📦 Plugin Richiesti

Prima di installare EO Suite Complete, assicurati di avere questi plugin attivi.

✅ Obbligatori

⚡ Consigliati

⚪ Opzionali

📋 Ordine di Installazione

• Installa e attiva Blocksy (tema)
• Installa plugin obbligatori
• Installa EO Suite Complete
• Esegui Setup Wizard
• Installa plugin opzionali se necessari

💡 Note

Ultimate Member: Usato per mostrare voci menu diverse a utenti loggati/non loggati. In futuro le funzioni subscription potrebbero essere gestite da piattaforma esterna.

📚 Indice Documentazione

EO Suite Complete - Versione 2.0.0 | Gennaio 2026

Cos'è EO Suite Complete?

EO Suite Complete è un plugin WordPress all-in-one per la rete Esperanto Oggi. Unifica in un unico plugin tutte le funzionalità necessarie per gestire un blog multilingua con sistema editoriale collaborativo.

🎯 Funzionalità Principali

• Editor semplificato per autori con workflow di revisione
• Assistente AI con Claude per migliorare testi e SEO
• Pagine standard (Login, Registrazione, Privacy, Cookie)
• Sistema newsletter multi-provider
• Documentazione integrata multilingua

📋 Documenti Disponibili

#	Documento	Descrizione
00	Plugin Richiesti	Prerequisiti e dipendenze
01	Indice	Questa pagina
02	Installazione	Guida passo-passo
03	Editor Autori	Modulo core obbligatorio
04	Assistente AI	Integrazione Claude
05	Login e Registrazione	Accesso utenti
06	Privacy e Cookie	Conformità GDPR
07	Chi Siamo	Pagina team
08	Bacheca Autori	Forum interno
09	Segnala Notizia	Form pubblico
10	Newsletter	Email marketing
11	Documentazione	Questo sistema
12	Configurazione	Impostazioni JSON
13	Troubleshooting	Risoluzione problemi

🚀 Quick Start

1. Installa i plugin richiesti (vedi doc. 00)
2. Carica e attiva EO Suite Complete
3. Vai su EO Suite → Setup ed esegui il wizard
4. Attiva i moduli desiderati in EO Suite → Moduli
5. Configura le pagine con gli shortcode

🔧 Guida Installazione

Segui questa guida per installare EO Suite Complete sul tuo sito WordPress.

📋 Prima di Iniziare

Verifica di avere:

• WordPress 6.0 o superiore
• PHP 8.0 o superiore
• Plugin obbligatori installati (vedi doc. 00)
• Accesso amministratore al sito

📦 Installazione Plugin

1. Scarica il file eo-suite-complete.zip
2. Vai su Plugin → Aggiungi nuovo → Carica plugin
3. Seleziona il file ZIP
4. Clicca Installa ora
5. Clicca Attiva plugin

⚙️ Setup Wizard

Dopo l'attivazione, esegui il Setup Wizard:

1. Vai su EO Suite → Setup
2. Step 1: Seleziona i moduli da attivare
3. Step 2: Crea le pagine standard (Login, Privacy, ecc.)
4. Step 3: Configura le impostazioni base
5. Step 4: Verifica e completa

📁 Cartelle Create

Il plugin crea automaticamente:

Cartella	Scopo
/wp-content/eo-docs/	File documentazione JSON
/wp-content/eo-config/	File configurazione

✅ Verifica Installazione

Dopo l'installazione verifica:

• ☐ Menu "EO Suite" visibile nel pannello admin
• ☐ Dashboard mostra tutti i moduli
• ☐ Nessun errore PHP nei log
• ☐ Cartelle create con permessi corretti

⬆️ Aggiornamenti

Per aggiornare il plugin:

1. Scarica la nuova versione
2. Vai su Plugin → Aggiungi nuovo → Carica plugin
3. WordPress chiederà se vuoi sostituire - conferma
4. Il plugin si aggiornerà mantenendo le impostazioni

✏️ Modulo Editor Autori

Stato: Obbligatorio (sempre attivo)

Questo modulo semplifica l'esperienza degli autori nel pannello WordPress.

🎯 Funzionalità

