wp-plugin-kashiwazaki-seo-shortcode-collector

Kashiwazaki Shortcode Collector is a powerful WordPress plugin that lets you beautifully showcase posts, pages, and custom post types. With its intuitive interface, it’s easy to use for everyone—from beginners to advanced users.

PHP ★ 0 🕔 0 GNU General Public License v2.0

Kashiwazaki SEO Shortcode Collector

WordPress
PHP
License
Version

指定した投稿タイプやカテゴリをショートコードで一括で呼び出すWordPressプラグイン

主な機能

  • 3つのデザインパターン - グリッド、リスト、カルーセルから選択可能
  • ビジュアルウィザード - コード不要でショートコードを生成
  • 完全レスポンシブ - すべてのデバイスで最適な表示
  • 高度なカスタマイズ - 列数、行数、色、配置を細かく制御
  • ページネーション - 大量の投稿を複数ページに分割(AJAX対応)
  • SEO最適化 - タイトルタグを自由に選択(h1〜h6、div)
  • 投稿タイプ対応 - 標準投稿、固定ページ、カスタム投稿タイプ

インストール

  1. プラグインファイルを /wp-content/plugins/kashiwazaki-shortcode-collector ディレクトリにアップロード
  2. WordPressの「プラグイン」メニューからプラグインを有効化
  3. 管理画面の「Kashiwazaki SEO Shortcode Collector」メニューから設定を確認

基本的な使い方

ウィザードを使う(推奨)

管理画面 → Kashiwazaki SEO Shortcode Collector → 「ショートコード作成ウィザード」タブ

6ステップで簡単にショートコードを作成できます:

  1. 投稿タイプを選択
  2. カテゴリ・分類を選択(任意)
  3. デザインパターンと色を設定
  4. レイアウト(列数・行数)を設定
  5. 表示内容を設定
  6. 詳細設定(リンクターゲット等)

手動でショートコードを書く

[ksc_posts post_type="post" cols="3" rows="2"]

デザインパターン

グリッド表示

[ksc_posts post_type="post" design="grid" cols="3" rows="2"]

カード形式で投稿を格子状に並べます。

リスト表示

[ksc_posts post_type="post" design="list" rows="5"]

縦一列でシンプルに投稿を並べます。サムネイルは表示されません。

カルーセル表示

[ksc_posts post_type="post" design="carousel" cols="3" autoplay="true" interval="3000"]

左右にスライドする形式で投稿を表示します。


パラメータ一覧

基本パラメータ

パラメータ 説明 デフォルト値 選択肢
post_type 投稿タイプ post post, page, カスタム投稿タイプ名
category カテゴリ・分類スラッグ (空) カテゴリスラッグ
design デザインパターン grid grid, list, carousel
cols 列数(横に並べる数) 3 1〜6
rows 行数 2 1〜10
color テキストカラー #333333 #000000形式
target リンクターゲット _self _self, _blank
description_length 抜粋文の長さ(単語数) 150 数値

表示内容パラメータ

パラメータ 説明 デフォルト値
show_title タイトルを表示 true
title_tag タイトルのHTMLタグ h2
show_date 投稿日を表示 true
show_modified 更新日を表示 false
show_author 投稿者を表示 false
show_excerpt 抜粋文を表示 true
show_category カテゴリを表示 false
show_tags タグを表示 false
show_read_more 続きを読むリンクを表示 false
read_more_text 続きを読むリンクのテキスト 続きを読む
date_format 日付の表示形式 Y.m.d

title_tagの選択肢: h1, h2, h3, h4, h5, h6, div

date_formatの例:

  • Y.m.d → 2024.01.15
  • Y年m月d日 → 2024年1月15日
  • Y/m/d → 2024/01/15

サムネイル(アイキャッチ画像)パラメータ

パラメータ 説明 デフォルト値
show_thumbnail サムネイルを表示 true
thumbnail_position サムネイルの位置 top
thumbnail_size サムネイルのサイズ full

thumbnail_positionの選択肢: top(上), left(左), right(右)

thumbnail_sizeの選択肢:

  • thumbnail - サムネイル(小)
  • medium - 中サイズ
  • large - 大サイズ
  • full - フルサイズ(オリジナル)

ソートパラメータ

パラメータ 説明 デフォルト値
orderby 並び順の基準 date
order 昇順/降順 DESC

orderbyの選択肢:

  • date - 投稿日
  • title - タイトル
  • modified - 更新日
  • rand - ランダム

orderの選択肢:

  • DESC - 降順(新しい順 / Z→A)
  • ASC - 昇順(古い順 / A→Z)

ページネーションパラメータ

パラメータ 説明 デフォルト値
pagination ページネーションを有効化 false
pagination_type ページネーションタイプ numbers
pagination_position ページネーションの表示位置 both

pagination_typeの選択肢:

  • numbers - 数字(1 2 3 4 5)
  • arrows - 矢印(前へ / 次へ)

pagination_positionの選択肢:

  • top - 上部のみ
  • bottom - 下部のみ
  • both - 上下両方

カルーセル専用パラメータ

