Rapls PDF Image Creator マニュアル（Free 版）

PDF の表紙を画像にしてアイキャッチ画像に設定する、無料プラグインの使い方です。
バージョン 1.4.45 ｜ WordPress 5.0 以上 ｜ PHP 7.4 以上

01このプラグインについて

メディアライブラリに PDF をアップロードすると、PDF のページを画像に変換し、その画像を PDF のアイキャッチ画像に設定します。変換には PHP の Imagick 拡張（ImageMagick）を使います。

• 自動生成：アップロードした時点でサムネイルを作ります。
• 全サイズ：フルサイズのほか、テーマが登録している画像サイズすべてを作ります。
• 真っ白を保存しない：全面が 1 色のページは描画の失敗とみなし、保存しません。
• カラー管理：CMYK の PDF は ICC プロファイルを通して sRGB に変換します。
• 理由を表示：作れなかったときは、ステータスタブとサイトヘルスに理由と対処を表示します。
• プロセスを起動しない：exec() などは一切使いません。制限の厳しい共用サーバーでも動きます。

02動作環境

多くの共用サーバーで使えます。使えるかどうかは、インストール後にステータスタブで確認できます。

03インストール

1. 管理画面で プラグイン → 新規追加 を開き、「Rapls PDF Image Creator」を検索します。
2. 今すぐインストール → 有効化 を押します。
3. 設定 → Rapls PDF Image Creator を開き、ステータス タブで要件を確認します。
4. PDF を 1 つアップロードして、サムネイルができることを確かめます。

設定画面には 設定・一括生成・ステータス の 3 つのタブがあります。

04ステータスタブで確認する

設定 → Rapls PDF Image Creator → ステータス。「サーバーステータス」に、このサーバーで PDF を描画できるかを表示します。バージョン番号から推測するのではなく、メモリ上で作った PDF を実際に読んで確かめた結果です。

ステータスタブ

結果は 12 時間記憶されます。ホスティング会社が設定を変えたあとは このサーバーを再検査 を押してください。

画面の下の 統計 には「PDF 総数」「サムネイルあり」「サムネイルなし」が出ます。統計を更新 で数え直します。

最後にサムネイルを作れなかった理由があれば、ここに日時と一緒に表示します。この表示は、次にサムネイルの生成が成功すると自動で消えます。

05設定タブ

設定 → Rapls PDF Image Creator → 設定

画像設定

動作設定

表示設定

挿入設定

投稿の編集画面で PDF を挿入したときに、何を出力するかを決めます。

<a href="%PDF_URL%" target="_blank">
  <img src="%THUMBNAIL_URL%" alt="%TITLE%">
</a>

出力は wp_kses_post() を通るので、投稿に書けない要素は取り除かれます。

06一括生成

プラグインを入れる前にアップロードした PDF や、設定を変えたあとに作り直したい PDF をまとめて処理します。

設定 → Rapls PDF Image Creator → 一括生成

1. 作り直したい場合は すでにサムネイルがある PDF も含める (再生成) にチェックを入れます。
2. PDF をスキャン を押します。「スキャン結果」に対象の数が出ます。
3. 生成開始 を押します。「進行状況」に「生成済み」「失敗」の数、「ログ」に 1 件ずつの結果が出ます。
4. 途中でやめるときは 停止 を押します。

対象が 0 件のときは、その理由（メディアライブラリに PDF がない／すべてサムネイル済み など）を表示します。すべてサムネイル済みの場合は、再生成を含めてスキャンし直すボタンが出ます。

07メディアライブラリ

