Title: AlphaListing
Author: Ethan Lin
Published: <strong>2025 年 3 月 12 日</strong>
Last modified: 2025 年 12 月 8 日

---

搜索插件

![](https://ps.w.org/alphalisting/assets/banner-772x250.jpg?rev=3254888)

![](https://ps.w.org/alphalisting/assets/icon-256x256.png?rev=3254888)

# AlphaListing

 作者：[Ethan Lin](https://profiles.wordpress.org/eslin87/)

[下载](https://downloads.wordpress.org/plugin/alphalisting.4.3.7.zip)

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

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

## 描述

Display posts, pages, and terms alphabetically in a Rolodex-, catalog-, or directory-
style list with the AlphaListing plugin!

This plugin includes a block and shortcode for the list, along with a widget for
linking to the list from any location on a site. If a letter has no associated pages,
the widget will display the letter unlinked, while the list page will omit the letter
entirely.

Show posts from any single or multiple post types, including built-in posts and 
pages. Post types from plugins like WooCommerce products are also supported. Alternatively,
display terms such as categories or tags.

_This plugin is based on the original **A-Z Listing** by Lucy (formerly Dani) Llewellyn,
which is no longer maintained. Custom templates built for the original plugin may
not work reliably with this version. For the most up-to-date example template, see
the [example template](https://raw.githubusercontent.com/Lin87/alphalisting/refs/heads/main/templates/a-z-listing.example.php)._

### Documentation

Comprehensive documentation is now available:

 * [Overview](https://github.com/Lin87/alphalisting/wiki)
 * [Installation](https://github.com/Lin87/alphalisting/wiki/Installation)
 * [Gutenberg block usage](https://github.com/Lin87/alphalisting/wiki/Gutenberg-Block)
 * [Shortcode reference](https://github.com/Lin87/alphalisting/wiki/Shortcode-References)
 * [PHP usage](https://github.com/Lin87/alphalisting/wiki/PHP-Usage)
 * [Templates and theming](https://github.com/Lin87/alphalisting/wiki/Templates-and-Theming)
 * [Frequently asked questions](https://github.com/Lin87/alphalisting/wiki/FAQs)

## 屏幕截图

 * [[
 * An example of the index listing page
 * [[
 * The Widget is shown here

## 区块

该插件提供了 1 个区块.

 *   AlphaListing

## 安装

This section describes how to install the plugin and get it working.

#### Requirements

 1. PHP 8.0 or higher is required.
 2. The plugin requires mbstring to be enabled in the PHP installation. Without this
    feature, the plugin may behave unexpectedly or fail.

#### Instructions

 1. Upload the `alphalisting` folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the “Plugins” menu in WordPress.
 3. Use the AlphaListing block in the (Gutenberg) block editor or the `[alphalisting]`
    shortcode on the desired page or post.
 4. (Optional) Add the A-Z Site Map widget to a sidebar.

## 评价

![](https://secure.gravatar.com/avatar/6b003c88f34dedb7ed9d7b106d712449e533c01bcf77d218c832f0766a5e0e25?
s=60&d=retro&r=g)

### 󠀁[A-Z Indexing](https://wordpress.org/support/topic/a-z-indexing/)󠁿

 [cheryanne](https://profiles.wordpress.org/cheryanne/) 2026 年 2 月 12 日

Thank you very much for creating this fork – I loved Dani’s original but removed
it after it was abandoned. Thanks again for all your efforts.

![](https://secure.gravatar.com/avatar/6b023a8915aceb4085e63f22d4515cdaf272ac95066e6cd4bb75fc1d86b9b122?
s=60&d=retro&r=g)

### 󠀁[Works like a charm!](https://wordpress.org/support/topic/works-like-a-charm-2436/)󠁿

 [Ruskin](https://profiles.wordpress.org/hedley/) 2026 年 1 月 12 日

I recently noticed that A-Z Listing appears to be abandoned, so I was happy to see
that Ethan Lin had forked it. Transition to the new plugin could not have been easier,
and so far it seems to work perfectly. This is my third A-Z plugin (I started with
WP-Snap years ago, which was also abandoned and replaced by A-Z Listing). Thanks
Ethan!

![](https://secure.gravatar.com/avatar/51b84b1df3ea44bbd12bc6122419e583464f3a67c25659a0bcd759c0d21ebfca?
s=60&d=retro&r=g)

### 󠀁[Ersatz für AZindex](https://wordpress.org/support/topic/ersatz-fur-azindex/)󠁿

 [rroeske](https://profiles.wordpress.org/rroeske/) 2025 年 10 月 29 日

Hello Ethan, I found your plugin today, and it seems to be exactly what I’m looking
for. I’ve been using AZIndex for about 15 years, which is no longer being developed.
I’m testing it now and will keep you updated… Thanks for your work. Update 29.10.2025:
Hi Ethan, I’ve been testing your plugin for a while now and I’m thrilled. It’s easy
to use and does exactly what it’s supposed to. Thanks!

![](https://secure.gravatar.com/avatar/5fc1f9c26b4dc3568084f5aa2a5716b447404c4fbb03d996fc48d45c9c3ace53?
s=60&d=retro&r=g)

### 󠀁[Excellent option for a-z product listings index](https://wordpress.org/support/topic/excellent-option-for-a-z-product-listings-index/)󠁿

 [Martin Freisinger](https://profiles.wordpress.org/martyshka/) 2025 年 10 月 3 
日

Exactly the plugin I was looking for to create a smooth listing of all my shop’s
products. It is lightweight and straightforward. Friendly and fast support! Highly
recommended!

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

## 贡献者及开发者

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

贡献者

 *   [ Ethan Lin ](https://profiles.wordpress.org/eslin87/)

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

### 对开发感兴趣吗?

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

## 更新日志

#### 4.3.7

 * Bugfix: harden column layout attribute sanitization.
 * Bugfix: fix parent selector attribute wiring in block editor.
 * Bugfix: harden widget update sanitization.
 * Bugfix: fix get_item_meta to handle plural item prefixes.
 * New: add exclude post and term IDs fields to the block settings.

#### 4.3.6

 * `[alphalisting exclude-terms]` now accepts explicit term listings and consistently
   filters by numeric term IDs for reliable exclusions.
 * Fixed `alphalisting_cache()` so template tags instantiate the namespaced query
   class without fatal errors.
 * Improved pagination to keep multi-page queries from skipping items and restored
   the unknown “#” bucket in edge cases.
 * Added an ASCII fallback when `mbstring` is unavailable so basic listings still
   render correctly.
 * Code improvements covering additional internal cleanups.

#### 4.3.5

 * Bugfix: fix critical error issues caused by namespaced functions in the files
   within the functions directory.
 * Bugfix: correct the conditional logic inside the `get_the_item_object()` function
   of the `Query` class by changing the checks for `post` to `posts` and `term` 
   to `terms`.

#### 4.3.4

 * Add namespace AlphaListing to all necessary PHP files.

#### 4.3.3

 * Bugfix: fix widget name not displaying on Widgets page.
 * Bugfix: fix widget autocomplete input fields.
 * Remove hardcoded admin-ajax.php URLs.
 * Remove the minor version from the “Tested up to” value in the readme.txt.
 * Move inline CSS style as style attribute in the template files.
 * Add permission callback to register_rest_route.
 * Remove load_plugin_textdomain as it is no longer necessary.
 * Prevent direct file access to plugin files.

#### 4.3.2

 * Bugfix: Fix the listing order under grouped letters so that items are now correctly
   sorted alphabetically in ascending order.
 * Update packages and fix deprecation warnings

#### Previous

This plugin is based on the original A-Z Listing by Lucy (formerly Dani) Llewellyn.
The last version released by Lucy was 4.3.1. Starting from version 4.3.2, this plugin
has diverged from the original A-Z Listing. For the full release history, including
Lucy’s releases, refer to the [changelog.md](https://github.com/Lin87/alphalisting/blob/main/changelog.md)
file.

## 额外信息

 *  版本 **4.3.7**
 *  最后更新：**4 月前**
 *  活跃安装数量 **400+**
 *  WordPress 版本 ** 5.0 或更高版本 **
 *  已测试的最高版本为 **6.9.4**
 *  PHP 版本 ** 8.0 或更高版本 **
 *  语言
 * [English (US)](https://wordpress.org/plugins/alphalisting/)
 * 标签
 * [a to z](https://cn.wordpress.org/plugins/tags/a-to-z/)[a-z](https://cn.wordpress.org/plugins/tags/a-z/)
   [index](https://cn.wordpress.org/plugins/tags/index/)[listing](https://cn.wordpress.org/plugins/tags/listing/)
   [widget](https://cn.wordpress.org/plugins/tags/widget/)
 *  [高级视图](https://cn.wordpress.org/plugins/alphalisting/advanced/)

## 评级

 5 星（最高 5 星）。

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

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

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

## 贡献者

 *   [ Ethan Lin ](https://profiles.wordpress.org/eslin87/)

## 支持

最近两个月解决的问题：

     总计 1，已解决 1

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