Rich Table of Contents

ཞིབ་བརྗོད།

RTOC is a table of contents generation plugin from Japan that allows anyone to easily create a table of contents. Equipped with the functions of the conventional table of contents plugin, it is designed to thoroughly pursue design and ease of use.
Introducing a real-time preview with an intuitive UI design allows you to create an ideal table of contents with a single button.It is definitely a plus factor for your blog or site.RTOC is easy to use, so please use it.

Install

【How to automatically install from the WordPress admin screen】
①Click “Plugins” “Add New” from the WordPress administration screen.
②Type “Rich Table of Contents” in the new search box.
③Activate after installation

【How to install manually using FTP etc.】
①Download this plugin from WordPress.org(There is a button called “Download” on the right side of the plugin title on this page, so download from there)
②Unzip the zip file called “rich-table-of-content” and download it to the / wp-content / plugins / directory.
③Click the plugin from the WordPress administration screen and click Activate.

Basic settings

Configure the basic settings for the table of contents.

  • Table of contents title: You can freely decide the title of the table of contents.
  • Auto insert for the following content types: You can decide whether to show the table of contents on posts and pages.
  • Heading to be displayed: Set which heading (h2, h3, h4) to display.
  • Display conditions: Set the number of headings to display the table of contents.
  • Font: Set font.

Design settings

You can freely set the table of contents design.

  • Title display: Set whether the title position is left or center.
  • H2 list design: Set the H2 list design.
  • H3 list design: Set the H3 list design.
  • Frame design: Sets the table of contents frame design.
  • Animation: Set the animation when the table of contents is displayed。
  • Smooth scroll : Set whether to scroll to the headline when clicking (tapping) the table of contents.

Preset color settings

RTOC color preset added by default. Choose and set the preset that suits your site.

Color settings(For advanced users)

In addition to the preset colors, you can set your own colors. If you want to set your own color or modify the preset color partially, please change the color here.

  • Title color: Set the title color.
  • Text color: Set the text color.
  • Back color: Set the back color.
  • Border color: Set the border color.
  • H2 list color: Set the H2 list color.
  • H3 list color: Set the H3 list color.
  • Back to table of contents button background color: Sets the background color of the back to table of contents button.(Available only when Back to Contents button is enabled)

Advanced settings

If you want to do advanced customization such as the button to return to the table of contents and the exclusion of plugin CSS, please set here.

  • Button to return to table of contents: (Only for smartphones) Display a button to return to the table of contents.
  • Button location to return to table of contents: (Only for smartphones) You can set the button to return to the table of contents to the left or right.
  • Up and down adjustment of the button to return to the table of contents: (example -20,40)
  • Excluded post ID: You can set posts that you do not want to show the table of contents. Set the table of contents not to be displayed in the article by entering the post article ID separated by commas.(Example 2,3,75)
  • Excluded page ID: You can set pages that you do not want to display the table of contents. By entering page IDs separated by commas, you can set the table of contents not to be displayed in articles.(Example 4,6,91)
  • Default table of contents settings: Select whether to display the table of contents open or closed.
  • Do not load plugin CSS: If checked, all CSS of RTOC will not be read and all design settings will be invalid. If you have customized the table of contents using CSS, JS, etc., please check here and operate.

RTOC shortcode

You can display the table of contents by pasting this code anywhere in the article. If you do not enter a value (such as title = “”) and it is blank, the setting on the management screen will be reflected.
For details, see the actual setting screen, so check that.

Help

If you have any problems, we will be glad to help you contact our support.
Also, basic issues are listed in the “Help section” of the plugin, so please look there first.

སྒྲིག་འཇུག

【How to automatically install from the WordPress admin screen】
①Click “Plugins” “Add New” from the WordPress administration screen.
②Type “Rich Table of Contents” in the new search box.
③Activate after installation

【How to install manually using FTP etc.】
①Download this plugin from WordPress.org(There is a button called “Download” on the right side of the plugin title on this page, so download from there)
②Unzip the zip file called “rich-table-of-content” and download it to the / wp-content / plugins / directory.
③Click the plugin from the WordPress administration screen and click Activate.

གདེང་འཇོག

