While some platforms may include mnoGoSearch, it is advised that you download mnoGoSearch source code, compile  and install it. This will minimize compatibility problems between all three components of mnoGoSearch.

These instructions assume that MySQL is used as a database backend. No other backends were tested.

Download Unix source code of mnoGoSearch from its web site at http://www.mnogosearch.org/download.html. Make sure that you download at least version 3.3.3 (earlier versions may work but not supported by this document or TYPO3 extension).

Server, where mnoGoSearch is compiled, must have the following packages installed:

Later text assumes that mnoGoSearch source code is downloaded to /tmp. Unpack it using

tar xzf mnogosearch-3.3.3tar.gz

This will create a directory "mnogosearch-3.3.3" inside /tmp directory with all files in it.

Now locate file named configure.in and modify it to change value of HAVE_PGSQL from 1 to 0:

cd mnogosearch-3.3.3

mcedit configure.in

While in editor, press F7 and enter HAVE_PGSQL. Press Enter and change 1 to 0. Press F2 to save and F10 to exit editor.

Next source code must be configured for build:

./configure --prefix=/opt/mnogosearch --disable-mp3 --disable-news --without-debug --with-pgsql=no --with-freetds=no --with-oracle8=no --with-oracle8i=no --with-iodbc=no --with-unixODBC=no --with-db2=no --with-solid=no --with-openlink=no --with-easysoft=no --with-sapdb=no --with-ibase=no --with-ctlib=no --with-zlib --with-mysql

All the above should come on a single line.

Assuming that there were no errors, make and install extension:

make

make install

Now check /opt/mnogosearch directory. There should be subdirectories like bin, etc, var, sbin (may be some others).

Download PHP extension from mnoGoSearch web site at  http://www.mnogosearch.org/download.html (it is called "mnoGoSearch PHP extension module", do not be fooled by "mnoGoSearch PHP Frontend"!). Make sure that you get at least version 1.96. Earlier versions will not work.

After downloading do the following:

tar xzf mnogosearch-php-extension-1.96.tar.gz

mv 1.96 mnogosearch-php-extension-1.96

cd mnogosearch-php-extension-1.96

phpize

./configure –-with-mnogosearch=/opt/mnogosearch

This properly configures mnoGoSearch PHP extension for the current PHP version.

Next step is extremely important to get PHP extension compiled and working right. Open php_mnogo.c in text editor and add

#undef HAVE_PG

on the new line after

#include "php.h"

To make extension execute

make

Extension files will be places to "modules" subdirectory. Now you need to check your php.ini to find where PHP extensions are located (search for extension_dir there) and place mnogosearch.so from "modules" subdirectory into the directory indentified by "extension_dir".

Restart Apache and check for any error message in error log. If you find nothing realted to mnogosearch, all went fine. message

You need to create mnoGoSearch database manually. The best way is to have mnoGoSearch data in the database, which is not Typo3 database. To create such database, launch mysql commadline tool with root account or account, who can create databases and grant privileges. The following is a snapshot of Linux shell session that will create mnoGoSearch database. You, however, can use any other tool (such as your hosting's control panel) to create a new mysql database.

prompt$ mysql -u root -p mysql

Enter password: ****

> create database mnogosearch;

> grant all privileges on mnogosearch.* to 'jane'@'localhost' identified by 'janescomplexpassword';

> exit;

prompt$

The "create database" statement above creates a new database named "mnogosearch". "grant all privileges" statement grants permissions to user "jane", who connects from localhost to all tables in "mnogosearch" database. Notice use of single quotes in the last statement.

Extension is configured when installed. Most parameters have defaults but you must put several parameters manually. See section Configuration later in this document for more information.

mnoGoSearch TYPO3 extension includes two TypoScript templates. Both of them must be added to TypoScript record for proper functioning of extension. Go to Web>Template and "Info/Modify" there. Click "Edit the whole template record" and locate mnoGoSearch templates in one of the boxes on the right. Click each of them to copy them to the left box. Save record.

Now reload front end part of the web site in the browser and explorer HTML source. You should find "UdmComment" HTML comments there. You may need to log out from backend to see these comments.

There is no need to specially index the web site. As soon as cron job runs, it will take care of reindexing. It will also create necessary tables in mnoGoSearch database automatically.

Cron script should be run once a day to perform reindexing in the database. Cron script should have access to mysql and mnogosearch engine (the once installed at /opt/mnogosearch).

To install a cron script, enter the following at Linux shell prompt:

crontab -e

It will oprn and editor. If you did not configure any special editor, it will be default Limux editor (either "vi" or "vim"). Press "i" button and enter the following at the end of the file as one line:

0 3 * * * /path/to/php/php5 -q /path/to/web/site/typo3conf/mnogosearch/cli/cli_mnogosearch.phpsh -w -n &>/dev/null

Make sure to enter correct paths. This lines commands to execute CLI script every day at 03:00. You can choose any hour by alterning the second digit or create completely your own schedule. See cron Limux manual for more information.

(The content of this section is not finished yet)

mnoGoSearch engine is capable of finding word forms (i.e. "man" and "men" or "go" and "went") for various languages. TYPO3 mnoGoSearch plugin fully supports this functionality. In order to enable fuzzy search, Ispell dictionarry and affix files for languages must be installed.

(This section is to be written)

There are exported mapping for default templates. They can be imported to TYPO3. To import templates, move file named tv_exported.xml from mnogosearch/pi1/templates directory to fileadmin and use TYPO3's export/import extension to import three premapped templates.

None yet