パラメータ 説明 デフォルト値
autoplay 自動再生 false
loop 無限ループ true
interval 自動再生の間隔(ミリ秒) 3000

レスポンシブパラメータ

パラメータ 説明 デフォルト値
mobile_breakpoint モバイル表示に切り替える幅(px) 768
tablet_breakpoint タブレット表示に切り替える幅(px) 1024

管理画面でグローバル設定も可能です。


使用例

基本的なグリッド表示

[ksc_posts post_type="post" category="news" cols="3" rows="2"]

サムネイルを左に配置

[ksc_posts post_type="post" thumbnail_position="left" thumbnail_size="medium"]

詳細情報付きの表示

[ksc_posts post_type="post" show_author="true" show_category="true" show_tags="true" show_read_more="true"]

ページネーション付きリスト

[ksc_posts post_type="post" design="list" rows="10" pagination="true" pagination_type="numbers"]

自動再生カルーセル

[ksc_posts post_type="post" design="carousel" cols="3" autoplay="true" loop="true" interval="4000"]

カスタム投稿タイプの表示

[ksc_posts post_type="product" category="electronics" design="grid" cols="4"]

タイトル順で並び替え

[ksc_posts post_type="post" orderby="title" order="ASC"]

ランダム表示

[ksc_posts post_type="post" orderby="rand" cols="3"]

カテゴリの指定方法

投稿タイプによってカテゴリの指定方法が異なります:

投稿(post)の場合

カテゴリスラッグを指定します。

[ksc_posts post_type="post" category="news"]

固定ページ(page)の場合

親ページのIDを page-ID 形式で指定します。

[ksc_posts post_type="page" category="page-123"]

カスタム投稿タイプの場合

タクソノミー(分類)のスラッグを指定します。

[ksc_posts post_type="product" category="electronics"]

レスポンシブ対応

自動レスポンシブ

デフォルトで以下の動作をします:

  • モバイル(768px以下): 1列表示
  • タブレット(769px〜1024px): 列数を段階的に削減
    • 6列 → 3列
    • 5列 → 3列
    • 4列 → 3列
    • 3列 → 2列
  • デスクトップ(1025px以上): 指定した列数で表示

ブレイクポイントのカスタマイズ

管理画面の「レスポンシブ設定」でグローバル設定を変更できます。

個別のショートコードで上書きも可能:

[ksc_posts post_type="post" mobile_breakpoint="600" tablet_breakpoint="900"]

PHPテンプレートでの使用

テーマのテンプレートファイル(archive.php、category.php など)で直接使用できます:

<?php echo do_shortcode('[ksc_posts post_type="post" cols="3" rows="3"]'); ?>

ウィザードでは「PHPコード」タブでテンプレート用のコードも生成されます。


技術仕様

システム要件

  • WordPress 5.0以上
  • PHP 7.2以上
  • jQuery(WordPressに含まれる)

対応ブラウザ

  • Chrome(最新版)
  • Firefox(最新版)
  • Safari(最新版)
  • Edge(最新版)

ファイル構成

kashiwazaki-shortcode-collector/
├── kashiwazaki-shortcode-collector.php  # メインプラグインファイル
├── includes/
│   ├── class-admin.php      # 管理画面
│   ├── class-wizard.php     # ウィザード機能
│   ├── class-shortcode.php  # ショートコード処理
│   └── class-display.php    # 表示レンダリング
├── assets/
│   ├── css/
│   │   ├── ksc-styles.css   # フロントエンドスタイル
│   │   ├── ksc-admin.css    # 管理画面スタイル
│   │   └── ksc-wizard.css   # ウィザードスタイル
│   └── js/
│       ├── ksc-carousel.js  # カルーセル機能
│       ├── ksc-pagination.js # ページネーション機能
│       ├── ksc-admin.js     # 管理画面スクリプト
│       └── ksc-wizard.js    # ウィザードスクリプト
└── languages/               # 翻訳ファイル

更新履歴

Version 1.0.3 - 2025-12-29

  • Changed: サムネイルサイズの選択肢をWordPress標準の名称に変更(フルサイズ、大サイズ、中サイズ、サムネイル)
  • Changed: サムネイルサイズのデフォルトを「フルサイズ」に変更

Version 1.0.2 - 2025-12-15

  • Fixed: ページネーション切替時に更新日が表示されなくなる問題を修正

Version 1.0.1 - 2025-12-14

  • Added: 更新日表示機能を追加(show_modifiedパラメータ)
  • Fixed: ウィザードで生成されるPHPコードのカルーセル表示で最後の1つが空白になる問題を修正

Version 1.0.0 - 2025-09-14

  • 初回リリース
  • グリッド、リスト、カルーセルの3つのデザインパターンを実装
  • ビジュアルウィザード機能を追加
  • レスポンシブデザイン対応
  • ページネーション機能を追加

ライセンス

GPL-2.0-or-later

開発者

開発者: 柏崎剛 (Tsuyoshi Kashiwazaki)
ウェブサイト: https://www.tsuyoshikashiwazaki.jp/


Keywords: WordPress, Plugin, Shortcode, Post Display, Grid Layout, Carousel, List View, Custom Post Type, Pagination