Manual d’usuari d’EasyPodcast

EasyPodcast permet gestionar un o diversos pòdcasts des del navegador i publica automàticament una web, un canal RSS i un mapa del lloc per a cada pòdcast. Aquest manual explica l’ús diari de l’aplicació un cop instal·lada.

Per instal·lar EasyPodcast o consultar els requisits tècnics, consulta el README.

1. Conceptes bàsics

EasyPodcast té dues zones:

• Web pública: mostra la portada, els capítols publicats, les pàgines informatives, el cercador i els enllaços socials.
• Tauler d’administració: permet configurar el pòdcast, crear capítols, consultar estadístiques i fer manteniment.

Al tauler, capítol es refereix a cada episodi del pòdcast. Pot tenir un d’aquests estats:

• draft: esborrany. No apareix a la web ni al canal RSS. Es pot desar només amb un títol i completar més endavant.
• scheduled: programat. Es publicarà en la data i hora indicades.
• published: publicat. Apareix a la web pública i al canal RSS.

La publicació programada no necessita cron. Quan arriba la data, EasyPodcast publica els capítols pendents en la visita següent a la web o al tauler. Utilitza l’hora local configurada a PHP.

2. Primer accés

1. Obre https://el-teu-domini.com/admin.php.
2. Si encara no hi ha cap administrador, introdueix un nom d’usuari i una contrasenya i repeteix-la per confirmar.
3. Prem Crear usuari i entrar.
4. Entra a Pòdcast i completa les dades bàsiques del canal abans de publicar el primer capítol.

En accessos posteriors pots identificar-te amb el nom d’usuari o el correu electrònic. Fes servir Sortir per tancar la sessió, sobretot en equips compartits.

3. Configurar el pòdcast

Obre Administració > Pòdcast. Les dades d’aquesta pantalla s’utilitzen a la web i al canal RSS.

Dades principals

• Títol: nom públic del pòdcast.
• URL principal: adreça pública de la instal·lació, com ara https://podcast.exemple.com.
• Descripció: presentació general del programa.
• Idioma: idioma declarat al canal RSS.
• Idioma del tauler: idioma de la interfície administrativa i de les pàgines públiques.
• Autor, propietari i correu electrònic: informació editorial inclosa al canal.
• Categories: fins a tres categories compatibles amb Apple Podcasts.
• Explícit: indica si el contingut general és explícit.
• Tipus iTunes: defineix si el pòdcast és episòdic o serial.
• Copyright: text legal que es mostra al canal.

Publicació i aparença

• Quantitat d’elements del canal RSS: limita els capítols del canal; 0 vol dir sense límit.
• Quantitat d’elements de la portada: capítols que apareixen per pàgina.
• Escriure metadades ID3: afegeix al MP3 títol, artista, àlbum, data, comentari i número de pista en pujar-lo.
• Imatge del pòdcast: portada quadrada, indicada amb una URL o pujada des del dispositiu.
• Imatge del hero: capçalera panoràmica opcional. Les imatges pujades es retallen i s’optimitzen automàticament.
• Aparença: des del tauler principal pots triar el tema visual i si seguirà la preferència clara o fosca del sistema.

Prem Desar pòdcast. Els canvis públics buiden automàticament la memòria cau i regeneren el canal i el mapa del lloc quan correspon.

4. Publicar un capítol

Obre Administració > Afegir.

Flux recomanat

1. Escriu el títol.
2. Mantén l’estat draft mentre prepares el contingut.
3. Afegeix una descripció breu per a la portada i el contingut complet per a la pàgina del capítol i el canal RSS.
4. Afegeix l’àudio amb una URL, pujant un fitxer o enregistrant-lo amb el micròfon.
5. Revisa la imatge, l’autor, el contingut explícit, la temporada, el número i el tipus d’episodi.
6. Selecciona published per publicar ara o scheduled per indicar una data futura.
7. Prem Desar capítol.
8. Comprova el resultat amb Vista prèvia i revisa la portada pública.

Camps importants

• GUID: identificador únic dels lectors RSS. EasyPodcast el genera si es deixa buit.
• URL del capítol: es genera a partir del títol. També pots fer servir Generar URL o indicar una URL vàlida.
• Descripció (només text): extracte opcional de fins a 4.000 caràcters; substitueix el contingut complet a la portada si existeix.
• Contingut: text complet amb editor visual; fins a 10.000 caràcters, incloses les etiquetes HTML.
• Data de publicació: si publiques i la deixes buida, s’utilitza la data actual; és obligatòria als capítols programats.
• Àudio: en pujar un fitxer es completen la URL, el MIME i la mida. Amb una URL externa, revisa aquestes dades manualment.
• Durada: format HH:MM:SS. Si no s’indica, EasyPodcast intenta calcular-la a partir d’un àudio local.
• Explícit: pot heretar la configuració general o definir-se per al capítol.
• Tipus: full per a un episodi normal, trailer per a un avanç i bonus per a contingut extra.
• Imatge i autor: si es deixen buits, s’utilitzen els valors generals del pòdcast.

