KAutoReadMore: documentazione

Dettagli
Categoria: Plugins ed estensioni per Joomla

🇮🇹 Italiano · 🇬🇧 English

Documentazione di KAutoReadMore

KAutoReadMore accorcia automaticamente il testo degli articoli che non hanno un'interruzione "Leggi tutto" e aggiunge il pulsante, nelle viste blog, elenco e articoli in evidenza. Per la presentazione e il download vedi la pagina di KAutoReadMore.

Requisiti

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

Installazione

  1. Scarica kautoreadmore.zip e installalo da Sistema → Installa → Estensioni → Carica pacchetto.
  2. Vai in Sistema → Gestione → Plugin, cerca "KAutoReadMore" e abilita "Contenuti - KAutoReadMore": come ogni nuovo plugin parte disabilitato.
  3. Apri il plugin per regolare le opzioni. I valori predefiniti vanno già bene per la maggior parte dei siti.

Gli aggiornamenti arrivano da Sistema → Aggiorna → Estensioni.

Come funziona

  • Nelle viste blog di categoria, elenco di categoria e articoli in evidenza, se un articolo non ha un'interruzione "Leggi tutto" e il testo supera il limite, il plugin lo accorcia e aggiunge il pulsante.
  • Il taglio non spezza mai una parola né un tag HTML: grassetti, link ed elenchi restano chiusi correttamente.
  • Il pulsante usa il layout nativo di Joomla, quindi ha lo stesso aspetto di un "Leggi tutto" manuale, compresi gli override del template.
  • Gli articoli con un'interruzione manuale non vengono toccati (salvo l'opzione "Ignora 'Leggi tutto' manuali").
  • La pagina del singolo articolo non viene mai modificata.

Opzioni

Tra parentesi il valore predefinito.

  • Modalità di troncamento (Caratteri): il limite è espresso in caratteri o in parole.
  • Limite caratteri (300, da 20 a 5000) oppure Limite parole (60, da 5 a 1000): la lunghezza massima del testo visibile.
  • Risparmio minimo per troncare (30): se il taglio toglierebbe meno di questa quantità, il testo resta intero. Evita di tagliare due parole per aggiungere un pulsante. 0 disattiva il controllo.
  • Testo di troncamento (…): aggiunto alla fine del testo accorciato, per esempio "…" oppure "[continua]".
  • Ignora 'Leggi tutto' manuali (No): se attivo, il troncamento automatico vale per tutti gli articoli, anche quelli con l'interruzione manuale. Utile per avere estratti tutti della stessa lunghezza.
  • Categorie escluse e Articoli esclusi (per ID): non vengono mai accorciati. L'ID dell'articolo si trova nell'elenco articoli o nell'URL di modifica (…&id=42).
  • Allineamento pulsante Leggi tutto (Sinistra): sinistra, centro o destra.
  • Applica alla vista Articoli in evidenza (Sì) e Applica alle viste Elenco/Blog di categoria (Sì).

Domande frequenti

Il pulsante non compare. Controlla che il plugin sia abilitato, che la vista sia tra quelle attive nelle opzioni e che il testo superi davvero il limite più il risparmio minimo. Verifica anche che nella voce di menu non sia nascosto il link "Leggi tutto" né nelle opzioni dell'articolo o della categoria (opzione "Leggi tutto" su Mostra): il plugin rispetta questa impostazione.

Compaiono due pulsanti. Succede solo se il template o un altro plugin aggiunge un proprio pulsante: KAutoReadMore non agisce sugli articoli che hanno già un'interruzione manuale.

Disinstallazione

Disinstalla "Contenuti - KAutoReadMore" da Sistema → Gestione → Estensioni. Il plugin non modifica gli articoli salvati: il troncamento avviene solo in visualizzazione, quindi dopo la disinstallazione i testi tornano a essere mostrati come prima.

Supporto

Vedi la pagina Supporto.

KAutoReadMore documentation

KAutoReadMore automatically shortens the text of articles that have no "Read more" split and adds the button, in blog, list and featured views. For the product overview and download, see the KAutoReadMore page.

Requirements

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

Installation

  1. Download kautoreadmore.zip and install it from System → Install → Extensions → Upload Package File.
  2. Go to System → Manage → Plugins, search for "KAutoReadMore" and enable "Content - KAutoReadMore": like every new plugin it starts disabled.
  3. Open the plugin to adjust the options. The defaults suit most sites.

Updates arrive from System → Update → Extensions.

How it works

  • In category blog, category list and featured views, when an article has no "Read more" split and its text exceeds the limit, the plugin shortens it and adds the button.
  • It never cuts a word or an HTML tag in half: bold text, links and lists stay properly closed.
  • The button uses Joomla's native layout, so it looks exactly like a manual "Read more", template overrides included.
  • Articles with a manual split are left alone (unless "Ignore manual 'Read more' splits" is on).
  • The single-article page is never changed.

Options

Default values in brackets.

  • Truncation mode (Characters): the limit is in characters or in words.
  • Character limit (300, 20 to 5000) or Word limit (60, 5 to 1000): the maximum length of the visible text.
  • Minimum savings to truncate (30): if the cut would remove less than this, the text stays whole. Avoids cutting two words just to add a button. 0 disables the check.
  • Truncation text (…): appended to the shortened text, for example "…" or "[continues]".
  • Ignore manual 'Read more' splits (No): when on, automatic truncation applies to every article, including those with a manual split. Useful for uniform excerpt lengths.
  • Excluded categories and Excluded articles (by ID): never shortened. The article ID is shown in the article list or in the edit URL (…&id=42).
  • Read more button alignment (Left): left, center or right.
  • Apply to Featured Articles view (Yes) and Apply to Category Blog/List views (Yes).

FAQ

The button does not appear. Check that the plugin is enabled, that the view is enabled in the options and that the text really exceeds the limit plus the minimum savings. Also check that the menu item does not hide the "Read More" link or in the article or category options ("Read More" set to Show): the plugin respects that setting.

Two buttons appear. This only happens when the template or another plugin adds its own button: KAutoReadMore does not act on articles that already have a manual split.

Uninstalling

Uninstall "Content - KAutoReadMore" from System → Manage → Extensions. The plugin never changes saved articles: truncation only happens when pages are displayed, so after uninstalling the texts are shown as before.

Support

See the Support page.