What is AdvSearch?¶
AdvSearch is an advanced search component for MODX Revolution. It allows search in dynamic contents (by using Zend Lucene search class), setting up of faceted search and searching in custom packages. It doesn't support the ajax functionality for the moment.
- MODX Revolution 2.0.8 or later
- PHP5 or later
- UTF-8 charset
- php multi-bytes setting ON
- Zend Search class from Zend library (See installation chapter)
- Jquery 1.5.1 (provided with AdvSearch)
AdvSearch was written by Coroico and first released on August 14th, 2011. It is loosely based on AjaxSearch for MODX Evolution by KyleJ/Coroico, minus dynamic content search based on Zend search library.
Before to run the first search with AdvSearch, you need to install the Zend Search library first. See installation chapter below.
Development and Bug Reporting¶
AdvSearch is stored and developed in GitHub, and can be found here:http://github.com/coroico/AdvSearch
Bugs can be filed here: http://github.com/coroico/AdvSearch/issues
Installation of the Zend Search class¶
Even if AdvSearch addon is fully installable through the package management, the first time you install AdvSearch you need to install the Zend Search class. This installation is done only one time and will be valid for all the following re-installation of the addon.
- go to the Zend Framework download page at http://framework.zend.com/download/latest/
- register you and download the free Zend Framework. Minimal release is enough.
- if you haven’t a folder for libraries under assets/ create a folder libraries/ under assets/
- unzip you Zend package under the assets/libraries/ folder. This should create a subdirectory named "Zend" (assets/libraries/Zend)
- in this directory only the "search" directory and the "Exception.php" files are required. You could remove all the others files and directories.
- at the end you should have only the "Search" folder and the "Exception.php" file.
AdvSearch has mainly 2 snippets - one to display a form ("AdvSearchForm") and the other to display search results ("AdvSearch"). A third snippet ("AdvSearchHelp") is used to display a help window for the presentation of the query syntax.
All the templates used by default to set up the form and display the results are provided as chunks. These chunks are installed through the package management.
Display a search form, and below it, the results:
[[!AdvSearchForm]] <h2>Results</h2> [[!AdvSearch]]
Display a Search form that sends you to a results page in Resource 82 (which has the AdvSearch call in it):