Per publicar o programar calen contingut i dades d’àudio vàlides. Un esborrany només necessita títol.

Enregistrar des del navegador

1. Desplega Enregistrar des del micròfon.
2. Autoritza l’accés al micròfon.
3. Prem Enregistrar i, en acabar, Aturar.
4. Comprova’l amb Escoltar enregistrament.
5. Prem Utilitzar aquest enregistrament i espera la confirmació de la pujada.
6. Desa el capítol.

No tanquis la pàgina mentre es codifica o es puja l’enregistrament.

Metadades del MP3

Si has activat l’escriptura automàtica d’ID3, EasyPodcast actualitza les metadades en pujar l’àudio. En editar un capítol existent pots fer servir Actualitzar metadades del MP3 actual per tornar-les a escriure.

5. Gestionar capítols

Obre Administració > Capítols. La pantalla separa els publicats, els esborranys i els programats.

Pots:

• cercar per títol o contingut;
• editar un capítol;
• obrir-ne una vista prèvia, fins i tot si és esborrany o programat;
• esborrar un capítol.

En esborrar-lo s’elimina el registre de la base de dades. L’àudio i la imatge només s’esborren del servidor si cap altre capítol ni la portada del pòdcast els utilitza. Tot i això, fes una còpia de seguretat abans d’una neteja important.

Modificar un capítol publicat actualitza el canal RSS, el mapa del lloc i la memòria cau pública.

6. Importar un altre pòdcast

Importar canal RSS copia capítols d’un canal extern a EasyPodcast i en descarrega localment àudios i imatges.

1. Obre Administració > Importar canal RSS.
2. Enganxa la URL completa i prem Vista prèvia.
3. Compara les metadades actuals amb les del canal i marca només els camps que vulguis sobreescriure.
4. Selecciona els capítols que vols importar.
5. Deixa desmarcada la importació de GUID duplicats, tret que els necessitis expressament.
6. Prem Iniciar importació i no tanquis la pàgina fins que acabi.
7. Revisa els capítols importats, la portada i el canal RSS.

La URL principal del pòdcast no se substitueix per la del canal importat. Les importacions grans poden durar minuts i depenen dels límits de pujada, memòria i temps d’execució del servidor.

7. Crear pàgines i afegir xarxes socials

Pàgines estàtiques

A Administració > Pàgines pots crear contingut com «Quant a», «Contacte» o «Avís legal».

1. Prem Afegir pàgina.
2. Escriu el títol i el contingut.
3. Revisa el slug: només lletres minúscules, números i guions.
4. Tria draft o published.
5. Opcionalment, selecciona una pàgina pare per crear una jerarquia de dos nivells.
6. Fes servir Ordre per controlar la posició; els números menors van primer.
7. Desa i comprova la vista prèvia.

Xarxes socials

A Administració > Xarxes socials pots afegir les URL completes de blog, LinkedIn, Mastodon, X, Pixelfed, Instagram, YouTube, GitHub i Bluesky. Només les xarxes configurades apareixen com a icones a la capçalera pública.

8. Consultar estadístiques

Obre Administració > Estadístiques per consultar:

• capítols publicats, esborranys i total emmagatzemat;
• mida total dels àudios segons la base de dades;
• últim capítol publicat;
• estat, nombre de pàgines i mida de la memòria cau;
• descàrregues i reproduccions.

L’activitat s’organitza en:

• Diari: esdeveniments recents de fins a set dies, amb data, capítol, tipus i IP.
• Mensual: acumulats per mes, amb filtre per any.
• Anual: acumulats per any.
• Resum: total de descàrregues i reproduccions per capítol.

Pots ordenar les taules prement-ne les capçaleres. Les peticions de comprovació HEAD dels lectors no compten com a descàrregues.

9. Còpies de seguretat

Obre Administració > Backups. La còpia de la base de dades i la dels fitxers multimèdia són separades.

Crear una còpia completa

1. Prem Exportar base de dades i desa el fitxer SQLite.
2. Descarrega totes les parts d’Exportar imatges.
3. Descarrega totes les parts d’Exportar àudios.
4. Si un fitxer supera el límit del ZIP, descarrega’l manualment amb l’enllaç indicat.
5. Desa tots els fitxers junts amb la data i la versió d’EasyPodcast.

Els ZIP es divideixen en parts de fins a 127 MB. Les imatges generades s’exclouen perquè es poden regenerar.

Restaurar

• Importar base de dades restaura contingut i configuració des d’un SQLite vàlid. Fes abans una còpia de l’estat actual: la restauració substitueix la base de dades en ús.
• Importar fitxers admet un o diversos ZIP i àudios individuals. Puja totes les parts necessàries per recuperar els mitjans.

