Spotify Podcast Episodes recupera dall’API di Spotify gli episodi di uno show e li mostra in una pagina WordPress, come elenco con copertina, data e durata oppure come serie di player Spotify incorporati. È pensato per chi pubblica un podcast su Spotify e vuole tenerne l’archivio aggiornato sul proprio sito senza copiare a mano i link: basta indicare lo show, e i nuovi episodi compaiono da soli. Funziona con uno shortcode, con un blocco Gutenberg e con un widget Elementor.
Uno show, tre modi per inserirlo
Lo show si indica con il suo ID di 22 caratteri, con l’URL completo di open.spotify.com (anche nelle varianti localizzate come /intl-it/) oppure con l’URI spotify:show:. Il plugin estrae l’ID e lo convalida prima di qualunque richiesta.
Le stesse opzioni sono disponibili nello shortcode [spotify_podcast], nel blocco “Spotify Podcast” della categoria Embed e nel widget Elementor “Spotify Podcast”: numero di episodi, ordine, elenco o player incorporato, formato della copertina, copertina cliccabile e disposizione a lista o a griglia. Negli editor l’anteprima si ferma a tre episodi, con un segnaposto al posto del player.
Elenco o player incorporato
Nella modalità elenco ogni episodio ha copertina, titolo collegato alla pagina dell’episodio su Spotify, data di pubblicazione nel formato del sito e durata in minuti; la descrizione, accorciata alla lunghezza scelta, si può aggiungere dal widget Elementor. Nella modalità embed ogni episodio diventa un player ufficiale di Spotify, con altezza regolabile. La copertina può avere proporzione 1:1, 4:3, 3:4, 16:9, 9:16, 3:2, 2:3, 16:10 o quella originale.
L’ordine predefinito parte dall’episodio più recente. L’ordine inverso, dal più vecchio, viene applicato solo quando il catalogo dello show è stato scaricato per intero: finché lo scaricamento è in corso restano in vista gli episodi più recenti già disponibili.
Cataloghi lunghi senza rallentare la pagina
Al primo caricamento il plugin scarica due pagine di risultati (fino a 100 episodi) e completa il resto del catalogo in background con WP-Cron, a blocchi, fino a 2.000 episodi per show. Gli episodi restano in cache per un’ora, le visite contemporanee non interrogano Spotify due volte e, se Spotify segnala il superamento dei limiti di richiesta, il plugin rispetta il tempo di attesa indicato e nel frattempo continua a mostrare gli episodi già in cache.
Se sul sito WP-Cron è disattivato, il catalogo avanza dopo l’invio della pagina al visitatore, così il tempo di caricamento non cambia; resta consigliato un cron di sistema su wp-cron.php. Gli errori dettagliati dell’API compaiono solo nell’editor, a chi può modificare i contenuti; ai visitatori viene mostrato un avviso generico.
Copertine nella Libreria media
Le copertine degli episodi non vengono caricate dai server di Spotify: il plugin le scarica nella Libreria media di WordPress, con il titolo dell’episodio come testo alternativo, e le serve dal dominio del sito. Durante la visualizzazione ne scarica al massimo quattro per pagina e mette in coda le altre, che vengono completate in background; nel frattempo compare un’immagine segnaposto.
Nella pagina delle impostazioni due strumenti permettono di scaricare in blocco le copertine degli episodi già in cache e di eliminare quelle degli episodi che non sono più nel catalogo, limitandosi agli show il cui catalogo in cache è completo.
Il widget Elementor
Il widget si trova nella categoria “Spotify Podcast” del pannello di Elementor. Aggiunge colonne responsive (fino a sei), spaziatura, dimensione della copertina, apertura dei link nella stessa scheda o in una nuova, e controlli di stile per contenitore, scheda dell’episodio (anche al passaggio del mouse), copertina, testi, player e messaggi. Tre preset (Spotify Dark, Minimal Card e Magazine Grid) danno una base visiva senza modificare layout e colonne. Con Elementor Pro il campo dello show accetta i tag dinamici.
Shortcode e attributi
Lo shortcode di base è [spotify_podcast show="ID_O_URL"]. Gli attributi facoltativi sono:
limit: numero di episodi (di serie tutti quelli disponibili);embed="yes": player Spotify incorporato al posto dell’elenco con link;order="asc": dal più vecchio, quando il catalogo è completo;cover_link="no": copertina non cliccabile;cover_ratio: formato della copertina, per esempio16:9ooriginal;layout="grid": griglia al posto della lista verticale.
Impostazioni e filtri per sviluppatori
Le credenziali si inseriscono nel menu Spotify Podcast → Impostazioni: Client ID e Client Secret di un’app creata nella dashboard Spotify for Developers, più il codice paese (di serie IT) richiesto dall’API. Il secret, una volta salvato, non viene più mostrato nel modulo. Nella stessa pagina si verifica la connessione a Spotify e si svuota la cache degli episodi.
Per personalizzazioni via codice sono disponibili i filtri spe_show_id (modifica l’ID dello show, che viene poi riconvalidato), spe_episodes (modifica l’elenco degli episodi prima della visualizzazione) e spe_episode_html (modifica l’HTML di ogni episodio, che passa comunque da un filtro di sicurezza che ammette solo i player di Spotify).
Integrazione con l’ecosistema ThinkClouds
Il plugin si aggiorna da ThinkRepo e dichiara un manifesto ThinkClouds con le opzioni e le copertine da portare in caso di migrazione. Le credenziali Spotify sono escluse dal trasferimento, e il controllo di salute segnala quando manca il Client Secret e va reinserito sul sito. Alla disinstallazione vengono rimossi impostazioni, cache, operazioni pianificate e copertine scaricate.
Requisiti
- WordPress 6.0 o superiore
- PHP 7.4 o superiore
- Un’app Spotify for Developers (Client ID e Client Secret)
- Elementor, facoltativo, per il widget; Elementor Pro, facoltativo, per i tag dinamici
Download riservato alle persone autorizzate: ti chiederemo la tua email e un codice di conferma.
Novità per versione
1.6.1 05/11/2026
- La pulizia delle copertine non cancella più i file di un catalogo ancora incompleto o fermo al tetto di 2000 episodi.
- Un episodio senza immagine valida non viene più rimesso in coda all'infinito.
