プラグイン「WP All Export」の使い方

ワードプレスの記事を含むデータをCSV/XMLでエクスポートする無料のプラグインツールの使用方法についてです。

エクスポートするプラグインの数は、リポジトリから探してみると案外少ないので、個人的に無料のプラグインから選ぶと「WP All Export」一択に思えます。

Nora
Nora

他のプラグインで便利なものがあるのをご存知の方がいらっしゃったら教えて欲しいです。。。orz

というのは、比較したのがワードプレスが標準的に備えているエクスポートツールは確かXMLのみだったと思いますし、どれもエクスポートするオブジェクトを絞り込むフィルター機能に乏しいように思えます。

実は一度WooCommerceの商品をCSVで扱えないかと探したことがありましたが、こちらは有料でしたので自分で簡易的なCSV機能を作ったか作ろうとしたかといった曖昧な記憶があります。

ただ、絞込み機能を無料の状態で使用するにあたっては少しハードルがあり、ワードプレスの「WP_Query」の使い方の知識が少し必要になりますが、テーマやプラグインなどを自分で作成したりカスタマイズした経験があるとハードルは殆どゼロに等しいです。

プラグイン:WP All Export

  • Table of Contents

まずはインストール・有効化

まずはインストールと有効化からです。

インストールされている数が多い上に、エクスポートツールの数が余り多く無いのですぐに見つかると思います。

このようにリポジトリから検索できます。

WP All Export
WP All Export

検索できたらインストール・有効化ボタンをクリックします。

有効化されていると、画像のようになると思います。

ページの案内

有効化が完了していると、管理画面のメニューアイテムが追加されます。

和訳がちょっと変ですが、「すべてエクスポート」と書かれているメニューです。

サブメニューとして

  • 新規エクスポート
  • エクスポートを管理
  • 設定

というページが用意されています。

WP All Export - 管理画面
WP All Export – 管理画面

何故他のエクスポートツールように「エクスポート」のようなページ名でなく、「新規エクスポート」というページ名なのかというと、このプラグインではエクスポートするクエリを保存し、のちに同じ条件で検索(条件の編集も可)することができ、エクスポートすると同時にそのエクスポートアクションを保存できるからです。

二番目の「エクスポートを管理」というページでは、まさに一度使用したエクスポート(アクション)がそれぞれ保存されていて、同じ条件で実行したり、編集を加えることができるよう、一覧となっています。

「設定」は、API利用やスケジューリング、絞り込むクエリのインポート機能などですので、最初は気にしなくても大丈夫です。

では、新規エクスポートを試してみましょう。

新規エクスポート

新規エクスポートのページに移動すると、前の項目で表示されていた画像のようなページになります。

プラグインのバージョンによるかもしれませんが、現在はこんな形です。

WP All Export - 管理画面
WP All Export – 管理画面

では、エクスポートの最初のステップです。

ステップ1:対象を選択・絞る

先ほどご案内した最初のページですが、選択肢が2つ表示されています。

  • 特定の投稿タイプ
  • WP_Query結果

緑色に光っているのが現在選択されている方です。

特定の投稿タイプの場合

まず、左の「特定の投稿タイプ」を選択する場合、該当するオブジェクト全てが対象となります。

例えば選択肢の中から「投稿」を選択すると、既存の投稿が全てCSVのリストに追加されます。

WP All Export - 特定の投稿タイプ
WP All Export – 特定の投稿タイプ

有料版では投稿タイプの選択肢の下にフィルタリング機能が使用可能で、カテゴリ指定などのルールを追加することができます。

投稿タイプの選択肢にある「分類」は恐らく分類として登録されているデータそのものを扱うものですので、事前確認をしっかりした方がいいです。

WP All Export - WP_Query結果
WP All Export – WP_Query結果

WP_Query結果の場合

と書かれても分かりにくいかもしれませんが、WP_Queryはワードプレスで条件に合う投稿などのオブジェクトを取得する際に使用するクエリです。

これを使うことにより、無料版であるにも拘らず、ある程度条件を指定して、条件に適合するもののみを抽出できます。

クエリを書き込むのは一番下のテキストボックス内です。

クエリの種類は、

  • 投稿タイプ
  • ユーザー
  • コメント

を検索するものが用意されていますが、ここでは基本的な投稿タイプでの紹介をしていきます。

もう一度参考ページを貼っておきます。

