integration-docs: Update WordPress for new doc format.

Part of zulip#29592.

Co-authored-by: Lauryn Menard <lauryn@zulip.com>
This commit is contained in:
Niloth P 2024-07-08 00:49:55 +05:30 committed by Tim Abbott
parent 3e100d872a
commit c271cdb113
1 changed files with 22 additions and 18 deletions

View File

@ -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/