{"id":19407,"date":"2012-10-25T07:23:12","date_gmt":"2012-10-25T07:23:12","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-snap-extended\/"},"modified":"2026-06-09T03:39:07","modified_gmt":"2026-06-09T03:39:07","slug":"wp-snap-extended","status":"publish","type":"plugin","link":"https:\/\/cn.wordpress.org\/plugins\/wp-snap-extended\/","author":10002000,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.4.2","stable_tag":"2.4.2","tested":"7.0","requires":"5.0","requires_php":"8.1","requires_plugins":null,"header_name":"Alphabetical pagination","header_author":"Mansoor Munib","header_description":"","assets_banners_color":"","last_updated":"2026-06-09 03:39:07","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/wp-snap-extended\/","header_author_uri":"https:\/\/github.com\/mansoormunib","rating":5,"author_block_rating":0,"active_installs":30,"downloads":5198,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.4.0":{"tag":"2.4.0","author":"mansoormunib","date":"2026-06-09 03:29:04"},"2.4.1":{"tag":"2.4.1","author":"mansoormunib","date":"2026-06-09 03:35:42"},"2.4.2":{"tag":"2.4.2","author":"mansoormunib","date":"2026-06-09 03:39:07"}},"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.4.0","2.4.1","2.4.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3565383,"resolution":"1","location":"assets","locale":"","width":1920,"height":2160}},"screenshots":[]},"plugin_section":[],"plugin_tags":[1406,2409,1403,1753,900],"plugin_category":[43],"plugin_contributors":[84923],"plugin_business_model":[],"class_list":["post-19407","plugin","type-plugin","status-publish","hentry","plugin_tags-alphabetical","plugin_tags-glossary","plugin_tags-index","plugin_tags-navigation","plugin_tags-pagination","plugin_category-customization","plugin_contributors-mansoormunib","plugin_committers-mansoormunib"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wp-snap-extended.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/wp-snap-extended\/assets\/screenshot-1.png?rev=3565383","caption":""}],"raw_content":"\n

Alphabetical Pagination<\/strong> (formerly WP-SNAP Extended!<\/em>) builds an alphabetical index of post titles across any public post type. Visitors jump straight to a letter (A, B, C \u2026), browse a paginated list of matching posts, and click through to each post's permalink.<\/p>\n\n

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.<\/p>\n\n

