Manuale utente di EasyPodcast

EasyPodcast permette di gestire uno o più podcast dal browser e pubblica automaticamente un sito, un feed RSS e una sitemap per ciascuno. Questo manuale spiega l’uso quotidiano dopo l’installazione.

Per installare EasyPodcast o consultare i requisiti tecnici, leggi il README.

1. Concetti di base

EasyPodcast ha due aree:

• Sito pubblico: homepage, episodi pubblicati, pagine informative, ricerca e collegamenti social.
• Pannello di amministrazione: configurazione del podcast, creazione di episodi, statistiche e manutenzione.

Il pannello usa episodio (in spagnolo capítulo) per ogni puntata del podcast. Gli stati possibili sono:

• draft: bozza, assente dal sito e dal feed. Puoi salvarla con il solo titolo e completarla dopo.
• scheduled: programmato per la data e l’ora indicate.
• published: pubblicato sul sito e nel feed RSS.

La pubblicazione programmata non richiede cron. Raggiunta la data, EasyPodcast pubblica gli episodi in attesa alla successiva visita del sito o del pannello. Usa l’ora locale configurata in PHP.

2. Primo accesso

1. Apri https://tuo-dominio.com/admin.php.
2. Se non esiste ancora un amministratore, inserisci un nome utente e una password, poi ripetila per confermare.
3. Premi Crea utente e accedi.
4. Apri Podcast e completa i dati del canale prima del primo episodio.

Negli accessi successivi puoi usare nome utente o e-mail. Usa Esci per terminare la sessione, soprattutto su computer condivisi.

3. Configurare il podcast

Apri Amministrazione > Podcast. Questi dati sono usati nel sito e nel feed RSS.

Dati principali

• Titolo: nome pubblico del podcast.
• URL principale: indirizzo pubblico dell’installazione, per esempio https://podcast.esempio.com.
• Descrizione: presentazione generale del programma.
• Lingua: lingua dichiarata nel feed RSS.
• Lingua del pannello: lingua dell’interfaccia amministrativa e delle pagine pubbliche.
• Autore, proprietario ed e-mail: informazioni editoriali incluse nel feed.
• Categorie: fino a tre categorie compatibili con Apple Podcasts.
• Esplicito: indica se il contenuto generale è esplicito.
• Tipo iTunes: podcast episodico o seriale.
• Copyright: testo legale mostrato nel feed.

Pubblicazione e aspetto

• Numero di elementi del feed RSS: limita gli episodi del feed; 0 significa nessun limite.
• Numero di elementi della homepage: episodi visualizzati per pagina.
• Scrivi metadati ID3: aggiunge titolo, artista, album, data, commento e numero di traccia all’MP3 durante il caricamento.
• Immagine del podcast: copertina quadrata, tramite URL o caricata dal dispositivo.
• Immagine hero: intestazione panoramica facoltativa. Le immagini caricate vengono ritagliate e ottimizzate automaticamente.
• Aspetto: dal pannello principale scegli il tema e se seguire la preferenza chiara o scura del sistema.

Premi Salva podcast. Le modifiche pubbliche svuotano automaticamente la cache e rigenerano feed e sitemap quando necessario.

4. Pubblicare un episodio

Apri Amministrazione > Aggiungi.

Procedura consigliata

1. Scrivi il titolo.
2. Mantieni draft durante la preparazione.
3. Aggiungi una descrizione breve per la homepage e il contenuto completo per la pagina dell’episodio e il feed.
4. Aggiungi audio tramite URL, caricamento di un file o registrazione dal microfono.
5. Controlla immagine, autore, contenuto esplicito, stagione, numero e tipo di episodio.
6. Scegli published per pubblicare subito o scheduled per una data futura.
7. Premi Salva episodio.
8. Controlla l’Anteprima e la homepage pubblica.

Campi importanti

• GUID: identificatore univoco dei lettori RSS, generato da EasyPodcast se vuoto.
• URL dell’episodio: generato dal titolo. Puoi anche usare Genera URL o indicare un URL valido.
• Descrizione (solo testo): estratto facoltativo fino a 4.000 caratteri; se presente, sostituisce il contenuto completo nella homepage.
• Contenuto: testo completo nell’editor visuale; fino a 10.000 caratteri, tag HTML inclusi.
• Data di pubblicazione: pubblicando senza data si usa quella attuale; obbligatoria per gli episodi programmati.
• Audio: il caricamento compila URL, MIME e dimensione. Per URL esterni controlla manualmente questi dati.
• Durata: formato HH:MM:SS. Se manca, EasyPodcast prova a calcolarla da un audio locale.
• Esplicito: eredita l’impostazione generale o viene definito per l’episodio.
• Tipo: full per un episodio normale, trailer per un’anteprima e bonus per contenuti extra.
• Immagine e autore: se vuoti, usano i valori generali del podcast.

