Istruzioni tecniche
In taNGOnet 2.0 è possibile inserire nei post, feed rss e tweets, utilizzando i widget, dei contenitori di informazioni costruiti in siti esterni e aggiunti poi negli articoli.
Per fare questo utilizzeremo il plugin Custom field shortcode ed i campi personalizzati. Questi ultimi li possiamo trovare come widget nelle schermate di editor dei post; se non sono presenti, sarà necessario abilitarli cliccando su “impostazioni schermo” in alto a destra accanto alla voce “aiuto”.
Vediamo in seguito come procedere:
Inserire feed rss widget negli articoli
Per costruire un feed rss widget ci appoggeremo al sito surfing-waves che offre un ottimo servizio. Questa breve guida fornirà informazioni necessarie per creare un buon widget per taNGOnet che rispetti la grafica, i colori e il font del blog e che abbia buone caratteristiche di lettura.
Scelta la fonte da cui prendere le notizie copiamo il link nella text box del campo “Add feeds”(figura 1). Possiamo inserire più fonti feed rss nello stesso widget fino ad un massimo di cinque.
Nelle voci general setting scegliamo la dimensione in pixel della finestra widget (figura 2). Accanto sulla destra ci sarà una piccola anteprima da dove possiamo vedere in tempo reale gli effetti delle nostre modifiche. Disabilitiamo l’autoscroll, in quanto risulta fastidioso quando nel widget sono presenti molti feed rss, e abilitiamo la scroll bar laterale. I feed rss linkeranno alle notizie originali, quindi selezioniamo che queste vengano aperte in una nuova scheda del browser per evitare di perdere la navigazione sul portale. Infine selezioniamo come font per le notizie il carattere Arial con dimensione 11 pixel.
Nella voce main title selezioniamo come colore dell’header del widget il colore esadecimale #CC0000, per attenerci al colore del tema di taNGOnet.
Ora possiamo vedere nell’anteprima (figura 3) il nostro widget; copiamo il codice javascript generato dal box sottostante.
Andiamo ora a creare un articolo. Nella schermata dell’editor, nel widget dei campi personalizzati clicchiamo su “aggiungi nuovo”; nella voce “valore” inseriamo il codice javascript, mentre nel campo “nome” assegnamo un nome significativo al widget appena creato. Ora sarà sufficiente inserire nell’articolo nel punto in cui desideriamo la stringa che richiamerà il corrispettivo contenuto del campo personalizzato per far apparire il feed rss widget nel post.
E’ possibile però che la grandezza della finestra del widget non ci soddisfi; non dobbiamo necessariamente ricostruirlo da capo ma possiamo manualmente intervenire sul codice contenuto nel campo personalizzato per riadattarlo.
Inserire tweet widget nel blog
Per inserire un tweet widget nei post sarà necessario avere un account twitter perché impiegheremo le liste di twitter come fonti per il nostro widget.Dal nostro account aggiungiamo come following gli utenti di cui vorremo inserire i tweet nel widget. Ora potremo creare una lista contente un solo utente se vogliamo costruire un widget con una sola fonte mentre creeremo una lista con più utenti se vogliamo costruire un widget con più fonti.
Twitter offre una serie di risorse e strumenti gratuiti tra cui anche un costruttore widget. Selezionando la voce “Widget per il mio sito web” è possibile scegliere la tipologia di widget da costruire; nel nostro caso costruiremo un widget con liste. Alla voce “Impostazioni” (figura 1) inseriremo il nome del nostro profilo twitter. Cliccando su “trova liste” verranno caricate le liste del nostro account; proseguiamo inserendo il titolo del widget e la didascalia.
Nella sezione “Preferenze” (figura 2) possiamo scegliere alcune opzioni di visualizzazione; i widget inseriti in taNGOnet seguono questa configurazione ma è possibile personalizzarli a piacimento:
- Aggiornamento automatico dei risultati;
- Barra di scorrimento laterale;
- Mostra i risultati tutti insieme
- Numero massimo di tweet da visualizzare;
- Mostra avatar, data/ora ed etichette.
Nella sezione “Aspetto” possiamo invece scegliere i colori del widget; anche in questo caso sceglieremo un colore che richiami il tema del portale taNGOnet quindi alla voce sfondo e link inseriremo il colore esadecimale #CC0000. Infine nell’ultima sezione, “Dimensioni”, possiamo scegliere le dimensioni del widget in pixel.
Ora il widget è pronto ed è possibile vederlo nell’anteprima (figura 3). Cliccate su “Termina e ottieni codice” e copiate il codice javacript.
Andiamo ora a creare un articolo. Nella schermata dell’editor, nel widget dei campi personalizzati clicchiamo su “aggiungi nuovo”; nella voce “valore” inseriamo il codice javascript, mentre nel campo “nome” assegnamo un nome significativo al widget appena creato. Ora sarà sufficiente inserire nell’articolo nel punto in cui desideriamo la stringa che richiamerà il corrispettivo contenuto del campo personalizzato per far apparire il tweet widget nel post.
E’ possibile però che la grandezza della finestra del widget non ci soddisfi; non dobbiamo necessariamente ricostruirlo da capo ma possiamo manualmente intervenire sul codice contenuto nel campo personalizzato per riadattarlo.
Per costruire un nuovo tweet widget non è necessario ripetere le operazioni precedenti, sarà sufficiente utilizzare la struttura campione di un tweet widget già esistente e modificare la parte di codice contenuta nel campo personalizzato che fa riferimento al nome del profilo a cui prelevare le liste, e il nome della lista a cui sono associati i diversi utenti di quello specifico profilo come mostrato di seguito:
.render().setList(‘twitter_user_name’, ‘list_name’).start();