Després, revisa la portada, diversos capítols, el canal i les imatges. Si falta alguna miniatura, fes servir Memòria cau > Regenerar imatges.

10. Memòria cau i manteniment

Memòria cau

La memòria cau pública desa l’HTML de la portada i els capítols, el canal i el mapa del lloc per respondre més ràpid.

• Habilitar memòria cau pública: recomanat en producció.
• Esborrar memòria cau web: elimina només les respostes HTML emmagatzemades; es tornaran a generar amb les visites.
• Regenerar imatges: recrea les variants de 80, 144 i 220 píxels de les imatges del pòdcast i els capítols.

Els canvis públics normals ja invaliden la memòria cau automàticament. Esborra-la manualment si veus contingut antic després d’una restauració o incidència.

Regenerar .htaccess

.htaccess generat restaura el fitxer amb les regles predeterminades d’EasyPodcast. Elimina totes les regles personalitzades i deshabilita el bloqueig per IP d’admin.php; utilitza-ho només per tornar a la configuració original.

Fitxers orfes

En instal·lacions Multipodcast, l’administrador global disposa de Netejar, que cerca àudios i imatges no utilitzats per cap capítol. Revisa la selecció abans de prémer Esborrar seleccionats: l’eliminació no es pot desfer.

11. Usuaris, contrasenya i 2FA

Canviar la contrasenya

Obre Contrasenya i introdueix l’actual i la nova seguint les indicacions. Si utilitzes Multipodcast, crea usuaris independents i no comparteixis comptes.

Activar l’autenticació en dos passos

1. Obre 2FA i prem Activar 2FA.
2. Escaneja el QR amb una aplicació TOTP, com Google Authenticator o Aegis. També pots introduir la clau manualment.
3. Escriu el codi de sis dígits per confirmar.
4. Desa immediatament els vuit codis de recuperació en un lloc segur.

Cada codi de recuperació s’utilitza un sol cop. Pots regenerar-los o desactivar 2FA confirmant-ho amb la contrasenya. En accedir pots recordar un dispositiu durant set dies.

Restringir l’accés a admin.php per IP

L’administrador global pot obrir Multipodcast > Seguretat per permetre l’accés a admin.php només des d’adreces IPv4, IPv6 o rangs CIDR determinats. El bloqueig està deshabilitat per defecte i s’activa expressament en dos passos. Inclou sempre la IP des d’on administres EasyPodcast abans de confirmar: una configuració incorrecta pot deixar-te sense accés.

L’activació és voluntària i responsabilitat de l’usuari. Després de prémer Habilitar bloqueig, revisa l’avís vermell i prem N’estic segur només si has comprovat la llista.

Recuperar l’accés si t’has bloquejat per error

Si no pots obrir admin.php, accedeix als fitxers del servidor amb SSH, SFTP o el gestor de fitxers de l’allotjament. Obre .htaccess al directori principal d’EasyPodcast i elimina únicament el bloc complet, de # BEGIN a # END, ambdues línies incloses:

# 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

Desa .htaccess sense canviar la resta de regles i torna a obrir admin.php. En treure el bloc es deshabilita la restricció per IP. Si hi ha diverses línies Allow from, elimina-les totes com a part del bloc.

Usuaris de pòdcast

En mode Multipodcast, l’administrador global pot obrir Usuaris per crear comptes i assignar-los un o diversos pòdcasts. Un usuari limitat només veu i administra els assignats; no accedeix a eines globals.

Pots desactivar temporalment un compte, canviar els pòdcasts assignats o donar-li una contrasenya nova. En eliminar-lo també s’eliminen els seus tokens API.

12. Gestionar diversos pòdcasts

Multipodcast allotja diversos canals en una instal·lació, amb capítols, pàgines, xarxes socials, estadístiques i tokens separats.

Activar-lo

1. Obre Multipodcast > Configuració Multipodcast.
2. Marca Activar Multipodcast.
3. Tria el directori del pòdcast actual, com el-meu-podcast: només minúscules, números i guions.
4. Decideix si l’arrel mostrarà un resum de tots els pòdcasts o la portada d’un pòdcast seleccionat.
5. Si fas servir el resum, configura’n idioma, tema, títol, subtítol i imatge de capçalera.
6. Desa la configuració.

Els fitxers multimèdia conserven les URL en activar Multipodcast.

Crear i administrar pòdcasts

1. Obre Pòdcasts.
2. Escriu un títol i un directori lliure.
3. Prem Crear pòdcast.
4. Fes servir Administrar pòdcast per completar la configuració i publicar contingut.

El selector de la barra superior canvia entre el tauler global i els pòdcasts disponibles. Cadascun té rutes pròpies sota https://el-teu-domini.com/directori/.

