Plugin / Beautiful taxonomy filters

Changelog

2.4.3

• BUGFIX: Fixed if statement causing PHP warning.
• IMPROVEMENT: Conditional dropdowns now attempts to not disable any value in the first dropdown being filtered, making it a bit more intuitive.

2.4.2

• BUGFIX: Missing slash in pagination rules. Thanks @fabianlindfors

2.4.1

• BUGFIX: Did not check if new rewrite rules was empty before attempting to merge them.

2.4.0

• This version should fix issues caused by last update
• IMPROVEMENT: Complete rewrite of the rewrite rules (huehuehue). note: BTF no longer allows for any order of taxonomies in URL. Only the order in which they are registered.
• BUGFIX: Fixed some warning when no taxonomies we’re registered on startup.

2.3.5

• FEATURE: Added shortcode for filter module. Use [show_beautiful_filters post_type="yourcptslug"] where you want!
• BUGFIX: Fixed issue where API function is_btf_filtered() returned false if query_var is different than registered taxonomy slug.
• BUGFIX: Some bugfixes for non existing contents etc. Just be happy with the shortcodes and carry on with your day!

2.3.4

• BUGFIX: HTML characters now properly decode when using conditional dropdowns.
• BUGFIX: Fixed Polylang urls incorrect when using homepage slug in URL.
• BUGFIX: Countable warning in post count for terms.
• BUGFIX: Fixed issue where has_archive was not honored.

2.3.3

• BUGFIX: Made a booboo with the previous versions new improved dropdown query. Please update right away and don’t try to find me.

2.3.2

• IMPROVEMENT: Vastly improved the conditional dropdowns query. It should now work even with pretty large sets of posts and terms.
• IMPROVEMENT: Norwegian translation added. Thank you Ørjan Hoyd H Vøllestad.
• BUGFIX: Widget now uses correct label for dropdown placeholders/labels.
• BUGFIX: Added initial slash to pagination in urls. Thanks @frantorres.
• BUGFIX: A pesky little php warning.
• BUGFIX: Some other stuff I can barely remember..

2.3.1

• BUGFIX: in_array warning on new installs. Move along, nothing to see here.

2.3.0

• IMPROVEMENT: New API functions are now available. They can be found in /includes/api.php. Most usable is probably is_btf_filtered() which will return true or false if the current page is filtered by BTF. Not currently in use everywhere in the code tho so don’t peak..
• IMPROVEMENT: “Clear all” only appear if there are actually something to clear.. Courtesy of the new api.
• IMPROVEMENT: Body classes are now added if on a BTF enabled archive and if there is currently a filter active. btf-archive and btf-filtered are added to the body class. Use these however you want!
• BUGFIX: Don’t mess with the “all option” when conditional dropdowns are active without select2.

2.2.1

• FEATURE: Disable fuzzy search in select2. It’s as easy as adding this filter:

  function disable_fuzzy_search( $boolean ) {
  return true;

  }
  add_filter(‘beautiful_filters_disable_fuzzy’, ‘disable_fuzzy_search’, 10, 1);

(Thanks to babouz44 for the help).

• BUGFIX: Was a little quick on the RTL. now it will work as it should 🙂

2.2.0

• BUGFIX: You can now have a different taxonomy rewrite slug than it’s query_var and it’ll work just fine anyway. Adds better compatibility with plugins that registers their own taxonomies. Big thanks to Kristoffer Lorentsen. Have a cookie 🍪
• BUGFIX: Found a bug when conditional dropdowns was used without select2. Don’t ask.

• IMPROVEMENT: Select2 will now automatically detect RTL languages. You can also set this manually using the filter:

  function modify_rtl( $rtl ) {
  return true;
  }
  add_filter( ‘beautiful_filters_rtl’, ‘modify_rtl’ );

• IMPROVEMENT: Select2 will now automatically detect current language (if using Polylang or WPML) and apply the correct translation file. You can also set this manually yourself using the new filter:

  function modify_current_language( $language ) {
  return ‘sv’;
  }
  add_filter( ‘beautiful_filters_language’, ‘modify_current_language’ );

• IMPROVEMENT: Some overall improvement to the select2 JS script. Just a bit of refactoring.

2.1.1

• IMPROVEMENT: Added Portuguese Brasil translation (Thanks to Bruno Sousa).
• IMPROVEMENT: Added Romanian translation (Thanks to Roberto Tamas).

2.1.0

