DGS Search

Introduzione

Lo script server per creare un piccolo motore di ricerca per il nostro sito, andando a scovare le informazioni all'interno delle cartelle o all'interno di un database. Veloce e facile da installare, questo prodotto viene fornito con la licenza GNU GPL 2.

Configurazione dello script

Una volta decompresso il file per l'installazione, editare il file config.php contenuto nella cartella "config".

General Options

$config['installBase'] = '/usr/local/apache/htdocs/dgssearch';
Percorso del server all'interno del quale è installato DgsSearch.

$config['searchModules'] = array('fs');
Moduli da utilizzare per i risultati della ricerca. Le opzioni disponibili sono "fs" (cioè appoggiandosi al file system) e "db" (cioè appoggiandosi ad un database).

$config['displayModules'] = array('title', 'query', 'stats', 'hr', 'nav', 'results', 'nav');
Moduli per visualizzare i risultati.

$config['language'] = 'english';
Linguaggio utilizzato dallo script. Sono disponibili "english", "german" e "spanish".

$config['fileSeparator'] = '/';
Separatore di file, per Win9x/NT/2000 mettere come valore "".

$config['header'] = 'header.php';
Nome del file che contiene il codice per l'intestazione delle pagine.

$config['footer'] = 'footer.php';
Nome del file che contiene il codice per la parte finale delle pagine.

$config['target'] = '_self';
target predefinito per quando si clicca su un link nella pagina dei risultati.

$config['fonts'] = 'Arial, Sans-Serif, Helvetica';
Font utilizzato per visualizzare la pagina dei risultati.

$config['headerColor'] = '666699';
Colore dell'intestazione nella pagina dei risultati.

$config['navColor'] = '008000';
Colore delle sezioni di navigazione nella pagina dei risultati.

$config['infoBarColor'] = '008000';
Colore delle sezione della barra delle info nella pagina dei risultati.

$config['infoBar'] = true;
Visualizza la barra delle info nella pagina dei risultati.

$config['infoBarFormat'] = '@URL@ @DASH-SIZE@ @SIZE2@ @DASH-LASTMOD@ @LASTMOD@';
Formato della barra delle info nella pagina dei risultati.

$config['dateFormat'] = 'M j, Y H:i:s';
Formato di visualizzazione della data dell'ultima modifica.

$config['results'] = 10;
Numero di risultati da visualizzare in ogni pagina.

$config['boldQuery'] = true;
Visualizza la query in grassetto.

$config['timed'] = true;
Visualizza all'utente il tempo impiegato per la ricerca.

$config['maxSearchTime'] = 25;
Tempo massimo da impiegare per una ricerca.

$config['maxSearchTime'] = 25;
Visualizza un link per la traduzione vicino ad ogni risultato.

$config['translateFrom'] = 'en_de';
La traduzione standard da eseguire.

Spiegazione delle variabili usate:

en_fr	dall'Inglese al Francese
en_de	dall'Inglese al Tedesco
en_it	dall'Inglese all'Italiano
en_pt	dall'Inglese al Portoghese
en_es	dall'Inglese allo Spagnolo
fr_en	dal Francese all'Inglese
de_en	dal Tedesco all'Inglese
it_en	dall'Italiano all'Inglese
pt_en	dal Portoghese all'Inglese
es_en	dallo Spagnolo all'Inglese
de_fr	dal Tedesco al Francese
fr_de	dal Francese al Tedesco
ru_en	dal Russo all'Inglese

$config['verifyConfig'] = true;
Verifica l'integrità del file "config".

$config['warn'] = true;
Visualizza degli avvertimenti in caso di errore.

$config['debug'] = false;
Visualizza delle informazioni aggiuntive per la fase di debugging.

$config['remoteDebug'] = false;
Utilizza il debug da remoto via browser. Leggere il file "INSTALL" per maggiori informazioni.

Configurazione dello script - II parte

Filesystem Options

Se nei moduli da utilizzare è stato scelto 'fs' leggere questa sezione.

$config['urlBase'] = 'http://www.xyz.com';
Indirizzo base del tuo sito.

$config['siteBase'] = '/usr/local/apache/htdocs';
La directory del server che corrisponde a 'urlBase'.

$config['fsBase'] = '/usr/local/apache/htdocs';
Directory del server nella quale cercare il file system.

$config['fsExclude'] = array('^.ht', '^dgssearch$');
File o directory da escludere durante la ricerca nel file system.

$config['cacheFile'] = '/tmp/dgssearch.cache';
File temporaneo per velocizzare la ricerca.

$config['cacheTTL'] = 3600;
Tempo Limite di durata del file temporaneo.

