內容簡介
Rapls PDF Image Creator 外掛可自動生成 PDF 文件的縮圖，並將其設為特色圖片，提升媒體庫的可視化效果。此外掛使用 ImageMagick 將 PDF 的第一頁轉換為圖片，並支援多種圖片格式。
【主要功能】
• 自動生成縮圖：上傳 PDF 時即時創建縮圖
• 特色圖片支援：自動設置生成的縮圖為 PDF 的特色圖片
• 多種尺寸：生成所有註冊的 WordPress 圖片尺寸
• 媒體庫整合：顯示縮圖取代預設 PDF 圖示
• 編輯器整合：在文章中插入帶縮圖的 PDF 連結
• 批量生成：一次為所有現有 PDF 生成縮圖
外掛標籤
開發者團隊
② 後台搜尋「Rapls PDF Image Creator – PDF Thumbnails & Featured Images」→ 直接安裝（推薦）
📦 歷史版本下載
原文外掛簡介
Rapls PDF Image Creator automatically generates thumbnail images when you upload PDF files to your WordPress Media Library. The plugin uses ImageMagick (Imagick PHP extension) to convert the first page of a PDF into an image.
👉 Setup guide & troubleshooting: How to fix CMYK black thumbnails and PDF/X issues
Key Features
Automatic Generation – Thumbnails are created instantly when PDFs are uploaded
Featured Image Support – Generated thumbnails are automatically set as the PDF’s featured image
Multiple Sizes – Images are generated in all registered WordPress image sizes
Media Library Integration – Display thumbnails instead of default PDF icons
Editor Integration – Insert PDF links with thumbnail images into your posts
Bulk Generation – Generate thumbnails for all existing PDFs at once
Flexible Output – Choose from JPEG, PNG, or WebP formats
How It Works
Upload a PDF file to the Media Library
The plugin automatically converts the first page to an image
The image is registered as the PDF’s featured image
Use shortcodes or template functions to display the thumbnail
Generated Files
When you upload my-document.pdf, the plugin creates:
my-document-pdf.jpg (Full size cover image)
my-document-pdf-1024×768.jpg (Large)
my-document-pdf-300×225.jpg (Medium)
my-document-pdf-150×150.jpg (Thumbnail)
Additional sizes based on your theme settings
Shortcodes
[rapls_pdf_thumbnail id="123"] – Display thumbnail image
[rapls_pdf_thumbnail_url id="123"] – Output thumbnail URL
[rapls_pdf_clickable_thumbnail id="123"] – Thumbnail linked to PDF
[rapls_pdf_download_link id="123"] – Download link with thumbnail
Template Functions
rapls_pic_get_thumbnail_url( $pdf_id, $size ) – Get thumbnail URL
rapls_pic_get_thumbnail_id( $pdf_id ) – Get thumbnail attachment ID
rapls_pic_get_thumbnail_image( $pdf_id, $size, $attr ) – Get thumbnail HTML
rapls_pic_has_thumbnail( $pdf_id ) – Check if PDF has thumbnail
rapls_pic_generate_thumbnail( $pdf_id, $force ) – Generate thumbnail
Requirements
WordPress 5.0 or higher
PHP 7.4 or higher
ImageMagick with Imagick PHP extension and PDF support
Most shared hosting providers have ImageMagick available. Check the Status tab in plugin settings to verify your server meets the requirements.
Using Template Functions
Display a PDF thumbnail in your theme:
$pdf_id = 123;
if ( rapls_pic_has_thumbnail( $pdf_id ) ) {
echo rapls_pic_get_thumbnail_image( $pdf_id, 'medium' );
}
Link thumbnail to PDF file:
$pdf_id = 123;
if ( $thumbnail_id = get_post_thumbnail_id( $pdf_id ) ) {
echo '';
echo wp_get_attachment_image( $thumbnail_id, 'medium' );
echo '';
}
Display All PDFs Attached to a Post
$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(
'%s',
esc_url( wp_get_attachment_url( $pdf->ID ) ),
rapls_pic_get_thumbnail_image( $pdf->ID, 'thumbnail' )
);
}
}
Available Filter Hooks
rapls_pdf_image_creator_thumbnail_page – PDF page to use (default: 0)
rapls_pdf_image_creator_thumbnail_max_width – Maximum width
rapls_pdf_image_creator_thumbnail_max_height – Maximum height
rapls_pdf_image_creator_thumbnail_resolution – Rendering resolution in DPI (default: 150)
rapls_pdf_image_creator_thumbnail_quality – Image quality (1-100)
rapls_pdf_image_creator_thumbnail_format – Output format
rapls_pdf_image_creator_thumbnail_bgcolor – Background color
rapls_pdf_image_creator_thumbnail_image_attributes – Image tag attributes
rapls_pdf_image_creator_custom_insert_html – Custom insert HTML
rapls_pdf_image_creator_hide_thumbnails_in_library – Hide in Media Library
rapls_pdf_image_creator_policy_paths – ImageMagick policy.xml paths to search when diagnosing blocked PDF support
Color Conversion Filters
rapls_pdf_image_creator_color_conversion – auto (default), icc or naive. naive restores the pre-1.1.0 colors
rapls_pdf_image_creator_icc_paths – Array of absolute paths to search, per profile type (srgb / cmyk)
rapls_pdf_image_creator_rendering_intent – An Imagick::RENDERINGINTENT_* value (default: relative colorimetric)
rapls_pdf_image_creator_flatten_background – Background transparency is flattened onto (default: the configured background, or white for JPEG)
Pointing the plugin at a specific pair of profiles:
add_filter( 'rapls_pdf_image_creator_icc_paths', function( $paths, $type ) {
if ( 'cmyk' === $type ) {
return array( '/srv/icc/JapanColor2011Coated.icc' );
}
return $paths;
}, 10, 2 );
Available Action Hooks
rapls_pdf_image_creator_before_generate – Before thumbnail generation
rapls_pdf_image_creator_after_generate – After successful generation
rapls_pdf_image_creator_generation_failed – When generation fails
