Log Settings

WordPress to Buffer Pro can log the result of each status message sent to Buffer through the Publish, Update, Repost and Bulk Publish actions.

Most of the time you won’t need to do anything with these Logs – however, they’re useful to confirm if WordPress to Buffer Pro attempted to send a status to Buffer, and whether the status was accepted.

In the WordPress Administration, click on the WP to Buffer Pro > Settings in the menu.
WordPress to Buffer Pro: Settings Menu

WordPress to Buffer Pro: Log Settings

Enable Logging

If enabled, for each Post, the Plugin will log whether statuses were sent to Buffer, and if so the result.

Display on Posts

If enabled, this displays Post-specific Logs on each Post when editing a Post, Page or Custom Post Type in the WordPress Administration interface.

WordPress to Buffer Pro: Logs: Post

Preserve Logs

Preserve Logs defines the number of days to preserve logs for before they are automatically purged (deleted) from the log database table.  A sensible default is provided by the Plugin of 30 days, but you may wish to adjust this accordingly.

If the value is zero or blank, logs are kept indefinitely and never automatically deleted.

To monitor your WordPress Cron jobs, we recommend installing WP Crontrol. WordPress to Buffer Pro will display the Log Cleanup job with the Hook Name wp_to_buffer_pro_log_cleanup_cron

Logs can manually be deleted through the Logs screen by a WordPress Administrator.

View Logs

To view the Logs, click on WP to Buffer Pro > Logs in the WordPress Administration interface:
WordPress to Buffer Pro: Logs Menu

A table will be displayed, showing all status activity, ordered by when a status was sent to Buffer, newest to oldest:
WordPress to Buffer Pro: Logs: Table

Understanding Log Entries

Each log entry comprises of the following information:

Column Description
Post ID The Post ID the Log Entry refers to.
Request Sent When the status was sent from the Plugin to Buffer
Action The Post Action that triggered this status (Publish, Update, Repost, Bulk Publish)
Profile The Social Media Profile the status message is for
Status Text The Status Text of the status message
Result The result from sending the status to Buffer:

  • Success: The status was added to Buffer successfully.
  • Test: The status would be added to Buffer successfully, but the WP-CLI command for Reposting or Bulk Publishing used the –test_mode flag.  No status was added to Buffer.
  • Warning: No status was added to Buffer, because the Post or Plugin settings don’t provide any status(es) to add to Buffer.  This can be due to Status Conditions, or a particular Post Type not having statuses enabled.  This is not an error, and typically by design based on how each individual site owner configures their Plugin.
  • Error: The status was not added to Buffer.  The Response field will provide more information on the issue.
Response The response from either the Plugin or Buffer, depending on the Result:

  • Success: A message from Buffer confirming that the status was added.
  • Test:
  • Warning:
  • Error:
Buffer: Status Created At (Only when Result = Success).  When the status was added to Buffer.
Buffer: Status Scheduled For (Only when Result = Success).  When the status is scheduled to be sent by Buffer to the Profile.

If you’ve configured multiple statuses, or enabled statuses to be sent to multiple social media profiles, you will see individual log entries for each status and social media profile combination.

Viewing Post-specific Logs

To view logs for a specific Post, you can either:

  • Edit the Post, or
  • Use the Logs screen and search by Post Title or ID

Edit Post

Edit the Post that you wish to view the Log for.

The Log will then be displayed in a meta box towards the bottom of the screen:
WordPress to Buffer Pro: Logs: Post

Search Logs Screen

To view logs for a specific Post ID, or partial Post Title, from the Logs screen:

  • Enter the Post ID, or partial Post Title, in the search box:
    WordPress to Buffer Pro: Search
  • Click the Search button.

A table will be displayed, showing Log Entries matching the Post ID or partial Post Title

Filtering Logs

Logs can be filtered by:

  • Action (Post Publish, Post Update, Automatic Repost or Bulk Publish)
  • Social Media Profile
  • Result (Success, Test, Warning or Error)
  • Request Sent Date Range

To filter the logs, click on the relevant filter above the table, selecting the applicable value:
WordPress to Buffer Pro: Filters

Click the Apply button to see the filtered logs.

Delete Log Entries

To delete one or more log entries:

  • Click the checkbox beside each log entry in the table:
    WordPress to Buffer Pro: Bulk Actions: Select
  • Under Bulk Actions, select Delete:
    WordPress to Buffer Pro: Bulk Actions: Delete
  • Click the Apply button
Deleting Log Entries is irreversible.  Only do so if you do not need the Log Entries for further debugging.

Clear Log

To delete all log entries:

  • Click the Clear Log button
Clearing the Log will delete ALL Log Entries, and is irreversible.  Only do so if you do not need the Log Entries for further debugging.