| @@ -2,9 +2,9 @@ | ||
| 2 | 2 | Contributors: MarcDK |
| 3 | 3 | Tags: TOC, Table of Contents, Block, Accessibility, Table |
| 4 | 4 | Requires at least: 6.2 |
| 5 | 5 | Tested up to: 7.1 |
| 6 | -Stable tag: 7.3.0 | |
| 6 | +Stable tag: 7.4.1 | |
| 7 | 7 | Requires PHP: 7.3 |
| 8 | 8 | License: GPLv2 or later |
| 9 | 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | Donate link: https://marc.tv/out/donate |
| @@ -63,8 +63,14 @@ | ||
| 63 | 63 | * Select the Box style directly in Gutenberg's Styles tab. |
| 64 | 64 | * Select a heading level or turn it into a paragraph. |
| 65 | 65 | * Disable the h2 heading of the TOC block and add your own. |
| 66 | 66 | |
| 67 | += Highlight the current section = | |
| 68 | + | |
| 69 | +Enable "Highlight current section" under Advanced Features in the SimpleTOC block settings. The link for the current section is underlined as visitors scroll. This option is off by default. To enable it for all blocks, turn on "Force highlight current section" under Settings > SimpleTOC. The global setting takes precedence over individual block settings. Developers can override the global setting with the `simpletoc_scroll_spy_enabled` filter. | |
| 70 | + | |
| 71 | +This feature uses native CSS `scroll-target-group` and `:target-current`. Browser support is limited. Browsers without support keep the normal table of contents and working links. No JavaScript fallback or polyfill is included. Highlighting applies to headings on the current page and does not make the table of contents sticky. | |
| 72 | + | |
| 67 | 73 | = Compatibility = |
| 68 | 74 | |
| 69 | 75 | * GeneratePress and Rank Math support. |
| 70 | 76 | * Works with popular AMP plugins. |
| @@ -73,15 +79,10 @@ | ||
| 73 | 79 | |
| 74 | 80 | SimpleTOC is open-source and developed on [GitHub Pages](https://github.com/mtoensing/SimpleTOC). If you find a bug or have an idea for a feature please feel free to contribute and create a pull request. |
| 75 | 81 | |
| 76 | 82 | == Changelog == |
| 77 | -= 7.3.0 = | |
| 78 | -* Changed: Box is now a native Gutenberg block style in the Styles tab. | |
| 79 | -* Added: Native text, link, background color, margin, and padding controls. | |
| 80 | -* Added: theme.json styling support for colors, spacing, and typography. | |
| 81 | -* Added: WordPress 7.1 support and automated compatibility tests. | |
| 82 | -* Changed: Existing box-style blocks and the global Force box style setting remain compatible. | |
| 83 | -* Thanks: Lovro Hrust (@lovor) for the theme.json and block styling feedback. | |
| 83 | += 7.4.1 = | |
| 84 | +* Fixed: Headings inside Query Loop blocks (core/query, GenerateBlocks) no longer receive duplicate anchor IDs from the surrounding page and are no longer listed in the table of contents. Fixes issue #90. | |
| 84 | 85 | |
| 85 | 86 | == Installation == |
| 86 | 87 | |
| 87 | 88 | SimpleTOC can be found and installed via the Plugin menu within WordPress administration (Plugins -> Add New). Alternatively, it can be downloaded from WordPress.org and installed manually... |
| @@ -153,9 +154,9 @@ | ||
| 153 | 154 | Replace the example values with your theme's values or preset variables. Selecting the Box style adds the standard `is-style-boxed` class. |
| 154 | 155 | |
| 155 | 156 | = How to allow developers to exclude specific headings programmatically? = |
| 156 | 157 | |
| 157 | -Use the 'simpletoc_excluded_blocks' filter. For example, this code will exclude heading blocks that are inside a column block. | |
| 158 | +Query Loop blocks (core/query, generateblocks/query-loop, generateblocks/query) are always excluded, because their headings repeat for every post. Use the 'simpletoc_excluded_blocks' filter to exclude more blocks. For example, this code will exclude heading blocks that are inside a column block. | |
| 158 | 159 | |
| 159 | 160 | Example: |
| 160 | 161 | |
| 161 | 162 | add_filter( 'simpletoc_excluded_blocks', function ( array $blocks ) { |
