mirror
/
podcast-namespace
kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
1
0
Forkuj 0
Kod Zgłoszenia Packages Projekty Wydania Wiki Aktywność

Update podroll.md 

Adding more detail about expected items from the remoteItem spec, and some additional detail.
pull/711/head
James Cridland 2025-06-18 10:08:00 +10:00 zatwierdzone przez GitHub
rodzic 91e3baa0f9
commit 0819880a87
Nie znaleziono w bazie danych klucza dla tego podpisu
ID klucza GPG: B5690EEEBB952194
1 zmienionych plików z 32 dodań i 2 usunięć
Pokaż statystyki Ściągnij plik aktualizacji Ściągnij plik porównania Expand all files Collapse all files

34
docs/tags/podroll.md
Wyświetl plik

@ -2,7 +2,7 @@
`<podcast:podroll>`
This element allows for a podcaster to include references to one or more podcasts in it's `<channel>` as a way of "recommending" other podcasts to their listener.
This element allows for a podcaster to include references to one or more podcasts in its `<channel>` as a way of "recommending" other podcasts to their listener. It's normally shown in user interfaces as "creator recommendations", or "shows you might like".
### Parent
@ -16,7 +16,7 @@ Single
The node value must be one or more [`<podcast:remoteItem>`](remoteItem.md) elements.
### Example
### Examples
```xml
<podcast:podroll>
@ -25,3 +25,33 @@ The node value must be one or more [`<podcast:remoteItem>`](remoteItem.md) eleme
<podcast:remoteItem feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810" />
</podcast:podroll>
```
Above, the simplest way to use a podroll, using the [one mandatory value for the `remoteItem`](remoteItem.md).
```xml
<podcast:podroll>
<podcast:remoteItem
feedGuid="29cdca4a-32d8-56ba-b48b-09a011c5daa9"
feedUrl="https://feeds.buzzsprout.com/231452.rss"
title="Buzzcast"
/>
<podcast:remoteItem
feedGuid="396d9ae0-da7e-5557-b894-b606231fa3ea"
feedUrl="https://feeds.buzzsprout.com/1538779.rss"
title="Podnews Weekly Review"
/>
<podcast:remoteItem
feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810"
feedUrl="http://mp3s.nashownotes.com/pc20rss.xml"
title="Podcasting 2.0"
/>
</podcast:podroll>
```
Above, a recommended podroll entry. It includes the `feedUrl` as well as the `feedGuid`, to help podcast apps discover shows without the GUID if they need to. It also includes a title, which is helpful for humans, and potentially for display in the app.
If information differs, information discoverable from the GUID always takes precedence. RSS feeds can change; the [GUID](guid.md) does not.
While the remoteItem includes an optional `itemGuid`, it is not expected that a podroll would normally link to individual episodes.
(Humans: you can [put a GUID into the search box](https://podcastindex.org/search?q=917393e3-1b1e-5cef-ace4-edaa54e1f810&type=all) on the Podcast Index website).