manual · pro

Rapls PDF Image Creator Pro マニュアル

Pro 1.1.0 ｜ 無料版 Rapls PDF Image Creator 1.4.39 以上 ｜ PHP 7.4 以上 ｜ WordPress 5.8 以上

Rapls PDF Image Creator Pro は、無料版 Rapls PDF Image Creator のアドオンです。無料版が作る PDF のサムネイルに、切り出し・PDF ごとのページ指定・閉じても止まらないキュー・差し替えの検出と差し替え画面を加えます。サーバーの条件がそろえば、無料版が描けない PDF を Ghostscript の直接呼び出しで描きます。

解像度・形式・品質・サイト全体のページ番号は、これまでどおり無料版の設定画面にあります。無料版の使い方は Free 版マニュアルをご覧ください。

01はじめに

動作要件

インストール

1. WordPress.org から無料版 Rapls PDF Image Creator（1.4.39 以上）をインストールし、有効化します。
2. 販売ページで購入すると、ライセンスキーがメールで届きます。
3. ダウンロードページで購入時のメールアドレスとライセンスキーを入力し、rapls-pdf-image-creator-pro.zip を受け取ります。
4. プラグイン → 新規プラグインを追加 → プラグインのアップロード から ZIP をアップロードし、有効化します。

ライセンスの有効化

ライセンスキーは RPIC-XXXXX-XXXXX-XXXXX-XXXXX-XXXXX の形です。

1. 設定 → PDF Image Creator Pro →「ライセンス」タブ を開きます。
2. メールアドレス に購入時のメールアドレス、ライセンスキー にキーを入力します。
3. ライセンスを有効化 を押します。「● ライセンス有効」と表示され、メールアドレス・伏せ字のキー・種類（「1サイト」または「5サイト」）が並べば完了です。

有効化で出るメッセージ:

無効化とサイトの移行

1 サイト版は 1 サイト、5 サイト版は 5 サイトまで有効化できます。別のサイトへ移すときは、元のサイトで このサイトでのライセンスを解除 を押してから（確認が出ます）、新しいサイトで有効化してください。解除するとサーバー側の枠が空き、このサイトのキーとメールアドレスは削除されます。

元のサイトを開けない、削除後も枠が残っているなどで解除できないときは、info@raplsworks.com にライセンスキーと元のサイトのアドレスをお知らせください。1 年のメールサポートを過ぎても受け付けます。ライセンスを再発行し、新しいキーをメールでお送りします（古いキーは使えなくなります。同じライセンスを使っている他のサイトも、新しいキーを入れるまで、次の毎日の確認で止まります）。キーをなくしただけのときは、同じキーをもう一度お送りします。

画面の場所

02切り出し

設定 → PDF Image Creator Pro の「何を切るか」「細かい調整」で設定します。

何を切るか

細かい調整

保存すると「保存しました。既存のサムネイルには手を触れていません。変えたいものは再生成してください。」と表示されます。作り直しはキューか、無料版の一括生成で行います。

手元のファイルで見る（プレビュー）

1. 設定画面の「手元のファイルで見る」で、— PDF を選ぶ — から PDF を選びます（新しい順に 20 件）。
2. 両方を描く を押します。画面上の設定（まだ保存していない値も含む）で、「切り出さない場合」と「この設定の場合」の 2 枚が並びます。
3. 2 枚目の下に、仕上がりの大きさとページ全体に対する割合、切り出しを適用しなかった場合はその理由が出ます。

03PDF ごとの設定

メディアライブラリで PDF を開くと、編集画面に次の欄が加わります。空欄・「サイト設定に従う」のままなら、サイト全体の設定がそのまま使われます。

04直接描画（Ghostscript）

サーバーの ImageMagick が PDF を読めないとき（多くはホスティング側のセキュリティポリシー、ときに部品の欠け）、無料版には回り道がありません。WordPress.org の規約で、ほかのプログラムを起動できないからです。Pro はその規約の外で配布されるため、Ghostscript を直接呼び出してページを描き、結果を無料版に渡して仕上げさせます。

使える条件

設定画面の「このサーバーが PDF をまったく描けないとき」→「このサーバー」に、判定と内訳が表示されます。

内訳には「プログラムの起動」「Ghostscript」「描画の時間制限」（あり (このプラグインが掛けます) / あり (timeout コマンド) / なし — 止まった描画を停止できません）が出ます。この結果は 12 時間記憶されます。ホスティング側で設定を変えたら このサーバーを再確認 を押してください。

有効にする

「使う」の 通常の経路が失敗したとき、Ghostscript の直接呼び出しに切り替える にチェックを入れて保存します。既定はオフで、判定が「使えます」でないときはチェックできません。サムネイルが作れず、無料版のステータス タブが PDF の描画を禁止・利用不可と言っているときに有効にしてください。

• 有効にすると、無料版のステータス タブの説明に「かわりに Ghostscript を直接呼び出してサムネイルを作っています。」が加わり、要件の一覧に「直接描画 (Pro)」の行が出ます。
• キューの詳細欄には「Ghostscript を直接呼び出して描画しました。」または「無料版で描画しました。」と、どちらで描いたかが出ます。
• Ghostscript 9.27 以前で透明を含むページが真っ白になる不具合には、自動で回避を掛けます。

05大きすぎるページの拒否

A0 のような大きなページを高い解像度で描くと、メモリを使い切って PHP の処理ごと落ちることがあります。落ちたプロセスは例外も失敗の記録も残しません。Pro はライセンスが有効なあいだ、描く前にページの大きさと解像度から画素数を見積もり、上限を超えるページを描かずに断ります。

• 上限は、ImageMagick のリソース上限の 40%、幅・高さの上限、そして 1 億画素（100 MP） のうち最も小さいもの。A4 の 600 dpi や A0 の 150 dpi（約 35 MP）は通り、A0 の 300 dpi（約 139 MP）は断られます。
• 断られたジョブはキューに「この解像度では、ページが大きすぎて描画できません。」と出ます。無料版の設定で解像度を下げて、もう一度キューに入れてください。
• 設定画面はありません。上限を変える必要がある場合は、フィルター rapls_pdfp_max_megapixels（単位は MP、0 以下で独自の上限を外す）を使います。

// 例: 上限を 150 MP にする（テーマの functions.php など）
add_filter('rapls_pdfp_max_megapixels', function () { return 150; });

実測: Xserver で A0・600 dpi のページが 0.004 秒で断られました（以前は 68.5 秒描き続けていました）。

06キュー

メディア → PDF キュー（見出しは「PDF サムネイルのキュー」）。キューに入れた PDF はバックグラウンドで処理され、画面を閉じても続きます。画面を開いているあいだは、画面からも処理を進め、件数が数秒ごとに更新されます。

画面のボタン

PDF が多く、1 回で入れきれないときは「1回で投入できる数を超える PDF がありました。下のボタンを押すと、止まったところから続きを投入します。」と出ます。残りをキューに入れる を押してください。結果は「追加: N件。入れ直し: N件。待機中: N件。」と表示されます。すでに入っているものや、同じ設定で作り終えたものは二重に入りません。

メディアライブラリの一括操作

メディア → ライブラリ をリスト表示にし、PDF にチェックを入れて「一括操作」から選びます。

• PDF サムネイルをキューに入れる — サムネイルの無いものを作ります。
• PDF サムネイルを作り直す (キュー) — 既存のサムネイルも置き換えて作り直します。一覧には「既存のサムネイルを置き換え」と出ます。

状態と再試行

詳細欄の主な理由:

サーバーの cron（静かなサイト向け）

バックグラウンドの処理は WP-Cron で動きます。WP-Cron は誰かがサイトを訪れたときにしか起きないため、訪問の少ないサイトでは何時間も進まないことがあります。一定の速さで進めたい場合は、サーバーの cron から wp-cron.php を 5 分ごとに呼んでください。

*/5 * * * * curl -s https://example.com/wp-cron.php?doing_wp_cron > /dev/null 2>&1

07差し替えの検出

サムネイルは、ある時点の PDF から作られます。あとで PDF が差し替えられても、サムネイルは古いままです。Pro はそれを見張って知らせます。見張ること自体は常に動いています（ファイルの大きさ・日時・ハッシュを比べるだけで、画像は変えません）。

検出できるもの・できないもの

Enable Media Replace 4.2.2 で、ファイル名を保つ差し替え・名前を変える差し替えの両方を実機で確認しています。

バッジと件数

• メディア → ライブラリ（リスト表示）の 「PDF のサムネイル」列に、差し替えられた PDF だけ 「差し替え済み」（「サムネイルは前のファイルのものです。」）、作れない PDF には 「作成できません」と出ます。問題の無い PDF には何も出ません。
• 設定画面の「現在の状況」に「差し替え N件、作成できないもの N件。」と出て、差し替えがあれば サムネイルを作り直すためキューに入れる のリンクが付きます。
• PDF の編集画面の「この PDF」欄にも同じ内容が出ます。

自動で作り直す

「差し替えを見つけたら」の 自動でサムネイルをキューに入れて作り直す にチェックを入れると、差し替えを見つけた PDF をキューに入れます。既定はオフです。頼まれずに画像を置き換えるためで、オフのままなら一覧に出るだけで、作り直すタイミングは自分で決められます（キューの「差し替えられた PDF をキューに入れる」）。

08PDF の差し替え

PDF の編集画面の右側に 「この PDF を差し替える」の箱があります。メディアライブラリの一覧（削除の隣）には置いていません。間違ったファイルで押さないためです。

差し替える

1. メディアライブラリで差し替えたい PDF を開きます。箱の「現在」に、いまのファイル名・大きさ・ページ数が出ます。
2. 新しい PDF を選びます。
3. いまのファイル名を保つ（既定でチェック済み）を確認します。
4. 差し替える を押します。

その PDF を指している投稿・リンク・メディアライブラリの項目は、すべてそのまま同じ PDF を指し続けます（添付ファイルの ID は変わりません）。サムネイルもその場で作り直され、前のサムネイル画像は残りません。

