Creare un sito dinamico

Sar-El 5.2 Creare un sito dinamico (versione del 25 settembre 2004) - 1 -

Sommario SOMMARIO... 2 PARTE PRIMA: LE SEZIONI... 6 LA STRUTTURA DELLA SEZIONE... 6 LA PAGINA MASTRO... 6 CARICAMENTO DELLA PAGINA MASTRO SUL SERVER... 7 CREAZIONE DI UNA NUOVA SEZIONE... 8 INSERIMENTO DEI DATI (PAGINE) NELLA SEZIONE... 10 I CAMPI DI TIPO "FILE"... 11 I CAMPI DI TIPO PERSONALIZZATO... 12 ALTERAZIONE DI UNA SEZIONE ESISTENTE... 14 I CAMPI PREDEFINITI DI SAR-EL... 14 UNA GRANDE SEZIONE O TANTE PICCOLE SEZIONI?... 15 LE PAGINE MASTRO ALTERNATIVE... 15 SEZIONI: RISPOSTE A DOMANDE FREQUENTI... 16 LA PAGINA HOME USA UNA PAGINA MASTRO VARIANTE... 16 NEWSLETTER... 16 THAT'S ALL FOLKS... 17 PARTE SECONDA: LE VISTE... 18 SELEZIONE E FILTRO DELLE VISTE... 18 ORDINAMENTO NELLE VISTE... 19 VISTE: ALCUNI SEMPLICI ESEMPI... 19 PER CREARE UN ELENCO ALFABETICO DI TUTTI I PRODOTTI... 19 PER CREARE UN ELENCO DI TUTTI I PRODOTTI PER DATA DI PRESENTAZIONE... 20 PER CREARE UN ELENCO DEI CINQUE PRODOTTI PIÙ NUOVI... 20 IL CODICE HTML NELLA PAGINA MASTRO... 20 PAGINE MASTRO E VISTE: ALCUNI SEMPLICI ESEMPI... 20 VISTA: ELENCO SEMPLICE... 20 VISTE: LINK ALLE PAGINE INTERNE... 21 VISTA: ELENCO NUMERATO... 21 VISTA: IN TABELLA, PER COLONNE... 21 VISTA: IN TABELLA, PER RIGHE... 22 VISTA: IN TABELLA PER RIGHE A COLORE ALTERNATO... 22 VISTE: IL MOTORE DI RICERCA... 23 COME SI CREA IL FORM DI RICERCA... 23 COME SI CREA LA PAGINA RISULTATI DELLA RICERCA... 24 QUANDO NULLA VIENE TROVATO... 24 MOTORE DI RICERCA: ALTRI ESEMPI... 25 VISTE: MODALITÀ AVANZATA... 26 VISTE DI TABELLE CORRELATE... 26 VISTE: RISPOSTE A DOMANDE FREQUENTI... 29 LA VISTA NON VIENE RISOLTA... 29 SET DI CARATTERI... 29 VISTE MULTIPLE... 29-2 -

VISTA USATA PIÙ VOLTE... 29 VISTE E AMMINISTRATORI... 30 VISTE SU PIÙ SEZIONI... 30 PARTE TERZA: I MODULI... 31 INTRODUZIONE: COSA SONO I MODULI... 31 LA PAGINA MASTRO PER IL MODULO... 32 GESTIONE DEGLI ERRORI... 33 RADIOBUTTON... 34 ONERR... 35 SELECTEDIF... 36 CHECKBOX... 36 SEZIONE MODULO IN LETTURA: IL FORUM... 37 MODULI: RISPOSTE A DOMANDE FREQUENTI... 38 CAMPI NASCOSTI... 38 CAMPI INCORPORATI DI SAR-EL E VALORI DI DEFAULT... 38 SEZIONI ACCESSIBILI IN LETTURA E SCRITTURA... 38 PARTE QUARTA: I PLUG-IN... 39 INTRODUZIONE AI PLUG-IN... 39 I PLUG-IN STANDARD... 39 PLUG-IN INTESTAZIONE... 39 PLUG-IN LOCALIZZAZIONE DATE... 40 PLUG-IN NOME DEL VISITATORE... 41 PLUG-IN ANTI-SPAM... 41 PLUG-IN PER MACROMEDIA FLASH... 42 PLUG-IN MOTORE DI RICERCA INCORPORATO... 43 I PLUG-IN DI VALIDAZIONE... 46 FUTURA... 46 PASSATA... 46 EMAIL... 46 I PLUG-IN DELLE VISTE... 46 PLUG-IN: RISPOSTE A DOMANDE FREQUENTI... 47 HTML E XHTML... 47 PARTE QUINTA: FUNZIONI AVANZATE... 48 COSTRUTTI CONDIZIONALI ALL INTERNO DELLE PAGINE MASTRO... 48 SAR-EL E GOOGLE... 49 INCLUSIONE DI FRAMMENTI HTML... 50 INDICE ANALITICO... 52-3 -

Scopo di questo manuale è spiegare con esempi concreti ai web designer come si realizza un sito dinamico usando Sar-El come sistema di gestione dei contenuti (CMS: content management system). Per la sua comprensione è richiesta la capacità di leggere il codice HTML. Si suppone che il lettore abbia già consultato l Introduzione a Sar-El. Lo schema sottostante presenta le dipendenze tra tutti i manuali di Sar-El. Il libro aperto mostra il manuale che state leggendo. Le frecce mostrano le dipendenze (la lettura dei libri più in alto è essenziale per la comprensione dei testi più avanzati in basso). - 4 -

Insieme a questo manuale sono forniti diversi materiali in formato digitale: pagine mastro HTML d'esempio, materiale pronto per l'importazione in Sar-El, eccetera. Di tanto in tanto il manuale vi farà qualche suggerimento o fornirà qualche trucco d'uso. Li trovate evidenziati in giallo, come è il caso di questo stesso paragrafo. - 5 -