参考ページ:WP_Query

使用するクエリは以下のようなものです。

'post_type'   => array( 'post' ),
'post_status' => array( 'public' ),
'tax_query'   => array(
    array(
        'taxonomy' => 'category',
        'field'    => 'name',
        'terms'    => array( 'カテゴリー1', '未分類' )
    ),
)

解説すると、本来は

$wp_query = new WP_Query( array(
  'post_type'   => array( 'post' ),
  'post_status' => array( 'public' ),
  'tax_query'   => array(
    array(
      'taxonomy' => 'category',
      'field'    => 'name',
      'terms'    => array( 'カテゴリー1', '未分類' )
    ),
  )
) );

とクエリを書いて、投稿オブジェクトのリストを「$wp_query」で取得するのですが、「WP All Export」のクエリを使用する際は、クエリの引数として使用される連想配列の中身を直接書く形になります。

上の条件ですと、

  • 投稿タイプ: 投稿
  • 投稿ステータス:公開
  • 「カテゴリー」の「未分類」あるいは「カテゴリー1」を有する

といったものが対象となります。

PHP言語で部分的に書くような状態で、ワードプレスのカスタマイズができる方なら大抵の方は扱えると信じておきます。

$wp_query = new WP_Query( array(
  // ここを直接書き込みます。
) );

また、tax_queryというパラメータを指定することで、少し複雑な分類を指定することもできてしまいます。

※ 最後の行末にカンマ(,)を付けるとエラーとなりますので、ご注意を。

このような形になります。

WP All Export - WP_Query結果
WP All Export – WP_Query結果

クエリが書けましたら、一番下の「エクスポート ファイルをカスタマイズします。」ボタンをクリックします。

クエリの書き方が間違えているとエラーとなります。

また、文字列検索することもできますが、プラグインのエラーなのか、単にプラグインが対応していないのか分かりませんが、次のステップでエラーが起きます。。。orz

では、ボタンをクリックしてみましょう。

ステップ2:CSVに出力するフィールドを選択

エラーが起こらずに次に進むと、次の画像のように遷移します。

まず、緑で囲った枠の下にあるボタンの中に「プレビュー」がありますので、ご希望のデータが取得できているか、そのデータの一覧を確認できます。

右の赤枠内にある「+」の付いたメニューアイテムをクリックすると、使用可能なフィールド一覧が表示されますので、それをドラッグドロップで緑枠内に移動させることでフィールドが追加できます。

緑の枠内にある項目がCSVのフィールドのリストとなっており、クリックすると編集・削除が可能です。

WP All Export - CSVフィールドの選択
WP All Export – CSVフィールドの選択

基本的な操作はこれだけで大丈夫です。

下にある項目はオプションですが軽く触れておきます。

紫枠の高度な設定は、区切りを指定できますが、インポート側のパーサが処理できない場合など以外では、標準的な設定のまま変更しない方がいいので、慣れている方以外は操作しない方が吉です。

次に緑枠内は、エクスポートするファイルの種類です。標準的なCSVファイルやXMLファイルを指定することが可能です。有料版では、エクセル形式にもできるようです。

最後の青枠は、CSVフィールドのテンプレート設定です。チェックを入れることで、操作中の設定フィールドをテンプレートとして保存することができます。

また、保存されているテンプレートを選択することで、上のフィールドをドラッグドロップなどで設定する手間を省略することもできます。

WP All Export - CSVフィールドの選択 オプション
WP All Export – CSVフィールドの選択 オプション

出力するCSVフィールドの設定が完了し、プレビューなどでも問題がないようでしたら、「続行」をクリックして次のステップに進みます。

ステップ3:確認と実行

ここまでくればあとは実行するだけです。

一番上の項目はスケジューリングの設定で、他のAPIや有料版での機能となっていますので、すっ飛ばして、緑枠内の設定項目についてです。

無料版のオプションに関しては和訳がされているようですので、フレンドリ名という項目について補足します。

フレンドリ名は、保存されるエクスポートアクション一覧の項目名として使用されます。どのようなエクスポート処理なのかが分かる名前をつけておくことで、「エクスポートを管理」のページにて一覧を見た時に見つけやすくなるでしょう。

WP All Export - 確認と実行
WP All Export – 確認と実行

では、「エクスポートの確認&実行」をクリックしましょう。

