[WordPress] 外掛分享： Alphabetical Pagination

Name: Alphabetical Pagination
Rating: 2.3 (3 reviews)
Author: mansoormunib

30+

安裝啟用

★★☆☆☆

2.3/5 分（3 則評價）

8 天前

最後更新

—

問題解決

WordPress 5.0+ PHP 8.1+ v2.4.2 上架：2012-10-24

內容目錄

1 內容簡介
2 外掛標籤
3 開發者團隊
4 原文外掛簡介
5 延伸相關外掛

內容簡介

WP-SNAP!（WordPress 瀏覽按字母排序文章系統）可以在類別或頁面模板檔案上創建文章標題的按字母排序清單。通過使用字母本身，可以在 WP-SNAP！生成的列表中進行導航。（例如，如果訪客在字母 D 上單擊，任何以該字母開頭的文章標題都會被展示。） WP-SNAP！將適用於任何 WordPress 3.0.1 或更高版本的網站，但特別適用於管理詞彙表、索引、評論或目錄。

WP-SNAP! 提供了三種不同的導航樣式以及與自定義永久鏈接和 WordPress loop的整合。插件選項可以在整個網站和模板上管理，並且可以將結果限制在一個類別中或擴大至包括子類別。聰明的網頁開發人員不應該在將 WP-SNAP！無縫集成到其最新項目中遇到任何問題。還添加了選項，允許自定義 CSS 類名稱和 HTML 標記外觀。

外掛標籤

index glossary navigation pagination alphabetical

開發者團隊

👤 mansoormunib

⬇ 下載最新版 (v2.4.2) 或搜尋安裝

① 下載 ZIP → 後台「外掛 › 安裝外掛 › 上傳外掛」
② 後台搜尋「Alphabetical Pagination」→ 直接安裝（推薦）

📦 歷史版本下載

2.4.0 2.4.1 2.4.2 trunk

原文外掛簡介

Alphabetical Pagination (formerly WP-SNAP Extended!) builds an alphabetical index of post titles across any public post type. Visitors jump straight to a letter (A, B, C …), browse a paginated list of matching posts, and click through to each post’s permalink.
Built for modern WordPress: PHP 8.1+ typed classes, schema-validated options, prepared SQL throughout, semantic markup, no jQuery dependency, no bundled CSS framework, zero front-end JS by default.
Why use it

Modern PHP 8.1+ architecture — typed final classes under includes/, every superglobal sanitised, every echoed value escaped, every DB call prepared.
Three embedding surfaces — [alphabetical_pagination] shortcode, alphabetical_pagination() template tag, and a native Gutenberg block (wp-snap-ext/index).
WooCommerce auto-mount — one click renders the index above the shop loop or product category archives via the native woocommerce_before_shop_loop action. No DOM hacks, no posts_where SQL filter injection.
15 bundled alphabet packs — English, Arabic, Chinese (Pinyin), German, Spanish, French, Greek, Hebrew, Hindi, Hungarian, Korean (Hangul Jamo), Russian, Thai, Turkish, Urdu.
WPML + Polylang aware — the letter cache keys on current language, so translated post sets render and cache per-language automatically.
REST API — GET /wp-json/wp-snap-ext/v1/letters and /posts for headless / React / app integrations.
Documented developer hook API — do_action/apply_filters at every render path so agencies can customise without forking.
Transient letter-availability cache — letter counts cached as transients, busted on save_post. Configurable TTL.
ACF excerpt fallback — supports top-level, sub-field, and deep flexible-content / repeater / group lookups via recursive get_fields() walk.
WCAG 2.1 AA —

, aria-current="page", aria-disabled on empty letters, explicit role="list" / role="listitem" (Safari + VoiceOver list-stripping fix), descriptive per-letter aria-label, visible focus outlines.
Zero front-end JS dependency by default — no jQuery, no Bootstrap, no FontAwesome. Stylesheet is ~1 KB.

2.3.0 feature surface

Gutenberg block — server-rendered wp-snap-ext/index block (no JS build pipeline required). Renders identically to the shortcode + template tag.
WooCommerce auto-mount — toggle in Settings → Alphabetical Pagination → WooCommerce. Mount hook selectable: woocommerce_before_shop_loop (default), woocommerce_archive_description, or woocommerce_before_main_content.
REST API endpoints — /wp-json/wp-snap-ext/v1/letters returns [{ letter, count, href }]; /wp-json/wp-snap-ext/v1/posts returns paginated post payloads.
Developer hooks:

do_action( 'wp_snap_ext/before_render', $context )
apply_filters( 'wp_snap_ext/pre_render', $html, $post_type, $display, $args ) — short-circuit
apply_filters( 'wp_snap_ext/query_args', $args, $context )
apply_filters( 'wp_snap_ext/letter_href', $href, $letter, $base )
apply_filters( 'wp_snap_ext/excerpt', $excerpt, $post_id )
apply_filters( 'wp_snap_ext/render', $html, $post_type, $display, $args )
do_action( 'wp_snap_ext/after_render', $html, $context )

Transient letter-availability cache — keyed by post_type, taxonomy, term, current language, alphabet pack, and menumisc setting. Invalidated on save_post, deleted_post, trashed_post, untrashed_post, and switch_blog. Default TTL 1 hour, configurable.
WPML + Polylang awareness — cache key includes wpml_current_language or pll_current_language(); WP_Query runs with suppress_filters => false so translated post sets get filtered.
15 multi-language alphabet packs — pick a script from the dropdown, the freeform Local Alphabet field is overwritten on save.
Appearance toggles — Horizontal / Vertical layout, Uppercase / Lowercase letter case, Disable Empty Letters (renders empty buckets as muted + aria-disabled), Hide Pagination If One Page.
Generic taxonomy filter — restrict the index to any registered taxonomy + term (beyond the legacy cat/tag args).
Meta-key intra-bucket sorting — set a post meta key + ASC / DESC to override post_title ordering within each letter bucket. Buckets still derive from post_title.
Per-page override map — { post_id => items_per_page } so /glossary can render 50 items per page while /products renders 20.
DOM auto-injection — for themes that don’t expose a hook: render the index in the footer and move it into a CSS selector via ~300 bytes of vanilla JS. No jQuery.

Backwards compatibility

The legacy wp_snap() template tag is preserved as a thin alias.
Legacy URL parameters ?snap=, ?cp=, and ?snap_paged= continue to be honoured alongside the canonical ?alpha_order= and ?alpha_paged=.
Legacy key_snap_* option keys are migrated to wp_snap_ext_* automatically on activation.

Usage
Gutenberg block
Add the Alphabetical Pagination block from the block inserter (Widgets category) and configure attributes through the block sidebar:

postType — post type to index (default post).
menu — 1, 2, or 3 (see menu styles in the admin panel).
firstload — all, none, or recent.
category — category ID or all.
includeChildren — include category children.
taxonomy + term — restrict the index to a specific term of any registered taxonomy.
display — true (default) renders the post list under the letter nav; false renders only the letter nav.

The block is fully server-rendered — its HTML matches the shortcode and template tag output byte for byte, and there is no JS build pipeline behind it.
Shortcode
Drop the shortcode into any post, page, widget, or Site Editor template part:
[alphabetical_pagination]

All template-tag arguments are exposed as shortcode attributes:
[alphabetical_pagination cat="15" child="true" menu="2" firstload="recent" post_type="post" display="true"]

Attribute reference:

cat — category ID, or all.
child — true to include category children (default false).
menu — 1, 2 or 3 (see menu styles in the admin panel).
firstload — all, none or recent.
post_parent — restrict to posts with a given parent ID.
post_type — defaults to post. Whitelisted against registered post types.
display — true (default) renders the post list under the letter nav; false renders only the letter nav.

The shortcode handler buffers its output through ob_start() / ob_get_clean(), so the index renders exactly where you place the shortcode rather than breaking out of the surrounding layout.
Theme template tag
For deeper theme integration, call alphabetical_pagination() directly from a template file. The legacy wp_snap() name is retained as a backwards-compatible alias.

Passing arguments works the same as the original wp_snap() API:

Render an alphabetical index over a custom post type:

Render only the letter navigation (without the post list):

URL query parameters
Once embedded, the plugin reads two query parameters on the front end:

?alpha_order=A — the active letter (or bucket, like A-D). alpha_order=misc selects the # bucket of non-alphanumeric titles.
?alpha_paged=2 — the active pagination page.

These are isolated to the plugin (they do not collide with WordPress’s own paged / tag / cat query vars). The legacy ?snap= / ?cp= parameters from earlier versions are still accepted so existing bookmarks keep working.
Gutenberg block attributes
Attribute
Type
Default
Notes
postType
string
post
Any registered public post type.
menu
number
1
1, 2, or 3.
firstload
string
recent
all / none / recent.
category
string
“
Category ID or all.
includeChildren
boolean
false
Include category children.
taxonomy
string
“
Any registered taxonomy slug.
term
number
0
Term ID for the taxonomy above.
display
boolean
true
Render the post list under the nav.
The block supports wide and full alignment via the supports.align declaration in block.json.
REST API
Two read-only public routes under /wp-json/wp-snap-ext/v1/:
GET /letters
Query params: post_type (default post), taxonomy, term.
Response (200 OK):
[ { "letter": "A", "count": 12, "href": "https://example.com/?alpha_order=A" }, … ]

