Описание
This plugin provides a widget and a filter to display a collapsible list of categories in your sidebar or posts by using vanilla Javascript.
Возможности плагина
- Support for Gutenberg blocks. Add it to any FSE theme or Gutenberg compatible theme.
- Display a collapsed list of your archives to reduce space.
- Uses vanilla JS to add effects and to be compatible with all browsers.
- Select the symbol for expanding/collapsing categories
- Select categories to exclude, so it shows only the categories you want.
- Autoexpand selected category (including it parent or child).
- Support for multiple instances.
- Simple layout configuration
- Shortcode support [JsCategoriesList]
- Translated to Spanish, Italian Russian, Slovak, Czech.
- Compatible with most JS cache and minify plugins.
- And more to come…
Настройки
- Title: title of the widget.
- Trigger Symbol: characters to be displayed as a bullet.
- Symbol position: where to put the expand/collapse symbol.
- Effect: JS’s effect to use.
- Order by: display order of categories.
- Expand: if list should be expanded or callapsed by default.
- Show number of posts: display how many post are published in the category.
- Show empty categories: display categories with no posts.
- Categories to include: categories to be included from the list.
- Categories to exclude: categories to be excluded from the list.
Скриншоты
Блоки
Этот плагин предоставляет 1 блок.
- JS Category List A block for displaying a category list with some effects.
Установка
- Make a directory
jquery-categories-list
under/wp-content/plugins/
- Upload all downloaded files to
/wp-content/plugins/jquery-categories-list/
- Activate plugin at the plugins section.
- 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.
Часто задаваемые вопросы
-
Why there are 2 widgets?
-
Since 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.
-
Why this plugin is not working?
-
By support experience, like 99% of problems are due to:
- 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.
- 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.
- You’re using a plugin that removes WordPress’ JS version and inserts an old one.
-
How I can send you a translation?
-
Send 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.
-
Can I use images as bullets or trigger symbols?
-
Yes, select ‘Empty Space’ as trigger symbol and Save, then you can add any custom background using CSS,
just play with the widget’s classes .jaw_category, .jcl_symbol, .jcl_link. -
Can I show this list inside posts?
-
Yes, only write [jQueryCategoriesList] anywhere inside a post or page’s contest and it will be
replaced for the archive list when rendering the content. You can add the following parameters to change its behavior:- showcount ( boolean ): Select if you want to show the count post inside category’s name
- ‘layout’ ( «right», «left» ): where to display the symbol
- ex_sym: the expansion symbol.
- con_sym: the collapse symbol.
- effect («none», «slide», «fade»): the JS effect to implement.
- orderby («name»,»id», «count»): how to order categories.
- orderdir («ASC», «DESC»): the direction to order categories.
- show_empty’ ( boolean ): show categories with no posts.
- expand («all», «none»): expand or collapase all categories.
- exclude: IDs (comma separated) of the categories to exclude.
-
How can i add multiples instances?
-
Since 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.
-
How I contribute to this plugin?
-
By 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 using plugin’s website’s donate link,
with the donation I can spend more time on this project. -
Can I have different instances with different configuration?
-
Since 2.0 it’s possible. Each instance has its own configuration. Shortcode widgets are controlled by shortcode attributes.
Отзывы
Участники и разработчики
«JS Categories List Widget» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники«JS Categories List Widget» переведён на 1 язык. Благодарим переводчиков за их работу.
Перевести «JS Categories List Widget» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
4.0.1
- Added support for WordPress Playground.
- Updating tests to the latest react-testing-library version.
- Updating JS dependencies to latest version. This will fix security issues and improve performance.
- Legacy version: added
jcl_widget_title
hook to allow changing the widget’s title (helpful for translations).
4.0.0
- Code migrated to Gutenberg block. Now you can use this plugin as a Gutenberg block on any modern theme.
- The block version reads the categories dynamically. It saves bandwidth and reduces old DOM size on old sites.
- JS code is only loaded if there’s a widget or block is added to page. No more always loading JS and CSS code.
- Deprecated old php version. It will only be on maintenance mode and new Gutenberg block will be supported.
- Improved automated tests and code, to make future versions easier to develop.
3.0
- Solved accordion bug with Intenet Explorer 8
2.2.2
- Solved expansion/contraction bug when using sub-categories.
- Added support for HTTPS, now the plugin generates the correct link if HTTPS is being used, thanks to bridgetwes for the patch.
- Added ordering by category’s slug.
2.2.1
- Fixed the problem of a warning message being shown when a post had a single category.
- Added a CSS class to li elements with child categories.
- Improved category HTML generation code to make future modifications easier.
2.2.
- Fixed category’s post count when excluding some categories, now it uses the same algorithm as the standard WP widget.
- Finally the list expands to the opened/click category! It remembers where you clicked! Just select the expand option to ‘Clicked Category’.
- Wrapped post count (if activated) inside a span to apply CSS rules.
- Added a active class for current category.
- Fixed some spanish translations.
- Plugin translated to Russian by Матвеев Валерий.
2.1
- Added option to exclude categories when using shortcodes, just add categorie’s ID separated by commas in the exclude attribute.
- Solved bug of not including JS file when using a filter without any widget.
- Solved bug of not including JS in some WP installlations under Windows.
2.0
- 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.
- Added support for multiples instances, finally you can have as many widgets as you want without any hack 🙂
- Added support for dynamic widgets
- Added an option to not have any effect when expanding or collapsing.
- Added an option to select if you want the symbol on the left or on the right.
- Added an option to autoexpand all categories by default.
- Removed dynamic generation of the JS file, now you don’t need write permissions on the folder.
- Rewroted JS code, now it is a single JS file for all instances, improved perfomance and compatible with all cache plugins.
- Updated translation files for Spanish, Czech, Slovak and Italian.
1.3.2
- 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.
- Added italian translation.
1.3.1
- Added option to show or hide empty categories.
- Improved shortcode, now parameters accepts yes, no, 1, or 0 as input.
1.3
- Improved Javascript code (please save again the configuration to take effect)
- 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 )
1.2.5
- Fixing i18n bug due to new wordpress changes, now it loads your language (if it was translated) correctly.
1.2.4
- JS code is not generated dynamically, now it is generated in a separated file. For better performance and to support any minify plugins.
1.2.3
- Improved generated HTML code to be more compatible when JS is off, also helps to search engines to navigate through archives pages.
- Added Slovak translation.
- Cleaned code and make it more readable for future hacks from developers.
1.2.2
- Changed plugin’s JS file loading to the footer, so it doesn’t affect your site’s loading speed.
- Added default value for widget’s title. And it is included in translation files, so this can be used in multi-language sites.
- Plugin translated to Czech (CZ) thanks to Tomas Valenta.
1.2.1
- Solving sorting bug, now you can choose the categories display order.
1.2
- Added support for multiples instances (by writing [jQuery Categories List] on any Text widget).
- Fixed a bug when no categories were selected to be filtered.
- Improved compatibility with WordPress 3.x.
1.1
- Added support to exclude categories when listing.
1.0
- Initial public version.