Rapls PDF Image Creator

説明

Rapls PDF Image Creator は、WordPress のメディアライブラリに PDF ファイルをアップロードすると自動的にサムネイル画像を生成します。ImageMagick (Imagick PHP エクステンション) を使用して、PDF の最初のページを画像に変換します。

主な機能

• 自動生成 – PDF アップロード時にサムネイルを即座に作成する
• アイキャッチ画像対応 – 生成したサムネイルを自動的に PDF のアイキャッチ画像に設定する
• 複数サイズ対応 – WordPress に登録されたすべての画像サイズで生成する
• メディアライブラリ統合 – デフォルトの PDF アイコンの代わりにサムネイルを表示する
• エディター統合 – サムネイル画像付きの PDF リンクを投稿に挿入する
• 一括生成 – 既存のすべての PDF のサムネイルを一度に生成する
• 柔軟な出力 – JPEG、PNG、WebP フォーマットから選択可能

仕組み

1. メディアライブラリに PDF ファイルをアップロードする
2. プラグインが最初のページを自動的に画像に変換する
3. 画像を PDF のアイキャッチ画像として登録する
4. ショートコードまたはテンプレート関数でサムネイルを表示する

生成されるファイル

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 – カスタム挿入 HTML
• rapls_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 – 生成失敗時