MF2 Feed adds a machine readable version of your posts, in the same way WordPress already offers RSS feeds. Other sites and services (readers, Webmention endpoints, IndieWeb tools) can read your content as structured data, no matter which theme you use.<\/p>\n\n
Just install and activate the plugin. There are no settings.<\/p>\n\n
After activation every URL of your site gets two additional feeds:<\/p>\n\n
\/feed\/mf2\/<\/code>): the raw Microformats2<\/a> data, the same format a Microformats parser would produce.<\/li>\n- JF2<\/strong> (
\/feed\/jf2\/<\/code>): a simplified version of the same data, easier to read and to work with. See the JF2 spec<\/a>.<\/li>\n<\/ul>\n\nExamples<\/h3>\n\n\n- Your site:
https:\/\/example.com\/<\/code> \u2192 https:\/\/example.com\/feed\/mf2\/<\/code> and https:\/\/example.com\/feed\/jf2\/<\/code><\/li>\n- A single post:
https:\/\/example.com\/2024\/01\/my-post\/<\/code> \u2192 https:\/\/example.com\/2024\/01\/my-post\/feed\/mf2\/<\/code> and https:\/\/example.com\/2024\/01\/my-post\/feed\/jf2\/<\/code> (the comments of the post are included)<\/li>\n<\/ul>\n\nA live example: https:\/\/notiz.blog\/2013\/06\/18\/the-rise-of-the-indieweb\/<\/a> and the matching mf2<\/a> and jf2<\/a> feeds.<\/p>\n\nThe plugin also adds rel=\"alternate\"<\/code> links to the <head><\/code> of every page, so tools can discover the feeds on their own. And it supports content negotiation: a client that requests a post with the Accept: application\/mf2+json<\/code> (or application\/jf2+json<\/code>) header gets the JSON directly instead of the HTML.<\/p>\n\nWhy?<\/h3>\n\n
Microformats2<\/a> are a key building block<\/a> of the IndieWeb. But it is very hard (if not impossible) to get them into all WordPress themes. There are a few community themes<\/a> that support Microformats2, but you should be able to use the theme you like. After a lot of discussions<\/a> and some different plugin approaches, this plugin provides an alternate (rel=\"alternate\"<\/code><\/a>) representation instead of changing the HTML of your theme.<\/p>\n\nThe URL design is inspired by p3k<\/a> of @aaronpk<\/a>.<\/p>\n\n\nFrom the plugin directory<\/h3>\n\n\n- Go to Plugins > Add New<\/em> in your WordPress admin.<\/li>\n
- Search for \"
mf2-feed<\/code>\".<\/li>\n- Click Install Now<\/strong> and then Activate<\/strong>.<\/li>\n<\/ol>\n\n
Manual installation<\/h3>\n\n\n- Download the plugin from the WordPress directory<\/a> or from GitHub<\/a>.<\/li>\n
- Upload the
mf2-feed<\/code> folder to wp-content\/plugins\/<\/code> on your server.<\/li>\n- Go to Plugins<\/em> and click Activate<\/strong>.<\/li>\n<\/ol>\n\n\n
\nWhat are Microformats2?<\/h3><\/dt>\nMicroformats are a simple way to mark up structured information in HTML using classes. WordPress uses some classic Microformats out of the box. Microformats2 supersedes the classic ones. You can read more on microformats.org<\/a>.<\/p><\/dd>\nWhat is JF2?<\/h3><\/dt>\nJF2<\/a> is a simpler JSON format based on Microformats2. It is easier to consume in code, so most tools prefer it.<\/p><\/dd>\nDo I need a special theme?<\/h3><\/dt>\nNo. The feeds are generated from the post data, not from the HTML of your theme. That is the whole point of the plugin.<\/p><\/dd>\n
Are there any settings?<\/h3><\/dt>\nNo. Install, activate, done.<\/p><\/dd>\n
The feed URLs return a 404<\/h3><\/dt>\nThe plugin registers new rewrite rules on activation. If the URLs do not work, go to Settings > Permalinks<\/em> and click Save Changes<\/em> once. This flushes the rewrite rules.<\/p><\/dd>\nCan I change the feed output?<\/h3><\/dt>\nYes, for developers there are a few filters: mf2_feed_array<\/code> and jf2_feed_array<\/code> for the whole feed, mf2_entry_array<\/code> and jf2_entry_array<\/code> for a single entry, and mf2_feed_content_type<\/code> \/ jf2_feed_content_type<\/code> for the content type.<\/p><\/dd>\nWhere can I get help?<\/h3><\/dt>\nThe plugin is developed on GitHub at indieweb\/wordpress-mf2-feed<\/a>. Please file support issues there.<\/p><\/dd>\n\n<\/dl>\n\n\n