Seleziona la tua lingua

Documentazione sugli shortcode MX

Aggiungi elementi di layout e di contenuto agli articoli di Joomla e ad altri contenuti visualizzati sul sito utilizzando tag tra parentesi. Il pacchetto include due plugin: uno elabora gli shortcode, mentre l'altro ti aiuta a inserirli dall'editor.

I due plugin

Installa e attiva entrambi i plugin per un'esperienza completa. Hanno ruoli distinti:

  • System - MX Shortcodes elabora il markup degli shortcode e visualizza il contenuto risultante sulle pagine pubbliche. Le sue impostazioni, tra cui il caricamento di Bootstrap e i colori degli shortcode, sono descritte di seguito.
  • Button Shortcode Generator (il pulsante dell’editor di MX Shortcodes) aggiunge un generatore di shortcode agli editor di contenuto Joomla supportati. Inserisce il codice shortcode nel vostro contenuto; non visualizza lo shortcode stesso.

Utilizzo del pulsante dello shortcode

  1. Apri un articolo o un altro elemento di contenuto e posiziona il cursore nell’editor nel punto in cui desideri inserire lo shortcode.
  2. Fai clic sul pulsante MX Shortcodes, solitamente visualizzato sotto l’editor. Cerca o seleziona uno shortcode dall’elenco.
  3. Compila i campi visualizzati. Per gli shortcode con elementi ripetibili, utilizza il controllo “Aggiungi” fornito per includere più elementi.
  4. Fai clic su "Aggiungi shortcode". Il generatore inserisce il codice dello shortcode in corrispondenza del cursore; controllalo e aggiungi o modifica eventuali contenuti interni secondo necessità.

Se il pulsante non è disponibile, verifica che "Generatore di shortcode dei pulsanti" sia abilitato e che l’editor supporti i pulsanti dell’editor di Joomla. Puoi anche digitare direttamente il codice dello shortcode. Il plugin "Sistema - MX Shortcodes" deve essere abilitato affinché quel codice venga elaborato sulle pagine pubbliche.

Scrivere gli shortcode manualmente

Inserisci il codice dello shortcode nell’editor dei contenuti. Utilizza le virgolette doppie attorno ai valori degli attributi. I tag con contenuto richiedono un tag di chiusura corrispondente; i tag degli elementi vanno inseriti all’interno dello shortcode padre.

[alert type="success"]Your changes have been saved.[/alert]
[divider margin_top="24px" margin_bottom="24px" /]

Requisiti: molti componenti utilizzano gli stili di Bootstrap 5 o comportamenti interattivi. Il template del tuo sito dovrebbe caricare Bootstrap 5 oppure abilitare l’opzione “Carica Bootstrap 5” nelle impostazioni del plugin di sistema. Lasciala disabilitata se il template carica già Bootstrap 5 per evitare di caricarlo due volte.

Lo shortcode dell’icona richiede inoltre che Font Awesome sia caricato dal template del sito. Le mappe si basano sull’API JavaScript di Google Maps e su una connessione a Internet.

Gli shortcode vengono elaborati sul sito pubblico nelle pagine HTML. Non vengono visualizzati nell’anteprima dell’editor di amministrazione. Evita di inserire uno shortcode all’interno del valore di un attributo di un altro elemento.

Pulsante

Crea un pulsante di collegamento in stile Bootstrap. Nome dello shortcode: button.

[button link="https://example.com" type="primary" size="large" target="_blank"]Learn more[/button]
Attributo Predefinito Valori / scopo
link vuoto URL di destinazione.
type secondary primary, secondary, success, danger, warning, info, light, dark, oppure link.
size predefinito small, large, oppure vuoto per la dimensione predefinita.
target stessa finestra Impostare su _blank per aprire una nuova scheda/finestra.
Etichetta — Etichetta del pulsante.

Icona

Visualizza un'icona Font Awesome. L'editor include un selettore di icone.

