manifest / integrations / wordpress-plugin-gatsby
Whitespace Gatsby integration
Adds preview and other integrations with Gatsby
by Whitespace · github.com/whitespace-se/wordpress-plugin-gatsby · website
★ 0stars
4.1kcomposer installs
0forks
Install
No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:
wp plugin install https://github.com/whitespace-se/wordpress-plugin-gatsby/archive/refs/heads/main.zipAlso on Packagist as whitespace-se/wordpress-plugin-gatsby:
composer require whitespace-se/wordpress-plugin-gatsbyFrom the readme
Whitespace Gatsby integration for Wordpress
Wordpress plugin that adds preview and other integrations with Gatsby.
How to install
If you want to use this plugin as an MU-plugin, first add this to your
composer.json:
Where path/to/your/mu-plugins is something like wp-content/mu-plugins or
web/app/mu-plugins.
Then get the plugin via composer:
Configuration
Preview
Define the GATSBYPREVIEWENDPOINT constant in you config (e.g. in
wp-config.php) to set up the preview, for example:
This url will be appended with a query string containing these parameters:
- id – The GraphQL ID for the post
- user = The encrypted ID of the user that is previewing the post
- wpnonce = A wprest nonce
- contentType = The content type of the post (deprecated)
You should use GraphQL to request data for the preview and that request must
contain the x-wp-user and x-wp-nonce headers, containing the values received
in the query string.
The GraphQL query may look like this, where $id is the GraphQL ID for the post
received in the query string:
Refresh on save
Define the GATSBYREFRESHENDPOINTS constant in you config (e.g. in
wp-config.php) if you need to trigger a Gatsby refresh when posts are updated.