Title: HM Content TOC
Author: dashaluna
Published: 2015 年 10 月 6 日
Last modified: 2015 年 10 月 7 日
---
搜尋外掛
這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個
外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。
# HM Content TOC
由 [dashaluna](https://profiles.wordpress.org/dashaluna/) 開發
[下載](https://downloads.wordpress.org/plugin/hm-content-toc.1.0.1.zip)
* [詳細資料](https://tw.wordpress.org/plugins/hm-content-toc/#description)
* [使用者評論](https://tw.wordpress.org/plugins/hm-content-toc/#reviews)
* [安裝方式](https://tw.wordpress.org/plugins/hm-content-toc/#installation)
* [開發資訊](https://tw.wordpress.org/plugins/hm-content-toc/#developers)
[技術支援](https://wordpress.org/support/plugin/hm-content-toc/)
## 外掛說明
The plugin provides:
* Shortcode `[hm_content_toc]` with `title` and `headers` attributes.
The shortcode
should be inserted into post/page content with optional attributes Example: `[
hm_content_toc title="TOC title" headers="h2, h3, h4"]`
* Plugin settings to specify default TOC settings for title and header, which will
be used in case a shortcode is specified without attributes, i.e. `[hm_content_toc]`
Plugin’s defaults are: empty title and headers `h2, h3, h4, h5, h6`
* Integration with [“Shortcake (Shortcode UI)” plugin](https://wordpress.org/plugins/shortcode-ui/)
### Bugs or feature requests
To report bugs or feature requests, [please use Github issues](https://github.com/dashaluna/hm-content-toc/issues).
### Translations
* English – default, always included
* Русский (Russian) by [Dasha Luna](https://profiles.wordpress.org/dashaluna)
* Italiano (Italian) by [Franz Vitulli](https://profiles.wordpress.org/franz-vitulli)
* Português (Portuguese – Portugal) by [Ana Silva](https://profiles.wordpress.org/anafransilva)
_Note:_ All my plugins are localized/translatable by default. This is very important
for
all users worldwide. So please contribute your language to the plugin to make
it even more useful. Please read the [instructions on how to contribute a translation](https://github.com/dashaluna/hm-content-toc/tree/master/languages).
### License: GPLv2 or later
This program is free software; you can redistribute it and/or modify
it under the
terms of the GNU General Public License as published by the Free Software Foundation;
either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE. See the GNU General Public License for more details.
## 螢幕擷圖
[⌊WordPress Admin: Plugins page - a summary of the plugin with quick action links
to plugin's Settings and Documentation on github webiste.⌉⌊WordPress Admin: Plugins
page - a summary of the plugin with quick action links to plugin's Settings and
Documentation on github webiste.⌉[
WordPress Admin: Plugins page – a summary of the plugin with quick action links
to plugin’s Settings and [Documentation on github webiste](https://github.com/dashaluna/hm-content-toc#readme).
[⌊WordPress Admin: Settings page - plugin's default settings. These settings will
be used when a shortcode [hm_content_toc] is specified without attributes. Shortcode
attribute takes precedence over default settings.⌉⌊WordPress Admin: Settings page-
plugin's default settings. These settings will be used when a shortcode [hm_content_toc]
is specified without attributes. Shortcode attribute takes precedence over default
settings.⌉[
WordPress Admin: Settings page – plugin’s default settings. These settings will
be used when a shortcode `[hm_content_toc]` is specified without attributes. Shortcode
attribute takes precedence over default settings.
[⌊WordPress Admin: Pages - example of a page that uses [hm_content_toc] shortcode
with its attributes, to specify title that appears before TOC and HTML element names
used to generate the TOC.⌉⌊WordPress Admin: Pages - example of a page that uses [
hm_content_toc] shortcode with its attributes, to specify title that appears before
TOC and HTML element names used to generate the TOC.⌉[
WordPress Admin: Pages – example of a page that uses `[hm_content_toc]` shortcode
with its attributes, to specify title that appears before TOC and HTML element names
used to generate the TOC.
[⌊Main website: Example of a page with generated TOC with specified parameters.⌉⌊
Main website: Example of a page with generated TOC with specified parameters.⌉[
Main website: Example of a page with generated TOC with specified parameters.
[⌊Main website: Example of a page when a link from the TOC is clicked. In this case,
the Heading #3 - third level link from the TOC is clicked, a visitor is taken to
that heading within the page content. The URL uses an anchor that has been inserted
before the heading in the page content.⌉⌊Main website: Example of a page when a
link from the TOC is clicked. In this case, the Heading #3 - third level link from
the TOC is clicked, a visitor is taken to that heading within the page content.
The URL uses an anchor that has been inserted before the heading in the page content
.⌉[
Main website: Example of a page when a link from the TOC is clicked. In this case,
the `Heading #3 - third level` link from the TOC is clicked, a visitor is taken
to that heading within the page content. The URL uses an anchor that has been inserted
before the heading in the page content.
[⌊WordPress Admin: Integration with Shortcake UI - the view when Add Media button
is clicked. The Insert Post Element tab lists all registered shortcodes with Shortcake.
The HM Content TOC is present to be inserted into post/page content.⌉⌊WordPress
Admin: Integration with Shortcake UI - the view when Add Media button is clicked.
The Insert Post Element tab lists all registered shortcodes with Shortcake. The
HM Content TOC is present to be inserted into post/page content.⌉[
WordPress Admin: Integration with Shortcake UI – the view when `Add Media` button
is clicked. The `Insert Post Element` tab lists all registered shortcodes with Shortcake.
The `HM Content TOC` is present to be inserted into post/page content.
[⌊WordPress Admin: Integration with Shortcake UI - the view when HM Content TOC
box was clicked, allowing for shortcode parameters to be specified.⌉⌊WordPress Admin:
Integration with Shortcake UI - the view when HM Content TOC box was clicked, allowing
for shortcode parameters to be specified.⌉[
WordPress Admin: Integration with Shortcake UI – the view when `HM Content TOC`
box was clicked, allowing for shortcode parameters to be specified.
## 安裝方式
HM Content TOC can be installed like any other WordPress plugin.
1. Upload the entire folder `hm-content-toc` to the `/wp-content/plugins/` directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Plugin settings will be added to WordPress Settings admin menu, i.e. `Settings -
> HM Content TOC Settings`, to specify the default settings for the plugin.
4. The settings page is visible only for users who can manage options, by default
it is super administrators and administrators.
5. Now you can use `[hm_content_toc]` shortcode in your post/page content to generate
TOC for specified headers from that post/page content.
## 常見問題集
1. What versions of WordPress are supported?
The plugin has been extensively tested on both standard and multisite installations
for the following WordPress versions:
* latest stable version [refer to Release Archive on wordpress.org site](https://wordpress.org/download/release-archive/)
* 4.2
## 使用者評論
### [Not as good as it could be](https://wordpress.org/support/topic/not-as-good-as-it-could-be/)
[thomask](https://profiles.wordpress.org/thomask/) 2016 年 9 月 3 日 1 則留言
It works, but i do not like two things 1. there is only one level of UL. Especialy
for headers i would prefer also possibility of nested TOC with H3 intended over
H2 etc. 2. Integration with shortcake is fine on first sight, but the problem is,
that the TOC is not visible in wysiwyg editor – the widget is there, but it has
zero height, so it it almost impossible to work with it
### [Simple and works](https://wordpress.org/support/topic/simple-and-works-109/)
[Rose](https://profiles.wordpress.org/thorned-rose/) 2016 年 9 月 3 日 1 則留言
Works straight out of the box and does exactly what it says. All I wanted was a
nice simple ToC without unneccesary bloat and this does just that. One thing I would
have liked to have seen is that the jump links created were the text of the headers
and not just “heading-1”, “heading-2″, etc. e.g. – My first h1 title – should be
My first h1 title
. Better for SEO and better for
screen readers. This is the only reason I didn’t give 5/5. Otherwise stellar plugin!
[ 閱讀全部 2 則使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/)
## 參與者及開發者
以下人員參與了開源軟體〈HM Content TOC〉的開發相關工作。
參與者
* [ dashaluna ](https://profiles.wordpress.org/dashaluna/)
* [ tcrsavage ](https://profiles.wordpress.org/tcrsavage/)
* [ John Blackbourn ](https://profiles.wordpress.org/johnbillion/)
* [ Robert O’Rourke ](https://profiles.wordpress.org/sanchothefat/)
[將〈HM Content TOC〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/hm-content-toc)
### 對開發相關資訊感興趣？
任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/hm-content-toc/)、
查看 [SVN 存放庫](https://plugins.svn.wordpress.org/hm-content-toc/)，或透過 [RSS](https://plugins.trac.wordpress.org/log/hm-content-toc/?limit=100&mode=stop_on_copy&format=rss)
訂閱[開發記錄](https://plugins.trac.wordpress.org/log/hm-content-toc/)。
## 變更記錄
#### 1.0.1
* Removed a full stop at the end of the plugin description as it was too long by
WP standards – doh!
## 中繼資料
* 版本 **1.0.1**
* 最後更新 **11 年前**
* 啟用安裝數 **10+**
* WordPress 版本需求 ** 4.2 或更新版本 **
* 已測試相容的 WordPress 版本 **4.3.34**
* 語言
* [English (US)](https://wordpress.org/plugins/hm-content-toc/)
* 標籤:
* [shortcode](https://tw.wordpress.org/plugins/tags/shortcode/)[toc](https://tw.wordpress.org/plugins/tags/toc/)
[toc shortcode](https://tw.wordpress.org/plugins/tags/toc-shortcode/)
* [進階檢視](https://tw.wordpress.org/plugins/hm-content-toc/advanced/)
## 評分
3.5 星，滿分為 5 星
* [ 0 個 5 星使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/?filter=5)
* [ 1 個 4 星使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/?filter=4)
* [ 1 個 3 星使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/?filter=3)
* [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/?filter=2)
* [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/hm-content-toc/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/hm-content-toc/reviews/#new-post)
[查看全部使用者評論](https://wordpress.org/support/plugin/hm-content-toc/reviews/)
## 參與者
* [ dashaluna ](https://profiles.wordpress.org/dashaluna/)
* [ tcrsavage ](https://profiles.wordpress.org/tcrsavage/)
* [ John Blackbourn ](https://profiles.wordpress.org/johnbillion/)
* [ Robert O’Rourke ](https://profiles.wordpress.org/sanchothefat/)
## 技術支援
使用者可在技術支援論壇提出意見反應或使用問題。
[檢視技術支援論壇](https://wordpress.org/support/plugin/hm-content-toc/)