[icon name="star" size="24" color="#e0a800" class="my-icon" /]
Attributo Predefinito Scopo
name home Nome dell'icona, con o senza il fa- prefisso.
size impostazione predefinita del browser Dimensione del carattere in pixel.
color ereditato Valore del colore CSS.
class vuoto Classe CSS aggiuntiva.

Il foglio di stile delle icone fornisce i nomi delle classi degli shortcode. Il font delle icone stesso deve essere disponibile nelle risorse del template/sito attivo.

Separatore

Inserisce un divisore orizzontale con margini e bordo configurabili.

[divider margin_top="24px" margin_bottom="24px" border="1px solid #ccc" /]
Attributo Predefinito Scopo
margin_top 18px Margine superiore CSS.
margin_bottom 18px Margine inferiore CSS.
border 0 Valore border-top valore.

Righe e colonne

row raggruppa le colonne; ciascuna col accetta le classi della griglia Bootstrap. L'editor offre col-12 e col-md-1 fino a col-md-12.

[row id="features" class="my-row"]
[col class="col-md-6"]First column[/col]
[col class="col-md-6"]Second column[/col]
[/row]
Tag Attributo Predefinito Scopo
row id vuoto ID riga facoltativo.
row class vuoto Classi aggiuntive sulla riga.
col class col Classi di colonna/griglia.
col Contenuto — Contenuto della colonna; gli shortcode annidati vengono elaborati.

È necessario lo stile della griglia Bootstrap per ottenere il consueto comportamento reattivo delle colonne. Includere Bootstrap 5 tramite le impostazioni del template o del plugin.

Avviso

Visualizza un avviso Bootstrap.

[alert type="success" close="yes"]Your changes have been saved.[/alert]
Attributo Predefinito Valori / scopo
type secondary primary, secondary, success, danger, warning, info, light, oppure dark.
close no Impostare su yes per visualizzare un pulsante di chiusura. Per chiudere è necessario JavaScript Bootstrap.
style vuoto Attributo di stile CSS inline facoltativo.
Contenuto — Testo di avviso o shortcode annidati.

Barra di avanzamento

Visualizza una barra di avanzamento con percentuale.

[progressbar bar="65" type="success" striped="yes" active="yes" text="Complete" /]
Attributo Predefinito Scopo
bar 50% Percentuale di avanzamento, compresa tra 0 e 100. Inserisci il numero (il sistema aggiunge automaticamente il simbolo %).
type primary Colore Bootstrap: primary, secondary, success, danger, warning, info, light, dark.
striped no Impostare su yes per lo stile a strisce.
active no Impostare su yes per le strisce animate.
text vuoto Etichetta facoltativa visualizzata prima della percentuale.

Conto alla rovescia

Conta alla rovescia fino a una data e un'ora. Entrambe [countdown] e il tag con le maiuscole tradizionali [Countdown] .

[countdown date="2027-01-01T00:00:00" size="large"]
The event has started!
[/countdown]
Attributo Predefinito Scopo
date obbligatorio Data/ora analizzabile da PHP DateTime, ad esempio ISO 8601. Date non valide o mancanti generano un errore in linea.
size medium small, medium, large, oppure custom.
custom_size 2rem Dimensione del numero quando size="custom"; supporta le unità di misura CSS quali 32px o 2rem.
Contenuto Conto alla rovescia completato. Contenuto facoltativo visualizzato una volta che il conto alla rovescia raggiunge lo zero.

Grafici a torta di avanzamento

Visualizza uno o più indicatori di avanzamento circolari animati utilizzando progresspie_item elementi secondari.

[progresspie size="medium"]
[progresspie_item label="Design" value="80" color="#1756a9" /]
[progresspie_item label="Build" value="55" color="#29a36a" /]
[/progresspie]
Tag / attributo Predefinito Scopo
progresspie size medium Dimensione dell'indicatore: small, medium, large, oppure custom.
progresspie custom_size 9rem lunghezza CSS utilizzata quando si seleziona una dimensione personalizzata.
progresspie_item label vuoto Etichetta di testo sotto l'indicatore.
progresspie_item value 0 Percentuale, compresa tra 0 e 100.
progresspie_item color #0d6efd Colore dell'indicatore in formato esadecimale a 3 o 6 cifre.

