The Beautiful Taxonomy Filters plugin is an easy and good-looking way to provide your visitors with filtering for your post types. With this you get a complete solution for adding filtering based on custom taxonomy terms/categories/tags. It will also automatically add rewrite rules for pretty looking filter URLs. It’s completely automatic, works without javascript and is based on the WordPress Plugin boilerplate for a standardized, organized and object-oriented codebase. It uses select2 for pretty looking and user friendly dropdowns but will fall back to ordinary ones if javascript is not supported.
No more horrible looking URLs or hacky Javascript solutions
产品特点
- Activate filtering on any registered public custom post type.
- Exclude taxonomies you just don’t want the visitors to filter on.
- Beautifies the resulting URLs. You won’t see any /posttype/?taxonomy1=term. Instead you’ll see /posttype/taxonomy/term.
- The pretty URLs are much more SEO friendly so you’ll give a boost to those filtered pages. Just remember to use canonicals where it’s appropriate.
- BETA: Conditional dropdowns. Make sure your visitors never end up with empty filtered results. AJAX reloads the values in each dropdown based on previously selected values.
- Polylang compatible.
- Multisite compatible. No network settings at the moment.
- Comes with a complete functional filter module for you to put in your theme.
- Three alternatives for putting the filter modules in your theme:
- Widgets (Also lets you “hard set” a post type for use anywhere)
- do_action hooks (for granular control)
- Automagic setting which will magically place the modules in your archive from thin air. Wizards at work…
- Choose from different styles for the component, or disable styling and do it yourself in style.css! Just want to tweak a style? Add your custom CSS directly on the settings page.
- Many more settings for fine-tuning the filter modules behavior:
- A ”Clear all” link for the filter component.
- Choose between placeholders or “show all” in the dropdowns.
- Hide empty terms in the dropdowns.
- Show a post count next to the term name
- Disable select2
- Show term description
- Disable headings you don’t want
- More to come!
- Ability to show your visitors information about their current active filtering and control the look of this.
- Allows for custom GET parameters to be included. Extend the filter your way with maybe a custom search-parameter or whatever you like.
- Many filters and actions for modifying the plugins behavior. For you control freaks out there…
语言
- 英文
- 瑞典语
- Spanish (Thanks to Juan Javier Moreno Restituto)
- Dutch (Thanks to Piet Bos)
- German (Thanks to Matthias Bonnes)
- French (Thanks to Brice Capobianco)
- Simplified Chinese (Thanks to Amos Lee)
- Portuguese (Thanks to Luis Martins)
- Portuguese Brasil (Thanks to Bruno Sousa)
- Catalan (Thanks to Maiol Xercavins)
- Swiss (Thanks to Raphael Hüni)
- Bulgarian (Thanks to Georgi Marokov)
- Romanian (Thanks to Roberto Tamas)
Do you want to translate this plugin to another language? I recommend using POEdit (http://poedit.net/) or if you prefer to do it straight from the WordPress admin interface (https://wordpress.org/plugins/loco-translate/). When you’re done, send us the file(s) to me@jonte.dev and we’ll add it to the official plugin!
其它
- Based on WordPress Plugin Boilerplate
- Uses Select2 to enhance dropdowns
Featured on
API
**Filters**
These are the filters available to modify the behavior of the plugin. These all take at least 1 parameter which you must return
beautiful_filters_dropdown_categories
$args is an array of the arguments put into the wp_dropdown_categories function.
$taxonomy is the current taxonomy.
beautiful_filters_post_types
$post_types is an array. Modifies the selected post types before being used.
beautiful_filters_taxonomies
$taxonomies is an array. Modifies the excluded taxonomies before being used.
beautiful_filters_taxonomy_order
$taxonomies is an array of the taxonomies slugs. $current_post_type is the post type we’re using the filter on. This must return the $taxonomies array.
beautiful_filters_dropdown_placeholder
$placeholder is the string used for the placeholder.
$taxonomy is the current taxonomy.
In order to change the placeholders you must use this filter rather than the modify_categories_dropdown argument “show_option_all”.
beautiful_filters_language
Changes the language code for the current page load.
beautiful_filters_rtl
Changes wether the page is RTL or not.
beautiful_filters_disable_fuzzy
Disables select2 fuzzy search. particularly useful for terms that are all numbers.
beautiful_filters_clear_all
$bool is a boolean which decides if the ”Clear all” link should be used or not. $current_post_type is the current post type being filtered
beautiful_filters_hide_empty
$bool is a boolean which decides if empty terms should be displayed or not. $current_post_type is the current post type being filtered
beautiful_filters_show_count
$bool is a boolean which decides if post count should be displayed or not. $current_post_type is the current post type being filtered
beautiful_filters_show_description
$bool is a boolean which decides if term description should be displayed or not. $current_post_type is the current post type being filtered
beautiful_filters_dropdown_order
$order is a string which defaults to ASC, other possible value is DESC. $taxonomy is the current taxonomy slug
beautiful_filters_dropdown_orderby
$order is a string which defaults to NAME, other possible value is ID or SLUG. $taxonomy is the current taxonomy slug
beautiful_filters_dropdown_behaviour
$behaviour is a string that should be either show_all_option or show_placeholder_option. $current_post_type is the current posttype name.
Use this to modify the dropdown behaviour per posttype or just manually from functions.php
beautiful_filters_dropdown_behaviour
$term_name is a string that have to be returned. $category is the term object. $depth is the level of depth for the current term starting at 0 (no parent).
Use this to alter the output of the term name inside the dropdowns.
beautiful_filters_taxonomy_label
$label is the name of the taxonomy used as label to the dropdown.
beautiful_filters_apply_button
$string is the default string of the apply filters button.
beautiful_filters_clear_button
$string is the default string of the apply filters button.
beautiful_filters_loader
beautiful_filters_active_terms
$terms is the terms string for the active filter info
$taxonomy is the current taxonomy name
beautiful_filters_disable_heading
$bool is a boolean of either true (hide filterinfo heading) or false (show filterinfo heading)
beautiful_filters_info_heading
$filter_heading is the default heading string
beautiful_filters_disable_postcount
$bool is a boolean of either true (hide filterinfo postcount) or false (show filterinfo postcount)
beautiful_filters_info_postcount
$postcount_paragraph is the default postcount string. You MUST add %d somewhere in the new string in order for the resulting number to appear.
beautiful_filters_new_url
Use this filter to manipulate the URL string of the filtered archive page that the visitor will be directed to.
beautiful_filters_selec2_minsearch
$min_search is an integer.
beautiful_filters_selec2_allowclear
$bool is a boolean value of either true of false. Setting this to false disables the ability to remove the selection with the x-icon.
**Actions**
These are the actions you may use to extend the filter component.
beautiful_actions_before_form
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
beautiful_actions_after_form
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
beautiful_actions_beginning_form
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
This action is very usable if you for some reason need to add inputs to be send with the form
beautiful_actions_ending_form
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
This action is very usable if you for some reason need to add inputs to be send with the form.
beautiful_actions_beginning_form_inner
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
This action can be used to add inputs etc to the beginning of the inner div of the filter module.
beautiful_actions_ending_form_inner
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
This action can be used to add inputs etc to the end of the inner div of the filter module.
beautiful_actions_before_redirection
$current_post_type is the post type which the filter component are currently using. Use this variable as a conditional if needed.
This action can be used to add your own stuff or manipulate something before the page is redirected to the new filtered page but after the page has reloaded.
beautiful_actions_beginning_filterinfo
$current_post_type is the post type which the filterinfo component are currently using. Use this variable as a conditional if needed.
This action is very usable if you for some reason need to add markup at the beginning of the filterinfo module
beautiful_actions_ending_filterinfo
$current_post_type is the post type which the filterinfo component are currently using. Use this variable as a conditional if needed.
This action is very usable if you for some reason need to add markup at the end of the filterinfo module
评论0