KAutoSubtitle: documentazione

Dettagli
Categoria: Plugins ed estensioni per Joomla

🇮🇹 Italiano · 🇬🇧 English

Documentazione di KAutoSubtitle

KAutoSubtitle mostra la Meta Description di ogni articolo come sottotitolo sotto il titolo, nelle viste blog di categoria, articoli in evidenza ed elenco articoli. Per la presentazione e il download vedi la pagina di KAutoSubtitle.

Requisiti

  • Joomla 5.x o 6.x
  • PHP 8.1 o superiore

Installazione

  1. Scarica kautosubtitle.zip e installalo da Sistema → Installa → Estensioni → Carica pacchetto.
  2. Vai in Sistema → Gestione → Plugin, cerca "KAutoSubtitle" e abilita "Contenuti - KAutoSubtitle".
  3. Apri il plugin e attiva almeno una vista (Blog, In evidenza o Elenco articoli): per impostazione predefinita sono tutte spente, quindi senza questo passo non compare nessun sottotitolo.

Gli aggiornamenti arrivano da Sistema → Aggiorna → Estensioni.

Come funziona

  • Il sottotitolo è il testo del campo Meta Description dell'articolo (scheda Pubblicazione dell'articolo).
  • Gli articoli senza Meta Description restano senza sottotitolo: il plugin non usa al suo posto il testo dell'articolo.
  • Lo stile predefinito è più piccolo, più chiaro e in corsivo, e prende il colore del testo dal template: funziona con temi chiari e scuri.
  • La pagina del singolo articolo non viene modificata.

Opzioni

Tra parentesi il valore predefinito.

  • Applica alla vista Blog di categoria (No), Applica alla vista Articoli in evidenza (No), Applica alla vista Elenco articoli (No): dove mostrare il sottotitolo. La vista Elenco articoli funziona con il markup standard di Joomla; con un override del template molto personalizzato potrebbe non comparire nulla, senza errori.
  • Categorie incluse: se impostate, il sottotitolo compare solo negli articoli di queste categorie e delle loro sottocategorie. Vuoto = nessuna restrizione.
  • Categorie escluse: gli articoli di queste categorie e delle loro sottocategorie non hanno mai il sottotitolo. Si combina con le incluse, per esempio per escludere una sottocategoria di un ramo incluso.
  • Classe CSS aggiuntiva: una classe già definita nel tuo template, aggiunta alla classe base kautosubtitle-text. Sono accettati solo lettere, numeri, trattini e trattini bassi.
  • Dimensione testo (0.85): solo il numero, l'unità em viene aggiunta in automatico (per esempio 1 o 0.7).
  • Testo in corsivo (Sì) e Testo in grassetto (No).

Domande frequenti

Non compare nessun sottotitolo. Controlla che la vista sia attiva nelle opzioni (sono tutte spente per impostazione predefinita), che l'articolo abbia la Meta Description compilata e che la sua categoria non sia esclusa o fuori dalle categorie incluse.

Voglio uno stile diverso. Usa le opzioni di dimensione, corsivo e grassetto, oppure aggiungi una classe CSS del tuo template. Per regole più specifiche puoi usare la classe kautosubtitle-text nel CSS personalizzato del template.

Disinstallazione

Disinstalla "Contenuti - KAutoSubtitle" da Sistema → Gestione → Estensioni. Il plugin non modifica gli articoli salvati: le Meta Description restano dove sono.

Supporto

Vedi la pagina Supporto.

KAutoSubtitle documentation

KAutoSubtitle shows each article's Meta Description as a subtitle under its title, in category blog, featured and list of articles views. For the product overview and download, see the KAutoSubtitle page.

Requirements

  • Joomla 5.x or 6.x
  • PHP 8.1 or later

Installation

  1. Download kautosubtitle.zip and install it from System → Install → Extensions → Upload Package File.
  2. Go to System → Manage → Plugins, search for "KAutoSubtitle" and enable "Content - KAutoSubtitle".
  3. Open the plugin and enable at least one view (Blog, Featured or List of Articles): they are all off by default, so without this step no subtitle appears.

Updates arrive from System → Update → Extensions.

How it works

  • The subtitle is the article's Meta Description field (Publishing tab of the article).
  • Articles without a Meta Description get no subtitle: the plugin does not fall back to the article text.
  • The default style is smaller, lighter and italic, and takes the text colour from the template: it works on light and dark themes.
  • The single-article page is not changed.

Options

Default values in brackets.

  • Apply to category Blog view (No), Apply to Featured Articles view (No), Apply to List of Articles view (No): where to show the subtitle. The List of Articles view works with Joomla's standard markup; with a heavily customised template override nothing may appear, without errors.
  • Included categories: when set, only articles in these categories and their subcategories get a subtitle. Empty = no restriction.
  • Excluded categories: articles in these categories and their subcategories never get a subtitle. Combines with the included ones, for example to exclude a subcategory of an included branch.
  • Additional CSS class: a class already defined in your template, added to the base kautosubtitle-text class. Only letters, digits, hyphens and underscores are accepted.
  • Text size (0.85): the number only, the em unit is added automatically (for example 1 or 0.7).
  • Italic text (Yes) and Bold text (No).

FAQ

No subtitle appears. Check that the view is enabled in the options (they are all off by default), that the article has a Meta Description and that its category is not excluded or outside the included categories.

I want a different style. Use the size, italic and bold options, or add a CSS class from your template. For more specific rules you can target the kautosubtitle-text class in your template's custom CSS.

Uninstalling

Uninstall "Content - KAutoSubtitle" from System → Manage → Extensions. The plugin never changes saved articles: the Meta Descriptions stay where they are.

Support

See the Support page.