FlexiTOC – Flexible Table of Contents

1.0.6

• Fix: headings written in non-Latin scripts (Bengali, Devanagari, Japanese, Arabic, Cyrillic and so on) got mangled anchor links. WordPress’s URL-slug handling percent-encodes each of those characters into about nine, then truncates at 200 — so only ~22 characters of the heading survived, cut off mid-word. Worse, two different headings sharing that opening ran together into the same anchor, and the resulting “-2” suffixes shift if headings are later added or reordered, quietly breaking links that were already shared. Anchors now keep the heading’s own characters, so they stay complete, readable and stable. Latin-script headings are unaffected: their anchors are byte-for-byte what they were before.

1.0.5

• Fix: TOC links could scroll to the wrong position when “Smooth scrolling” was on — a layout shift while the browser’s native smooth-scroll animation was still running (a web font or image finishing load and changing the page height, for example) could stop it short of the target heading. A small script, loaded only when smooth scrolling is enabled, now checks the landing position shortly after and corrects it if a shift knocked it off course. Not yet confirmed against WordPress 7.1 — needs its own live verification pass.

1.0.4

• Fix: on a WordPress 7.1 Release Candidate, the FlexiTOC block occasionally failed to register at all (missing from the block inserter), caused by a timing race where window.wp was still undefined when the block’s editor script ran, despite correct script dependencies. Both editor scripts now defer their setup until wp and the specific sub-modules they need are confirmed available, which resolves this regardless of the underlying timing cause and is safe on all supported WordPress versions.
• Confirmed compatible with WordPress 7.1 after repeated (8x) testing on the environment that originally reproduced the issue, with the fix applied.

1.0.3

• Fix: block.json was missing declarative editorScript/style/editorStyle references, which WordPress.org’s plugin-directory scanner needs to detect and list a plugin’s blocks (the “Blocks” section on the plugin page, and visibility in the block editor’s “Available to install” search). The actual script/style registration is unchanged — these are handled in PHP as before, for translations and settings-aware localization — this only makes them statically visible to the directory’s scanner.
• Add: readme tags now include “block” (moved into the first five, since only the first five tags are used for WordPress.org search).
• Improve: readme wording refined against real search-demand data (highest-volume validated query is “wordpress table of contents”; page-builder compatibility — Elementor and Divi, both verified working via the shortcode — also has measurable search demand).
• Add: an Installation section, and two FAQ entries addressing performance impact and the free/no-upsell guarantee up front.

1.0.2

• Fix: when automatic insertion was off and a FlexiTOC block was placed outside the post content (a sidebar, widget area, or Site Editor template part), anchor ids were never added to the article’s headings. The sidebar TOC’s links pointed at ids that did not exist anywhere on the page, so clicking them did nothing (or occasionally jumped to the top of the page instead). Anchor ids are now always added whenever the page is displayed, regardless of where the TOC itself is placed.
• Harden: some themes call the_content more than once for the same post; the plugin now caches its own processed output per post for the request so a second call can’t strip a custom heading label a second time with nothing left to restore it from.

1.0.1

• Add: a third list style, None, for a clean nav-style list with no bullets or numbers.
• Add: Heading hierarchy setting (Nested/Flat) — Flat lists every included heading at a single level, ideal for sidebar and sticky placements where nested indentation competes with the available width. Configurable globally, per block, and per shortcode.
• Improve: the Numbered style now uses outline-style numbering for nested headings (1, 1.1, 1.2, 2, 2.1 …) instead of switching to letters (a, b, c) at the second level.
• Fix: the block editor’s list-style preview (Bulleted/Numbered) always showed a bulleted list regardless of the selected setting; it now matches whatever is actually selected.
• Fix: the “Bulleted” list style set no visible marker at all (ol correctly showed numbers, but ul had no matching override and stayed markerless). Bullets now render for the Bulleted style, both on the front end and in the editor preview.