Why use it<\/h4>\n\n
    \n
  • Modern PHP 8.1+ architecture<\/strong> \u2014 typed final<\/code> classes under includes\/<\/code>, every superglobal sanitised, every echoed value escaped, every DB call prepared.<\/li>\n
  • Three embedding surfaces<\/strong> \u2014 [alphabetical_pagination]<\/code> shortcode, alphabetical_pagination()<\/code> template tag, and a native Gutenberg block (wp-snap-ext\/index<\/code>).<\/li>\n
  • WooCommerce auto-mount<\/strong> \u2014 one click renders the index above the shop loop or product category archives via the native woocommerce_before_shop_loop<\/code> action. No DOM hacks, no posts_where<\/code> SQL filter injection.<\/li>\n
  • 15 bundled alphabet packs<\/strong> \u2014 English, Arabic, Chinese (Pinyin), German, Spanish, French, Greek, Hebrew, Hindi, Hungarian, Korean (Hangul Jamo), Russian, Thai, Turkish, Urdu.<\/li>\n
  • WPML + Polylang aware<\/strong> \u2014 the letter cache keys on current language, so translated post sets render and cache per-language automatically.<\/li>\n
  • REST API<\/strong> \u2014 GET \/wp-json\/wp-snap-ext\/v1\/letters<\/code> and \/posts<\/code> for headless \/ React \/ app integrations.<\/li>\n
  • Documented developer hook API<\/strong> \u2014 do_action<\/code>\/apply_filters<\/code> at every render path so agencies can customise without forking.<\/li>\n
  • Transient letter-availability cache<\/strong> \u2014 letter counts cached as transients, busted on save_post<\/code>. Configurable TTL.<\/li>\n
  • ACF excerpt fallback<\/strong> \u2014 supports top-level, sub-field, and deep flexible-content \/ repeater \/ group lookups via recursive get_fields()<\/code> walk.<\/li>\n
  • WCAG 2.1 AA<\/strong> \u2014 <nav aria-label><\/code>, aria-current=\"page\"<\/code>, aria-disabled<\/code> on empty letters, explicit role=\"list\"<\/code> \/ role=\"listitem\"<\/code> (Safari + VoiceOver list-stripping fix), descriptive per-letter aria-label<\/code>, visible focus outlines.<\/li>\n
  • Zero front-end JS dependency by default<\/strong> \u2014 no jQuery, no Bootstrap, no FontAwesome. Stylesheet is ~1 KB.<\/li>\n<\/ul>\n\n

    2.3.0 feature surface<\/h4>\n\n
      \n
    • Gutenberg block<\/strong> \u2014 server-rendered wp-snap-ext\/index<\/code> block (no JS build pipeline required). Renders identically to the shortcode + template tag.<\/li>\n
    • WooCommerce auto-mount<\/strong> \u2014 toggle in Settings \u2192 Alphabetical Pagination \u2192 WooCommerce<\/strong>. Mount hook selectable: woocommerce_before_shop_loop<\/code> (default), woocommerce_archive_description<\/code>, or woocommerce_before_main_content<\/code>.<\/li>\n
    • REST API endpoints<\/strong> \u2014 \/wp-json\/wp-snap-ext\/v1\/letters<\/code> returns [{ letter, count, href }]<\/code>; \/wp-json\/wp-snap-ext\/v1\/posts<\/code> returns paginated post payloads.<\/li>\n
    • Developer hooks<\/strong>:\n\n
        \n
      • do_action( 'wp_snap_ext\/before_render', $context )<\/code><\/li>\n
      • apply_filters( 'wp_snap_ext\/pre_render', $html, $post_type, $display, $args )<\/code> \u2014 short-circuit<\/li>\n
      • apply_filters( 'wp_snap_ext\/query_args', $args, $context )<\/code><\/li>\n
      • apply_filters( 'wp_snap_ext\/letter_href', $href, $letter, $base )<\/code><\/li>\n
      • apply_filters( 'wp_snap_ext\/excerpt', $excerpt, $post_id )<\/code><\/li>\n
      • apply_filters( 'wp_snap_ext\/render', $html, $post_type, $display, $args )<\/code><\/li>\n
      • do_action( 'wp_snap_ext\/after_render', $html, $context )<\/code><\/li>\n<\/ul><\/li>\n
      • Transient letter-availability cache<\/strong> \u2014 keyed by post_type, taxonomy, term, current language, alphabet pack, and menumisc setting. Invalidated on save_post<\/code>, deleted_post<\/code>, trashed_post<\/code>, untrashed_post<\/code>, and switch_blog<\/code>. Default TTL 1 hour, configurable.<\/li>\n
      • WPML + Polylang awareness<\/strong> \u2014 cache key includes wpml_current_language<\/code> or pll_current_language()<\/code>; WP_Query runs with suppress_filters => false<\/code> so translated post sets get filtered.<\/li>\n
      • 15 multi-language alphabet packs<\/strong> \u2014 pick a script from the dropdown, the freeform Local Alphabet field is overwritten on save.<\/li>\n
      • Appearance toggles<\/strong> \u2014 Horizontal \/ Vertical layout, Uppercase \/ Lowercase letter case, Disable Empty Letters (renders empty buckets as muted + aria-disabled<\/code>), Hide Pagination If One Page.<\/li>\n
      • Generic taxonomy filter<\/strong> \u2014 restrict the index to any registered taxonomy + term (beyond the legacy cat\/tag args).<\/li>\n
      • Meta-key intra-bucket sorting<\/strong> \u2014 set a post meta key + ASC \/ DESC to override post_title ordering within each letter bucket. Buckets still derive from post_title.<\/li>\n
      • Per-page override map<\/strong> \u2014 { post_id => items_per_page }<\/code> so \/glossary can render 50 items per page while \/products renders 20.<\/li>\n
      • DOM auto-injection<\/strong> \u2014 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.<\/li>\n<\/ul>\n\n

        Backwards compatibility<\/h4>\n\n
          \n
        • The legacy wp_snap()<\/code> template tag is preserved as a thin alias.<\/li>\n
        • Legacy URL parameters ?snap=<\/code>, ?cp=<\/code>, and ?snap_paged=<\/code> continue to be honoured alongside the canonical ?alpha_order=<\/code> and ?alpha_paged=<\/code>.<\/li>\n
        • Legacy key_snap_*<\/code> option keys are migrated to wp_snap_ext_*<\/code> automatically on activation.<\/li>\n<\/ul>\n\n

          Usage<\/h3>\n\n

          Gutenberg block<\/h4>\n\n

          Add the Alphabetical Pagination<\/strong> block from the block inserter (Widgets category) and configure attributes through the block sidebar:<\/p>\n\n

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

            The block is fully server-rendered \u2014 its HTML matches the shortcode and template tag output byte for byte, and there is no JS build pipeline behind it.<\/p>\n\n

            Shortcode<\/h4>\n\n

            Drop the shortcode into any post, page, widget, or Site Editor template part:<\/p>\n\n

            [alphabetical_pagination]\n<\/code><\/pre>\n\n
            All template-tag arguments are exposed as shortcode attributes:<\/p>\n\n
            [alphabetical_pagination cat=\"15\" child=\"true\" menu=\"2\" firstload=\"recent\" post_type=\"post\" display=\"true\"]\n<\/code><\/pre>\n\n
            Attribute reference:<\/p>\n\n
              \n
            • cat<\/code> \u2014 category ID, or all<\/code>.<\/li>\n
            • child<\/code> \u2014 true<\/code> to include category children (default false<\/code>).<\/li>\n
            • menu<\/code> \u2014 1, 2 or 3 (see menu styles in the admin panel).<\/li>\n
            • firstload<\/code> \u2014 all<\/code>, none<\/code> or recent<\/code>.<\/li>\n
            • post_parent<\/code> \u2014 restrict to posts with a given parent ID.<\/li>\n
            • post_type<\/code> \u2014 defaults to post<\/code>. Whitelisted against registered post types.<\/li>\n
            • display<\/code> \u2014 true<\/code> (default) renders the post list under the letter nav; false<\/code> renders only the letter nav.<\/li>\n<\/ul>\n\n
              The shortcode handler buffers its output through ob_start()<\/code> \/ ob_get_clean()<\/code>, so the index renders exactly where you place the shortcode rather than breaking out of the surrounding layout.<\/p>\n\n
              Theme template tag<\/h4>\n\n
              For deeper theme integration, call alphabetical_pagination()<\/code> directly from a template file. The legacy wp_snap()<\/code> name is retained as a backwards-compatible alias.<\/p>\n\n
              <?php\nif ( function_exists( 'alphabetical_pagination' ) ) {\n    echo alphabetical_pagination();\n}\n?>\n<\/code><\/pre>\n\n
              Passing arguments works the same as the original wp_snap()<\/code> API:<\/p>\n\n
              <?php\necho alphabetical_pagination( 'cat=15&child=true&firstload=recent' );\n?>\n<\/code><\/pre>\n\n
              Render an alphabetical index over a custom post type:<\/p>\n\n
              <?php\necho alphabetical_pagination( '', 'glossary_term' );\n?>\n<\/code><\/pre>\n\n
              Render only the letter navigation (without the post list):<\/p>\n\n
              <?php\necho alphabetical_pagination( '', 'post', false );\n?>\n<\/code><\/pre>\n\n
              URL query parameters<\/h4>\n\n
              Once embedded, the plugin reads two query parameters on the front end:<\/p>\n\n
                \n
              • ?alpha_order=A<\/code> \u2014 the active letter (or bucket, like A-D<\/code>). alpha_order=misc<\/code> selects the #<\/code> bucket of non-alphanumeric titles.<\/li>\n
              • ?alpha_paged=2<\/code> \u2014 the active pagination page.<\/li>\n<\/ul>\n\n
                These are isolated to the plugin (they do not collide with WordPress's own paged<\/code> \/ tag<\/code> \/ cat<\/code> query vars). The legacy ?snap=<\/code> \/ ?cp=<\/code> parameters from earlier versions are still accepted so existing bookmarks keep working.<\/p>\n\n
                Gutenberg block attributes<\/h4>\n\n\n\n\n  Attribute\n  Type\n  Default\n  Notes\n\n\n\n\n  postType<\/code>\n  string\n  post<\/code>\n  Any registered public post type.\n\n\n  menu<\/code>\n  number\n  1<\/code>\n  1, 2, or 3.\n\n\n  firstload<\/code>\n  string\n  recent<\/code>\n  all<\/code> \/ none<\/code> \/ recent<\/code>.\n\n\n  category<\/code>\n  string\n  ``\n  Category ID or all<\/code>.\n\n\n  includeChildren<\/code>\n  boolean\n  false<\/code>\n  Include category children.\n\n\n  taxonomy<\/code>\n  string\n  ``\n  Any registered taxonomy slug.\n\n\n  term<\/code>\n  number\n  0<\/code>\n  Term ID for the taxonomy above.\n\n\n  display<\/code>\n  boolean\n  true<\/code>\n  Render the post list under the nav.\n\n\n\n\n
                The block supports wide<\/code> and full<\/code> alignment via the supports.align<\/code> declaration in block.json<\/code>.<\/p>\n\n
                REST API<\/h4>\n\n
                Two read-only public routes under \/wp-json\/wp-snap-ext\/v1\/<\/code>:<\/p>\n\n
                GET \/letters<\/code><\/strong><\/p>\n\n
                Query params: post_type<\/code> (default post<\/code>), taxonomy<\/code>, term<\/code>.<\/p>\n\n
                Response (200 OK):<\/p>\n\n
                [ { \"letter\": \"A\", \"count\": 12, \"href\": \"https:\/\/example.com\/?alpha_order=A\" }, \u2026 ]\n<\/code><\/pre>\n\n
                GET \/posts<\/code><\/strong><\/p>\n\n
                Query params: post_type<\/code>, taxonomy<\/code>, term<\/code>, letter<\/code> (single character or #<\/code>), page<\/code> (default 1), per_page<\/code> (default 10, max 100).<\/p>\n\n
                Response (200 OK):<\/p>\n\n
                { \"posts\": [ { \"id\": 42, \"title\": \"...\", \"permalink\": \"...\", \"excerpt\": \"...\" } ], \"total\": 75, \"total_pages\": 8, \"page\": 1, \"per_page\": 10 }\n<\/code><\/pre>\n\n
                Toggle the endpoints on \/ off under Settings \u2192 Alphabetical Pagination \u2192 REST API & Cache<\/strong>. Lockdown plugins that block public REST surface should leave the toggle off.<\/p>\n\n
                WooCommerce auto-mount<\/h4>\n\n
                Enable Settings \u2192 Alphabetical Pagination \u2192 WooCommerce \u2192 Auto-mount on Shop<\/strong>. The index renders above the shop loop (or after the archive description \/ before main content \u2014 pick the mount hook from the dropdown) on:<\/p>\n\n
                  \n
                • the WooCommerce shop archive,<\/li>\n
                • product taxonomy archives (e.g. \/product-category\/food<\/code>).<\/li>\n<\/ul>\n\n
                  The mount uses native WooCommerce actions, never posts_where<\/code>, so it does not collide with caching plugins, SEO plugins, or multilingual plugins that also filter WP_Query.<\/p>\n\n
                  Developer hooks<\/h4>\n\n
                  Customise behaviour without forking through the following hooks (added in 2.3.0):<\/p>\n\n
                  add_filter( 'wp_snap_ext\/query_args', function( $args, $context ) {\n    $args['meta_query'] = [ [ 'key' => 'featured', 'value' => '1' ] ];\n    return $args;\n}, 10, 2 );\n\nadd_filter( 'wp_snap_ext\/letter_href', function( $href, $letter, $base ) {\n    return str_replace( '?alpha_order=', '#letter\/', $href );\n}, 10, 3 );\n\nadd_filter( 'wp_snap_ext\/excerpt', function( $excerpt, $post_id ) {\n    return wp_trim_words( $excerpt, 25, '\u2026' );\n}, 10, 2 );\n<\/code><\/pre>\n\n
                  Full list:<\/p>\n\n
                    \n
                  • do_action( 'wp_snap_ext\/before_render', $context )<\/code> \u2014 fires before the index renders.<\/li>\n
                  • apply_filters( 'wp_snap_ext\/pre_render', $html, $post_type, $display, $args )<\/code> \u2014 short-circuit; return a string to replace the HTML.<\/li>\n
                  • apply_filters( 'wp_snap_ext\/query_args', $args, $context )<\/code> \u2014 mutate WP_Query arguments.<\/li>\n
                  • apply_filters( 'wp_snap_ext\/letter_href', $href, $letter, $base )<\/code> \u2014 rewrite letter link hrefs (router compatibility).<\/li>\n
                  • apply_filters( 'wp_snap_ext\/excerpt', $excerpt, $post_id )<\/code> \u2014 post-process the resolved excerpt.<\/li>\n
                  • apply_filters( 'wp_snap_ext\/render', $html, $post_type, $display, $args )<\/code> \u2014 final filter on rendered HTML.<\/li>\n
                  • do_action( 'wp_snap_ext\/after_render', $html, $context )<\/code> \u2014 fires after the index has rendered.<\/li>\n<\/ul>\n\n
                    Backend settings<\/h4>\n\n
                    Under Settings \u2192 Alphabetical Pagination<\/strong> you'll find:<\/p>\n\n
                      \n
                    • Navigational Menu Options<\/strong> \u2014 Local Alphabet, Menu Style, Group Posts, Recent Posts, CSS class names, Ignore When Alphabetizing.<\/li>\n
                    • Presentational Options<\/strong> \u2014 Fancy URLs, Fancy URL Name, Tabs.<\/li>\n
                    • Pagination \u2192 Items Per Page<\/strong> \u2014 integer, defaults to 10. Registered through the WordPress Settings API and sanitised with absint()<\/code>.<\/li>\n
                    • Content Fallback \u2192 ACF Excerpt Fallback<\/strong> \u2014 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()<\/code> \u2192 get_sub_field()<\/code> \u2192 recursive get_fields()<\/code> walk for deeply nested flexible-content \/ repeater \/ group sub-fields.<\/li>\n
                    • Content Fallback \u2192 ACF Field Name<\/strong> \u2014 the field name (or key) read by get_field()<\/code> when the toggle is enabled. The plugin gracefully no-ops if ACF (or ACF Pro) is not installed.<\/li>\n
                    • Appearance \u2192 Layout<\/strong> \u2014 Horizontal or Vertical letter strip.<\/li>\n
                    • Appearance \u2192 Letter Case<\/strong> \u2014 Uppercase or Lowercase.<\/li>\n
                    • Appearance \u2192 Disable Empty Letters<\/strong> \u2014 renders empty buckets as muted + aria-disabled<\/code>, with the anchor stripped.<\/li>\n
                    • Appearance \u2192 Hide Pagination If One Page<\/strong> \u2014 skips the Previous\/Next strip when the filtered set fits on one page.<\/li>\n
                    • Language \u2192 Alphabet Pack<\/strong> \u2014 pick from 15 bundled scripts. Selecting a pack overwrites the freeform Local Alphabet field on save.<\/li>\n
                    • Sorting \u2192 Meta Key<\/strong> \u2014 post meta key used for intra-bucket ordering instead of post_title.<\/li>\n
                    • Sorting \u2192 Meta Order<\/strong> \u2014 ASC \/ DESC.<\/li>\n
                    • Taxonomy Filter \u2192 Taxonomy + Term ID<\/strong> \u2014 restrict the index to a single term of any registered taxonomy.<\/li>\n
                    • WooCommerce \u2192 Auto-mount on Shop<\/strong> + Mount Hook<\/strong> \u2014 see the WooCommerce section above.<\/li>\n
                    • DOM Injection \u2192 Enable DOM Injection<\/strong> + Target Selector<\/strong> \u2014 print the index in the footer and move it into a CSS selector via vanilla JS.<\/li>\n
                    • REST API & Cache \u2192 Enable REST Endpoints<\/strong> + Cache TTL<\/strong> \u2014 see the REST API section above.<\/li>\n<\/ul>\n\n\n
                        \n
                      1. Upload the wp-snap-extended<\/code> directory to \/wp-content\/plugins\/<\/code>.<\/li>\n
                      2. Activate the plugin through the Plugins<\/strong> screen in WordPress.<\/li>\n
                      3. Visit Settings \u2192 Alphabetical Pagination<\/strong> to configure the menu style, alphabet pack, pagination limit, WooCommerce mount, content fallback, REST API, and other options.<\/li>\n
                      4. Embed the index in any post or page with the Gutenberg block, the shortcode, or the template tag from your theme.<\/li>\n<\/ol>\n\n\n
                        \n
                        Does the plugin still work if I'm calling `wp_snap()` from my theme?<\/h3><\/dt>\n
                        Yes. wp_snap()<\/code> is kept as a thin alias for alphabetical_pagination()<\/code> with the same parameter list, so existing themes continue to work unchanged.<\/p><\/dd>\n
                        I need to embed the index inside a Gutenberg page.<\/h3><\/dt>\n
                        Use the native Alphabetical Pagination<\/strong> block (added in 2.3.0) from the block inserter under the Widgets category \u2014 it's fully server-rendered and supports wide \/ full alignment. The block sidebar exposes post type, menu style, firstload, category, taxonomy + term, and display attributes. The legacy approach (Shortcode block with [alphabetical_pagination]<\/code>) still works.<\/p><\/dd>\n
                        Does it integrate with WooCommerce?<\/h3><\/dt>\n
                        Yes. Enable Settings \u2192 Alphabetical Pagination \u2192 WooCommerce \u2192 Auto-mount on Shop<\/strong> and the index renders above the WooCommerce shop loop and product category archives automatically. The mount uses native WooCommerce action hooks (woocommerce_before_shop_loop<\/code>, woocommerce_archive_description<\/code>, or woocommerce_before_main_content<\/code> \u2014 pick from the dropdown) so it never collides with caching \/ SEO \/ multilingual plugins that filter WP_Query.<\/p><\/dd>\n
                        Is it WPML \/ Polylang compatible?<\/h3><\/dt>\n
                        Yes. The transient letter-availability cache keys on the current language (via wpml_current_language<\/code> filter or pll_current_language()<\/code> function), and WP_Query<\/code> runs with suppress_filters => false<\/code>, so translated post sets are filtered and cached per-language automatically. Switching language busts the cache for that language only.<\/p><\/dd>\n
                        Can I get the data over REST for a headless front end?<\/h3><\/dt>\n
                        Yes. Two read-only public endpoints under \/wp-json\/wp-snap-ext\/v1\/<\/code>: GET \/letters<\/code> returns [{ letter, count, href }]<\/code>, GET \/posts<\/code> returns paginated post payloads filtered by letter. Toggle on \/ off under Settings \u2192 Alphabetical Pagination \u2192 REST API & Cache<\/strong>.<\/p><\/dd>\n
                        How do I display the ACF field instead of the trimmed post content?<\/h3><\/dt>\n
                        Go to Settings \u2192 Alphabetical Pagination \u2192 Content Fallback<\/strong>, enable ACF Excerpt Fallback<\/strong>, and enter the ACF Field Name<\/strong> (e.g. summary<\/code>). The plugin tries get_field()<\/code> first, then get_sub_field()<\/code>, then walks the entire get_fields()<\/code> tree recursively to find the field even when it lives inside an ACF flexible-content layout, repeater row, or group. Falls back to a trimmed extract of the post content if ACF returns nothing.<\/p><\/dd>\n
                        My theme has no obvious hook to drop the index into.<\/h3><\/dt>\n
                        Enable Settings \u2192 Alphabetical Pagination \u2192 DOM Injection \u2192 Enable DOM Injection<\/strong> and provide a CSS selector (e.g. .entry-content<\/code>, #primary > article:first-child<\/code>). The plugin renders the index into a hidden <template><\/code> element in the footer and a ~300-byte vanilla-JS snippet moves it into the matched element on DOMContentLoaded<\/code>. No jQuery, no dependencies.<\/p><\/dd>\n
                        How do I sort posts by a custom field instead of the title?<\/h3><\/dt>\n
                        Under Settings \u2192 Alphabetical Pagination \u2192 Sorting<\/strong>, set Meta Key<\/strong> to your post meta key and Meta Order<\/strong> to ASC or DESC. The letter buckets still derive from post_title<\/code>, but the order of posts within<\/em> each bucket follows the meta value. Useful for sorting glossary terms by importance, products by SKU, etc.<\/p><\/dd>\n
                        Can I use a non-Latin alphabet (Arabic, Chinese pinyin, Cyrillic, Greek, Hebrew, Hindi, Korean, Thai, \u2026)?<\/h3><\/dt>\n
                        Yes. Pick the script from Settings \u2192 Alphabetical Pagination \u2192 Language \u2192 Alphabet Pack<\/strong>. 15 packs are bundled: English, Arabic, Chinese (Pinyin A\u2013Z), German (with Umlauts), Spanish (with \u00d1), French, Greek, Hebrew, Hindi (Devanagari), Hungarian, Korean (Hangul Jamo), Russian (Cyrillic), Thai, Turkish, Urdu. Selecting a pack overwrites the freeform Local Alphabet field on save. You can also type a fully custom alphabet directly.<\/p><\/dd>\n
                        Are the letter counts cached?<\/h3><\/dt>\n
                        Yes. Letter availability is stored as a transient keyed by post_type \/ taxonomy \/ term \/ current language \/ alphabet pack \/ menumisc setting. Default TTL is 1 hour (configurable under REST API & Cache \u2192 Cache TTL<\/strong>). The cache is invalidated automatically on save_post<\/code>, deleted_post<\/code>, trashed_post<\/code>, untrashed_post<\/code>, and switch_blog<\/code> \u2014 so editing a post immediately reflects in the index.<\/p><\/dd>\n
                        Can I customise the output without editing the plugin?<\/h3><\/dt>\n
                        Yes \u2014 every render path fires hooks (added in 2.3.0):<\/p>\n\n
                          \n
                        • wp_snap_ext\/before_render<\/code>, wp_snap_ext\/after_render<\/code> \u2014 actions.<\/li>\n
                        • wp_snap_ext\/pre_render<\/code> \u2014 short-circuit filter (return a string to replace the HTML).<\/li>\n
                        • wp_snap_ext\/query_args<\/code> \u2014 mutate WP_Query args before the query runs.<\/li>\n
                        • wp_snap_ext\/letter_href<\/code> \u2014 rewrite letter link hrefs (useful for SPA routers).<\/li>\n
                        • wp_snap_ext\/excerpt<\/code> \u2014 post-process the resolved excerpt.<\/li>\n
                        • wp_snap_ext\/render<\/code> \u2014 final filter on the rendered HTML.<\/li>\n<\/ul>\n\n
                          See the Developer hooks<\/strong> section above for code samples.<\/p><\/dd>\n
                          Why are pagination URLs using `?alpha_paged=` instead of `?paged=`?<\/h3><\/dt>\n
                          So they don't collide with WordPress's own paged query variable on category, tag, or archive templates. You can paginate the alphabetical list independently of the surrounding archive.<\/p><\/dd>\n
                          Is the plugin accessible (WCAG)?<\/h3><\/dt>\n
                          Yes \u2014 the markup targets WCAG 2.1 AA. The letter navigation is wrapped in a semantic <nav aria-label=\"Alphabetical Navigation\"><\/code>, the active letter carries aria-current=\"page\"<\/code>, empty letters carry aria-disabled=\"true\"<\/code>, every link has a descriptive aria-label<\/code>, and the stylesheet provides visible :focus-visible<\/code> outlines. Explicit role=\"list\"<\/code> \/ role=\"listitem\"<\/code> are emitted because Safari + VoiceOver strip the implicit list role when list-style:none<\/code> is applied.<\/p><\/dd>\n\n<\/dl>\n\n\n
                          2.4.2<\/h4>\n\n
                            \n
                          • Bumped \"Tested up to\" to WordPress 7.0. No functional changes.<\/li>\n<\/ul>\n\n
                            2.4.1<\/h4>\n\n
                              \n
                            • readme.txt metadata fix \u2014 limited Tags to wp.org's maximum of 5 and trimmed the short description to the 150-character limit. No functional changes.<\/li>\n<\/ul>\n\n
                              2.4.0<\/h4>\n\n
                                \n
                              • Tabbed settings page<\/strong> \u2014 the admin panel is reorganised into four tabs using the standard WordPress nav-tab<\/code> UI: General<\/strong>, Styling<\/strong>, Integrations<\/strong>, and Developer<\/strong>. After saving, you are returned to the tab you were editing (Post\/Redirect\/Get), not the first one.<\/li>\n
                              • Styling mode<\/strong> \u2014 new \"Styling\" choice on the Styling tab:\n\n
                                  \n
                                • Default CSS<\/em> \u2014 loads the bundled snap-style-default.css<\/code> skin (styled letter strip, post cards, pagination buttons) that mirrors the plugin's preview.<\/li>\n
                                • No CSS (theme consistent)<\/em> \u2014 loads only the minimal structural snap-style.css<\/code> so the output inherits your theme's typography, colours, and button styles. This remains the default, so existing sites are unchanged on update.<\/li>\n
                                • Only the selected stylesheet is enqueued, and only on pages that actually render the index.<\/li>\n<\/ul><\/li>\n
                                • Developer tab<\/strong> \u2014 copy-paste reference with <pre><code><\/code> snippets for the [alphabetical_pagination]<\/code> shortcode, the alphabetical_pagination()<\/code> template tag (with a function_exists()<\/code> guard and the wp_snap()<\/code> alias note), and the wp_snap_ext\/*<\/code> action\/filter hooks.<\/li>\n<\/ul>\n\n
                                  2.3.0<\/h4>\n\n
                                    \n
                                  • Gutenberg block<\/strong> \u2014 new server-rendered wp-snap-ext\/index<\/code> block. Drop the alphabetical index into any post, page, or Site Editor template with one click. No JS build pipeline required; block.json + render.php only.<\/li>\n
                                  • WooCommerce auto-mount<\/strong> \u2014 toggle the new \"Auto-mount on Shop\" setting and the index renders above the shop loop \/ product category archives automatically via the native woocommerce_before_shop_loop<\/code> (or woocommerce_archive_description<\/code> \/ woocommerce_before_main_content<\/code>) action. No DOM hacks, no posts_where<\/code> SQL injection.<\/li>\n
                                  • REST API<\/strong> \u2014 public endpoints under \/wp-json\/wp-snap-ext\/v1\/<\/code>:\n\n
                                      \n
                                    • GET \/letters?post_type=\u2026&taxonomy=\u2026&term=\u2026<\/code> \u2192 [ { letter, count, href } ]<\/code><\/li>\n
                                    • GET \/posts?post_type=\u2026&letter=A&page=1&per_page=10<\/code> \u2192 { posts, total, total_pages }<\/code><\/li>\n
                                    • Toggle on the settings page; uses the transient cache so repeated calls hit memory.<\/li>\n<\/ul><\/li>\n
                                    • Documented developer hook API<\/strong> \u2014 every render path now fires:\n\n
                                        \n
                                      • do_action( 'wp_snap_ext\/before_render', $context )<\/code><\/li>\n
                                      • apply_filters( 'wp_snap_ext\/pre_render', $html, $post_type, $display, $args )<\/code> (short-circuit)<\/li>\n
                                      • apply_filters( 'wp_snap_ext\/query_args', $args, $context )<\/code><\/li>\n
                                      • apply_filters( 'wp_snap_ext\/letter_href', $href, $letter, $base )<\/code><\/li>\n
                                      • apply_filters( 'wp_snap_ext\/excerpt', $excerpt, $post_id )<\/code><\/li>\n
                                      • apply_filters( 'wp_snap_ext\/render', $html, $post_type, $display, $args )<\/code><\/li>\n
                                      • do_action( 'wp_snap_ext\/after_render', $html, $context )<\/code><\/li>\n<\/ul><\/li>\n
                                      • Transient letter-availability cache<\/strong> \u2014 letter counts are cached as transients keyed by post_type \/ taxonomy \/ term \/ current language \/ alphabet pack. Invalidated on save_post<\/code>, deleted_post<\/code>, trashed_post<\/code>, untrashed_post<\/code>, switch_blog<\/code>. Default TTL 1 hour (configurable).<\/li>\n
                                      • WPML + Polylang awareness<\/strong> \u2014 the cache key includes the current language (via wpml_current_language<\/code> or pll_current_language()<\/code>) and WP_Query runs with suppress_filters => false<\/code>, so translated post sets are filtered and cached per-language.<\/li>\n
                                      • Multi-language alphabet packs<\/strong> \u2014 pick from 15 bundled scripts (English, Arabic, Chinese pinyin, German, Spanish, French, Greek, Hebrew, Hindi, Hungarian, Korean Jamo, Russian, Thai, Turkish, Urdu). Selecting a pack overwrites the freeform Local Alphabet field on save.<\/li>\n
                                      • Appearance toggles<\/strong> \u2014 Horizontal\/Vertical layout, Uppercase\/Lowercase letter case, \"Disable empty letters\" (renders empty buckets as muted + aria-disabled<\/code>), \"Hide pagination if one page\".<\/li>\n
                                      • Generic taxonomy filter<\/strong> \u2014 restrict the index to any registered taxonomy + term ID (beyond the legacy cat\/tag args).<\/li>\n
                                      • Meta-key intra-bucket sorting<\/strong> \u2014 set a post meta key + ASC\/DESC to override post_title ordering within each letter bucket. Buckets themselves still derive from post_title.<\/li>\n
                                      • Per-page override map<\/strong> \u2014 store a { post_id => items_per_page }<\/code> array so \/glossary can render 50 items per page while \/products renders 20.<\/li>\n
                                      • DOM auto-injection<\/strong> \u2014 for themes that don't expose a hook: render the index into a hidden <template><\/code> in the footer and move it into a CSS selector via ~300 bytes of vanilla JS. No jQuery dependency.<\/li>\n
                                      • Accessibility preserved<\/strong> \u2014 <nav aria-label><\/code>, aria-current=\"page\"<\/code>, explicit role=\"list\" \/ role=\"listitem\"<\/code>, descriptive aria-label<\/code> per letter link, aria-disabled<\/code> on empty letters, visible focus outlines.<\/li>\n<\/ul>\n\n
                                        2.2.0<\/h4>\n\n
                                          \n
                                        • URL parameters migrated to ?alpha_order=<\/code> and ?alpha_paged=<\/code> (legacy ?snap=<\/code> \/ ?cp=<\/code> \/ ?snap_paged=<\/code> still honoured).<\/li>\n
                                        • Post titles are now rendered as links to each post's permalink.<\/li>\n
                                        • Accessibility (WCAG AA): letter navigation wrapped in a semantic <nav aria-label=\"Alphabetical Navigation\"><\/code>, every letter link carries a descriptive aria-label<\/code>, the active letter is exposed via aria-current=\"page\"<\/code>, and visible focus outlines are provided in the stylesheet.<\/li>\n
                                        • New \"Learn More\" CTA below each post excerpt linking to the post permalink, with an aria-label<\/code> that includes the post title.<\/li>\n
                                        • New Content Fallback<\/strong> settings section: toggle \"Use ACF field fallback if post excerpt is missing\" + text input \"ACF Field Name\". When enabled and ACF is active, the plugin reads the configured field via get_field()<\/code> for posts without a native excerpt.<\/li>\n
                                        • Frontend post cards now show: linked title \u2192 excerpt (native \u2192 ACF fallback \u2192 trimmed content) \u2192 Learn More button.<\/li>\n<\/ul>\n\n
                                          2.1.0<\/h4>\n\n
                                            \n
                                          • Rebranded as Alphabetical Pagination<\/strong>. Existing directory structure and option keys are preserved.<\/li>\n
                                          • New template tag alphabetical_pagination()<\/code> (the legacy wp_snap()<\/code> is kept as a backwards-compatible alias).<\/li>\n
                                          • New [alphabetical_pagination]<\/code> shortcode lets the index be embedded in any post or page. Attributes mirror the template tag arguments (cat<\/code>, child<\/code>, menu<\/code>, firstload<\/code>, post_parent<\/code>, post_type<\/code>, display<\/code>).<\/li>\n
                                          • New \"Items Per Page\" admin setting registered through the WordPress Settings API (register_setting<\/code>, add_settings_section<\/code>, add_settings_field<\/code>) and sanitised with absint()<\/code>. Defaults to 10 if unset.<\/li>\n
                                          • The post loop is now paginated; Previous \/ Next + numbered links are rendered through paginate_links()<\/code> below the alphabetised post list.<\/li>\n<\/ul>\n\n
                                            2.0.0<\/h4>\n\n
                                              \n
                                            • Requires PHP 8.1+. Plugin is now organised as typed classes under includes\/<\/code>.<\/li>\n
                                            • Security: prepared statements on the legacy \"ignore words\" SQL path, full sanitisation of $_GET<\/code> \/ $_POST<\/code> \/ $_SERVER<\/code> reads, escaped output, nonce + manage_options<\/code> capability check on the settings page (was the deprecated numeric level \"8\").<\/li>\n
                                            • Settings now stored under the wp_snap_ext_*<\/code> option prefix. Legacy key_snap_*<\/code> values are migrated automatically on activation.<\/li>\n
                                            • Stylesheet is registered through wp_enqueue_scripts<\/code> and only enqueued on pages that actually call wp_snap()<\/code>.<\/li>\n
                                            • Standard navigation queries now use WP_Query<\/code> instead of a hand-rolled SQL string.<\/li>\n
                                            • Backwards-compatible wp_snap()<\/code> template tag retained.<\/li>\n<\/ul>\n\n
                                              1.0.0<\/h4>\n\n
                                                \n
                                              • Original Dinwebb fork of Nathan Olsen's WP-SNAP! plugin.<\/li>\n<\/ul>","raw_excerpt":"Alphabetical (A\u2013Z, #, 0\u20139) index for any post type. Shortcode, Gutenberg block, REST API, WooCommerce auto-mount, multilingual, WCAG AA.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/19407","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=19407"}],"author":[{"embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/mansoormunib"}],"wp:attachment":[{"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=19407"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=19407"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=19407"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=19407"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=19407"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/cn.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=19407"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}