From c271cdb113ddb2d0407452b91b04ae5e1351fe92 Mon Sep 17 00:00:00 2001 From: Niloth P <20315308+Niloth-p@users.noreply.github.com> Date: Mon, 8 Jul 2024 00:49:55 +0530 Subject: [PATCH] integration-docs: Update WordPress for new doc format. Part of zulip#29592. Co-authored-by: Lauryn Menard --- zerver/webhooks/wordpress/doc.md | 40 ++++++++++++++++++-------------- 1 file changed, 22 insertions(+), 18 deletions(-) diff --git a/zerver/webhooks/wordpress/doc.md b/zerver/webhooks/wordpress/doc.md index 0734b08f08..b513ba7322 100644 --- a/zerver/webhooks/wordpress/doc.md +++ b/zerver/webhooks/wordpress/doc.md @@ -1,33 +1,37 @@ +# Zulip WordPress integration + Get WordPress notifications in Zulip! -If you're hosting your WordPress blog yourself (i.e., not on WordPress.com), -first install the -[HookPress plugin](https://wordpress.org/plugins/hookpress/) (experimental). +{start_tabs} 1. {!create-channel.md!} 1. {!create-an-incoming-webhook.md!} -1. {!generate-integration-url.md!} +1. {!generate-webhook-url-basic.md!} - **Important:** The HookPress plugin requires URL parameters to - be delimited by semicolons instead of ampersands. If you have a - self-hosted blog, replace every `&` with `;` in the URL above. +1. Add `/wp-admin/options-general.php?page=webhooks` to the end of your + WordPress URL, and navigate to the site. Click **Add webhook**. -1. Go to - `https://YOUR-WORDPRESS-BLOG/wp-admin/options-general.php?page=webhooks`, - after replacing `YOUR-WORDPRESS-BLOG` appropriately. Click **Add webhook**. +1. Select an **Action** from the [supported + events](#filtering-incoming-events) that you'd like to be notified + about, along with these corresponding **Fields**: `post_title`, + `post_type`, and `post_url`. -1. Select the **Action** that you'd like to be notified about, along with - the corresponding **Fields**. The list of currently supported actions is: +1. Set **URL** to the URL generated above, and click **Add new webhook**. - * **publish_post**: Use fields *post_title*, *post_type*, and *post_url* - * **publish_page**: Use fields *post_title*, *post_type*, and *post_url* - * **user_register**: Use fields *display_name* and *user_email* (available on self-hosted blogs only) - * **wp_login**: Use field *user_login* (available on self-hosted blogs only) - -1. Set **URL** to the URL constructed above, and click **Add new webhook**. +{end_tabs} {!congrats.md!} ![](/static/images/integrations/wordpress/wordpress_post_created.png) + +{!event-filtering-additional-feature.md!} + +### Related documentation + +- [WordPress webhooks documentation][1] + +{!webhooks-url-specification.md!} + +[1]: https://wordpress.com/support/webhooks/