ステップ4:ダウンロード

画面が遷移したら、あとはファイルが生成されるのを待つだけです。

赤枠にあるボタンもしくはリンクをクリックすると、エクスポートされたCSV(あるいはXML)ファイルがダウンロードできます。

「バンドル」でダウンロードする場合だと、ZIPファイル形式に圧縮された状態となります。

WP All Export - ダウンロード
WP All Export – ダウンロード

URLを伏せているのは、ローカルのテスト環境がマルチサイトでしたので、テスト用に使用しているレンタルサーバ上のマルチサイトではない標準的なワードプレスを使っている為です。お気になさらず。

エクスポートを管理

管理画面の「すべてエクスポート」->「エクスポートを管理」というページについてです。

ここには一度実行したエクスポートアクションが記録されており、最後に実行した際に生成されたファイルを再度ダウンロードしたり、同じ条件に基づいて再度CSVファイルを生成することができます。

試しに条件に当て嵌まる投稿などを公開して、「エクスポートを実行」をクリックすると、新しい投稿も含まれてCSVが生成されていました。

WP All Export - エクスポートを管理
WP All Export – エクスポートを管理

注意点は「設定のエクスポート」という項目が、恐らく「エクスポートの設定」の誤訳だということです。

翻訳はボランティアで行われていると思いますので、和訳は完璧ではないようです。

 

最後に

WP_Queryを直接書くことができるため、無料版でも条件の絞込みができるのも魅力的ですが、一度実行したエクスポートアクションをテンプレートとして保存しておけるのは非常に便利です。

他のエクスポートプラグインでは使用不可な機能が豊富です。

無料アドオンも豊富で、すでにリポジトリにアップロードされているものもあります。

もちろんインポート用のプラグインも存在します。

Nora
Nora

無料版でしたら僕もすぐに試すことができますので、ご質問などがございましたら、コメントなどで構いませんので、お気軽にお声掛けください。

ちなみにWP_Queryでエラーとなってしまう文字列検索は、

's' => '文字列'

という形です。

専用プラグインを作ってフィルター掛けて修正できるかなぁと思ったのですが、プラグインの中身見たらすんごい数のファイルで、探すの大変そうでした。。。orz

Nora
Nora

クエリのサンプル

カテゴリー「カテゴリー1」の投稿:

'post' => array( 'post' ),
'post_status' => array( 'public' ),
'tax_query' => array(
  array(
    'taxonomy' => 'category',
    'field'    => 'name',
    'terms'    => array( 'カテゴリー1' )
  ),
)

要ログインの「プライベート」ステータスのカテゴリー「カテゴリー1」の投稿:

'post' => array( 'post' ),
'post_status' => array( 'private' ),
'tax_query' => array(
  array(
    'taxonomy' => 'category',
    'field' => 'name',
    'terms' => array( 'カテゴリー1' )
  ),
)

タグ「タグ1」の投稿:

'post' => array( 'post' ),
'post_status' => array( 'public' ),
'tax_query' => array(
  array(
    'taxonomy' => 'tag',
    'field'    => 'name',
    'terms'    => array( 'タグ1' )
  ),
)

カテゴリー「カテゴリー1」とタグ「タグ1」を併せ持つ投稿:

'post' => array( 'post' ),
'post_status' => array( 'public' ),
'tax_query' => array(
  'relation' => 'AND',
  array(
    'taxonomy' => 'category',
    'field'    => 'name',
    'terms'    => array( 'カテゴリー1' )
  ),
  array(
    'taxonomy' => 'tag',
    'field'    => 'name',
    'terms'    => array( 'タグ1' ),
  ),
)

カテゴリー「カテゴリー1」とタグ「タグ1」のどちらかを持つ投稿:

'post' => array( 'post' ),
'post_status' => array( 'public' ),
'tax_query' => array(
  'relation' => 'OR',
  array(
    'taxonomy' => 'category',
    'field'    => 'name',
    'terms'    => array( 'カテゴリー1' )
  ),
  array(
    'taxonomy' => 'tag',
    'field'    => 'name',
    'terms'    => array( 'タグ1' ),
  ),
)

1件のコメント

  • 公開時にテキストが消えている部分がありましたので、後から少し修正しました。。。orz

コメントを残す

このサイトはスパムを低減するために Akismet を使っています。コメントデータの処理方法の詳細はこちらをご覧ください