Like WordPress Core, this plugin includes automated unit tests written in PHPUnit.
To run the unit tests:
- Set up the WordPress testing library as described in Handbook: Automated Testing. You can also do this using WP-CLI.
- From the plugin directory, run
- Set up a test email address (services such as Gmail work great for this) and enable IMAP or POP3 access. (Refer to Installation for detailed instructions.)
- 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.
- Enter those settings into the Post By Email settings and save them.
- 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.
Caveat: 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.
Before reporting a bug, make sure you've updated the plugin to the latest version.
Then, provide as much of the following information as possible:
- WordPress version (e.g. 3.6.x).
- Plugin version (e.g. 1.0.4).
- PHP version (e.g. 5.2.x or 5.3.x).
- Your mailbox settings (URL, protocol, port and whether SSL is enabled; not your login and password).
- Any error messages displayed (it might help to enable WP_DEBUG in your wp-config.php).
- 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 "email@example.com"). This link has instructions for viewing full message headers in Gmail, Outlook and Yahoo.