{"id":87123,"date":"2018-06-21T07:16:22","date_gmt":"2018-06-21T07:16:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/categorylist\/"},"modified":"2026-04-17T19:03:16","modified_gmt":"2026-04-17T19:03:16","slug":"categorylist","status":"publish","type":"plugin","link":"https:\/\/ro.wordpress.org\/plugins\/categorylist\/","author":15893194,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.5","stable_tag":"1.5","tested":"6.8.5","requires":"5.8","requires_php":"8.0","requires_plugins":null,"header_name":"Simple Category List","header_author":"Nilesh Ziniwal","header_description":"This plugin shows the cateogy lists at any where by the one simple shortcode.","assets_banners_color":"d8e7f0","last_updated":"2026-04-17 19:03:16","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/ncp\/payment\/5PPDH7K9MZSNG","header_plugin_uri":"https:\/\/www.linkedin.com\/in\/nilesh-ziniwal-prajapati-07709799\/","header_author_uri":"https:\/\/www.linkedin.com\/in\/nilesh-ziniwal-prajapati-07709799\/","rating":5,"author_block_rating":0,"active_installs":20,"downloads":3072,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1":{"tag":"1.1","author":"nziniwal","date":"2018-06-26 07:25:14"},"1.2":{"tag":"1.2","author":"nziniwal","date":"2018-06-27 13:44:45"},"1.3":{"tag":"1.3","author":"nziniwal","date":"2019-04-30 11:51:46"},"1.4":{"tag":"1.4","author":"nziniwal","date":"2025-02-09 11:31:10"},"1.5":{"tag":"1.5","author":"nziniwal","date":"2026-04-17 19:03:16"}},"upgrade_notice":{"2.1.3":"<p>Hardening release (no database migration). Safe to update from 2.1.x.<\/p>","2.1.2":"<p>Maintenance: <code>languages\/<\/code> placeholder file, optional documentation URL filter. No database changes. (If you still use the old <code>category_list.php<\/code> bootstrap, re-activate the plugin once.)<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3509218,"resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3509218,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250-rtl.jpg":{"filename":"banner-772x250-rtl.jpg","revision":3237255,"resolution":"772x250","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3237255,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1","1.2","1.3","1.4","1.5"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3509202,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3509202,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3237248,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3509202,"resolution":"4","location":"assets","locale":""},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3509202,"resolution":"5","location":"assets","locale":""}},"screenshots":{"1":"<strong>Category lists<\/strong> \u2014 table of lists and shortcodes.","2":"<strong>Add \/ Edit list<\/strong> \u2014 shortcode defaults and design."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[610,166,80,91,286],"plugin_category":[57],"plugin_contributors":[158226],"plugin_business_model":[],"class_list":["post-87123","plugin","type-plugin","status-publish","hentry","plugin_tags-categories","plugin_tags-posts","plugin_tags-shortcode","plugin_tags-taxonomy","plugin_tags-woocommerce","plugin_category-taxonomy","plugin_contributors-nilesh","plugin_committers-nziniwal"],"banners":{"banner":"https:\/\/ps.w.org\/categorylist\/assets\/banner-772x250.jpg?rev=3237255","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/categorylist\/assets\/icon-128x128.png?rev=3509218","icon_2x":"https:\/\/ps.w.org\/categorylist\/assets\/icon-256x256.png?rev=3509218","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/categorylist\/assets\/screenshot-1.png?rev=3509202","caption":"<strong>Category lists<\/strong> \u2014 table of lists and shortcodes."},{"src":"https:\/\/ps.w.org\/categorylist\/assets\/screenshot-2.png?rev=3509202","caption":"<strong>Add \/ Edit list<\/strong> \u2014 shortcode defaults and design."},{"src":"https:\/\/ps.w.org\/categorylist\/assets\/screenshot-3.png?rev=3237248","caption":""},{"src":"https:\/\/ps.w.org\/categorylist\/assets\/screenshot-4.png?rev=3509202","caption":""},{"src":"https:\/\/ps.w.org\/categorylist\/assets\/screenshot-5.png?rev=3509202","caption":""}],"raw_content":"<!--section=description-->\n<p><strong>Simple Category List<\/strong> is built for production sites: multiple presets, a clear admin UI, transient-backed term queries, and optional per-shortcode overrides.<\/p>\n\n<p><strong>Good for:<\/strong> WooCommerce product categories and tags, blog categories, custom post types, any public taxonomy (e.g. <code>product_cat<\/code>, <code>category<\/code>, custom taxonomies), hierarchical or flat term lists, and theme builders that support shortcodes.<\/p>\n\n<p><em>WordPress.org allows only five plugin tags; related terms above help people find this page in search.<\/em><\/p>\n\n<p><strong>Features<\/strong><\/p>\n\n<ul>\n<li><strong>Multiple lists<\/strong> \u2014 each row has a numeric <strong>id<\/strong>, a URL <strong>slug<\/strong>, and JSON settings (taxonomy, exclude list, default title, design).<\/li>\n<li><strong>Shortcodes<\/strong> \u2014 <code>[category_list id=\"2\"]<\/code>, <code>[category_list preset=\"my-slug\"]<\/code>, or <code>[category_list]<\/code> (first list). Other attributes override saved defaults.<\/li>\n<li><strong>Front-end design<\/strong> \u2014 heading level, colors, spacing, list markers via CSS custom properties on the wrapper.<\/li>\n<li><strong>Top-level admin menu<\/strong> \u201cCategory lists\u201d (dashicon) with <strong>All lists<\/strong> and <strong>Add new<\/strong>.<\/li>\n<li><strong>Migration<\/strong> \u2014 legacy <code>nzp_scl_config<\/code> \/ <code>nzp_option_name<\/code> data is migrated when possible.<\/li>\n<\/ul>\n\n<p><strong>Bootstrap files<\/strong><\/p>\n\n<ul>\n<li>Root <strong><code>index.php<\/code><\/strong> \u2014 WordPress plugin header, constants, <code>register_activation_hook<\/code>, and <code>require<\/code> of <code>includes\/bootstrap.php<\/code>.<\/li>\n<li><strong><code>includes\/bootstrap.php<\/code><\/strong> \u2014 PSR-style autoload, text domain, <code>Plugin<\/code> bootstrap. Not loadable on its own (guards require WordPress + <code>NZP_CATEGORY_LIST_LOADED<\/code>).<\/li>\n<\/ul>\n\n<h3>Support<\/h3>\n\n<h3>\ud83d\udcac Need Help?<\/h3>\n\n<p>If you have any issues, we\u2019re here for you.<\/p>\n\n<p>\ud83d\udd39 WordPress Support Forum: https:\/\/wordpress.org\/support\/plugin\/categorylist\/<br \/>\n\ud83d\udd39 Direct Support: https:\/\/www.linkedin.com\/in\/nziniwal\/<\/p>\n\n\n\n<h3>\ud83d\udc96 Support This Plugin<\/h3>\n\n<p>If you find this plugin useful, consider supporting development:<\/p>\n\n<p>\ud83d\udc49 Donate here: https:\/\/www.paypal.com\/ncp\/payment\/5PPDH7K9MZSNG<\/p>\n\n<p>Your support helps us improve and add new features!<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>categorylist<\/code> folder to <code>\/wp-content\/plugins\/<\/code> (or ZIP via <strong>Plugins \u2192 Add New \u2192 Upload<\/strong>).<\/li>\n<li>Activate <strong>Simple Category List<\/strong>.<\/li>\n<li>If you upgraded from a build that used <code>category_list.php<\/code> as the main file, <strong>deactivate and activate<\/strong> the plugin once so WordPress loads <code>index.php<\/code>.<\/li>\n<li>Go to <strong>Category lists<\/strong>, create lists, copy shortcodes.<\/li>\n<\/ol>\n\n<p><strong>Translations:<\/strong> place <code>wp-categorylist-show-{locale}.mo<\/code> files in the <code>languages\/<\/code> folder (same folder name as the Text Domain). A blank <code>languages\/index.php<\/code> ships to block direct directory access.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20is%20data%20stored%3F\"><h3>Where is data stored?<\/h3><\/dt>\n<dd><p>Table <code>{prefix}nzp_scl_presets<\/code> (columns: id, name, slug, payload JSON, sort_order). Legacy <code>nzp_scl_config<\/code> is migrated and removed when present.<\/p><\/dd>\n<dt id=\"how%20does%20the%20shortcode%20choose%20a%20list%3F\"><h3>How does the shortcode choose a list?<\/h3><\/dt>\n<dd><ul>\n<li><code>id<\/code> \u2014 database id of the list  <\/li>\n<li><code>preset<\/code> \u2014 slug of the list  <\/li>\n<li>Neither \u2014 first list by sort order \/ id<\/li>\n<\/ul><\/dd>\n<dt id=\"how%20do%20i%20add%20a%20documentation%20link%20on%20the%20plugins%20screen%3F\"><h3>How do I add a Documentation link on the Plugins screen?<\/h3><\/dt>\n<dd><p>add_filter( 'nzp_scl_docs_url', function() { return 'https:\/\/example.com\/docs'; } );<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.3<\/h4>\n\n<ul>\n<li><strong>Security:<\/strong> autoload path containment, preset JSON size cap (save + load), admin save uses <code>check_admin_referer<\/code>, delete handler verifies nonce after resolving id, admin assets only for <code>manage_options<\/code>, no-op if plugin bootstrap is included twice.<\/li>\n<\/ul>\n\n<h4>2.1.2<\/h4>\n\n<ul>\n<li><code>languages\/index.php<\/code> placeholder for safe empty <code>languages\/<\/code> directory.<\/li>\n<li><strong>Plugins screen:<\/strong> optional <strong>Documentation<\/strong> link via filter <code>nzp_scl_docs_url<\/code> (plugin row meta).<\/li>\n<\/ul>\n\n<h4>2.1.1<\/h4>\n\n<ul>\n<li><strong>Single entry file:<\/strong> root <code>index.php<\/code> only (removed <code>category_list.php<\/code> and <code>nzp-simple-category-list.php<\/code>). Runtime lives in <code>includes\/bootstrap.php<\/code>.<\/li>\n<li><strong>Plugins screen:<\/strong> \u201cManage lists\u201d and related action links when configured.<\/li>\n<li>Plugin headers: <code>Requires at least<\/code>, <code>Requires PHP<\/code>, <code>License URI<\/code>.<\/li>\n<li>Readme: installation, file layout.<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Multiple presets, <code>nzp_scl_presets<\/code> table, top-level admin menu, <code>id<\/code> \/ <code>preset<\/code> shortcode attributes.<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Custom table storage, OOP layout, design tokens.<\/li>\n<\/ul>\n\n<h4>1.6.1<\/h4>\n\n<ul>\n<li>Modular includes, transient cache fixes.<\/li>\n<\/ul>","raw_excerpt":"WooCommerce and post taxonomy lists via shortcode. Multiple presets, design controls, custom table storage. Managed under Category lists in admin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/87123","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=87123"}],"author":[{"embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/nziniwal"}],"wp:attachment":[{"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=87123"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=87123"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=87123"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=87123"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=87123"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ro.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=87123"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}