Status Settings


Videos are not designed to be a substitute for instructions. Please refer to the detailed Documentation below.

Once WordPress to Buffer Pro has been authenticated with your Buffer account, you’ll want to define one or more status updates to send to social media account(s) linked with your Buffer account.

WordPress to Buffer Pro provides granular control for determining which Post Types (Posts, Pages etc) to send to Buffer when they are published and/or updated.

For each Post Type, WordPress to Buffer Pro then provides options to:

  • Define Default status messages for Publish and/or Update
  • Choose which Social Media account(s) to send content to
  • Define social media account specific status updates for Publish and/or Update

To set your status messages, in the WordPress Administration, click on the WP to Buffer Pro > Settings in the menu.
WordPress to Buffer Pro: Settings Menu

Post Types

Depending on your theme and plugins, additional tabs may appear as well as the default Posts and Pages tabs. These additional tabs will be registered Custom Post Types.
WordPress to Buffer Pro: Status Settings: Post Type Tabs

To edit the status updates to be sent to Buffer for Posts, click on the Posts tab.

Post Type Tabs

For each Post Type, you’ll see each of your Buffer social media profiles, as well as a Defaults tab, listed on the left of the screen.

It’s important to go through each tab to define the settings you’ll need.

WordPress to Buffer Pro: Status Settings: Post Type Tabs

  • Defaults: Global settings that apply to enabled social media accounts.
  • Social Media Accounts: Each social media account linked to your Buffer account will be displayed here, one account per tab. Clicking a tab will provide options to enable posting to said social media account, as well as an option to override the default Defaults tab above.
    • Account Enabled: Tick this checkbox if you want to send status updates to this social media profile.
    • Override Defaults: Tick this checkbox if you want to specify a custom set of status updates for this specific social media profile.  If this checkbox is not ticked, the settings on the Defaults tab will be used.
It is not enough to just define the Defaults.  You must ALSO click on each Social Media Account tab, choosing whether to enable that Account.  If you do not, no statuses will be sent to Buffer.

For all tabs, the following settings are available:

Publish

  • Enabled: Tick this checkbox if you want to send a status update to your Buffer account when a Post, Page or Custom Post Type is published.  This also applies to scheduled Posts, Pages and Custom Post Types.
  • Add Status Update: Click this button to add an additional status update.  You can have as many status updates as you wish, but each must be unique to ensure Buffer and the social networks don’t reject them.

For each status update, the following options are available:
WordPress to Buffer Pro: Status Settings: Status

  • Insert Tag: Use this to select a template tag to insert into the status.
  • Image: Depending on the social network you’re defining a status for, up to three options are available here, which determine if and how a Featured Image is displayed with the status update.
    Refer to the Featured Image Documentation for a detailed breakdown and preview of how this setting operates.
  • Status: The main text to send for the status update.

Status: Shortcodes

Shortcodes can be used within the status text.

If your shortcode outputs HTML, this will be stripped out before the status is sent to Buffer.
If you’re using a PODS shortcode, you must include both the name and field attributes as a minimum.  For example, if your Post Type is called show and your PODS field is called line_up, you would use [pods name=”show” field=”line_up”]

Status: Tags

The following template tags can be inserted into status updates, either by:

  • Using the Insert Tag dropdown, displayed above the status message text field,
  • Manually typing in the template tag into the status message text field.
