allow socialInteract in <channel> - closes #601

pull/635/head
Dave Jones 2024-04-25 15:54:07 -05:00
rodzic 5076f74d26
commit 79d44ae131
2 zmienionych plików z 24 dodań i 19 usunięć

Wyświetl plik

@ -901,6 +901,9 @@ The node value is a string denoting one of the following possible values:
version audio enclosure attached.
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a
traditional blog platform style.
- `publisher` - Describes a feed that links to other feeds a publisher owns using the `<podcast:remoteItem>` element.
To understand the structure of how "publisher" feeds work, please see the dedicated document
(here)[publishers/publishers.md].
### List Mediums
In addition to the above mediums, each medium also has a counterpart "list" variant, where the original medium name
@ -1157,28 +1160,29 @@ of it's purpose.
<br><br><br><br><!-- Tag block -->
## Social Interact
`<podcast:socialInteract>`<br><br>
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode.
This "root post" is treated as the canonical location of where the comments and discussion around this episode will
take place. This can be thought of as the "official" social media comment space for this episode. If a protocol
such as "activitypub" is used, or some other protocol that allows programmatic API access, these comments can be
directly pulled into the app, and replies can be posted back to the thread from the app itself.
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode, or
to the podcast as a whole. This "root post" is treated as the canonical location of where the comments and
discussion around the episode or podcast will take place. This can be thought of as the "official" social media
comment space for the episode or podcast. If a protocol such as "activitypub" is used, or some other protocol that
allows programmatic API access, these comments can be directly pulled into the app, and replies can be posted back
to the thread from the app itself.
If multiple `socialInteract` tags are given for an `<item>`, the `priority` attribute is strongly recommended to
give the app an indication as to which comments to display first.
If multiple `socialInteract` tags are given for an `<item>` or the `<channel>`, the `priority` attribute is strongly
recommended to give the app an indication as to which comments to display first.
This tag can also be used as a signal to platforms and apps that the podcaster does not want public comments shown
alongside this episode. For this purpose a `protocol` value of "disabled" can be specified, with no other
alongside the episode or podcast. For this purpose a `protocol` value of "disabled" can be specified, with no other
attributes or node value present.
### Parent
&nbsp; `<item>`
&nbsp; `<item>` or `<channel>`
### Count
&nbsp; Multiple
### Attributes
- **uri** (required) The uri/url of root post comment.
- **protocol** (required) The [protocol](/socialprotocols.txt) in use for interacting with the comment root post.
- **uri** (required) The uri/url of root post comment.
- **accountId** (recommended) The account id (on the commenting platform) of the account that created this root post.
- **accountUrl** (optional) The public url (on the commenting platform) of the account that created this root post.
- **priority** (optional) When multiple socialInteract tags are present, this integer gives order of priority. A
@ -1187,9 +1191,9 @@ attributes or node value present.
Example (simple):
```xml
<podcast:socialInteract
uri="https://podcastindex.social/web/@dave/108013847520053258"
protocol="activitypub"
<podcast:socialInteract
protocol="activitypub"
uri="https://podcastindex.social/web/@dave/108013847520053258"
accountId="@dave"
/>
```
@ -1198,15 +1202,15 @@ Example (complex):
```xml
<podcast:socialInteract
priority="1"
uri="https://podcastindex.social/web/@dave/108013847520053258"
protocol="activitypub"
protocol="activitypub"
uri="https://podcastindex.social/web/@dave/108013847520053258"
accountId="@dave"
accountUrl="https://podcastindex.social/web/@dave"
/>
<podcast:socialInteract
priority="2"
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
protocol="twitter"
priority="2"
protocol="twitter"
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
accountId="@podcastindexorg"
accountUrl="https://twitter.com/PodcastindexOrg"
/>

Wyświetl plik

@ -1,4 +1,5 @@
disabled
activitypub
twitter
lightning
lightning
bluesky