|
Variabili di modulo.
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.
con_add()
Funzione utilizzata per aggiungere un contatto al database.
Parametro d'input:
$con_den - Denominazione
$con_ind - Indirizzo
$con_cap - Cap
$con_cit - Città
$con_pro - Provincia
$con_codnaz - Codice nazione
$con_ema - Email
$con_uid - Username
$con_pwd - Password
Ritorno:
Controlla re la variabile globale $g_error per eventuali errori. Se
la variabile è vuota, l'operazione ha avuto successo.
Esempio:
$con_den = 'Mario Rossi';
// assegna la denominazione
con_add();
// aggiunge il contatto
con_delete()
Funzione utilizzata per cancellare un contatto dal database.
Parametro d'input:
$con_cod - Il codice del
contatto da cancellare
Ritorno:
Nessuno ritorno.
Esempio:
$con_cod = '124';
// assegna il codice contatto da cancellare
con_delete(); //
cancella il contatto dal database
con_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 = con_field('codice'); //
ritorna il codice
con_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:
con_form('indirizzo'); //
crea campo di larghezza uguale a quella del database
con_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:
con_html('<a
href="scm.php?cod={codice}">codice</a>'); //
ritorna la stringa '<a
href="scm.php?cod=2301">codice</a>
con_list()
Funzione che esegue un'interrogazione sulla tabella del database ed
inizializza l'archivio per essere visualizzato in una tabella html.
Parametro d'input:
$con_where - Parametro where
della query SQL (leggere manuale SQL)
$con_order - Parametro order
della query SQL (leggere manuale SQL)
Ritorno:
$bof_con - Se il database è
vuoto viene impostato a 1
$eof_con - Se il database è
vuoto viene impostato a 1
Esempio:
con_list();
// effettua l'interrogazione dell'archivio
con_login()
Funzione che controlla il login per vedere se esistono i parametri
d'input nel database dei contatti.
Parametro d'input:
$con_uid - Username
$con_pwd - Password
Ritorno:
Nessuno ritorno. Genera un campo form.
Esempio:
$con_uid = 'pippo';
// assegna la username
$con_pwd = 'pluto'; //
assegna la password
con_login();
// controlla la correttezza del login
con_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
$con_where - Parametro where
della query SQL (leggere manuale SQL)
$con_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="con_cod">
<option
selected value="">Qualsiasi</option>
<script language="php">con_options('23');</script>
</select>
// aggiunge le altre <option> selezionando
quella con valore = '23002'
con_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 con_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:
$con_pagpre('conlist.php',
'<< pagina precedente', ' ')'; //
prepara un link alla pagina precedente visualizzando il testo $yestext se
esistono dei records altrimenti il testo contenuto in $notext
con_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 con_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:
$con_pagsuc('conlist.php',
'pagina successiva >>', ' ')'; //
prepara un link alla pagina successiva visualizzando il testo $yestext se
esistono dei records altrimenti il testo contenuto in $notext
con_read()
Funzione che legge un determinato record dal database.
Parametro d'input:
$con_cod - Contiene il
codice della chiave da leggere
Ritorno:
$bof_con - Se la lettura non
va a buon fine viene impostato a 1
$eof_con - Se la lettura non va
a buon fine viene impostato a 1
Esempio:
$con_cod = 5;
// impostazione parametro d'input
con_read();
// effettua la lettura
con_readnext()
Funzione che legge il record successivo di una lista. Da utilizzare
solo dopo aver inizializzato una lista con il comando con_list()
Parametro d'input:
Ritorno:
$eof_con - Se la lettura va
oltre la fine dell'archivio viene impostato a 1
Esempio:
$con_readnext()'; //
legge il record successivo
con_scheda()
Funzione utilizzata per avviare automaticamente, a seconda del
contenuto del parametro d'input, altre funzioni di gestione del
database.
Parametro d'input:
$con_add - Con un qualsiasi
carattere avvia la funzione con_add()
$con_upd - Con un qualsiasi
carattere avvia la funzione con_update()
$con_del - Con un qualsiasi
carattere avvia la funzione con_delete()
$con_addupd - Con un qualsiasi carattere avvia la funzione con_add()
e poi con_update()
Ritorno:
Nessuno ritorno. Avvia la funzione prescelta..
Esempio:
$con_add = 'si'; //
assegna un valore al parametro
con_scheda(); //
avvia la funzione con_add()
con_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:
con_show('codice');
// visualizza il codice
con_update()
Funzione utilizzata per aggiornare un contatto nel database.
Parametro d'input:
$con_cod - Variabile globale
che contiene il codice contatto da aggiornare. Obbligatoria
$con_den - Denominazione
$con_ind - Indirizzo
$con_cap - Cap
$con_cit - Città
$con_pro - Provincia
$con_codnaz - Codice nazione
$con_ema - Email
$con_uid - Username
$con_pwd - Password
Ritorno:
Nessuno ritorno.
Esempio:
$con_cod = '12'; //
assegna il codice contatto
$con_ind = 'Via Colle Novo, 24'; //
assegna l'indirizzo
con_update(); //
aggiorna il contatto nel database
| 