Parte prima: Le sezioni La struttura della sezione Un sistema di gestione dinamico dei contenuti è utilissimo per gestire siti con moltissime pagine tutte in qualche modo simili. Immaginate di voler creare un sito web dedicato a tutti i cantanti al mondo: sarebbe impossibile per qualsiasi grafico scrivere una distinta pagina HTML per ciascuno e mantenere aggiornato un sistema del genere sarebbe un incubo. Usando Sar-El noi possiamo creare un'unica pagina HTML una pagina mastro e con quella vestire tutte le informazioni sui cantanti. Cominciamo. Immaginatevi le informazioni che volete mettere dentro al vostro sito. Per esempio, immaginiamo che, per cominciare, voi vogliate creare un sito che presenta i cantanti lirici. Di ogni cantante decidiamo di voler presentare: Nome e cognome; Data di nascita; Nazionalità; Timbro di voce; Curriculum vitae e una Fotografia. Sar-El vuole che ad ogni informazione diversa sia associato un tipo. Questo è indispensabile perché dati differenti vanno trattati in modo differente. Facciamo un esempio pratico per capire questa esigenza. Immaginate di voler presentare i cantanti lirici per data di nascita, dal più vecchio al più giovane. I cantanti sono: Aristide Pallazzi, nato il 25/11/1961 Mirella Di Panna, nata il 15/07/1964 Se Sar-El non sapesse che le date sono, appunto, date, collocherebbe prima Di Panna e poi Pallazzi. Questo accade perché in ordine alfabetico "15/07/1964" viene prima di "25/11/1961" (perché 1 viene prima di 2). I tipi predefiniti da Sar-El sono: Numero intero (per esempio 41) Numero reale (con la virgola: per esempio 3,14) Data Testo breve (sino a 255 caratteri, per esempio un cognome) Testo lungo (sino a 65.536 caratteri, per esempio una scheda prodotto) File (un documento esterno, come per esempio una lettera creata con Microsoft Word o una fotografia) Multiparole (una serie di parole separate da virgole, come per esempio una lista di ingredienti). A questi tipi si aggiungono altri tipi definiti da voi per il vostro uso, che vedremo in seguito. Sar-El vuole anche che ogni informazione abbia un nome distinto e composto solo da lettere, cifre e il trattino basso _. Nel caso dei cantanti d'opera decideremo di lavorare così: Campo Tipo Scopo nome Testo breve Nome di battesimo cognome Testo breve data_nascita Data nazione Testo breve Nazionalità di provenienza timbro bio Testo breve Testo lungo Baritono o tenore o soprano o... Curriculum vitae foto File Fotografia Armati di queste decisioni possiamo disegnare la nostra prima pagina mastro. La pagina mastro Immaginatevi le pagine del vostro sito. Disegnatele con Dreamweaver, o GoLive, o lo strumento che più vi piace. Per ora metteteci dentro informazioni false. Per esempio, se stavate pensando a una pagina dedicata al grande tenore Aristide Pallazzi, disegnatela completamente e metteteci dentro la sua foto, la sua biografia, una tabella con i suoi dischi. Usate HTML puro. - 6 -

Sentitevi liberi di progettare anche la struttura di navigazione del sito, anche se non è indispensabile a questo punto. Per esempio: voi avete in mente un motore di ricerca che elenca i timbri di voce, e quando ho scelto tenore mostra tutti i tenori, e cliccando il nome di Aristide Pallazzi va alla sua scheda. O magari un più tradizionale motore di ricerca dove scrivo il nome dell'artista e il sistema ne visualizza i dati. Potrebbe venire fuori qualche cosa di simile a questa: Il codice HTML di questa pagina d'esempio è a vostra disposizione per la consultazione. Lo trovate nella cartella "1-mockup_statico" Ora vogliamo generalizzare e trasformare questo facsimile in una vera pagina mastro. È facilissimo: ci basta entrare sulla pagina HTML e sostituire il testo d'esempio con i segnaposto. Si tratta semplicemente di utilizzare il nome breve dell'informazione (quello elencato nella colonna di sinistra della tabella poco sopra) circondato da parentesi graffe. Caricamento della pagina mastro sul server Per esempio, dove sta scritto "Aristide Palazzi" noi scriveremo {nome} {cognome}. Al posto di "tenore", sempre consultando la tabella che abbiamo creato al paragrafo precedente, scriveremo {timbro}. Attenzione a maiuscole e minuscole, che per Sar-El sono cose distinte: per semplicità consigliamo di usare ovunque solo le minuscole. Non bisogna neppure lasciare spazi bianchi dentro alle parentesi graffe. Il risultato finale, naturalmente, avrà un aspetto "sbagliato" dentro Dreamweaver, GoLive o semplicemente dentro al browser: assomiglierà a quello visto qui a sinistra. Non c'è di che preoccuparsi: la pagina visibile ai visitatori verrà composta dal motore di Sar-EL combinando questa pagina mastro con i dati che tra poco inseriremo nel programma. Probabilmente, arrivati a questo punto, avete qualche dubbio riguardo alla foto. Per adesso non preoccupatevene: ci penseremo tra qualche minuto. Una volta completata la pagina mastro, essa va caricata nel sito. Utilizzate un programma FTP, come per esempio Cute FTP per Windows oppure Interarchy per Mac OS. Se create le pagina HTML usando un programma come GoLive o Dreamweaver potete utilizzare il sistema incorporato di questi software autore. - 7 -

Collegatevi al seguente indirizzo: ftp://nome del vostro sito Vi verranno richiesti nome e parola d'ordine: utilizzate quelli che il vostro amministratore di rete ha fornito a questo scopo, oppure richiedetene di nuovi. Non è possibile collegarsi con il cosiddetto "FTP anonimo", ovvero senza inserire una parola d'ordine. Se la connessione non vi riesce, controllate di aver trascritto nome utente e password esattamente. Ricordate che le lettere minuscole e le maiuscole non sono interscambiabili! Una volta collegati, navigate vedrete la cartella che ospiterà le pagine mastro del vostro sito. Depositate una copia dei file della pagina mastro (cantanti.html, ccs_td.css e la cartella immagini: per vostra convenienza trovate tutti questi file, che naturalmente potete modificare a vostro piacimento, allegati a questo documento all'interno di "2-prima_pagina_mastro". Creazione di una nuova sezione Siamo finalmente pronti per giocare con Sar-El. Colleghiamoci al suo indirizzo (solitamente è http://nome del vostro sito/sarel/) e digitiamo il nostro nome e la nostra password. Vorremo creare una nuova sezione. Nel linguaggio di Sar-El, una sezione è lo spazio in cui inseriamo un gruppo di dati omogenei (per esempio, tutte le schede di tutti i cantanti) in modo che Sar-El realizzi una pagina web da ciascuno di essi. tabella. Clicchiamo la linguetta "Sezioni" in alto e poi il pulsante "Aggiungi sezione" in basso. Nella schermata che appare possiamo definire la sezione che desideriamo, semplicemente applicando i dati della nostra La prima schermata che ci accoglie ci chiede di dare un nome alla nostra sezione ("cantanti" va benissimo) e di selezionare una pagina mastro per essa (nel menu troveremo soltanto la pagina che abbiamo appena caricato, "cantanti.html". Se il menu "Pagina mastro" non contiene la voce "cantanti.html" verificate di aver correttamente caricato i file, come spiegato nel paragrafo precedente. Ignorate per ora le opzioni sottostanti. Ne riparleremo nel seguito del manuale. Nella seconda schermata (e nelle successive) Sar-El ci chiede di inserire, una alla volta, una descrizione di tutti i campi (i tipi di informazione che verranno memorizzati nella sezione, cioè i dati dei cantanti, come per esempio le loro date di nascita). In pratica, dobbiamo solo completare il riquadro riprodotto qui di fianco, una volta per ogni riga della tabella di pagina 6. - 8 -

