dkukral

Joe Boydston

Used to email text of post when it is published.
<h3>License</h3>
Copyright 2010 – 2014 Joe Boydston, Don Kukral
This program is free software; you can redistribute it and/or modify 
it under the terms of the GNU General Public License as published by 
the Free Software Foundation; either version 2 of the License, or 
(at your option) any later version.
This program is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of 
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 
GNU General Public License for more details.
You should have received a copy of the GNU General Public License 
along with this program; if not, write to the Free Software 
Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USANone.

Email on Publish

Plugin for WordPress that emails to text of the post when published

David Shanske

IndieWeb

Ryan

Micropub is an open API standard that is used to create posts on your site using third-party clients. Web apps and native apps (e.g. iPhone, Android) can use Micropub to post short notes, photos, events or other posts to your own site, similar to a Twitter client posting to Twitter.com. Requires the IndieAuth plugin for authentication.
Once you’ve installed and activated the plugin, try a client such as <a href="http://quill.p3k.io/" rel="nofollow ugc">Quill</a> to create a new post on your site. It walks you through the steps and helps you troubleshoot if you run into any problems. A list of known Micropub clients are available <a href="https://indieweb.org/Micropub/Clients" rel="nofollow ugc">here</a>
Supports the full <a href="https://micropub.spec.indieweb.org/" rel="nofollow ugc">Micropub spec</a>
As this allows the creation of posts without entering the WordPress admin, it is not subject to any Gutenberg compatibility concerns per se. Posts created will not have Gutenberg blocks as they were not created with Gutenberg, but otherwise there should be no issues at this time.
Available in the WordPress plugin directory at <a href="https://wordpress.org/plugins/micropub/" rel="ugc">wordpress.org/plugins/micropub</a>.
<h3>License</h3>
This project is placed in the public domain. You may also use it under the <a href="http://creativecommons.org/publicdomain/zero/1.0/" rel="nofollow ugc">CC0 license</a>.
<h3>WordPress details</h3>
<h4>Filters and hooks</h4>
Adds ten filters:
<pre><code>before_micropub( $input )
</code></pre>
Called before handling a Micropub request. Returns <code>$input</code>, possibly modified.
<pre><code>micropub_post_content( $post_content, $input )
</code></pre>
Called during the handling of a Micropub request. The content generation function is attached to this filter by default. Returns <code>$post_content</code>, possibly modified.
<pre><code>micropub_post_type( $post_type = 'post', $input )
</code></pre>
Called during the creation of a Micropub post. This defaults to post, but allows for setting Micropub posts to a custom post type.
<pre><code>micropub_tax_input( $tax_input, $input )
</code></pre>
Called during the creation of a Micropub post. This defaults to nothing but allows for a Micropub post to set a custom taxonomy.
<pre><code>micropub_syndicate-to( $synd_urls, $user_id, $input )
</code></pre>
Called to generate the list of <code>syndicate-to</code> targets to return in response to a query. Returns <code>$synd_urls</code>, an array, possibly modified. This filter is empty by default
<pre><code>micropub_query( $resp, $input )
</code></pre>
Allows you to replace a query response with your own customized version to add additional information
<pre><code>micropub_suggest_title( $mf2 )
</code></pre>
Allows a suggested title to be generated. This can be used either to generate the post slug or for individuals who want to use it to set a WordPress title
<pre><code>indieauth_scopes( $scopes )
</code></pre>
This returns scopes from a plugin implementing IndieAuth. This filter is empty by default.
<pre><code>indieauth_response( $response )
</code></pre>
This returns the token auth response from a plugin implementing IndieAuth. This filter is empty by default.
<pre><code>pre_insert_micropub_post( $args )
</code></pre>
This filters the arguments sent to wp_insert_post just prior to its insertion. If the ID key is set, then this will short-circuit the insertion to allow for custom database coding.
…and two hooks:
<pre><code>after_micropub( $input, $wp_args = null)
</code></pre>
Called after handling a Micropub request. Not called if the request fails (ie doesn’t return HTTP 2xx).
<pre><code>micropub_syndication( $ID, $syndicate_to )
</code></pre>
Called only if there are syndication targets $syndicate_to for post $ID. $syndicate_to will be an array of UIDs that are verified as one or more of the UIDs added using the <code>micropub_syndicate-to</code> filter.
Arguments:
<ul>
<li><code>$input</code>: associative array, the Micropub request in <a href="http://micropub.net/draft/index.html#json-syntax" rel="nofollow ugc">JSON format</a>. If the request was form-encoded or a multipart file upload, it’s converted to JSON format.</li>
<li><code>$wp_args</code>: optional associative array. For creates and updates, this is the arguments passed to <code>wp_insert_post</code> or <code>wp_update_post</code>. For deletes and undeletes, <code>args['ID']</code> contains the post id to be (un)deleted. Null for queries.</li>
</ul>
<h4>Other</h4>
Stores <a href="http://microformats.org/wiki/microformats2" rel="nofollow ugc">microformats2</a> properties in <a href="https://codex.wordpress.org/Function_Reference/post_meta_Function_Examples" rel="nofollow ugc">post metadata</a> with keys prefixed by <code>mf2_</code>. <a href="https://indiewebcamp.com/WordPress_Data#Microformats_data" rel="nofollow ugc">Details here.</a> All values are arrays; use <code>unserialize()</code> to deserialize them.
Does not support multithreading. PHP doesn’t really either, so it generally won’t matter, but just for the record.
Supports Stable Extensions to Micropub:
<ul>
<li><a href="https://indieweb.org/Micropub-extensions#Post_Status" rel="nofollow ugc">Post Status</a> – Either <code>published</code> or <code>draft</code></li>
<li><a href="https://indieweb.org/Micropub-extensions#Visibility" rel="nofollow ugc">Visibility</a> – Either <code>public</code> or <code>private</code>.</li>
<li><a href="https://indieweb.org/Micropub-extensions#Query_for_Category.2FTag_List" rel="nofollow ugc">Query for Category/Tag List</a> – Supports querying for categories and tags.</li>
<li><a href="https://indieweb.org/Micropub-extensions#Slug" rel="nofollow ugc">Slug</a> – Custom slug.</li>
<li><a href="https://indieweb.org/Micropub-extensions#Query_for_Post_List" rel="nofollow ugc">Query for Post List</a> – Supports query for the last x number of posts.</li>
</ul>
Supports Proposed Extensions to Micropub:
<ul>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/35" rel="nofollow ugc">Limit Parameter for Query</a> – Supports adding limit to any query designed to return a list of options to limit it to that number.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/36" rel="nofollow ugc">Offset Parameter for Query</a> – Supports adding offset to any query. Must be used with limit.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/34" rel="nofollow ugc">Filter Parameter for Query</a> – Supported for the Category/Tag List query.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/16" rel="nofollow ugc">Location Visiblity</a> – Either <code>public</code>, <code>private</code>, or <code>protected</code></li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/7" rel="nofollow ugc">Query for Supported Queries</a> – Returns a list of query parameters the endpoint supports</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/8" rel="nofollow ugc">Query for Supported Properties</a> – Returns a list of which supported experimental properties the endpoint supports so the client can choose to hide unsupported ones.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/15" rel="nofollow ugc">Discovery of Media Endpoint using Link Rel</a> – Adds a link header for the media endpoint</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/32" rel="nofollow ugc">Supports extended GEO URIs</a> – Supports adding arbitrary parameters to the GEO URI. Micropub converts this into an mf2 object. Supported as built into the Indigenous client.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/30" rel="nofollow ugc">Supports deleting uploaded media</a> – Supports action=delete&url=url on the media endpoint to delete files.</li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/14" rel="nofollow ugc">Supports querying for media on the media endpoint</a> and <a href="//github.com/indieweb/micropub-extensions/issues/37)" rel="nofollow ugc">optional URL parameter for same</a></li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/45" rel="nofollow ugc">Supports filtering media queries by mime-type</a></li>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/8#issuecomment-536301952" rel="nofollow ugc">Return Visibility in q=config</a></li>
</ul>
Deprecated Extensions still Supported:
<ul>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/10" rel="nofollow ugc">Last Media Uploaded</a> – Supports querying for the last image uploaded …set to within the last hour. This was superseded by supporting <code>q=source&limit=1</code> on the media endpoint.</li>
</ul>
Extensions Supported by Other Plugins:
<ul>
<li><a href="https://github.com/indieweb/micropub-extensions/issues/6" rel="nofollow ugc">Query for Location</a> – Suported by Simple Location if installed.</li>
</ul>
If an experimental property is not set to one of the noted options, the plugin will return HTTP 400 with body:
<pre><code>{
 "error": "invalid_request",
}
</code></pre>
WordPress has a <a href="https://codex.wordpress.org/Uploading_Files#About_Uploading_Files_on_Dashboard" rel="nofollow ugc">whitelist of file extensions that it allows in uploads</a>. If you upload a file in a Micropub extension that doesn’t have an allowed extension, the plugin will return HTTP 400 with body:
<pre><code>{
 "error": "invalid_request",
 "error_description": "Sorry, this file is not permitted for security reasons."
}<h3>Authentication and authorization</h3>
</code></pre>
For reasons of security it is recommended that you only use this plugin on sites that implement HTTPS. Authentication is not built into this plugin.
In order to use this, the IndieAuth plugin is required. Other plugins may be written in future as alternatives and will be noted if they exist.
<h3>Configuration Options</h3>
These configuration options can be enabled by adding them to your wp-config.php
<ul>
<li><code>define('MICROPUB_NAMESPACE', 'micropub/1.0' )</code> – By default the namespace for micropub is micropub/1.0. This would allow you to change this for your endpoint</li>
<li><code>define('MICROPUB_DISABLE_NAG', 1 )</code> – Disable notices for insecure sites</li>
<li><code>define('MICROPUB_DRAFT_MODE', 1 )</code> – Override default post status and set to draft for debugging purposes.</li>
</ul>
<h3>Development</h3>
The canonical repo is http://github.com/indieweb/wordpress-micropub . Feedback and pull requests are welcome!
To add a new release to the WordPress plugin directory, tag it with the version number and push the tag. It will automatically deploy.
To set up your local environment to run the unit tests and set up PHPCodesniffer to test adherence to <a href="https://make.wordpress.org/core/handbook/coding-standards/php/" rel="nofollow ugc">WordPress Coding Standards</a> and <a href="https://github.com/wimg/PHPCompatibility" rel="nofollow ugc">PHP Compatibility</a>:
<ol>
<li>Install <a href="https://getcomposer.org" rel="nofollow ugc">Composer</a>. Composer is only used for development and is not required to run the plugin.</li>
<li>Run <code>composer install</code> which will install PHP Codesniffer, PHPUnit, the standards required, and all dependencies.</li>
</ol>
To configure PHPUnit
<ol>
<li>Install and start MySQL. (You may already have it.)</li>
<li>Run <code>./bin/install-wp-tests.sh wordpress_micropub_test root '' localhost</code> to download WordPress and <a href="https://develop.svn.wordpress.org/trunk/tests/phpunit/" rel="nofollow ugc">its unit test library</a>, into your systems tmp directory by default, and create a MySQL db to test against. <a href="http://wp-cli.org/docs/plugin-unit-tests/" rel="nofollow ugc">Background here</a>. Feel free to use a MySQL user other than <code>root</code>. You can set the <code>WP_CORE_DIR</code> and <code>WP_TESTS_DIR</code> environment variables to change where WordPress and its test library are installed. For example, I put them both in the repo dir.</li>
<li>Open <code>wordpress-tests-lib/wp-tests-config.php</code> and add a slash to the end of the ABSPATH value. No clue why it leaves off the slash; it doesn’t work without it.</li>
<li>
Run <code>phpunit</code> in the repo root dir. If you set <code>WP_CORE_DIR</code> and <code>WP_TESTS_DIR</code> above, you’ll need to set them for this too. You should see output like this:
Installing… 
… 
1 / 1 (100%) 
Time: 703 ms, Memory: 33.75Mb 
OK (1 test, 3 assertions)
</li>
</ol>
To set up PHPCodesniffer to test adherence to <a href="https://make.wordpress.org/core/handbook/coding-standards/php/" rel="nofollow ugc">WordPress Coding Standards</a> and <a href="https://github.com/wimg/PHPCompatibility" rel="nofollow ugc">PHP 5.6 Compatibility</a>:
<ol>
<li>To list coding standard issues in a file, run <code>composer phpcs</code></li>
<li>If you want to try to automatically fix issues, run `composer phpcbf“.</li>
</ol>
To automatically convert the readme.txt file to readme.md, you may, if you have installed composer as noted in the previous section, enter <code>composer update-readme</code> to have the .txt file converted 
into markdown and saved to readme.md.

Micropub

Great plugin that supports a very worthy movement in wordpress

great plugin

Allows you to publish to your site using Micropub clients.

Email on Publish vs Micropub