• 表紙の表示：グリッド表示・一覧表示とも、PDF のアイコンの代わりに生成したサムネイルを表示します（「サムネイルアイコンを表示」がオンのとき）。
• 添付ファイルの編集画面：サムネイルを作った PDF は、編集画面のプレビューにも生成したサムネイルを表示します（1.4.3 以降）。
• 画像の選択画面に出る PDF：サムネイルのある PDF は、WordPress 標準の画像選択（画像・ギャラリー・投稿のアイキャッチ画像の各ブロック、ブロックエディターのアイキャッチ画像、クラシックエディターの「アイキャッチ画像を設定」と「メディアを追加」のアイキャッチ画像）にだけ出ます。他のプラグインの選択画面や、カバー・メディアとテキストなどの選択画面には出ません。フィルター rapls_pdf_image_creator_pdfs_in_every_image_picker で true を返すと、画像を求めるすべての選択画面に出す 1.4.20 までの動きに戻せます。ブロックエディターに PDF をドロップや貼り付けしたときは、画像ブロックではなくファイルブロックになります。PDF を画像として使うには、画像ブロックの「メディアライブラリ」タブで選んでください。
• 「PDF サムネイル」列：一覧表示に、サムネイルの有無（✓ / ✗）の列が付きます。
• 行のリンク：PDF の行にマウスを乗せると サムネイル生成（未生成のとき）または サムネイル再生成 が出ます。1 件だけ作り直すときに使います。

メディア → ライブラリ（一覧表示）

作られるファイル

my-document.pdf をアップロードすると、次のようなファイルができます（サイズはテーマの設定によります）。

my-document-pdf.jpg            フルサイズ
my-document-pdf-1024x768.jpg   大
my-document-pdf-300x225.jpg    中
my-document-pdf-150x150.jpg    サムネイル

再生成したサムネイルには、前とは別のファイル名が付きます。同じ URL のままだと、ブラウザーが古い画像を表示し続けるためです。

08投稿への挿入

投稿の編集画面で「メディアを追加」から PDF を選んで挿入すると、挿入設定のとおりに出力されます。

サムネイルを置く場所を投稿の中で細かく決めたいときは、次の章のショートコードも使えます。

09ショートコード

id には PDF の添付ファイル ID を指定します（メディアライブラリで PDF を開いたときの URL の item= / post= の数字）。ショートコードに指定できるのは PDF の ID だけです（1.4.45 以降）。他の投稿の ID も指定できる 1.4.20 までの動きに戻すには、フィルター rapls_pdf_image_creator_shortcode_any_post で true を返してください。その場合も、その投稿を見られる閲覧者にだけ表示されます。

[rapls_pdf_clickable_thumbnail id="123" size="medium"]
[rapls_pdf_download_link id="123" text="資料をダウンロード" show_thumbnail="false"]

10テンプレート関数

$pdf_id = 123;
if ( rapls_pic_has_thumbnail( $pdf_id ) ) {
    echo rapls_pic_get_thumbnail_image( $pdf_id, 'medium' );
}

投稿に添付された PDF をすべて並べる例：

$pdfs = get_posts( array(
    'post_type'      => 'attachment',
    'post_mime_type' => 'application/pdf',
    'post_parent'    => get_the_ID(),
    'posts_per_page' => -1,
) );

foreach ( $pdfs as $pdf ) {
    if ( rapls_pic_has_thumbnail( $pdf->ID ) ) {
        printf(
            '<a href="%s">%s</a>',
            esc_url( wp_get_attachment_url( $pdf->ID ) ),
            rapls_pic_get_thumbnail_image( $pdf->ID, 'thumbnail' )
        );
    }
}

11サムネイルが作られないとき

まず ツール → サイトヘルス の「PDF サムネイルの生成」か、ステータス タブを見てください。原因によって、頼む相手と頼む内容が変わります。

サーバーが PDF を読めない

この PDF だけ作れない

真っ白になる

1.4.0 以降、全面が 1 色のページは保存しません。PDF はアイコンのままになり、ステータスタブに理由が出ます。原因はおもに 2 つです。

