2026年8月31日

WooCommerceのインストールと初期設定方法

WooCommerce

はじめに

WordPressでネットショップを開きたいがWooCommerceの設定方法がわからない・セットアップウィザードを使ったが設定が不完全でショップが正しく機能しない・決済方法やメール通知の設定場所がわからないといった問題の解決方法を解説します。

症状・原因

WooCommerceのパーマリンクが正しく設定されておらず商品ページが404エラーになる
支払い設定が未完了のため購入処理ができない
送料設定がされていないためチェックアウトで「配送方法が見つかりません」と表示される
WooCommerceのDBテーブルが正しく作成されていない（インストールエラー）

解決手順

ステップ1：WooCommerce をインストールして有効化する

# ✅ WP-CLI でインストール
wp plugin install woocommerce --activate --path=/var/www/html/

# ✅ WooCommerce のバージョン確認
wp plugin get woocommerce --field=version --path=/var/www/html/
# → 8.x.x

# ✅ WooCommerce DBテーブルが作成されているか確認
wp db query "SHOW TABLES LIKE 'wp_woocommerce%';" --path=/var/www/html/
# → wp_woocommerce_sessions
# → wp_woocommerce_api_keys
# → wp_woocommerce_order_items
# → ...

# ✅ DBテーブルが不足している場合は再インストール
wp plugin deactivate woocommerce --path=/var/www/html/
wp plugin activate woocommerce --path=/var/www/html/
# → プラグイン有効化時にDBテーブルが再作成される

ステップ2：基本設定（一般・商品・支払い）を行う

# ✅ WooCommerce の基本設定をコマンドラインで確認
wp option get woocommerce_store_address --path=/var/www/html/
wp option get woocommerce_currency --path=/var/www/html/
# → JPY ← 日本円

# ✅ 通貨を日本円に設定
wp option update woocommerce_currency "JPY" --path=/var/www/html/
wp option update woocommerce_currency_pos "left" --path=/var/www/html/
wp option update woocommerce_price_decimal_sep "." --path=/var/www/html/
wp option update woocommerce_price_num_decimals "0" --path=/var/www/html/
# → 日本円は小数点なし（0円）

# ✅ 店舗の住所設定（消費税計算に必要）
wp option update woocommerce_store_address "東京都渋谷区1-1-1" --path=/var/www/html/
wp option update woocommerce_default_country "JP" --path=/var/www/html/

# ✅ パーマリンクを再生成（WooCommerceページが404になる場合）
wp rewrite flush --hard --path=/var/www/html/

ステップ3：配送方法と税金を設定する

# ✅ 配送ゾーンを作成（日本国内向け）
wp wc shipping_zone create \
    --name="Japan" \
    --order=1 \
    --user=1 \
    --path=/var/www/html/

# ✅ 配送ゾーンに地域を追加
ZONE_ID=$(wp wc shipping_zone list --format=ids --user=1 --path=/var/www/html/ | head -1)
wp wc shipping_zone_location create $ZONE_ID \
    --code="JP" \
    --type="country" \
    --user=1 \
    --path=/var/www/html/

# ✅ 送料無料の配送方法を追加
wp wc shipping_zone_method create $ZONE_ID \
    --method_id="free_shipping" \
    --user=1 \
    --path=/var/www/html/

# ✅ 消費税設定
wp option update woocommerce_calc_taxes "yes" --path=/var/www/html/
wp option update woocommerce_tax_based_on "base" --path=/var/www/html/
wp option update woocommerce_prices_include_tax "yes" --path=/var/www/html/
# → 価格を税込み表示

ステップ4：支払い方法を設定する

# ✅ 利用可能な支払い方法を確認
wp wc payment_gateway list --user=1 --path=/var/www/html/
# → cod: Cash on delivery (有効/無効)
# → bacs: Direct bank transfer
# → cheque: Check payments

# ✅ 代金引換（COD）を有効化
wp option update woocommerce_cod_settings \
    '{"enabled":"yes","title":"代金引換","description":"商品お届け時にお支払いください"}' \
    --format=json --path=/var/www/html/

# ✅ Stripe プラグインで クレジットカード決済を追加
wp plugin install woocommerce-gateway-stripe --activate --path=/var/www/html/

# ✅ ペイパル決済を設定
wp option update woocommerce_paypal_settings \
    '{"enabled":"yes","email":"your-paypal@email.com"}' \
    --format=json --path=/var/www/html/

ステップ5：テスト購入と通知メールを確認する

# ✅ WooCommerce のメールテンプレートを確認
wp wc --help --path=/var/www/html/ 2>/dev/null
ls /var/www/html/wp-content/plugins/woocommerce/templates/emails/
# → customer-completed-order.php
# → customer-new-account.php
# → admin-new-order.php

# ✅ テストメールを送信
wp eval "
WC()->mailer()->get_emails()['WC_Email_New_Order']->trigger(1);
echo 'Test email sent';
" --path=/var/www/html/

# ✅ WooCommerce のヘルスチェック
wp eval "
\$tools = new WC_REST_System_Status_Tools_Controller();
echo print_r(WC()->call_function('wc_print_r', WC()->get_core_statuses()), true);
" --path=/var/www/html/ 2>/dev/null

# ✅ WooCommerce のステータスをチェック
wp option get woocommerce_queue_flush_rewrite_rules --path=/var/www/html/
wp rewrite flush --hard --path=/var/www/html/

注意事項

WooCommerceをインストール後は必ずパーマリンクを「設定 > パーマリンク」から再保存（またはwp rewrite flush --hard）してください。これを行わないとショップページや商品ページが404エラーになります
日本円（JPY）を使用する場合はwoocommerce_price_num_decimalsを0に設定してください。デフォルトは2（例：1,000.00円）で見栄えが悪くなります

まとめ

WooCommerceのセットアップは①wp plugin install woocommerce --activateでインストール・DBテーブル作成確認・404時はwp rewrite flush --hard、②通貨をJPYに設定・小数点を0に・店舗住所（消費税計算用）を設定、③配送ゾーン（日本）を作成・配送方法追加・消費税を有効化して税込み価格表示、④代金引換/クレジットカード/ペイパルなど支払い方法を設定、⑤テストメール送信・WooCommerceヘルスチェック・メールテンプレートのカスタマイズの手順で進めます。

Post Views: 11