• IMPROVEMENT: The conditional dropdowns now also apply when loading a filter result page. Please post all issues to the support forums.
• IMPROVEMENT: Updated POT file.
• IMPROVEMENT: Updated Swedish translation.
• IMPROVEMENT: Added Bulgarian translation (Thanks to Georgi Marokov).

2.0.0

• FEATURE: It’s finally here! AJAX-powered conditional dropdowns. Select a term in one taxonomy and see the selectable terms change in all other taxonomies. No more “no posts found” results for the visitors. This is a BETA feature which you have to enable in the advanced settings. If you find issues please create a topic in the forums.

A loader will appear and the dropdowns will be disabled while the AJAX works its magic if it takes longer than 800ms. any new AJAX triggered before the previous has finished will also abort the previous one.

You can replace the default loader .gif (WordPress spinner) using the new filter:

function my_custom_loader( $loader, $taxonomy, $posttype ){

    return $loader; // $loader is an img tag

}
add_filter('beautiful_filters_loader', 'my_custom_loader', 10, 3);

• FEATURE: A new style option “Simple” which just arranges everything without adding colors, drop shadows etc. also tweaked other styles for new select2 classes.
• IMPROVEMENT: Select2: Now a wrapping span element is always added to the results of the dropdown which carries over all classnames from the original option element. Use this to style hierarchical taxonomies. .select2-results__option .level-1{ padding-left: 1em; }.
• IMPROVEMENT: Added Portuguese (Thanks to Luis Martins).
• IMPROVEMENT: Added Catalan (Thanks to Maiol Xercavins).
• IMPROVEMENT: Added Swiss (Thanks to Raphael Hüni).
• IMPROVEMENT: Fixed some untranslatable strings.
• IMPROVEMENT: Updated POT file and Swedish translation.
• IMPROVEMENT: Greatly improved the information on the help and about tabs. Now there’s links to the forum, FAQ, hooks and github repo. All to make it easier for you to nag at me!
• IMPROVEMENT: Updated screenshots for wordpress.org
• IMPROVEMENT: Added a very basic stylesheet always included (already minimized to 486b) with BTF.

1.3.0

Just a minor update right now.. bigger things to come. carry on!

• IMPROVEMENT: Updated select2 lib to v 4.0.3. Hopefully fixing some issues with later versions of Safari on IOS

1.2.9

• BUGFIX: Fixed undefined index for widget walker.
• BUGFIX: Fixed incorrect post count in each term when filter module is not on a CPT archive.
• IMPROVEMENT: Updated german translations. Thanks to Nils Schönwald.
• IMPROVEMENT/BUGFIX: Updated select2 library to 4.0.1 (latest stable). This seems to fix issue of .change event not happening on original select element.
• IMPROVEMENT: Fixed some commenting inconsistencies. Nothing to see here folks.

1.2.8

IMPORTANT: In this update we’ve done a big overhaul of the settings page. This was important to be able to keep improving BTF settings and features. Unfortunately this means that any of your advanced settings will have to be reset. After updating please take a look at the “Advanced options” tab to make sure everything is set as you want.

• FEATURE: Added option under Advanced tab to show term description in the dropdowns. If you’re also using select2 the description will wrap in a span which you can style however you like! This feature is also available for widgets and of course you can modify it by post type using the new filter “beautiful_filters_show_description” which you can read more about in Notes on wordpress.org
• IMPROVEMENT/BUGFIX: Makes sure that when the option to show number of posts in term it will only show the number of posts for the current post type (if multiple post types shares the same taxonomies). Pretty neat!
• IMPROVEMENT: Complete overhaul of the settings page. Now with tabs and more logical separation of settings. It will allow me to add more settings to the advanced tab without overwhelming the user.
• IMPROVEMENT: Added notification and checks of versions to make setting changes easier in the future. Will be able to automatically convert settings so you’ll no longer lose them. Sorry about that btw..
• IMPROVEMENT: Added a notification on activation to let new users get started easily.
• IMPROVEMENT: Added a link to the post type archive next to each post type and a list of connected post types next to each taxonomy in Basic options settings tab.
• IMPROVEMENT: Some basic housecleaning because we always need more lemon pledge.
• BUGFIX: Automagic setting no longer affects RSS feeds.
• BUGFIX: Fixed minor html validation errors. Thanks to kiwiot for noticing.
• BUGFIX: Fixed issue with hidden select overflowing and causing horizontal scroll. Thanks to OrsomeWells for noticing.

1.2.7

• IMPROVEMENT: Added the same filter for modifying the “Apply filter” button text for the widget as the other implementations. If you’re already using the filter you should see the change to the widget without any further actions.
• IMPROVEMENT: Added filter for changing the “Clear all” button text. Use beautiful_filters_clear_button. Takes the string and requires a return of a string.