Schede

Crea una navigazione a schede e pannelli di contenuto. La prima scheda è attiva al caricamento iniziale della pagina.

[tab id="details" class="product-tabs" button="nav-tabs"]
[tab_item title="Description"]Product details go here.[/tab_item]
[tab_item title="Shipping"]Shipping information goes here.[/tab_item]
[/tab]
Tag / attributo Predefinito Scopo
tab id myTab ID di base; per ogni istanza vengono generati ID univoci.
tab class tab Classe wrapper aggiuntiva.
tab button nav-tabs nav-tabs oppure nav-pills.
tab_item title vuoto Etichetta del pulsante Tab.
tab_item Contenuto — Contenuto del pannello; gli shortcode annidati vengono elaborati.

Accordion

Crea un accordion Bootstrap con il primo pannello inizialmente aperto.

[accordion id="faq" version="2"]
[accordion_item title="How does it work?"]Explanation goes here.[/accordion_item]
[accordion_item title="Can I get help?"]Contact our support team.[/accordion_item]
[/accordion]
Tag / attributo Predefinito Scopo
accordion id accordion1 ID di base; per ogni istanza vengono generati ID univoci.
accordion version 1 Stile 1 o 2 (variante delle FAQ).
accordion_item title vuoto Intestazione del pannello.
accordion_item Contenuto — Corpo del pannello; gli shortcode annidati vengono elaborati.

Crea una galleria di immagini responsive. È possibile fornire immagini come elementi ripetibili oppure utilizzare una cartella relativa alla directory principale delle immagini multimediali configurata in Joomla.

[gallery columns="3" modal="yes" filter="yes" folder="events"]
[gallery_item src="local-images:/events/launch.jpg" tag="launch,team"]Launch event[/gallery_item]
[gallery_item src="local-images:/events/team.jpg" tag="team"]The team[/gallery_item]
[/gallery]
Tag / attributo Predefinito Scopo
gallery columns 3 Colonne, con valore compreso tra 1 e 6.
gallery folder vuoto Sottocartella opzionale e sicura all'interno della cartella immagini di Joomla Media configurata. File supportati: JPG, PNG, GIF, WebP, AVIF, SVG.
gallery modal yes Apri ogni immagine in un modale Bootstrap oppure usa no per creare un link all’immagine.
gallery filter no Mostra i filtri per tag quando impostato su yes.
gallery_item src "obbligatorio" per la "Origine immagine", selezionata nel selettore multimediale dell’editor. Il valore "local-media" dell’editor utilizza local-images:/path/image.jpg.
gallery_item tag vuoto tag di filtro separati da virgola.
gallery_item contenuto vuoto Didascalia facoltativa.

I percorsi delle cartelle sono limitati alle sottocartelle della radice delle immagini multimediali; i percorsi assoluti e i segmenti di percorso non sono accettati.

Crea un carosello Bootstrap con i controlli "precedente" e "successivo" quando sono presenti più diapositive.

[carousel id="feature-slides"]
[carousel_item src="local-images:/slides/one.jpg"]First caption[/carousel_item]
[carousel_item src="local-images:/slides/two.jpg"]Second caption[/carousel_item]
[/carousel]
Tag / attributo Predefinito Scopo
carousel id carousel ID di base; per ogni istanza vengono generati ID univoci.
carousel_item src vuoto Fonte immagine facoltativa. Se specificata, l'elemento visualizza un'immagine e una didascalia facoltativa.
carousel_item contenuto vuoto Didascalia o contenuto arbitrario della diapositiva quando src viene omesso.

Il renderer riconosce anche [caption]...[/caption] nel contenuto della diapositiva. Il carosello richiede CSS/JavaScript di Bootstrap 5.

Testimonianze

Mostra una o più schede di testimonianze in una griglia o in uno slider responsive.

