這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

f(x) TOC

外掛說明

f(x) TOC Simple Table Of Contents Plugin. Just add [toc] shortcode in content to display. This plugin will parse and grab all heading (h1 -h6) in your content and display it as structured table of contents (just like WikiPedia.org table of contents).

Features:

  1. Super simple and easy to use.
  2. Auto create Table of contents by listing all your headings in your content.
  3. The GPL v2.0 or later license. 🙂 Use it to make something cool.
  4. Support available at Genbu Media.

Shortcode Options:

You can use several options in [toc] shortcode:

  1. title: to change the title of table of contents, as default is Table of contents.
  2. title_tag: element wrapper for the title, the default is h2.
  3. list: you can use ul for unordered list (default), or ol for ordered list.
  4. depth: list depth (numeric). the default is 6.

Advance usage example using all the options:

[toc title=”This page content:” title_tag=”strong” list=”ol” depth=”1″]
Notes for developer:

Github

Development of this plugin is hosted at GitHub. Pull request and bug reports are welcome.

Hooks

List of hooks available in this plugin:

filter: fx_toc_default_args (array)

The default option for the shortcode.

filter: fx_toc_output (string)

HTML output of the shortcode.

安裝方式

  1. Navigate to “Plugins > Add New” Page from your Admin.
  2. To install directly from WordPress.org repository, search the plugin name in the search box and click “Install Now” button to install the plugin.
  3. To install from plugin .zip file, click “Upload Plugin” button in “Plugins > Add New” Screen. Browse the plugin .zip file, and click “Install Now” button.
  4. Activate the plugin.

常見問題集

Can I add this in widget ?

No, you can only add this shortcode in content.

Can I dislay it in archive pages?

Yes, if your theme display full content, table of contents will be displayed.

How to style this ?

The Table of contents output is wrapped in fx-toc class. You can style it using CSS.

使用者評論

2016 年 12 月 27 日
Very nice and easy TOC. Thanks so much for the plugin!
2016 年 11 月 12 日
Excellent plugin which does exactly what I was looking for. Unbloated (hope it stays that way) and hopefully updated when the need arises ... without adding too many options to it. Perfect the way it is. Love it! Thanks for making this one. 🙂
閱讀全部 5 則使用者評論

參與者及開發者

以下人員參與了開源軟體〈f(x) TOC〉的開發相關工作。

參與者

將 f(x) TOC 外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

1.1.0 – 04 May 2016

  • Display TOC on archive pages too.
  • Strip tags for each list item to avoid problem in the future.
  • Add plugin action link for support.
  • new filter “fx_toc_output”.

1.0.0 – 11 Jan 2016

  • Init