Pubblicare o programmare richiede contenuto e dati audio validi. Per una bozza basta il titolo.

Registrare dal browser

1. Espandi Registra dal microfono.
2. Autorizza l’accesso al microfono.
3. Premi Registra e, al termine, Ferma.
4. Controlla con Ascolta registrazione.
5. Premi Usa questa registrazione e attendi la conferma del caricamento.
6. Salva l’episodio.

Non chiudere la pagina durante la codifica o il caricamento della registrazione.

Metadati MP3

Se la scrittura automatica ID3 è attiva, i metadati vengono aggiornati al caricamento. Per un episodio esistente, usa Aggiorna i metadati dell’MP3 attuale per riscriverli.

5. Gestire gli episodi

Apri Amministrazione > Episodi. Pubblicati, bozze e programmati sono separati.

Puoi:

• cercare per titolo o contenuto;
• modificare un episodio;
• aprire un’anteprima anche di bozze e programmati;
• eliminare un episodio.

L’eliminazione rimuove il record dal database. Audio e immagine vengono eliminati dal server solo se nessun altro episodio né la copertina del podcast li usa. Fai comunque un backup prima di una pulizia importante.

Modificare un episodio pubblicato aggiorna feed, sitemap e cache pubblica.

6. Importare un altro podcast

Importa feed RSS copia episodi da un feed esterno e scarica localmente audio e immagini.

1. Apri Amministrazione > Importa feed RSS.
2. Incolla l’URL completo e premi Anteprima.
3. Confronta i metadati attuali con quelli del feed e seleziona solo i campi da sovrascrivere.
4. Seleziona gli episodi da importare.
5. Lascia disattivata l’importazione dei GUID duplicati, salvo necessità esplicita.
6. Premi Avvia importazione e tieni aperta la pagina fino alla fine.
7. Controlla episodi importati, homepage e feed.

L’URL principale non viene sostituito da quello del feed importato. Le importazioni grandi possono richiedere minuti e dipendono dai limiti di caricamento, memoria e tempo di esecuzione del server.

7. Creare pagine e aggiungere social network

Pagine statiche

In Amministrazione > Pagine, crea contenuti come «Chi siamo», «Contatti» o «Note legali».

1. Premi Aggiungi pagina.
2. Scrivi titolo e contenuto.
3. Controlla lo slug: solo lettere minuscole, numeri e trattini.
4. Scegli draft o published.
5. Se vuoi, scegli una pagina superiore per una gerarchia a due livelli.
6. Usa Ordine per la posizione; i numeri minori vengono prima.
7. Salva e controlla l’anteprima.

Social network

In Amministrazione > Social network, aggiungi gli URL completi di blog, LinkedIn, Mastodon, X, Pixelfed, Instagram, YouTube, GitHub e Bluesky. Solo le reti configurate compaiono come icone nell’intestazione pubblica.

8. Consultare le statistiche

Apri Amministrazione > Statistiche per vedere:

• episodi pubblicati, bozze e totale archiviato;
• dimensione totale degli audio secondo il database;
• ultimo episodio pubblicato;
• stato, numero di pagine e dimensione della cache;
• download e riproduzioni.

L’attività si divide in:

• Giornaliero: eventi recenti fino a sette giorni, con data, episodio, tipo e IP.
• Mensile: totali mensili, filtrabili per anno.
• Annuale: totali annuali.
• Riepilogo: download e riproduzioni per episodio.

Clicca sulle intestazioni per ordinare le tabelle. Le richieste di verifica HEAD dei lettori non contano come download.

9. Backup

Apri Amministrazione > Backup. Database e file multimediali vengono salvati separatamente.

Creare un backup completo

1. Premi Esporta database e conserva il file SQLite.
2. Scarica tutte le parti di Esporta immagini.
3. Scarica tutte le parti di Esporta audio.
4. Se un file supera il limite ZIP, scaricalo manualmente dal collegamento mostrato.
5. Conserva tutti i file insieme, con data e versione di EasyPodcast.

Gli ZIP sono divisi in parti fino a 127 MB. Le immagini generate sono escluse perché rigenerabili.

Ripristinare

• Importa database ripristina contenuti e impostazioni da un SQLite valido. Prima salva lo stato attuale: il ripristino sostituisce il database in uso.
• Importa file accetta uno o più ZIP e audio singoli. Carica tutte le parti necessarie per recuperare i media.

