Title: Simple Category List
Author: nziniwal
Published: <strong>2018 年 6 月 21 日</strong>
Last modified: 2026 年 4 月 17 日

---

搜索插件

![](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

 作者：[nziniwal](https://profiles.wordpress.org/nziniwal/)

[下载](https://downloads.wordpress.org/plugin/categorylist.1.5.zip)

 * [详情](https://cn.wordpress.org/plugins/categorylist/#description)
 * [评价](https://cn.wordpress.org/plugins/categorylist/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/categorylist/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/categorylist/#developers)

 [支持](https://wordpress.org/support/plugin/categorylist/)

## 描述

**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!

## 屏幕截图

 * [[
 * **Category lists** — table of lists and shortcodes.
 * [[
 * **Add / Edit list** — shortcode defaults and design.
 * [[
 * [[
 * [[

## 安装

 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.

## 常见问题

### 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’; });

## 评价

![](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/) 2019 年 5 月 17 日

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/) 2018 年 6 月 26 日 1 回复

Every one can install this plugin and easily use on the website. Very helpful plugin
for category listing. User friendly plugin. Thanks.

 [ 阅读所有2条评价 ](https://wordpress.org/support/plugin/categorylist/reviews/)

## 贡献者及开发者

「Simple Category List」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ nziniwal ](https://profiles.wordpress.org/nziniwal/)
 *   [ nilesh ](https://profiles.wordpress.org/nilesh/)

[帮助将「Simple Category List」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/categorylist)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/categorylist/)，查看
[SVN仓库](https://plugins.svn.wordpress.org/categorylist/)，或通过[RSS](https://plugins.trac.wordpress.org/log/categorylist/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/categorylist/)。

## 更新日志

#### 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.

## 额外信息

 *  版本 **1.5**
 *  最后更新：**2 月前**
 *  活跃安装数量 **20+**
 *  WordPress 版本 ** 5.8 或更高版本 **
 *  已测试的最高版本为 **6.8.5**
 *  PHP 版本 ** 8.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/categorylist/)
 * 标签
 * [categories](https://cn.wordpress.org/plugins/tags/categories/)[posts](https://cn.wordpress.org/plugins/tags/posts/)
   [shortcode](https://cn.wordpress.org/plugins/tags/shortcode/)[taxonomy](https://cn.wordpress.org/plugins/tags/taxonomy/)
   [woocommerce](https://cn.wordpress.org/plugins/tags/woocommerce/)
 *  [高级视图](https://cn.wordpress.org/plugins/categorylist/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  2 条 5 星评价     ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/categorylist/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/categorylist/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/categorylist/reviews/)

## 贡献者

 *   [ nziniwal ](https://profiles.wordpress.org/nziniwal/)
 *   [ nilesh ](https://profiles.wordpress.org/nilesh/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/categorylist/)

## 捐助

您愿意支持这个插件的发展吗?

 [ 捐助此插件 ](https://www.paypal.com/ncp/payment/5PPDH7K9MZSNG)