zulip/zerver/webhooks/wordpress/doc.md

Get WordPress notifications in Zulip!

If you're hosting your WordPress blog yourself (i.e., not on WordPress.com), first install the HookPress plugin (experimental).

1. {!create-stream.md!}

2. {!create-an-incoming-webhook.md!}

3. {!generate-integration-url.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.

4. Go to https://YOUR-WORDPRESS-BLOG/wp-admin/options-general.php?page=webhooks, after replacing YOUR-WORDPRESS-BLOG appropriately. Click Add webhook.

5. Select the Action that you'd like to be notified about, along with the corresponding Fields. The list of currently supported actions is:

   • 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)

6. Set URL to the URL constructed above, and click Add new webhook.

{!congrats.md!}