GET /posts
Query params: post_type, taxonomy, term, letter (single character or #), page (default 1), per_page (default 10, max 100).
Response (200 OK):
{ "posts": [ { "id": 42, "title": "...", "permalink": "...", "excerpt": "..." } ], "total": 75, "total_pages": 8, "page": 1, "per_page": 10 }

Toggle the endpoints on / off under Settings → Alphabetical Pagination → REST API & Cache. Lockdown plugins that block public REST surface should leave the toggle off.
WooCommerce auto-mount
Enable Settings → Alphabetical Pagination → WooCommerce → Auto-mount on Shop. The index renders above the shop loop (or after the archive description / before main content — pick the mount hook from the dropdown) on:

the WooCommerce shop archive,
product taxonomy archives (e.g. /product-category/food).

The mount uses native WooCommerce actions, never posts_where, so it does not collide with caching plugins, SEO plugins, or multilingual plugins that also filter WP_Query.
Developer hooks
Customise behaviour without forking through the following hooks (added in 2.3.0):
add_filter( 'wp_snap_ext/query_args', function( $args, $context ) {
$args['meta_query'] = [ [ 'key' => 'featured', 'value' => '1' ] ];
return $args;
}, 10, 2 );

add_filter( 'wp_snap_ext/letter_href', function( $href, $letter, $base ) {
return str_replace( '?alpha_order=', '#letter/', $href );
}, 10, 3 );

add_filter( 'wp_snap_ext/excerpt', function( $excerpt, $post_id ) {
return wp_trim_words( $excerpt, 25, '…' );
}, 10, 2 );

Full list:

do_action( 'wp_snap_ext/before_render', $context ) — fires before the index renders.
apply_filters( 'wp_snap_ext/pre_render', $html, $post_type, $display, $args ) — short-circuit; return a string to replace the HTML.
apply_filters( 'wp_snap_ext/query_args', $args, $context ) — mutate WP_Query arguments.
apply_filters( 'wp_snap_ext/letter_href', $href, $letter, $base ) — rewrite letter link hrefs (router compatibility).
apply_filters( 'wp_snap_ext/excerpt', $excerpt, $post_id ) — post-process the resolved excerpt.
apply_filters( 'wp_snap_ext/render', $html, $post_type, $display, $args ) — final filter on rendered HTML.
do_action( 'wp_snap_ext/after_render', $html, $context ) — fires after the index has rendered.

Backend settings
Under Settings → Alphabetical Pagination you’ll find:

Navigational Menu Options — Local Alphabet, Menu Style, Group Posts, Recent Posts, CSS class names, Ignore When Alphabetizing.
Presentational Options — Fancy URLs, Fancy URL Name, Tabs.
Pagination → Items Per Page — integer, defaults to 10. Registered through the WordPress Settings API and sanitised with absint().
Content Fallback → ACF Excerpt Fallback — checkbox. When on, posts without a native WordPress excerpt fall back to the value of an ACF field instead of the trimmed post content. ACF lookup chain: get_field() → get_sub_field() → recursive get_fields() walk for deeply nested flexible-content / repeater / group sub-fields.
Content Fallback → ACF Field Name — the field name (or key) read by get_field() when the toggle is enabled. The plugin gracefully no-ops if ACF (or ACF Pro) is not installed.
Appearance → Layout — Horizontal or Vertical letter strip.
Appearance → Letter Case — Uppercase or Lowercase.
Appearance → Disable Empty Letters — renders empty buckets as muted + aria-disabled, with the anchor stripped.
Appearance → Hide Pagination If One Page — skips the Previous/Next strip when the filtered set fits on one page.
Language → Alphabet Pack — pick from 15 bundled scripts. Selecting a pack overwrites the freeform Local Alphabet field on save.
Sorting → Meta Key — post meta key used for intra-bucket ordering instead of post_title.
Sorting → Meta Order — ASC / DESC.
Taxonomy Filter → Taxonomy + Term ID — restrict the index to a single term of any registered taxonomy.
WooCommerce → Auto-mount on Shop + Mount Hook — see the WooCommerce section above.
DOM Injection → Enable DOM Injection + Target Selector — print the index in the footer and move it into a CSS selector via vanilla JS.
REST API & Cache → Enable REST Endpoints + Cache TTL — see the REST API section above.

延伸相關外掛

文章

文章

內容簡介

外掛標籤

開發者團隊

原文外掛簡介

Apply Filters