[testimonial version="1" slider="1" columns="3" gap="16" autoplay="1" loop="1" nav="1"]
[testimonial_item name="Alex Example" designation="Designer" email="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo." url="https://example.com"]
The team was helpful and the result was excellent.
[/testimonial_item]
[testimonial_item name="Sam Example" designation="Project Lead"]
Communication was clear throughout the project.
[/testimonial_item]
[/testimonial]

Utilizzare slider="0" per una griglia e version="1" oppure version="2" per lo stile della scheda. Rimane disponibile un modulo legacy a elemento singolo:

[testimonial name="Alex Example" designation="Designer" email="Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo."]
The team was helpful and the result was excellent.
[/testimonial]
Attributo "Group" Predefinito Scopo
version 1 Stile della scheda 1 oppure 2.
slider 0 1 per il cursore, 0 per la griglia.
gap 6 Spaziatura tra gli elementi in pixel, compresa tra 0 e 50.
columns 3 Elementi per riga su desktop.
columns_tabl 2 Elementi per riga a 960–1280 px.
columns_tabp 2 Elementi per riga a 768–959 px.
columns_mobl 1 Elementi per riga a 441–767 px.
columns_mobp 1 Elementi per riga fino a 440 px.
autoplay 1 Avanzamento automatico del cursore; impostare 0 per disattivare.
autoplay_timeout 5000 Tempo tra un avanzamento e l’altro in millisecondi, compreso tra 1.000 e 60.000.
autoplay_speed 1000 Durata della transizione in millisecondi, compresa tra 0 e 10.000.
loop 1 Continua nella stessa direzione oltre il limite dello slider.
nav 1 Mostra i controlli "precedente"/"successivo" in modalità cursore.
Attributo dell’elemento Impostazione predefinita Scopo
name John Doe Nome della persona.
designation vuoto Titolo di lavoro o descrizione.
email vuoto per le voci ripetute Link e-mail facoltativo. Il modulo legacy a voce singola imposta come valore predefinito Questo indirizzo email è protetto dagli spambots. È necessario abilitare JavaScript per vederlo..
url vuoto URL facoltativo collegato alla designazione.
Contenuto vuoto Testo della testimonianza; gli shortcode annidati vengono elaborati.

Blockquote

Formatta il testo racchiuso come citazione.

[blockquotes]A short quotation or customer statement.[/blockquotes]

Accetta il contenuto racchiuso; gli shortcode annidati vengono elaborati.

Mappa

Incorpora una posizione contrassegnata da OpenStreetMap.

[mxmap lat="48.8584" lng="2.2945" zoom="15" height="400" /]
Attributo Predefinito Scopo
lat 41.3850409 Latitudine; intervallo accettato da −85,05112878 a 85,05112878.
lng 2.1747294 Longitudine; intervallo accettato da −180 a 180.
height 200 Altezza del fotogramma in pixel, compresa tra 1 e 3000.
zoom 16 Livello di zoom, compreso tra 0 e 19.

La mappa viene richiesta a OpenStreetMap dal browser del visitatore. In caso di coordinate non valide, vengono utilizzate le coordinate predefinite.

YouTube

Visualizza singoli video di YouTube o i video di un canale. Gli ID dei singoli video sono incorporati nel dominio di YouTube con protezione della privacy potenziata youtube-nocookie.com .

Singoli video

[youtube source="items" slider="1" columns="4"]
[youtube_item id="dQw4w9WgXcQ"][/youtube_item]
[youtube_item id="M7lc1UVf-VE"][/youtube_item]
[/youtube]

Utilizza l’ID del video di 11 caratteri, non l’URL completo.

Video di un canale

[youtube source="channel" channel="UCxxxxxxxxxxxxxxxxxxxxxx" slider="0" limit="15" show_more="1" /]

Inserisci un ID canale, che in genere inizia con UC, anziché con il nome o l’handle del canale. Senza una chiave API, lo shortcode combina gli ID dei video estratti dalla pagina dei video del canale e dal suo feed RSS pubblico. Con una chiave API, richiede la playlist dei video caricati dal canale tramite l’API dati di YouTube; tale modalità richiede un ID canale che inizi con UC e recupera al massimo 50 elementi per richiesta. Non effettua la paginazione di tale richiesta API.