• Menu admin semplificato per ruoli Autore/Collaboratore
• Workflow "Invia per revisione" (autori non possono pubblicare)
• Ogni autore vede solo i propri articoli
• Dashboard personalizzata con statistiche
• Notifiche email automatiche

👥 Come Funziona per gli Autori

Menu Visibile

Gli autori vedono solo:

• I miei articoli - Lista propri articoli
• Scrivi nuovo - Crea articolo
• Media - Libreria immagini
• Profilo - Impostazioni personali

Workflow Pubblicazione

1. L'autore scrive l'articolo
2. Clicca "Invia per Revisione" (non "Pubblica")
3. L'articolo va in stato "In attesa"
4. Editor/Admin riceve notifica email
5. Editor revisiona e pubblica
6. L'autore riceve email di conferma

📧 Notifiche Email

Evento	Destinatario
Articolo inviato per revisione	Admin/Editor
Articolo pubblicato	Autore

⚙️ Impostazioni

Nessuna configurazione richiesta. Il modulo funziona automaticamente in base al ruolo utente.

💡 Note

• Gli admin e editor vedono il menu completo
• Gli autori non possono modificare articoli già pubblicati
• Gli autori possono modificare i propri articoli in bozza o in attesa

🤖 Modulo Assistente AI

Stato: Opzionale

Integra Claude AI di Anthropic per assistere gli autori nella scrittura e ottimizzazione SEO.

🎯 Funzionalità

⚙️ Configurazione

API Key Globale (per tutti gli autori)

• Vai su EO Suite → Assistente AI
• Inserisci la API Key nel campo "API Key Globale"
• Clicca Salva

API Key Personali (opzionale)

Se abilitato, ogni autore può usare la propria API key:

1. Spunta "Permetti chiavi personali" nelle impostazioni
2. Gli autori inseriscono la key nel proprio Profilo

Ottenere una API Key

1. Vai su console.anthropic.com
2. Crea un account
3. Genera una API Key (inizia con sk-ant-api03-...)

📍 Dove si Trova

Il pannello AI appare sopra l'editor quando si modifica un articolo.

💡 Consigli d'Uso

• Migliora Testo: Usalo dopo aver scritto la bozza completa
• Struttura H2/H3: Ideale per articoli lunghi (500+ parole)
• Proponi Titoli: Scegli il titolo più accattivante dalla lista
• Frase Chiave: Copia e incolla in All In One SEO

⚠️ Note Importanti

• Richiede Classic Editor (non funziona con Gutenberg)
• Ogni richiesta consuma crediti API
• Il testo non viene mai salvato sui server Anthropic

🔐 Modulo Login e Registrazione

Stato: Opzionale

Fornisce pagine personalizzate per accesso e registrazione utenti.

🎯 Funzionalità

• Form login personalizzato con stile EO
• Form registrazione con campi aggiuntivi
• Integrazione con Ultimate Member per menu condizionali
• Redirect automatico dopo login
• Messaggi di errore in italiano

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_login]	Form di login
[eo_register]	Form di registrazione

📄 Creare le Pagine

Pagina Login

1. Crea nuova pagina
2. Titolo: Login
3. Slug: login
4. Contenuto: [eo_login]
5. Pubblica

Pagina Registrazione

1. Crea nuova pagina
2. Titolo: Registrazione
3. Slug: registrazione
4. Contenuto: [eo_register]
5. Pubblica

⚠️ Importante: Pagine Ultimate Member

Ultimate Member crea automaticamente le proprie pagine (Login, Register, Account, ecc.). Per evitare conflitti:

1. Vai su Pagine → Tutte le pagine
2. Elimina o metti in bozza le pagine create da UM:
   • Login (di UM)
   • Register (di UM)
   • Account (di UM)
   • Password Reset (di UM)
3. Usa solo le pagine EO con gli shortcode [eo_login] e [eo_register]

⚙️ Configurazione

Vai su EO Suite → Moduli → Login per:

• Abilitare/disabilitare registrazione pubblica
• Scegliere ruolo predefinito nuovi utenti
• Personalizzare URL redirect dopo login
• Configurare campi obbligatori

🔗 Integrazione Menu

Con Ultimate Member puoi mostrare voci diverse:

Utente NON loggato vede:

