Contributors: dshanske
Tags: indieweb, interaction, posts, webmention, share, like
Stable tag: 2.5.2
Requires at least: 4.7
Tested up to: 4.7.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Ever want to reply to someone else's post with a post on your own site? Or to "like" someone else's post, but with your own site?
Post Kinds adds support for responding to and interacting with other sites using the standards developed by the IndieWeb by implementing kinds of posts.
It can also distinguish certain types of passive posts in a manner similar to post formats.
- Bob wants to reply to Sue on his own website.
- Sue enables webmentions(separate plugin) on her site.
- Bob creates a post and sets it as a reply to or a like of Sue's post.
- A webmention is sent to Sue's site, and stored as a comment on Sue's post.
For more information on the Indieweb and tools for WordPress, visit Getting Started on WordPress.
The Development version of the plugin is hosted at Github. You can file issues there.
The plugin requires the webmention plugin to support sending/receiving notice of a reply/like to another site which will appear as a comment. The Semantic Linkbacks plugin is available to more richly display the comment.
Settings have been completely changed and you will have to reset.
Due to changes in the Micropub plugin, multiple values for properties are now supported. Until this feature is supported in this plugin it will only look at the first value and ignore the others.
I have changed the icons again, to go back to something closer to the original. If anyone wants to contribute alternate icon sets for the project, willing to consider adding them. Also, coming up is another change to how the plugin stores and works with data to continue to move toward something closer to Microformats. Looking at a JF2 representation.
This version makes some changes to the presentation. Backup your installation first as a precaution. Lots of changes under the hood which will bear fruit in future.
This version migrates data to a new storage formats. Backup your installation first as a precaution.
Many sites will not need all of the kinds set up. What kinds of posts you wish to publish are specific to your needs.
You can enable/disable more based on preference. Some may be enabled by plugins.
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
- 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
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
- Read - reading a book, compared to online material
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
- Check-In - Identifying you are at a place. This would use the extended WordPress Geodata. It will require the Simple Location plugin to add location awareness to posts.
- Tag - Allows you to tag a post as being of a specific tag, or person tagging.
- Eat - Representing recording what you eat, perhaps for a food diary
- Drink - Similar to Eat
- Follow - A post indicating you are now following someone's activities
- Mood - Mood - Feeling
- Recipe - Recipe
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.
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.
- If you add
?kindurl=URLto the post editor URL, it will automatically fill this into the URL box in post properties - If you add
?kind=liketo 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 URL
Indieweb Post Kinds had support for replying to Twitter posts using the Social Network Auto Poster plugin. The developers of that plugin have not contacted the developer of this plugin.
= Version 2.5.2 =
* Generation of strings being moved from individual functions to one unified function to make management easier
* Description now appears on Archives
* Description now appears on settings page
* Adding of `kind-type` css class only to posts
* Enhance setting of kind based on micropub properties
* Only set post format on initial save not subsequent ones
= Version 2.5.1 =
* Fix bug hiding metabox
* Add drop down filter for Kinds to View Posts
= Version 2.5.0 =
* Parsing code now rewritten to add Parse This class based on Press This parsing code
* MF2 parsing code rewritten and consolidated - future improvements coming
* Link Preview class now supports AJAX over REST API instead of admin-ajax
* Start/End and Published/Updated Separated in UI
* Duration is calculated and saved when post is saved based on start and end dates
* RSVP property created and the RSVP kind now available as an option
* Tags now an option for a reply-context and will be displayed as hashtags in future.
* Facebook manual embed code removed as Facebook is now supported by WordPress as of 4.7 for embeds
* Google Plus manual embed code removed even though Google Plus is not supported mostly because did not wish to maintain as sole exception
* Add whitelist - oembed will only be used if one of the officially whitelisted sites is there(Filter Available). Otherwise it will use the link-preview generation. Option to disable.
* Set default post format based on post kind.
* Redoing of options and removal of option to remove post formats support and theme compat
* Update help description
* Fix Mood SVG
* Cleanup and removal of older code
= Version 2.4.4 =
* Simplify coding standards issues
* Update settings
* Add quote kind ( props @miklb )
* Enhance parsing code in preparation for more enhancement
= Version 2.4.3 =
* Setting of Kind from Micropub now fixed due changes in Micropub plugin
* Micropub sets all properties as arrays including single properties and to match this will require more extensive changes.
In interim plugin will ignore multiple values and only use the first.
= Version 2.4.2 =
* Fix text domain
* Compatibility check for 4.6
* Change default to article from note, per commentary.
= Version 2.4.1 =
* Fix error where Twitter shim is not loaded if other version of MF2 Parser is loaded
* Reserve Recipe per Request
* Removed the word travel and replaced with trip and itinerary...(idea from @aaronpk).
= Version 2.4.0 =
* Refactor to initialize classes in new plugin loading class
* Remove additional global functions
* Switch from inline SVG to an SVG sprite
* Switch icons back to new Genericon svg icon set with supplements from FontAwesome
* Switch like to a heart to be in line with current thinking on this
* Views now use a function that looks for a directory called kind_views in the theme in the event any theme wants to customize display kinds
* Mood was added as a reserved kind per request @acegiak
* Made some adjustments to the meta parsing to improve results
= Version 2.3.7 =
* Remove auto-set function for kind if not post type post
* Move global functions to the class in which they were used
* Refine MF2 parser check to hide retrieve button if version is less than 5.3
= Version 2.3.6 =
* Manually fix Parser which in latest version has one line that breaks compatibility with PHP 5.3
* Disable MF2 Parser usage if version lower than 5.3
= Version 2.3.5 =
* Remove comment transition action in favor of proposing it be moved into webmentions plugin
* Replace send webmentions code with a hook
* Add PHP docblocks to php-mf-cleaner
* Update to latest version of MF2 Parser
* Theme Compatibility CSS separated from Basic CSS and Admin CSS again
* Remove helper functions no longer used
= Version 2.3.4 =
* The CSS included with Post Kinds hides entry-title by default where applicable for non-aware themes.
* Attempted to fix reported issue with wrong URL being sent webmention
* Fix error with emoji decode test backcompat
* Separate parsing code into separate class
* Retire separate OGP Parser in favor of simpler built in code
= Version 2.3.3 =
* Fix issue with improper microformats generating bad parsed results.
* Add default kind option
* Change how plugin handles default options by adding Defaults function
* Bug fix by acegiak to content protection override
* Feature added by acegiak to set default kind if no kind is set when post is saved
* Add post_id to filter kind_response_display
* When retrieving information on a URL, set the title to the title of the URL if no title is set
* Add kindurl query variable to admin. If you add it to wp-admin/post-new.php with a URL then it will automatically put that URL in the URL box. For use by bookmarklets
= Version 2.3.2 =
* Fix rendering issues when no response
* Add support for Indieweb Plugin
* Special rendering for excerpts
= Version 2.3.1 =
* Changed method of retrieving svg files due server restrictions
* Jquery Date and Time Picker now enables when HTML5 input date/time not supported
= Version 2.3.0 =
* Attempt to fix emoji issue reported by @acegiak
* Duration to be deprecated and replaced by start date and end date. The presence of a duration field will be used over start minus
end date..
* Start/Published Date and End/Updated Date have an updated input field instead of a text string
* Response caching removed due limited utility
* Removal of older code in favor of new templating system for each kind. Have tried this before, but really want to make it work.
* Font icon replaced with SVG icons.
* Retrieve button now generates an alert if the URL box is blank or does not have a URL.
* Start of help system
* Hooks for possible future author data to be stored/retrieved from a nicknames cache
* Activation of the jam post kind, previously reserved.
* Addition of the read post kind, reflecting having read a book, as opposed to shorter content.
* Reserving of the quote post kind, for excerpting. Will be added in future version
= Version 2.2.1 =
* Minor Tweaks and Bugfixes from changes in 2.2.0.
* Inputs Sanitized for Your Protection
* Summary currently shows summary of input if available. Full content is
parsed if marked up with microformats, however this, like many elements,
is not currently used.
* Rewrote storage protocol for better retrieval but still in intermediate
state.
* Plan to rewrite and improve the display functionality with more templates
for version 2.3.0.
= Version 2.2.0 =
* New Tabbed Metabox - More Fields are Always Desired and this new design
allows for more fields to be added without overwhelming the interface
* AJAX Enabled Retrieve Function instead of Automatic Retrieval
* New Fields for Citation (Published, Updated, Featured Image)
= Version 2.1.2 =
* Fix priority - user entered values should override parsed ones
* Add filters for parsing from additional markup and building the metadata
* Support for microformats2 import of metadata in addition to existing
support for OpenGraph
* In the next version, will be rewriting the additions to the post editor.
per request, it will give more control over the automatic parsing.
* Webmentions are now only sent if the new status is publish
= Version 2.1.1 =
* Bugfixes from Version 2.1.0
* Removal of Semantic Linkbacks code due upgrade in Semantic Linkbacks
making it unnecessary
= Version 2.1.0 =
* Metadata Processing will be centralizing in the Kind_Meta class
* Continuing to move toward WordPress Coding Standards including inline documentation
* Fixes for the OpenGraph Parsing of Content to Fill Additional Metadata
* Metadata fields not part of the user interface to be stored for future use
* You can now pre-select a kind by adding ?kind=reply to wp-admin/post-new.php
* Merged the Kind_View and Kind_Display into a single class
* Plan for Customizable Display Objects will be replaced by hooks/filters in the next version.
* New Function get_post_mf2meta to retrieve the mf2 prefixed metadata
* Supports setting the post kind for posts created by Micropub plugin
* Rearrangement of classes and functions in an attempt to simplify
* Settings Page Now Allows You to Select which Kinds to Show in the New Post UI
* Clarified that some terms are reserved for use as future kinds.
* Added reserved terms eat, drink, follow and jam.
* Supports setting kind eat or drink when triggered by Teacup/Micropub only
= Version 2.0.2 =
* Change markup to use e-content instead of p-content
* Add versioning for CSS
= Version 2.0.1 =
* Bugfixes
* Accepted fix for webmention sending from acegiak
* Add option to disable sideloading of author images
= Version 2.0.0 =
* Rewrite completed
* Multi-author/multi-reply temporarily removed in storage, but it wasn't being used yet anyway
* Customizable display objects now supported
* Open Graph Protocol Parsing Added to Extract Title/Description/Image from URLs
* Sideloads Author Picture
* Add Duration Meta Field by request of Acegiak. This can be used for duration of activity...
for example, watching/playing/listening/exercising/etc.
= Version 1.4.1 =
* Bug fixes for changes made in 1.4.0.
= Version 1.4.0 =
* Begin rewrite to class-scoped functions in line with WordPress Guidelines.
* Part of a major refinement and tightening of code
= Version 1.3.1 =
* Additional refinements to kind defaults and minor bugfixes
= Version 1.3.0 =
* Add functionality to better customize displays for different types.
* Add default options on activation.
* Show/hide check-in if Simple Location plugin is enabled.
* Change exclude types to include types.
* Add filter for plugins to show/hide kinds in the selector.
* Reduce default to a handful of kinds for new users. The plan going forward is to have some functionality enabled by secondary plugins
= Version 1.2.3 =
* Fix bug introduced in 1.2.2 with URL storage.
* Add publication as a field option
= Version 1.2.2 =
* Add option to disable KSES protection on the content box(courtesy/request of acegiak).
* Minor cleanup
= Version 1.2.1 =
* Add filter to support post kinds for Semantic Linkbacks plugin.
* Add responses to feed content.
= Version 1.2.0 =
* Change to store meta using [WordPress Data](https://indieweb.org/WordPress_Data) proposal.
* Display functionality broken into individual pieces to make it easier to customize and edit
* Multi-reply support in the data structure/display but not in entry
= Version 1.1.1 =
* Adds theme support and removes embed in content option
= Version 1.1.0 =
* Added new kinds - listen, watch, check-in, play at the suggestion of acegiak.
* Adds support for passive kinds.
* Some code cleanup and commenting.
* Start of add_theme_support function. This will replace the setting to embed in content in a future version.
= Version 1.0.2 =
* Bug fixes
= Version 1.0.1 =
* Update Readme to better describe
= Version 1.0 =
* Now in the WordPress repository
= Version 0.3 =
* Custom Code for Generating the Kind Select Box to Allow for Default Kind.
* Defined constant POST_KIND_EXCLUDE to hide kinds from the selector
= Version 0.24 =
* Added Grunt/SASS support to more easily control changes and support internationalization
= Version 0.23 =
* Option to refresh the cache on each load added
= Version 0.22 =
* Complete response html cached to post-meta and purged on post update.
= Version 0.21 =
* Temporary fix for slow embed code in preparation for caching to reduce calls.
* Removed defaultterms check to only run on settings page save or plugin activation instead of on each load.
= Version 0.2 =
* Forked to Indieweb Post Kinds to reflect a change to act as an alternative to the post formats feature of WordPress.
* Removed multikind option. Prior to this, the plugin functions mirrored those of tags. With the removal of multikind support, each post can only have one kind, and the functions will more closely mirror the Post Format.
* Complete rewrite of the display functionality.
= Version 0.11 =
* Option to Update Metadata Deliberately Commented Out.
* Anyone who used the old plugin should backup their database before considering migration. The data should still be in the database regardless.
= Version 0.1 =
** * Revised settings page to use WordPress Settings API. Alert:** This version switches to using an array for storage of response data for future development. To migrate your data, please backup your database and then check Migrate to new data structure on update on the options page.
= Version 0.06 =
* Added in support for Favorite
* fixed webmention support.
= Version 0.05 =
* Set up embed handler for commonly linked sites.
* Add options to turn on embeds for these sites.
* Plugin is probably now feature complete enough for test deployment to a live site.
= Version 0.04 =
* Add function to generate verbs(Like to Liked...) for a given kind.
* Add Display functionality in Beta.
* Include Genericons and Dashicons for icon options for the various kinds.
* Add plugin option to add the response URL to the top or bottom of the content section.
* Plugin near point at which can be deployed for basic use.
= Version 0.03 =
* Location function removed and split into separate plugin called Simple Location.
* Any check-in kind functionality will have this as a dependency.
= Version 0.02 =
* Location meta box with HTML5 geolocation fill-in added. This allows posts to optionally have a location. This is as per the Wordpress Geodata specifications, so the Wordpress Android app will fill them in. There is no display functionality.
* Various functions that mimic the built-in functions for other taxonomies were added, including filters to add additional behaviors. Default terms now prepopulate if no terms exist.
= Version 0.01 =
* Registers a custom taxonomy
* adds in code snippets to turn the post meta box from checkboxes to radio buttons
* adds code to allow a custom permalink tag if needed.