kopia lustrzana https://github.com/Podcastindex-org/podcast-namespace
socialInteract tag - formalized
rodzic
e6c6ae051f
commit
f3cbd1c2c6
47
docs/1.0.md
47
docs/1.0.md
|
@ -872,3 +872,50 @@ The node value is a free form string meant to explain to the user where this con
|
||||||
```xml
|
```xml
|
||||||
<podcast:contentLink href="https://twitter.com/statuses/somepost">Chat on Twitter!</podcast:contentLink>
|
<podcast:contentLink href="https://twitter.com/statuses/somepost">Chat on Twitter!</podcast:contentLink>
|
||||||
```
|
```
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
<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.
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
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 attributes or node value present.
|
||||||
|
|
||||||
|
### Parent
|
||||||
|
`<item>`
|
||||||
|
|
||||||
|
### Count
|
||||||
|
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.
|
||||||
|
- **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 or priority in ascending order of importance. A lower number means higher priority.
|
||||||
|
|
||||||
|
|
||||||
|
Example (simple):
|
||||||
|
```xml
|
||||||
|
<podcast:socialInteract uri="https://podcastindex.social/web/@dave/108013847520053258" protocol="activitypub" accountId="@dave" />
|
||||||
|
```
|
||||||
|
|
||||||
|
Example (complex):
|
||||||
|
```xml
|
||||||
|
<podcast:socialInteract priority="1" uri="https://podcastindex.social/web/@dave/108013847520053258" protocol="activitypub" accountId="@dave" accountUrl="https://podcastindex.social/web/@dave" />
|
||||||
|
<podcast:socialInteract priority="2" uri="https://twitter.com/PodcastindexOrg/status/1507120226361647115" protocol="twitter" accountId="@podcastindexorg" accountUrl="https://twitter.com/PodcastindexOrg" />
|
||||||
|
```
|
||||||
|
|
||||||
|
Example (disabled):
|
||||||
|
```xml
|
||||||
|
<podcast:socialInteract protocol="disabled" />
|
||||||
|
```
|
Ładowanie…
Reference in New Issue