• Login
• Registrati

Utente loggato vede:

• I miei articoli
• Scrivi articolo
• Profilo
• Esci

💡 Note

• La registrazione crea utenti con ruolo "Abbonato" di default
• L'admin deve promuovere manualmente ad "Autore" chi vuole scrivere
• Il form include protezione anti-spam base

🔒 Modulo Privacy e Cookie

Stato: Opzionale

Fornisce pagine legali pre-configurate per la conformità GDPR.

🎯 Funzionalità

• Template Privacy Policy completo
• Template Cookie Policy completo
• Testi personalizzabili
• Conformità GDPR/normativa italiana

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_privacy_policy]	Pagina Privacy Policy
[eo_cookie_policy]	Pagina Cookie Policy

📄 Creare le Pagine

Pagina Privacy Policy

1. Crea nuova pagina
2. Titolo: Privacy Policy
3. Slug: privacy-policy
4. Contenuto: [eo_privacy_policy]
5. Pubblica
6. Vai su Impostazioni → Privacy e selezionala come pagina ufficiale

Pagina Cookie Policy

1. Crea nuova pagina
2. Titolo: Cookie Policy
3. Slug: cookie-policy
4. Contenuto: [eo_cookie_policy]
5. Pubblica

⚙️ Personalizzazione

Vai su EO Suite → Moduli → Privacy per modificare:

• Nome organizzazione/titolare
• Indirizzo e contatti
• Email DPO (se presente)
• Elenco servizi terze parti
• Tipi di cookie utilizzati

⚠️ Importante

I template forniscono una base di partenza. È responsabilità del gestore del sito:

• Verificare la completezza dei testi
• Adattare alle specifiche del proprio sito
• Consultare un legale se necessario
• Mantenere aggiornate le informazioni

💡 Cookie di Terze Parti

Se utilizzi questi servizi, assicurati di menzionarli:

👥 Modulo Chi Siamo

Stato: Opzionale

Crea una pagina "Chi Siamo" completa con team, autori e statistiche del blog.

🎯 Funzionalità

• Sezione presentazione blog
• Gestione team (fondatori e membri)
• Lista automatica autori del blog
• Statistiche in tempo reale
• Sezione contatti
• Supporto multilingua con Polylang

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_chi_siamo]	Pagina completa con tutte le sezioni
[eo_about]	Solo sezione presentazione
[eo_fondatori]	Solo sezione fondatori
[eo_team]	Solo altri membri team
[eo_lista_autori]	Solo lista autori blog
[eo_contatti]	Solo sezione contatti
[eo_statistiche]	Solo statistiche blog

📄 Creare la Pagina

1. Crea nuova pagina
2. Titolo: Chi Siamo
3. Slug: chi-siamo
4. Contenuto: [eo_chi_siamo]
5. Pubblica

👤 Gestire il Team

Aggiungere un Membro

1. Vai su EO Suite → Chi Siamo → Team
2. Clicca Aggiungi Membro
3. Compila: Nome, Ruolo, Descrizione, Foto
4. Seleziona tipo: Fondatore o Altro Membro
5. Imposta ordine di visualizzazione
6. Pubblica

Tipi di Membri

Tipo	Visualizzazione
Fondatore	Sezione dedicata, card più grande
Altro Membro	Sezione team, card standard

⚙️ Personalizzazione Testi

Vai su EO Suite → Chi Siamo → Impostazioni per modificare:

• Testo presentazione blog
• Titoli delle sezioni
• Email contatti (redazione, tecnico)
• Etichette statistiche

🌐 Multilingua

Con Polylang attivo:

1. Seleziona la lingua nel selettore in alto
2. Modifica i testi per quella lingua
3. Salva
4. Ripeti per ogni lingua

📊 Statistiche Automatiche

La sezione statistiche mostra automaticamente:

• Numero articoli pubblicati
• Numero autori attivi
• Numero categorie
• Anno di inizio blog

📋 Modulo Bacheca Autori

Stato: Opzionale

Forum interno per la comunicazione tra redazione e autori.

🎯 Funzionalità

• Bacheca messaggi visibile solo agli utenti loggati
• Annunci dalla redazione
• Discussioni tra autori
• Notifiche nuovi messaggi
• Moderazione da parte degli admin

