なぜ専門のWooCommerce製品導入ツールが必要なのでしょうか？
オンラインストアの規模が拡大するにつれて、商品を一つ一つ手動で追加することはますます非現実的になってきています。既存の店舗データの移行、在庫価格の一括更新、またはサプライヤーからの商品リストの取得など、効率的なデータインポート機能は非常に重要です。WooCommerce自体が提供する基本的なインポートツールでは簡単なシナリオには対応できますが、複雑な商品タイプやカスタムフィールド、大量のデータを扱う場合には、開発者はより体系的で強力な方法を習得する必要があります。
正しいツールと方法を使用して製品をインポートすることで、多くの時間を節約できるだけでなく、人的なミスを最小限に抑え、データの一貫性を確保することができます。標準的なシンプルな製品から変動する製品、サブスクリプション制やバンドル販売といった高度な製品タイプに至るまで、しっかりとしたインポートプロセスはeコマース運営の自動化の基盤となります。本稿では、標準的なCSVファイルの準備から、プログラミングによるカスタム製品の処理までの完全なプロセスについて詳しく説明します。
標準的なCSVファイルを準備し、一括でインポートします。
WooCommerceには、CSVファイルを通じて商品をインポートする機能が内蔵されており、これが最も一般的で直接的な一括操作の方法です。その鍵となるのは、WooCommerceが期待する形式に合ったCSVファイルを準備することです。
推薦図書 WooCommerce Eコマースサイトの開発：オンラインストアをゼロから構築する。
理解核心产品数据列
基本的なCSVファイルのインポートには、いくつかの重要な列が含まれていなければなりません。その中で、IDとType列が最も重要です。ID既存の製品とマッチして更新を行うために使用されます。空欄のままにすると、新しい製品が作成されます。Typeそれでは、製品タイプが定義されました。例えば：simple（シンプルな製品）variable（変動する製品）grouped（グループ化された製品など）その他の基本情報列には以下のものが含まれます：SKU（在庫単位）Name（製品名）、Published（公開状態：1は「公開済み」を意味します）Description（説明）Regular price（通常価格）およびStock（在庫数）
変動する製品については、インポートプロセスが2つのステップに分かれています。まず親製品をインポートし、その後、その子変種をインポートします。Typeリストに追加するvariableサブバリアントTypeリストに追加するvariationそして、以下の方法で…Parent列には親製品のSKUを指定し、それに基づいて関連付けを行います。
分類、タグ、画像の処理
カテゴリーやタグのインポートには特定のフォーマットが必要です。製品のカテゴリーについては、以下の方法で処理できます：Categories列では「親カテゴリ > 子カテゴリ」という形式を使用し、複数のカテゴリは英語のセミコロン（;）で区切ります。例：「ファッション > シャツ; 夏季新商品」。タグについては…Tags列内のデータは、英語のコンマ（,）で区切られています。
製品画像のインポートは比較的柔軟です。以下の方法で行うことができます：Images列に画像のURLを指定します。複数のURLは英語のコンマ（,）で区切ります。最初のURLがメイン画像として使用されます。WooCommerceはインポート時にこれらの画像をダウンロードし、メディアライブラリに保存しようとします。もう一つの方法は、画像を事前にFTPを使用してサーバーの特定のディレクトリにアップロードし、CSVファイル内で相対パスを参照する方法です。
標準的でシンプルな製品のCSVファイルの例は以下の通りです：
推薦図書 WooCommerceチュートリアル：ゼロからプロの電子商取引ウェブサイトを構築するための完全なガイド。
ID,Type,SKU,Name,Published,Description,Regular price,Stock,Categories,Images
,simple,T-SHIRT-SM,纯棉简约T恤,1,这是一件舒适的纯棉T恤。,29.99,100,服饰 > 上衣,https://example.com/tshirt.jpgWP CLIを使用して高度なインポート自動化を実現する
開発者や上級ユーザー向けに、WordPressのコマンドラインツールについて説明します。WP-CLIより強力でスクリプト化可能なインポート方法が提供されています。これは、デプロイプロセスに統合したり、非常に大規模なデータセットを処理するのに特に適しています。
「基本的な通過方法」という意味ですね。wp-cliCSVをインポートするコマンドは以下の通りです：
wp import products.csv --authors=skipしかし、より一般的な方法はカスタムスクリプトを使用することです。PHPスクリプトを書いて、それを利用することができます。WP-CLIのwp eval-fileコマンドを実行するための指示です。スクリプトの核心は、これらのコマンドを使用することにあります。wc_get_product_object関数は製品オブジェクトを作成し、その属性を設定します。
以下は、プログラミングによってシンプルな製品を作成するPHPスクリプトの例です：
<?php
// 读取CSV数据
$csvFile = 'products.csv';
if (($handle = fopen($csvFile, 'r')) !== FALSE) {
$header = fgetcsv($handle); // 读取标题行
while (($data = fgetcsv($handle)) !== FALSE) {
$productData = array_combine($header, $data);
// 创建产品对象
$product = new WC_Product_Simple();
$product->set_name($productData['Name']);
$product->set_sku($productData['SKU']);
$product->set_regular_price($productData['Regular price']);
$product->set_description($productData['Description']);
$product->set_stock_quantity($productData['Stock']);
$product->set_status($productData['Published'] == 1 ? 'publish' : 'draft');
// 处理分类
$categoryNames = explode(';', $productData['Categories']);
$categoryIds = [];
foreach ($categoryNames as $catName) {
$term = term_exists(trim($catName), 'product_cat');
if (!$term) {
$term = wp_insert_term(trim($catName), 'product_cat');
}
if (!is_wp_error($term)) {
$categoryIds[] = (int)$term['term_id'];
}
}
$product->set_category_ids($categoryIds);
$product->save();
echo "产品已创建/更新: " . $productData['Name'] . " (ID: " . $product->get_id() . ")n";
}
fclose($handle);
}
?>上記のスクリプトを「script.txt」という名前のファイルに保存してください。import_products.phpその後、コマンドを使用して処理を続けることができます。wp eval-file import_products.php実施。
WP CLIを利用して複雑な関連付けを処理する
WP-CLIその強力な点は、複雑なロジックを処理できることにあります。例えば、変動する製品やその属性をインポートする際には、まずグローバルな属性を作成し、その属性を製品に割り当ててバリエーションを生成することができます。スクリプトを記述することで、各ステップでのエラー処理やログ記録を正確に制御し、完全に自動化されたインポートパイプラインを実現することができます。外部API（ERPやサプライヤーシステムなど）との同期が必要な場合には、それを組み合わせることで…WP-CLIジョブスケジューラ（Cron Job）を使用することが最も理想的な解決策です。
プログラミングによるカスタム製品およびメタデータの処理
標準的なCSVフォーマットの列では要件を満たすことができない場合、例えば関連するカスタムフィールドの導入や、サードパーティのプラグインによって作成された製品タイプ（予約製品など）、または複雑なメタデータが必要な場合には、プログラミングによる処理が必要になります。
カスタムフィールド製品の作成と更新
WooCommerce製品のすべての標準データ（価格、在庫など）およびカスタムデータ（ACFやその他の方法で追加されたデータ）は、最終的にメタデータ（Post Meta）として保存されます。プログラムによるデータのインポートでは、これらのメタデータを正しく使用することが鍵となります。set_シリーズ手法とupdate_post_meta関数。
仮に私たちの手元に「××」という名前のものがあるとします。custom_batch_number以下のコードは、製品を作成する際にカスタムフィールドを設定する方法を示しています：
// 假设 $product 是一个 WC_Product 对象
$product->set_name('高级定制产品');
$product->set_regular_price(99.99);
$product->save(); // 必须先保存产品以获得ID
// 更新自定义字段（产品元数据）
$product_id = $product->get_id();
update_post_meta($product_id, 'custom_batch_number', 'BATCH-2026-001');
update_post_meta($product_id, '_custom_field', 'value'); // 下划线开头表示隐藏的元数据注意が必要なのは、一部のサードパーティプラグインが独自の製品タイプクラスを定義している場合です。このような製品を作成する際には、対応するクラスを使用する必要があります。例えば…new WC_Product_Booking()そして、プラグインが提供する特定のメソッドを呼び出します。
WooCommerceのフックを使用してインポート機能を拡張する
WooCommerceでは、インポート処理中にカスタムロジックを実行するために多数のフック（Hook）が用意されています。その中でも特に重要な2つのアクションフックは以下の通りです：woocommerce_new_productとwoocommerce_update_productそれらは、製品の作成時と更新時にそれぞれトリガーされます。
例えば、製品をインポートした後に、自動的にその製品に内部審査状態を割り当てることができます。
add_action('woocommerce_new_product', 'my_post_import_actions', 10, 2);
add_action('woocommerce_update_product', 'my_post_import_actions', 10, 2);
function my_post_import_actions($product_id, $product) {
// 自动为所有新导入的产品添加“待审核”标记
update_post_meta($product_id, '_internal_review_status', 'pending');
// 或者根据特定条件进行处理
if (strpos($product->get_sku(), 'PREMIUM') !== false) {
wp_set_object_terms($product_id, 'premium', 'product_tag', true);
}
}さらに、フィルターフックもあります。woocommerce_product_import_pre_insert_product_object非常に便利な機能です。これにより、製品データがデータベースに保存される前にその内容を修正することができます。価格の統一フォーマット化、計量単位の変換、データのコンプライアンスチェックなどに役立ちます。
概要
WooCommerceの製品データのインポートは、簡単なものから複雑なものまで、段階的に習得できるスキルです。標準的なCSVファイルを使ったインポート方法をマスターすることが基本であり、これはほとんどの一括更新やデータ移行のシナリオに適用できます。しかし、繰り返し発生するタスクに対応したり、開発ワークフローと連携させたりする必要がある場合には、より高度な知識やスキルが求められます。WP-CLIコマンドラインによる自動化処理はその強力さを実証しています。高度にカスタマイズされたショップでは、カスタムフィールドやサードパーティプラグインのデータ、複雑なビジネスロジックが関わってくるため、プログラミング手法とWooCommerceのフックを組み合わせることで究極の柔軟性と制御力が得られます。成功したインポート戦略では、これらのツールを組み合わせて使用することが多いです。例えば、CSVを使って日常的なバッチ処理を行い、スクリプトを使って複雑でカスタマイズされたニーズに対応します。重要なのは、WooCommerceのデータ構造を深く理解し、操作を行う前に常に既存のデータを完全にバックアップすることです。
FAQ よくある質問
CSVファイル内の特殊文字やエンコーディングの問題をどのように処理するか？
CSVファイルをUTF-8エンコードで保存するようにしてください。これはWooCommerceの公式インポーターが完全にサポートしている唯一のエンコードです。データにコンマ、引用符、改行符などの特殊な文字が含まれている場合は、フィールドの値全体を英字のダブルクォーテーションマークで囲む必要があります。
例えば、説明文中にコンマが含まれている場合は、次のように記述する必要があります：“这是一件优质，舒适的产品”テキストエディタですべてのフィールドの引用符がペアであることを確認することをお勧めします。これは、インポート時のエラーを避けるための重要なステップです。
可変製品をインポートする際に、属性が表示されない、またはバリエーションの作成に失敗した場合はどうすればよいでしょうか？
これは通常、CSVフォーマットの問題、またはインポートの順序に関する問題です。まず、グローバル属性が正しく設定されていることを確認してください。親製品をインポートする際には…Type: variable）の際には、以下の手順が必要です：Attribute 1 nameとAttribute 1 value(s)例えば、同じ列内で属性を定義する場合などです。颜色と红色,蓝色。
次に、バリアントのインポートについてです（Type: variation）の際には、必ず以下の手順に従ってください。Parent列には親製品のSKUを正確に引用してください。Attribute: 颜色このような列では、その変種の具体的な属性値を指定する必要があります（例えば…）。红色最後に、インポートが完了したら、製品の「バリアント」タブに移動し、「バリアントを作成」または「変更を保存」をクリックする必要があります。そうすると、システムが属性に基づいてすべての可能なバリアントの組み合わせを生成します。
プログラミングによって製品画像を正しく設定する方法は以下の通りです。
プログラミングを使って製品の画像を設定する場合、CSVファイル内でURLを指定するよりも少し複雑です。主な手順は、まず画像ファイルをWordPressのメディアライブラリにアップロードし、そのファイルのIDを取得することです。その後、そのIDを製品に割り当てます。
使用できます。media_sideload_imageこの関数はURLから画像をダウンロードし、それを添付ファイルとして作成します。サンプルコードは以下の通りです：
$image_url = 'https://example.com/product.jpg';
$attach_id = media_sideload_image($image_url, $product_id, '产品图片描述', 'id');
if (!is_wp_error($attach_id)) {
// 设置为主图
set_post_thumbnail($product_id, $attach_id);
// 如需加入产品图库
// $gallery_ids = array($attach_id);
// update_post_meta($product_id, '_product_image_gallery', implode(',', $gallery_ids));
}大量の商品を導入する際にウェブサイトがタイムアウトしたり、メモリが不足したりした場合、どのように対処すればよいでしょうか？
これはサーバーの実行時間制限やメモリ制限によるものです。大規模なデータのインポートの場合は、WordPressの管理画面を通じて操作を行うべきではなく、専用のツールや方法を使用する必要があります。WP-CLIコマンドラインツールは、PHPのタイムアウト設定の影響を受けません。
スクリプトのレベルでは、バッチ処理の戦略を採用することができます。例えば、毎回100件のCSVレコードを読み取り処理し、処理が完了したら次に進むといった方法です。sleep(1)少し停止して、それに合わせてください。wp_cache_flush()キャッシュをクリアしてメモリを解放しましょう。また、インポートスクリプトを実行する前に、以下の操作を行うこともできます：wp-config.php一時的にメモリ制限を増やします：define('WP_MEMORY_LIMIT', '512M');数万件から数十万件規模の製品データのインポートについては、直接データベースを操作するか、より専門的なデータマイグレーションツールを利用することをお勧めします。
次はどうする？
拡大読書と実践的知識
以下は、この記事のトピックに関連しており、さらに深く読むのに適している。あなたの現在の問題に最も近い記事から優先順位をつけ、徐々に周辺のトピックに広げていく方が良い場合が多い。
日本語