My Snow Monkey +

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

My Snow Monkey プラグインディレクトリへの URL

// 使用例
wp_enqueue_style( 'custom-style', MY_SNOW_MONKEY_URL . '/assets/css/style.css' );

MY_SNOW_MONKEY_PATH

My Snow Monkey プラグインディレクトリへの ファイルパス

// 使用例
require_once MY_SNOW_MONKEY_PATH . '/includes/helper-functions.php';

📂 機能ごとにファイルを分割管理

functions ディレクトリ

/functions ディレクトリの中にある PHP ファイルは、自動的に読み込まれます。 その際、ファイル名がハイフンで始まるもの（例：-example.php）は、読み込まれません。

✅ 配置するコード:

• テーマに依存しない汎用的なカスタマイズ
• WordPress 標準機能の拡張
• プラグイン同士の連携機能

snow-monkey ディレクトリ

/snow-monkey ディレクトリの中にある PHP ファイルは、Snow Monkey テーマが有効な場合のみ自動的に読み込まれます。 その際、ファイル名がハイフンで始まるもの（例：-example.php）は、読み込まれません。

✅ 配置するコード:

• Snow Monkey テーマ専用のカスタマイズ
• Snow Monkey のフックやフィルターを使用する機能
• テーマ固有のブロックスタイルやカラーパレット

📄 含まれるファイル:

includes ディレクトリ

プラグインの中核となるクラスファイルを配置します。

含まれるファイル:

• class-my-snow-monkey-plus.php: メインクラス

🎨 SCSS 開発

構造

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 でラップしてブロックスタイルを出力

🔄 自動読み込み機能

プラグインは以下の順序でファイルを読み込みます：

1. メインクラスの初期化 (My_Snow_Monkey_Plus::get_instance())
2. functions ディレクトリのファイル読み込み (テーマ非依存)
3. Snow Monkey テーマチェック
4. snow-monkey ディレクトリのファイル読み込み (テーマ依存)

🛡️ テーマサポート

Snow Monkey テーマ以外が有効になっている場合：

• 管理画面に警告メッセージを表示
• snow-monkey ディレクトリのファイル読み込みをスキップ
• functions ディレクトリのファイルは引き続き動作

📝 開発のベストプラクティス

ファイル命名規則

• 有効なファイル: feature-name.php
• 無効なファイル: -disabled-feature.php (ハイフン開始)

コード配置の判断

📋 Version History

Version 1.0.3

• ディレクトリ構造の変更: src/ を assets/ にリネーム
• snow-monkey 機能追加:
  • ブロックインサーターで Snow Monkey Blocks を最上部に表示
  • Polylang 言語スイッチ機能を追加（contactページでは非表示）
  • 特定ページでグローバルナビを別メニューに切り替え
  • フッター前にRBUIパターンを表示する機能
  • カラーパレット更新、デフォルトパレットを非表示に設定
• コード品質向上: 改行コードをLFに統一、サンプルコードを削除
• ドキュメント強化: README更新、各ファイルの詳細説明を追加

Version 1.0.2

• Snow Monkey テーマ判定の改善: より確実で効率的な判定ロジックに変更
• 判定ロジックの最適化: 不要な処理を削除してパフォーマンス向上
• WordPress 6.7.0+ 対応: initフックでのファイル読み込みに変更し翻訳問題を解決
• フック実行順序の最適化: プラグインファイル読み込みを翻訳読み込みより優先に変更
• バージョン管理の統一: フォールバックバージョンを1.0.2に更新
• ドキュメント拡充: 技術的特徴セクションの追加でプラグインの内部仕様を明確化

Version 1.0.1

• モダンなコード構造への リファクタリング
• クラスベースの設計でメンテナンス性向上
• SCSS のエディター/フロント分離対応
• 自動読み込み機能の効率化 (glob() 使用)
• オートローダー除外規則の変更 (ハイフン1つ開始)