La riga indicata "Uso" è riservata alle vostre note e promemoria. Può anche venire lasciata bianca. Quando arriviamo all'ultima specifica, quella della fotografia, Sar-El vorrà anche sapere quale posizione all'interno del server vada riservato alle immagini dei cantanti. Il suggerimento è di selezionare la cartella "images" (ci occuperemo nel prossimo capitolo delle peculiarità delle immagini: per adesso, questa soluzione è quella migliore possibile). Al termine, dovremmo vedere una schermata che sulla sinistra riassume tutti i campi da noi aggiunti. Possiamo concludere il processo premendo il pulsante "Crea sezione" in basso a destra. Vedremo una schermata di conferma finale (oppure, se abbiamo commesso qualche errore, un messaggio esplicativo). In questa fase, infatti, Sar-El legge la pagina HTML che abbiamo caricato e la confronta con la struttura che abbiamo definito. Se le due non sono compatibili, Sar-El ci spiega dove sta il problema e ci offre qualche suggerimento che ci aiuta a risolvere il problema. Se qualcosa non va, nel 99% dei casi significa che abbiamo dato un nome leggermente differente a un campo nella pagina mastro rispetto a quanto abbiamo fatto nella dichiarazione di nuova sezione. Per esempio, se la pagina mastro contiene il segnaposto {data_nascita} e nella sezione abbiamo inserito "datanascita" oppure Data_nascita, allora Sar-El si lamenta. Per rimediare possiamo correggere la pagina mastro, e poi ricaricarla con FTP, oppure specularmente possiamo cancellare il componente incongruente nella struttura, cliccando l'icona " al suo fianco, e poi reinserirlo usando la stessa sintassi della pagina mastro. Immediatamente o dopo qualche correzione dovremmo vedere una schermata analoga a quella riprodotta qui di seguito. Complimenti! Avete appena creato il vostro primo sito dinamico! Tra un attimo vedremo di inserirci qualche contenuto e di navigarlo. Per ora premete il pulsante "Avanti, accetta la definizione di sezione" - 9 -

Inserimento dei dati (pagine) nella sezione Il manuale utente Sar-El copre i dettagli dell'inserimento di nuove pagine. In sintesi, comunque, ecco una spiegazione. Abbiamo creato un sito dinamico, pronto per raccogliere e pubblicare le schede personali di migliaia di cantanti. Per ora, tuttavia, non abbiamo inserito nessun nome al suo interno. Sar-El, amichevolmente, ci lascia davanti a una schermata che ci invita a riempire di contenuti il sito (avremmo potuto raggiungerla noi stessi cliccando la linguetta "Pagine" in alto, ma Sar-El lo ha fatto per noi). Clicchiamo il pulsante "Aggiungi pagina": ci troviamo davanti a una scheda che possiamo compilare indicando i dati di un cantante (uno fittizio andrà benissimo). Inserite il nome del cantante nello spazio "title", ignorate i campi successivi (se ne parla nel manuale utente) e compilate tutte le righe da "nome" in giù tranne (per ora) "foto", poi cliccate il pulsante "Invia modifiche". Sar-El conferma l'inserimento e vi chiede se volete creare ulteriori pagine o se preferite provare la nuova pagina. Sentitevi liberi di impratichirvi e giocare con il sistema inserendo alcune schede su cantanti veri o immaginari. Poi premete il pulsante "Prova la nuova pagina". Dovreste vedere una schermata simile a quella qui sotto. Questa schermata, conosciuta come "testpage", è un ambiente ibrido in cui in alto trovate la barra degli strumenti Sar-El mentre in basso vedere una anteprima della pagina web come apparirà ai vostri visitatori. Se volete tornare alla visione modulare della pagina premete la freccia verso sinistra che vedete in alto a sinistra nella pagina. Se volete vedere la pagina web come la vedrebbe un utente finale del vostro sito, senza la barra degli strumenti Sar-El, premete il pulsante con l'occhio, in alto a destra. - 10 -

La caratteristica più interessante di testpage, però, è la sua capacità di lasciarvi ritoccare i contenuti del sito "al vivo". Cliccate l'icona della matitina che vedete sotto alla biografia del cantante. Apparirà una finestrella che vi permette di cambiare il testo. Tutti i cambiamenti vengono immediatamente applicati e sono in linea non appena premete il pulsante di conferma. Potete spostare la finestrella cliccando sulla barra del titolo blu e trascinando. Potete ridimensionare la finestrella in modo da vedere per intero il testo che state correggendo cliccando sull'angolo zigrinato in basso a destra mentre tenete premuto il tasto di modifica (dipende dalla vostra macchina, ma è solitamente Ctrl sui PC Windows; Maiuscole invece sugli Apple Macintosh). Il ridimensionamento della finestra di aggiornamento istantaneo purtroppo non funziona in Internet Explorer versione 5.x per Macintosh, a causa di un errore in quella versione del programma. A parte questa eccezione, la finestrella è completamente operabile su Windows, Macintosh e Linux sotto i browser Internet Explorer versione 4 e successiva; Netscape versione 4.5 e successiva; Opera versione 5 e successiva; Mozilla; Safari: Konqueror. Se in questa fase vi si presentano problemi con le vocali minuscole accentate, gli altri simboli speciali delle lingue europee (come la ñ dello spagnolo, la ç del francese, la ü del tedesco) e gli alfabeti non lativi, verificate che la vostra pagina mastro indichi esplicitamente l alfabeto corretto per la lingua prescelta. Simurg vi consiglia di utilizzare sempre per le vostre pagine mastro il plug-in incorporato {HEAD} (descritto nel seguito di questo manuale) in modo che Sar-El stesso sia responsabile per indicare correttamente il codice ASCII esteso utilizzato dalla pagina al browser dei visitatori. I campi di tipo "File" Se, nei primi esperimenti di inserimento, avete provato a caricare sul server una foto relativa, probabilmente avete incontrato un messaggio d'errore che dice "I dati della pagina sono stati salvati, ma il file allegato non è stato registrato". La scheda del cantante è stata comunque registrata ma la foto non è stata salvata. Dove sta il problema esattamente, e come lo si risolve? Quando avete copiato la cartella delle immagini sul server, insieme alla pagina mastro, il vostro programma FTP ha automaticamente creato una cartella in cui voi e soltanto voi potete aggiungere immagini. Quando Sar-El ha provato a infilare in quella cartella la foto del cantante, non ci è riuscito, perché il Sar-El non siete voi. Il server web ha rifiutato a Sar-El il permesso di scrivere qualche cosa in una cartella non sua. Per rimediare, voi (che siete i proprietari della cartella) dovete concedere a Sar-El il diritto di metterci dentro alcuni documenti. Sar-El userà questo permesso solo per spostare nella cartella i file che voi gli passate quando create o editate una pagina. Avviate il vostro programma di FTP favorito. Fate clic con il tasto destro del mouse sulla cartella delle immagini. Nel menu che appare troverete una opzione relativa alle proprietà della cartella, o ai suoi permessi, o privilegi (la forma esatta del menu dipende dallo specifico programma FTP che voi avete scelto). Nella finestra che appare, e che sarà simile a quella riportata qui sotto (l'immagine è presa da Interarchy per Macintosh), spuntate la casella che permette ad "everyone" (tutti) di scrivere ("write") nella casella. - 11 -

