This plugin provides a widget and a filter to display a collapsible list of categories in your sidebar or posts by using vanilla Javascript.<\/p>\n\n
jquery-categories-list<\/code> under \/wp-content\/plugins\/<\/code><\/li>\n- Upload all downloaded files to
\/wp-content\/plugins\/jquery-categories-list\/<\/code><\/li>\n- Activate plugin at the plugins section.<\/li>\n
- Go to Presentation -> Widgets and drag the JS Categories List to your sidebar and configure it, if you want to display it inside a post then write [JsCategoriesList] at the location where it will be shown and save it.<\/li>\n<\/ol>\n\n\n
\nWhy there are 2 widgets?<\/h3><\/dt>\nSince version 4.0 the widget was migrated to a Gutenberg block. So there will be a Gutenberg block with the most modern code and compatibility and a legacy version that is 100% made in PHP to keep compatibility with older installations.<\/p><\/dd>\n
Why this plugin is not working?<\/h3><\/dt>\nBy support experience, like 99% of problems are due to:<\/p>\n\n
\n- There's a Javascript error caused by other plugin and it stops any further code execution, check your browser's logs to find the problem and deactivate the conflict plugin.<\/li>\n
- Your template doesn't have a wp_footer() function, this plugin requires this function to load JS code at the end of the website to improve speed.<\/li>\n
- You're using a plugin that removes Wordpress' JS version and inserts an old one.<\/li>\n<\/ul><\/dd>\n
How I can send you a translation?<\/h3><\/dt>\nSend me the translated .mo file to migueluseche(a)skatox.com and indicate the language, I can read english or spanish, so please write me on these languages.<\/p><\/dd>\n
Can I use images as bullets or trigger symbols?<\/h3><\/dt>\nYes, select 'Empty Space' as trigger symbol and Save, then you can add any custom background using CSS,\njust play with the widget's classes .jaw_category, .jcl_symbol, .jcl_link.<\/p><\/dd>\n
Can I show this list inside posts?<\/h3><\/dt>\nYes, only write [jQueryCategoriesList] anywhere inside a post or page's contest and it will be\nreplaced for the archive list when rendering the content. You can add the following parameters to change its behavior:<\/p>\n\n
\n- showcount<\/strong> ( boolean ): Select if you want to show the count post inside category's name<\/li>\n
- 'layout'<\/strong> ( \"right\", \"left\" ): where to display the symbol<\/li>\n
- ex_sym<\/strong>: the expansion symbol.<\/li>\n
- con_sym<\/strong>: the collapse symbol.<\/li>\n
- effect<\/strong> (\"none\", \"slide\", \"fade\"): the JS effect to implement.<\/li>\n
- orderby<\/strong> (\"name\",\"id\", \"count\"): how to order categories.<\/li>\n
- orderdir<\/strong> (\"ASC\", \"DESC\"): the direction to order categories.<\/li>\n
- show_empty'<\/strong> ( boolean ): show categories with no posts.<\/li>\n
- expand<\/strong> (\"all\", \"none\"): expand or collapase all categories.<\/li>\n
- exclude<\/strong>: IDs (comma separated) of the categories to exclude.<\/li>\n<\/ol><\/dd>\n
How can i add multiples instances?<\/h3><\/dt>\nSince 2.0 you can add as many instances as you want, but there's another way to do it, just add a new Text widget only with the shortcode [jQueryCategoriesList] then it will have a new copy of the widget.<\/p><\/dd>\n
How I contribute to this plugin?<\/h3><\/dt>\nBy using it, recommending it to other users, giving it 5 starts at plugin's wordpress page, suggesting features or coding new features and finally by DONATING<\/strong> using plugin's website's donate link,\nwith the donation I can spend more time on this project.<\/p><\/dd>\nCan I have different instances with different configuration?<\/h3><\/dt>\nSince 2.0 it's possible. Each instance has its own configuration. Shortcode widgets are controlled by shortcode attributes.<\/p><\/dd>\n\n<\/dl>\n\n\n
4.1.1<\/h4>\n\n\n- Added a post type selector in the block editor to switch between posts and custom post types registered with the default Categories taxonomy.<\/li>\n
- Added REST support to load category options and frontend category trees by selected post type.<\/li>\n
- Updated category picker behavior to refresh category options when changing the selected post type.<\/li>\n
- Added a new block setting to open category links in a new page (
target=\"_blank\"<\/code>).<\/li>\n- Added backward-compatible post type fallback to
post<\/code> when older block instances do not have post_type<\/code> saved.<\/li>\n<\/ul>\n\n4.1.0<\/h4>\n\n\n- Standardized the plugin text domain to
jquery-categories-list<\/code> across PHP, block metadata, JavaScript, and bundled translation files for better WordPress.org compatibility.<\/li>\n- Improved legacy widget, block, and REST code to better follow WordPress coding standards, sanitization, escaping, and inline documentation practices.<\/li>\n
- Added the remaining editor translation string and wired block script translations through the generated editor asset handle.<\/li>\n
- Hardened shortcode category parsing so user-provided
exclude<\/code> values are treated strictly as ID lists and are never unserialized, while keeping backward compatibility for stored serialized widget values.<\/li>\n<\/ul>\n\n4.0.3<\/h4>\n\n\n- Escaped category names\/links\/counts in the legacy frontend output, fixed\nactive child detection, and made exclude parsing safe with unserialize(...,\n['allowed_classes' => false]) + wp_parse_id_list in classes\/legacy\/class-\njcl-legacy-html-builder.php.<\/li>\n
- Added spaces between data-* attributes, escaped admin form values\/IDs\/names,\nsanitized stored exclude lists, and safely deserialized excludes in classes\/\nlegacy\/class-jcl-legacy-widget.php.<\/li>\n
- Validated REST params (orderby, orderdir, parent, cats) and normalized them\nto safe values in classes\/class-js-categories-list-rest-endpoints.php.<\/li>\n<\/ul>\n\n
4.0.2<\/h4>\n\n\n- Improve compatibility with WordPress standards<\/li>\n<\/ul>\n\n
4.0.1<\/h4>\n\n\n- Added support for WordPress Playground.<\/li>\n
- Updating tests to the latest react-testing-library version.<\/li>\n
- Updating JS dependencies to latest version. This will fix security issues and improve performance.<\/li>\n
- Legacy version: added
jcl_widget_title<\/code> hook to allow changing the widget's title (helpful for translations).<\/li>\n<\/ul>\n\n4.0.0<\/h4>\n\n\n- Code migrated to Gutenberg block. Now you can use this plugin as a Gutenberg block on any modern theme.<\/li>\n
- The block version reads the categories dynamically. It saves bandwidth and reduces old DOM size on old sites.<\/li>\n
- JS code is only loaded if there\u2019s a widget or block is added to page. No more always loading JS and CSS code.<\/li>\n
- Deprecated old php version. It will only be on maintenance mode and new Gutenberg block will be supported.<\/li>\n
- Improved automated tests and code, to make future versions easier to develop.<\/li>\n<\/ul>\n\n
3.0<\/h4>\n\n\n- Solved accordion bug with Intenet Explorer 8<\/li>\n<\/ul>\n\n
2.2.2<\/h4>\n\n\n- Solved expansion\/contraction bug when using sub-categories.<\/li>\n
- Added support for HTTPS, now the plugin generates the correct link if HTTPS is being used, thanks to bridgetwes<\/strong> for the patch.<\/li>\n
- Added ordering by category's slug.<\/li>\n<\/ul>\n\n
2.2.1<\/h4>\n\n\n- Fixed the problem of a warning message being shown when a post had a single category.<\/li>\n
- Added a CSS class to li<\/strong> elements with child categories.<\/li>\n
- Improved category HTML generation code to make future modifications easier.<\/li>\n<\/ul>\n\n
2.2.<\/h4>\n\n\n- Fixed category's post count when excluding some categories, now it uses the same algorithm as the standard WP widget.<\/li>\n
- Finally the list expands to the opened\/click category! It remembers where you clicked! Just select the expand option to 'Clicked Category'.<\/li>\n
- Wrapped post count (if activated) inside a span<\/strong> to apply CSS rules.<\/li>\n
- Added a active class for current category.<\/li>\n
- Fixed some spanish translations.<\/li>\n
- Plugin translated to Russian by \u041c\u0430\u0442\u0432\u0435\u0435\u0432 \u0412\u0430\u043b\u0435\u0440\u0438\u0439.<\/li>\n<\/ul>\n\n
2.1<\/h4>\n\n\n- Added option to exclude categories when using shortcodes, just add categorie's ID separated by commas in the exclude attribute.<\/li>\n
- Solved bug of not including JS file when using a filter without any widget.<\/li>\n
- Solved bug of not including JS in some WP installlations under Windows.<\/li>\n<\/ul>\n\n
2.0<\/h4>\n\n\n- Huge update thanks to donations! If you upgrade to this version you'll NEED to configurate the widget AGAIN, due to architecture rewriting configuration may get lost.<\/li>\n
- Added support for multiples instances, finally you can have as many widgets as you want without any hack :)<\/li>\n
- Added support for dynamic widgets<\/li>\n
- Added an option to not have any effect when expanding or collapsing.<\/li>\n
- Added an option to select if you want the symbol on the left or on the right.<\/li>\n
- Added an option to autoexpand all categories by default.<\/li>\n
- Removed dynamic generation of the JS file, now you don't need write permissions on the folder.<\/li>\n
- Rewroted JS code, now it is a single JS file for all instances, improved perfomance and compatible with all cache plugins.<\/li>\n
- Updated translation files for Spanish, Czech, Slovak and Italian.<\/li>\n<\/ul>\n\n
1.3.2<\/h4>\n\n\n- Fixed some several bugs, thanks to Marco Lizza who reviewed the code and fixed them. Plugin should be more stable and won't throw errors when display_errors is on.<\/li>\n
- Added italian translation.<\/li>\n<\/ul>\n\n
1.3.1<\/h4>\n\n\n- Added option to show or hide empty categories.<\/li>\n
- Improved shortcode, now parameters accepts yes, no, 1, or 0 as input.<\/li>\n<\/ul>\n\n
1.3<\/h4>\n\n\n- Improved Javascript code (please save again the configuration to take effect)<\/li>\n
- Better shortcode\/filter support. now it has attributes for different behavior on instances. (There's no support for effect and symbol because it is managed through the JS filse )<\/li>\n<\/ul>\n\n
1.2.5<\/h4>\n\n\n- Fixing i18n bug due to new wordpress changes, now it loads your language (if it was translated) correctly.<\/li>\n<\/ul>\n\n
1.2.4<\/h4>\n\n\n- JS code is not generated dynamically, now it is generated in a separated file. For better performance and to support any minify plugins.<\/li>\n<\/ul>\n\n
1.2.3<\/h4>\n\n\n- Improved generated HTML code to be more compatible when JS is off, also helps to search engines to navigate through archives pages.<\/li>\n
- Added Slovak translation.<\/li>\n
- Cleaned code and make it more readable for future hacks from developers.<\/li>\n<\/ul>\n\n
1.2.2<\/h4>\n\n\n- Changed plugin's JS file loading to the footer, so it doesn't affect your site's loading speed.<\/li>\n
- Added default value for widget's title. And it is included in translation files, so this can be used in multi-language sites.<\/li>\n
- Plugin translated to Czech (CZ) thanks to Tomas Valenta.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- Solving sorting bug, now you can choose the categories display order.<\/li>\n<\/ul>\n\n
1.2<\/h4>\n\n\n- Added support for multiples instances (by writing [jQuery Categories List] on any Text widget).<\/li>\n
- Fixed a bug when no categories were selected to be filtered.<\/li>\n
- Improved compatibility with Wordpress 3.x.<\/li>\n<\/ul>\n\n
1.1<\/h4>\n\n\n- Added support to exclude categories when listing.<\/li>\n<\/ul>\n\n
1.0<\/h4>\n\n\n- Initial public version.<\/li>\n<\/ul>","raw_excerpt":"A simple Gutenberg block and JS widget (can be called from posts) for displaying categories in a list with some effects.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/11419","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=11419"}],"author":[{"embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/skatox"}],"wp:attachment":[{"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=11419"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=11419"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=11419"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=11419"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=11419"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/azb.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=11419"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}