2023 ལོའི་ཟླ 8 ཚེས 10 ཉིན།
I want to give it 4.5 stars. I rounded up. Since it was easy enough to make a work-around for any of my issues, it deserves at least a 4. And it works for keyboard-only users. I rejected 4 other table of contents plugins immediately after installing because there was no way for a keyboard-only user to open a closed table of contents and/or the links inside. This one can be tabbed to. Yay! I like that you can specify the heading level depth (though this is true of all table of contents plugins I tried). You can stop the ToC from appearing on specific pages and posts by listing the page/post id’s to exclude in the settings. I just discovered that you can also hide the table of contents on individual pages by using the shortcode and including heading=”h0″. No heading levels, no table of contents at all. (If this is not documented somewhere, it should be, because it is a useful feature for editors who do not have access to plugin settings.) However, explaining to my website owners that they need to add a shortcode to hide the table of contents is a bit strange. We have two custom post types and only want it to show on one. Checking the “Posts” box made it show not only on regular posts, but also on both custom post types. I used CSS display:none; to hide it on the type where we never want it to show, for lack of an alternative. My remaining issue concerned the styling, but I tend to modify most everything with my own CSS, and it was very easy to override the plugin’s styling. By the way, I just upgraded to WordPress 6.3 and the plugin still works. Oh, and it was able to generate a ToC on the “Opt-Out Preferences” page generated by Complianz, which several block-based ToC’s could not do because the generated content appears after the ToC’s block does. So now I am replacing all my ToC blocks on my personal site with the automatically-generated Rich Table of Contents and eagerly anticipating not having to insert another ToC block every time I write a new blog page.
2023 ལོའི་ཟླ 7 ཚེས 12 ཉིན།
プラグインバージョン1.3.97にバージョンアップすると、画面が真っ白、エラーメッセージが表示されるようです。(プラグインバージョン1.3.9は問題なし。)
2023 ལོའི་ཟླ 7 ཚེས 12 ཉིན།
JIN:R (1.2.0)でカテゴリを個別ページで設定している表示にすると、コンテンツが何も表示されなくなるバグがありましたが、即日で修正されました
2023 ལོའི་ཟླ 3 ཚེས 7 ཉིན།
Hello,Very nice plugin. I make a request.1. Please make it possible to change the text color and background color of the open/close button.2. When the open/close button is hidden, please align the title to the left.
2021 ལོའི་ཟླ 7 ཚེས 3 ཉིན།
The creators use the plugin as a mere marketing tool, there is no intention to make it usable, as you can see when you look for support. They won’t allow you to remove the main TOC and put it only where you want (by using the shortcode), even when they put checkboxes to make it happen. They are kidding us, and the promisse to change such an easy thing like this (checkboxes that doesn’t work) has been running for years now, with no real action taken after various updates. Patetic.
གདེང་འཇོག 17 ཡོངས་སུ་ཀློག

བྱས་རྗེས་འཇོག་མཁན། & གསར་འབྱེད་པ།

“Rich Table of Contents” is open source software. The following people have contributed to this plugin.

བྱས་རྗེས་འཇོག་མཁན།

“Rich Table of Contents” has been translated into 1 locale. Thank you to the translators for their contributions.

ཁྱེད་ཀྱི་སྐད་ཡིག་ནང་ལ་ “Rich Table of Contents” ཡིག་སྒྱུར་བྱོས།

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

དག་བཅོས་ཉིན་ཐོ།

1.0

First Release.

1.0.1

The version has been upgraded with minor corrections!

1.0.2

The version has been upgraded with minor corrections!

1.0.3

