SpagoLab
Il laboratorio di 2Spaghi nasce dall'esigenza di condividere con voi tutti i nuovi progetti che stiamo realizzando. Condividere significa anche rendervi partecipi, un pò come acccade adesso per le SpagoIdee.
SpagoWidget - Documentazione
La documentazione ti guida Step by Step all'uso degli SpagoWidget di 2spaghi.
Indice
- A chi si rivolge questa documentazione
- Introduzione
- Formato dei Widget
- Esempi di Widget
- Widget per visualizzare una lista di tags
- Widget per visualizzare una lista di ristoranti
- Contatti e riferimenti
- Domande frequenti
A chi si rivolge questa documentazione
questa documentazione si rivolge a tutti i possessori di siti web o blog ma anche a sviluppatori con competenze di scripting, HTML, PHP, ASP, JSP, .NET, JavaScript, Visual Basic e, più in generale, a tutti i linguaggi orientati agli oggetti (OOP).
Introduzione
All'interno della documentazione troverete tutte le informazioni utili per portare i contenuti di 2Sapghi sul vostro sito web o blog. Tramite semplici esempi potrete capire come creare e personalizzare i contenuti da esportare.
Formato dei Widget
I widget attualmente disponibili consentono di ottenere, o una lista di tags o una lista di ristoranti. In entrambi i casi il risultato sarà un codice XHTML valido che assumerà l'aspetto dato dal vostro CSS. Il codice XHTML generato dai widget conterrà uno o più TAG tra quelli riportati nella Tabella 1.
Tabella 1
| Tag | Descrizione |
|---|---|
| <div><div> | Marca un contenitore logico in un documento (nessun valore semantico) |
| <h1>...<h6> | Marcano i titoti di diverso livello d'importante gerarchica da h1 a h6 (heading 1 to 6) |
| <p></p> | Marca un paragrafo (paragraph) |
| <span></span> | Marca una sezione in un documento (nessun valore semantico) |
| <ul></ul> | Marca una lista non ordinata (unordered list) |
| <li></li> | Marca i singoli elementi di una lista (list item) |
Esempi di Widget
Di seguito sono illustrati alcuni esempi già pronti all'uso per iniziare subito ad usare gli SpagoWidget.
Widget per visualizzare una lista di tags
Per personalizzare i tags da visualizzare sono disponibili diversi parametri che, usati singolarmente o in combinazione tra loro, fanno da filtro sul risultato. I parametri e la loro descrizione sono riportati nella Tabella 2.
Tabella 2
| Parametro | Valore | Tipo | Descrizione |
|---|---|---|---|
| mode | alltags, mytags | stringa | Il parametro mode accetta due valori, alltags e mytags. Il valore alltags mostra tutti i tags principali presenti su 2Spaghi. Il valore mytags va usato in combinazione con il parametro user e mostra solo i tags inseriti dall' user indicato. |
| user | Username es: user=username |
stringa | Il parametro user in combinazione con mytags restringe la visualizzazione dei tags mostrando solo quelli inseriti dall'utente specificato. |
| dv | nome città es: dv=milano |
stringa | Il parametro dv mostra i tags dei ristoranti di una specifica città. Il parametro dv ha la precedenza sui parametri prov e reg. Per una città composte da due o più parole è preferibile usare la seguente sintassi es: "cinisello+balsamo". |
| prov | sigla provincia es: prov=ag |
stringa | Il parametro prov mostra i tags dei ristoranti di una specifica provincia (sigla) Il parametro prov ha la precedenza sul parametro reg. |
| reg | nome regione es: reg=sicilia |
stringa | Il parametro reg mostra i tags dei ristoranti di una specifica regione. I nomi di regione devono essere indicati per esteso es: "friuli+venezia+giulia". |
| etnia | es: etnia=cinese es: etnia=all |
stringa | Il parametro etnia restringe la visualizzazione dei tags ai soli ristoranti di una determinata etnia. Con etnia=all si visualizzano tutti i tags di ristoranti etnici. |
| qt | 1/50 es: qt=50 |
numerico | Il parametro qt indica quanti tags devono essere visualizzati, è trasversale per tutti i tipi di mode ed accetta valori numerici da 1 a 50. |
| title | es: title="SpagoTags" | stringa | Il parametro title consente di personalizzare il titolo del box. Il valore predefinito è SpagoTags. Per un titolo composto da due o più parole è preferibile usare la seguente sintassi es: "I+Miei+Tags". |
Per inserire i tags di 2Spaghi sul tuo sito web o blog copia il codice di uno qualsiasi degli esempi seguenti e incollalo dove desideri che vengano visualizzati.
Esempio: "mode=alltags"
Verranno visualizzati tutti i tags più popolati.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=alltags&qt=50"></script>
Visualizza un esempio online - esempio 1
Esempio: "mode=alltags" e "dv=milano"
Verranno visualizzati tutti i tags più popolati dei ristoranti di milano.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=alltags&dv=milano&qt=5"></script>
Visualizza un esempio online - esempio 2
Esempio: "mode=alltags" e "prov=sa"
Verranno visualizzati tutti i tags più popolati dei ristoranti della provincia di Salerno (SA).
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=alltags&prov=sa&qt=5"></script>
Visualizza un esempio online - esempio 3
Esempio: "mode=alltags" e "reg=sicilia"
Verranno visualizzati tutti i tags più popolati dei ristoranti della regione Sicilia.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=alltags&reg=sicilia&qt=5"></script>
Visualizza un esempio online - esempio 4
Esempio: "mode=alltags" e "reg=sicilia" e "etnia=cinese"
Verranno visualizzati tutti i tags più popolati dei ristoranti Cinesi della regione Sicilia.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=alltags&reg=lombardia&etnia=cinese&qt=5"></script>
Visualizza un esempio online - esempio 5
Esempio: "mode=mytags" e "user=flander"
Verranno visualizzati tutti i tags inseriti da flander, che soffre di manie di protagonismo ;-)
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=mytags&user=flander&qt=5"></script>
Visualizza un esempio online - esempio 6
Esempio: "mode=mytags" e "user=flander" e "etnia=giapponese"
Verranno visualizzati tutti i tags inseriti da flander, sempre protagonista.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=mytags&user=flander&etnia=giapponese&qt=5"></script>
Visualizza un esempio online - esempio 7
Widget per visualizzare una lista di ristoranti
Per personalizzare la lista di ristoranti da visualizzare sono disponibili diversi parametri che, usati singolarmente o in combinazione tra loro, fanno da filtro sul risultato. I parametri e la loro descrizione sono riportati nella Tabella 3.
Tabella 3
| Parametro | Valore | Tipo | Descrizione |
|---|---|---|---|
| mode | ristoranti, preferiti, commentati, votati, taggati | stringa | Il parametro mode accetta cinque valori ristoranti, preferiti, commentati, votati e taggati. Il valore ristoranti mostra una lista di ristoranti generica. Il valore preferiti in combinazione con il parametro user mostra i ristoranti preferiti dell'utente specificato. Il valore commentati mostra gli ultimi ristoranti commentati, di conseguenza il valore votati mostra gli ultimi ristoranti votati cosi come il valore taggati mostra gli ultimi ristoranti taggati, tutto in ordine di tempo. |
| user | Username es: user=username |
stringa | Il parametro user in combinazione con i valori preferiti, commentati e votati restringe la visualizzazione dei ristoranti mostrando solo quelli preferiti, commentati o votati dall'utente specificato. |
| dv | nome città es: dv=milano |
stringa | Il parametro dv mostra una lista di ristoranti di una specifica città. Il parametro dv ha la precedenza sui parametri prov e reg. Per una città composte da due o più parole è preferibile usare la seguente sintassi es: "cinisello+balsamo". |
| prov | sigla provincia es: prov=ag |
stringa | Il parametro prov mostra una lista di ristoranti di una specifica provincia (sigla) Il parametro prov ha la precedenza sul parametro reg. |
| reg | nome regione es: reg=sicilia |
stringa | Il parametro reg mostra una lista di ristoranti di una specifica regione. I nomi di regione devono essere indicati per esteso es: "friuli+venezia+giulia". |
| etnia | es: etnia=cinese es: etnia=all |
stringa | Il parametro etnia restringe la visualizzazione ai soli ristoranti di una determinata etnia. Con etnia=all si visualizzano tutti i ristoranti etnici. |
| qt | 1/15 es: qt=15 |
numerico | Il parametro qt indica quanti ristoranti devono essere visualizzati, è trasversale per tutti i tipi di mode ed accetta valori numerici da 1 a 15. |
| title | es: title="SpagoTags" | stringa | Il parametro title consente di personalizzare il titolo del box. Il valore predefinito è Ristoranti. Per un titolo composto da due o più parole è preferibile usare la seguente sintassi es: "I+Miei+Ristoranti". |
Per inserire i ristoranti di 2Spaghi sul tuo sito web o blog copia il codice di uno qualsiasi degli esempi seguenti e incollalo dove desideri che vengano visualizzati.
Esempio: "mode=commentati"
Verranno visualizzati tutti gli ultimi ristoranti che sono stati commentati su 2spaghi.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=commentati&qt=15"></script>
Esempio: "mode=preferiti" e "user=flander"
Verranno visualizzati tutti i ristoranti preferiti da flander, lo sapevo lo sapevo, sempre lui :-)
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=preferiti&user=flander&qt=5"></script>
Esempio: "mode=commentati" e "dv=milano"
Verranno visualizzati tutti gli ultimi ristoranti di Milano che sono stati commentati su 2spaghi.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=commentati&dv=milano&qt=5"></script>
Esempio: "mode=votati" e "prov=mi" e "etnia=cinese"
Verranno visualizzati tutti gli ultimi ristoranti Cinesi in provincia di Milano che sono stati votati su 2spaghi.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=votati&prov=mi&etnia=cinese&qt=5"></script>
Esempio: "mode=taggati" e "user=shamperd"
Verranno visualizzati tutti gli ultimi ristoranti che sono stati taggati da shamperd, che si è commosso!.
<script type="text/javascript" src="http://www.2spaghi.it/spagolab/widget/get/?mode=taggati&user=shamperd&qt=5"></script>
Contatti e riferimenti
Per ogni problema in fase di utilizzo e personalizzazione non esitate a contattarci scrivendo a spagowidget@2spaghi.it indicando l'eventuale errore o problema riscontrato. Più precisa sarà la descrizione del problema, potete anche inviarci il codice che non funziona, più semplice sarà per noi rispondervi ed effettuare eventuali controlli.
Domande frequenti
- D: Ma chi ve lo ha fatto fare?
- R: è quello che ci chiediamo ogni santo giorno :-D
- D: non ho la possibilità di modificare il mio sito, come faccio?
- R: puoi contattare il tuo web master/web designer e chiedere a lui di effettuare le modifiche seguendo le istruzioni riportate nella documenatzione.
- D: ho un blog sotto wordpress.com, ma non posso aggiungere codice alle pagine, come faccio?
- R: stiamo studiando un sistema per poter mettere gli SpagoWidget anche su piattaforme "chiuse".
- D: sono previste versioni più avanzate?
- R: più di così? :-D