內容簡介
Mocursor Smart TOC 是一款輕量級的 Gutenberg 區塊，能自動從文章和頁面的標題生成可連結的目錄。使用者只需將其放入內容中，即可輕鬆運作，並支援短碼用法，適合各種編輯器。
【主要功能】
• 自動生成可連結的目錄
• 支援 Gutenberg 區塊和短碼
• 主題感知，自動繼承樣式
• 可自訂標題和包含的標題層級
• 支援折疊和黏性模式
• 提供回到頂部的連結選項
開發者團隊
原文外掛簡介
Mocursor Smart TOC 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 — it just works. Also available as a [mctoc] shortcode for classic editor users.
The block is fully dynamic, accessible, lightweight, and theme-aware. It uses WordPress design tokens and CSS custom properties so it inherits your theme’s colors, fonts, and spacing automatically.
Shortcode Support
The Mocursor Smart TOC block is also available as a [mctoc] shortcode for use in the classic editor, widgets, or theme templates.
Basic usage:
[mctoc]
With options:
[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" align="right" justify=""]
Available shortcode attributes:
title — TOC heading text (default: “Table of Contents”)
include_h2 — Include H2 headings: “true” or “false” (default: “true”)
include_h3 — Include H3 headings: “true” or “false” (default: “true”)
include_h4 — Include H4 headings: “true” or “false” (default: “true”)
exclude_headings — Comma-separated heading texts to exclude
numbering — Numbering style: “none”, “decimal”, or “nested” (default: “none”)
collapsed — Start collapsed: “true” or “false” (default: “false”)
sticky — Enable sticky mode: “true” or “false” (default: “false”)
offset — Scroll offset in pixels for fixed headers (default: 80)
skip — Number of headings to skip from the start (default: 0)
back_to_top — Show “Back to Top” link: “true” or “false” (default: “false”)
align — Floating block alignment: “left”, “center”, or “right”. Left/right allow nearby content to wrap beside the TOC.
justify — No-wrap TOC position: “left”, “center”, or “right”. Surrounding content stays above and below the TOC.
Ideal Use Cases
Mocursor Smart TOC is perfect for:
Long-form blog posts — Help readers navigate 2,000+ word articles with ease.
Documentation and knowledge bases — Technical docs, how-to guides, and reference pages.
Online courses and tutorials — Give learners a clear roadmap of every lesson section.
Legal, policy, and compliance pages — Terms of service, privacy policies, and similar documents.
Product and feature pages — Long product descriptions with multiple sections.
Recipe and travel blogs — Readers can jump to the section they care about.
Wiki-style internal sites — Any WordPress site used as an internal wiki or resource library.
Accessibility-focused sites — The TOC gives keyboard and screen reader users a reliable way to navigate.
Classic editor users — The shortcode works perfectly in the classic editor.
Why Choose Mocursor Smart TOC?
Zero configuration needed — Drop the block in and it works immediately.
100% Gutenberg-native + Shortcode — Built as a real Gutenberg block with a classic shortcode fallback.
Dynamic and always up to date — Server-rendered, always matches the current content.
Incredibly lightweight — No JavaScript frameworks. Pure vanilla JS for all interactivity.
Deeply customizable — Rich inspector controls for heading levels, numbering, collapsibility, sticky mode, and more.
Accessible by default — Proper ARIA attributes, keyboard navigation, semantic HTML, and focus management.
Theme-aware — Uses WordPress design tokens and CSS custom properties.
No lock-in — Deactivate the plugin and your content is untouched.
Privacy-friendly — No external requests, no tracking, no analytics, no cookies.
Open source — Licensed under GPLv2.
Block Features
Automatic heading detection for H2, H3, and H4
Heading level filtering with individual checkboxes
Exclude specific headings by text
Skip first N headings option
Three numbering styles: None, Decimal, Nested
Collapsible TOC with configurable default state
Smooth scrolling with configurable offset
Active heading highlight via IntersectionObserver
Back to Top link
Sticky mode
Live editor preview
Full block editor design controls (colors, typography, spacing, borders)
Left, center, and right floating alignment using native block controls
Left, center, and right no-wrap justification for positioning without shifting surrounding content beside the TOC
Shortcode support with full attribute control
How to Use
Method 1: Block Editor
Install and activate the plugin.
Open any post or page in the block editor.
Click the block inserter (+), search for “Mocursor Smart TOC”, and insert the block.
For a floating layout where text can wrap beside the TOC, use the block toolbar alignment (left, center, or right).
For positioning without text wrapping, open Layout → Justify TOC (No Text Wrap) and choose Left, Center, or Right.
Publish — the TOC renders with smooth scrolling and active heading tracking.
Method 2: Shortcode
In any post, page, or widget, type [mctoc].
Optionally use floating alignment: [mctoc title="Contents" numbering="decimal" align="left"].
Or use no-wrap positioning: [mctoc title="Contents" numbering="decimal" justify="right"].
Method 3: PHP Template
Tips:
Place the TOC inside a Group block with a max-width for a contained look.
Enable sticky mode for sidebar layouts.
Use the shortcode in classic editor widgets or template files.
