Better rules.
Easier administration.
Version 0.2.0 implements all five requested improvements in the Free core and Pro add-on. Update Free first, then Pro. This remains a beta for staging evaluation.
New in 0.2.0
- Confirmed template deletion safely clears references; duplication at capacity gives clear feedback.
- Unicode-aware literal title matching handles ÉCOLE and école consistently.
- Explicit automatic show/hide rules preserve per-post and manual placement choices.
- Searchable articles and category/tag selectors with keyboard controls and manual fallbacks.
- Complete configuration export/import with strict validation, preview, confirmed replacement and guarded Undo.
Previous 0.1.1 fixes retained
- Sticky navigation: clicked headings clear the measured TOC height; long lists and short viewports use inline contents.
- Pro rail: occupied theme sidebars and other content keep the TOC inline. Layout changes trigger a fresh check.
- Automatic placement: hidden and excluded containers, including template/code content affected by WordPress paragraph formatting, no longer receive the automatic TOC.
- Pro assignments: templates remain assigned while a content type is temporarily unavailable, including across unrelated or stale-form saves.
Free, implemented
- Automatic before-heading, after-first-paragraph, and end-of-article placement.
- Heading-level selection, threshold gating, and opt-in public content types.
- Five presets, width, alignment, spacing, typography, theme inheritance, and custom colors.
- Manual block and shortcode with one TOC owner per article.
- Per-post placement, exclusions, and independent TOC labels.
- Existing-ID preservation, collision-safe generated IDs, and duplicate-ID diagnostics.
- Collapse, numbering, section tracking, header offsets, and basic sticky contents.
- Native WordPress settings and post controls; informational PRO tabs.
Pro, implemented
- First-match rule priority with All/Any conditions and an evaluation report.
- Automatic show/hide, minimum, layout, and shared-template overrides.
- Shared templates assigned by content type or rule.
- Validated template import/export plus complete configuration transfer with reviewed replacement and guarded Undo.
- Progressive desktop rail and a searchable, nonmodal mobile contents panel.
Validation
The exact Free and Pro ZIPs passed 466 WordPress assertions plus 23 HTML5 checks on WordPress 7.1.2 / PHP 8.5.4 / MariaDB. All 29 installed plugin files matched source and ZIP bytes. A further 106 placement export-path checks passed.
Plugin Check 2.1.0 completed all 34 default groups, including five runtime groups: zero errors in both editions. Free retains the existing warning for the owner’s unfilled contributor username; Pro has zero warnings.
WordPress 6.5.13 / PHP 7.4.33 and WordPress 7.1.3 / PHP 8.3.33 each passed 445 WordPress assertions plus 23 HTML5 output checks in separate disposable Playground environments. These repeat the same tests across supported versions, including transactional import and rollback on the recognized SQLite driver.
99 Chromium checks passed across navigation, selectors and actual WordPress administration. Tests cover uploads, download, preview, apply, Undo, later-edit protection, template deletion, and Japanese category and Unicode title rules. The source report retains a Chromium cross-document transition message observed during native admin navigation.
All six website pages passed their structure, local-link/download and script checks, and 12 jsdom interactions passed. Repeatable tests, exact package qualification and scope limits are in the source bundle.
Automated checks are evidence for this beta, not WordPress.org approval or a guarantee of every theme and plugin combination. Broad browser, page-builder, translation, and multisite checks remain release work.
Outside this release
- Automatic import or migration from another TOC plugin.
- A Pro payment flow, commercial terms, subscription management, license server, or update service.
- Certified compatibility with all themes and page builders.
- Guaranteed search rankings, rich results, or accessibility/legal compliance.
WordPress.org preparation
The Free package has a GPL-compatible license, bundled readable source, local assets, capability and nonce checks, sanitization, output escaping, and no premium implementation locked by payment. Pro is distributed separately.
Before submission, add the owner’s actual WordPress.org contributor username, publish the project’s support and security contact details, check the final live URLs and slug availability, and review the chosen theme/editor and screen-reader behavior on the target staging site. The WordPress Plugins Team decides acceptance.
Read the official directory guidelines
Downloads
Previous betas
The 0.1.1 maintenance packages remain available: Free 0.1.1, Pro 0.1.1, source 0.1.1 and checksums.
The original 0.1.0 files are retained for comparison: Free 0.1.0, Pro 0.1.0, source 0.1.0 and original checksums. Use 0.2.0 for the corrected behavior.