pringuin / pimcore-lucene-search
Pimcore 10.x Website Indexer (powered by Zend Search Lucene)
Installs: 522
Dependents: 0
Suggesters: 0
Security: 0
Stars: 4
Watchers: 1
Forks: 20
Open Issues: 1
Type:pimcore-bundle
Requires
- ocramius/package-versions: ^2.3
- pimcore/pimcore: ^11.0.0
- vdb/php-spider: ^0.6
- zf1/zend-search-lucene: ~1.12
This package is auto-updated.
Last update: 2024-10-19 16:49:26 UTC
README
Note
This is a fork of the original dachcom-digital/pimcore-lucene-search repository. Dachcom did not update this bundle for Pimcore X in favor of the Dynamic Search Bundle
This includes changes by yosoDev and beheist, thanks a lot!
Requirements
- Pimcore >= 11
Pimcore 10
Use the version 3.X for Pimcore 10
Pimcore 5/6
Get the Pimcore 5/6 Version here.
Pimcore 4
Get the Pimcore4 Version here.
Installation
- Add code below to your
composer.json
- Activate & install it through the ExtensionManager
"require" : { "pringuin/pimcore-lucene-search" : "~4.0.0" }
Configuration
To enable LuceneSearch, add those lines to your AppBundle/Resources/config/pimcore/config.yml
:
lucene_search: enabled: true
A complete setup could look like this:
lucene_search: enabled: true fuzzy_search_results: false search_suggestion: true seeds: - 'http://your-domain.dev' filter: valid_links: - '@^http://your-domain.dev.*@i' view: max_per_page: 10 crawler: content_max_size: 4 content_start_indicator: '<!-- main-content -->' content_end_indicator: '<!-- /main-content -->'
You need to add the config parameter to your config.yml to override the default values. Execute this command to get some information about all the config elements of LuceneSearch:
# configuration about all config parameters $ bin/console config:dump-reference LuceneSearchBundle # configuration info about the "fuzzy_search_results" parameter $ bin/console config:dump-reference LuceneSearchBundle fuzzy_search_results
We also added a detailed documentation about all possible config values.
Features
- Maintenance driven indexing
- Auto Complete
- Restricted Documents & Usergroups (member plugin recommended but not required)
Usage
Default
The crawler Engine will start automatically every night by default. Please check that the pimcore default maintenance script is properly installed.
Command Line Command
If you want to start the crawler manually, use this command:
$ php bin/console lucenesearch:crawl -f -v
Logs
You'll find some logs from the last crawl in your backend (at the bottom on the LuceneSearch settings page). Of course you'll also find some logs in your var/logs
folder.
Note: please enable the debug mode in pimcore settings to get all types of logs.
Further Information
- Categories: Learn more about category based crawling / searching.
- Custom Header: Learn how to add custom headers to the crawler request (like a auth token).
- Restrictions: Learn more about restricted crawling / indexing.
- Custom Meta Content: Learn more about crawling / searching custom meta.
- Crawler Events: Hook into crawler process to add custom fields to index.
- Lucene Document Modification: Remove or change availability of lucene documents within a pimcore update/deletion event.
- Frontend Implementation: Get a step by step walkthrough to implement lucene search into your website.
Copyright and license
Copyright: DACHCOM.DIGITAL
For licensing details please visit LICENSE.md
Upgrade Info
Before updating, please check our upgrade notes!