Contenuto
Il plugin Contenuti espone gli strumenti di gestione editoriale di Joomla: articoli, categorie, tag e valori dei campi. È la base del lavoro redazionale gestito dall'IA.
Ogni strumento di gestione richiede, nel componente Joomla interessato, il permesso indicato nella colonna «Diritti necessari». Gli strumenti di lettura non richiedono alcun permesso specifico. L'account connesso deve disporre del diritto richiesto, altrimenti lo strumento viene rifiutato.
Articoli
Creare, modificare, cercare, pubblicare ed eliminare articoli, con accesso alla cronologia delle versioni. Componente: Articoli (com_content).
| Strumento | Funzione | Diritti necessari (ACL) |
|---|---|---|
create_article | Creare un articolo | Creare — core.create |
update_article | Modificare un articolo | Modificare — core.edit |
get_article | Leggere un articolo | Nessuno (lettura) |
search_articles | Cercare articoli | Nessuno (lettura) |
set_article_state | Pubblicare / annullare la pubblicazione / archiviare / spostare nel cestino | Modificare lo stato — core.edit.state |
delete_article | Eliminare (cestino; definitivo = permanent + confirm) | Eliminare — core.delete |
reorder_article | Riordinare | Modificare lo stato — core.edit.state |
list_article_versions | Elencare la cronologia delle versioni | Modificare — core.edit |
get_article_version | Leggere una versione | Modificare — core.edit |
diff_article_versions | Confrontare due versioni | Modificare — core.edit |
restore_article_version | Ripristinare una versione | Modificare — core.edit |
create_article e update_article coprono tutte le schede dell'editor Joomla: contenuto, immagini e link, date di creazione e pubblicazione, evidenza, autore, nota, opzioni dell'articolo e metadati. Le date devono essere espresse nel formato ISO 8601; in assenza di fuso orario, vengono interpretate secondo il fuso orario del sito.
Categorie
Organizzare la struttura gerarchica dei contenuti. Componente: Articoli (com_content).
| Strumento | Funzione | Diritti necessari (ACL) |
|---|---|---|
list_categories | Elencare le categorie | Nessuno (lettura) |
get_category | Leggere una categoria (con i valori dei relativi campi) | Nessuno (lettura) |
create_category | Creare una categoria | Creare — core.create |
update_category | Modificare una categoria | Modificare — core.edit |
delete_category | Eliminare una categoria | Eliminare — core.delete |
Tag
Gestire i tag e associarli agli articoli. Componente: Tag (com_tags).
| Strumento | Funzione | Diritti necessari (ACL) |
|---|---|---|
list_tags | Elencare i tag | Nessuno (lettura) |
get_tag | Leggere un tag | Nessuno (lettura) |
create_tag | Creare un tag | Creare — core.create |
update_tag | Modificare un tag | Modificare — core.edit |
delete_tag | Eliminare un tag | Eliminare — core.delete |
Campi personalizzati
Impostare i valori dei campi personalizzati di un articolo o di una categoria. Le definizioni dei campi (creazione, tipi, gruppi) fanno capo al plugin Campi personalizzati. Componente: Articoli (com_content).
| Strumento | Funzione | Diritti necessari (ACL) |
|---|---|---|
list_article_fields | Elencare i campi applicabili agli articoli di una categoria | Nessuno (lettura) |
list_category_fields | Elencare i campi applicabili alle categorie (filtrati in base all'assegnazione se category_id) | Nessuno (lettura) |
reorder_article_field | Riordinare un campo personalizzato tra quelli del relativo contesto e gruppo — qualsiasi contesto: articoli, categorie, utenti (nonostante il nome) | Modificare lo stato — core.edit.state |
I valori vengono impostati tramite l'argomento fields di create_article / update_article e di create_category / update_category (diritto Creare o Modificare) e vengono letti nella chiave fields di get_article / get_category. Vengono applicati solo i campi assegnati alla categoria; gli altri vengono segnalati come ignorati. I valori strutturati (sottoform, elenchi multipli) devono essere scritti nel formato restituito dalla lettura, ad esempio {"row0": {"field12": "…"}} per un sottoform.
Esempi di prompt
«Crea un articolo «I nostri orari estivi» nella categoria Notizie e pubblicalo.»
«Archivia gli articoli della categoria Promozioni 2024.»
«Ripristina la versione di ieri dell'articolo della home page.»
«Aggiungi una domanda alle FAQ della categoria Tariffe.»
Sicurezza e ACL
Le azioni rispettano l'ACL di Joomla: l'assistente può creare, modificare o eliminare solo ciò che il tuo account è autorizzato a gestire, nelle categorie consentite. L'eliminazione definitiva di un articolo richiede una conferma esplicita (confirm=true).