$config['maxFileSize'] = 51200;
Dimensione massima (in byte) dei file da cercare.

$config['metaDesc'] = false;
Indicizza soprattutto in base al tag META.

$config['stripTags'] = true;
In questo modo il codice PHP non verrà visualizzato durante le operazioni di ricerca.

$config['followLinks'] = true;
Nel caso in cui venga trovata la funzione SymLinks, rimanda automaticamente al link corrispondente.

$config['frameSet'] = false;
Permette la generazione automatica di un layout utilizzante i frame.

$config['exts'] = array('s?html?', 'php3?', 'txt');
Le estensioni dei file da includere nella ricerca.

$config['docExts'] = array('Pdf', 'doc', 'ps');
Estensioni dei documenti ai quali puntare al posto delle pagine HTML.

$config['descWidth'] = 80;
Larghezza per visualizzare una descrizione.

$config['descHeight'] = 2;
Altezza per visualizzare una descrizione.

$config['descEnd'] = '...';
Caratteri di chiusura di una descrizione.

Configurazione dello script - III parte

Database Options

Se nei moduli da utilizzare è stato scelto 'db' leggere questa sezione.
Attenzione! la "x" serve per utilizzare più database nei quali cercare.

Lo script non utilizza una database proprietario, ma ricerca all'interno di uno già esistente, quindi per eventuali chiarimenti o spiegazioni aggiuntive sulla configurazione del database fare riferimento al file "INSTALL".

$database[x]['type'] = 'mysql';
Tipo di database da usare, sono disponibili mysql, postgresql, mssql, ibase e odbc.

$database[x]['server'] = 'localhost';
Indirizzo del server da utilizzare.

$database[x]['port'] = 3306;
Porta di accesso al server.

$database[x]['username'] = 'username';
Nome utente di accesso al server.

$database[x]['password'] = 'password';
Password di accesso al server.

$database[x]['database'] = 'database';
Nome del database (o DNS) da utilizzare.

$database[x]['persistent'] = true;
Definisce se la connessione deve essere persistente oppure no.

$database[x]['table'] = array('art');
Nome della tabella all'interno della quale ricercare i dati.

$database[x]['tableAssoc'] = '';
Una stringa delle regole per associare i valore prelevati da più tabelle.

$database[x]['searchField'] = array('title', 'artist');
Campi all'interno dei quali cercare.

$database[x]['returnField'] = array('id', 'title', 'artist');
I campi che devono essere restituiti dalla ricerca nel database.

$database[x]['link'] = 'title is @1@';
Il link usato per i risultati.

$database[x]['url'] = 'http://www.xyz.com/bogus.php?id=@0@';
L'url usato per visualizzare i dati dal database.

$database[x]['desc'] = array('The artists name is @2@.');
La descrizione da visualizzare.

$database[x]['descWidth'] = 80;
La lunghezza della descrizione da visualizzare.

$database[x]['wildcard'] = 'both';
Tipo di utilizzo del wildcard (*) all'interno del database. Puè essere disabilitato, abilitato, essere considerato solo a sinistra o solo a destra.

$database[x]['orderByDepth'] = -1;
Qui viene settato il numero di campi da utilizzare quando vengono ordinati i risultati del database. Settare questo parametro a -1 significa utilizzare tutti i campi.

$database[x]['forceLower'] = false;
Forza una ricerca non sensibile all'utilizzo di caratteri minuscoli o maiuscoli per il termine da cercare.

Constants

Costanti dello script che contengono informazioni da NON modificare.

$config['program'] = 'DGS Search';
Nome dello script.

$config['version'] = 'v0.9.6';
Versione dello script.

$config['maxResults'] = 65535;
Numero massimo di risultati di una ricerca.

$config['extSeparator'] = '.';
Simbolo di separazione tra il nome del file e la sua estensione.

$config['thisDir'] = '.';
Simbolo per accedere alla directory corrente.

$config['parentDir'] = '..';
Simbolo per accedere alla directory superiore.

Installazione sul server

Adesso caricare tutti i file sul server, senza settare nessuna priorità particolare, e accedere all'indirizzo del tipo http://www.tuosito.it/dgssearch/index.php per testare lo script che dovrebbe essere perfettamente funzionante.

Considerazioni Finali

Sicuramente un prodotto completo che permette di allestire un motore di ricera sul proprio sito. Naturalmente i risultati devono essere pescati da un filesystem o da un database. Lo script è disponibile praticamente solo in lingua inglese, quindi per usarlo dovremmo tradurlo personalmente. L'operazione di traduzione comunque porterà via poco tempo ed alla fine avremo uno script all'altezza delle aspettative.