カテゴリーウィジェットExtプラグイン
プラグイン本体
サポートオプション
カテゴリーウィジェットExtプラグインは、デフォルトのカテゴリーウィジェットを大幅に拡張したプラグインです。デフォルトでは、ドロップダウンで表示、投稿数の表示、階層を表示の3つのオプションしか用意されておらず、用途がかなり限定されてしまいます。しかし、カテゴリーウィジェットExtプラグインを使用すれば、投稿を合わせて表示したり、特定のカテゴリーのみを表示したり、様々なケースに対応しています。
さらには、カスタム投稿タイプのカスタム分類(taxonomy)にも対応。カテゴリーの一覧同様、カスタム分類でも階層表示や投稿表示が可能です。
インストール
- ダウンロードした圧縮ファイルを解凍後、`category-widget-ext`ディレクトリを`wp-content/plugins`ディレクトリにアップロードします。
- WordPressの管理メニューからプラグインを選択し、カテゴリーウィジェットExtプラグインを有効化します。
- 管理メニューの外観にあるウィジェットから設定を行います。
ウィジェット設定
カテゴリーウィジェットExtプラグインのウィジェットの設定は以下のとおりです。
- タイトル
ウィジェットのタイトルを指定します。何も指定しないデフォルトは、カテゴリーです。 - カスタム分類
デフォルトはカテゴリーです。カスタム分類が登録されているとここに表示されます。 - ドロップダウンで表示
リスト表示ではなく、ドロップダウンで表示する場合はチェックを入れます。以下の多くの設定は、リスト表示の拡張用なので、ドロップダウンでは設定が反映されませんのでご注意ください。 - 投稿数を表示する
カテゴリー横にそのカテゴリーに属する投稿数を表示する場合はチェックを入れます。 - タイトルに投稿数を表示しない
投稿数を表示するにチェックが入っている場合に、タイトルに投稿数を表示したくない場合にチェックを入れます。 - 階層を表示
カテゴリーの表示を階層で表示する場合はチェックを入れます。 - 空のカテゴリーを隠す
投稿がないカテゴリーを表示させたくない場合はチェックを入れます。 - メニュータイトルをカテゴリー名に変更
ウィジェットのタイトルをカテゴリー名で置き換えることができます。カテゴリートップではタイトルが表示されますが、下層カテゴリーではカテゴリー名で置換されます。 - タイトル属性に説明文を加える
カテゴリーに説明文がある場合、リンクにtitle属性を追加します。 - サブカテゴリーのみ表示
カテゴリーページでは、自カテゴリーに属するサブカテゴリーのみを表示することができます。関係のないカテゴリーを表示する必要がない場合、カテゴリーの階層がはっきりしている場合などに使用します。直下のサブカテゴリーのみ展開と合わせて指定することはできません。 - 直下のサブカテゴリーのみ展開
カテゴリーページでは、自カテゴリーに属するサブカテゴリーのみを展開することができます。関係のないカテゴリーはトップカテゴリーのみ表示されます。サブカテゴリーのみ表示と合わせて指定することはできません。 - 投稿を表示する
カテゴリーに付随する投稿を表示することができます。 - 直下のサブカテゴリーのみ投稿を表示
投稿を表示するにチェックを入れておく必要があります。現在表示しているカテゴリーに付随する投稿のみ表示します。 - 表示中の投稿を除外する
現在表示している投稿を除外して投稿リストを表示することができます。投稿を表示するにチェックを入れる必要があります。 - トップページに投稿を表示しない
トップページに投稿を表示したくない場合はチェックを入れます。 - 並び順
名前、投稿数、スラッグ、IDの中から選択してください。 - 順序
並び順の順序を昇順、降順から選択してください。 - 排除カテゴリーID (1.2.4以上)
リストから排除したいカテゴリーIDをカンマ区切りで指定してください。 - 表示する投稿数
カテゴリーに付随する投稿をいくつ表示させるかを指定します。制限はありませんが、あまり多くを設定すると負荷がかかると思います。 - 固定表示カテゴリーID
特定のカテゴリーのリストを表示したい場合にカテゴリーIDを指定してください。カテゴリーIDの確認方法は、管理メニューの投稿にあるカテゴリーでカテゴリー名にカーソルを合わせるとcat_IDが現れますのでその値を入力してください。0はカテゴリーを指定しないという意味です。 - 投稿非表示カテゴリーID
投稿を表示したくないカテゴリーがある場合は、「,」カンマ区切りでカテゴリーIDを指定します。デフォルトは空欄です。 - トップ階層
トップページのカテゴリー階層を何階層まで表示するかを指定します。デフォルトは0で階層に制限を付けません。この項目を有効にするには、階層を表示にチェックを入れる必要があります。 - サブ階層
サブカテゴリーページのカテゴリー階層を何階層まで表示するかを指定します。デフォルトは0で階層に制限を付けません。この項目を有効にするには、階層を表示とカテゴリー直下のサブカテゴリーのみ表示するにチェックを入れる必要があります。
ショートコード
カテゴリーウィジェットExtプラグインは、ショートコードからも使用できます。もっとも簡単なショートコードは[cwe]です。ショートコードで設定できるオプションは以下のとおりです。
- before_widget
カテゴリーボックスのタグを指定します。デフォルトは、<div class="cwe"> です。例)[cwe before_widget="<div>" after_widget="</div>"] - after_widget
カテゴリーボックスを閉じるタグを指定します。デフォルトは、</div> です。 - before_title
タイトルのタグを指定します。デフォルトは、<h4> です。例)[cwe before_title="<strong>" after_title="</strong>"] - after_title
タイトルを閉じるタグを指定します。デフォルトは、</h4> です。 - notitle
タイトルを表示しない場合に1を指定します。例)[cwe notitle=1] - title
タイトルを指定します。例)[cwe title="カテゴリーリスト"] - dropdown
ドロップダウンで表示する場合に指定します。例)[cwe dropdown=1] - count
タイトルに投稿数を表示しない場合に指定します。例)[cwe notitlecount=1] - notitlecount
投稿数を表示する場合に指定します。例)[cwe count=1] - hierarchical
階層を表示する場合に指定します。例)[cwe hierarchical=1] - hideempty
投稿がないからのカテゴリーを表示させない場合に指定します。例)[cwe hideempty=1] - use_desc_for_title
カテゴリーの説明文をリンクのtitle属性に表示させるかを指定します。例)[cwe use_desc_for_title=1] - behalf
メニュータイトルをカテゴリー名に変更する場合に指定します。例)[cwe behalf=1] - subcategory
カテゴリー直下のサブカテゴリーのみ表示する場合に指定します。例)[cwe subcategory=1] - open_only_sub
カテゴリー直下のサブカテゴリーのみ展開する場合に指定します。例)[cwe open_only_sub=1] - showposts
カテゴリーに付随する投稿を表示する場合は指定します。例)[cwe showposts=1] - show_only_sub
カテゴリー直下のサブカテゴリーのみ投稿を表示する場合に指定します。例)[cwe showposts=1 show_only_sub=1] - except
表示中の投稿を除外する場合に指定します。例)[cwe except=1] - excepttop
トップページに投稿を表示したくない場合は指定します。例)[cwe excepttop=1] - orderby
並び順を指定します。例)[cwe orderby=id] - order
順序を指定します。例)[cwe order=desc] - exclude (1.2.4以上)
排除カテゴリーIDをカンマ区切りで指定します。例)[cwe exclude="5,7"] - num
投稿数を指定します。デフォルトは、5です。例)[cwe num=15] - catid
特定のカテゴリーのリストを表示させたい場合にカテゴリーIDを指定します。例)[cwe catid=35] - nopostcats
投稿を表示したくないカテゴリーIDを「,」カンマ区切りで指定します。例)[cwe nopostcats="1,5,7"] - topdepth
トップページのカテゴリー階層を何階層まで表示するかを指定します。例)[cwe topdepth=1] - subdepth
サブカテゴリーページのカテゴリー階層を何階層まで表示するかを指定します。例)[cwe subdepth=2] - orderby
カテゴリーの並び順を指定します。デフォルトはnameです。My Category Orderプラグインが存在する場合は、デフォルトはorderとなります。例)[cwe orderby="order"] - order
カテゴリーの並び順の昇順か降順かを指定します。デフォルトはASCです。例)[cwe orderby="DESC"]
ライセンス
このプラグインは、WordPressと同じライセンスであるGNU GPLを採用しています。
変更履歴
- 1.2.6 2017年08月20日
- コードクリーニング。
- 1.2.5 2014年10月31日
- バグフィックス: カスタム分類使用時のドロップダウンリストからのリンク。
- 1.2.4 2014年07月17日
- 排除カテゴリーID(カンマ区切り)。
- 1.2.3 2014年02月26日
- コードクリーニング。
- 1.2.2 2013年11月19日
- バグフィックス: ウィジェットの読込方式。
- 1.2.1 2011年10月05日
- バグフィックス: メインクエリへの影響
- 1.2 2011年05月30日
- post-item クラスをリストに追加。
- タイトルに投稿数を表示させないオプション。
- 直下のサブカテゴリーのみ投稿を表示するオプション。
- 1.1.1 2010年07月13日
- 並び順、順序のオプション追加
- 1.1 2010年07月02日
- カスタム投稿タイプのカスタム分類に対応
- 1.0.2 2010年04月13日
- 下層カテゴリーページのみサブカテゴリーを展開するオプションの追加
- バグ修正:ショートコードの挿入位置
- 1.0.1 2010年02月09日
- トップ階層、サブ階層の追加
- バグ修正:hierarchical
- 1.0 2010年01月27日 初リリース
多言語化
- 英語、日本語対応