[WordPress] Really Simple CSV Importerでハマったエラーまとめ

• 数百、数千件のカスタムフィールド付き投稿データを入力するときに便利なプラグイン「Really Simple CSV Importer」
• とても便利ですが、正しくCSVファイルを作らないとインポートできませんし、インポートできてもデータがずれてしまったりします
• 本記事で自分がつまずいたあれこれをまとめておきたいと思います

正しくインポートできる最小構成のサンプル

• インポート時に少なくとも必要（と思われる）3つの要素だけをまとめたデータです
• まずは最小構成でインポートができるかチェックしてから、必要な要素を付け足していくと問題発生時の原因が特定しやすくなります
• 「post_type」は投稿タイプの指定です。普通の投稿の場合は「post」、固定ページの場合は「page」、カスタム投稿タイプの場合はそのスラッグ名を指定します
• 「post_status」は公開状態の指定です。無指定の場合はdraft（下書き）として扱われてしまうため、「publish」と指定しておきます
• 「post_title」は記事のタイトルとなります

「データベースに投稿を追加できませんでした　WP_Postオブジェクトがセットされていません。」と表示される

• CSVファイルの文字コードが間違っている場合のエラーです
• 「Really Simple CSV Importer」は「UTF-8」の文字コードで作成されたCSVファイルでなければインポートできません（ただし、データに全角文字がない場合はインポートできてしまいます）
• ExcelでCSVファイルを作成すると、気づかず文字コードが「SJIS」になってしまうことがあるため注意が必要です
• LibreOfficeというソフトでCSVファイルを作成することが推奨されていますが、私の場合は①テキストエディタでUTF-8形式に保存したCSVファイルを作成→②Excelで作成した表データをペースト→③タブを「,」に置換という流れで作成しました

「"publish" は不正な投稿タイプです。」と表示される

• CSVに記載するデータの順番が間違っている場合のエラーです
• 上記のサンプルは「post_title」「post_type」「post_status」という順番になっていますがこれはNG
• 「post_type」「post_status」「post_title」という順番で記載しましょう

post_typeを指定しているのに「注: 可能な場合 post_type 値を記載してください。」という警告が出て、指定したpost_typeではなく「投稿」にインポートされてしまう

• インポートしたCSVファイルがBOM付きだったことが原因でした。BOMなしの形式で作成し直してインポートすることで解決しました。

エラーなしで完了したがデータがインポートされていない

• CSVデータの末尾に空改行が必要です
• テキストエディタに貼り付けてCSVファイルを作成している場合には注意しましょう

インポートしたデータがずれてしまう

• データが別の列にずれこんで入ってしまうケース。要因が色々ありえます

複数のカテゴリーをインポートする

• インポートできない話とは少しそれますが、ちょっと迷った点として紹介
• 複数のカテゴリーをインポートするときは素直に「,」区切りで入力すればOKです

複数のタクソノミー（ターム）をインポートする

• タクソノミーの場合は「tax_{タクソノミースラッグ名}」で列を作成します
• サンプルでは、「product」というカスタム投稿タイプに「sample」というタクソノミーの「ts_xxx」と「ts_yyy」の2つのタームを登録しています

Excelでデータを作る場合のポイント

• Excelでデータを作る場合は、データを「""」で囲むために関数を使うと楽です

• 全角文字が入るセルには「""」で囲んだ上に半角スペースを入れるため、次のような関数を使います

• 複数行に改行されたセルは、テキストエディタにコピペすると二重のダブルクオーテーション「""～""」で囲まれるため、結果的にコピペしたデータが「"""～"""」このような形になります。これをただの「"～"」の形に戻す必要があります
• ですので、テキストエディタにコピペしたあとに以下の置換作業を行います
  • タブを「,」に置換
  • 「"""」を「"」に置換