Pots marcar un pòdcast com a principal: es conservarà si desactives Multipodcast.

Operacions que canvien URL o eliminen contingut

• Canviar directori modifica les URL públiques del pòdcast, les pàgines, el canal i els capítols. Fes-ho només si pots actualitzar els enllaços externs.
• Esborrar pòdcast crea primer una còpia ZIP i després elimina el pòdcast, els capítols, les estadístiques i els mitjans exclusius. Cal escriure’n el títol per confirmar. Descarrega i conserva el ZIP.
• Desactivar Multipodcast conserva el pòdcast principal, crea còpies dels secundaris i després els elimina. Requereix confirmació explícita i el títol exacte del principal.

13. API i automatitzacions

La secció API integra EasyPodcast amb scripts, n8n o altres aplicacions.

1. Obre API Tokens.
2. Indica un nom identificable i, opcionalment, una data de caducitat.
3. Tria l’abast: content per a automatitzacions habituals de contingut; admin només per a operacions administratives sensibles.
4. Genera el token i copia’l al moment: no es tornarà a mostrar complet.
5. Consulta Documentació de l’API per veure endpoints i exemples.

Revoca immediatament els tokens que no s’utilitzin o que puguin haver quedat exposats. Els usuaris limitats només poden operar sobre els pòdcasts assignats.

14. Actualitzar EasyPodcast

1. Fes almenys una còpia de la base de dades i, preferiblement, també dels mitjans.
2. Obre Actualitzar.
3. Compara la versió instal·lada amb l’última disponible.
4. Si n’hi ha una de nova, prem Actualitzar a v… i espera que acabi.
5. Llegeix les novetats i comprova portada, tauler, un capítol, canal RSS i mapa del lloc.

L’actualitzador descarrega la versió de GitHub Releases, en verifica la integritat i substitueix els fitxers de l’aplicació. No modifica directament base de dades, àudios ni imatges; les migracions necessàries s’apliquen automàticament en carregar l’aplicació.

15. Què publica EasyPodcast

En una instal·lació d’un sol pòdcast, les rutes habituals són:

En Multipodcast, cada canal utilitza un directori, com /el-meu-podcast/, /el-meu-podcast/feed.xml i /el-meu-podcast/sitemap.xml. L’arrel pot mostrar el resum global o el pòdcast destacat.

Per enviar-lo a una plataforma de distribució, proporciona la URL pública del feed.xml del canal. Després de publicar un capítol, comprova que apareix tant a la web com al canal RSS.

16. Rutina recomanada

Abans de publicar

• Revisa títol, descripció breu, contingut, àudio i imatge.
• Escolta el principi i el final del fitxer.
• Comprova el contingut explícit i la numeració.
• Utilitza draft fins que tot estigui a punt.

Després de publicar

• Obre la portada i la pàgina del capítol.
• Reprodueix o descarrega l’àudio.
• Comprova feed.xml.
• Revisa títol, imatge i descripció en compartir la URL.

Manteniment periòdic

• Exporta sovint la base de dades i abans de cada actualització.
• Conserva còpies periòdiques d’àudios i imatges fora del servidor.
• Revisa les estadístiques i l’espai ocupat.
• Revoca tokens i desactiva usuaris que ja no necessitin accés.
• Comprova les actualitzacions i fes una còpia abans d’aplicar-les.

17. Problemes freqüents

Un capítol no apareix públicament

• Comprova que l’estat sigui published.
• Si està programat, revisa data, hora i zona horària del servidor.
• Obre la web per processar la publicació programada.
• Esborra la memòria cau web si persisteix.

L’àudio no es reprodueix

• Comprova que la URL sigui accessible.
• Revisa MIME, mida i format del fitxer.
• Si l’has pujat des del tauler, confirma que la pujada va acabar abans de desar.

El canal RSS no reflecteix un canvi

• Torna a desar el pòdcast o el capítol.
• Compara feed.php i feed.xml.
• Esborra la memòria cau web.
• Verifica permisos d’escriptura sobre feed.xml i cache/.

Falta una imatge o miniatura

• Comprova la URL original.
• Obre Memòria cau > Regenerar imatges.
• Verifica permisos d’escriptura a images/ i images/generated/.

No es pot importar un canal RSS

• Comprova que la URL sigui pública i retorni RSS vàlid.
• Verifica que PHP tingui habilitada l’extensió cURL.
• Prova menys capítols si el servidor té límits estrictes.
• No tanquis la pestanya durant la descàrrega.

No es pot desar o pujar contingut

Normalment es deu a límits de PHP o permisos del servidor. L’administrador de l’allotjament ha de revisar la mida màxima de pujada, el temps d’execució i els permisos d’escriptura de podcast.sqlite, audios/, images/, cache/, feed.xml i favicon.ico.