Rapls PDF Image Creator
·
ImageMagick を使用して、アップロードした PDF ファイルからサムネイル画像を自動生成します。アイキャッチ画像に設定し、投稿に挿入できます。
評価機能
バージョン
1.0.9.10
有効インストール数
80
最終更新日時
Jun 11, 2026
Rapls PDF Image Creator は、WordPress のメディアライブラリに PDF ファイルをアップロードすると自動的にサムネイル画像を生成します。ImageMagick (Imagick PHP エクステンション) を使用して、PDF の最初のページを画像に変換します。
👉 セットアップガイドとトラブルシューティング : CMYK の黒のサムネイルや PDF/X に関する問題の解決方法
主な機能
- 自動生成 – PDF アップロード時にサムネイルを即座に作成する
- アイキャッチ画像対応 – 生成したサムネイルを自動的に PDF のアイキャッチ画像に設定する
- 複数サイズ対応 – WordPress に登録されたすべての画像サイズで生成する
- メディアライブラリ統合 – デフォルトの PDF アイコンの代わりにサムネイルを表示する
- エディター統合 – サムネイル画像付きの PDF リンクを投稿に挿入する
- 一括生成 – 既存のすべての PDF のサムネイルを一度に生成する
- 柔軟な出力 – JPEG、PNG、WebP フォーマットから選択可能
仕組み
- メディアライブラリに PDF ファイルをアップロードする
- プラグインが最初のページを自動的に画像に変換する
- 画像を PDF のアイキャッチ画像として登録する
- ショートコードまたはテンプレート関数でサムネイルを表示する
生成されるファイル
my-document.pdf をアップロードすると、プラグインは以下を作成します:
- my-document-pdf.jpg (フルサイズカバー画像)
- my-document-pdf-1024×768.jpg (大)
- my-document-pdf-300×225.jpg (中)
- my-document-pdf-150×150.jpg (サムネイル)
- テーマ設定に基づく追加サイズ
ショートコード
[rapls_pdf_thumbnail id="123"]– サムネイル画像を表示する[rapls_pdf_thumbnail_url id="123"]– サムネイル URL を出力する[rapls_pdf_clickable_thumbnail id="123"]– PDF へのリンク付きサムネイル[rapls_pdf_download_link id="123"]– サムネイル付きダウンロードリンク
テンプレート関数
rapls_pic_get_thumbnail_url( $pdf_id, $size )– サムネイル URL を取得するrapls_pic_get_thumbnail_id( $pdf_id )– サムネイルの添付ファイル ID を取得するrapls_pic_get_thumbnail_image( $pdf_id, $size, $attr )– サムネイル HTML を取得するrapls_pic_has_thumbnail( $pdf_id )– PDF にサムネイルがあるか確認するrapls_pic_generate_thumbnail( $pdf_id, $force )– サムネイルを生成する
要件
- WordPress 5.0以上
- PHP 7.4以上
- Imagick PHP エクステンションと PDF サポートを含む ImageMagick
ほとんどの共有ホスティングで ImageMagick を利用できます。プラグイン設定の「ステータス」タブでサーバーが要件を満たしているか確認してください。
テンプレート関数の使用
テーマで PDF サムネイルを表示する:
$pdf_id = 123;
if ( rapls_pic_has_thumbnail( $pdf_id ) ) {
echo rapls_pic_get_thumbnail_image( $pdf_id, 'medium' );
}
サムネイルを PDF ファイルにリンクする:
$pdf_id = 123;
if ( $thumbnail_id = get_post_thumbnail_id( $pdf_id ) ) {
echo '<a href="' . esc_url( wp_get_attachment_url( $pdf_id ) ) . '" target="_blank">';
echo wp_get_attachment_image( $thumbnail_id, 'medium' );
echo '</a>';
}
投稿に添付されたすべての 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' )
);
}
}
利用可能なフィルターフック
rapls_pdf_image_creator_thumbnail_page– 使用する PDF ページ (デフォルト: 0)rapls_pdf_image_creator_thumbnail_max_width– 最大幅rapls_pdf_image_creator_thumbnail_max_height– 最大の高さrapls_pdf_image_creator_thumbnail_quality– 画像品質 (1-100)rapls_pdf_image_creator_thumbnail_format– 出力フォーマットrapls_pdf_image_creator_thumbnail_bgcolor– 背景色rapls_pdf_image_creator_thumbnail_image_attributes– 画像タグの属性rapls_pdf_image_creator_custom_insert_html– カスタム挿入 HTMLrapls_pdf_image_creator_hide_thumbnails_in_library– メディアライブラリで非表示にする
利用可能なアクションフック
rapls_pdf_image_creator_before_generate– サムネイル生成前rapls_pdf_image_creator_after_generate– 生成成功後rapls_pdf_image_creator_generation_failed– 生成失敗時