ショートコードウィザード

GUIベースのウィザードでショートコードを自動生成する方法と、利用可能なショートコードパラメータについて解説します。

ウィザードの使い方

管理画面の「Kashiwazaki SEO Shortcode Collector」から「ウィザード」タブを開くと、ショートコード生成ウィザードが表示されます。

管理画面の左メニューから Kashiwazaki SEO Shortcode Collector をクリックし、ウィザードタブを選択します。

投稿タイプを選択します。投稿・固定ページ・カスタム投稿タイプから選択できます。選択すると、対応するカテゴリが自動的に読み込まれます。

必要に応じてカテゴリを選択します。特定のカテゴリに絞り込んでコンテンツを表示したい場合に指定します。

レイアウト（グリッド・リスト・カルーセル）と、グリッドの場合は列数（1〜6列）を選択します。

「プレビュー」ボタンをクリックすると、設定内容に基づいたコンテンツ一覧のプレビューが表示されます。

プレビューを確認後、「ショートコードをコピー」ボタンで生成されたショートコードをクリップボードにコピーし、投稿や固定ページのエディタに貼り付けます。

ヒント

ウィザードでの投稿タイプ選択やカテゴリ読み込みはAJAXで動的に処理されるため、ページのリロードなしでスムーズに操作できます。

ウィザードを使わずに手動でショートコードを記述する場合は、以下のパラメータを使用できます。

パラメータ	説明
post_type	取得する投稿タイプを指定します。`post`（投稿）、`page`（固定ページ）、またはカスタム投稿タイプのスラッグを指定します。
category	カテゴリのスラッグまたはIDを指定します。省略した場合はすべてのカテゴリが対象になります。
layout	レイアウトを指定します。`grid`（グリッド）、`list`（リスト）、`carousel`（カルーセル）から選択します。
columns	グリッドレイアウト時の列数を指定します（1〜6）。グリッド以外のレイアウトでは無視されます。

投稿を3列グリッドで表示:

[ksc_collector post_type="post" layout="grid" columns="3"]

特定カテゴリの投稿をリスト表示:

[ksc_collector post_type="post" category="news" layout="list"]

カスタム投稿タイプをカルーセル表示:

[ksc_collector post_type="product" layout="carousel"]

ウィザードのプレビュー機能では、ショートコードの出力結果を管理画面上で事前に確認できます。プレビューはAJAXで動的に生成されるため、設定を変更するたびにリアルタイムで結果を確認できます。

注意

プレビューはあくまで管理画面上の表示です。フロントエンドではテーマのCSSが適用されるため、実際の見た目は若干異なる場合があります。

本プラグインは管理画面のウィザード機能を実現するために、4つのAJAXハンドラーを使用しています。

ハンドラー	機能
投稿タイプ取得	登録されている投稿タイプの一覧を動的に取得します。
カテゴリ取得	選択された投稿タイプに紐づくカテゴリを取得します。
プレビュー生成	設定されたパラメータに基づいてコンテンツ一覧のプレビューを生成します。
ショートコード生成	選択された設定からショートコード文字列を生成します。

補足

AJAXハンドラーはすべてnonce検証を行い、管理者権限を持つユーザーのみがアクセスできます。