※[Setting up your development environment]を日本語に訳した内容です。

WooCommerce の拡張機能プラグインの構築は簡単なプロセスですが、いくつかの変更部分と、理解しておく必要があるサポート ソフトウェア ツールがいくつかあります。 このガイドでは、WooCommerce 拡張機能プラグインを構築するために基本的な開発環境をセットアップする手順を説明します。

前提条件

推奨ドキュメント

WooCommerce 拡張機能は、特殊なタイプの WordPress プラグインです。 WordPress プラグイン開発が初めての場合は、WordPress プラグイン開発者ハンドブックのいくつかの記事を参照してください。

必要なソフトウェア

Git nvm NodeJS PNpm Composer

注: Windows マシンで作業している場合は、続行する前に、このガイドの「Windows 環境での拡張機能の構築」セクションを参照してください。

再利用可能な WordPress 開発環境をセットアップする

上記のソフトウェアに加えて、ローカル開発サーバー スタックをセットアップする何らかの方法も必要になります。 これにはさまざまなツールが利用可能ですが、それぞれに特定の機能と制限があります。 ご希望のワークフローに最も適した以下のオプションを選択することをお勧めします。

WordPress 固有のツール

vvv – VirtualBox と Vagrant を利用した、高度に構成可能な、クロスプラットフォームで堅牢な環境管理ツールです。 これは、WooCommerce Core チームが貢献者に推奨するツールの 1 つです。

wp-env – WordPress コミュニティによって保守されているコマンドラインユーティリティ。これを使用すると、Docker および JSON マニフェストを使用してカスタム WordPress 環境をセットアップして実行できます。

LocalWP – ワンクリックで WordPress をインストールできるクロスプラットフォームアプリです。

一般的な PHP ベースの Web スタック ツール

MAMP – Mac または Windows にインストールできるローカル サーバー環境。

WAMP – Apache2、PHP、および MySQL を使用してアプリケーションを作成できる Windows Web 開発環境。

XAMPP – MariaDB、PHP、および Perl を含む、インストールが簡単な Apache ディストリビューション。 Windows、Linux、OS X で利用できます。

サーバーの最小要件

開発環境を管理するために選択したツールに関係なく、そのツールが WooCommerce のサーバー推奨事項と WordPress を実行するための要件を満たしていることを確認する必要があります。

WordPress 開発環境の構造 (public_html/)

開発環境はさまざまですが、WordPress 環境の基本的なファイル構造は一貫している必要があります。

WooCommerce 拡張機能を開発するときは、通常、作業のほとんどをローカル サーバーの public_html ディレクトリ内で行うことになります。 ここでは、時間をかけていくつかの重要なパスを理解してください。

wp-content/debug.log – これは、WordPress がエラーやデバッグに役立つその他のメッセージなどの重要な出力を書き込むファイルです。

wp-content/plugins/ – これは、WordPress プラグイン フォルダーが存在するサーバー上のディレクトリです。

wp-content/themes/ – これは、WordPress テーマフォルダーが存在するサーバー上のディレクトリです。

WooCommerce Core を環境に追加する

WooCommerce の拡張機能を開発する場合、WooCommerce コアの開発バージョンをインストールすると便利です。

WC コアリポジトリのクローンを wp-content/plugins/ に作成します。

cd /your/server/wp-content/plugins
git clone https://github.com/woocommerce/woocommerce.git
cd woocommerce

必要なノードのバージョンを有効化する

nvm use

Found '/path/to/woocommerce/.nvmrc' with version <v16>
Now using node v16.20.2 (npm v8.19.4)

注: 必要なバージョンの Node がインストールされていない場合は、NVM が警告を発してインストールできるようにします。