.
Annunci online

FORUM

Per una migliore gestione delle richieste ordinarie vi invitiamo a usare il nostro forum che offre una migliore visibilità ai thread di domande-risposte

Contattaci

Per comunicare con il cannocchiale labs (un'idea? un bug? qualcosa che non è chiaro?) puoi scriverci direttamente a questo indirizzo.

Link

Feed

Resta aggiornato con i feed
Feed RSS di questo blog Feed ATOM di questo blog

Glamware: la guida

Glamware

pubblicato da il 29 gennaio 2007 alle 17:23

GLAMWARE - La collezione di insiemi POST

DOCUMENTAZIONE GLAMWARE - LA COLLEZIONE DI INSIEMI POST

Per collezione di insiemi di intende un oggetto composto da un elenco di insiemi. La collezione POST fornisce l'elenco dei post e a differenza dell'insieme BLOG deve essere utilizzato all'interno di un LOOP

L'insieme di meta POST restituisce un elenco di valori associati al POST

Di seguito viene fornito l'elenco completo delle meta (i nomi delle variabili che contengono i valori) offerto dall'insieme POST

META NOTE ESEMPIO DI USO
(i codici di esempio possono essere inseriti in qualsiasi punto nel codice HTML del template)
TITLE titolo del post <DOL:POST.TITLE>
ABSTRACT abstract del post <DOL:POST.ABSTRACT>
TEXT contenuto del post <DOL:POST.TEXT>
TEXTLEN lunghezza del testo <DOL:IF POST.TEXTLEN>0>
<DOL:POST.TEXT>
<DOL:ELSE POST.TEXTLEN>0>
questo post è vuoto
<DOL:ENDIF POST.TEXTLEN=0>
ABSTRACTLEN lunghezza dell'abstract <DOL:IF POST.ABSTRACTLEN>0>
<DOL:POST.ABSTRACT>
<DOL:ELSE POST.ABSTRACTLEN>0>
<DOL:POST.TEXT>
<DOL:ENDIF POST.ABSTRACTLEN=0>
ID_BLOGRUB identificativo unico della rubrica (si può usare per linkare il blog con filtro attivo sulla rubrica) Questo post compare nella rubrica: <a href='/?r=<DOL:POST.ID_BLOGRUB>'><DOL:POST.SECTION></a>
SECTION nome della rubrica (categoria) a cui appartiene il post Questo post compare nella rubrica: <a href='/?r=<DOL:POST.ID_BLOGRUB>'><DOL:POST.SECTION></a>
DATE data inserimento del post <DOL:POST.DATE>
DAY giorno (numerico) della data di inserimento del post pubblicato nel giorno <DOL:POST.DAY>
MONTH mese (numerico) della data di inserimento del post pubblicato nel mese <DOL:POST.MONTH>
YEAR anno (numerico) della data di inserimento del post pubblicato nell'anno <DOL:POST.YEAR>
HOUR ora (numerico) della data di inserimento del post pubblicato alle ore <DOL:POST.HOUR> : <DOL:POST.MINUTE>
MINUTE minuti (numerico) della data di inserimento del post pubblicato alle ore <DOL:POST.HOUR> : <DOL:POST.MINUTE>
YYMM anno+mese (numerico) della data di inserimento del post <DOL:POST.YYMM>
PREVDATE data inserimento del post precedente <DOL:POST.PREVDATE>
NEXTDATE data inserimento del post successivo <DOL:POST.NEXTDATE>

Glamware

pubblicato da il 29 gennaio 2007 alle 16:21

GLAMWARE - blocco di codice LOOP

L'istruzione LOOP viene utilizzata per elencare collezioni di insiemi enumerabili

Cosa è un insieme lo abbiamo visto con l'insieme di meta BLOG. Le collezioni enumerabili di insiemi rappresentano strutture piu' complesse, come l'insieme dei post del blog, o l'insieme delle sezioni. In pratica le collezioni vengono impiegate laddove è necessario avere degli elenchi di oggetti. In glamware gli oggetti POST,SECTIONS,LINK sono esempi di collezioni enumerabili di insiemi.

Le collezioni enumerabili vanno utilizzate all'interno di strutture iterative LOOP

Es.
<DOL:LOOP LINK>
<a href="http://<DOL:LINK.LINK>" target="_blank"><DOL:LINK.DESCRIPTION></a><br>
<DOL:ENDLOOP LINK>
In questo esempio viene mostrato l'elenco dei link del nostro blog

La struttura di un loop è la seguente:
<DOL:LOOP NOMECOLLEZIONE>
codice html+glamware
<DOL:ENDLOOP NOMECOLLEZIONE>

All'interno di un blocco di codice LOOP si accede alle collezioni chiamandole con la sintassi:
NOMECOLLEZIONE.META

Le collezioni enumerabili attualmente supportate da glamware sono le seguenti:

  • POST
  • SECTIONS
  • LINK

Per ognuna di esse verrà pubblicato un post con la documentazione degli oggetti.

Glamware

pubblicato da il 26 gennaio 2007 alle 11:38

GLAMWARE - L'INSIEME BLOG

DOCUMENTAZIONE GLAMWARE - L'INSIEME BLOG

L'insieme di meta BLOG restituisce un elenco di valori associati al BLOG (sezione BLOG->Impostazioni di www.go.ilcannocchiale.it), normalmente si tratta di informazioni che sono state inserite attraverso la sezione BLOG della piattaforma.

Di seguito viene fornito l'elenco completo delle meta (i nomi delle variabili che contengono i valori) offerto dall'insieme BLOG

META NOTE ESEMPIO DI USO
(i codici di esempio possono essere inseriti in qualsiasi punto nel codice HTML del template)
TITLE titolo del blog <DOL:BLOG.TITLE>
SUBTITLE sottotitolo del blog <DOL:BLOG.SUBTITLE>
IMGPATH path delle immagini LOGO e ICONA. Questa meta è necessaria in quanto le immagini associate al BLOG (logo e icona) variano da blog a blog e per usarle (vedi meta LOGO) è necessario poter definire l'intero path dell'immagine <DOL:BLOG.IMGPATH>
LOGO nome dell'immagine inserita nel logo del blog
(si usa in abbimanento alla meta IMGPATH)
<img src=" /<DOL:BLOG.IMGPATH><DOL:BLOG.LOGO> alt="il mio logo">
HEADERIMG nome dell'immagine inserita nella testata grafica personale
(si usa in abbimanento alla meta IMGPATH)
<img src=" /<DOL:BLOG.IMGPATH><DOL:BLOG.HEADERIMG> alt="il mio logo">
COUNTER Restituisce il numero di accessi al blog <DOL:BLOG.COUNTER>
LASTUPDATE Restituisce la data dell'ultimo aggiornamento del blog <DOL:BLOG.LASTUPDATE>
NUMPOST Restituisce il numero dei POST inseriti nel BLOG <DOL:BLOG.NUMPOST>
META Restituisce le meta impostate nel manager da utilizzarsi nella sezione <HEAD>...</HEAD> del template

<HEAD>
<DOL:BLOG.META>
</HEAD>

PAGETITLE Restituisce il titolo della pagina impostato nel manager

<HEAD>
<title><DOL:BLOG.TITLE>.ilcannocchiale.it&nbsp; <DOL:BLOG.PAGETITLE></title>
</HEAD>

Glamware

pubblicato da il 26 gennaio 2007 alle 10:36

Introduzione a Glamware

Con questo post iniziamo a documentare Glamware.

Come accennato in precedenza Glamware è il linguaggio (semplicissimo) che si utilizza per personalizzare o creare da zero il template di visualizzazione di un BLOG. Glamware è stato sviluppato da noi appositamente per il Cannocchiale, durante il suo sviluppo ci siamo resi conto delle sue potenzialità al punto che oggi viene utilizzato da DOL come strumento di sviluppo interno dei propri progetti WEB.

Iniziamo facciamo una precisazione: il template altro non è che un file HTML standard, Glamware viene utilizzato per visualizzare elementi dinamici come il nome del proprio blog, l'elenco delle rubriche, il counter, i post e così via. Questo modello permette la scrittura di templates completamente liberi, potete inserire qualsiasi oggetto comprensibile da parte di un browser (codice HTML standard, parti in javascript, oggetti flash e naturalmente tag di Glamware) con la possibilità di interfacciarvi con la base di dati che contiene tutto del vostro BLOG.

Per chi mastica un po' di HTML sarà utile sapere che si usa attraverso TAG scritti con una sintassi ben precisa: <DOL:istruzioneglamware>
Per fare un esempio se in un certo punto della nostra pagina vogliamo far visualizzare il nome del proprio blog il tag equivalente da inserire nel codice HTML è <DOL:BLOG.TITLE>

Analizzando l'esempio appena riportato possiamo individuare:

DOL: è il prefisso che si usa all'interno dei TAG glamware
BLOG indica un insieme (di singole meta o di ulteriori insiemi, verranno specificati nella documentazione)
TITLE indica una meta appartenente all'insieme blog

Fin qui è tutto molto semplice, per il momento ci fermiamo (tra poco pubblicheremo il link della documentazione dell'insieme BLOG).

Nel prossimo appuntamento introdurremo gli insiemi di insiemi e le istruzioni iterative di Glamware (essenziali per implementare oggetti che si ripetono all'interno della pagina come le rubriche, i link... e soprattutto i POST!