Incrusta podcasts de Podhoc al teu web — Documentació del widget iframe

Incrusta el teu podcast de Podhoc en qualsevol web en segons

Publiques un podcast a Podhoc. El vols al teu blog, en un mòdul de curs, en un article de redacció o dins la wiki del teu equip. L’embed de Podhoc és un únic iframe — l’enganxes, el lector prem play i l’àudio es reprodueix des de podhoc.com sense treure’l de la teva pàgina.

Els permisos d’incrustació són només per a l’autor. Només l’autor del podcast pot generar un fragment d’incrustació per a aquest podcast — el botó Embed es controla al servidor contra l’owner_id del podcast i queda ocult a les fitxes de Descobreix de podcasts que no són teus. Així l’atribució queda neta i l’autor manté el control sobre retirades.

No cal compte per a l’oient. Els lectors anònims escolten una previsualització gratuïta de 30 segons sense registrar-se; en prémer “Escoltar a Podhoc” s’obre la pàgina original on poden iniciar sessió per escoltar l’episodi complet (els crèdits s’apliquen segons la matriu de crèdits del Descobreix). Les reproduccions de previsualització les absorbeix Podhoc — no consumeixen el teu saldo de crèdits. El reproductor pesa 50 KB gzip, es carrega de manera diferida en entrar al viewport i mostra un placeholder de “no disponible” en comptes d’un frame trencat si arribes a despublicar el podcast.

Com aconseguir el teu codi embed

1. Obre EL TEU podcast a Descobreix de Podhoc

Entra a app.podhoc.com/discover i obre un dels teus podcasts publicats. El botó Embed només apareix als podcasts que has creat tu, perquè els permisos d’incrustació estan vinculats a l’autor; a les fitxes de Descobreix de podcasts que no són teus, el botó Embed queda ocult.

2. Prem Embed i copia l’iframe

A la fitxa del podcast prem Embed. Un modal et mostra l’HTML de l’iframe ja emplenat amb el slug canònic i l’identificador únic del permís d’incrustació. Copia el fragment sencer. L’identificador del permís és el que Podhoc utilitza per atribuir les reproduccions d’embed al teu compte i per gestionar retirades; no l’eliminis del fragment.

3. Enganxa l’iframe al teu lloc

Posa el fragment en qualsevol bloc HTML — un widget HTML personalitzat de WordPress, una targeta embed de Ghost, un /embed de Notion, una pàgina MDX de Docusaurus, o <iframe> pla en un lloc estàtic. El reproductor serveix des de podhoc.com, es carrega de manera diferida i suma 50 KB gzip al pes de la teva pàgina.

Exemple: embed en viu

Aquest és el fragment canònic, apuntant a un podcast de mostra de Descobreix. Substitueix el slug ?podcast=example pel del teu podcast després del pas 2.

<iframe
  src="https://app.podhoc.com/embed?podcast=example"
  width="100%"
  height="240"
  loading="lazy"
  frameborder="0"
  allow="autoplay; clipboard-write; encrypted-media; picture-in-picture"
  title="Reproductor de Podhoc"
></iframe>

L’atribut loading="lazy" no és negociable — manté l’embed fora del camí crític de xarxa fins que el lector el desplaça al viewport, que és el que protegeix la teva puntuació de page-speed.

Opcions de personalització

A v1 l’iframe es lliura visualment fix a 100% d’ample × 240 px d’alt amb la paleta de marca de Podhoc. Aquestes palanques són al roadmap i es documentaran aquí quan aterrin:

• Pròximament: amplada — un query param ?w= per sobreescriure l’amplada per defecte.
• Pròximament: alçada — un query param ?h= per a layouts compactes / expandits.
• Pròximament: tema — ?theme=light|dark|auto perquè combini amb la paleta del teu lloc.

Fins que arribin, l’embed és deliberadament simple — un fragment, sense ajustos, funciona igual a cada pàgina.

Rendiment

• Mida del bundle: 50 KB gzip per al primer embed d’una pàgina. Els següents embeds en la mateixa pàgina només afegeixen les metadades del podcast (~2 KB cada un), no el codi sencer del reproductor.
• Càrrega diferida: l’iframe inclou loading="lazy" per defecte. El navegador retarda la petició de xarxa fins que el lector el desplaça al viewport, així que un embed sota la línia de scroll costa zero bytes fins que cal.
• Streaming: l’àudio se serveix des de la mateixa distribució de CloudFront que app.podhoc.com, amb peticions per rang de bytes per a scrubbing instantani.
• Impacte en page-speed: a les nostres auditories internes de Lighthouse, una pàgina amb un embed de Podhoc puntua a 1 punt de distància de la mateixa pàgina sense embed quan el fragment queda sota la línia de scroll.

Anti-abús — 100 reproduccions / dia / host

Per mantenir el streaming públic sostenible sense facturar-te’l, Podhoc aplica un límit suau de 100 reproduccions per dia i per host. El límit és per domini que incrusta, no per podcast — si allotges deu embeds a elmeublog.example, tot el domini comparteix el pressupost de 100 reproduccions diàries.

A la pràctica:

• Les primeres 100 reproduccions del dia es serveixen amb normalitat.
• A partir d’aquí el reproductor continua carregant i mostra les metadades del podcast, però presenta un missatge amable de “Límit diari assolit — torna demà o obre a Podhoc”.
• El comptador es reinicia a mitjanit UTC.

Si tens una necessitat legítima d’un límit més alt (una redacció molt visitada, una plataforma de cursos amb molt trànsit), escriu-nos des de la pàgina de suport — mantenim una llista blanca per a integradors de confiança.

Preguntes freqüents

El bloc FAQ que apareix a continuació és el mateix que faqs: al front-matter de la pàgina, que és el que Hugo emet com a dades estructurades per als cercadors i els resums d’IA.

Relacionat

• Preus — packs de crèdits i subscripcions (les reproduccions de l’embed no consumeixen els teus crèdits).
• Privacitat — què registrem quan un lector prem play en un embed.
• Termes — regles d’ús acceptable del widget embed.
• Descobreix — explora podcasts públics i copia codis embed.

Explora Descobreix i copia un codi embed →