KTP Banner

KantanPro 向けに任意のバナー広告を表示する WordPress プラグインです。

プラグイン情報

• プラグイン名: KTP Banner
• バージョン: 1.3.3
• 最終更新日: 2026-05-25
• 対象: WordPress + KantanPro

機能

• 管理画面でバナー画像 URL / リンク URL / 代替テキストを設定
• 画像URLはメディアライブラリから選択可能（アップロード / ギャラリー選択）
• KantanPro 管理画面への表示（通知表示）
• KantanPro ショートコード出力へのバナー差し込みフォールバック
• 各バナーにスマホ用画像を個別設定可能（767px以下で自動切り替え）
• 複数バナーの登録とローテーション表示（2〜60秒間隔）
• ショートコード [ktp_banner] で任意の場所に表示
• ウィジェット（外観 > ウィジェット）からサイドバー等に表示
• Gutenberg ブロック「KTP Banner」で本文の任意位置に挿入
• 任意のフック名を設定して do_action( 'your_hook' ) に差し込み可能
• KantanPro がないサイトでは サイト全体の表示位置（wp_footer / wp_body_open）で自動表示可能

セットアップ

1. WordPress 管理画面で KTP Banner を有効化
2. 管理画面左メニューの KTP Banner を開く
3. 画像 URL などを保存

表示方法

1) KantanProの画面に表示

• display_hook 設定によるフック表示
• フック未登録時は ktpwp_all_tab / kantanAllTab / kantanpro_ex 出力へ自動フォールバック差し込み（KantanProEX では非表示）

2) KantanPro 管理画面に通知として自動表示

• KantanPro管理画面で表示 をオンにすると、page=kantanpro... の画面で通知エリアに表示されます。

3) ショートコード

[ktp_banner]

任意クラスを付ける場合:

[ktp_banner class="my-banner"]

4) 任意フックに表示

設定画面の 追加表示フック名（任意） に、例: kantanpro_after_header を設定。 その後、KantanPro 側で下記が実行されると表示されます。

do_action( 'kantanpro_after_header' );

5) ウィジェット

1. WordPress 管理画面で 外観 > ウィジェット（または 外観 > エディター > ウィジェット）を開く
2. KTP Banner をサイドバー等のウィジェットエリアに追加
3. バナー内容は KTP Banner メニューで管理（ウィジェット側の個別設定は不要）

6) ブロックエディター

1. 投稿・固定ページの編集画面で ブロック追加（+） をクリック
2. KTP Banner ブロックを検索して挿入
3. バナー内容は KTP Banner メニューで管理（ブロック側の個別設定は不要）

更新履歴

1.3.3 (2026-05-25)

• ウィジェット表示でスマホ用画像が切り替わらない不具合を修正
• ウィジェット・フック表示時の CSS 読み込みを改善

1.3.0 (2026-05-25)

• 各バナーにスマホ用画像URL（任意）を追加
• スマホ用画像が設定されている場合、767px以下で自動切り替え

1.2.1 (2026-05-25)

• ブロックエディター用「KTP Banner」ブロックを追加（本文の任意位置に挿入可能）
• 幅広・全幅アライメントに対応

1.1.3 (2026-05-25)

• バナーローテーションが動作しない不具合を修正（HTMLクラス名のサニタイズ問題）
• ローテーション用 CSS/JS の読み込みタイミングを改善
• 遅延読み込みコンテンツ向けに MutationObserver によるローテーター初期化を追加

1.1.2 (2026-05-25)

• WordPress ウィジェット「KTP Banner」を追加（外観 > ウィジェット）
• 複数バナー登録とローテーション表示（2〜60秒・フェード切替）に対応
• 管理画面にバナー一覧リピーター UI を追加（追加・削除・個別有効化）
• 旧形式（単一バナー）設定の自動移行
• ローテーション用フロントエンド CSS/JS を追加
• 設定メニューをトップレベル「KTP Banner」に移動

1.1.0 (2026-05-25)

• 複数バナーの登録に対応
• 2件以上の有効バナーを指定秒数ごとに切り替えるローテーション表示を追加
• 旧形式（単一バナー）の設定データを自動移行

1.0.15 (2026-05-25)

• 外観 > ウィジェット から追加できる「KTP Banner」ウィジェットを追加
• ウィジェットはショートコードと同様、KantanProEX 環境でも明示配置時に表示可能

1.0.14 (2026-05-10)

• KantanProEX が有効な環境でも、明示的に配置した [ktp_banner] は表示できるよう修正
• 自動差し込み・フック表示・管理画面通知は従来どおり KantanProEX では非表示

1.0.12 (2026-05-01)

• GitHub Release を参照する更新通知の仕組みを追加
• WordPress標準のプラグイン更新画面で zipball_url 経由の更新を受け取れるよう対応
• GitHub zipball 展開後のフォルダ名を ktp-banner に補正する処理を追加

1.0.11 (2026-05-01)

• KantanProEX のフォルダ名が KantanProEx の場合も有料版として検出し、EX環境でバナーを表示しないよう修正
• EX本体が公開する識別子も判定に利用し、プラグイン読み込み順による検出漏れを軽減

1.0.10 (2026-04-28)

• KantanProEX 判定を KTPWP_EDITION 依存から切り離し、EX プラグイン実体の有効化状態のみで判定するよう修正
• KantanPro（WordPress版）が pro 扱いでもバナー表示できるように改善

1.0.9 (2026-04-28)

• KantanProEX の有効化状態を判定する機能を追加
• KantanProEX の有効化判定を複数のベースネームで行うように修正

1.0.8 (2026-04-27)

• KantanProEX（KTPWP_EDITION が pro）が有効なときはバナーを一切表示しない（フック・[ktp_banner]・管理画面通知・ショートコード出力への差し込みを無効化）
• 差し込み対象に kantanpro_ex を追加（無料版向け。EX では非表示）

1.0.7 (2026-04-08)

• KantanPro 管理画面のメニュースラッグ判定条件を修正

1.0.6 (2026-04-08)

• KantanPro 側の表示位置変更に追従し、メニュースラッグ判定を ktp- / ktpwp 系にも対応

1.0.5 (2026-04-08)

• KantanPro がない設置先向けに wp_footer / wp_body_open 表示オプションを追加

1.0.4 (2026-03-28)

• README.md のプラグイン情報（バージョン・更新日・更新履歴）を readme.txt と整合

1.0.3 (2026-03-28)

• バナー画像を親幅いっぱい（フルワイド）表示に変更

1.0.2 (2026-03-27)

• KantanPro ショートコード差し込み時の重複表示判定を強化
• ヘッダー上表示・フック表示・フォールバック表示がある場合の再挿入を抑止

1.0.1 (2026-03-27)

• KantanPro 側の表示位置調整に対応し、ヘッダー上表示経路を強化
• フック未登録時のフォールバック表示を追加
• メディアライブラリ選択機能と画像プレビューの安定性を改善
• バナー余白と画像サイズ（50%表示）を調整

1.0.0 (初回リリース)

• KTP Bannerプラグインの初期実装を追加