Skip to content

Commit 79d44ae

Browse files
committed
allow socialInteract in <channel> - closes #601
1 parent 5076f74 commit 79d44ae

File tree

2 files changed

+24
-19
lines changed

2 files changed

+24
-19
lines changed

docs/1.0.md

Lines changed: 22 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -901,6 +901,9 @@ The node value is a string denoting one of the following possible values:
901901
version audio enclosure attached.
902902
- `blog` - Describes a feed of informally written articles. Similar to `newsletter` but more informal as in a
903903
traditional blog platform style.
904+
- `publisher` - Describes a feed that links to other feeds a publisher owns using the `<podcast:remoteItem>` element.
905+
To understand the structure of how "publisher" feeds work, please see the dedicated document
906+
(here)[publishers/publishers.md].
904907

905908
### List Mediums
906909
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.
11571160
<br><br><br><br><!-- Tag block -->
11581161
## Social Interact
11591162
`<podcast:socialInteract>`<br><br>
1160-
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode.
1161-
This "root post" is treated as the canonical location of where the comments and discussion around this episode will
1162-
take place. This can be thought of as the "official" social media comment space for this episode. If a protocol
1163-
such as "activitypub" is used, or some other protocol that allows programmatic API access, these comments can be
1164-
directly pulled into the app, and replies can be posted back to the thread from the app itself.
1163+
The `socialInteract` tag allows a podcaster to attach the url of a "root post" of a comment thread to an episode, or
1164+
to the podcast as a whole. This "root post" is treated as the canonical location of where the comments and
1165+
discussion around the episode or podcast will take place. This can be thought of as the "official" social media
1166+
comment space for the episode or podcast. If a protocol such as "activitypub" is used, or some other protocol that
1167+
allows programmatic API access, these comments can be directly pulled into the app, and replies can be posted back
1168+
to the thread from the app itself.
11651169

1166-
If multiple `socialInteract` tags are given for an `<item>`, the `priority` attribute is strongly recommended to
1167-
give the app an indication as to which comments to display first.
1170+
If multiple `socialInteract` tags are given for an `<item>` or the `<channel>`, the `priority` attribute is strongly
1171+
recommended to give the app an indication as to which comments to display first.
11681172

11691173
This tag can also be used as a signal to platforms and apps that the podcaster does not want public comments shown
1170-
alongside this episode. For this purpose a `protocol` value of "disabled" can be specified, with no other
1174+
alongside the episode or podcast. For this purpose a `protocol` value of "disabled" can be specified, with no other
11711175
attributes or node value present.
11721176

11731177
### Parent
1174-
&nbsp; `<item>`
1178+
&nbsp; `<item>` or `<channel>`
11751179

11761180
### Count
11771181
&nbsp; Multiple
11781182

11791183
### Attributes
1180-
- **uri** (required) The uri/url of root post comment.
11811184
- **protocol** (required) The [protocol](/socialprotocols.txt) in use for interacting with the comment root post.
1185+
- **uri** (required) The uri/url of root post comment.
11821186
- **accountId** (recommended) The account id (on the commenting platform) of the account that created this root post.
11831187
- **accountUrl** (optional) The public url (on the commenting platform) of the account that created this root post.
11841188
- **priority** (optional) When multiple socialInteract tags are present, this integer gives order of priority. A
@@ -1187,9 +1191,9 @@ attributes or node value present.
11871191

11881192
Example (simple):
11891193
```xml
1190-
<podcast:socialInteract
1191-
uri="https://podcastindex.social/web/@dave/108013847520053258"
1192-
protocol="activitypub"
1194+
<podcast:socialInteract
1195+
protocol="activitypub"
1196+
uri="https://podcastindex.social/web/@dave/108013847520053258"
11931197
accountId="@dave"
11941198
/>
11951199
```
@@ -1198,15 +1202,15 @@ Example (complex):
11981202
```xml
11991203
<podcast:socialInteract
12001204
priority="1"
1201-
uri="https://podcastindex.social/web/@dave/108013847520053258"
1202-
protocol="activitypub"
1205+
protocol="activitypub"
1206+
uri="https://podcastindex.social/web/@dave/108013847520053258"
12031207
accountId="@dave"
12041208
accountUrl="https://podcastindex.social/web/@dave"
12051209
/>
12061210
<podcast:socialInteract
1207-
priority="2"
1208-
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
1209-
protocol="twitter"
1211+
priority="2"
1212+
protocol="twitter"
1213+
uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115"
12101214
accountId="@podcastindexorg"
12111215
accountUrl="https://twitter.com/PodcastindexOrg"
12121216
/>

socialprotocols.txt

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
disabled
22
activitypub
33
twitter
4-
lightning
4+
lightning
5+
bluesky

0 commit comments

Comments
 (0)