Yeoman/Yeoman WordPress Generator
< Yeoman
はじめに
[編集]Yeoman WordPress Generator(generator-yo-wordpress)は、WordPressのテーマやプラグインを効率的に生成するためのYeomanジェネレーターです。開発者は、このツールを利用して、手動で設定する手間を省き、標準化された構成を短時間で構築できます。本ハンドブックでは、generator-yo-wordpressのインストールから利用方法、カスタマイズ、トラブルシューティングまでを解説します。
インストールと準備
[編集]必要な環境
[編集]以下のソフトウェアが必要です。
インストール後、以下のコマンドでバージョンを確認してください：
node -v npm -v
generator-yo-wordpressのインストール
[編集]以下のコマンドを実行してインストールします：
npm install -g generator-yo-wordpress
初期セットアップ
[編集]初回利用時に、~/.yeoman-wordpress/config.jsonに設定ファイルが生成されます。このファイルには、プロジェクト生成時のデフォルト設定が保存されます。
WordPressプロジェクトの生成
[編集]基本コマンド
[編集]以下のコマンドで新しいWordPressプロジェクトを生成します：
yo yo-wordpress
プロジェクト生成の手順
[編集]- プロンプトに従い、以下の情報を入力します：
- 使用するWordPressのバージョン（デフォルトで最新の安定版）
- テーマ名
- 開発者情報
- 生成されるディレクトリ構造：
wp-content/themes/your-theme-name/- テーマファイル（例：
style.css,functions.php）
- WordPressをインストールし、管理画面でテーマを有効化します。
プラグインの生成
[編集]基本コマンド
[編集]以下のコマンドでプラグインを生成します：
yo yo-wordpress:plugin
プラグイン生成の手順
[編集]- プロンプトに従い、以下の情報を入力します：
- プラグイン名
- バージョン番号
- 説明
- 生成されるディレクトリ構造：
your-plugin-name/your-plugin-name.phpincludes/admin/public/
- 生成されたファイルをカスタマイズして利用します。
設定ファイルの活用
[編集]設定ファイルの概要
[編集]~/.yeoman-wordpress/config.jsonには、プロジェクト生成時のデフォルト設定が保存されます。
設定ファイルのカスタマイズ方法
[編集]- 手動で編集可能。
- 設定をリセットするには、ファイルを削除して再生成します。
カスタマイズと応用例
[編集]スターターテーマの調整
[編集]functions.phpにカスタムメニューやウィジェットを追加。- テンプレートファイル（例：
single.php,archive.php）を編集。
プラグインの拡張
[編集]- 独自フックの実装。
- ショートコードを追加。
トラブルシューティング
[編集]よくある問題と解決策
[編集]- npmエラー：管理者権限で再実行。
- プロジェクトが生成されない：依存関係を再インストール。
問題報告の手順
[編集]以下の情報を提供してください：
- Node.js, npm, Yeomanのバージョン（例：
node -v,npm -v,yo -v） - 使用OS