📍 Dove si Trova

La bacheca appare automaticamente nella dashboard degli autori quando accedono al pannello WordPress.

👥 Chi Può Usarla

Ruolo	Permessi
Amministratore	Scrive, modifica, elimina tutti i messaggi
Editor	Scrive, modifica propri messaggi, modera
Autore	Scrive e modifica propri messaggi
Collaboratore	Solo lettura

📝 Tipi di Messaggi

Tipo	Icona	Uso
Annuncio	📢	Comunicazioni importanti dalla redazione
Discussione	💬	Conversazioni tra autori
Suggerimento	💡	Idee e proposte

⚙️ Configurazione

Vai su EO Suite → Moduli → Bacheca per:

• Abilitare/disabilitare la bacheca
• Scegliere chi può scrivere messaggi
• Attivare notifiche email per nuovi annunci
• Impostare numero messaggi visibili

💡 Consigli d'Uso

• Usa gli Annunci per linee guida editoriali
• Incoraggia gli autori a proporre Suggerimenti
• Rispondi tempestivamente alle discussioni
• Fissa i messaggi importanti in alto

📰 Modulo Segnala Notizia

Stato: Opzionale

Form pubblico per permettere ai visitatori di segnalare notizie alla redazione.

🎯 Funzionalità

• Form pubblico accessibile a tutti
• Campi personalizzabili
• Notifica email alla redazione
• Anti-spam integrato
• Archivio segnalazioni nel pannello admin

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_segnala_notizia]	Form completo per segnalazioni

📄 Creare la Pagina

1. Crea nuova pagina
2. Titolo: Segnala una Notizia
3. Slug: segnala-notizia
4. Contenuto: [eo_segnala_notizia]
5. Pubblica

📋 Campi del Form

Campo	Obbligatorio	Descrizione
Nome	✅	Nome del segnalatore
Email	✅	Per eventuali contatti
Titolo notizia	✅	Breve titolo della segnalazione
Descrizione	✅	Dettagli della notizia
Link fonte	⚪	URL della fonte originale
Allegato	⚪	Immagine o documento

⚙️ Configurazione

Vai su EO Suite → Moduli → Segnala Notizia per:

• Email destinatario notifiche
• Attivare/disattivare campi opzionali
• Personalizzare messaggio di conferma
• Configurare anti-spam

📬 Gestione Segnalazioni

Le segnalazioni ricevute sono visibili in:

EO Suite → Segnalazioni

Da qui puoi:

• Visualizzare tutte le segnalazioni
• Segnare come "Letta" o "Da elaborare"
• Convertire in bozza articolo
• Eliminare segnalazioni spam

💡 Consigli d'Uso

• Aggiungi il link alla pagina nel menu principale
• Promuovi la pagina sui social
• Rispondi alle segnalazioni valide
• Controlla regolarmente l'archivio

📧 Modulo Newsletter

Stato: Opzionale

Sistema di iscrizione newsletter con supporto multi-provider.

🎯 Funzionalità

• Form iscrizione personalizzabile
• Integrazione con provider email esterni
• Double opt-in per conformità GDPR
• Widget per sidebar/footer
• Gestione liste multiple

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_newsletter]	Form iscrizione standard
[eo_newsletter style="compact"]	Versione compatta per sidebar

🔗 Provider Supportati

Provider	Stato
Brevo (ex Sendinblue)	✅ Supportato
Mailchimp	✅ Supportato
MailerLite	🔜 Prossimamente

⚙️ Configurazione Brevo

1. Vai su EO Suite → Moduli → Newsletter
2. Seleziona provider: Brevo
3. Inserisci API Key (da dashboard Brevo)
4. Seleziona la Lista di destinazione
5. Salva

Ottenere API Key Brevo

1. Accedi a app.brevo.com
2. Vai su Impostazioni → API Keys
3. Crea nuova chiave
4. Copia e incolla nel plugin

⚙️ Configurazione Mailchimp

1. Vai su EO Suite → Moduli → Newsletter
2. Seleziona provider: Mailchimp
3. Inserisci API Key (da dashboard Mailchimp)
4. Seleziona Audience/Lista
5. Salva

