內容簡介
WebEquipe PDF Search 可為網站中的 PDF 檔案建立索引，讓訪客透過站內搜尋同時找到文章、頁面及 PDF 內文，大幅提升網站內容的可搜尋性與資訊利用率。
【主要功能】
• 自動索引 PDF 內文並納入站內搜尋結果
• 新上傳的 PDF 可自動建立索引
• 支援排除特定 PDF，避免出現在搜尋中
• 提供專屬短代碼建立獨立 PDF 搜尋表單
• 搜尋結果可顯示圖示、檔案大小、頁數等資訊
• 可設定檔案大小上限，最高支援 500MB
外掛標籤
開發者團隊
原文外掛簡介
WebEquipe PDF Search indexes your PDF files and makes their text searchable. When visitors search your site, they see results from both your posts/pages and the content inside your PDFs. Search returns one result per PDF with an excerpt from the best-matching page.
Video
Watch the setup and usage guide:
Supported PDFs
Works with: Standard, text-based PDFs (the kind you create or export from Word, Google Docs, etc.). File size default 50MB, configurable up to 500MB in PDF Search → Settings.
Mixed PDFs: If some pages have extractable text and others are image-only, indexing succeeds with a warning; search covers the text pages only.
Does not work with: Scanned or image-only PDFs with no extractable text—they are marked Error with guidance to use a text-based PDF (run OCR elsewhere first). Password-protected PDFs cannot be indexed.
Keep Private PDFs Out of Search
Need to hide or protect certain PDFs? Use Exclude so a PDF is never indexed and never appears in search—even when you run “Re-index All PDFs” or bulk index. Excluded PDFs stay in your Media Library; they just won’t be searchable. Use Include later to allow indexing again. You can exclude or include PDFs from the Media Library or from PDF Search → Manage PDFs.
How to Use
Install and activate the plugin.
Open PDF Search in the WordPress admin sidebar (Dashboard is the home screen).
Click Re-index All PDFs on the Dashboard or PDF Search → Index Activity to index existing PDFs (new uploads are indexed automatically when Enable PDF Indexing is on).
Use your site’s search or add the shortcode [webequipe_pdf_search_form] on a page—PDFs will appear in results when Enable Search Integration is enabled.
Use PDF Search → Manage PDFs to scan the library, filter by status, and run bulk actions. Use PDF Search → Index Activity to review indexing runs, export a CSV log, or start another full re-index.
Settings at a Glance
All options are under PDF Search → Settings:
General – Enable PDF indexing on upload, include PDFs in WordPress search, maximum file size (50MB default), search result excerpt length.
Indexing options – Batch size (PDFs per re-index step), pages per batch (background page steps), page index threshold (when large PDFs switch to page-by-page indexing), max page content length (0 = unlimited; re-index after changing).
Search display options – Show or hide PDF icon, file size, page count, last updated date, author, thumbnail preview, and summary/snippet text in search results.
Advanced – Debug logging, memory limit, processing timeout, background processing, delete data on uninstall.
Full details and shortcode options: PDF Search → Help.
What You Can Do
Dashboard – Indexed PDF count, pages indexed, coverage, search health, recent activity, quick links, and Re-index All PDFs.
Full-text search – Search inside PDF content by page; one result per PDF with the best-matching excerpt.
Control each PDF – Index, unindex, exclude, or retry from the Media Library, Manage PDFs, or the attachment screen.
Bulk actions – Index, unindex, include, or exclude multiple PDFs at once (Media Library or Manage PDFs).
Index Activity – Filterable log of every indexing run, stats, and CSV export.
Search display – Configure icons, meta, previews, and excerpts in settings.
Shortcode – Add a PDF-only search form with [webequipe_pdf_search_form] (see PDF Search → Help).
Background processing – Large PDFs above the page threshold are indexed page-by-page in the background to avoid timeouts.
Troubleshooting
PDFs not appearing in search
Ensure PDFs are indexed (Media Library → “Search Indexed” column), Enable Search Integration is on, and the PDF is not excluded. Check PDF Search → Manage PDFs for Error status and use Index Activity to see why a run failed.
Indexing fails or times out
In PDF Search → Settings: enable Background Processing, review Pages Per Batch and Page Index Threshold for large files, and lower Batch Size if Re-index All PDFs stops early. Under Advanced, adjust Processing Timeout and ensure PHP memory_limit and max_execution_time are sufficient (see Help). Very large PDFs are processed in multiple page batches automatically when over the threshold.
Legacy index after upgrade
If you see a notice about migrating to per-page indexing, run Re-index All PDFs from the Dashboard or Index Activity page.
Other issues
See the FAQ above and PDF Search → Help for full documentation.
Privacy
The plugin stores extracted PDF text and metadata in custom database tables (webequipe_pdf_search_files, webequipe_pdf_search_pages, and webequipe_pdf_search_activity, with a legacy webequipe_pdf_search_index table until you re-index). A compressed backup may also be stored in WordPress post meta for PDF attachments. If debug logging is enabled, recent log entries are stored in a WordPress option (not written directly to disk). The plugin does not collect or send visitor search data to external services. If your PDFs contain personal or sensitive information, that content is in the index—mention this in your privacy policy if required.
Third-Party Libraries
smalot/pdfparser (LGPL-3.0) – PDF text extraction
symfony/polyfill-mbstring (MIT) – multibyte string support
Credits
Developed by WebEquipe. Uses smalot/pdfparser for PDF text extraction.
Support
Support: https://wordpress.org/support/plugin/webequipe-pdf-search