Dopo il ripristino controlla homepage, vari episodi, feed e immagini. Se manca una miniatura, usa Cache > Rigenera immagini.

10. Cache e manutenzione

Cache

La cache pubblica conserva l’HTML della homepage e degli episodi, il feed e la sitemap per rispondere più velocemente.

• Abilita cache pubblica: consigliato in produzione.
• Svuota cache web: elimina solo le risposte HTML memorizzate; le visite le rigenereranno.
• Rigenera immagini: ricrea le varianti da 80, 144 e 220 pixel delle immagini del podcast e degli episodi.

Le normali modifiche pubbliche invalidano già la cache automaticamente. Svuotala manualmente se restano contenuti vecchi dopo un ripristino o un problema.

Rigenerare .htaccess

.htaccess generato ripristina il file con le regole predefinite di EasyPodcast. Elimina le regole personalizzate e disabilita il blocco IP di admin.php; usalo solo per tornare alla configurazione originale.

File orfani

In Multipodcast, l’amministratore globale dispone di Pulisci, che cerca audio e immagini inutilizzati dagli episodi. Controlla la selezione prima di Elimina selezionati: l’eliminazione non è annullabile.

11. Utenti, password e 2FA

Cambiare password

Apri Password, inserisci quella attuale e quella nuova seguendo le indicazioni. In Multipodcast, crea utenti separati invece di condividere account.

Attivare l’autenticazione a due fattori

1. Apri 2FA e premi Attiva 2FA.
2. Scansiona il QR con un’app TOTP, come Google Authenticator o Aegis, oppure inserisci la chiave manualmente.
3. Conferma con il codice a sei cifre.
4. Conserva immediatamente gli otto codici di recupero in un luogo sicuro.

Ogni codice funziona una sola volta. Puoi rigenerarli o disattivare 2FA confermando con la password. All’accesso puoi ricordare un dispositivo per sette giorni.

Limitare l’accesso a admin.php per IP

L’amministratore globale può aprire Multipodcast > Sicurezza per consentire solo determinati IPv4, IPv6 o intervalli CIDR. Il blocco è disabilitato per impostazione predefinita e si attiva espressamente in due passaggi. Includi sempre il tuo IP di amministrazione prima di confermare: un errore può escluderti dal pannello.

L’attivazione è facoltativa e sotto la responsabilità dell’utente. Dopo Abilita blocco, leggi l’avviso rosso e premi Sono sicuro solo dopo aver verificato l’elenco.

Recuperare l’accesso dopo un blocco accidentale

Se non puoi aprire admin.php, accedi ai file tramite SSH, SFTP o il gestore dell’hosting. Apri .htaccess nella directory principale di EasyPodcast e rimuovi solo il blocco completo, da # BEGIN a # END, incluse entrambe le righe:

# BEGIN EasyPodcast: bloqueo por IP de admin.php
# Bloqueo al admin.php
<Files "admin.php">
    Order Deny,Allow
    Deny from all
    Allow from x.x.x.x
</Files>
# END EasyPodcast: bloqueo por IP de admin.php

Salva senza cambiare le altre regole e riapri admin.php. Rimuovere il blocco disabilita la restrizione IP. Se ci sono più righe Allow from, rimuovile tutte come parte del blocco.

Utenti dei podcast

In Multipodcast, l’amministratore globale apre Utenti per creare account e assegnare uno o più podcast. Un utente limitato vede e gestisce solo quelli assegnati, senza accesso agli strumenti globali.

Puoi disattivare temporaneamente un account, cambiarne i podcast o impostare una nuova password. Eliminarlo elimina anche i suoi token API.

12. Gestire più podcast

Multipodcast ospita più canali in un’installazione, separando episodi, pagine, social network, statistiche e token.

Attivazione

1. Apri Multipodcast > Configurazione Multipodcast.
2. Seleziona Attiva Multipodcast.
3. Scegli la directory del podcast attuale, come mio-podcast: solo minuscole, numeri e trattini.
4. Scegli se la radice mostra un riepilogo di tutti i podcast o la homepage di uno selezionato.
5. Per il riepilogo, configura lingua, tema, titolo, sottotitolo e immagine d’intestazione.
6. Salva.

I file multimediali conservano gli URL quando attivi Multipodcast.

Creare e amministrare podcast

1. Apri Podcast.
2. Inserisci titolo e directory libera.
3. Premi Crea podcast.
4. Usa Amministra podcast per completare le impostazioni e pubblicare.

Il selettore superiore passa tra pannello globale e podcast disponibili. Ciascuno ha percorsi propri sotto https://tuo-dominio.com/directory/.

