Portfolio dei contenuti - Documentazione Ajax

1. Requisiti

• Joomla con il componente di base "Articoli" (com_content) abilitato.
• Articoli pubblicati a cui il visitatore corrente è autorizzato ad accedere.
• Una directory di cache di Joomla scrivibile quando è abilitato il ridimensionamento delle immagini.
• Joomla 4 o versioni successive per la funzionalità AJAX "Carica altri".

2. Installazione

1. Nell’area di amministrazione di Joomla, apri Sistema > Installa > Estensioni.
2. Carica mod_mx_contentportfolio.zipo installare il pacchetto utilizzando il relativo URL.
3. Apri Estensioni > Moduli, individua "Content Portfolio Ajax" e crea o modifica un'istanza.
4. Imposta lo stato del modulo su Pubblicato e seleziona una posizione del template.
5. In "Assegnazione menu", scegli le pagine in cui deve apparire il portfolio.
6. Salva il modulo e controlla la pagina sul front-end.

Il modulo carica i propri file CSS e JavaScript dalla propria assets . Non rimuovere il assets, core, language, né tmpl .

3. Guida rapida

Per un portfolio di base:

1. Crea o modifica articoli Joomla e pubblicali. Aggiungi un'immagine introduttiva nella scheda "Immagini e link" di ciascun articolo, se sono richieste immagini.
2. Nella scheda “Sorgente” del modulo, selezionare una o più categorie in “Seleziona categoria”.
3. Imposta il "Numero di articoli" sul numero di elementi da mostrare inizialmente.
4. In "Impostazioni", scegli uno stile visivo e imposta il numero di elementi per pagina.
5. Lascia attivate le opzioni "Mostra immagini", "Mostra titolo", "Mostra descrizione" e "Mostra continua a leggere", a meno che il design non richieda diversamente.
6. Pubblica il modulo e verifica che gli articoli selezionati siano visibili.

Se non viene selezionata alcuna categoria, il modulo può utilizzare tutti gli articoli altrimenti idonei. Si consiglia di selezionare le categorie per ottenere un risultato prevedibile.

4. Impostazioni sorgente

Articoli

• L’opzione “Seleziona categoria” limita gli articoli di origine alle categorie selezionate.
• "Articoli delle sottocategorie" include o esclude gli articoli presenti nelle sottocategorie.
• "Livelli" imposta la profondità massima delle sottocategorie.
• "Tag" limita gli articoli di origine ai tag Joomla selezionati.
• "Articoli in primo piano" mostra gli articoli in primo piano, li nasconde o mostra solo gli articoli in primo piano.
• "Ordinamento articoli" e "Direzione di ordinamento" controllano l'ordine della query, inclusi titolo, ID, date, visualizzazioni, ordine del gestore e ordine casuale.
• "Numero di articoli" imposta il numero di articoli caricati per ogni richiesta.
• "Destinazione del link" apre i link nella stessa finestra, in una nuova finestra/scheda o in un popup.
• "Attiva eventi di contenuto" abilita gli eventi del plugin di contenuto di Joomla per gli articoli visualizzati.

Testo e metadati

• Mostra o nascondi il titolo e imposta il numero massimo di caratteri.
• Mostra o nascondi i tag, scegli il numero di tag e posizionali sopra o sotto la descrizione.
• Mostra o nascondi la descrizione e imposta il numero massimo di caratteri.
• Mostra o nascondi il titolo della categoria, l'autore, la data e il link "Leggi tutto".
• Imposta eventuali prefissi per categoria e autore, il formato della data e l’etichetta “Leggi tutto”.

La descrizione viene ricavata dal testo introduttivo dell’articolo. I limiti di caratteri positivi troncano il testo; gli interruttori di visualizzazione nascondono completamente il contenuto.

5. Impostazioni immagini

Abilita l’opzione “Mostra immagini” per gli stili selezionati. Il modulo cerca le immagini nell’ordine specificato da “Ordine immagini”.

• image_intro: l’immagine introduttiva dell’articolo.
• image_fulltext: l’immagine del testo completo dell’articolo.
• inline_introtext: un'immagine presente nel testo introduttivo.
• inline_fulltext: un'immagine presente nel testo completo.
• external: un'immagine con riferimento esterno, se supportata.

Esempio di ordine delle immagini:

image_intro, image_fulltext, inline_introtext, inline_fulltext

Se non viene trovata alcuna immagine, il segnaposto predefinito è modules/mod_mx_contentportfolio/assets/images/noimage.jpg.

Quando il ridimensionamento è abilitato, configurare la funzione di ridimensionamento, il tipo di output, la qualità, la trasparenza, la larghezza e l’altezza. La directory della cache di Joomla deve essere scrivibile in modo che le immagini generate possano essere memorizzate e riutilizzate.

6. Layout e Aspetto