Name Tag Description
Site Name {sitename} Displays your WordPress’ site name
Post Title {title} Displays the Post / Page / Custom Post Type Title
Post Excerpt {excerpt} Displays the Post / Page / Custom Post Type Excerpt. If none if defined or available, will automatically generate from the Content.
Post Content {content} Displays the Post / Page / Custom Post Type Content.
Post Date {date} Displays the Post / Page / Custom Post Type Publish Date
Post URL {url} Displays the Post / Page / Custom Post Type URL
Post Meta Field {custom_field_NAME} Displays the Post / Page / Custom Post Type Custom Field Name’s value.  Replace NAME with the name of your Custom Field.  For example, a Custom Field called ‘test’ would use the template tag {custom_field_test}
Author Login {author_user_login} Displays the Post / Page / Custom Post Type’s Author’s Username
Author Nice Name {author_user_nicename} Displays the Post / Page / Custom Post Type’s Author’s Nice Name
Author Email {author_user_email} Displays the Post / Page / Custom Post Type’s Author’s Email Address
Author URL {author_user_url} Displays the Post / Page / Custom Post Type’s Author’s URL
Author Display Name {author_display_name} Displays the Post / Page / Custom Post Type’s Author’s Display Name
Author Meta Field {author_field_NAME} Displays the Post / Page / Custom Post Type Author Custom Field Name’s value.  Replace NAME with the name of your Custom Field.  For example, a Custom Field called ‘test’ would use the template tag {author_field_test}
Taxonomy: Category {taxonomy_category} Displays a list of Categories assigned to the Post / Page / Custom Post Type.  Each Category is preceded with a hashtag, and each Category is separated by a space.  For example, a Post with the Categories one, two and three would output as #one #two #three
Taxonomy: Tag {taxonomy_post_tag} Displays a list of Tags assigned to the Post / Page / Custom Post Type.  Each Tag is preceded with a hashtag, and each Tag is separated by a space.  For example, a Post with the Tags one, two and three would output as #one #two #three
Taxonomy: Format {taxonomy_post_format} Displays a list of Post Formats assigned to the Post / Page / Custom Post Type.  EachPost Format is preceded with a hashtag, and each Category is separated by a space.  For example, a Post with the Post Formats one, two and three would output as #one #two #three
Depending on your WordPress web site, you may see additional Taxonomies if they are supported by the Post Type that you’re configuring status messages for.

Status: Tags: Taxonomies

When using any taxonomy based template tag, such as {taxonomy_category}, you can optionally specify the maximum number of Terms that should be output on the status message.  This is useful if, for example, your Post has several Terms, and outputting all of them would result in a status message that is too long for a given social network.

To specify the maximum number of Terms, use the following format:

{taxonomy_category:n}

n is an integer number of the maximum number of Terms to output.  For example, if we wanted to output up to 2 Categories, we would use {taxonomy_category:2}

Status: Scheduling

WordPress to Buffer Pro: Status: Schedule: Options

For each defined status, several options are available to define where (and when) a status should appear in your Buffer queue:

Add to End of Buffer Queue

Adds the status update to the end of the social media profile’s queue.

Add to Start of Buffer Queue

Adds the status update to the start of the social media profile’s queue.

Post Immediately

Posts the status update to your social media profiles when the Post is published.

Custom Time

WordPress to Buffer Pro: Status: Schedule: Custom Time

Allows you to schedule the status on Buffer for a given offset in days, hours and minutes after your Post is published.

For example, to schedule a status update on Buffer to be sent to your to social media profiles 2 days after your Post is published:

  • Days: 2
  • Hours: 0
  • Minutes: 0

Custom Time (based on Custom Field / Post Meta Value)

WordPress to Buffer Pro: Status: Schedule: Custom Time Field

Allows you to schedule the status on Buffer for a given offset in days, hours and minutes relative to the Post’s Custom Field / Meta Field.

For example, to send a status update to social media profiles 2 days after the date given in your Post’s Custom Field called event_date:

  • Days: 2
  • Hours: 0
  • Minutes: 0
  • Before / After: After Custom Field Value
  • Custom Meta Field Name: event_date

For example, to send a status update to social media profiles 12 hours before the date given in your Post’s Custom Field called my_date:

  • Days: 0
  • Hours: 12
  • Minutes: 0
  • Before / After: Before Custom Field Value
  • Custom Meta Field Name: my_date
When using the Custom Field (based on Custom Field / Post Meta Value) option, the date value in your Post’s Custom Field must be in the format yyyy-mm-dd.

The Events Calendar: Relative to Event Start Date

WordPress to Buffer Pro: Status: Schedule: Event Start Date

This option is only available if The Events Calendar Plugin is installed and activated on your WordPress web site, and you are editing status settings for Events.

Allows you to schedule the status on Buffer for a given offset in days, hours and minutes relative to The Event Calendar Event’s Start Date.

For example, to send a status update to social media profiles 12 hours before an Event’s Start Date:

  • Days: 0
  • Hours: 12
  • Minutes: 0
  • Before / After: Before Event Date

The Events Calendar: Relative to Event End Date

WordPress to Buffer Pro: Status: Schedule: Event End Date

This option is only available if The Events Calendar Plugin is installed and activated on your WordPress web site, and you are editing status settings for Events.

Allows you to schedule the status on Buffer for a given offset in days, hours and minutes relative to The Event Calendar Event’s End Date.

