Elementi di contenuto speciale

In precedenza avete visto elementi di contenuto generale. Dunque sapete come funzionano. In questa sezione vi presento qualche esempio di elemento di contenuto speciale che è però assolutamente familiare. Per esempio come creare un form di e-mail? Oppure un box di ricerca per cercare nel contenuto del sito? E un guest-book? Continuate a leggere e vedrete. 

Form di e-mail

Abbiamo già un box di e-mail sul sito. Se andate alla pagina “Contact” vedrete questo form: 

 

Nel backend l’elemento del contenuto che genera questo form nel modulo Pagina assomiglia a questo: 

 

A proposito, notate la pagina “Thank you” che è una sotto-pagina della pagina “Contatti”! 

Ora, modificate l’elemento. Questo è il form che vedrete: 

 

Il contenuto è apparentemente ancora più “stile-codice” dell’elemento di contenuto di tipo “Tabella”! Ma come al solito - cliccate sull’icona dell’assistente e potete modificare il contenuto con uno strumento più comodo! 

 

Come potete vedere i codici sono trasformati in una gradevole finestra. Qui ciascun campo è creato attraverso comandi visuali. Per un campo dovete chiaramente inserire un valore e un tipo di campo (#2). Queste sono le parti visibili. Dovete anche assegnare un nome interno (#3) al campo, questo nome è quello che si vedrà nell’e-mail del destinatario. Nel caso di “campi di inserimento” potete definire un valore di default (#4).

Per tutti i forms di e-mail vi sono tre valori da configurare: il nome del pulsante d’invio (#5), l’oggetto dell’e-mail inviata (#6) e infine l’indirizzo elettronico della persona che deve ricevere l’e-mail (#7). Questa persona siete normalmente voi o chiunque del vostro gruppo risponda a queste richieste. 

Aggiunta di una lista di selezione 

Ora aggiungiamo una lista di selezione da cui si possa scegliere un articolo da ricevere. In “FC Bigfeet” abbiamo dei calendari, la rivista del club e le matite che inviamo alle persone.  

Scegliete semplicemente il tipo “Selector box”: 

 

Cliccate allora sul pulsante “Aggiorna senza salvare” (che non salva il contenuto – lo invia solo e ricrea il form!).

 

Inserite queste informazioni: 

 

L’etichetta è evidente (#1). Il nome del campo “item_to_send” (#2) non è visibile sulla pagina web, ma come detto prima - è il nome che il destinatario dell’e-mail vedrà per identificare questa selezione! Infine ogni valore che volete nel box di selezione è un inserimento di linea nel campo di testo (#3), semplicemente. Salvate il contenuto dell’assistente e ottenete questa pagina: 

 

Veramente facile! 

Qualche nota 

Ora nel backend la nuova lista di selezione è stata aggiunta nelle linee di codice nel campo “Configurazione”: 

Se siete curiosi provate a guardare la linea e potrete comprendere la sintassi di creazione dei campi dei forms senza l’assistente: 

 

Se perdete la pazienza potete cercare aiuto nel documento TSref dove una sezione prova a descrivere i dettagli. Ma sappiate che è di un livello molto elevato e tecnico!

Un’altra cosa importante è “Jump to page”  - questo campo dice semplicemente a TYPO3 verso quale pagina dirigere l’utente dopo aver inviato il form.

 

In altre parole - quando l’utente ha riempito il form e ha premuto il pulsante “Invia form!” vedrà questa pagina che contiene... un elemento di contenuto di pagina ordinario con questo messaggio: 

 

Davvero molto semplice - vero? E molto flessibile. 

Risoluzione di problemi 

Su servers Windows vi sono forti probabilità che la funzione di posta elettronica non vada. Se quando inviate il form ottenete un messaggio d’errore di PHP allora non avete probabilmente dei server SMPT o qualunque altra cosa permetta a PHP di inviare la posta. Su UNIX questo funziona normalmente. 

Box di ricerca

Il progetto seguente è di implementare un form di ricerca. È ancora più facile e lo si è già creato nella pagina “Search”: 

 

L’elemento stesso è estremamente semplice: 

 

La sola caratteristica è di avere il tipo “Ricerca”, poiché il campo “Vai alla pagina” non è utilizzato. Funziona nella stessa maniera che per il form di e-mail  - restituisce la pagina quando riceve la richiesta di ricerca (questa deve contenere un altro elemento di contenuto “Ricerca” per mostrare i risultati). Se esso non è definito, è la pagina attuale che sarà presa in considerazione, la qual cosa è assolutamente normale per i form di ricerca.

Come effettuare una ricerca 

Cercando la parola “risultato”, vengono presentate due pagine: 

 

 

 

Provate a cliccare il titolo “Report results”: 

 

Siete allora ridiretti verso la pagina e le parole cercate sono colorate in rosso... Carino no? 

Ricerca indicizzata? 

L’elemento di ricerca di default che voi utilizzate qui cerca direttamente nella pagina e nei records degli elementi di contenuto di pagina. È abbastanza efficace per molti piccoli siti web. 

Se ne avete bisogno, esiste anche una ricerca professionale indicizzata. Infatti potete ottenere tutte le funzioni per cui è stata scritta un’estensione (la vedremo più avanti). Per il momento potete provare http://typo3.org come esempio di quello che TYPO3 offre come motore di ricerca indicizzato:

 

Il risultato sarà una cosa del tipo: 

 

Notate che i risultati sono organizzati in sezioni e sono ordinati in base alla loro percentuale di pertinenza. 

L’estensione che fa tutto ciò si chiama “indexed_search” ed il manuale con tutte le informazioni si trova qui.

Guest book

Anche il guest book è una cosa molto semplice da aggiungere. Tuttavia guest book, message board, modulo di news, ecc. sono generalmente disponibili come estensioni. Le estensioni vanno installate prima di essere utilizzate. È possibile che fallisca lo scaricamento dall’archivio online, TER (TYPO3 Extension Repository), se esse ancora non disponibili sul server. 

Per installare un’estensione come il guest book basta semplicemente andare nell’Extension Manager (EM) e cliccare sull’icona aggiungi: 

 

Nella vista “Loaded extensions” potete vedere la lista delle estensioni installate: 

 

Inserimento del Guest book in una pagina 

Come con il form di e-mail e il form di ricerca, un guest book - come normalmente ogni applicazione web (chiamata “plug-in” nella terminologia TYPO3) - è inserito sotto forma di elemento di contenuto di pagina che agisce come uno spazio riservato a questa funzione:

 

Il tipo “Insert plug-in” è il selettore principale e il tipo secondario “Plugin” è utilizzato per determinare il tipo di plug-in. Le opzioni riflettono le estensioni installate: 

 

Abbiamo già un guest book generale - Ora ne creeremo uno per le pagine della sezione “Team pages” che esigono un’autenticazione con user e password: 

Andate sul modulo Pagina, cliccate sul titolo di pagina “Team pages” nell’albero delle pagine e poi su “Nuova pagina”: 

 

Inserite un titolo per la pagina: 

 

Salvate e uscite. A questo punto create il contenuto di pagina: 

 

Scegliete il plugin “Guest book”: 

 

Ed ora, indovinate come è facile inserire notizie e message boards... :-) 

Salvate il form e ottenete: 

 

Notate il campo “CODE” - esso contiene qualche istruzione che fa apparire il guest book - una buona ragione per utilizzare l’assistente “Nuovo contenuto” per inserire l’elemento da cui esso preconfigura queste istruzioni! 

Certamente potete inserire un titolo e altri elementi - ma la funzione principale è l’inserimento di questo elemento: 

 

Voilà! Il guest book è disponibile e utilizzabile. 

 

Dov’è memorizzato il contenuto del guest book? 

Se volete gestire il vostro guest book, eliminare per esempio gli inserimenti non seri come il mio sopra, andate nel modulo Pagina e poi su quella guest book. Vedrete tutti gli iscritti del guest book e in più dei normali elementi di contenuto di pagina: 

 

Curiosi di sapere come modificarli? Cliccate sull’icona del guest book: 

 

È lo stesso principio del message board (come noi l’utilizziamo). Ma non tutti i plugin elencano i loro elementi nel modulo Pagina. In pratica, noi dovremmo generalmente utilizzare il modulo Lista per la gestione degli elementi se vogliamo disporre di un approccio comune: 

 

Questo ci porta dunque all’aspetto principale: anche gli inserimenti del guest book sono, in TYPO3, elementi di database come le pagine, i contenuti, gli utenti, ecc.; possiamo modificarli, nasconderli, eliminarli e copiarli/incollarli con il gioco già noto degli strumenti di sistema.

Mapppa del sito

Non passerei molto tempo sull’inserimento della mappa del sito poiché conoscete già il principio. Un elemento di contenuto di un certo tipo con qualche parametro complementare applicato: 

 

Notate il campo “Starting point” (Punto di partenza) - che determina la pagina a partire dalla quale la mappa del sito è generata! Nello stesso modo, altri tipi utilizzano questo campo. Al posto della mappa del sito potete anche inserire delle “Liste di links” basate sulla struttura e sui contenuti delle pagine: 

 

Siete invitati a testare tutto ciò ora. Ricordatevi che l’aiuto è sempre a portata di mano: 

 

Il plugin delle news

Il plugin delle news utilizzato sul sito è generato dell’estensione “mininews”. Assicuratevi dunque che sia installato (Extension Manager): 

 

Dopo averlo installato possiamo esaminare com’è stato utilizzato. La differenza importante con il guest book è che il plugin delle “mininews” è inserito sulla prima pagina e alla pagina delle notizie (archivi + vista di dettaglio). La prima pagina del sito mostra gli ultimi tre messaggi: 

 

Cliccando su “[more ...]” l’utente è indirizzato verso la pagina “News” dove gli viene mostrato il testo dettagliato: 

 

Gli elementi di contenuto nel backend 

In prima pagina troverete questo elemento di contenuto alla base della pagina se guardate la pagina con il modulo Pagina: 

 

Il contenuto è: 

 

Notate innanzitutto che il campo specifico per questo tipo di contenuto “Listing mode” è configurato a “Frontpage teaser”, che corrisponde alla pubblicazione dei riassunti e non degli articoli completi.  Secondariamente il campo “Starting point” (Punto di partenza) è utilizzato per indicare la pagina in cui si trovano gli archivi, quella che mostrerà il testo dettagliato!

Sulla pagina “News” è inserito un elemento simile! Solo il campo “Listing mode” è diverso: 

 

E dove è memorizzato l’elemento delle notizie? 

Ripensate al guest book: gli elementi delle news sono come gli altri elementi di database di TYPO3. Il miglior modo di ottenere una vista d’insieme completa degli elementi trovati su una pagina è di utilizzare il modulo Lista. Vediamo: 

 

E come si fa per modificarne uno? 

 

 

E per crearne uno nuovo? 

 

 

 

 

Le videate parlano da sole... 

Workflow di notizie 

E se desidero che un’altra persona scriva degli articoli di news per me, se voglio controllare gli articoli di news prima che siano pubblicati, TYPO3 può farlo? 

È una situazione che si chiama “workflow”. Più avanti in questo tutorial descriveremo esattamente la semplice situazione di cui abbiamo bisogno in questo caso. 

Getting Started -

 

7 / 15