Non ci sono potenziali problemi di sicurezza in questo settaggio, anche se così potrebbe sembrare di primo acchito. Soltanto voi (attraverso FTP) e Sar-El potete raggiungere la cartella immagini. Se in futuro vi capiterà di visitare la cartella immagini usando FTP, scoprirete che Sar-El cambia nome ai file che avete caricato. Questo avviene perché Sar-El deve garantire il buon funzionamento del sistema anche se più persone collaborano alla medesima sezione e se caricano, indipendentemente e in buona fede, documenti differenti ma che hanno lo stesso nome sui loro personali PC. A questo punto potreste chiedervi cosa si scrive dentro la pagina mastro per far apparire in un certo punto l'immagine del cantante che abbiamo registrato nella base dati. La risposta è che per Sar-El un campo di tipo file non è diverso dagli altri. Date una occhiata allo HTML della pagina mastro (se usate Dreamweaver, cliccate l'icona marcata con il simbolo "< >"). Noterete che l'immagine fissa, la foto di Aristide Palazzi che avevamo inserito dentro al fac-simile originale, veniva definita così: <img src="images/pallazzi.jpg" alt="{nome} {cognome}"> In altre parole, lo HTML prevede che voi scriviate <IMG SRC= e poi il nome del documento con l'immagine. Per lasciare che sia Sar-El a gestire la fotografia che memorizziamo nel campo "foto" della base dati noi useremo semplicemente: <img src="{foto}" alt="{nome} {cognome}"> Se usate Dreamweaver per creare le vostre pagine web, fare attenzione. Quel programma tende a trasformare lo HTML che abbiamo appena impostato, sostituendo le parentesi graffe con i loro codici, così: <img src="%7bfoto%7d" eccetera. Quando questo accade, Sar-El non riconosce più la presenza delle parentesi graffe, non inserisce l'informazione presa dalla base dati al suo posto e la foto non appare! I campi di tipo personalizzato Se avete provato a introdurre un po' di schede di cantanti, vi sarete forse resi conto di un potenziale problema. Nel campo "timbro" è possibile scrivere qualsiasi cosa. Non soltanto "baritono" o "tenore" o "soprano", ma anche (magari per errore) "barittono". Questo può essere un problema in un sito che è destinato a contenere molte centinaia di pagine. Per rimediare, proviamo a creare un nuovo tipo di dati. Cliccate la linguetta "Sezioni" e il pulsante "Aggiungi nuova sezione". Nella prima schermata scrivete che volete creare una sezione chiamata timbri_di_voce e che si tratta di un menu. Selezionate una pagina mastro qualsiasi: non è importante. Sar-El vi presenta, pre-compilato, il modulo per l'inserimento di campi, suggerendo di crearne uno chiamato "stringa". Senza modificare nulla, cliccate il pulsante "Aggiungi" e, immediatamente di seguito, il pulsante "Crea sezione". - 12 -

Ora cliccate "Aggiungi pagina" e, nel modulo che appare, scrivete "baritono" sia alla voce "title" che alla voce "stringa". Ignorate le altre voci e cliccate "Invia modifiche". Se lo desiderate, potete creare altre "pagine" (in realtà sono solo opzioni distinti, che diventeranno voci di un menu) con la dicitura "mezzo soprano" o "basso". Qualche lettore, a questo punto della spiegazione, si sentirà un po' perso. Che cosa abbiamo fatto, esattamente? Da questo momento, il Sar-El riconosce e ci permette di utilizzare un nuovo tipo di dati che va ad aggiungersi a quelli incorporati: il tipo "timbri di voce". Quando creiamo una sezione, possiamo assegnare questo tipo ai campi che aggiungiamo. Quando viene aggiunta una pagina a una sezione che contiene dati del nuovo tipo, Sar-El fa apparire un menu a scomparsa che riporta tutte e sole le voci che noi abbiamo appena elencato. Nel nostro caso, però, si pone un problema. Noi abbiamo già creato la sezione "cantanti" e abbiamo deciso che il campo "timbro" fosse ti tipo "Breve testo" perché non sapevamo che Sar-El avesse a disposizione anche i tipi dati definiti dall'utente. Come risolvere questo problema? Non c'è bisogno di cancellare la sezione "cantanti" per ricrearla correggendo l'errore: nel prossimo paragrafo scopriremo come alterare una sezione esistente in un caso come questo. Potreste chiedervi per quale motivo Sar-El vi faccia inserire due volte ogni voce del menu, una prima volta sotto "title" e una seconda volta sotto "stringa". La spiegazione: Sar-El vi consente di creare menu in cui la voce che appare a video ("titolo") è differente dal testo che viene effettivamente inserito nella base dati e poi posizionato nella pagina visibile al visitatore ("stringa"). Un esempio in cui questa funzionalità sia utile? Immaginate di voler creare un sito web con un catalogo di prodotti di idropittura. Ogni scheda prodotto (ogni tinta) deve riportare un link alla scheda dello sverniciatore più adatto e ci sono due sverniciatori differenti. Il primo, "acetone super", è presentato alla pagina web www.tinte.it/showpage.php?template=prodotti&id=47 mentre l'altro, chiamato "sbiancante professionale ultraforte", si trova a www.tinte.it/showpage.php?template=prodotti&id=31. - 13 -

