A WordPress plugin for JAMstack deployments on Netlify (and other platforms).
This plugin provides a way to fire off a request to a webhook when a post, page or custom post type has been created, udpated or deleted. You're also able to fire off a request manually at the click of a button, or programmatically via a WordPress action.
The plugin attempts to trigger builds when you update your content, and has settings that you can use to define what post types & taxonomies should be monitored. However, when you need more control, there are actions & filters you can use to get the job done.
You can choose which posts types should trigger builds from the plugin settings. However, you may require more control, or need to overwrite the settings, you can do so using the jamstack_deployments_post_types
filter. By default, this filter contains an array of post types that we monitor. You can add or remove them as required.
For example, if you want to force the plugin to trigger builds for the 'post'
post type regardless of the settings, you can do so with the following code:
add_filter('jamstack_deployments_post_types', function ($post_types, $post_id, $post) {
if (!in_array($post->post_type, $post_types, true)) {
$post_types[] = 'post';
}
return $post_types;
}, 10, 3);
Like post types, you can choose which taxonmies should trigger builds from the plugin settings. But there may be times you need more control. For this, you can use the jamstack_deployments_taxonomies
filter. By defualt, this filter contains an array of taxonomies that we monitor.
For example, if you want to force the plugin to trigger builds for the 'post_tag'
taxonomy regardless of the settings, you can do so with the following code:
add_filter('jamstack_deployments_taxonomies', function ($taxonomies, $term_id, $tax_id) {
$tax = get_taxonomy($tax_id);
if (!in_array($tax->name, $taxonomies, true)) {
$taxonomies[] = 'post_tag';
}
return $taxonomies;
}, 10, 3);
You can use the jamstack_deployments_post_statuses
filter to change which post statuses we monitor. The default is to monitor 'publish'
, 'private'
and 'trash'
.
Here is an example that adds 'review'
to the array of post statuses that we monitor & will trigger builds for.
add_filter('jamstack_deployments_post_statuses', function ($statuses, $post_id, $post) {
$statuses[] = 'review';
return $statuses;
}, 10, 3);
The jamstack_deployments_fire_webhook
action can be used to fire the webhook and trigger a build at a custom point that you specify. For example, if you want to fire the webhook when a user registers, then you can use:
add_action('user_register', 'jamstack_deployments_fire_webhook');
You can run code directly before or after you fire the webhook using the following actions:
- Before:
jamstack_deployments_before_fire_webhook
- After:
jamstack_deployments_after_fire_webhook