Post Kinds

Kinds, like Post Formats built into WordPress, allow you to specify that a post contains a certain type of content. It also, based
on you classifying it that way, displays it appropriately and marks it up accordingly so outside sites can identify it. Kinds are
either a response to something, such as a URL, or a more passive type of post where you are recording/logging something you did, for
example, watched a movie.

This is added by webmention support.

1. Bob wants to reply to Sue on his own website.
2. Sue enables webmentions(separate plugin) on her site.
3. Bob creates a post and sets it as a reply to or a like of Sue’s post.
4. A webmention is sent to Sue’s site, and Sue’s site uses the markup added by this plugin to determine what kind of post it is.
5. Sue’s site stores and displays data from the post as a comment on Sue’s post.

For more information on the Indieweb and tools for WordPress, visit Getting Started on
WordPress.

You can enable/disable more based on preference. Some may be enabled by plugins. You do not have to use ones you don’t want. Not having a post kind enabled
will not disable the functionality on existing posts, it only hides the selection in adding new posts.

These kinds have an analog in post formats. Adding context to one of these may make it a Passive Kind.

• Article – traditional long form content – a post with an explicit post name(title)
• Note – short content – a post with just plain content (also the default)
• Photo – image or photo post – a post with an embedded image as its primary focus. This uses either the featured image or attached images depending on theme.
• Video – video post – a post with an embedded image as its primary focus.
• Audio – audio post – a post with an embedded sound file as its primary focus.

The Response Kinds

• Reply – Replying to someone else’s comment
• Repost – a complete repost of someone else’s content
• Like – props/compliments to the original post/poster
• Favorite – special to the favoriter
• Bookmark – This is basically sharing/storing a link/bookmark.
• Quote – Quoted Content
• RSVP – A specific type of Reply regarding an event
• Check-In – Identifying you are at a place. To show full location, the Simple Location plugin is recommended as it will display maps.
• Issue – Issue is a special kind of article post that is a reply to typically some source code, though potentially anything at a source control repository.
• Review – Review is a post evaluating a product, service, or experience.

The Passive Kinds

To “Scrobble” a song is when listening to it, you would make it a post on
your website. This is the most well-known example of a passive kind of post. They are formed by having content in the context box on one of these types of
posts.

• Listen – scrobble – listening to an audio post
• Jam – Indicating a particularly personally meaningful song
• Watch – video – watching a video
• Play – playing a game
• Craft – making something…such as 3D printing, crafting, etc.
• Read – reading a book, compared to online material
• Eat – Representing recording what you eat, perhaps for a food diary
• Drink – Similar to Eat

The following Kinds are reserved for future use but will not show up in the
interface at this time.

• Wish – a post indicating a desire/wish. The archive of which would be
  a wishlist, such as a gift registry or similar.
• Weather – A weather post would be current weather conditions
• Exercise – Representing some form of physical activity
• Trip – Representing a trip…this represents a geographic journey and would require location awareness.
• Itinerary – Itinerary – this would refer to scheduled transit, plane, train, etc. and does not require location awareness
• Tag – Allows you to tag a post as being of a specific tag, or person tagging.
• Follow – A post indicating you are now following someone’s activities
• Mood – Mood – Feeling
• Recipe – Recipe
• Event – An event is a type of post that in addition to a post name (event title) has a start datetime (likely end datetime), and a location.
• Sleep – Sleep is a passive metrics post type that indicates how much time (and often a graph of how deeply) a person has slept.
• Acquisition – Purchased, Donated, or otherwise acquired an object
• Question – Question is a post type for soliciting answer replies, which are then typically up/down voted by others and then displayed underneath the question post ordered by highest positive vote count rather than time ordered.

I would prefer if something is popular enough to merge it into the plugin. Feel free to ask for a term to be reserved by filing an issue.
However if you are interested in creating your own there is functionality around it.

register_post_kind(
‘reply’,
array(
‘singular_name’ => __( ‘Reply’, ‘indieweb-post-kinds’ ), // Name for one instance of the kind
‘name’ => __( ‘Replies’, ‘indieweb-post-kinds’ ), // General name for the kind plural
‘verb’ => __( ‘Replied to’, ‘indieweb-post-kinds’ ), // The string for the verb or action (liked this)
‘property’ => ‘in-reply-to’, // microformats 2 property
‘format’ => ‘link’, // Post Format that maps to this
‘description’ => __( ‘a reply to content typically on another site’, ‘indieweb-post-kinds’ ),
‘description-url’ => ‘http://indieweb.org/reply’,
‘title’ => false, // Should this kind have an explicit title
‘show’ => true, // Show in Settings
)
)
);

Add a function with your kind in the above format, hooking it in the init hook and it will add the Kind to the system.

set_post_kind_visibility( $slug, $show = true ) – If you add this function in early on, it will change the visibility of a kind.

Post Kinds automatically handles the display of archives of individual types. So to view all the posts marked as “note”, for example, one could visit the URL http://www.YOURSITE.COM/kind/note/.
Simply replace YOURSITE.COM with your particular site name and the particular post kind name to access the others.

You can also add the date /kind/note/2018/12/24 to see date-based archives.

For archives if you add exclude_kind as a query variable it will exclude specific kinds from the query ?exclude=kind&exclude_terms=note. You can also do this as /exclude/kind/note,checkin as it accepts multiple values

There is also a special photo photo included, using ?kind_photos=1 or /photos or /photos/yyyy or /photos/yyyy/mm or /photos/kind/note or any other taxonomy. This will use the photo enhancements introduced in 3.4.0 to only show photos from
all types of posts.

Post Kinds also automatically handles RSS feeds which can be made available or subscribed to for any of the particular kinds. The RSS feed for all the posts marked as “note”, for example could be found at either the URL http://www.example.com/kind/note/feed or http://www.example.com/feed/?kind=note (if one doesn’t have pretty permalinks enabled). Others can be obtained by replacing “note” with the other kinds.

At the moment, a fully automatic bookmarklet is not yet part of the plugin but you can send data directly to the Post Editor

• If you add ?kindurl=URL to the post editor URL, it will automatically fill this into the URL box in post properties
• If you add ?kind=like to the post editor URL, it will automatically set the kind.

So – https://www.example.com/wp-admin/post-new.php?kindurl=URL&kind=like will automatically set a like with the URL

Using the Micropub plugin for WordPress is the easiest way to post outside of the Post Editor. This will work with any Micropub client.

The JetPack sharing module conflicts with this plugin.

I am not sure. It is not a strict priority. At this time, there is no definite time for this support. I have been gradually moving toward abstracting more of the data into the REST API
so it could more easily be added to the block editor.

The Development version of the plugin is hosted at Github. You can file issues there.