Quando noi inseriamo le schede delle vernici dovremo selezionare da menu uno dei due link, ma sarebbe difficilissimo farlo basandoci sull'indirizzo web. I n questo caso scriveremo che "title" è "acetore super" mentre invece "stringa" è www.tinte.it/showpage.php?template=prodotti&id=47. Quando introduciamo le schede delle vernici selezioneremo il nome dello sverniciatore più adatto. Nella pagina mastro potremo usare l'indirizzo e portare direttamente chi clicca alla pagina rilevante. Alterazione di una sezione esistente Le sezioni esistenti possono venire modificate. Possiamo aggiungere nuovi campi che si rendono necessari, o togliere campi esistenti che non servono più. Possiamo anche modificare la definizione dei campi esistenti. Per esempio Cliccate la linguetta "Sezioni" e nella tabella che appare cliccate il nome della sezione "cantanti" che abbiamo creato in precedenza. Nella schermata che vediamo a questo punto possiamo già fare qualche modifica: per esempio, cambiando la pagina mastro di default che avevamo prescelto creando la sezione. Il nome di una sezione esistente non può venire cambiato. Cliccate il pulsante "Modifica struttura " per intervenire sui campi. Nella tabella che appare potete distruggere un campo cliccando l'icona del cestino. Potete aggiungere un nuovo campo usando il riquadro in basso. Potete modificare un campo esistente cliccandone il nome. Per esempio, cliccate "timbro" e modificatene il tipo da "breve testo" a "timbri di voce", come nell'immagine qui di fianco. Quando cliccate il pulsante "Aggiorna", Sar-El vi avvisa se la modifica è potenzialmente distruttiva. Per esempio, cancellare un campo è sempre una modifica distruttiva perché tutte le informazioni di quel tipo in tutte le pagine esistenti vanno perse. Modificare il tipo di un campo, come stiamo facendo noi, è potenzialmente distruttivo solo in alcuni casi. Se abbiamo creato la scheda di un cantante scrivendo "falsetto" quando il campo accettava qualsiasi cosa, questa informazione viene persa se trasformiamo il campo in modo che accetti soltanto i valori di basso, baritono, tenore, contralto, mezzo soprano e soprano. I campi predefiniti di Sar-El Quando voi create una sezione, Sar-El non trova spazio soltanto per le informazioni scelte e specificate da voi: automaticamente e inevitabilmente il programma inserisce in ogni sezione i campi predefiniti, che vengono presentati per la compilazione subito prima dei vostri nel modulo di creazione nuova pagina (linguetta Pagine, pulsante Aggiungi pagina ) - 14 -

Un elenco completo dei campi predefiniti si trova nel manuale Governare il sito. L idea è che quei campi vengono compilati dagli amministratori, quindi è nel loro manuale che vengono dettagliatamente presentati. Durante la creazione delle nuove sezioni i campi predefiniti non si vedono, a meno che voi non visitiate le Preferenze di Sar-El (linguetta Informazioni, pulsante Preferenze in basso) e spuntiate la apposita casella. Una grande sezione o tante piccole sezioni? Per Sar-El, tutte le pagine dinamiche di un sito appartengono a una qualche sezione. (Un sito creato con Sar-El può tranquillamente contenere pagine statiche, realizzate con il metodo tradizionale). Quando arriva il momento di creare le sezioni, molti responsabili si pongono un dilemma: accorpare o dividere? Per esempio, se stiamo preparando il sito di un mobilificio che produce tavoli, sedie e armadi, ci conviene creare una singola sezione chiamata mobili oppure tre sezioni, una per ciascuna tipologia di prodotto? Ciascuna delle due alternative offre qualche vantaggio. I motori di ricerca forniti da Sar-El lavorano su una singola sezione per volta. Da questo punto di vista è più semplice lavorare accorpando: se un visitatore sa che abbiamo in catalogo un oggetto chiamato Alessandro Manzoni può scriverne il nome in un motore di ricerca sul sito e trovarne la scheda prodotto, anche se il visitatore non si ricorda che il prodotto è una scrivania. Viceversa, le diverse tipologie di prodotto hanno caratteristiche differenti che il visitatore potrebbe considerare discriminanti. Per esempio, quando un architetto sta cercando sedie di legno di ciliegio per il salotto, probabilmente non vuole fare una ricerca di ciliegio sul campo materiale e trovare gli armadi mischiati alle sedie. La discriminante, alla fin fine, è proprio questa. Se vogliamo fare ricerche su una delle tipologie di prodotto alla volta, lavorando su una caratteristica peculiare della tipologia (per esempio: trova tutti i tavoli a tre gambe), allora conviene creare sezioni distinte. Se invece le ricerche lavoreranno su attributi comuni a tutti i prodotti (per esempio le dimensioni) allora possiamo tranquillamente accorpare. Nel prossimo capitolo di questo manuale (nel paragrafo Viste su più sezioni ) mostreremo una tecnica che permette di combinare i risultati di ricerche parallele su più sezioni differenti, all interno di una singola pagina web. Tale tecnica consente di simulare una ricerca su più sezioni e rende più semplice il lavoro di chi ha scelto di creare sezioni distinte. Chi invece sceglie di accorpare le sezioni troverà grandi benefici dall uso delle pagine mastro alternative, o pagine varianti, che presentiamo nel prossimo paragrafo. Le pagine mastro alternative Immaginate di star preparando un catalogo prodotti per il web. Cominciate preparando una pagina mastro universale e vi accorgete che non basta. Per esempio, i tavoli sono orizzontali e richiedono una fotografia molto larga, mentre gli armadi la vogliono stretta e alta. Magari vanno mostrate due foto per i mangimi prodotti dall azienda e nessuna foto per i concimi. Oppure vogliamo un fondo color crema per le schede prodotto dei gelati e un fondo rosa per i sorbetti. In tutti questi casi risolviamo l impasse creando più pagine mastro alternative tra di loro: magari simili, ma distinte: vere e proprie varianti sul tema. Un altro caso in cui servono pagine mastro differenti è quando stiamo progettando la navigazione del sito. Immaginate di voler mostrare un elenco di tutti i film recensiti da una rivista online: cliccando il titolo della pellicola vedremo la pagina web che presenta il giudizio del recensore. Sia l elenco che la scheda film sono pagine mastro della sezione film, ma ovviamente sono molto differenti. E se poi consentiamo al visitatore di cercare e trovare tutti i film con regista Peckinpah, anche in questo caso avremo bisogno di una distinta pagina mastro per la sezione film, il cui testo comincerà con Abbiamo trovato sei film il cui regista è Peckinpah. C è una differenza importante tra il primo e il secondo caso. Nel primo caso sarà il redattore del sito (chi crea nuove pagine web e le mette in linea) a selezionare la pagina mastro variante da applicare. Per esempio, quando inserisco la scheda prodotto di un sorbetto istruisco il Sar-El in modo che appaia sempre usando una pagina mastro con fondo rosa. Vediamo innanzitutto come impostare le cose in modo che questo sia possibile. - 15 -

