Questo modulo ha delle variabili globali che possono essere assegnate prima dell'inclusione del modulo stesso. L'assegnazione permette di eseguire delle funzioni prima di qualsiasi istruzione html.

Queste variabili sono:

$formop - Può contenere i seguenti valori: 'login' o 'scheda'. Il primo esegue automaticamente la funzione login ed il secondo la funzione scheda.

Per esempio, e' possibile chiamare la pagina html passando come parametro queste variabili:

<a href="pagina.php?formop=scheda>aggiorna</a>

In questo caso, prima della visualizzazione della pagina html, viene eseguita l'istruzione scheda.

cli_add()

Funzione utilizzata per aggiungere un cliente al database.

Parametro d'input:

$cli_den - Denominazione
$cli_ind - Indirizzo
$cli_cap - Cap
$cli_cit - Città
$cli_pro - Provincia
$cli_codnaz - Codice nazione
$cli_cfi - Codice Fiscale
$cli_piv - Partita Iva
$cli_codsel - Codice selezione
$cli_codpag - Codice pagamento
$cli_codban - Codice banca
$cli_dden - denominazione destinazione
$cli_dind - Indirizzo destinazione
$cli_dcap - Cap destinazione
$cli_dcit - Città destinazione
$cli_dpro - Provincia destinazione
$cli_dcodnaz - Codice nazione destinazione
$cli_ema - Email
$cli_uid - Username
$cli_pwd - Password

Ritorno:

Controlla re la variabile globale $g_error per eventuali errori. Se la variabile è vuota, l'operazione ha avuto successo.

Esempio:

$cli_den = 'Mario Rossi';   // assegna la denominazione
cli_add();                  // aggiunge il cliente al database

cli_delete()

Funzione utilizzata per cancellare un cliente dal database.

Parametro d'input:

$g_codcli - Il codice del cliente da cancellare

Ritorno:

Nessuno ritorno.

Esempio:

$g_codcli = '1024';   // assegna il codice cliente da cancellare
cli_delete();         // cancella il cliente da database

cli_field($field, $type = 'str')

Funzione che restituisce il valore di un determinato campo dell'archivio.

Parametro d'input:

$field - Nome del campo dell'archivio. Fare riferimento all'appendice A.
$type - Tipo di visualizzazione. Quelli supportati sono:

'qua' - per campo quantità. Aggiunge la virgola e i decimali
'val' - per campo lire.
'eur' - per campo euro. Aggiunge la virgola e i decimali
'str' - non apporta nessuna variazione al campo

Ritorno:

valore - Il valore del campo sia numerico che stringa

Esempio:

$cod = cli_field('codice'); // ritorna il codice

cli_form($field)

Funzione che visualizza un campo in una form html.

Parametro d'input:

$field - Il nome del campo del database da visualizzare. Se è stata precedentemente effettuata una lettura dell'archivio, il campo viene riempito col valore letto, altrimenti viene presentato vuoto.

Ritorno:

Nessuno ritorno. Genera un campo form.

Esempio:

cli_form('indirizzo');    // crea campo di larghezza uguale a quella del database

cli_html($str)

Funzione che restituisce una stringa composta dal codice html ed il valore dei campi richiesti. I campi posti all'interno di $str devono essere racchiusi da { e }.

Parametro d'input:

$str - Stringa contenente il codice html ed i campi racchiusi tra { e}.

Ritorno:

string - Una stringa html con i campi convertiti in valori

Esempio:

cli_html('<a href="scm.php?cod={codice}">codice</a>'); // ritorna la stringa '<a href="scm.php?cod=2301">codice</a>

cli_list()

Funzione che esegue un'interrogazione sulla tabella del database ed inizializza l'archivio per essere visualizzato in una tabella html.

Parametro d'input:

$cli_where - Parametro where della query SQL (leggere manuale SQL)
$cli_order - Parametro order della query SQL (leggere manuale SQL)

Ritorno:

$bof_cli - Se il database è vuoto viene impostato a 1
$eof_cli - Se il database è vuoto viene impostato a 1

Esempio:

cli_list();              // effettua l'interrogazione dell'archivio

cli_login()

Funzione che controlla il login per vedere se esistono i parametri d'input nel database dei clienti.

Parametro d'input:

$cli_uid - Username
$cli_pwd - Password

Ritorno:

Nessuno ritorno. Genera un campo form.

Esempio:

$cli_uid = 'pippo';   // assegna la username
$cli_pwd = 'pluto';   // assegna la password
cli_login();          // controlla la correttezza del login

cli_options($default = '')

La funzione riempie un'option box di un form html con tutti i records. Per preselezionare un valore specifico, impostate il parametro $default.

Parametro d'input:

$default - Contiene il valore di un "value" dell'option box da selezionare
$cli_where - Parametro where della query SQL (leggere manuale SQL)
$cli_order - Parametro order della query SQL (leggere manuale SQL)

Ritorno:

Nessuno ritorno. viene generata un'option box in un form html.

Esempio:

<select size="1" name="cli_cod">
    <option selected value="">Qualsiasi</option>
    <script language="php">cli_options('23002');</script>
</select>
// aggiunge le altre <option> selezionando quella con valore = '23002'

cli_pagpre($link, $yestext, $notext)

Funzione che prepara un link html per procedere alla pagina precedente di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando cli_list()

Parametro d'input:

$link - Nome della pagina html che viene caricata dopo il click sul link.
$yestext - Testo visualizzato per link se esistono altri records.
$notext - Testo visualizzato per link se non esistono altri records.

Ritorno:

Nessuno. Crea il link html per la pagina precedente di una lista

Esempio:

$cli_pagpre('clilist.php', '<< pagina precedente', '&nbsp;')';   // prepara un link alla pagina precedente visualizzando il testo $yestext se esistono dei records altrimenti il testo contenuto in $notext

cli_pagsuc($link, $yestext, $notext)

Funzione che prepara un link html per procedere alla pagina successiva di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando cli_list()

Parametro d'input:

$link - Nome della pagina html che viene caricata dopo il click sul link.
$yestext - Testo visualizzato per link se esistono altri records.
$notext - Testo visualizzato per link se non esistono altri records.

Ritorno:

Nessuno. Crea il link html per la pagina successiva di una lista

Esempio:

$cli_pagsuc('clilist.php', 'pagina successiva >>', '&nbsp;')';   // prepara un link alla pagina successiva visualizzando il testo $yestext se esistono dei records altrimenti il testo contenuto in $notext

cli_read()

Funzione che legge un determinato record dal database.

Parametro d'input:

$cli_cod - Contiene il codice della chiave da leggere

Ritorno:

$bof_cli - Se la lettura non va a buon fine viene impostato a 1
$eof_cli - Se la lettura non va a buon fine viene impostato a 1

Esempio:

$cli_cod = 5;         // impostazione parametro d'input
cli_read();           // effettua la lettura

cli_readnext()

Funzione che legge il record successivo di una lista. Da utilizzare solo dopo aver inizializzato una lista con il comando cli_list()

Parametro d'input:

Ritorno:

$eof_cli - Se la lettura va oltre la fine dell'archivio viene impostato a 1

Esempio:

$cli_readnext()';   // legge il record successivo

cli_scheda()

Funzione utilizzata per avviare automaticamente, a seconda del contenuto del parametro d'input, altre funzioni di gestione del database.

Parametro d'input:

$cli_add - Con un qualsiasi carattere avvia la funzione cli_add()
$cli_upd - Con un qualsiasi carattere avvia la funzione cli_update()
$cli_del - Con un qualsiasi carattere avvia la funzione cli_delete()
$cli_addupd - Con un qualsiasi carattere avvia la funzione cli_add() e poi cli_update()

Ritorno:

Nessuno ritorno. Avvia la funzione prescelta..

Esempio:

$cli_add = 'si';   // assegna un valore al parametro
cli_scheda();      // avvia la funzione cli_add()

cli_show($field, $type = 'str')

La funzione serve per visualizzare il contenuto di un campo del database. Contiene dei parametri d'input che aiutano la formattazione del campi numerici.

Parametro d'input:

$field - Nome del campo da visualizzare (fare riferimento all'appendice A)
$type - Tipo di visualizzazione. Quelli supportati sono:

'qua' - per campo quantità. Aggiunge la virgola e i decimali
'val' - per campo lire.
'eur' - per campo euro. Aggiunge la virgola e i decimali
'str' - non apporta nessuna variazione al campo

Ritorno:

Nessuno ritorno. Il campo viene visualizzato.

Esempio:

cli_show('codice');           // visualizza il codice

cli_update()

Funzione utilizzata per aggiornare un cliente nel database.

Parametro d'input:

$g_codcli - Variabile globale che contiene il codice cliente da aggiornare. Obbligatoria

$cli_den - Denominazione
$cli_ind - Indirizzo
$cli_cap - Cap
$cli_cit - Città
$cli_pro - Provincia
$cli_codnaz - Codice nazione
$cli_cfi - Codice Fiscale
$cli_piv - Partita Iva
$cli_codsel - Codice selezione
$cli_codpag - Codice pagamento
$cli_codban - Codice banca
$cli_dden - Denominazione destinazione
$cli_dind - Indirizzo destinazione
$cli_dcap - Cap destinazione
$cli_dcit - Città destinazione
$cli_dpro - Provincia destinazione
$cli_dcodnaz - Codice nazione destinazione
$cli_ema - Email
$cli_uid - Username
$cli_pwd - Password

Ritorno:

Nessuno ritorno.

Esempio:

$g_codcli = '12';   // assegna il codice cliente
$cli_ind = 'Via Colle Novo, 24';   // assegna l'indirizzo
cli_update();       // aggiorna il cliente nel database