Title: Simple Category List Author: nziniwal Published: ޖޫން 21, 2018 Last modified: އޭޕްރިލް 17, 2026 --- Search plugins ![](https://ps.w.org/categorylist/assets/banner-772x250.jpg?rev=3237255) ![](https://ps.w.org/categorylist/assets/icon-256x256.png?rev=3509218) # Simple Category List By [nziniwal](https://profiles.wordpress.org/nziniwal/) [Download](https://downloads.wordpress.org/plugin/categorylist.1.5.zip) * [Details](https://dv.wordpress.org/plugins/categorylist/#description) * [Reviews](https://dv.wordpress.org/plugins/categorylist/#reviews) * [Installation](https://dv.wordpress.org/plugins/categorylist/#installation) * [Development](https://dv.wordpress.org/plugins/categorylist/#developers) [Support](https://wordpress.org/support/plugin/categorylist/) ## Description **Simple Category List** is built for production sites: multiple presets, a clear admin UI, transient-backed term queries, and optional per-shortcode overrides. **Good for:** WooCommerce product categories and tags, blog categories, custom post types, any public taxonomy (e.g. `product_cat`, `category`, custom taxonomies), hierarchical or flat term lists, and theme builders that support shortcodes. _WordPress.org allows only five plugin tags; related terms above help people find this page in search._ **Features** * **Multiple lists** — each row has a numeric **id**, a URL **slug**, and JSON settings (taxonomy, exclude list, default title, design). * **Shortcodes** — `[category_list id="2"]`, `[category_list preset="my-slug"]`, or `[category_list]` (first list). Other attributes override saved defaults. * **Front-end design** — heading level, colors, spacing, list markers via CSS custom properties on the wrapper. * **Top-level admin menu** “Category lists” (dashicon) with **All lists** and ** Add new**. * **Migration** — legacy `nzp_scl_config` / `nzp_option_name` data is migrated when possible. **Bootstrap files** * Root **`index.php`** — WordPress plugin header, constants, `register_activation_hook`, and `require` of `includes/bootstrap.php`. * **`includes/bootstrap.php`** — PSR-style autoload, text domain, `Plugin` bootstrap. Not loadable on its own (guards require WordPress + `NZP_CATEGORY_LIST_LOADED`). ### Support ### 💬 Need Help? If you have any issues, we’re here for you. 🔹 WordPress Support Forum: https://wordpress.org/support/plugin/categorylist/ 🔹 Direct Support: https://www.linkedin.com/in/nziniwal/ ### 💖 Support This Plugin If you find this plugin useful, consider supporting development: 👉 Donate here: https://www.paypal.com/ncp/payment/5PPDH7K9MZSNG Your support helps us improve and add new features! ## Screenshots * [[ * **Category lists** — table of lists and shortcodes. * [[ * **Add / Edit list** — shortcode defaults and design. * [[ * [[ * [[ ## Installation 1. Upload the `categorylist` folder to `/wp-content/plugins/` (or ZIP via **Plugins Add New Upload**). 2. Activate **Simple Category List**. 3. If you upgraded from a build that used `category_list.php` as the main file, ** deactivate and activate** the plugin once so WordPress loads `index.php`. 4. Go to **Category lists**, create lists, copy shortcodes. **Translations:** place `wp-categorylist-show-{locale}.mo` files in the `languages/` folder (same folder name as the Text Domain). A blank `languages/index.php` ships to block direct directory access. ## FAQ ### Where is data stored? Table `{prefix}nzp_scl_presets` (columns: id, name, slug, payload JSON, sort_order). Legacy `nzp_scl_config` is migrated and removed when present. ### How does the shortcode choose a list? * `id` — database id of the list * `preset` — slug of the list * Neither — first list by sort order / id ### How do I add a Documentation link on the Plugins screen? add_filter( ‘nzp_scl_docs_url’, function() { return ‘https://example.com/docs’; }); ## Reviews ![](https://secure.gravatar.com/avatar/57bd060e4041ed9e6b85584764c654bce742c01c49d4ac1b03dba73ee046e6e7? s=60&d=retro&r=g) ### 󠀁[Super Plugin](https://wordpress.org/support/topic/super-plugin-625/)󠁿 [mayu11](https://profiles.wordpress.org/mayu11/) މެއި 17, 2019 it is easy to use and perfect solution in minutes! ![](https://secure.gravatar.com/avatar/0dd4ec10c39f5a7535c224652adebb196f390131d7a8a06e014b45930cda956c? s=60&d=retro&r=g) ### 󠀁[Nice and awesome Plugin](https://wordpress.org/support/topic/nice-and-awesome-plugin/)󠁿 [nziniwal](https://profiles.wordpress.org/nziniwal/) ޖޫން 26, 2018 1 reply Every one can install this plugin and easily use on the website. Very helpful plugin for category listing. User friendly plugin. Thanks. [ Read all 2 reviews ](https://wordpress.org/support/plugin/categorylist/reviews/) ## Contributors & Developers “Simple Category List” is open source software. The following people have contributed to this plugin. Contributors * [ nziniwal ](https://profiles.wordpress.org/nziniwal/) * [ nilesh ](https://profiles.wordpress.org/nilesh/) [Translate “Simple Category List” into your language.](https://translate.wordpress.org/projects/wp-plugins/categorylist) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/categorylist/), check out the [SVN repository](https://plugins.svn.wordpress.org/categorylist/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/categorylist/) by [RSS](https://plugins.trac.wordpress.org/log/categorylist/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.1.3 * **Security:** autoload path containment, preset JSON size cap (save + load), admin save uses `check_admin_referer`, delete handler verifies nonce after resolving id, admin assets only for `manage_options`, no-op if plugin bootstrap is included twice. #### 2.1.2 * `languages/index.php` placeholder for safe empty `languages/` directory. * **Plugins screen:** optional **Documentation** link via filter `nzp_scl_docs_url`( plugin row meta). #### 2.1.1 * **Single entry file:** root `index.php` only (removed `category_list.php` and` nzp-simple-category-list.php`). Runtime lives in `includes/bootstrap.php`. * **Plugins screen:** “Manage lists” and related action links when configured. * Plugin headers: `Requires at least`, `Requires PHP`, `License URI`. * Readme: installation, file layout. #### 2.1.0 * Multiple presets, `nzp_scl_presets` table, top-level admin menu, `id` / `preset` shortcode attributes. #### 2.0.0 * Custom table storage, OOP layout, design tokens. #### 1.6.1 * Modular includes, transient cache fixes. ## Meta * Version **1.5** * Last updated **3 weeks ago** * Active installations **20+** * WordPress version ** 5.8 or higher ** * Tested up to **6.8.5** * PHP version ** 8.0 or higher ** * Language * [English (US)](https://wordpress.org/plugins/categorylist/) * Tags * [categories](https://dv.wordpress.org/plugins/tags/categories/)[posts](https://dv.wordpress.org/plugins/tags/posts/) [shortcode](https://dv.wordpress.org/plugins/tags/shortcode/)[taxonomy](https://dv.wordpress.org/plugins/tags/taxonomy/) [woocommerce](https://dv.wordpress.org/plugins/tags/woocommerce/) * [Advanced View](https://dv.wordpress.org/plugins/categorylist/advanced/) ## Ratings 5 out of 5 stars. * [ 2 5-star reviews ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/categorylist/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/categorylist/reviews/) ## Contributors * [ nziniwal ](https://profiles.wordpress.org/nziniwal/) * [ nilesh ](https://profiles.wordpress.org/nilesh/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/categorylist/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/ncp/payment/5PPDH7K9MZSNG)