Kat Hagan

<p><strong>Warning:</strong> This plugin is currently in beta!  Use at your own risk and please report any bugs, either on the <a href="https://wordpress.org/support/plugin/post-by-email" rel="ugc">WordPress Support forums</a> or via the <a href="https://github.com/codebykat/wp-post-by-email/issues" rel="nofollow ugc">Github issues page</a>.</p>
<p>Any new messages sent to the configured email address will be posted to the blog.  This plugin replaces the functionality that used to live in WordPress core.</p>
<p>Once an email has been successfully posted to the blog, it can either be marked as read (IMAP servers only) or deleted from the mailbox.</p>
<p>Updates on the project can be found on the <a href="https://make.wordpress.org/core/tag/post-by-email/" rel="nofollow ugc">Make WordPress Core blog</a>.</p>
<h3>Features</h3>
<ul>
<li>Supports IMAP or POP3 servers, with or without SSL</li>
<li>Optional PIN-based authentication guards against email spoofing</li>
<li>Uses WordPress’s built-in roles to manage which users can post</li>
<li>Set categories, tags and custom taxonomies by including shortcodes in your email</li>
<li>Email attachments will automatically be added to the post’s gallery</li>
<li>Emails from unauthorized users can be either set as pending or discarded</li>
</ul>
<h3>Post Authors and Security</h3>
<p>The “From” address is matched to WordPress users in the database to determine the post’s author.  If the author doesn’t have an account or isn’t allowed to publish posts, the post status will be set to “pending”.</p>
<p>By default, any users in the Author, Editor or Administrator roles are able to publish posts.  Use the Users menu item in the admin dashboard to view and manage which users have this capability.  For more information on the WordPress permissions system, see <a href="https://codex.wordpress.org/Roles_and_Capabilities" rel="nofollow ugc">Codex: Roles and Capabilities</a>.</p>
<h3>Shortcodes</h3>
<p>By default, emailed posts will be placed in the default category configured in the settings.</p>
<p>You can also set the categories, tags and custom taxonomy terms on your posts by including shortcodes in your email.  These should be space-separated.  Use slugs for tags (and non-hierarchical taxonomies) and either slugs or IDs for categories (/ hierarchical taxonomies).  Terms that do not yet exist will be created.  Examples:</p>
<p><strong>Categories:</strong> Use either slugs or IDs.<br />
    [category posted-by-email another-category]<br />
    [category 14]</p>
<p><strong>Tags:</strong> Use slugs.<br />
    [tag cool-stuff]</p>
<p><strong>Custom Taxonomies:</strong> Use slugs for non-hierarchical taxonomies, and IDs for hierarchical.<br />
    [custom-taxonomy-name thing1 thing2]<br />
    [another-custom-taxonomy 2 3 5]</p>
<h3>Attachments</h3>
<p>Any files attached to an email will be uploaded to the Media Library and added to the post as a gallery.  You can specify gallery options, or its location within the post, by including a <a href="https://codex.wordpress.org/Gallery_Shortcode" rel="nofollow ugc">gallery shortcode</a> in your email.  If no gallery shortcode exists, it will be added to the end of the post.</p>
<h3>Testing</h3>
<h4>Automated Tests</h4>
<p>Like WordPress Core, this plugin includes automated unit tests written in PHPUnit.</p>
<p>To run the unit tests:</p>
<ol>
<li>Set up the WordPress testing library as described in <a href="https://make.wordpress.org/core/handbook/automated-testing/" rel="nofollow ugc">Handbook: Automated Testing</a>.  You can also do this <a href="http://wp-cli.org/blog/plugin-unit-tests.html" rel="nofollow ugc">using WP-CLI</a>.</li>
<li>From the plugin directory, run <code>WP_TESTS_DIR=/path/to/WordPress/test/install phpunit</code></li>
</ol>
<h4>Manual Testing</h4>
<ol>
<li>Set up a test email address (services such as Gmail work great for this) and enable IMAP or POP3 access.  (Refer to <a href="https://wordpress.org/plugins/post-by-email/installation/" rel="ugc">Installation</a> for detailed instructions.)</li>
<li>Verify that you are using the correct mailbox settings by using a third-party email client, such as Outlook or OSX Mail.app, to connect to your test mailbox.</li>
<li>Enter those settings into the Post By Email settings and save them.</li>
<li>Navigate to the “Activity Log” tab and press the “Check Now” button.  When the page reloads, you should see a new entry in the log file describing the results of the mail check.</li>
</ol>
<p><strong>Caveat:</strong> There is sometimes a delay between sending an email and having it show up in the mailbox, especially with POP3.  If you’re using IMAP, you can connect using a third-party mail client to verify that messages have been received, then mark them as unread so Post By Email will pick them up.</p>
<h3>Reporting Bugs</h3>
<p>Before reporting a bug, make sure you’ve updated the plugin to the latest version.</p>
<p>Then, provide as much of the following information as possible:</p>
<ol>
<li>WordPress version (e.g. 3.6.x).</li>
<li>Plugin version (e.g. 1.0.4).</li>
<li>PHP version (e.g. 5.2.x or 5.3.x).</li>
<li>Your mailbox settings (URL, protocol, port and whether SSL is enabled; not your login and password).</li>
<li>Any error messages displayed (it might help to <a href="https://codex.wordpress.org/WP_DEBUG" rel="nofollow ugc">enable WP_DEBUG</a> in your wp-config.php).</li>
<li>If the issue is related to a specific email, the full email, including headers.  Feel free to replace any personal information with dummy text (such as “sender@example.com”).  <a href="https://support.google.com/groups/answer/75960?hl=en" rel="nofollow ugc">This link</a> has instructions for viewing full message headers in Gmail, Outlook and Yahoo.</li>
</ol>


Post By Email

Create new posts on your WordPress blog by sending email to a specific email address.

Barry Ceelen

<p><strong>Note:</strong> Requires the <a href="https://wordpress.org/plugins/post-by-email/" rel="ugc">Post By Email</a> plugin.</p>
<p>The plugin filters the post content after a post has been created via the <a href="https://wordpress.org/plugins/post-by-email/" rel="ugc">Post By Email</a> plugin.<br />
If the post content contains only a URL it automatically assigns the ‘link’ <a href="https://codex.wordpress.org/Post_Formats" rel="nofollow ugc">post format</a> to the post and wraps the URL in a link tag.</p>
<h4>Github</h4>
<p>Fork me on <a href="https://github.com/barryceelen/wp-post-by-email-links" rel="nofollow ugc">Github</a>.</p>


Post By Email Links

Create new posts with the 'link' post format by sending an email with a URL or link as the body.

Post By Email vs Post By Email Links