Come installare SQLEdit.

1. Download il pacchetto in formato sorgente qui.
   
     root@devel# wget .../SQLEdit-xx-yy-zz.tar.gz
    
2. Entra nella diretcory di root del WebGUI sul tuo server (il default è /data/WebGUI)
   
       root@devel# cd /data/WebGUI
    
3. Scompatta SQLEdit in questa directory
   
     root@devel# tar zxvf /dir/where/you/saved/SQLEdit-xx.yy.zz.tar.gz
    

   Verranno installati i seguenti file:

   • read1st-SQLEdit.txt
   • docs/SQLEdit/create.sql
   • docs/SQLEdit/create_01_pre_06_01.sql
   • docs/SQLEdit/install.txt
   • docs/SQLEdit/readme.txt
   • docs/SQLEdit/uninstall.sql
   • docs/SQLEdit/changelog/01.xx.xx.txt
   • docs/SQLEdit/changelog/06.xx.xx.txt
   • docs/SQLEdit/upgrades/upgrade_01.00.00_01.00.01.sql
   • docs/SQLEdit/upgrades/upgrade_01.00.01_01.00.02.sql
   • docs/SQLEdit/upgrades/upgrade_01.00.02_01.00.03.sql
   • docs/SQLEdit/upgrades/upgrade_01.00.03_01.00.04.sql
   • docs/SQLEdit/upgrades/upgrade_01.00.04_06.00.00.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.00_06.00.01.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.01_06.00.02.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.02_06.00.03.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.03_06.00.04.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.04_06.00.05.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.05_06.00.06.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.06_06.00.07.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.07_06.00.08.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.08_06.00.09.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.09_06.00.10.sql
   • docs/SQLEdit/upgrades/upgrade_06.00.11_06.00.12.sql
   • docs/SQLEdit/upgrades/upgrade_06.01.02_06.01.03.sql
   • docs/SQLEdit/upgrades/upgrade_06.01.03_06.01.04.sql
   • docs/SQLEdit/upgrades/upgrade_06.01.04_06.02.00.sql
   • docs/SQLEdit/upgrades/upgrade_06.02.02_06.02.03.sql
   • docs/SQLEdit/upgrades/upgrade_06.03.00_06.03.01.sql
   • docs/SQLEdit/upgrades/upgrade_06.03.02_06.03.03.sql
   • lib/WebGUI/Wobject/SQLEdit.pm
   • lib/WebGUI/i18n/English/SQLEdit.pm
   • lib/WebGUI/i18n/Italian/SQLEdit.pm
   • lib/WebGUI/Help/SQLEdit.pm
   • lib/DBIx/DBDescribe.pm
   • lib/DBIx/DBDescribe/DBD.pm
   • lib/DBIx/DBDescribe/DBD/mysql.pm
   • lib/DBIx/DBDescribe/DBD/mssql.pm

    

4. Esegui lo script SQL di installazione (cambia il nome del database mettendo al posto di WebGUI quello da te scelto)
   
     root@devel# mysql -p WebGUI < docs/SQLEdit/create.sql
    
5. Se la tua versione di WebGUI è precedente alla 06.01.xx devi eseguire anche quest'altro script

   
     root@devel# mysql -p WebGUI < docs/SQLEdit/create_01_pre_06_01.sql

6. Modifica WebGUI.conf per aggiungere il modulo SQLEdit all'interno della lista dei WObject caricati
   
     root@devel# vi /data/WebGUI/etc/WebGUI.conf
     ...
     wobjects = Article, EventsCalendar, ExtraColumn, FAQ, FileManager, \
     HttpProxy, Item, LinkList, DataForm, MessageBoard, Poll, Product, \
     SiteMap, SQLReport, Survey, SyndicatedContent, USS, WobjectProxy, \
     SQLEdit
     ...
    
7. Rilancia il web server (questo non dovrebbe essere necessario...)

Nota per la macro ^International utilizzata nel template di default.

Il template fornito di default con SQLEdit usa la macro ^International per generare alcuni pezzi di codice HTML tradotto. La macro ^Internazional è però una macro di programmazione e, di default, queste macro sono disabilitate in WebGUI. Se, per esempio, trovate la scritta ^International(62); nel pulsante di salvataggio del form invece di "Salva", allora avete questa macro disabilitata.

Per attivare il funzionamento della macro ^Internazional, aprite il file WebGUI.conf e aggiungete

International => International

alla fine della sezione macro. Se, per esempio, l'ultima riga di tale seziona appare come

u => u_companyUrl

sostituite questa con

u => u_companyUrl, \
International => International

Ovviamente potete sempre sostituire la macro ^International presente nel template con una vostra traduzione statica ma, in questo modo, andate a perdere la possibilità di vedere la pagina automaticamente tradotta in più lingue.

Come aggiornare.

1. Scompatta SQLEdit nella directory principale di WebGUI
   
       root@devel# tar zxvf /dir/where/you/saved/SQLEdit-xx.yy.zz.tar.gz
    
2. Esegui tutti gli script presenti in docs/SQLEdit/upgrades dalla tua versione attuale a quella appena installate. Considera che, da una versione ad un'altra, se non sono state fatte modifiche al database, nessuno script è disponibile. Per esempio, se tenti di aggiornare dalla versione 06.00.12 alla 06.01.01 non dovrai eseguire nessuno script. Se aggiorni dalla 06.00.12 alla 06.01.03 dovrai eseguire il solo script upgrade_06.01.02_06.01.03.sql.

Come disinstallare.

1. Eseguire lo script docs/SQLEdit/uninstall.sql sql.
2. Cancellare tutti i file presenti in read1st-SQLEdit.txt