Loadmodule in Joomla!® 3.4

Inserire un modulo in un articolo di Joomla!® è una procedura comune ed in alcuni casi indispensabile per ottenere una migliore contestualizzazione.
Esempi comuni sono l'inserimento di gallerie fotografiche, moduli di login o form da compilare all'interno di articoli.
I comandi che utilizzo in Joomla!® per inserire un modulo in un contenuto sono due:
loadmodule
loadposition

loadmodule - Inserire un modulo in un contenuto di Joomla!®

loadmodule
richiama un ben preciso modulo utilizzando un nome dato dal sistema (tra poco vedremo come ricavarlo) o in aggiunta, anche un "Title" dato da noi.
loadposition
richiama un modulo utilizzando un nome di posizione modulo che può essere anche creato appositamente per visualizzare un particolare modulo.

I due sistemi funzionano bene entrambi, starà a noi scegliere di volta in volta quale sia più comodo all'uso che dobbiamo farne.
Vediamo nel dattaglio come vanno implementati.

Premessa: Plugin "Content - Load Modules" abilitato

Prima di tutto accertiamoci che il plugin "Content - Load Modules" sia abilitato.
Di solito lo è di default ma per esserne sicuri basta andare su Extensions --> Plugin Manager e filtrare con "load"
La spunta verde segnala che il plugin è attivato.

Loadmodule - Joomla!® 3.x

Il comando loadmodule è forse meno usato del loadposition per la difficoltà a volte nel reperire il nome corretto del modulo da inserire nel richiamo, soprattutto se si tratta di un modulo di terze parti. La sintassi corretta per il suo inserimento è:

Prima parte: {loadmodule... }

Tra parentesi graffe è un normale richiamo di un plugin in Joomla!®

Seconda parte: mod_nome

È il nome "di sistema" del modulo, vediamo come ricavarlo nei due casi: modulo nativo o modulo di terze parti.

Modulo nativo di Joomla!®

Se il modulo da richiamare è tra quelli presenti nativamente in Joomla!® qui ne elenco alcuni tra i più comuni:

mod_articles_latest
mod_articles_popular
mod_articles_category
mod_articles_categories
mod_banners
mod_custom
mod_feed
mod_login
mod_related_items
mod_tags_popular

Modulo di terze parti

Se invece cerchiamo un modulo di terze parti il sistema che utilizzo io è questo:
- entro nel database con phpMyAdmin
- cerco nella colonna Structure la tabella xxxxx_extensions
- clicco su Browse
- scorro la colonna name fino a trovare il modulo che mi interessa e mi ricavo il corrispondente valore della colonna element.
Quest'ultimo (nell'esempio mod_roksprocket) sarà il valore da inserire nel richiamo dopo loadmodule.
Nota: i moduli potrebbero essere in ordine di "extension_id" quindi scorrete tutta la colonna "element" per essere sicuri di trovare quello che cerchiamo.

Terza parte (facoltativa): titolo modulo

Anche se non obbligatorio, vi consiglio di aggiungere al richiamo anche l'ultimo parametro, il titolo.
Così facendo, anche in presenza di più moduli dello stesso tipo, saremo certi che venga mostrato quello che ci interessa.
Questo è semplicemente il titolo del modulo, quello che vediamo dal backend nel pannello Module Manager (Gestione Moduli).

loadmodule - Esempi pratici

Facciamo ora un esempio richiamando da un articolo il modulo di login (mod_login), che è nativo di Joomla!®
Nell'esempio sotto (foto di sinistra) è stato creato un articolo dal titolo "Loadmodule" e in basso sotto al testo, inserito il richiamo.
Nell'immagine di destra potete vedere il risultato.
Se il modulo è unico e non può essere confuso con un altro, possiamo omettere l'inserimento del titolo e scrivere nell'articolo:

Altro esempio, questa volta richiamiamo un modulo Custom o HTML Personalizzato (mod_custom come nome di sistema) creato da noi dal titolo "Mio Modulo"
Nota: dato che il modulo viene chiamato utilizzando tipo e titolo, la posizione non è importante e per questo non è stata impostata.

Andiamo nell'articolo di prima e questa volta aggiungiamo il richiamo:

ed ecco il risultato finale: