Questo stato di cose non ha contribuito certamente a far crescere la community (davvero molto piccola, soprattutto in Italia). Da meno di una settimana è uscito CMS Made Simple Development CookBook di Samuel Goldstein edito da Packt Publishing. Il libro è disponibile sia in versione cartacea che digitale. E’ possibile acquistare l’edizione che si preferisce, entrambe o un pacchetto speciale che comprende CMS Made Simple 1.6: Beginner’s Guide.

Il libro è suddiviso in 10 sezioni: si parte parlando di UDT, per passare a SMARTY e poi addentrarsi nello sviluppo di moduli e nell’utilizzo delle API del core di CMSMS. Il materiale è esposto con cura e corredato da esempi pratici di complessità crescente.

Riporto di seguito i capitoli per darvi un idea più chiara dei contenuti:

• Understanding CMS Extensions
• Programming with Smarty and Core Modules
• Getting the Most out of Tags and User-Defined Tag
• Getting Started with Modules
• Using the Database API
• Using the Module Form API
• Your Module and the Community
• Creating Useful Admin Panels
• Using Events
• Advanced Module Tricks and SEO

Post Correlati:

1. Cms Made Simple – stampare un menu di un’altra pagina Il bello di CMS Made Simple è la grande flessibilità...
2. CMS Made Simple 1.6 – una guida per iniziare CMS Made Simple è un CMS flessibile e potente attorno...
3. Usare il plugin template di Tiny MCE in CMS Made Simple Tiny MCE è fra gli editor wysiwyg più utilizzati nei...

Related posts brought to you by Yet Another Related Posts Plugin.

In buona sostanza l’idea è quella di recuperare in maniera ricorsiva i figli di una pagina arbitraria passando come parametro l’alias univoco di pagina. Per effettuare questa operazione è necessario installare CGSimpleSmarty (lo trovate sul forge ), un estensione dell’oggetto Smarty incluso nel core di CMSMS che mette a disposizione metodi molto utili ad un gran numero di operazioni. Nel nostro caso specifico CGSimpleSmarty ci aiuterà a recuperare alcuni parametri relativi alle pagine (il numero di figli, alias e titolo).

[sniplet stampaMenuPagina]

Nello script viene utilizzato anche il plugin selflink (nel core di cmsms) per creare il link a partire dall’alias di pagina. In questo modo lo script funziona anche se viene abilitato il friendly url.

Post Correlati:

1. Joomla inserire l’alias di pagina nel body Una segnalazione al volo per chi ha, come me, la...
2. CMS Made Simple – Lorem Ipsum plugin Quando si lavora ad un nuovo progetto spesso si ha...
3. Posizionare il footer in fondo alla pagina con jQuery Spesso quest’attività, all’apparenza semplice, si scontra con il design di...

Related posts brought to you by Yet Another Related Posts Plugin.

Fra le features più interessanti c’è indubbiamente la possibilità di richiamare snippet di codice già pronto. Possiamo rendere disponibile questa funzione attivando il plugin “template”; per farlo è necessario eseguire alcuni passaggi.

Per prima cosa andiamo in estensioni > Modulo WYSIWYG TinyMCE e poi sul tab “plugins”, qui flagghiamo la voce “template” e premiamo salva per includere il plugin nelle impostazioni dell’editor.

Poi premiamo il tab “profili”  qui decidiamo in quale profilo e in quale riga di pulsanti inserire quello relativo al plugin. Per inserirlo è sufficiente scrivere “template” preceduto da una virgola, dopodichè clicchiamo su “salva profilo” per rendere effettiva la modifica. A questo punto nel campo di testo in basso dovreste già vedere il pulsante relativo al plugin template.

A questo punto premiamo il tab “avanzate” e andiamo a configurare i template. In questo tab esiste un campo chiamato “configurazioni extra”, qui dobbiamo inserire il setup relativo ai template che si desidera inserire. Il codice deve essere su di una sola riga. Di seguito riportiamo un esempio in cui sono stati configurati due template:

[sniplet tempateTiny]

I path fanno riferimento al root del sito quindi, se vi attenete all’esempio dovrete creare una cartella chiamata layEditor nella root principale del sito. I template sono semplici pagina html contenenti esclusivamente il codice che intendete inserire nella pagina.

Tuttavia nessuno vi vieta di inserire codice smarty o altro. Personalmente trovo questo plugin molto utile perchè semplifica, e di molto , l’assistenza alla popolazione dei contenuti.

Per approfondimenti vi consiglio di fare riferimento al sito del progetto, alla voce plugin

Post Correlati:

1. CMS Made Simple – Lorem Ipsum plugin Quando si lavora ad un nuovo progetto spesso si ha...
2. Cms Made Simple – plugin secure mailto Oggi vi presento un plugin per CMS Made Simple sviluppato...
3. 20 template opensource Opensource template propone 20 template opensource che si distinguono...

Related posts brought to you by Yet Another Related Posts Plugin.

