初対面の人にも大雑把なTHE☆O型を当てられてしまうのに、Web と PC 周りでは細かいところが気になる小倉(@ogr8beat)です。

Table of Contents Plus」は、自動的にもくじを生成してくれる便利で有名な WordPress プラグインです。

有効化するだけで機能は使えるのですが、記事によってはカスタマイズを加えたいシーンもあるのではないでしょうか。
ショートコードを使うことで、その要望を叶えられる場合があります。WordPress公式ディレクトリより、TOC+独自のショートコードをまとめておきます。

もくじ関連のショートコード

もくじの表示/非表示

[toc]

もっとも基本となるショートコード。
プラグインの設定で表示条件を指定しているはずなので、それに合致する場合はこのショートコードを記述していなくても自動的にもくじは表示されます。
もくじを非表示にしたい場合、以下のショートコードを任意の場所に記述します。

[no_toc]

これらのショートコードは投稿(ポスト)、固定ページ、カスタム投稿タイプで有効です。

もくじのタイトルを変更する

[toc label="もくじのタイトル"]

設定したデフォルトとは違うタイトルをつけるには、labelプロパティを使用します。

もくじのタイトルを非表示

[toc no_label=true]

もくじに含める見出しを制御する

[toc heading_levels="2,3"]

ブログ記事で使われる中見出しは主に<h2>以降です。
<h3>のみにしたい、<h3><h4>だけにしたいなど、もくじとして表示したい見出しレベルを個別に指定できます。もくじに含めたい見出しレベル(<h2>なら2)をheading_levelsに記述するだけ。複数指定するときは例のようにコンマで区切ります。

もくじを回り込ませる

[toc float="left"]

floatプロパティを付与することができます。leftもしくはrightのみ指定可能。

もくじにクラスをつける

[toc class="クラス名"]

任意のクラスをつけることができます。このクラスは1つでなくてもよく、半角スペースで区切ることで複数のクラスをつけられます。

サイトマップ関連のショートコード

サイトマップを表示する

[sitemap]

すべての固定ページとカテゴリのリストを自動生成します。投稿やページだけでなくテキストウィジェットでも使用できますが、これには投稿(ポスト)は含まれません。

固定ページのみのサイトマップを表示する

[sitemap_pages]

投稿(ポスト)、カテゴリページなどは含まれません。

  • <h1><h6>までの使用する見出しを指定
[sitemap_pages heading="数字"]
  • リストのタイトルを変更
[sitemap_pages label="リストのタイトル"]
  • リストのタイトルを非表示(false もしくは true)
[sitemap_pages no_label="false"]
  • リストからページまたはカテゴリを除外
[sitemap_pages exclude="除外するページまたはカテゴリのID"]
  • リストからページまたはカテゴリを除外(子孫を含む)
[sitemap_pages exclude_tree="除外するページまたはカテゴリのID"]

カテゴリのみのサイトマップを表示する

[sitemap_categories]

[sitemap_pages] と挙動は同じで、カテゴリのみのリストを生成します。

投稿を含むサイトマップを表示する

[sitemap_posts]

[sitemap]固定ページとカテゴリのみのリストでしたが、これは公開されたすべての投稿(ポスト)のリストを生成します。デフォルトではアルファベット順に並べられています。

  • 並び順を変更(ASCで昇順、DESCで降順)
[sitemap_posts order="ASC"]
  • タイトル順
[sitemap_posts orderby="title"]
  • 投稿日時順
[sitemap_posts orderby="date"]
  • ID順
[sitemap_posts orderby="ID"]
  • ランダム
[sitemap_posts orderby="rand"]
[sitemap_posts separate="true"]

サイトマップはともかく、もくじのショートコードは結構日常的に使うと思います。細かく見出しを分けて<h3>は除いていいかな~なんてときですね。これいらない気がする…とよそ様のブログを見ていて思うことも多いです。

[toc heading_levels="2,3"]あたりはクイックタグに登録しておくのも手。せっかく導入しているプラグインなので、ぜひご活用ください。

WordPress

    Leave a comment

    Trackback URL :

    1. […]  8beat Studio  1 tweetTable of Contents Plus ショートコードまとめhttps://8beat-studio.net/table-of-contents-plus-shortcode/初対面の人にも大雑把なTHE☆O型を当てられてしまうのに、Web と PC 周りでは […]

    2. […]  8beat Studio  1 tweet 1 userTable of Contents Plus ショートコードまとめhttps://8beat-studio.net/table-of-contents-plus-shortcode/初対面の人にも大雑把なTHE☆O型を当てられてしまうのに、Web と PC […]

    3. […] な点もあります。 [ toc]以外の、[ no_toc]や[ toc heading_levels=”2,3″]などは実装されていないようです。 ショートコード参考ページ:Table of Contents Plus ショートコードまとめ – 8beat Studio […]

    Related Posts