Встраивайте подкасты Podhoc на свой сайт — документация iframe-виджета

Встройте свой подкаст Podhoc на любой сайт за секунды

Вы публикуете подкаст в Podhoc. Хотите видеть его у себя в блоге, в модуле курса, в редакционной статье или в командной wiki. Embed Podhoc — это один iframe: вставляете, читатель нажимает play, аудио идёт со podhoc.com, не уводя его с вашей страницы.

Разрешения на встраивание — только для автора. Только автор подкаста может сгенерировать сниппет встраивания для этого подкаста — кнопка Embed ограничена на сервере по owner_id подкаста и скрыта на страницах Discover для подкастов, авторами которых вы не являетесь. Это сохраняет чистую атрибуцию и даёт законному автору контроль над удалениями.

Слушателю аккаунт не нужен. Анонимные читатели слышат бесплатный 30-секундный фрагмент без регистрации; нажатие “Слушать на Podhoc” открывает страницу-источник, где они могут войти, чтобы прослушать полный эпизод (кредиты применяются согласно матрице кредитов Discover). Прослушивания превью берёт на себя Podhoc — они не расходуют ваш баланс кредитов. Плеер весит 50 КБ gzip, лениво подгружается при попадании во вьюпорт и показывает плейсхолдер «недоступно» вместо сломанного фрейма, если вы снимаете исходный подкаст с публикации.

Как получить код embed

1. Откройте СВОЙ подкаст в Discover Podhoc

Перейдите на app.podhoc.com/discover и откройте один из своих опубликованных подкастов. Кнопка Embed показывается только на подкастах, автором которых вы являетесь, потому что разрешения на встраивание привязаны к автору; на страницах Discover для подкастов, авторами которых вы не являетесь, кнопка Embed скрыта.

2. Нажмите Embed и скопируйте iframe

На странице подкаста нажмите Embed. Модальное окно покажет HTML iframe, уже заполненный каноническим slug и уникальным идентификатором разрешения на встраивание. Скопируйте фрагмент целиком. Идентификатор разрешения — это то, что Podhoc использует для атрибуции прослушиваний из embed к вашему аккаунту и для управления удалениями; не удаляйте его из сниппета.

3. Вставьте iframe на свой сайт

Положите фрагмент в любой HTML-блок — пользовательский HTML-виджет WordPress, embed-карточку Ghost, /embed Notion, MDX-страницу Docusaurus или сырой <iframe> на статическом сайте. Плеер тянется со podhoc.com, лениво подгружается при попадании во вьюпорт и добавляет 50 КБ gzip к весу страницы.

Пример: живой embed

Ниже — канонический пример фрагмента, указывающий на демонстрационный подкаст из раздела «Открой». После шага 2 замените slug ?podcast=example на slug вашего подкаста.

<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="Плеер Podhoc"
></iframe>

Атрибут loading="lazy" обязателен — он удерживает embed вне критического пути сети до момента, когда читатель прокрутит его во вьюпорт, и именно это сохраняет ваши page-speed-метрики.

Параметры настройки

В v1 iframe поставляется визуально фиксированным: 100% ширины × 240 px высоты, с фирменной палитрой Podhoc. Перечисленные ниже рычаги находятся в плане и будут задокументированы здесь по мере выхода:

• Скоро: width — query-параметр ?w=, переопределяющий ширину контейнера по умолчанию.
• Скоро: height — query-параметр ?h= для компактных / расширенных layout-ов.
• Скоро: theme — ?theme=light|dark|auto, чтобы плеер соответствовал палитре сайта.

Пока этого нет, embed намеренно прост — один фрагмент без настройки, одинаковый везде.

Производительность

• Размер бандла: 50 КБ gzip для первого embed на странице. Последующие embed на той же странице добавляют только блоб метаданных подкаста (~2 КБ каждый), а не полный код плеера.
• Ленивая загрузка: iframe по умолчанию выставляет loading="lazy". Браузер откладывает сетевой запрос, пока читатель не прокрутит плеер во вьюпорт, поэтому embed ниже первого экрана стоит ноль байт до момента появления.
• Стриминг: аудио раздаётся через ту же дистрибуцию CloudFront, что и app.podhoc.com, с byte-range-запросами для мгновенной перемотки.
• Влияние на page-speed: во внутренних аудитах Lighthouse страница с одним embed Podhoc остаётся в пределах 1 балла от той же страницы без embed, если фрагмент находится ниже первого экрана.

Защита от злоупотреблений — 100 прослушиваний / день / хост

Чтобы публичный стриминг раздела «Открой» оставался устойчивым и не выставлялся в счёт встраивающему, Podhoc применяет мягкое ограничение 100 прослушиваний в сутки на один хост. Ограничение действует на домен встраивания, а не на конкретный подкаст — если на моиблог.example десять embed, весь домен делит бюджет в 100 прослушиваний в сутки.

На практике:

• Первые 100 прослушиваний в календарных сутках идут как обычно.
• Дальше плеер всё ещё загружается и показывает метаданные подкаста, но выводит дружелюбное сообщение: «Дневной лимит исчерпан — попробуйте завтра или откройте в Podhoc».
• Счётчик сбрасывается в полночь UTC.

Если у вас есть обоснованная потребность в более высоком лимите (популярная редакция, нагруженная курс-платформа), напишите нам через страницу поддержки — мы ведём белый список для доверенных встраивающих.

Часто задаваемые вопросы

Блок FAQ ниже отражает список faqs: из front-matter страницы, который Hugo отдаёт как структурированные данные для поисковиков и AI-сводок.

Связанное

• Цены — пакеты кредитов и подписки (прослушивания embed не расходуют ваши кредиты).
• Конфиденциальность — что мы логируем, когда читатель нажимает play в embed.
• Условия — правила допустимого использования embed-виджета.
• Открой — просматривайте публичные подкасты и берите коды embed.

Откройте раздел «Открой» и заберите код embed →