Preparate la pagina mastro alternativa (tipicamente, rielaborando quella base) e caricatela sul server web (tipicamente, usando FTP). Entrate nel Sar-El e cliccate la linguetta Sezioni. Sulla riga della sezione che ci interessa, cliccate l icona delle pagine mastro alternative:. Appare una schermata che elenca tutte le pagine mastro abilitate per questa sezione (la prima volta che visitate questa schermata, l elenco sarà vuoto). Selezionate dall elenco Aggiungi pagina mastro alternativa il file HTML che avete appena creato e cliccate il pulsante Aggiungi. Sar-El esegue un controllo di coerenza, analogo a quello che era stato fatto per la pagina mastro principale quando è stata creata la sezione. Da questo istante, quando un amministratore di sezione modifica o aggiunge una nuova pagina in questa sezione, ha l opzione di indicare che quella pagina di aprirà nel contesto grafico variante. Passiamo al secondo caso: stiamo creando una pagina mastro alternativa che verrà utilizzata come parte integrante della navigazione, per esempio per mostrare i risultati di una ricerca, oppure un elenco delle altre pagine della sezione. Di solito, queste pagine mastro alternative contengono Viste, un argomento che affronteremo nel prossimo capitolo. La creazione della pagina variante avviene come nel caso precedente, e così anche il suo caricamento via FTP. Ne regoliamo però l apparizione lavorando sulla URL, usando il parametro aggiuntivo masterpage. Immaginate di aver preparato una pagina mastro chiamata elenco.html che mostra il titolo di tutte le pagine della sezione articoli. Per leggere l articolo numero 101 scriviamo nel browser l indirizzo http://il.nostro.sito/showpage.php?template=articoli&id=101 Per guardare invece l elenco l indirizzo sarà: http://il.nostro.sito/showpage.php?template=articoli&id=101&masterpage=elenco.ht ml Le pagine mastro alternative di questo tipo vengono spesso raggiunte quando il visitatore compila un modulo HTML per effettuare una ricerca. In questo caso il parametro masterpage viene passato dentro al modulo. Si usa un parametro input di tipo hidden nello HTML, così: <input type= hidden name= masterpage value= opinioni.html /> Trovate numerosi esempi di utilizzi di questo tipo nel prossimo capitolo Sezioni: risposte a domande frequenti La pagina home usa una pagina mastro variante La pagina homedel mio sito, una rivista on-line, mostra i tre articoli aggiunti più di recente al sito. Tecnicamente, è una pagina mastro alternativa della sezione articoli. La vedo perfettamente se uso questo indirizzo nel browser: http://www.ilsito.it/showpage.php?template=articoli&masterpage=home.html Però io voglio che questa pagina venga presentata ai visitatori che accedono per la prima volta al sito, scrivendo: http://www.ilsito.it/ Come mi comporto? Crea un file di testo chiamato index.php e incolla al suo interno questa riga di codice: <?php header("location: showpage.php?template=articoli&masterpage=home.htm");?> Carica il file sul tuo server. Questa soluzione è dimostrata nel sito esemplificativo che accompagna questo manuale e che trovate nella cartella 4-sito_designer Newsletter Vorrei estrarre dalla base dati Sar-El tutte le novità dell ultima settimana, formattarle e spedirle per posta elettronica nella forma di una newsletter a chi si abbona al servizio. Mi rendo conto che Sar-El non può fare tutto questo per me, ma vorrei sapere sino a che punto può aiutarmi. La procedura Sar-El che genera una pagina e la invia al browser si chiama showpage; tutte le volte che noi guardiamo una pagina sintetizzata da Sar-El combinando pagina mastro e contenuto della base dati - 16 -

il suo indirizzo infatti comincia con showpage.php?template= eccetera. Esiste un programma fratello chiamato savepage, che possiamo utilizzare per registrare gli impaginati. savepage lavora come showpage, ma anziché inviare il risultato al browser lo registra in un documento sul server. Potremo recuperarlo usando FTP, con lo stesso meccanismo e i medesimi parametri che usiamo per inviare le pagine mastro, oppure darlo in pasto a un programma di newsletter che gira sul server. Facciamo un esempio, per maggior chiarezza. Questo indirizzo ci fa vedere dentro Internet Explorer una pagina del nostro sito: http://www.demo.it/showpage.php?id=101&template=canzoni Questo indirizzo, invece, ordina al Sar-El di registrare sul disco rigido del server una copia della pagina HTML: http://www.demo.it/savepage.php?id=101&template=canzoni La pagina verrà registrata sotto il nome canzoni1.html. Se questo nome non ci sta bene, possiamo cambiarlo aggiungendo una istruzione in più, savename: http://www.demo.it/savepage.php?id=101&template=canzoni&savename=qualsiasicosa.htm In quest ultimo caso, il documento generato sul server si chiamerà qualsiasicosa.htm. That's all folks Questo conclude la nostra prima passeggiata esplorativa dentro Sar-El. Prima di passare al secondo capitolo, dove vedremo come realizzare i motori di ricerca e come strutturare le pagine indice, vi suggeriamo di passare un po' di tempo a riguardare le funzionalità Sar-El che abbiamo presentato qui. Provate a creare una nuova sezione e a popolarla. Modificate il contenuto sia nella modalità a moduli sia nella modalità al vivo. - 17 -

Parte seconda: le viste Creando una vista, noi possiamo costruire un elenco, (cioè un punto di vista da cui il nome), di dati depositati dentro al nostro sistema. Se abbiamo un catalogo di cinquemila prodotti, per esempio, possiamo creare una vista sui prodotti che costano meno di dieci Euro, e inserirla in una pagina web. Anche quando l assortimento di prodotti a catalogo o il prezzo di listino cambiano noi non dobbiamo preoccuparci: quella pagina mostrerà sempre e soltanto i prodotti che in un dato istante costano meno di dieci Euro. Il criterio di inclusione in una vista può essere semplicissimo, come nell esempio poco sopra, o più complicato. Possiamo chiedere di inserire in una vista tutte le pagine modificate nell ultimo mese, oppure le schede del personale il cui cognome comincia con le lettere A-L, oppure gli articoli il cui titolo contiene la parola novità. Se il nostro catalogo a stampa contiene una sezione ultime notizie, possiamo creare una vista che le include tutte e ci siamo così procurati un efficiente indice dell intera sezione. Una vista è una regola di selezione, che noi definiamo e a cui diamo un nome. Per esempio, la vista «prodotti che costano meno di dieci Euro» ci cui parlavamo sopra. Sar-El registra la vista e la utilizza (esegue la selezione) quando la trova riferita dentro una pagina mastro. Per creare una vista noi clicchiamo la linguetta Viste in alto, premiamo il pulsante Aggiungi vista e compiliamo il modulo che appare. In alto dobbiamo specificare il nome della vista (possiamo scrivere qualsiasi cosa si tratta in effetti di un commento, un promemoria a nostro vantaggio, che Sar-El registrerà a nostro vantaggio ma che non utilizzerà). Di seguito scriviamo la etichetta della vista. In questo caso, invece, si tratta di una singola parola (deve contenere soltanto lettere, numeri e il carattere =_ ). La etichetta della Vista verrà usata per chiedere al Sar-El di eseguire la selezione. Ogni volta che Sar-El trova l etichetta dentro una pagina del nostro sito web, la selezione viene eseguita e il risultato appare nella pagina, formattato come noi desideriamo. Selezione e filtro delle viste Nel modulo di definizione delle viste troviamo le regole di selezione e filtro. Questo è il riquadro più importante da compilare. - 18 -

