尚未检测到更新。GitHub 发布版本后会显示在这里。
按最近已完成的 8 小时观测回合间的 GitHub 星标增量排序
Geld is a browser extension that hides test files and other review noise from GitHub diffs, so you can review the code that matters first. Chrome, Edge, Firefox and Safari.
翻译准备中
个人 GitHub 账号下公开仓库的所有者可以登录并验证所有权，自行管理介绍，无需管理员批准。
登录并生成验证文件，在 30 分钟内将其提交到此仓库的默认分支。其他分支或分叉仓库中的文件无效。然后在下方检查文件，即可无需管理员批准直接管理项目。请保留文件以维持管理权限。
如需登录，将前往登录页面。登录后请回到此处，再次点击所选的验证按钮。
在项目文件夹中运行 /nomorevibe verify，即可验证所有权并自行管理介绍。
一分钟完成验证Generate PDF thumbnail images automatically in WordPress. Supports CMYK→sRGB conversion and PDF/X format.
翻译准备中
取自仓库 README
正在加载完整 README。 以下为已保存的摘录。
WordPress で PDF ファイルからサムネイル画像を自動生成するプラグインです。PDF アップロード時に自動でプレビュー画像を作成し、アイキャッチ画像や投稿内の画像として利用できます。 📖 詳しい解説記事: Rapls PDF Image Creator｜WordPress PDFサムネイル生成プラグイン • PDF 自動サムネイル生成 — メディアライブラリへ PDF アップロード時に自動で画像化 • 抽出ページの指定 — 既定は 1 ページ目。設定画面で任意の 1 ページを指定でき、フィルタ rapls_pdf_image_creator_thumbnail_page で PDF ごとに上書きできます（1 回の生成につき 1 ページ） • 画像フォーマット選択 — PNG / JPEG / WebP など複数フォーマットに対応 • パフォーマンス最適化 — キャッシング機能で再生成を回避 • ショートコード / テンプレート関数 — [rapls_pdf_thumbnail] などで投稿やテーマから呼び出し • 一括生成 — 既存の PDF をまとめて画像化 • 多言語対応 — i18n 対応（日本語翻訳同梱）查看完整 README ↗
WordPress で PDF ファイルからサムネイル画像を自動生成するプラグインです。PDF アップロード時に自動でプレビュー画像を作成し、アイキャッチ画像や投稿内の画像として利用できます。
📖 詳しい解説記事: Rapls PDF Image Creator｜WordPress PDFサムネイル生成プラグイン
rapls_pdf_image_creator_thumbnail_page で PDF ごとに上書きできます（1 回の生成につき 1 ページ）[rapls_pdf_thumbnail] などで投稿やテーマから呼び出し詳しくは ガイド を参照。
A: Imagick PHP 拡張が無いか、ImageMagick が PDF を読むために必要な Ghostscript が サーバーに無い可能性があります。まず管理画面の「Status」タブで検出結果を確認してください。
A: 管理画面で「解像度」設定を上げてください。
A: 「Settings」タブの Page Number で指定します（0 が 1 ページ目）。
サイト全体の既定値なので、PDF ごとに変えたい場合はフィルタを使ってください。
add_filter( 'rapls_pdf_image_creator_thumbnail_page', function ( $page, $pdf_id ) {
return 2; // 3 ページ目
}, 10, 2 );
1 回の生成で書き出せるのは 1 ページです。
A: 管理画面の「Bulk Generate」タブから一括生成します。 処理は分割して順次実行されるので、完了するまでタブを開いたままにしてください。
A: 管理画面で「出力フォーマット」を WebP に設定。
ただし、一部のブラウザ・サーバー環境では WebP がサポートされていない場合があります。
php -m | grep -i imagick
php -r 'var_dump( Imagick::queryFormats( "PDF" ) );'
空配列が返る場合は、ImageMagick に PDF デリゲートが無いか、Ghostscript が未導入です。
gs --version
いずれも確認できない場合は、サーバー提供者に導入を依頼してください。
Generator::generate() は変換オプションをすべて PDF 単位のフィルター経由で組み立てます。第 2 引数に添付 ID が渡るので、PDF ごとに違う値を返せます。
| フィルター | 既定値 | 型 |
|---|---|---|
rapls_pdf_image_creator_thumbnail_page | 設定画面の値（0 = 1 ページ目） | int |
rapls_pdf_image_creator_thumbnail_max_width | 1024 | int |
rapls_pdf_image_creator_thumbnail_max_height | 1024 | int |
rapls_pdf_image_creator_thumbnail_resolution | 150 | int |
rapls_pdf_image_creator_thumbnail_quality | 90 | int |
rapls_pdf_image_creator_thumbnail_format | jpeg | string |
rapls_pdf_image_creator_thumbnail_bgcolor | white | string |
// report-*.pdf だけ 3 ページ目を使う（ページ番号は 0 起点）
add_filter('rapls_pdf_image_creator_thumbnail_page', function ($page, $pdfId) {
return 0 === strpos(basename(get_attached_file($pdfId)), 'report-') ? 2 : $page;
}, 10, 2);
add_filter('rapls_pdf_image_creator_before_resize', function (Imagick $image, array $options) {
// $options['attachment_id'] — 元 PDF の添付 ID
// $options['source_path'] — 元 PDF の絶対パス
return $image; // 別インスタンスを返してもよい
}, 10, 2);
透過を背景色に合成し、アルファチャンネルを落とした直後、リサイズの直前に走ります。この位置である理由は 2 つあります。アルファが残っていると、内容と余白を見分ける処理が意味をなしません。そして縮小後に測ると、境界がぼやけた測定になります。
戻り値が Imagick でなければ無視され、画像はそのまま処理を続けます。リスナーが 1 つも無いときに挙動が変わってはいけないので、返り値は必ず型検査してください、ではなく、プラグイン側が型検査します。
| フック | 引数 |
|---|---|
rapls_pdf_image_creator_before_generate | $pdfId, $pdfPath |
rapls_pdf_image_creator_after_generate | $thumbnailId, $pdfId, $result |
rapls_pdf_image_creator_generation_failed | $message, $pdfId, $code, $result |
generation_failed は 1.4.0 で変わりました。すべての失敗経路で発火し（それ以前は変換エラーのときだけ）、第 3 引数に機械可読なコードが付きます。既存の 2 引数のリスナーはそのまま動きます。
コードの一覧は includes/FailureCode.php にあります。FailureCode::isPermanent() は、同じ設定でやり直しても同じ結果になるものを true で返します。ディスクが一杯（write_failed）は後で解消しますが、2 億ピクセルのページ（resource_limit）は明日も 2 億ピクセルです。
| フィルター | 用途 |
|---|---|
rapls_pdf_image_creator_engines | 変換エンジンの差し替え |
rapls_pdf_image_creator_icc_paths | ICC プロファイルの探索先 |
rapls_pdf_image_creator_color_conversion | 色変換の方式を固定する |
rapls_pdf_image_creator_policy_paths | policy.xml の探索先 |
rapls_pdf_image_creator_flatten_background | 合成する背景色 |
rapls_pdf_image_creator_hide_thumbnails_in_library | 生成画像をライブラリで隠すか |
rapls_pdf_image_creator_thumbnail_image_attributes | 出力する img の属性 |
バグ報告・機能要望は Issues までお願いします。Pull Request も歓迎です。
詳細は readme.txt をご覧ください。
Rapls（ラプルス）
フリーランス Web 開発者 / WordPress Polyglots PTE（日本語翻訳責任者）
GPL v2 or later