For example, to send a status update to social media profiles 2 days before an Event’s End Date:

  • Days: 2
  • Hours: 0
  • Minutes: 0
  • Before / After: Before End Date

Specific Date and Time

WordPress to Buffer Pro: Status: Schedule: Specific Date and Time

This option is only available when defining status messages at Post level.  Refer to the Documentation on how to do this.

Allows you to schedule the status on Buffer for the given date and time.

Status: Re-Order Status Updates

To re-order a status updates, drag and drop them by clicking the number in the circle.

Status: Delete Status Updates

To delete a status update, click the bin icon below the number in the circle.


Update

  • Enabled: Tick this checkbox if you want to send a status update to your Buffer account when a Post, Page or Custom Post Type is updated.

The remaining functions in the Update panel are the same as the Publish panel.


Conditions: Taxonomies

For each status update, you can conditionally choose to send the status to Buffer based on whether a Post has (or does not have) specific Taxonomy Terms (categories, tags etc).

This is useful if, for example:

  • You want to send different status updates for a Post depending on the Post Category,
  • You do not want to send status updates for a Post belonging to a specific Category,
  • You want to send different status updates to different Pinterest boards depending on the Post Category

To define conditions for a status update, click on the Conditions: Taxonomies arrow to display available options:
WordPress to Buffer Pro: Status: Conditions: Taxonomies

  • Comparison: Choose a comparison method
    • No Conditions
      Do not apply any conditions to this status update for the given Taxonomy.
    • Post(s) must include ANY of the below Taxonomy Terms to send this status to Buffer
      The Post must have at least one of the Taxonomy Terms you specify, for the status update to be sent to Buffer.
    • Post(s) must include ALL of the below Taxonomy Terms to send this status to Buffer
      The Post must have all of the Taxonomy Terms you specify, for the status update to be sent to Buffer.
    • Post(s) must exclude ANY of the below Taxonomy Terms to send this status to Buffer
      The Post must not have any of the Taxonomy Terms you specify.  If the Post does contain one or more of the Taxonomy Terms you specify, the status update will not be sent to Buffer.
  • Terms
    • In the text input below the Comparison dropdown option, start typing the Taxonomy Term Name(s) that you require for this condition.
    • As you start typing, your existing Taxonomy Term Name(s) will appear in the list.  Click on a term to add it.
      WordPress to Buffer Pro: Status Settings: Conditions
    • To remove an existing Taxonomy Term, click the small cross to the left of the term
      WordPress to Buffer Pro: Status Settings: Conditions

Click Save to update your settings.


Conditions: Custom Fields

For each status update, you can conditionally choose to send the status to Buffer based on whether a Post has (or does not have) Custom Field Values (sometimes referred to as Meta Key values).  More than one rule can be specified per status, and each rule can have different comparison operators for the same or different Custom Fields.

This is useful if, for example:

  • You want to send different status updates for a Post depending on the value of a Custom Field, such as an Advanced Custom Field value or meta key value,
  • You do not want to send status updates for a Post where a meta key value is missing (such as your SEO Plugin’s Title field)

To define conditions for a status update, click on the Conditions: Custom Fields arrow to display the table:
WordPress to Buffer Pro: Status: Conditions: Custom Fields Table

  • To add additional conditions, click the Add Meta  / Custom Field Condition button.
  • To remove an existing condition, click the Remove button for the row you want to remove.

For each condition, the following options are available:

  • Key: The Custom Field (meta key) to inspect
  • Compare: The method used to compare the Post’s custom field value to the Value below.
  • Value: The value to compare.

For example, to only have a status be sent to Buffer when the Custom Field yoast_seo_title has any value:

  • Key: yoast_seo_title
  • Compare: Does Not Equal
  • Value: (leave blank)

WordPress to Buffer Pro: Status: Conditions: Custom Fields Table: Yoast Example

For example, to only have a status be sent to Buffer when the Custom Field price is greater than 10, and the Custom Field quantity is greater than or equal to 1:

  • Key: price
  • Compare: Greater Than
  • Value: 10
  • Key: quantity
  • Compare: Greater Than or Equal To
  • Value: 1

WordPress to Buffer Pro: Status: Conditions: Custom Fields Table: Example

Click Save to update your settings.

Once you have completed the Plugin setup, a green tick will be displayed on each Post Type and Social Media Account tab, to identify which are enabled for sending statuses to Buffer.