remoteItem and podroll tags

pull/536/head
Dave Jones 2023-05-11 10:00:29 -05:00
rodzic 8975380f1d
commit d26943f0cb
1 zmienionych plików z 47 dodań i 8 usunięć

Wyświetl plik

@ -1069,10 +1069,52 @@ common use, this list will be updated by the community to reflect that.
<br><br><br><br><!-- Tag block -->
## Remote Item
`<podcast:remoteItem>`<br><br>
This element provides a way to "point" to another feed or an `<item>` in another feed.
### Parent
&nbsp; `<channel>` or `<podcast:podroll>` or `<podcast:valueTimeSplit>`
### Count
&nbsp; Multiple
### Attributes
- **feedGuid** (required) The `<podcast:guid>` of the remote feed being pointed to.
- **feedUrl** (optional) The url of the remote feed being pointed to.
- **itemGuid** (optional) If this remote item element is intended to point to an `<item>` in the remote feed, this
attribute should contain the value of the `<guid>` of that `<item>`.
- **medium** (optional) If the feed being pointed to is not of medium type 'podcast', this attribute should contain it's
`<podcast:medium>` type from the list of types available in this document.
### Examples
```xml
<podcast:remoteItem feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810" />
```
```xml
<podcast:remoteItem
feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810"
itemGuid="asdf089j0-ep240-20230510"
/>
```
```xml
<podcast:remoteItem
feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810"
feedUrl="https://feeds.example.org/917393e3-1b1e-5cef-ace4-edaa54e1f810/rss.xml"
itemGuid="asdf089j0-ep240-20230510"
medium="music"
/>
```
<br><br><br><br><!-- Tag block -->
## Podroll
`<podcast:podroll>`<br><br>
This element allows for a podcaster to include references to one or more podcasts in it's `<channel>` as a way of
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.
### Parent
@ -1081,17 +1123,14 @@ This element allows for a podcaster to include references to one or more podcast
### Count
&nbsp; Single
### Attributes
None
### Node value
&nbsp; This is a comma separated list of `<podcast:guid>` values referencing other podcast feeds.
&nbsp; The node value must be one or more `<podcast:remoteItem>` elements.
### Example
```xml
<podcast:podroll>
29cdca4a-32d8-56ba-b48b-09a011c5daa9,
396d9ae0-da7e-5557-b894-b606231fa3ea,
917393e3-1b1e-5cef-ace4-edaa54e1f810
<podcast:remoteItem feedGuid="29cdca4a-32d8-56ba-b48b-09a011c5daa9" />
<podcast:remoteItem feedGuid="396d9ae0-da7e-5557-b894-b606231fa3ea" />
<podcast:remoteItem feedGuid="917393e3-1b1e-5cef-ace4-edaa54e1f810" />
</podcast:podroll>
```