{"id":264088,"date":"2025-12-02T10:37:58","date_gmt":"2025-12-02T10:37:58","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/toc-master\/"},"modified":"2025-12-02T10:41:24","modified_gmt":"2025-12-02T10:41:24","slug":"toc-builder-by-robertivan","status":"publish","type":"plugin","link":"https:\/\/es.wordpress.org\/plugins\/toc-builder-by-robertivan\/","author":13483948,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.3.0","stable_tag":"1.3.0","tested":"6.8.5","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"TOC Builder by RobertIvan","header_author":"Robert Ivan","header_description":"An ultra-advanced Table of Contents generator with smooth scroll, Gutenberg support, and high configurability.","assets_banners_color":"","last_updated":"2025-12-02 10:41:24","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/github.com\/robertivan\/","rating":5,"author_block_rating":0,"active_installs":0,"downloads":154,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.3.0":{"tag":"1.3.0","author":"robertivan","date":"2025-12-02 10:41:24"}},"upgrade_notice":{"1.2.0":"<p>Update with WordPress sidebar menu restructuring and live preview. Dynamic preview, clickable heading selectors, and navigation updates. Backward compatible.<\/p>","1.1.0":"<p>Update with the admin interface. Design with tabs, live preview, and user experience updates. Backward compatible.<\/p>","1.0.1":"<p>Bug fixes for heading ID injection. Update recommended for all users.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":{"tbrv\/toc":{"name":"tbrv\/toc","title":"TOC Builder by RobertIvan"}},"tagged_versions":["1.3.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"General Settings page with WordPress sidebar menu, 2-column layout, and live preview","2":"Live preview showing dynamic TOC structure based on selected heading levels","3":"Heading selectors (H1-H6) with clickable areas","4":"Collapsible TOC preview with interactive hide\/show functionality","5":"Mobile-responsive layout with stacked settings and preview","6":"WordPress sidebar menu with TOC Builder icon"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[148076,19897,1753,10851,10852],"plugin_category":[43],"plugin_contributors":[251528],"plugin_business_model":[],"class_list":["post-264088","plugin","type-plugin","status-publish","hentry","plugin_tags-gutenberg","plugin_tags-headings","plugin_tags-navigation","plugin_tags-table-of-contents","plugin_tags-toc","plugin_category-customization","plugin_contributors-robertivan","plugin_committers-robertivan"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/toc-builder-by-robertivan.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>TOC Builder by RobertIvan is a Table of Contents plugin that automatically generates a navigation menu from your content's headings. It includes an admin interface for configuration and is suitable for long-form content, documentation sites, and blogs.<\/p>\n\n<h4>Core Features<\/h4>\n\n<ul>\n<li><strong>Auto-Detection<\/strong> - Automatically scans content for headings (H1-H6)<\/li>\n<li><strong>Smooth Scroll<\/strong> - Animated scrolling to sections<\/li>\n<li><strong>SpyScroll<\/strong> - Highlights the current section in the TOC while scrolling<\/li>\n<li><strong>Gutenberg Ready<\/strong> - Includes a native block with live preview in the editor<\/li>\n<li><strong>Configurable<\/strong> - Customize position, colors, heading levels, and more<\/li>\n<li><strong>Performance<\/strong> - Assets loading and caching optimized<\/li>\n<li><strong>Responsive<\/strong> - Compatible with desktop, tablet, and mobile devices<\/li>\n<\/ul>\n\n<h4>Admin Interface<\/h4>\n\n<p>TOC Builder by RobertIvan features an admin settings page for configuration:<\/p>\n\n<p><strong>Design System<\/strong><\/p>\n\n<ul>\n<li>Gradient color scheme<\/li>\n<li>Animations and transitions<\/li>\n<li>Card-based layout<\/li>\n<li>System typography<\/li>\n<\/ul>\n\n<p><strong>WordPress Sidebar Menu Structure<\/strong><\/p>\n\n<ul>\n<li>Dedicated Sidebar Menu - Menu in WordPress sidebar with a custom icon<\/li>\n<li>General Settings - Core TOC functionality with live preview<\/li>\n<li>Appearance Settings - Visual customization options (coming soon)<\/li>\n<li>Advanced Settings - Options for developers (coming soon)<\/li>\n<li>Premium Features - Planned functionality<\/li>\n<li>Bookmarkable URLs - Direct URLs for each section<\/li>\n<\/ul>\n\n<p><strong>User Experience<\/strong><\/p>\n\n<ul>\n<li>Live Preview - Preview updates based on selected heading levels<\/li>\n<li>Heading Selection - Click on heading boxes (H1-H6) to toggle selection<\/li>\n<li>Visual Hierarchy - Preview shows TOC structure based on heading selections<\/li>\n<li>Interactive Demo - Collapsible TOC preview with hide\/show functionality<\/li>\n<li>Visual Feedback - Checkboxes with gradient backgrounds when selected<\/li>\n<li>2-Column Layout - Settings on left, sticky live preview on right (desktop)<\/li>\n<li>Responsive Design - Stacked layout on smaller screens<\/li>\n<\/ul>\n\n<h4>Future Architecture<\/h4>\n\n<p>The admin interface is designed to accommodate upcoming features:<\/p>\n\n<ul>\n<li>Custom color schemes and typography options<\/li>\n<li>Advanced CSS customization<\/li>\n<li>Performance optimization controls<\/li>\n<li>Analytics and tracking capabilities<\/li>\n<li>Pre-built design templates<\/li>\n<li>Multi-language support infrastructure<\/li>\n<\/ul>\n\n<h4>Suitable For<\/h4>\n\n<ul>\n<li>Long-form blog posts and articles<\/li>\n<li>Documentation and knowledge bases<\/li>\n<li>Educational content and tutorials<\/li>\n<li>Product guides and manuals<\/li>\n<li>Any content with multiple headings<\/li>\n<\/ul>\n\n<h3>Technical Details<\/h3>\n\n<h4>File Structure<\/h4>\n\n<p>toc-master\/\n\u251c\u2500\u2500 assets\/\n\u2502   \u251c\u2500\u2500 css\/\n\u2502   \u2502   \u251c\u2500\u2500 style.css              (Frontend TOC styles)\n\u2502   \u2502   \u2514\u2500\u2500 admin-premium.css      (Admin interface styles)\n\u2502   \u2514\u2500\u2500 js\/\n\u2502       \u251c\u2500\u2500 script.js              (Frontend functionality)\n\u2502       \u251c\u2500\u2500 admin-settings.js      (Admin interface interactions)\n\u2502       \u2514\u2500\u2500 block.js               (Gutenberg block)\n\u251c\u2500\u2500 includes\/\n\u2502   \u251c\u2500\u2500 class-toc-generator.php    (Core TOC generation logic)\n\u2502   \u251c\u2500\u2500 class-toc-settings.php     (Settings page with UI)\n\u2502   \u2514\u2500\u2500 class-toc-block.php        (Gutenberg block registration)\n\u2514\u2500\u2500 toc-builder.php                (Main plugin file)<\/p>\n\n<h4>Admin Interface Architecture<\/h4>\n\n<p>The settings pages use a component-based architecture:<\/p>\n\n<ul>\n<li>CSS Design System - CSS custom properties, modular components, responsive breakpoints<\/li>\n<li>WordPress Sidebar Navigation - Individual pages for each settings section<\/li>\n<li>Live Preview System - TOC rendering with dynamic heading selection<\/li>\n<\/ul>\n\n<h4>Color Palette<\/h4>\n\n<p>Primary Colors:\n* Primary Gradient: #4F46E5 \u2192 #7C3AED\n* Accent Cyan: #06B6D4\n* Accent Purple: #A855F7<\/p>\n\n<p>Neutral Colors:\n* Gray Scale: #F1F5F9 \u2192 #0F172A\n* Success: #10B981\n* Warning: #F59E0B<\/p>\n\n<h3>Support<\/h3>\n\n<p>For support, feature requests, and bug reports, please visit the plugin's support forum on WordPress.org.<\/p>\n\n<h3>Credits<\/h3>\n\n<p>Developed with \u2764\ufe0f for the WordPress community.<\/p>\n\n<!--section=installation-->\n<h4>Automatic Installation<\/h4>\n\n<ol>\n<li>Log in to your WordPress admin panel<\/li>\n<li>Navigate to Plugins \u2192 Add New<\/li>\n<li>Search for \"TOC Builder by RobertIvan\"<\/li>\n<li>Click \"Install Now\" and then \"Activate\"<\/li>\n<li>Navigate to TOC Builder in the WordPress sidebar to configure<\/li>\n<\/ol>\n\n<h4>Manual Installation<\/h4>\n\n<ol>\n<li>Download the plugin ZIP file<\/li>\n<li>Upload the <code>toc-master<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Navigate to TOC Builder in the WordPress sidebar to configure the plugin<\/li>\n<\/ol>\n\n<h4>After Activation<\/h4>\n\n<ol>\n<li>Go to TOC Builder in the WordPress sidebar<\/li>\n<li>Enable the Table of Contents<\/li>\n<li>Select which heading levels to include (H1-H6)<\/li>\n<li>Choose where to display the TOC (before\/after first heading, or top of content)<\/li>\n<li>Configure additional options like smooth scroll and collapsible TOC<\/li>\n<li>Save your settings<\/li>\n<\/ol>\n\n<p>The TOC will appear automatically on posts and pages (if enabled) or you can use the <code>[tbrv]<\/code> shortcode to place it manually.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id='how%20does%20the%20plugin%20work%3F'><h3>How does the plugin work?<\/h3><\/dt>\n<dd><p>TOC Builder by RobertIvan automatically scans your post or page content for HTML heading tags (H1 through H6) and generates a navigational Table of Contents. It adds unique IDs to each heading so users can jump directly to sections.<\/p><\/dd>\n<dt id='can%20i%20exclude%20specific%20headings%3F'><h3>Can I exclude specific headings?<\/h3><\/dt>\n<dd><p>Currently, you can select which heading levels (H1-H6) to include in the settings. For example, you can choose to only include H2 and H3 headings.<\/p><\/dd>\n<dt id='does%20it%20work%20with%20page%20builders%3F'><h3>Does it work with page builders?<\/h3><\/dt>\n<dd><p>Yes. It works with any content that uses standard HTML heading tags (<code>&lt;h1&gt;<\/code> to <code>&lt;h6&gt;<\/code>) and the standard WordPress <code>the_content<\/code> filter. This includes most major page builders.<\/p><\/dd>\n<dt id='how%20do%20i%20manually%20insert%20the%20toc%3F'><h3>How do I manually insert the TOC?<\/h3><\/dt>\n<dd><p>You have three options:\n1. Enable automatic insertion in TOC Builder settings\n2. Use the <code>[tbrv]<\/code> shortcode anywhere in your content\n3. Use the \"TOC Builder\" block in the Gutenberg editor<\/p><\/dd>\n<dt id='can%20i%20customize%20the%20appearance%3F'><h3>Can I customize the appearance?<\/h3><\/dt>\n<dd><p>The current version includes basic styling. Advanced appearance customization options (colors, typography, layout) are planned for future releases and will be accessible through the Appearance tab.<\/p><\/dd>\n<dt id='is%20it%20compatible%20with%20my%20theme%3F'><h3>Is it compatible with my theme?<\/h3><\/dt>\n<dd><p>Yes. TOC Builder by RobertIvan is designed to work with any WordPress theme that follows standard WordPress coding practices.<\/p><\/dd>\n<dt id='does%20it%20affect%20my%20site%27s%20performance%3F'><h3>Does it affect my site's performance?<\/h3><\/dt>\n<dd><p>No. The plugin is optimized for performance with minimal CSS and JavaScript that only loads when needed.<\/p><\/dd>\n<dt id='can%20i%20use%20it%20on%20multiple%20sites%3F'><h3>Can I use it on multiple sites?<\/h3><\/dt>\n<dd><p>Yes. This plugin is licensed under GPLv2, which allows you to use it on as many sites as you want.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Improved: Codebase refactoring for better compatibility<\/li>\n<li>Fixed: Minor bugs and stability improvements<\/li>\n<li>Improved: CSS loading optimization<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Changed: All functions, classes, and hooks prefixed with tbrv_ to prevent conflicts<\/li>\n<li>Changed: All CSS classes renamed to .tbrv-* for consistency<\/li>\n<li>Improved: WordPress coding standards compliance with unique prefixes throughout<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Added: WordPress sidebar menu with icon and structure<\/li>\n<li>Added: Separate admin pages for General, Appearance, Advanced, and Premium<\/li>\n<li>Added: Live preview that regenerates when selecting\/deselecting heading levels<\/li>\n<li>Added: Heading selectors with clickable areas<\/li>\n<li>Added: Visual selection feedback with gradient backgrounds<\/li>\n<li>Added: Preview generation showing TOC structure based on heading combinations<\/li>\n<li>Added: 2-column layout with settings and sticky preview side-by-side on desktop<\/li>\n<li>Improved: Asset loading - JavaScript only loaded on pages that need it<\/li>\n<li>Improved: UX with click-anywhere-on-box heading selection<\/li>\n<li>Fixed: Tab navigation replaced with WordPress standard submenu pages<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Added: Admin interface with design;<\/li>\n<li>Added: Tab-based navigation (General, Appearance, Advanced, Premium)<\/li>\n<li>Added: Live preview with interactive demo<\/li>\n<li>Added: Card-based settings layout<\/li>\n<li>Added: Animations and transitions in the admin interface<\/li>\n<li>Added: Responsive admin design<\/li>\n<li>Added: Architecture for upcoming premium features<\/li>\n<li>Improved: Visual feedback on user interactions<\/li>\n<li>Improved: Color scheme<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fixed: Bug where heading ID injection failed when headings had no existing attributes<\/li>\n<li>Fixed: JavaScript and CSS assets not loading properly on frontend<\/li>\n<li>Fixed: Variable scope issue causing incorrect heading IDs to be reused<\/li>\n<li>Improved: Offset-based string replacement for reliability<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release<\/li>\n<li>Added auto-detection of headings<\/li>\n<li>Added smooth scroll and SpyScroll<\/li>\n<li>Added Gutenberg block support<\/li>\n<\/ul>","raw_excerpt":"A Table of Contents generator for WordPress with admin interface.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/264088","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=264088"}],"author":[{"embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/robertivan"}],"wp:attachment":[{"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=264088"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=264088"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=264088"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=264088"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=264088"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/es.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=264088"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}