woocommerce-backend-dev

WooCommerce バックエンド開発

このスキルでは、プロジェクトの標準と規約に従って WooCommerce のバックエンド PHP コードを開発するためのガイダンスを提供します。

このスキルを使用するタイミング

次の作業を行う前に、必ずこのスキルを実行してください。

• 新しい PHP 単体テスト（*Test.php ファイル）の作成
• 新しい PHP クラスの作成
• 既存のバックエンド PHP コードの変更
• フックやフィルターの追加

手順

バックエンド PHP コードを追加または変更する際は、WooCommerce プロジェクトの規約に従ってください。

1. 新しいコード構造の作成：クラスの作成とファイルの整理に関する規約については、file-entities.md を参照してください（ただし、新しい単体テストファイルについては unit-tests.md を参照してください）。
2. 命名規約：メソッド、変数、パラメーターの命名については、code-entities.md を参照してください。
3. コーディングスタイル：一般的なコーディング標準とベストプラクティスについては、coding-conventions.md を参照してください。
4. 型アノテーション：PHPStan 対応の PHPDoc アノテーションについては、type-annotations.md を参照してください。
5. フックの使用：フックのコールバック規約とドキュメントについては、hooks.md を参照してください。
6. 依存性注入：DI コンテナーの使用については、dependency-injection.md を参照してください。
7. データ整合性：CRUD 操作を行う際にデータ整合性を確保する方法については、data-integrity.md を参照してください。
8. テストの作成：単体テストの規約については、unit-tests.md を参照してください。

主要な原則

• WordPress コーディング標準に必ず従ってください。
• 単独の関数ではなく、クラスメソッドを使用してください。
• 新しい内部クラスは、デフォルトで src/Internal/ に配置してください。
• Automattic\WooCommerce 名前空間で PSR-4 オートローディングを使用してください。
• 新しい機能には、包括的な単体テストを作成してください。
• 変更をコミットする前に、リンティングとテストを実行してください。

バージョン情報

@since アノテーションに使用する次の WooCommerce バージョン番号を確認するには、次の手順に従ってください。

• trunk ブランチ上の includes/class-woocommerce.php にある $version プロパティを読み取ります。
• -dev 接尾辞が付いている場合は削除します。
• 例：trunk に 10.4.0-dev と表示されている場合は、@since 10.4.0 を使用します。
• 注：trunk に対する PR をレビューする場合、リリース済みのバージョンと比べて「将来」のように見えても、trunk のバージョンが正しいバージョンです。