• Ghostscript が古い（9.27 以前）：透明グループの中の画像で読み取りに失敗し、エラーを出さずに白いページを返します。PowerPoint や Illustrator から書き出した PDF で起きます。1.4.1 以降は、透明処理を切る指定（GS_OPTIONS）をその読み取りのあいだだけ環境に置いて、一度だけ読み直します。すでに絵が出たページには何もしません。根本的には、ホスティング会社に Ghostscript の更新を相談してください。
• 一部の ImageMagick 6 と CMYK の PDF：CMYK の PDF を ImageMagick 自身が読めない形式（bmpsep8）で受け取るビルドがあります。プラグイン側では回避できません。ホスティング会社に、ImageMagick 7 への更新か、delegates.xml の ps:cmyk を bmpsep8 から pamcmyk32 に変えることを頼んでください。RGB の PDF には起きないので、「一部の PDF だけ白い」ときはこれを疑ってください。

色が派手になる

サーバーに CMYK の ICC プロファイルが見つからないと、単純な計算の変換になり、緑や青が派手になります。ステータスタブの「カラー管理」を確認してください。サーバーに CMYK のプロファイルを入れるか、rapls_pdf_image_creator_icc_paths フィルターでプロファイルの場所を指定すると、正しい色に戻ります。

更新前に作ったサムネイルは前の色のままです。一括生成で再生成してください。前の色に固定したい場合は次のようにします。

add_filter( 'rapls_pdf_image_creator_color_conversion', function() {
    return 'naive';
} );

12フィルターとアクション

2 ページ目を表紙にする例（設定タブの「ページ番号」でも同じことができます）：

add_filter( 'rapls_pdf_image_creator_thumbnail_page', function( $page, $pdf_id ) {
    return 1; // 0 始まりなので 2 ページ目
}, 10, 2 );

13アンインストール

プラグインを削除すると、設定と、生成したサムネイル画像が削除されます。画像を残したい場合は、削除する前に 表示設定 → アンインストール時に画像を保持 をオンにしてください。残した画像は、普通の画像としてメディアライブラリに残ります。PDF ファイルそのものは削除されません。

14よくある質問

1 ページ目以外を表紙にできますか？

できます。設定タブの「ページ番号」で、サイト全体で使うページを指定してください（0 が最初のページ）。このサーバーでページの指定が効くかは、ステータスタブの「ページ選択」でわかります。

更新したのに、サムネイルの色が前のままです。

更新でサムネイルを自動では作り直しません。一括生成で「すでにサムネイルがある PDF も含める (再生成)」にチェックを入れて実行してください。

再生成したのに、画面では古い画像のままです。

1.4.1 以降は、再生成した画像に別のファイル名を付けるので、ブラウザーのキャッシュに邪魔されません。それより前に作った画像の場合は、ブラウザーのキャッシュを消してから確認してください。

添付ファイルの編集画面だけ、プレビューが真っ白です。

1.4.2 以前の表示です。WordPress はアップロード時に自分でも PDF のプレビューを作りますが、それには真っ白になる読み取りへの対策が効きません。編集画面はそのプレビューを表示していました。1.4.3 以降は、生成したサムネイルがある PDF ではそちらを表示します。プラグインを更新すれば直り、サムネイルを作り直す必要はありません。

サーバーでコマンドを実行しますか？

しません。PDF の描画は ImageMagick（Imagick 拡張）が行い、プラグインはプロセスを起動しません。真っ白のときの読み直しも、環境変数を一時的に置くだけです。

15アドオンについて

この無料プラグインに足す有料アドオン Rapls PDF Image Creator Pro があります。PDF ごとのページ指定と切り出し、差し替えられた PDF の検出と差し替え画面、タブを閉じても進むキューを追加します。無料プラグインの動作は、アドオンの有無で変わりません。アドオンの案内は、プラグイン一覧の行、設定タブの下のカード、ステータスタブ、ページ番号の欄の下（ページ番号を変えたあと一度だけ）の 5 か所だけに出ます。フィルター rapls_pdf_image_creator_show_upsell で false を返すと、すべて消えます。