Il caso più semplice e più comune è il primo: la Vista non è filtrata. In questo caso, Sar-El restituisce tutti gli elementi della sezione. Per esempio, se vogliamo creare un indice dei nostri prodotti allora creiamo una vista non filtrata che restituisce un elenco di tutti i record (tutte le pagine) della sezione prodotti. La voce verranno presentate contemporaneamente informazioni da non più di record in questo caso va lasciata in bianco oppure (è lo stesso) va scritto il numero zero, che Sar-El in questo caso prende nel senso di nessun limite. Immaginiamo di voler trovare solo i prodotti che costano meno di dieci Euro. In questo caso selezioneremo il pulsante filtra e mostra solo i record in cui il prezzo è inferiore q. Subito sotto, selezioneremo il pulsante il valore e digiteremo 10 Le opzioni id del record corrente e valore scelto dal visitatore si usano in casi speciali, che presentiamo nel seguito di questo capitolo: le relazioni e i motori di ricerca, rispettivamente. Ordinamento nelle viste Le viste restituiscono i loro risultati in un ordine specificato da noi. Questa sezione è piuttosto intuitiva e non richiede particolari spiegazioni. Vediamo piuttosto qualche esempio pratico di Viste reali. Viste: alcuni semplici esempi In questo paragrafo immaginiamo di aver creato una sezione catalogo prodotti e di voler preparare un indice, per la home page, usando le Viste di Sar-El. Presentiamo qui tre casi molto frequenti: si veda oltre il paragrafo le viste: uso avanzato per altri esempi. Per creare un elenco alfabetico di tutti i prodotti La vista non è filtrata e mostra tutti i record della sezione prodotti. Verranno presentate contemporaneamente informazioni da non più di 0 record. Mostra i record ordinati per titolo. Presenta i risultati in ordine ascendente A-Z - 19 -

La opzione verranno presentate contemporaneamente informazioni da in questo caso va lasciata in bianco oppure (è lo stesso) va scritto il numero zero, che Sar-El in questo caso prende nel senso di nessun limite. Per creare un elenco di tutti i prodotti per data di presentazione La vista non è filtrata e mostra tutti i record della sezione prodotti. Verranno presentate contemporaneamente informazioni da non più di 0 record. Mostra i record ordinati per data di creazione. Presenta i risultati in ordine discendente dic-gen Un caso analogo al precedente, ma qui usiamo l ordinamento discendente (da dicembre a gennaio, cioè i più recenti per primi). Ordinando per data di creazione mostriamo per primi i record (le pagine) inserite più di recente. Se invece ordinassimo per data di aggiornamento allora apparirebbero per primi i record (le pagine) che abbiamo ritoccato poco tempo fa. Per creare un elenco dei cinque prodotti più nuovi La vista non è filtrata e mostra tutti i record della sezione prodotti. Verranno presentate contemporaneamente informazioni da non più di 5 record. Mostra i record ordinati per data di creazione. Presenta i risultati in ordine discendente dic-gen Un caso identico al precedente, ma qui mettiamo all opera l opzione verranno presentate contemporaneamente informazioni da Il codice HTML nella pagina mastro Come dicevamo, Sar-El registra le nostre impostazioni nella sua base dati e le esegue tutte le volte che trova l etichetta della Vista in una pagina mastro. La definizione della Vista decide quali e quanti record appariranno nel contesto della pagina mastro. Ma come decidiamo cosa deve apparire in grassetto e cosa in corsivo? E come stabiliamo se, di ogni record, deve apparire solo il titolo oppure tutte le informazioni (i campi) che abbiamo a disposizione in base dati? Tutto questo avviene durante la creazione della pagina mastro. Il richiamo di una vista avviene in Sar-El usando la sintassi {BEGIN etichetta} {END etichetta}. Tutto ciò che si trova tra BEGIN ed END viene ripetuto una volta per ogni record trovato. Pagine mastro e viste: alcuni semplici esempi Per esempio, immaginiamo di aver creato una sezione prodotti che contiene questi tre record: Immaginiamo anche di aver creato una vista con etichetta elenco_prodotti che li trova tutti e li lista in ordine alfabetico. Vista: elenco semplice Per avere un elenco nella mia pagina home io scrivo: {BEGIN elenco_prodotti} {title}<br /> {END elenco_prodotti} Il risultato HTML (che viene inviato al visitatore) sarà: Biscotti al cioccolato<br /> Torta al cioccolato<br /> Yogurt al cioccolato<br /> - 20 -

Il risultato a video sarà semplicemente: Biscotti al cioccolato Torta al cioccolato Yogurt al cioccolato Viste: link alle pagine interne Immaginiamo che di ciascun prodotto esiste una ampia descrizione. Vogliamo allora che, quando il visitatore clicca il nome del prodotto, venga mandato alla scheda del prodotto. Se abbiamo impostato correttamente le cose, la scheda del prodotto Yogurt al cioccolato (prodotto numero 102 nella sezione prodotti ) avrà per indirizzo: showpage.php?template=prodotti&id=102 Per avere un elenco linkato nella mia pagina home io scrivo: {BEGIN elenco_prodotti} <a href= showpage.php?template=prodotti&id={id} >{title}</a> {END elenco_prodotti} Il risultato HTML (che viene inviato al visitatore) sarà: <a href= showpage.php?template=prodotti&id=103 >Biscotti al cioccolato</a> <a href= showpage.php?template=prodotti&id=101 >Torta al cioccolato</a> <a href= showpage.php?template=prodotti&id=102 >Yogurt al cioccolato</a> Vista: elenco numerato Per avere un elenco numerato nella mia pagina home io scrivo: <ol> {BEGIN elenco_prodotti} <li>{title}</li> {END elenco_prodotti} </ol> Il risultato HTML (che viene inviato al browser) sarà: <ol> <li>biscotti al cioccolato</li> <li>torta al cioccolato</li> <li>yogurt al cioccolato</li> </ol> Il risultato a video sarà semplicemente: 1. Biscotti al cioccolato 2. Torta al cioccolato 3. Yogurt al cioccolato Vista: in tabella, per colonne Per impaginare all interno di una tabella il risultato di una vista posso scrivere: <table border= 1 > <tr> {BEGIN elenco_prodotti} <td>{title}</td> {END elenco_prodotti} </tr> </table> Il risultato HTML (che viene inviato al browser) sarà: <table border= 1 > <tr> <td>biscotti al cioccolato</td> <td>torta al cioccolato</td> <td>yogurt al cioccolato</td> </tr> </table> Il risultato a video sarà semplicemente: - 21 -

