Yeoman/Yeoman WordPress Generator

はじめに

Yeoman WordPress Generator(generator-yo-wordpress)は、WordPressのテーマやプラグインを効率的に生成するためのYeomanジェネレーターです。開発者は、このツールを利用して、手動で設定する手間を省き、標準化された構成を短時間で構築できます。本ハンドブックでは、generator-yo-wordpressのインストールから利用方法、カスタマイズ、トラブルシューティングまでを解説します。

インストールと準備

必要な環境

以下のソフトウェアが必要です。

• Node.js
• npm（Node.jsに付属）

インストール後、以下のコマンドでバージョンを確認してください：

node -v
npm -v

generator-yo-wordpressのインストール

以下のコマンドを実行してインストールします：

npm install -g generator-yo-wordpress

初期セットアップ

初回利用時に、~/.yeoman-wordpress/config.jsonに設定ファイルが生成されます。このファイルには、プロジェクト生成時のデフォルト設定が保存されます。

WordPressプロジェクトの生成

基本コマンド

以下のコマンドで新しいWordPressプロジェクトを生成します：

yo yo-wordpress

プロジェクト生成の手順

1. プロンプトに従い、以下の情報を入力します：
   • 使用するWordPressのバージョン（デフォルトで最新の安定版）
   • テーマ名
   • 開発者情報
2. 生成されるディレクトリ構造：
   • wp-content/themes/your-theme-name/
   • テーマファイル（例：style.css, functions.php）
3. WordPressをインストールし、管理画面でテーマを有効化します。

プラグインの生成

基本コマンド

以下のコマンドでプラグインを生成します：

yo yo-wordpress:plugin

プラグイン生成の手順

1. プロンプトに従い、以下の情報を入力します：
   • プラグイン名
   • バージョン番号
   • 説明
2. 生成されるディレクトリ構造：
   • your-plugin-name/
     • your-plugin-name.php
     • includes/
     • admin/
     • public/

1. 生成されたファイルをカスタマイズして利用します。

設定ファイルの活用

設定ファイルの概要

~/.yeoman-wordpress/config.jsonには、プロジェクト生成時のデフォルト設定が保存されます。

設定ファイルのカスタマイズ方法

• 手動で編集可能。
• 設定をリセットするには、ファイルを削除して再生成します。

カスタマイズと応用例

スターターテーマの調整

• functions.phpにカスタムメニューやウィジェットを追加。
• テンプレートファイル（例：single.php, archive.php）を編集。

プラグインの拡張

• 独自フックの実装。
• ショートコードを追加。

トラブルシューティング

よくある問題と解決策

• npmエラー：管理者権限で再実行。
• プロジェクトが生成されない：依存関係を再インストール。

問題報告の手順

以下の情報を提供してください：

• Node.js, npm, Yeomanのバージョン（例：node -v, npm -v, yo -v）
• 使用OS

参考資料

• GitHub: generator-yo-wordpress
• WordPress Codex
• WordPress Plugin Handbook