元に戻す

前のファイルを保管していると、箱に「前のファイルを保管しています: ファイル名、差し替えたのは … 前です。」と 前のファイルに戻す が出ます。押すと確認のあと、直前のファイルに戻し、サムネイルも作り直します（「前の PDF を元のファイル名で戻し、サムネイルも作り直しました。」）。

保管数を「保管しない」にしていると、「差し替えたファイルを保管しない設定になっているため、ここから元に戻すことはできません。」と表示されます。

保管と Nginx

設定画面の「差し替えられた PDF」→「自分で差し替えるとき」の 元に戻せるように、前のファイルをこの数だけ保管する: で、保管しない / 1 / 2 / 3（既定 1）から選びます。

• 保管先は uploads の中の、推測できない名前のフォルダー（rapls-pdfp-backups- に続くランダムな文字列）です。
• Apache では、そのフォルダーの .htaccess がすべてのアクセスを拒否します。
• PDF をメディアライブラリから削除すると、その PDF の保管ファイルも削除されます。

# Nginx の例（フォルダー名は設定画面に表示されたものに置き換え）
location ^~ /wp-content/uploads/rapls-pdfp-backups-xxxxxxxxxxxx/ { deny all; }

09更新

Pro の更新は WordPress.org ではなく Rapls Works の更新サーバーから、WordPress のいつもの更新画面に届きます。ライセンスが有効であることが必要です（アップデートに期限はありません。人が答えるメールサポートはご購入から 1 年間で、その後もアップデートは届きます）。

• プラグイン 画面の Pro の行に 詳細を表示 と 更新を確認 が付きます。更新を確認を押すと、「バージョン N が利用できます。…」「最新版です (N)。」「ライセンスが有効でないため、更新を確認できません。」「更新サーバーに接続できないか、ライセンスが受け付けられませんでした。…」のいずれかが出ます。最後のものが出たときに、下に更新の案内が残っていれば、それは前回サーバーにつながったときの案内です。
• ライセンスキーは URL に載せず、リクエストのヘッダーで送ります。
• ZIP は HTTPS でのみ受け取り、インストール前に大きさと SHA-256 を照合します。合わなければ「更新パッケージが整合性検査に通らなかったため、インストールしませんでした。」と出て、何も入れ替えません。
• 無料版が古くて Pro が止まっているときも、更新は受け取れます。

10削除（アンインストール）

プラグイン 画面で Pro を無効化して削除すると、次のものを消します。

保管フォルダーを消すため、差し替えで保管していた前の PDF は削除後に戻せなくなります。必要なら先に元に戻してください。

11困ったとき

Pro を入れたのに何も変わらない

• 切り出しの既定は「オフ」です。設定 → PDF Image Creator Pro でモードを選んでください。
• 設定を変えても、既存のサムネイルはそのままです。キューの「すべての PDF のサムネイルを作り直す」か、PDF を選んで「PDF サムネイルを作り直す (キュー)」で作り直してください。
• 設定 → PDF Image Creator Pro →「ライセンス」タブ で「ライセンス有効」になっているか確認してください。
• 管理画面上部に無料版についての赤い通知が出ていないか確認してください。

「無料版に必要な拡張点がありません」と出る

無料版のバージョンは足りているのに、Pro が接続するフィルター（rapls_pdf_image_creator_before_resize）がコードにありません。無料版をクリーンなコピーから入れ直してください。直らなければ、この名前を添えてサポートにご連絡ください。

キューが進まない

• 訪問の少ないサイトでは WP-Cron が起きません。サーバーの cron を 5 分ごとに設定するか、キューの画面を開いたままにしてください。
• DISABLE_WP_CRON を true にしているなら、サーバーの cron が必要です。
• 「再試行待ち」は約 5 分後まで動きません。

サムネイルが真っ白

無料版のステータス タブで理由を確認してください。Ghostscript 9.27 以前の透明の不具合なら、無料版と直接描画のどちらも回避を掛けます。スキャンの PDF で余白を取り除いた結果がおかしい場合は、許容値を確認してください（12〜21% は避ける）。

切り出しが途中で止まったように見える

許容値が 12〜21% の範囲にある可能性が高いです。プレビューで仕上がりの大きさを見比べ、8% 以下か 21% より上に変えてください。この PDF だけ切りたくない場合は、編集画面の「切り出し」を「オフ」にします。

差し替えたのに古い PDF がダウンロードされる

ファイル名を保った差し替えでは URL が同じなので、CDN やブラウザのキャッシュが古い PDF を返すことがあります。CDN のキャッシュを消すか、ブラウザで再読み込みしてください。

新しい PDF を上げたのに「差し替え済み」が出ない

新しくアップロードして古いものを削除した場合は、別のファイルなので検出できません。新しい PDF はふつうにサムネイルが作られます。FTP で上書きした場合は、毎日の確認か「いますべての PDF を確認する」で出ます。

直接描画のチェックボックスが押せない

「このサーバー」の判定が「使えます」ではありません。表示された理由を確認し、ホスティング側で変更したら このサーバーを再確認 を押してください。

12よくある質問