Ad ogni modo non tutte le funzionalità di smarty sono supportate da cmsms, daltronde solo alcune di esse si rivelano effettivamente utili (mentre altre, se ci fossero, sarebbero davvero comode ). In questa primissima parte della guida mi limiterò a fornirvi i concetti fondamentali per effettuare alcune delle operazioni più semplici, utili a compiere i primi passi nell’utilizzo di questo strumento.

Sintassi generale

Il codice smarty fa racchiuso all’interno di parentesi graffe {}, ad esempio se vogliamo stampare il contenuto di una variabile è sufficiente scrivere {$nomeVariabile}.
Possiamo inserire smarty in tre posti:

• nel contenuto della pagina
• nell’apposito spazio di ogni pagina accessibile dal tab “opzioni”, con label “Dati o logica Smarty specifica di questa pagina”
• nei template

Non possiamo inserire smarty dentro i tag definiti dall’ utente (o UDT) che di fatto sono un modo semplice e veloce di creare snippet smarty da richiamare poi dove riteniamo più opportuno

I commenti si scrivono in questo modo {* questo è un commento *}

Per evitare errori dovuti all’utilizzo di javascript (che fa a sua volta uso di parentesi graffe) è necessario includere tutto il codice dentro il tag smarty “literal”. In pratica tutto quello racchiuso in questo tag non verrà considerato codice smarty e quindi non verrà parsato. Ad esempio per includere uno script fatto con jQuery scriveremo:
{literal}
$(document).ready(function() {
... codice ...
});
{/literal}

Possiamo poi iniettare informazioni via smarty aprendo e chiudendo literal dentro a un js, il risultato sarà poco leggibile ma funzionale.

In base al tag smarty che stiamo utilizzando possono essere o meno disponibili parametri addizionali.  i parametri hanno la seguente sintassi:
{tag_smarty nome_parametro = 'valore_parametro'}
come valore parametro possiamo utilizzare valori statici o variabili, in quel caso si devono utilizzare i doppi apici o nessun apice.

Variabili

In ogni pagina di CMS Made Simple sono disponibili diverse variabili di pagina alle quali possiamo attingere grazie a smarty. Il primo passo consiste nel sapere quali sono e che valore hanno. Per recuperare questo tipo di informazioni è sufficiente inserire {get_template_vars}. Questo plugin ha l’unica funzione di stamparvi nella pagina tutte le variabili disponibili.

Come dicevamo poco fa per stampare il contenuto di una variabile è sufficiente nominarla racchiusa all’interno delle parentesi graffe {$nomeVariabile}.

Per assegnare un valore statico ad una variabile si utilizzerà il comando “assign“; assign ha due parametri, var, il nome della variabile e value, il suo valore. Si scriverà:
{assign var='nomeVar' value='valoreVar'}

Per assegnare il varore di un blocco di pagina, o del content si userà il parametro assign di content in questo modo:
{content block='nomeBlocco' assign='nomeVarBlocco'}

Poi quando vorrò stampare il contenuto assegnato scriverò il nome della variabile preceduta dal dollaro:
{$nomeVarBlocco}

Se voglio concatenare due variabili, o una variabile e del testo scriverò:
{$nomeVar|cat:$altraVar}
Oppure:
{$nomeVar|cat:’ stringa che voglio concatenare’}
Oppore posso fare netrambe le cose:
{$nomeVar|cat:$altraVar|cat:’ stringa che voglio concatenare’}
Ovviamente in tutti questi casi il contenuto delle variabili coinvolte verrà trattato come stringa.

Se volgio invece eseguire delle operazioni matematiche scriverò:
Somma: {$valore+10}
Divisione: {$valore+10}
Moltiplicazione: {$valore*10}
Se non desidero stampare direttamente il valore ma utilizzarlo in modo differente posso assegnare il risultato ad un’altra variabile usando il comando assign, in questo modo:
{assign var='nuova' value=$valore/10}

Per oggi ci fermiamo qui, nella prossima parte vedremo la logica condizionale, i clicli e altre cosette utili.

Post Correlati:

1. Progettazione web e fruibilità – prima parte Fruire i contenuti su più dispositivi Il concetto di fruibilità...
2. Cms Made Simple – stampare un menu di un’altra pagina Il bello di CMS Made Simple è la grande flessibilità...
3. CMS Made Simple 1.6 – una guida per iniziare CMS Made Simple è un CMS flessibile e potente attorno...

Related posts brought to you by Yet Another Related Posts Plugin.

Questo plugin è utile quando volete mettere a disposizione dei vostri utenti la possibiilità di visualizzare in chiaro gli indirizzi di contatto magari collegando al template il plugin via smarty in questo modo:

{content block=’email’ oneline=’true’ assign=’email’}
{mailtoSecure mail=$email}

Come si installa?

Il plugin per funzionare utilizza anche jQuery (nel caso vogliate utilizzare il modo ‘js’) e un suo plugin quindi ho incluso anche la cartellina js che vede essere inserita sulla root del sito (o dove vi pare ma in questo caso dovrete cambiare i path con i quali richiamate i js nel template). Il plugin vero e proprio va copiato dentro la cartella plugin.

Come si usa?

È sufficiente inserire nella pagina/template:
[sniplet secure1]

Di default il plugin è in modalità js e per avere la visualizzazione corretta è necessario includere nel template il framework jQuery e il suo plugin jquery.mailto.

<script type=”text/javascript” src=”js/jquery-1.3.2.min.js”></script>
<script type=”text/javascript” src=”js/jquery.mailto.js”></script>
{literal}
<script type=”text/javascript”>
$(document).ready(function() {
$(‘a.email’).mailto();
});
</script>
{/literal}

Quali parametri sono disponibili?

• email – l’indirizzo email che si intende inserire.
• (opzionale) class – string, un eventuale classe da associare al link generato (o all’immagine nel caso si scelga la generazione dell’immagine). Di default la classe è email (nel caso la si cambi in modalità js è necessario ricordarsi di cambiare la classe anche nel codice js.
• (opzionale) messaggio – string, permette di impostare un messaggio da visualizzare nel caso non sia inserito il paramentro email (utile nel caso vogliate impostare un campo content block nel template per permettere agli utenti di inserire la email
• (opzionale) mode – string, permette di scegliere la modalità di generazione. È disponibile “js” o “image”, di default js. La modalità “image” è ancora abbozzata, funziona ma ha dei limiti nella customizzazione. E’ possibile scegliere il formato (png,jpg,gif), il path di salvataggio dell’immagine generata, il colore dello sfondo e quello del testo ma non il font e la sua dimensione.
• (opzionali) width e height – int, inserire le dimensioni dell’immagine generata (default altezza 20px, larghezza 250px)
• (opzionale) path - string, inserire il path in cui salvare le immagini generate (di default: uploads/images/)
• (opzionale) color e bgColor - string, inserire il valore esadecimale per ciascun parametro (di default colore nerro su sfondo bianco).

Esempio:
[sniplet secure2]

Potete scaricare la prima versione del plugin da qui: secureMailto

Post Correlati:

1. Usare il plugin template di Tiny MCE in CMS Made Simple Tiny MCE è fra gli editor wysiwyg più utilizzati nei...
2. CMS Made Simple – Lorem Ipsum plugin Quando si lavora ad un nuovo progetto spesso si ha...
3. Cms Made Simple – guida a Smarty parte prima Dal mio punto di vista una delle caratteristiche che rende...

Related posts brought to you by Yet Another Related Posts Plugin.

Il plugin è basato sulla classe “lipsum” modificata di Artur Barseghyan e ha alcuni parametri che permettono una certa customizzazione del testo generato.

Parametri

• (opzionale) all – il parametro all settato a 1 stampa tutti i contenuti (se uso questo parametro non è possibile usare gli altri di seguito)
• (opzionale) h2 – è possibile decidere il numero di parole da generare nel titolo della pagina
• (opzionale) p – è possibile decidere il numero di paragrafi da generare
• (opzionale) ul – è possibile decidere il numero di elementi lista da generare
• (opzionale) table - è possibile decidere il numero di tabelle da stampare
• (opzionale) urlImg – è possibile inserire il path dell’immagine utilizzata come placeholder (di default il path base è uploads/images, quindi è necessario codificare urlImg da quel path a meno di non cambiare base)
• (opzionale) base – permette di cambiare il path di base per l’immagine di placeholder
• (opzionale) imgsx e imgdx – permette di cambiare le classi attribuite alle due immagini (di default rispettivamente imgSx e imgDx)

Qui potete scaricare la prima versione: loremipsum.plugin.zip (v.01)

Post Correlati:

1. Cms Made Simple – plugin secure mailto Oggi vi presento un plugin per CMS Made Simple sviluppato...
2. Usare il plugin template di Tiny MCE in CMS Made Simple Tiny MCE è fra gli editor wysiwyg più utilizzati nei...
3. Cms Made Simple – stampare un menu di un’altra pagina Il bello di CMS Made Simple è la grande flessibilità...

Related posts brought to you by Yet Another Related Posts Plugin.

Ho ordinato la versione cartacea che mi deve ancora arrivare. Da quello che posso vedere mi sembra un libro piuttosto completo: ci sono 11 capitoli che trattano in modo esaustivo tutti i principali aspetti del CMS. Si parte dai reguisiti e dalla procedura di installazione fino ad arrivare alla configurazione e all’uso di moduli sviluppati da terze parti come l’e-commerce e il multi-lingue.

Per quanto mi rigurda, la parte più interessante è quella relativa allo sviluppo di moduli e funzionalità, all’implementazione del multilingue e all’ottimizzazione SEO del CMS.

A quando il manuale “advanced”?

Post Correlati:

1. Cms Made Simple – guida a Smarty parte prima Dal mio punto di vista una delle caratteristiche che rende...
2. E’ uscito CMS Made Simple Development CookBook Cms Made Simple è un CMS estremamente flessibile e potente...
3. Usare il plugin template di Tiny MCE in CMS Made Simple Tiny MCE è fra gli editor wysiwyg più utilizzati nei...

Related posts brought to you by Yet Another Related Posts Plugin.