Biscotti al cioccolato Torta al cioccolato Yogurt al cioccolato Vista: in tabella, per righe Per impaginare all interno di una tabella il risultato di una vista posso scrivere: <table border= 1 > {BEGIN elenco_prodotti} <tr><td>{title}</td><td>{prezzo}</td></tr> {END elenco_prodotti} </table> Il risultato HTML (che viene inviato al browser) sarà: <table border= 1 > <tr><td>biscotti al cioccolato</td><td>3.25</td></tr> <tr><td>torta al cioccolato</td><td>20</td></tr> <tr><td>yogurt al cioccolato</td><td>1.5</td></tr> </table> Il risultato a video sarà semplicemente: Biscotti al cioccolato 3.25 Torta al cioccolato 20 Yogurt al cioccolato 1.5 Vista: in tabella per righe a colore alternato Sar-El riconosce la necessità di creare tabelle visivamente aggraziate e leggibili usando il meccanismo delle Viste. Per questo motivo Sar-El definisce automaticamente uno pseudo-campo chiamato sarelviews_row e gli assegna alternativamente il valore odd e even (rispettivamente nelle righe dispari e pari). In combinazione con un semplice foglio stile, questo permette di ottenere righe a sfondo alternato. <style type="text/css" title="righe alternate" media="all"> td.odd { background-color: #CCFFFF; } td.even { background-color: #0099FF; } </style> <table border= 1 > {BEGIN elenco_prodotti} <tr> <td class='{sarelviews_row}'> {title} </td> <td class='{sarelviews_row}'> {prezzo} </td> </tr> {END elenco_prodotti} </table> Il risultato HTML (che viene inviato al browser) sarà: <table border= 1 > <tr> <td class='odd'>biscotti al cioccolato</td> <td class='odd'>3.25</td> </tr> <tr> <td class='even'>torta al cioccolato</td> <td class='even'>20</td> </tr> <tr> <td class='odd'>yogurt al cioccolato</td> <td class='odd'>1.5</td> </tr> </table> Il risultato a video sarà: - 22 -

Biscotti al cioccolato 3.25 Torta al cioccolato 20 Yogurt al cioccolato 1.5 Viste: il motore di ricerca Il meccanismo delle Viste si utilizza anche per creare semplici motori di ricerca interni al sito. (Per un motore di ricerca avanzato si veda plug in motore di ricerca incorporato nell ultimo capitolo del manuale Sar-El). Le viste utilizzate come motore di ricerca sono quelle in cui specifichiamo mostra solo i record in cui (regola di ricerca) è uguale a valore scelto dal visitatore. Facciamo un esempio pratico. Creiamo una nuova Vista. Le diamo un nome a piacere e per etichetta scegliamo motore_ricerca. Impostiamo la Vista perché selezioni i soli record il cui titolo contiene un valore scelto dal visitatore, che la pagina HTML passerà nel parametro search. Perché il motore di ricerca abbia senso dovremo preparare due pagine HTML. La prima pagina (form di ricerca) permette al visitatore di scrivere il testo che vuole cercare e può avere un aspetto di questo tipo: La seconda pagina mostra i risultati della ricerca, impaginati a nostro piacere, usando la Vista. Come si crea il form di ricerca Il form di ricerca è un comune form (o modulo ) HTML che chiama Sar-El a eseguire la ricerca. La modalità di invio è indifferentemente POST o GET (Sar-El supporta entrambe). Il modulo deve necessariamente passare a Sar-El le seguenti informazioni : - 23 -

Nome Obbligatorio? Usi e note template Sì Come sempre quando chiamiamo Sar-El dobbiamo specificare la sezione che fornisce il contesto. Se nella pagina risultati della ricerca mostriamo esclusivamente i risultati della ricerca, questo parametro può avere un valore qualsiasi, ma il valore deve essere fornito e deve essere valido (il nome di una sezione esistente). Se nella pagina risultati della ricerca mostriamo anche altro (per esempio, la scheda del nostro prodotto di punta, il numero 250, crema al cioccolato ) allora passeremo la sezione che ci interessa (per esempio, prodotti ). id No Se nella pagina risultati della ricerca mostriamo esclusivamente i risultati della ricerca, questo parametro può venire omesso. Se nella pagina risultati della ricerca mostriamo anche altro (per esempio, la scheda del prodotto numero 250, crema al cioccolato ) allora passeremo il numero caratteristico che ci interessa (per esempio, 250). masterpage Sì Nome della pagina risultati della ricerca. search Sì È il valore da cercare Vediamo un esempio di form di ricerca in HTML: <form action="showpage.php" method="post"> <input type="hidden" name="template" value="prodotti" /> <input type="hidden" name="masterpage" value="trova.html" /> <input type="text" name="search" size="30" /> </form> Come si crea la pagina risultati della ricerca La pagina con il risultato si impagina esattamente come una qualsiasi pagina mastro che contiene una Vista. (Vedere il paragrafo Viste e pagine mastro: alcuni semplici esempi sopra). Per proseguire nel semplice esempio visto sin qui, se nella pagina risultati della ricerca che io chiamo trova.html inserisco questo codice HTML: {BEGIN motore_ricerca } {title}<br /> {END motore_ricerca} e se il visitatore cerca cioccolato, allora il risultato HTML (che viene inviato al browser) sarà: Biscotti al cioccolato<br /> Torta al cioccolato<br /> Yogurt al cioccolato<br /> Se il visitatore cerca invece biscotti allora il risultato HTML (che viene inviato al browser) sarà: Biscotti al cioccolato<br /> Quando nulla viene trovato In una pagina risultati della ricerca molto semplice, come quella proposta qui sopra, quando il visitatore cerca un testo che non esiste, allora appare una pagina bianca. Una soluzione più elegante si ottiene utilizzando il meccanismo se allora..altrimenti introdotto in Sar-El versione 5.1. Ecco un esempio dimostrativo: {IF motore_ricerca} <p>elenco dei prodotti il cui nome contiene la parola <i>{search}</i>:</p> {BEGIN motore_ricerca} <p>{title}</p> {END motore_ricerca} {ELSE motore_ricerca} <p>spiacente, nessun prodotto contiene la parola <i>{search}</i> nel nome.</p> {ENDIF motore_ricerca} Se il visitatore cerca biscotti allora il risultato HTML sarà: <p>elenco dei prodotti il cui nome contiene la parola <i>biscotti</i>:</p> <p>biscotti al cioccolato</p> - 24 -