/** Geminiが自動生成した概要 **/
SOY CMS/ShopのSOY2HTMLに、軽微なカスタマイズを容易にする隠し機能が追加されました。クラスファイルと同名のHTMLファイル名の頭にアンダースコア「_」を付けると、そのHTMLファイルが優先的に読み込まれます。これにより、プラグインのバージョンアップ時の上書きを回避できます。例えば、配送モジュールの文言変更など、PHP知識を必要とせず容易にカスタマイズできます。標準配送モジュールなら `delivery_normal/cart/_DeliveryNormalCartPage.html` を配置し、元のHTMLの内容をコピー・編集することで実現できます。SOY Shop 2系以降で利用可能、1系は `soy2_build.php` の修正が必要です。新パッケージはsaitodev.coからダウンロードできます。
/** Geminiが自動生成した概要 **/
HTMLFormクラスは、HTMLのフォーム要素を生成するためのコンポーネントです。formタグを生成し、メソッド(デフォルトはPOST)やアクション、ターゲットなどの属性を設定できます。POSTメソッドの場合、CSRF対策としてsoy2_tokenという隠しフィールドを自動的に追加します。アクションが指定されていない場合は、現在のリクエストURIがアクションとして設定されます。また、JavaScriptのonSubmitイベントを設定することも可能です。disabled属性の設定も可能です。
/** Geminiが自動生成した概要 **/
SOY Shopプラグインの拡張ポイントsoyshop.config.phpは、プラグイン毎に詳細設定画面を作成するための機能です。プラグインディレクトリにsoyshop.config.phpを設置し、インターフェース`SOYShopConfigPageBase`を実装することで、`http://ドメイン/CMSインストールディレクトリ/soyshop/index.php/Config/Detail?plugin=プラグインID` でアクセス可能な設定ページが生成されます。
主要なメソッドは`getConfigPage()`（設定画面のHTMLを出力）、`getConfigPageTitle()`（設定画面のタイトル）、`redirect()`（リダイレクト）です。`getConfigPage()`では、SOY2HTMLを用いてHTMLを生成するのが一般的です。PAY.JPクレジットカード支払いモジュールでは、`PayJpConfigPage`クラスとテンプレートファイルを使用して設定画面を構築しています。`redirect()`メソッドは、設定更新後などにURLパラメータを追加してリダイレクトする際に使用します。
/** Geminiが自動生成した概要 **/
SOY Shopの「soyshop.info.php」は、プラグインごとの詳細画面へのリンクを拡張するための重要なファイルです。これを導入することで、管理画面の「拡張設定」および各プラグインの詳細ページに、プラグイン固有の設定画面へのリンクを表示させることができます。
実装には「SOYShopInfoPageBase」インターフェースを継承し、getPageメソッドでアクティブ時のみリンクを生成します。特に、URL生成には「SOY2PageController::createLink()」を使用し、「Config.Detail?plugin=プラグインID」形式で環境に依存しない適切なパスを組み立てるのがポイントです。これにより、ユーザーはスムーズにプラグイン設定へアクセスできるようになります。
/** Geminiが自動生成した概要 **/
SOY Shopプラグインの解説として、銀行振込モジュールを例に拡張ポイントが説明されている。プラグインはfeaturesディレクトリにmodule.iniで情報を定義し、pluginsディレクトリに機能を実装する。soyshop.config.php（設定画面）、soyshop.info.php（詳細ページへのリンク追加）、soyshop.order.mail.php（メールへの文章挿入）、soyshop.payment.php（支払い機能）といった拡張ポイントがあり、これらは/soyshop/webapp/src/logic/plugin/extensions/以下にインターフェース定義がある。
/** Geminiが自動生成した概要 **/
SOY Shopのプラグイン複製は、対象ディレクトリ（例：payment_furikomi）を丸ごと複製し、名前を（例：payment_furikomi2）に変更する。ファイル名、クラス名、モジュールID（payment_furikomi→payment_furikomi2、PaymentFurikomi→PaymentFurikomi2など）を全て変更する。module.iniのモジュールIDも修正。拡張ポイントファイル(soyshop.***.php)やUtilクラスなども同様に置換。HTMLファイルは修正不要。PHPの知識があれば複製後、自由に修正可能。