Shortcode Table of Contents

July 31, 2018

Shortcode Table of Contents Plugin

Display an automated table of contents via shortcode.

Simply use the [toc content=".your-container"] shortcode to automatically generate a table of contents for any HTML container.

The shortcode accepts a number of parameters:

  • contentstringrequired
    A CSS selector indicating the container of your content.
  • headersstring
    A comma separated list of heading selectors that you want to include.
  • speedint
    Speed of sliding back to top.
  • anchor-classstring
    Class of anchor links.
  • anchor-textstring
    Prepended or appended to anchor headings. Leave blank to disable anchor links.
  • top_classstring
    Back to top button or link class.
  • spytrue/false
    Enable scroll spy. This will highlight the list items as you scroll past them.
  • positionappend/prepend
    Position of anchor text.
  • spy-offsetint
    Specify heading offset for spy scrolling.

Installation

  1. Upload the plugin files to the /wp-content/plugins/shortcode-toc directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress

Screenshots

  1. Add the <code>[toc]</code> shortcode to any post/page/custom-post-type, at any position in the content.

    Add the [toc] shortcode to any post/page/custom-post-type, at any position in the content.

  2. A nested list will be generated based on the headings within your chosen HTML element.

    A nested list will be generated based on the headings within your chosen HTML element.

  3. Add the <code>anchor-text</code> parameter.

    Add the anchor-text parameter.

  4. When the <code>anchor-text</code> parameter is set, the text will be appended to your headings so your users can easily copy the link to that section.

    When the anchor-text parameter is set, the text will be appended to your headings so your users can easily copy the link to that section.

FAQ

Installation Instructions

  1. Upload the plugin files to the /wp-content/plugins/shortcode-toc directory, or install the plugin through the WordPress plugins screen directly.
  2. Activate the plugin through the ‘Plugins’ screen in WordPress

Can I use the shortcode multiple times on a page?

No. Currently it’ll only work once per page.

The table of contents isn’t showing up.

Did you set the content parameter of the shortcode to a valid CSS selector on your page? This is a required argument.

Can I build a table of contents for just h2 and h3 tags?

Yup, your shortcode would look like this [toc content=".your-container" headers="h2,h3"]

Is there a PHP version of the shortcode?

You can use the do_shortcode() function like this:

<?php echo do_shortcode( '[toc content=".your-container"]' ); ?> 

Changelog

v1.0.3 (31/07/2018)
[fix] Revert back to original anchorific. Bower one was an old version.

v1.0.2 (01/12/2017)
[update] Use latest anchorific.

v1.0.1 (30/11/2017)
[update] Remove anchor text by default.
[fix] Ensure ‘spy’ param works with true/false values.

v1.0.0 (29/11/2017)
[release] Initial release.

Details

  • Version: 1.0.3
  • Active installations: 400
  • WordPress Version: 4.0
  • Tested up to: 4.9.26

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars