Snow Monkey 用カスタマイズコードを管理するプラグインです。 My Snow Monkey と同じように使用できます。 機能ごとにファイルを分割管理するのに便利なようになっています。
- 自動ファイル読み込み: 各ディレクトリのPHPファイルを自動で読み込み
- テーマ依存管理: Snow Monkey テーマ専用機能とテーマ非依存機能を分離
- モダンなコード構造: クラスベースの設計で保守性向上
- SCSS サポート: フロント用とエディター用のスタイルを効率的に管理
- Singletonパターン: クラスベースの設計で適切なインスタンス管理を実装
- 多言語対応:
load_textdomain()メソッドによる翻訳機能をサポート - テーマ判定機能: Snow Monkey テーマの有効化状態を確実に検出
- 効率的ファイル読み込み:
auto_load()メソッドによる自動ファイル読み込み - 管理画面通知: 非対応テーマ使用時の適切な警告表示
my-snow-monkey-plus/
├── my-snow-monkey-plus.php # メインプラグインファイル
├── includes/ # プラグイン本体のクラスファイル
│ └── class-my-snow-monkey-plus.php
├── functions/ # テーマ非依存のカスタマイズ
├── snow-monkey/ # Snow Monkey テーマ専用のカスタマイズ
│ ├── add-color-palette.php # カラーパレット追加
│ ├── block-styles.php # ブロックスタイル登録
│ ├── enqueue-scripts.php # スクリプト・スタイル読み込み
│ ├── global-nav.php # グローバルナビカスタマイズ
│ ├── lang-switch.php # 言語切り替え機能
│ ├── sm-prepend-footer.php # フッター前コンテンツ
│ └── smb-block-category-order.php # ブロックカテゴリー順序
├── assets/ # リソースファイル
│ ├── css/ # コンパイル済みCSS
│ ├── scss/ # SCSSソースファイル
│ ├── js/ # JavaScript
│ └── images/ # 画像ファイル
└── README.md
下記の定数が利用可能です。
My Snow Monkey プラグインディレクトリへの URL
// 使用例
wp_enqueue_style( 'custom-style', MY_SNOW_MONKEY_URL . '/assets/css/style.css' );My Snow Monkey プラグインディレクトリへの ファイルパス
// 使用例
require_once MY_SNOW_MONKEY_PATH . '/includes/helper-functions.php';/functions ディレクトリの中にある PHP ファイルは、自動的に読み込まれます。
その際、ファイル名がハイフンで始まるもの（例：-example.php）は、読み込まれません。
✅ 配置するコード:
- テーマに依存しない汎用的なカスタマイズ
- WordPress 標準機能の拡張
- プラグイン同士の連携機能
/snow-monkey ディレクトリの中にある PHP ファイルは、Snow Monkey テーマが有効な場合のみ自動的に読み込まれます。
その際、ファイル名がハイフンで始まるもの（例：-example.php）は、読み込まれません。
✅ 配置するコード:
- Snow Monkey テーマ専用のカスタマイズ
- Snow Monkey のフックやフィルターを使用する機能
- テーマ固有のブロックスタイルやカラーパレット
📄 含まれるファイル:
| ファイル | 説明 |
|---|---|
add-color-palette.php |
theme.json にカスタムカラーを追加し、デフォルトカラーを非表示に設定 |
block-styles.php |
見出し・段落などのカスタムブロックスタイルを登録 |
enqueue-scripts.php |
フロント・エディター用のCSS/JSを読み込み |
global-nav.php |
特定ページでグローバルナビを別メニューに切り替え |
lang-switch.php |
Polylang の言語スイッチを Snow Monkey に表示 |
sm-prepend-footer.php |
フッター前にコンテンツを挿入 |
smb-block-category-order.php |
ブロックインサーターで Snow Monkey Blocks を最上部に表示 |
プラグインの中核となるクラスファイルを配置します。
含まれるファイル:
class-my-snow-monkey-plus.php: メインクラス
assets/scss/
├── _variables.scss # CSS カスタムプロパティ（色定義など）
├── _common.scss # 共通スタイル
├── _block-style.scss # ブロックスタイル（mixin + 直接出力）
├── _polylang.scss # Polylang 言語スイッチ用スタイル
├── style.scss # フロント用エントリーポイント
└── editor-style.scss # エディター用エントリーポイント
- フロント用 (
style.scss): そのままブロックスタイルを出力 - エディター用 (
editor-style.scss):.editor-styles-wrapperでラップしてブロックスタイルを出力
プラグインは以下の順序でファイルを読み込みます：
- メインクラスの初期化 (
My_Snow_Monkey_Plus::get_instance()) - functions ディレクトリのファイル読み込み (テーマ非依存)
- Snow Monkey テーマチェック
- snow-monkey ディレクトリのファイル読み込み (テーマ依存)
Snow Monkey テーマ以外が有効になっている場合：
- 管理画面に警告メッセージを表示
snow-monkeyディレクトリのファイル読み込みをスキップfunctionsディレクトリのファイルは引き続き動作
- 有効なファイル:
feature-name.php - 無効なファイル:
-disabled-feature.php(ハイフン開始)
| 機能の種類 | 配置先 | 例 |
|---|---|---|
| WordPress標準機能のカスタマイズ | functions/ |
カスタム投稿タイプ、管理画面カスタマイズ |
| Snow Monkey専用機能 | snow-monkey/ |
テーマフック、ブロックスタイル、カラーパレット |
| 共通ユーティリティ | includes/ |
ヘルパークラス、共通関数 |
- ディレクトリ構造の変更:
src/をassets/にリネーム - snow-monkey 機能追加:
- ブロックインサーターで Snow Monkey Blocks を最上部に表示
- Polylang 言語スイッチ機能を追加（contactページでは非表示）
- 特定ページでグローバルナビを別メニューに切り替え
- フッター前にRBUIパターンを表示する機能
- カラーパレット更新、デフォルトパレットを非表示に設定
- コード品質向上: 改行コードをLFに統一、サンプルコードを削除
- ドキュメント強化: README更新、各ファイルの詳細説明を追加
- Snow Monkey テーマ判定の改善: より確実で効率的な判定ロジックに変更
- 判定ロジックの最適化: 不要な処理を削除してパフォーマンス向上
- WordPress 6.7.0+ 対応: initフックでのファイル読み込みに変更し翻訳問題を解決
- フック実行順序の最適化: プラグインファイル読み込みを翻訳読み込みより優先に変更
- バージョン管理の統一: フォールバックバージョンを1.0.2に更新
- ドキュメント拡充: 技術的特徴セクションの追加でプラグインの内部仕様を明確化
- モダンなコード構造への リファクタリング
- クラスベースの設計でメンテナンス性向上
- SCSS のエディター/フロント分離対応
- 自動読み込み機能の効率化 (
glob()使用) - オートローダー除外規則の変更 (ハイフン1つ開始)