View Categories

Getting Started With Metadata Scheduling (Pro)

This feature requires the Pro version of the PublishPress Future plugin.

In the Pro version of the PublishPress Future plugin it is possible to schedule changes to your posts based on metadata. This makes it possible to integrate PublishPress Future with other plugins. For example, you can create a date field in the Advanced Custom Fields plugin and use that to control the date for Future Actions.


Where to Find Metadata Scheduling #

  • In your WordPress admin menu, go to “Future Actions” and the “Post Types” tab.
  • Use the “Select a post type to edit” option to choose the post type you want to use with Metadata Scheduling:
Select a post type to edit
  • Check the box for “Enable Metadata Scheduling”.
Enable Metadata Scheduling

Types of Data in Metadata Scheduling #

When you are using an integration, there are types of data that you can update in PublishPress Future:

  • Action Date: This field stores the scheduled date for the action.
  • Action Type: This field stores the type of action that will be executed.
  • New Post Status: The field stores the post status the post receives when Action Type is “change-status”.
  • Action Status: This field specifies if the action should be enabled. Anything different from “saved” or 1 will mean that the action is disabled.
  • Taxonomy Name: The taxonomy name for being used when selecting terms. Only required for taxonomy-related actions.
  • Taxonomy Terms: A list of term's IDs for being used by the action. Only required for taxonomy-related actions.

If you've enabled this feature for a specific post type, you can optionally customize the metakey used for storing each Future action's data or stick with the default metakeys. Then every time the metadata is processed, the plugin will look for the specific metadata, and if the flag is not found, it will process the scheduling based on the metadata values.

NameDefault MetakeyData FormatDescription
Action Date
_expiration-dateUnix timestamp or YYYY-mm-dd H:i:s
This field stores the scheduled date for the action.
Action Type_expiration-date-typeIt should contain a lowercase string, with no spaces or special chars. A value that is compatible with sanitize_key.This field stores the type of action that will be executed.
New Post Status_expiration-date-post-satusIt should contain a lowercase string, with no spaces or special chars. A value that is compatible with sanitize_key.This field is used when Action Type is “change-status”, and stores the new status for the post.
Action Status_expiration-date-status“saved” or 1This field specifies if the action should be enabled or not. Anything different from “saved” or 1 will mean that the action is ignored.
Taxonomy Name_expiration-date-taxonomyIt should contain a lowercase string, with no spaces or special chars. A value that is compatible with sanitize_key.The taxonomy name for being used when selecting terms. Only required for taxonomy related actions.
Taxonomy Terms_expiration-date-categoriesA comma separated list of integer numbers.A list of term's IDs for being used by the action. Only required for taxonomy related actions.

Available Action Types #

Action NameAction Description
change-statusChange status to the value found on “New Post Status”.
draftChange status to Draft (deprecated)
privateChange status to Private (deprecated)
trashChange status to Trash (deprecated)
deleteDelete
stickStick
unstickUnstick
categoryReplace all categories
category-addAdd extra categories
category-removeRemove selected categories
category-remove-allRemove all categories
custom_status_[custom-status-name]Change status to [custom-status-name] – Only on Pro, for statuses enabled for the post type.