{"id":10700,"date":"2026-05-19T04:30:12","date_gmt":"2026-05-18T20:30:12","guid":{"rendered":"https:\/\/aeosub.com\/mocursor-toc\/"},"modified":"2026-05-19T04:30:12","modified_gmt":"2026-05-18T20:30:12","slug":"mocursor-toc","status":"publish","type":"post","link":"https:\/\/aeosub.com\/zh\/mocursor-toc\/","title":{"rendered":"Mocursor Smart TOC"},"content":{"rendered":"
\"Mocursor<\/div>\n
\n\n\n\n\n\n\n\n
Developer<\/th>\nMoses Cursor Ssebunya<\/a><\/td>\n<\/tr>\n
Version<\/th>\nv1.0.2<\/td>\n<\/tr>\n
Active Installs<\/th>\n0 +<\/td>\n<\/tr>\n
Requires \/ Tested<\/th>\n6.4 \/ 7.0<\/td>\n<\/tr>\n
Last Updated<\/th>\n2026-05-18 7:47pm GMT<\/td>\n<\/tr>\n
Official Link<\/th>\nView Details \u2192<\/a><\/td>\n<\/tr>\n<\/table><\/div>\n
A powerful, lightweight Gutenberg block that automatically generates a linked, navigable table of contents from your post headings.<\/div>\n

Mocursor Smart TOC<\/strong> is a lightweight, feature-packed Gutenberg block that automatically generates a linked table of contents from the headings in your posts and pages. Simply drop it into your content \u2014 it just works. Also available as a [mctoc]<\/code> shortcode for classic editor users.<\/p>\n

The block is fully dynamic<\/strong>, accessible<\/strong>, lightweight<\/strong>, and theme-aware<\/strong>. It uses WordPress design tokens and CSS custom properties so it inherits your theme’s colors, fonts, and spacing automatically.<\/p>\n

Shortcode Support<\/h4>\n

The Mocursor Smart TOC block is also available as a [mctoc]<\/code> shortcode for use in the classic editor, widgets, or theme templates.<\/p>\n

Basic usage:<\/strong><\/p>\n

[mctoc]\n<\/code><\/pre>\n
With options:<\/strong><\/p>\n
[mctoc title=\"On This Page\" include_h2=\"true\" include_h3=\"true\" include_h4=\"false\" numbering=\"nested\" collapsed=\"true\" sticky=\"true\" offset=\"100\" skip=\"1\" exclude_headings=\"Related Posts,Comments\" back_to_top=\"true\"]\n<\/code><\/pre>\n
Available shortcode attributes:<\/strong><\/p>\n
    \n
  • title<\/code> \u2014 TOC heading text (default: “Table of Contents”)<\/li>\n
  • include_h2<\/code> \u2014 Include H2 headings: “true” or “false” (default: “true”)<\/li>\n
  • include_h3<\/code> \u2014 Include H3 headings: “true” or “false” (default: “true”)<\/li>\n
  • include_h4<\/code> \u2014 Include H4 headings: “true” or “false” (default: “true”)<\/li>\n
  • exclude_headings<\/code> \u2014 Comma-separated heading texts to exclude<\/li>\n
  • numbering<\/code> \u2014 Numbering style: “none”, “decimal”, or “nested” (default: “none”)<\/li>\n
  • collapsed<\/code> \u2014 Start collapsed: “true” or “false” (default: “false”)<\/li>\n
  • sticky<\/code> \u2014 Enable sticky mode: “true” or “false” (default: “false”)<\/li>\n
  • offset<\/code> \u2014 Scroll offset in pixels for fixed headers (default: 80)<\/li>\n
  • skip<\/code> \u2014 Number of headings to skip from the start (default: 0)<\/li>\n
  • back_to_top<\/code> \u2014 Show “Back to Top” link: “true” or “false” (default: “false”)<\/li>\n<\/ul>\n
    Ideal Use Cases<\/h4>\n
    Mocursor Smart TOC is perfect for:<\/p>\n
      \n
    • Long-form blog posts<\/strong> \u2014 Help readers navigate 2,000+ word articles with ease.<\/li>\n
    • Documentation and knowledge bases<\/strong> \u2014 Technical docs, how-to guides, and reference pages.<\/li>\n
    • Online courses and tutorials<\/strong> \u2014 Give learners a clear roadmap of every lesson section.<\/li>\n
    • Legal, policy, and compliance pages<\/strong> \u2014 Terms of service, privacy policies, and similar documents.<\/li>\n
    • Product and feature pages<\/strong> \u2014 Long product descriptions with multiple sections.<\/li>\n
    • Recipe and travel blogs<\/strong> \u2014 Readers can jump to the section they care about.<\/li>\n
    • Wiki-style internal sites<\/strong> \u2014 Any WordPress site used as an internal wiki or resource library.<\/li>\n
    • Accessibility-focused sites<\/strong> \u2014 The TOC gives keyboard and screen reader users a reliable way to navigate.<\/li>\n
    • Classic editor users<\/strong> \u2014 The shortcode works perfectly in the classic editor.<\/li>\n<\/ul>\n
      Why Choose Mocursor Smart TOC?<\/h4>\n
        \n
      1. Zero configuration needed<\/strong> \u2014 Drop the block in and it works immediately.<\/li>\n
      2. 100% Gutenberg-native + Shortcode<\/strong> \u2014 Built as a real Gutenberg block with a classic shortcode fallback.<\/li>\n
      3. Dynamic and always up to date<\/strong> \u2014 Server-rendered, always matches the current content.<\/li>\n
      4. Incredibly lightweight<\/strong> \u2014 No JavaScript frameworks. Pure vanilla JS for all interactivity.<\/li>\n
      5. Deeply customizable<\/strong> \u2014 Rich inspector controls for heading levels, numbering, collapsibility, sticky mode, and more.<\/li>\n
      6. Accessible by default<\/strong> \u2014 Proper ARIA attributes, keyboard navigation, semantic HTML, and focus management.<\/li>\n
      7. Theme-aware<\/strong> \u2014 Uses WordPress design tokens and CSS custom properties.<\/li>\n
      8. No lock-in<\/strong> \u2014 Deactivate the plugin and your content is untouched.<\/li>\n
      9. Privacy-friendly<\/strong> \u2014 No external requests, no tracking, no analytics, no cookies.<\/li>\n
      10. Open source<\/strong> \u2014 Licensed under GPLv2.<\/li>\n<\/ol>\n
        Block Features<\/h4>\n
          \n
        • Automatic heading detection for H2, H3, and H4<\/li>\n
        • Heading level filtering with individual checkboxes<\/li>\n
        • Exclude specific headings by text<\/li>\n
        • Skip first N headings option<\/li>\n
        • Three numbering styles: None, Decimal, Nested<\/li>\n
        • Collapsible TOC with configurable default state<\/li>\n
        • Smooth scrolling with configurable offset<\/li>\n
        • Active heading highlight via IntersectionObserver<\/li>\n
        • Back to Top link<\/li>\n
        • Sticky mode<\/li>\n
        • Live editor preview<\/li>\n
        • Full block editor design controls (colors, typography, spacing, borders)<\/li>\n
        • Shortcode support with full attribute control<\/li>\n<\/ul>\n
          How to Use<\/h4>\n
          Method 1: Block Editor<\/strong><\/p>\n
            \n
          1. Install and activate the plugin.<\/li>\n
          2. Open any post or page in the block editor.<\/li>\n
          3. Click the block inserter (+), search for “Mocursor Smart TOC”, and insert the block.<\/li>\n
          4. Customize via the block settings sidebar.<\/li>\n
          5. Publish \u2014 the TOC renders with smooth scrolling and active heading tracking.<\/li>\n<\/ol>\n
            Method 2: Shortcode<\/strong><\/p>\n
              \n
            1. In any post, page, or widget, type [mctoc]<\/code>.<\/li>\n
            2. Optionally add attributes: [mctoc title=\"Contents\" numbering=\"decimal\" collapsed=\"true\"]<\/code>.<\/li>\n<\/ol>\n
              Method 3: PHP Template<\/strong><\/p>\n
              <?php echo do_shortcode( '[mctoc title=\"Page Contents\" numbering=\"nested\"]' ); ?>\n<\/code><\/pre>\n
              Tips:<\/strong><\/p>\n
                \n
              • Place the TOC inside a Group block with a max-width for a contained look.<\/li>\n
              • Enable sticky mode for sidebar layouts.<\/li>\n
              • Use the shortcode in classic editor widgets or template files.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"
                A powerful, lightweight Gutenberg block that automatically generates a linked, navigable table of contents from your post headings.<\/p>","protected":false},"author":1,"featured_media":9317,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[252],"tags":[555],"class_list":["post-10700","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-trends","tag-wordpress-plugin"],"_links":{"self":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10700","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/comments?post=10700"}],"version-history":[{"count":0,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/10700\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media\/9317"}],"wp:attachment":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media?parent=10700"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/categories?post=10700"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/tags?post=10700"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}