• Stile: scegliere da Stile 1 a Stile 6, oppure Casuale.
• Elementi per vista: scegliere da 1 a 6 colonne.
• Usa dimensioni personalizzate degli elementi: abilita il modello di dimensione del primo elemento.
• Modello di dimensione del primo elemento: valori separati da virgola, ad esempio double, normal, double-height, normal, normal, double-width.
• Larghezza intera: espande il modulo fino alla larghezza della finestra di visualizzazione.
• Allineamento dei filtri: posiziona i filtri a destra, al centro o a sinistra.
• Carica Bootstrap e Carica jQuery: abilitare solo se il modello non li fornisce già.
• CSS personalizzato: aggiunge CSS limitato a questa istanza del modulo.

double si estende su due colonne e due righe, double-width si estende su due colonne e double-height si estende su due righe. I valori non validi o mancanti vengono trattati come normal.

7. Filtri

Abilita "Filtri per categoria" e/o "Filtri per tag" per mostrare i link di filtro sopra la griglia. I filtri per categoria utilizzano l'elenco degli articoli del modulo; quando i filtri per tag sono abilitati con le categorie selezionate, i link dei tag includono tutti i tag degli articoli pubblicati appartenenti a quelle categorie, compresi i tag sugli articoli che superano la dimensione iniziale della pagina.

• Le etichette dei filtri mostrano le etichette delle categorie o dei tag.
• L'etichetta "Mostra tutto" aggiunge il collegamento configurato dal testo "Tutto".
• La modalità di filtro controlla il numero di collegamenti di filtro che un visitatore può selezionare:
• - "Singolo": selezionando un filtro si cancella la selezione precedente. Utilizzare questa opzione quando i visitatori devono sfogliare una categoria o un tag alla volta.
• - "Multiplo": i visitatori possono selezionare diversi filtri per categoria e/o tag. I filtri selezionati vengono evidenziati e possono essere attivati o disattivati.
• La logica dei filtri multipli viene utilizzata solo quando la "Modalità filtro" è impostata su "Multiplo". Essa controlla come vengono combinati i filtri selezionati:
• - "OR": mostra un articolo quando corrisponde ad almeno un filtro selezionato.
• - "AND": mostra un articolo solo se soddisfa tutti i filtri selezionati.
• L’ordinamento dei filtri per tag ordina i tag in base all’ordine nel backend di Joomla o al titolo.

Esempi di modalità di filtro

In modalità Singola, selezionando un filtro si cancella la selezione precedente. In modalità Multipla con logica OR, un articolo deve corrispondere ad almeno un filtro selezionato. Con la logica AND, deve corrispondere a tutti i filtri selezionati. Il link "Tutti" cancella i filtri attivi e mostra tutti gli articoli presenti nei risultati della fonte.

8. Carica altri

Nelle impostazioni, abilita "Mostra Carica altro" e imposta il "Numero di articoli" in base alle dimensioni della pagina. Il pulsante richiede il lotto successivo senza ricaricare completamente la pagina e scompare quando non sono più disponibili articoli corrispondenti.

Impostazioni di stile

Stile

Seleziona la presentazione del portfolio:

• Random: seleziona in modo casuale uno degli stili disponibili.
• Style 1 fino a Style 6: utilizza uno stile specifico per il portfolio.

Impostazione predefinita: Style 2.

Elementi per riga

Imposta il numero di elementi del portfolio visualizzati in ogni riga. I valori disponibili sono 1 fino a 6.

Impostazione predefinita: 3.

Usa dimensioni personalizzate degli elementi

Abilita le dimensioni personalizzate degli elementi nella griglia del portfolio.

• Yes: applica lo schema di dimensioni degli elementi configurato.
• No: utilizza la dimensione standard per tutti gli elementi.

Impostazione predefinita: Yes.

Dimensioni degli elementi

Visibile quando Use Custom items size è abilitato. Immettere un modello separato da virgole per le dimensioni degli elementi. I valori supportati sono:

• normal: una colonna e una riga.
• double: due colonne e due righe.
• double-width: due colonne e una riga.
• double-height: una colonna e due righe.

Esempio:

double,normal,double-height,normal,normal,double-width

Il modello viene applicato in ordine e si ripete per gli elementi successivi caricati con "Carica altro". double-width e double-height sono destinati allo Stile 6. Lo schema predefinito contiene 16 voci.

Impostazioni di “Carica altro”

Mostra "Carica altro"

Determina se il pulsante "Carica altro" è disponibile.

• Yes: consente ai visitatori di richiedere altri articoli.
• No: visualizza solo il set di risultati iniziale.

Impostazione predefinita: Yes.

La funzione "Carica altro" richiede Joomla 4 o versioni successive e un numero di articoli positivo nelle impostazioni della fonte.

Testo di "Carica altro"

Visibile quando Show Load More è abilitato. Imposta il testo visualizzato sul pulsante.

Impostazione predefinita: Load More.

Effetto "Carica altro"

Visibile quando Show Load More è abilitato. Seleziona l’animazione di entrata per gli elementi caricati dal pulsante:

• Appear In
• Simple Fade
• Fade In Up
• Fade In Down
• Zoom In
• Bounce In
• Flip In
• Light Speed In Left
• Rotate In Down Left
• Jack in box
• None

Layout a larghezza intera

Larghezza intera

Controlla la larghezza del modulo:

• Yes: visualizza il portfolio a tutta larghezza della finestra di visualizzazione, indipendentemente dal contenitore del template.
• No: utilizza la larghezza prevista dal layout del template.

Impostazione predefinita: No.

Impostazioni filtro

Posizione dei filtri

Imposta la posizione orizzontale dei filtri per categoria e tag:

• Right
• Center
• Left

Impostazione predefinita: Right.

Mostra etichette dei filtri

Controlla il testo descrittivo visualizzato prima dei controlli dei filtri.

• Yes: mostra le etichette dei filtri per categoria e tag.
• No: nasconde tali etichette.

Impostazione predefinita: Yes.

Filtri per categoria

Controlla se vengono visualizzati i collegamenti dei filtri per categoria.

• Yes: mostra i filtri per le categorie rappresentate dai risultati degli articoli del modulo.
• No: nascondi i filtri per categoria.

Impostazione predefinita: Yes.

Testo "Filtra per categoria"

Visibile quando entrambi Category filters e Show filter labels sono abilitati. Imposta l'etichetta visualizzata per i filtri per categoria.

Impostazione predefinita: Filter by category.

Filtri per tag

Determina se vengono visualizzati i collegamenti ai filtri per tag.

• Yes: mostra i filtri per i tag rappresentati dai risultati degli articoli del modulo.
• No: nascondi i filtri per tag.

Impostazione predefinita: No.

Testo "Filtra per tag"

Visibile quando entrambi Tag filters e Show filter labels sono abilitati. Imposta l'etichetta visualizzata per i filtri per tag.

Impostazione predefinita: Filter by tags.

Ordine dei filtri per tag

Visibile quando Tag filters è abilitato. Ordina i link del filtro per tag in base a:

• Backend Order: l'ordine configurato in Joomla.
• Title: ordine alfabetico dei titoli.

Impostazione predefinita: Backend Order.

Direzione di ordinamento del filtro per tag

Visibile quando Tag filters è abilitato. Imposta la direzione di ordinamento dei tag:

• Ascending
• Descending

Impostazione predefinita: Ascending.

Pulsante "Mostra tutto"

Controlla se viene visualizzato un link per cancellare i filtri attivi.

• Yes: visualizza il link "Tutto".
• No: nasconde il collegamento "Tutto".

Impostazione predefinita: Yes.

Selezione dei filtri

Controlla il modo in cui i visitatori selezionano i filtri:

• One filter at a time: la selezione di un altro filtro sostituisce la selezione corrente.
• Multiple filters: i visitatori possono selezionare più filtri contemporaneamente.

Impostazione predefinita: One filter at a time.

Corrispondenza multipla dei filtri

Visibile quando Filter selection è impostato su Multiple filters. Controlla come vengono combinati i filtri selezionati:

• All selected tags (AND): un articolo deve soddisfare tutti i filtri selezionati.
• Any selected tag (OR): un articolo deve soddisfare almeno uno dei filtri selezionati.

Impostazione predefinita: Any selected tag (OR).

Testo del pulsante "Tutto"

Imposta il testo del link che cancella i filtri attivi e riporta alla lista completa dei risultati.

Impostazione predefinita: All.

9. Risoluzione dei problemi

Non vengono visualizzati articoli

• Verificare che gli articoli siano pubblicati e accessibili.
• Controllare le categorie, i tag, lo stato "in primo piano", la lingua e l'assegnazione al menu.
• Verificare che il modulo sia pubblicato in una posizione visualizzata dal template attivo.

Mancano le immagini

• Aggiungere un'immagine introduttiva o a tutto campo all'articolo.
• Abilitare la fonte dell'immagine corrispondente e inserirla nell'ordine delle immagini.
• Controlla il percorso del segnaposto e i permessi della directory della cache.

I filtri non mostrano le opzioni previste

I filtri vengono creati dai risultati degli articoli del modulo, non da ogni categoria o tag presente in Joomla. Amplia la selezione della fonte e verifica che gli articoli pertinenti siano stati pubblicati.

L'opzione "Carica altro" non è visibile

Verifica che sia installato Joomla 4 o una versione più recente, che l’opzione "Carica altro" sia visibile, che il conteggio degli articoli sia positivo e che ci siano risultati iniziali sufficienti.

Si verificano conflitti di stile o JavaScript

Disattiva le opzioni "Carica jQuery" o "Carica Bootstrap" se il template carica già tali librerie. Svuota la cache di Joomla e del browser.

10. Aggiornamento

Eseguire il backup della configurazione del modulo e dei file del sito prima dell’aggiornamento. Installare il file ZIP più recente tramite il programma di installazione delle estensioni di Joomla. Il modulo dichiara un server di aggiornamento, pertanto Joomla potrebbe proporre aggiornamenti anche quando il server è raggiungibile.