📄 Aggiungere il Form

In una pagina

[eo_newsletter]

In sidebar/footer

1. Vai su Aspetto → Widget
2. Aggiungi widget HTML personalizzato
3. Inserisci: [eo_newsletter style="compact"]

🔮 Sviluppi Futuri

Funzionalità	Descrizione	Stato
Invio automatico eventi	Quando si pubblica un articolo su un evento futuro, invio automatico newsletter agli iscritti	🔜 In sviluppo
Template email	Template personalizzabili per diverse tipologie di contenuto	🔜 Pianificato
Segmentazione	Invio a liste specifiche in base alla categoria articolo	🔜 Pianificato

💡 Consigli d'Uso

• Usa il double opt-in per evitare spam
• Offri un incentivo all'iscrizione
• Posiziona il form in punti strategici (fine articolo, sidebar)
• Mantieni la lista pulita eliminando indirizzi inattivi

📁 Modulo Documentazione

Stato: Opzionale

Sistema di documentazione integrato multilingua per gestire guide e manuali.

🎯 Funzionalità

• Documentazione in formato JSON
• Supporto multilingua (un file per lingua)
• Due modalità di editing: JSON e Visuale
• Visualizzazione frontend per utenti

📍 Strumenti Disponibili

Strumento	Menu	Uso
Docs Manager	EO Suite → Docs Manager	Editing JSON diretto
Editor Documenti	EO Suite → Editor Documenti	Editing visuale WYSIWYG

📝 Docs Manager (JSON)

Per utenti tecnici che preferiscono modificare il JSON direttamente:

• Lista file JSON disponibili
• Editor con validazione JSON
• Template predefiniti
• Formattazione automatica

✏️ Editor Documenti (Visuale)

Per tutti gli utenti, interfaccia semplificata:

• Lista documenti nella sidebar
• Editor WYSIWYG (come scrivere in Word)
• Drag & drop per riordinare
• Selezione lingua con un click
• Nessuna conoscenza tecnica richiesta

Come Usare l'Editor Visuale

1. Vai su EO Suite → Editor Documenti
2. Seleziona la lingua (🇮🇹 IT, 🌍 EO, ecc.)
3. Clicca su un documento nella lista
4. Modifica titolo e contenuto
5. Clicca 💾 Salva Documento
6. Clicca 💾 Salva Tutto per salvare il file

📂 Struttura File

I file sono salvati in: /wp-content/eo-docs/

File	Lingua
docs-it.json	Italiano
docs-eo.json	Esperanto
docs-es.json	Spagnolo
docs-en.json	Inglese

➕ Creare Nuova Lingua

1. Vai su Editor Documenti
2. Clicca ➕ Nuova Lingua
3. Inserisci codice lingua (es: fr, de)
4. Viene creato il file docs-XX.json vuoto
5. Aggiungi i documenti tradotti

📝 Shortcode Disponibili

Shortcode	Descrizione
[eo_docs]	Mostra indice documentazione
[eo_docs doc="installazione"]	Mostra documento specifico

💡 Consigli d'Uso

• Usa l'Editor Visuale per modifiche quotidiane
• Usa il Docs Manager solo per operazioni avanzate
• Mantieni la documentazione aggiornata in tutte le lingue
• Usa ID descrittivi per i documenti (es: guida-installazione)

⚙️ Modulo Configurazione

Stato: Opzionale

Editor per gestire file di configurazione JSON del sito.

🎯 Funzionalità

• Gestione centralizzata configurazioni
• Editor JSON con validazione
• Backup automatico prima delle modifiche
• Configurazioni separate per ambiente (dev/prod)

📍 Dove si Trova

EO Suite → Configurazione

📂 File di Configurazione

I file sono salvati in: /wp-content/eo-config/

File	Scopo
config.json	Configurazione principale
emails.json	Template email
categories.json	Categorie predefinite

⚙️ Configurazioni Disponibili

Generali

Chiave	Descrizione
site_name	Nome del sito
default_language	Lingua predefinita
admin_email	Email amministratore

Moduli

Chiave	Descrizione
modules_enabled	Lista moduli attivi
ai_model	Modello Claude da usare
newsletter_provider	Provider newsletter attivo

Email

Chiave	Descrizione
email_from_name	Nome mittente
email_from_address	Indirizzo mittente
smtp_settings	Configurazione SMTP

💡 Quando Usarlo

Usa il Config Editor per:

• Modifiche rapide alle impostazioni
• Backup/ripristino configurazioni
• Trasferimento configurazioni tra siti
• Debug problemi di configurazione

⚠️ Attenzione

• Modifica i file JSON solo se sai cosa fai
• Un errore di sintassi può causare malfunzionamenti
• Usa sempre il pulsante Valida JSON prima di salvare
• Il sistema crea backup automatici (ultimi 5)

🔄 Backup e Ripristino

Backup Manuale

1. Vai su EO Suite → Configurazione
2. Clicca 📥 Esporta Tutto
3. Salva il file ZIP sul tuo computer

Ripristino

1. Vai su EO Suite → Configurazione
2. Clicca 📤 Importa
3. Seleziona il file ZIP di backup
4. Conferma il ripristino

🔧 Risoluzione Problemi

Soluzioni ai problemi più comuni con EO Suite Complete.

🔴 Problemi di Installazione

Il plugin non si attiva

Causa: Versione PHP troppo vecchia

Soluzione:

• Verifica la versione PHP (richiesto 8.0+)
• Contatta l'hosting per aggiornare PHP
• Riprova l'attivazione

Errore "Plugin già esistente"

Causa: Versione precedente non rimossa

Soluzione:

1. Vai su Plugin
2. Disattiva ed elimina la versione vecchia
3. Reinstalla la nuova versione

🔴 Problemi Assistente AI

Il pannello AI non appare

Causa: Gutenberg attivo invece di Classic Editor

Soluzione:

1. Installa e attiva Classic Editor
2. Ricarica la pagina di modifica articolo

Errore "API Key non valida"

Causa: Chiave API errata o scaduta

Soluzione:

1. Vai su console.anthropic.com
2. Verifica che la chiave sia attiva
3. Genera una nuova chiave se necessario
4. Aggiorna in EO Suite → Assistente AI

Errore "Credito insufficiente"

Causa: Crediti Anthropic esauriti

Soluzione:

1. Accedi alla console Anthropic
2. Aggiungi credito al tuo account
3. Riprova

🔴 Problemi Pagine

Shortcode non funziona (mostra testo invece del form)

Causa: Modulo non attivato

Soluzione:

1. Vai su EO Suite → Moduli
2. Attiva il modulo corrispondente
3. Ricarica la pagina

Pagina mostra errore 404

Causa: Permalink non aggiornati

Soluzione:

1. Vai su Impostazioni → Permalink
2. Clicca Salva modifiche (senza cambiare nulla)
3. Riprova

🔴 Problemi Menu

Voci menu non cambiano per utenti loggati/non loggati

Causa: Ultimate Member non configurato correttamente

Soluzione:

1. Verifica che Ultimate Member sia attivo
2. Vai su Aspetto → Menu
3. Configura le condizioni di visibilità per ogni voce

🔴 Problemi Newsletter

Iscritti non arrivano al provider

Causa: API Key errata o lista non selezionata

Soluzione:

1. Vai su EO Suite → Moduli → Newsletter
2. Verifica API Key
3. Verifica che sia selezionata una lista
4. Testa con un'iscrizione di prova

🔴 Problemi Documentazione

File JSON non si salva

Causa: Permessi cartella non corretti

Soluzione:

1. Verifica che /wp-content/eo-docs/ esista
2. Imposta permessi 755 per la cartella
3. Imposta permessi 644 per i file

Editor visuale non carica i documenti

Causa: File JSON corrotto

Soluzione:

1. Vai su Docs Manager (editor JSON)
2. Clicca Valida JSON sul file problematico
3. Correggi eventuali errori di sintassi
4. Salva

📞 Supporto

Se il problema persiste:

1. Verifica i log di WordPress (wp-content/debug.log)
2. Disattiva altri plugin per escludere conflitti
3. Contatta il supporto tecnico con:
   • Descrizione dettagliata del problema
   • Screenshot dell'errore
   • Versione WordPress e PHP