Puoi segnare un podcast come principale: verrà conservato disattivando Multipodcast.

Operazioni che cambiano URL o eliminano contenuti

• Cambia directory modifica gli URL pubblici di podcast, pagine, feed ed episodi. Fallo solo se puoi aggiornare i collegamenti esterni.
• Elimina podcast crea prima un backup ZIP, poi elimina podcast, episodi, statistiche e media esclusivi. Scrivi il titolo per confermare. Scarica e conserva lo ZIP.
• Disattiva Multipodcast conserva il principale, salva i secondari e poi li elimina. Richiede conferma esplicita e titolo esatto del principale.

13. API e automazioni

La sezione API integra EasyPodcast con script, n8n o altre applicazioni.

1. Apri API Tokens.
2. Indica un nome riconoscibile ed eventualmente una scadenza.
3. Scegli l’ambito: content per le normali automazioni dei contenuti; admin solo per operazioni amministrative sensibili.
4. Genera e copia subito il token: non verrà più mostrato per intero.
5. Consulta Documentazione API per endpoint ed esempi.

Revoca subito i token inutilizzati o potenzialmente esposti. Gli utenti limitati possono operare solo sui podcast assegnati.

14. Aggiornare EasyPodcast

1. Salva almeno il database, preferibilmente anche i media.
2. Apri Aggiorna.
3. Confronta la versione installata con l’ultima disponibile.
4. Se c’è una nuova versione, premi Aggiorna a v… e attendi la fine.
5. Leggi le novità e verifica homepage, pannello, un episodio, feed e sitemap.

L’aggiornamento scarica da GitHub Releases, verifica l’integrità e sostituisce i file dell’applicazione. Non modifica direttamente database, audio o immagini; le migrazioni necessarie si applicano automaticamente al caricamento dell’applicazione.

15. Cosa pubblica EasyPodcast

Percorsi abituali con un solo podcast:

In Multipodcast ciascun canale usa la propria directory, come /mio-podcast/, /mio-podcast/feed.xml e /mio-podcast/sitemap.xml. La radice può mostrare il riepilogo globale o il podcast in evidenza.

Per inviarlo a una piattaforma, fornisci l’URL pubblico del relativo feed.xml. Dopo la pubblicazione, controlla che l’episodio compaia sul sito e nel feed.

16. Routine consigliata

Prima di pubblicare

• Controlla titolo, descrizione breve, contenuto, audio e immagine.
• Ascolta inizio e fine del file.
• Verifica contenuto esplicito e numerazione.
• Usa draft finché tutto è pronto.

Dopo la pubblicazione

• Apri homepage e pagina dell’episodio.
• Riproduci o scarica l’audio.
• Controlla feed.xml.
• Verifica titolo, immagine e descrizione condividendo l’URL.

Manutenzione periodica

• Esporta spesso il database e prima di ogni aggiornamento.
• Conserva backup periodici di audio e immagini fuori dal server.
• Controlla statistiche e spazio occupato.
• Revoca token e disattiva utenti che non necessitano più dell’accesso.
• Cerca aggiornamenti ed esegui un backup prima di applicarli.

17. Problemi frequenti

Un episodio non appare pubblicamente

• Verifica lo stato published.
• Se programmato, controlla data, ora e fuso orario del server.
• Visita il sito per attivare la pubblicazione programmata.
• Svuota la cache web se persiste.

L’audio non viene riprodotto

• Verifica che l’URL sia accessibile.
• Controlla MIME, dimensione e formato.
• Se caricato dal pannello, verifica che il caricamento fosse completo prima di salvare.

Il feed non riflette una modifica

• Salva nuovamente podcast o episodio.
• Confronta feed.php e feed.xml.
• Svuota la cache web.
• Verifica i permessi di scrittura su feed.xml e cache/.

Manca un’immagine o miniatura

• Controlla l’URL originale.
• Apri Cache > Rigenera immagini.
• Verifica i permessi su images/ e images/generated/.

Impossibile importare un feed

• Controlla che l’URL sia pubblico e restituisca RSS valido.
• Verifica che l’estensione cURL di PHP sia abilitata.
• Prova meno episodi se i limiti del server sono rigidi.
• Non chiudere la scheda durante il download.

Impossibile salvare o caricare contenuti

Di solito dipende dai limiti PHP o dai permessi del server. L’amministratore dell’hosting deve controllare dimensione massima di caricamento, tempo di esecuzione e permessi di scrittura di podcast.sqlite, audios/, images/, cache/, feed.xml e favicon.ico.