Jalandhar Table of Contents

Jalandhar Table of Contents generates an SEO-friendly table of contents (TOC) from the headings in your post or page. Instead of scrolling through long-form content, readers can jump straight to the exact section they came for. The plugin works automatically upon activation, or lets you place your TOC precisely where you want using a shortcode, a custom Gutenberg block, or a widget. Every link points to a real, semantic anchor on the heading itself, and the entire TOC is wrapped in a proper <nav> landmark - so it is just as valuable to search engine crawlers and screen readers as it is to human visitors. Long-form guides, tutorials, recipes, FAQs, and review posts all rank and read better with a well-structured table of contents. Table of Contents Features

• Automatic TOC Insertion: Automatically insert a table of contents into posts, pages, or any custom post type. Choose your preferred position and qualifying content types.
• Semantic & Search-Engine-Friendly: Uses real <ul>/<li> (or <ol>/<li>) lists inside a <nav> landmark with clean anchor links that search engines may use for jump-to-section links in results.
• Flexible Manual Insertion: Place your TOC manually using the [jptoc] shortcode, the Gutenberg "Table of Contents" block, a widget, or the classic editor toolbar button.
• Smart Heading Filtering: Set a minimum heading count so the TOC never displays on short posts. Choose which heading levels to include and skip specific headings by level or text matching.
• Hierarchical & Flat Views: Display nested sub-headings (e.g., H3 under H2) or a clean, flat list view.
• Advanced Numbering: Format lists with decimal or Roman numerals, sequentially or nested by depth.
• Full Appearance Customization: Complete control over width, float/alignment, typography (font size and weight), and colors.
• Built-in Color Schemes: Select from dark, light, white, transparent, or theme-inherited color schemes with individual color overrides.
• Interactive Elements: Optional show/hide toggle with custom labels and smooth scrolling with configurable top offsets for sticky headers.
• Clean URL Anchors: Generates readable anchor links in URLs (e.g., example.com/faq/#How_Do_This) instead of random IDs, with options for lowercase conversion and dash separation.
• Accessibility Ready: Built with aria-expanded states on toggles and descriptive aria-label attributes on <nav> landmarks.
• Per-Post Overrides: Override the global settings on individual posts and pages when you need an exception.
• RTL Language Support: Works with right-to-left languages.
• Developer Friendly: Extensible via hooks and filters, and tested with popular page builders, caching plugins, and SEO plugins.

Auto Insert To automatically insert a table of contents into your posts, enable "Auto Insert Table of Contents" under the plugin's "Auto Insert" settings tab, then choose which post types should get one. Supported automatic positions:

• Before the first heading
• After the first heading
• After the first block (paragraph or heading)
• Top of the post content
• Bottom of the post content

Manual Insert If you prefer placing your table of contents manually, use any of these methods:

• The "Table of Contents" button in the classic editor toolbar
• The "Table of Contents" block in the Gutenberg editor
• The "Table of Contents" widget in your sidebars
• The [jptoc] shortcode anywhere in your content

Clean, Readable Anchor Links By default, each heading's anchor is generated from its text (e.g., #How_Do_This), keeping your URLs human-readable. Under the "Misc." settings tab, in the "Hash" section, you can choose the anchor format (as heading, as heading without transliterate, or a counter such as #jptoc1), convert anchors to lowercase, and replace underscores with dashes. Note: For non-English websites using the "As heading" anchor format, enabling the Intl PHP extension ensures proper transliteration of anchors. Compatibility Jalandhar Table of Contents has been tested for compatibility with:

• Elementor Page Builder
• Beaver Builder and Beaver Builder Themer Add-On
• WPBakery Page Builder
• Oxygen Builder
• WPML (WordPress Multilingual Plugin)
• Rank Math SEO
• WP Rocket
• Toolset Views and Toolset Access

Developer Hooks & Filters Filters jptoc_before and jptoc_after Add custom HTML immediately before or after the table of contents. add_filter('jptoc_before', function ($before) { return ' Custom text before TOC.' . $before; }); Filter jptoc_shortcode_tag Change the shortcode tag from the default [jptoc]. add_filter('jptoc_shortcode_tag', function ($tag) { return 'toc'; }); Filter jptoc_heading_id Customize the anchor ID generated for individual headings. add_filter('jptoc_heading_id', function ($id, $label) { return $id; }, 10, 2);

You can install the Jalandhar Table of Contents plugin using any of the standard WordPress installation methods below. Once activated and Auto Insert Table of Contents box check in Settings, it will start generating clean TOCs and jump links for your content instantly. Installing from the WordPress Dashboard

1. Navigate to Plugins > Add New.
2. Search for "Jalandhar Table of Contents".
3. Click Install Now and then Activate.

Installing via Upload

1. Download the plugin ZIP archive.
2. Go to Plugins > Add New > Upload Plugin in your WordPress dashboard.
3. Select the file, click Install Now, and click Activate Plugin.

Manual FTP Installation

1. Upload the jalandhar-table-of-contents folder to your /wp-content/plugins/ directory.
2. Navigate to the Plugins screen in WordPress and click Activate.

Getting Started

• A "Table of Contents" button appears in the classic editor toolbar, on the post/page edit screen.
• A "Table of Contents" block becomes available in the Gutenberg editor - search for it in the block inserter.
• A "Table of Contents" widget becomes available under Appearance > Widgets.
• A "Table of Contents" menu item appears under Settings > Table of Contents in your WP dashboard, where you can configure global settings, appearance, colors, and auto-insert behavior.

1.0.1

• Fix: cleanly remove all plugin data (including per-post overrides and widget settings) when the plugin is deleted.
• New: Custom CSS field under Misc. settings, for adding your own styles without editing your theme.

1.0.0

• Initial release of the Jalandhar Table of Contents (TOC) plugin.