La ricerca del canale avviene durante il rendering della pagina. Al server Joomla deve essere consentito di effettuare richieste HTTPS a YouTube e Google. YouTube potrebbe limitare i risultati della pagina/del feed; una chiave API viene inviata a Google nella richiesta API.

Attributo Predefinito Scopo
source items items o channel.
channel vuoto ID del canale quando si utilizza la sorgente canale.
api_key vuoto Chiave API dati YouTube facoltativa.
limit 15 Numero iniziale e per clic in modalità griglia del canale, compreso tra 1 e 50.
show_more 1 Mostra "Carica altro" nella modalità griglia dei canali se sono stati recuperati più risultati rispetto al limite iniziale.
slider 1 1 cursore; 0 griglia.
height 400 Altezza del video in pixel, compresa tra 100 e 900.
gap 6 Spaziatura in pixel, compresa tra 0 e 50.
round 0 Impostare su 1 per arrotondare gli angoli dell’iframe.
columns 4 Elementi per riga su desktop.
columns_tabl 3 Elementi per riga a 960–1280 px.
columns_tabp 3 Elementi per riga a 768–959 px.
columns_mobl 2 Elementi per riga a 441–767 px.
columns_mobp 1 Elementi per riga fino a 440 px.
autoplay 1 Movimento automatico dello slider; impostare 0 per disattivarlo.
autoplay_timeout 5000 Ritardo in millisecondi, compreso tra 1.000 e 60.000.
autoplay_speed 1000 Transizione in millisecondi, compresa tra 0 e 10.000.
loop 1 Continua nella stessa direzione oltre il limite del cursore.
nav 1 Mostra i controlli precedente/successivo in modalità slider.

Le impostazioni delle colonne sono limitate da 1 a 10. “Carica altro” si applica solo alla fonte del canale in modalità griglia; la modalità cursore visualizza tutti i video recuperati. Sia il cursore di YouTube che quello delle testimonianze mettono in pausa la riproduzione automatica al passaggio del mouse e utilizzano lo stesso comportamento di loop direzionale.

Video YouTube o Vimeo

mxvideo incorpora un singolo URL di YouTube o Vimeo. Questo è distinto dallo shortcode multi-elemento/canale youtube .

[mxvideo height="360"]https://www.youtube.com/watch?v=dQw4w9WgXcQ[/mxvideo]
[mxvideo height="360"]https://youtu.be/dQw4w9WgXcQ[/mxvideo]
[mxvideo height="360"]https://vimeo.com/123456789[/mxvideo]
Attributo Predefinito Scopo
height 281 Altezza dell’iframe in pixel.
Contenuto obbligatorio URL completo e supportato di YouTube o Vimeo.

Shortcode tipografici

Lettera maiuscola

Applica lo stile di iniziale maiuscola alla prima lettera del paragrafo racchiuso.

[dropcap]A paragraph that begins with a decorative initial letter.[/dropcap]

Numero di blocco

Inserisce un indicatore numerato prima del testo.

[blocknumber text="01" size="large" background="#1756a9" color="#fff" type="circle"]Step details[/blocknumber]
Attributo Predefinito Scopo
text 01 Numero/testo dell'indicatore.
size medium small, medium, large, oppure custom.
custom_size 2.5rem Dimensione CSS quando è selezionata l'opzione "personalizzata".
background #000 Colore di sfondo dell'indicatore.
color #666 Colore del testo dell'indicatore.
type predefinito rounded, circle, oppure vuoto.
Contenuto — Testo che segue l'indicatore.

Blocco

Racchiude il contenuto in un blocco con uno stile.

[block background="#f4f7fa" color="#333" padding="20px" border="#ccd" type="rounded"]Highlighted content[/block]
Attributo Predefinito Scopo
background transparent Sfondo CSS.
color #666 Colore del testo.
padding 15px Rientro CSS.
border 0 Colore del bordo in codice esadecimale o un valore di bordo supportato, ad esempio 1px solid #ccc.
type predefinito rounded, circle, oppure vuoto.
Contenuto — Contenuto a blocco.

Bolla

Visualizza un fumetto con la citazione dell'autore.

[bubble author="Jamie" background="#fafafa" color="#333" padding="10px" border="#ccc" type="rounded"]A message in a speech bubble.[/bubble]
Attributo Predefinito Scopo
author Ahmed Etichetta della citazione.
background #CCC Sfondo del fumetto.
color ereditato Colore del testo opzionale.
padding 10px Rientro della bolla.
border 0 Colore esadecimale opzionale del bordo o valore di bordo supportato.
type predefinito rounded, circle, oppure vuoto.
Contenuto — Messaggio della bolla.

Testo di suggerimento

Mostra un testo descrittivo quando si passa il mouse sul testo di attivazione o quando questo è selezionato. Se il testo del tooltip è vuoto, viene visualizzato solo il contenuto di attivazione.

[tooltip text="More details are available here." position="top" style="dark"]Read more[/tooltip]
Attributo Predefinito Valori / scopo
text vuoto Contenuto del tooltip.
position top top, bottom, left, oppure right.
style default default, dark, oppure light.
Contenuto — Testo di attivazione; selezionabile con il focus della tastiera.

Crea un pulsante che apre una finestra di dialogo modale Bootstrap.

[modal title="Information" button="Read details" size="lg" centered="yes"]
Modal body content goes here.
[/modal]
Attributo Predefinito Valori / scopo
title Modal Titolo della finestra di dialogo.
button Open modal Etichetta del pulsante di attivazione.
size predefinito Predefinito, sm, lg, oppure xl.
centered yes Impostare su no per disabilitare il centraggio verticale.
Contenuto — Corpo del modale; gli shortcode annidati vengono elaborati.

Playlist audio/video

Crea un lettore audio o video HTML nativo e un elenco di tracce selezionabili. Gli URL multimediali forniti devono essere riproducibili direttamente dal browser.

[playlist type="audio"]
[playlist_item title="Intro" src="https://example.com/intro.mp3" /]
[playlist_item title="Main track" src="https://example.com/main.mp3" /]
[/playlist]
Tag / attributo Predefinito Scopo
playlist type audio audio o video.
playlist_item src obbligatorio URL diretto del file multimediale; le fonti vuote vengono ignorate.
playlist_item title Titolo del brano generato Etichetta del brano ed etichetta accessibile del lettore.

Inizialmente viene selezionata la prima fonte valida. Selezionando un altro elemento si cambia la fonte del lettore e si avvia la riproduzione; il browser potrebbe richiedere un'azione da parte dell'utente.

Risorse e implementazione

  • plg_mxshortcodes/shortcodes/ contiene renderer di shortcode.
  • plg_mxshortcodes/css/ contiene gli stili degli shortcode; CSS e JavaScript vengono messi in coda quando necessario.
  • plg_mxshortcodes/js/countdown.js, progresspie.js, e playlist.js aggiungono le rispettive interazioni.
  • plg_mxshortcodes/js/youtube.js implementa il comportamento condiviso dello slider di YouTube e delle testimonianze.
  • plg_editors_shortcode/shortcodes.php definisce i campi visualizzati nel selettore di shortcode dell’editor.

Il plugin di sistema elabora gli shortcode nell’output HTML per il client del sito. Gli shortcode all’interno del contenuto di un altro shortcode funzionano laddove il genitore elabori esplicitamente il contenuto annidato; utilizzare i tag di elemento forniti per i componenti ripetibili.

Se i file sorgente degli shortcode vengono modificati, ricompilare plg_mxshortcodes.zip e plg_editors_shortcode.zip, quindi aggiornare pkg_mxshortcodes.zip per distribuire le modifiche tramite il programma di installazione delle estensioni di Joomla.

Articoli correlati

Iscriviti alla nostra newsletter

Rimani aggiornato su vendite, promozioni, aggiornamenti di prodotti e nuove versioni di prodotti.