Now go punch a shark!

1.2.6

• FEATURE: It’s now easier than ever to add the modules to your themes. Instead of using <?php if(function_exists('show_beautiful_filters')){ show_beautiful_filters(); } ?> you can now just do <?php do_action('show_beautiful_filters'); ?> and of course <?php do_action('show_beautiful_filters_info'); ?> for the info module. This means less code, cleaner look and you wont see a white screen of death if you’ve failed to do a function_exists call and disabled the plugin. NOTE: The old way will still work so don’t worry.. you don’t have to do anything if you don’t want to… More info.
• IMPROVEMENT: Some performance improvements and code cleanup to the front end part of the plugin. You probably wont notice any difference but I’ll feel good about myself. Late spring cleaning is better than none!
• IMPROVEMENT: More validation and sanitation on the form elements and the functions which handle the filter module. Safety first!

1.2.5

• IMPROVEMENT: Added filter for the term names in the dropdowns. Add your own indentation indicators or just mess about with the term names. Go bananas!
• IMPROVEMENT: Since security is fashionable we’ve added Nonce security to the form. Try to hack us now!

1.2.4

• Tested on WordPress 4.2
• IMPROVEMENT: Added Simplified Chinese translation. Thanks to Amos Lee.
• IMPROVEMENT: Added the ability to sort the taxonomies by filter. No need to re-register them in the “right” order. Thanks to mranner.
• IMPROVEMENT: Updated the Select2 library (RC2). Fixes usability on devices amongst other things.
• IMPROVEMENT: Added a setting to select2 which only applies the search-field in the dropdown if there’s more than 8 results. This can be modified with a new filter which you can read about under Other notes.
• IMPROVEMENT: Added localization for all select2 parameters and created new filters for modifying those.

A new resource for information about how to use BTF and it’s filters will soon emerge from the mist…

1.2.3

• IMPROVEMENT: Added some basic media query styling to the style themes to avoid extremely small dropdowns on those modern electric things people carry around (smartphones).
• FEATURE: German translation added. Thanks to Matthias Bonnes.
• FIX: Fixed issue with ” and ‘ difference in wp_dropdown_categories walker. I’ll try to do some more testing before pushing out new features in the future… Thanks to Folbert for noticing.

1.2.2

• IMPROVEMENT: Added the terms slug as class to the option element. Allows for custom styling per term option. You can for example use it to colorcode the dropdowns terms.
• IMPROVEMENT: The dropdowns and filter infos now use the registered labels of the taxonomies for “all ” etc. instead of a translatable slug. If you are using polylang or WPML and had translated the “all” string for each language you should instead translate the taxonomy labels.
• IMPROVEMENT: Greatly improved the rewrite rules. They will ONLY be created for the taxonomies of the activated posttypes without any of the built-in taxonomies or polylangs (if they exist). So in short, we’ve reduced the rewrite rules by quite a bit.
• FIX: Fixed an issue where using the automagic feature would result in a php warning.

Note: in order for the filtering to work with a rewrite slug for your taxonomies you need to set query_var to the same value as your rewrite slug.
For example: you have a taxonomy registered with the slug “product_color” but you want the url slug to be “color”. Add “color” to both the query_var value and rewrite['slug'] value.

1.2.1

• IMPROVEMENT: Added multiple new actions for even better control of the filter module and give you the ability to modify the template_redirect filter. Check “other notes” for more.
• IMPROVEMENT: Added a filter to be able to manipulate the new URL a visitor is sent to when filtering
• IMPROVEMENT: Improved the way the filterinfo module determines current taxonomies.
• FIX: Fixed an issue where current taxonomies didn’t get displayed properly in the filterinfo module.

1.2

• FEATURE: the show_beautiful_filters() function can now take a parameter of a custom post type name. Doing so enables you to show the filter module anywhere in your theme for a specific post type. Much like the widget except you can place the function pretty much anywhere without having to use a widget. Pretty sweet.
• FEATURE: You’re now able to completely disable the select2 library and use good old regular selects instead. Use your own select improving library or whatever… my feelings aren’t hurt. Just remember that the regular selects don’t support placeholders so it will fall back to the “all option”.
• FEATURE: Beautiful Taxonomy Filters is now compatible with Polylang. This is still kind of beta so there might be some bugs to work out over time. I have not been able to try every possible setting so feedback on this is appreciated! See FAQ for more info
• IMPROVEMENT: Updated swedish translations. If you’re a well educated multilingual person with a kind heart I’d love translations for other languages as well! Klingon might be a bit excessive tho.
• IMPROVEMENT: Made the menu item name translatable.
• IMPROVEMENT: Minifed JS and CSS for minimal file sizes to load.
• FIX: php warning for the automagic feature in settings page.
• FIX: The result of filter count is now correct and applied to the filterinfo widget as well.
• FIX: Sometimes when on a different post type the filter widget didn’t use the proper posttype.
• FIX: The “Clear all” link should now always point to the correct URL.

1.1.4.2

• FIX: Hotfix #3. Added fix for widgets regarding core taxonomies.

1.1.4.1

• FIX: Hotfix #2.. Some files got lost in version 1.1.4 and we had to help them find their way back.

1.1.4

• FIX: This update is a hotfix for an issue where WordPress builtin categories and tags connected to a CPT appear in the filter module. Since they cannot be supported at this time they should not appear at all. This update fixes that. Thanks to BlantantWeb for the notice.

1.1.3

• FEATURE: The filterinfo module now has the ability to show how many posts a filter has resulted in. There is also new filters for hooking into this.
• FEATURE: New actions have been added to the filterinfo module that allows for custom markup inside the module.
• FEATURE: There is now a filter for modifying the placeholder of each dropdown.
• FEATURE: There is now a filter for modifying the filter buttons text “Apply filter”.
• IMPROVEMENT: The plugins scripts will now load in footer instead of head. This also fixes some rare bugs where dependencies with jQuery did not work.
• IMPROVEMENT: Update to swedish translation.

1.1.1

• FEATURE: You can now automagically insert the two modules into your archive pages! No need for modification of your theme. This feature is sort of experimental and there’s a few things to note compared to the manual methods:
  • The modules wont appear if your users select a filtering and there’s no posts.
  • You can’t control the placement of the filter. You can decide to place the filter info module above or below the filter module but that’s it. For more control use one of the manual methods (function calls or widgets).
  • The modules wont output twice. So that means you’ll have to remove the manual functions if you’re using them. This also means that you can use the automagic way and still manually place the functions on specific posttype archives if you like. Great stuff I know…
• FEATURE: You can now choose to display a placeholder text and a “clear” button on the dropdowns instead of the regular “All ” option. Of course this comes with a filter to let you control this feature per posttype archive. Have placeholders on one archive and an empty option on another.. no problem!
• FIX: The filter module will now work correctly even when you have a different rewrite slug for your CPT.
• FIX: Minor bug fixes resulting in PHP notice logs.
• IMPROVEMENT: Minor code performance improvements.
• IMPROVEMENT: Update to Swedish and French translations. Thanks to Brice Capobianco for the french translation.
• IMPROVEMENT: Updated select2 to 3.5.2

1.1.0

• FEATURE: Brand new beautiful widget. You can now add the filter module directly to your sidebar areas via a custom widget.
  • Ability to override the main settings for granular control over each widget.
  • Select a specific posttype and the filter will work from anywhere (redirecting to the proper filtered archive url).
• FEATURE: But wait.. there’s more! You get another beautiful widget for displaying the active filter info. Oh and the widget wont even appear where it’s not supposed to. So no need to micromanage it’s visibility!
• FEATURE: New option to show or hide empty terms in dropdowns
• FEATURE: New option to show post count next to terms in dropdowns
• FEATURE: Dutch translation. Thanks to Piet Bos
• FEATURE: French translation. Thanks to Brice Capobianco
• FEATURE: Added filter to set the option to show/hide empty terms
• FEATURE: Added filters to set order and orderby in the dropdown arguments (if you for some reason want to display the terms z-a… for example)
• FEATURE: Added filter to change the “Active filters” heading
• STYLE: Added styling for displaying hierarchical terms in dropdowns (down to 2 levels)
• STYLE: Some minor touch ups on both styles
• FIX: Added taxonomy specific ids to each dropdown wrapper to allow for more in-depth custom styling per dropdown.
• FIX: Added current post type to the filters beautiful_filters_clear_all and beautiful_filters_hide_empty to allow for posttype specific settings.
• FIX: Changed behaviour of the current filter info module to always be visible and show “all ” if no term is active.
• IMPROVEMENT: Abstracted some functionality for cleaner leaner meaner code

1.0.2

• FIX: Bug found in displaying the filter info
• FIX: Bug found in displaying the filter module

1.0.1

• FIX: PHP Notice on some occasions using the filter info function
• FEATURE: Spanish translation. Thanks to Juan Javier Moreno Restituto

1.0

• Initial public version