<Corrected item>
・[JIN only] Fixed the problem that characters written in the category disappeared
・Fixed the problem that the heading icon short code was displayed
・Fixed an issue that short code is not displayed when SPACE is included
・Fixed an issue where pasting a shortcode into a tracking widget was not reflected
・Fixed the problem that it is not displayed correctly only with ‘(‘ and ‘[‘
・Fixed display bug on IE and EDGE

1.0.4

<Corrected item>
・Fixed an issue where footer copyright display was broken by affinger
・Fixed an issue where the $ hook string was exposed on the admin screen
・Fixed an issue where a line break on a text editor would cause the line break to disappear even if the line was saved on a text editor.
・Fixed the problem that the set id is deleted when the id is set in the headline
┗The problem of IDs being deleted in the table of contents created with shortcodes continues.
・Fixed the problem that the top article disappears if RTOC is included when the fixed top page is set in “AFFINGER management”> “Top page” in affinger5

1.0.5

<Corrected item>
・fixed HTML structure of table of contents is broken
・Fixed a problem where the table of contents is displayed on a page even if the display check is removed.
・Fixed a problem where id is lost if id is set to a heading when a shortcode is used to generate a table of contents.
・Adding Help Items
・Correction of typos and omissions in the management screen.

1.0.6

<Corrected item>
・Fixed a problem where the “Back to Table of Contents” button is displayed even if there is no table of contents.

1.0.9

<Corrected item>
・Confirmed support for WordPress 5.4

1.1.0

<Added item>
・Added translation files to support English and Japanese.

1.1.2

<Corrected item>
・Corrected a typo in the management screen.

1.1.4

<Corrected item>
・Fixed a problem with HTML anchors in headings that caused the headings to jump to other headings when the table of contents was clicked.
・Fixed a problem where the design is not reflected when the headline design is customized. (Only font size is supported.)
・Fixed a problem that does not work even if you put RTOC in the sidebar follow widget and click it on the category page.
・Fixed the problem of links not jumping on category pages.
・Fixed a problem in which the ad above the first heading of JIN is displayed on the table of contents when the table of contents is set above the heading when using RTOC. (JIN only)

<Added item>
・Added an item that can change the text of the Back to Table of Contents button.
・Added an item that can change the text of the open/close button.

1.1.6

<Corrected item>
・Fixed a problem with the first heading.
・Fixed a problem with shortcode headings not jumping.

1.1.7

<Corrected item>
・Fixed a problem with a count() error when adding headings to a category page.
・Fixed an issue where IDs are not given for the first heading and you can’t jump from the table of contents.

1.1.9

<Corrected item>
・Fixed an issue where an article created in Gutenberg and edited in Classic Editor does not scroll when clicked on to check the article.
・Fixed an issue where the sequential numbering of the table of contents does not scroll correctly when using numbers.

1.1.97

<Corrected item>
・Added “rtoc-” to the name used in counter to prevent duplication when counter-increment is used in other themes and plugins.
・Fixed a problem where the sequential numbering was broken if H2 was numbered “1.” and H3 was numbered “01 |”.
・In RTOC Settings > Shortcodes > Table of Contents shortcode, change heading=”h3″ to heading=””.
・Fixed earlyacccess of Noto Sans JP to the official version.
・Fixed the paragraph structure of the output table of contents.
・Make it possible to handle Japanese characters in the id name.

1.1.98

<Corrected item>
・Added placeholder to the exclude ID setting in the application settings.
・Fixed a problem where the table of contents would also reflect headings that were bold or italicized, or contained other elements such as img tags in the headings.
・Fixed an issue where the Gutenberg Widget in WordPress 5.8 would throw an error.
・Fixed an issue where a popup would appear when using JIN, even if a color other than JIN color was set.

1.2.1

<New Features>
・Added a function to measure the usage rate of the table of contents for 7 days. Only articles with a table of contents are supported, and you can check the value on the article edit screen. (This figure is calculated by our own method.)
・Adjustment of existing designs
・Refactoring the code

1.2.2

<Corrected item>
・Fixed Syntax Error in PHP 7.2 and below that was found in Ver1.2.1.

1.2.5

<Corrected item>
-Support for WordPress 5.9-
・Fixed the problem of headings not jumping correctly.

1.2.6

<Corrected item>
-Support for WordPress 5.9-
・Fixed the problem of not jumping to the heading properly when using double-byte numbers or certain special characters.
・Fixed broken design in the sidebar.

1.3.0

Fixed issue with display of TOP page table of contents
Fixed issue with RTOC not being detected as table of contents in Rank Math SEO

Addition of a setting to hide the open/close button of the table of contents.
Addition of a setting to display the Back to Table of Contents button on PCs.
Addition of a function to display the Back to Table of Contents button with a fade-in.
Unify and brush up the table of contents design in the sidebar.

Adjustment of design in other themes.
Adjustment of the design of the sidebar.
Load fonts only for selected fonts.

1.3.1

Fixed an issue that prevented viewing media and editing articles.
Fixed an issue where a margin would open under an article on the TOP page.

1.3.2

Fixed an issue that caused an error when activating the plugin.
Fixed an issue that caused margins to appear when the top page is a fixed page.

1.3.4

Fixed an issue with a margin opening under the footer when viewing the article on a mobile phone.
Fixed an issue where the sidebar would be covered when viewing an article on a mobile phone.
Fixed an issue where the design of the sidebar would be corrupted when a specific design is selected.

1.3.5

Added a check box to not display the table of contents on the TOP page.

Adjusted the CSS of the table of contents.
Adjustment of open/close button design.

Fixed a problem with the table of contents of other articles being displayed on fixed pages.
Fixed a problem with shortcodes not displaying properly.
Fixed a problem that the messages of other plug-ins are not displayed on the RTOC setting screen.
Fixed a JS error when a shortcode was added to the sidebar with no table of contents in the article.

1.3.6

Support for WordPress 6.1.1

Fixed an issue where the table of contents title was right-aligned when there was a table of contents in the sidebar.
Fixed an issue where the open/close button of the table of contents was below the title.
Fixed an issue where the table of contents stops tracking when the page frame is trimmed.
Fixed an issue where the title color of the table of contents was not reflected.
Fixed an issue where the table of contents is displayed even on category pages when using the WordPress theme JIN:R.

1.3.8

The following issues have been corrected.
「RTOC does not validate and escapes some of its shortcode attributes before outputting them back in the page, which could allow users with a role as low as a contributor to perform Stored Cross-Site Scripting attacks, which could be used against high privileged users such as admin. and we consider it a high-risk level.」

1.3.9

The following issues have been corrected.
「RTOC does not validate and escapes some of its shortcode attributes before outputting them back in the page, which could allow users with a role as low as a contributor to perform Stored Cross-Site Scripting attacks, which could be used against high privileged users such as admin. and we consider it a high-risk level.」

1.3.91

・Support for WordPress 6.2
・Partial refactoring of internal code
・Banner replacement

1.3.96

・Fixed an issue that the table of contents is not displayed on fixed pages with customized categories of WordPress theme JIN:R.
・Design Adjustment

1.3.97

・Design Adjustment

1.3.99

・Fixed an error when using a theme other than JIN:R.

1.4.0

Support for WordPress 6.6.1

・Fixed an issue where a Warning error would occur if you went to the article page before entering the settings screen.
・Fixed an issue where initial values were not reflected when the plugin was activated for the first time.
・Fixed an issue with the table of contents in the sidebar penetrating into the footer in certain environments.
・Fixed an issue that caused Javascript errors under certain conditions.