teppokoivula/search-engine-pdf-indexer

Optional and experimental PDF file indexing add-on for the ProcessWire CMS/CMF module SearchEngine

0.0.4 2022-07-18 18:12 UTC

Requires

• php: >=7.4
• smalot/pdfparser: ^2.2
• spatie/pdf-to-text: ^1.52
• symfony/process: ^5.0
• wireframe-framework/processwire-composer-installer: ^1.0.0

MPL-2.0

• Teppo Koivula

• module
• processwire

README

This module adds (experimental) PDF indexing support for the SearchEngine module.

Please note that in order to parse PDF files, we need to install some third party dependencies. Currently two PDF parsing libraries are supported: smalot/pdfparser and spatie/pdf-to-text. These are automatically installed along with this module when you install it via Composer, but if you install the module via file upload or using the modules manager in admin, please run composer install in the directory of the module after installing it.

Note also that spatie/pdf-to-text requires the pdftotext CLI tool, which needs to be installed on your OS. Please check out the spatie/pdf-to-text GitHub repository at https://github.com/spatie/pdf-to-text for more details.

Usage

WARNING: this module is currently considered highly experimental. There's a good chance that installing it will cause fatal errors on your site. Please backup your data before installing the module and/or enabling it. If you run into any problems, please open a GitHub issue at https://github.com/teppokoivula/SearchEnginePdfIndexer/issues/new.

1. Install and configure SearchEngine
2. Install SearchEnginePdfIndexer, preferably via Composer (composer require teppokoivula/search-engine-pdf-indexer)
3. If you installed SearchEnginePdfIndexer via modules manager or file upload, run composer install in the directory of the module
4. Configure SearchEnginePdfIndexer

Installing

This module can be installed by downloading or cloning the SearchEnginePdfIndexer directory into the /site/modules/ directory of your site, but the recommended method installign it using Composer: composer require teppokoivula/search-engine-pdf-indexer. Composer installation takes care of dependencies automatically, which makes following steps easier.

License

This project is licensed under the Mozilla Public License Version 2.0. For licensing of any third party dependencies that this module interfaces with, see their respective README or LICENSE files.