You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/explanation/get-vs-post/index.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -52,3 +52,7 @@ curl -X POST \
52
52
53
53
# Summary
54
54
While both methods have their uses, POST requests are generally recommended for WPGraphQL due to their flexibility, security advantages, and ability to handle complex queries. However, GET requests can be useful for simple, cacheable queries and is useful when paired with caching mechanisms like the Smart Cache plugin. Consider your specific use case, security requirements, and caching needs when choosing between the two methods.
55
+
56
+
## Contributing
57
+
58
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
This code would change the default `/graphql` endpoint to `/my_endpoint`.
44
44
45
-
Alternatively, you can configure the endpoint directly in the **WPGraphQL Settings** under **GraphQL Endpoint**, without needing to modify your code.
45
+
Alternatively, you can configure the endpoint directly in the **WPGraphQL Settings** under **GraphQL Endpoint**, without needing to modify your code.
46
+
47
+
## Contributing
48
+
49
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: docs/explanation/headless-authentication/index.md
+5-1Lines changed: 5 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -104,4 +104,8 @@ To tie everything together, we will provide:
104
104
Our approach to authentication in headless WordPress emphasizes **modularity**, **security**, and developer **experience**. To support these principles, we will provide **ready-to-use code snippets** and **example boilerplate code** that you can easily integrate into your application.
105
105
106
106
## Example use case
107
-
For example, if you're building a headless WordPress application with a React frontend, you can use our code snippets to implement Credentials authentication. You can integrate our boilerplate code for handling access tokens securely, including token storage and refresh logic, without needing to install additional dependencies.
107
+
For example, if you're building a headless WordPress application with a React frontend, you can use our code snippets to implement Credentials authentication. You can integrate our boilerplate code for handling access tokens securely, including token storage and refresh logic, without needing to install additional dependencies.
108
+
109
+
## Contributing
110
+
111
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: docs/explanation/rendering-options/index.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -141,3 +141,7 @@ Considerations
141
141
* Styling Parity: Achieving perfect styling parity can be challenging due to the dynamic nature of WordPress styles.
142
142
143
143
* Maintenance: Styles may change with theme updates, customizations or major WordPress updates, requiring periodic updates in your headless application.
144
+
145
+
## Contributing
146
+
147
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: docs/explanation/routing/index.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -469,3 +469,7 @@ In traditional WordPress, custom post types (CPTs) are registered using `registe
469
469
470
470
- `/portfolio/` → Archive page for portfolio items
471
471
- `/portfolio/project-name/` → Single portfolio item
472
+
473
+
## Contributing
474
+
475
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
* Most complex implementation of the three approaches.
262
262
* Requires handling multiple sitemap files
263
263
* May have performance implications if not properly cached
264
+
265
+
## Contributing
266
+
267
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: docs/how-to/nextjs-pages-router/enable-apq/index.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -125,3 +125,7 @@ const client = new ApolloClient({
125
125
On the Network tab you should see your query being sent as a GET request.
126
126
127
127

128
+
129
+
## Contributing
130
+
131
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: docs/index.md
+9-8Lines changed: 9 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,9 +3,6 @@ title: "Introduction"
3
3
description: "Introduction to the Headless WordPress Toolkit, a modern, framework-agnostic collection of plugins and packages for building headless WordPress applications."
4
4
---
5
5
6
-
7
-
# Introduction
8
-
9
6
## What is the Headless WordPress Toolkit?
10
7
11
8
The Headless WordPress Toolkit is a modern, framework-agnostic toolkit for building headless WordPress applications. It provides a collection of plugins, packages, and examples to help developers make WordPress a better headless CMS.
@@ -18,18 +15,18 @@ The toolkit includes several WordPress plugins to enhance the headless experienc
18
15
19
16
| Plugin | Description |
20
17
|--------|-------------|
21
-
|[`hwp-previews`](../plugins/hwp-previews/)| Headless Previews solution for WordPress: fully configurable preview URLs via the settings page which is framework agnostic. |
22
-
|[`wpgraphql-webhooks`](../plugins/wpgraphql-webhooks/)| Extends WPGraphQL to support webhook subscriptions and dispatching for headless WordPress environments. |
23
-
|[`wpgraphql-logging`](../plugins/wpgraphql-logging/)| Logging for WPGraphQL requests with granular lifecycle events and Monolog integration. |
24
-
|[`wpgraphql-debug-extensions`](../plugins/wpgraphql-debug-extensions/)| Advanced debugging, performance analysis, and metric collection for WPGraphQL. |
18
+
|[hwp-previews](../plugins/hwp-previews/)| Headless Previews solution for WordPress: fully configurable preview URLs via the settings page which is framework agnostic. |
19
+
|[wpgraphql-webhooks](../plugins/wpgraphql-webhooks/)| Extends WPGraphQL to support webhook subscriptions and dispatching for headless WordPress environments. |
20
+
|[wpgraphql-logging](../plugins/wpgraphql-logging/)| Logging for WPGraphQL requests with granular lifecycle events and Monolog integration. |
21
+
|[wpgraphql-debug-extensions](../plugins/wpgraphql-debug-extensions/)| Advanced debugging, performance analysis, and metric collection for WPGraphQL. |
25
22
26
23
You can find more information about installation in the [plugins documentation](../plugins/README.md).
27
24
28
25
## Packages
29
26
30
27
We provide NPM packages that can be used in your frontend applications. All packages use vanilla ES Modules with no build step.
31
28
32
-
-[`@wpengine/hwp-toolbar`](../packages/toolbar/) — in active development (not yet published)
29
+
-[@wpengine/hwp-toolbar](../packages/toolbar/) — in active development (not yet published)
33
30
34
31
> [!NOTE]
35
32
> No packages are published to npm yet. These are pre-release and subject to change.
@@ -41,3 +38,7 @@ This project contains a wide variety of examples demonstrating how to use the He
41
38
Most examples include a `wp-env` setup, allowing you to fully configure a headless application with a single command.
42
39
43
40
For a full list of examples and how to run them, please see the [examples documentation](../examples/README.md).
41
+
42
+
## Contributing
43
+
44
+
If you feel like something is missing or you want to add documentation, we encourage you to contribute! Please check out our [Contributing Guide](https://github.com/wpengine/hwptoolkit/blob/main/CONTRIBUTING.md) for more details.
Copy file name to clipboardExpand all lines: plugins/README.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,10 +6,10 @@ WordPress plugins for the Headless WordPress Toolkit. Each plugin is paired with
6
6
7
7
| Plugin | Description |
8
8
|--------|-------------|
9
-
|[`hwp-previews`](./hwp-previews/README.md)| Headless Previews solution for WordPress: fully configurable preview URLs via the settings page which is framework agnostic. |
10
-
|[`wpgraphql-webhooks`](./wpgraphql-webhooks/README.md)| Extends WPGraphQL to support webhook subscriptions and dispatching for headless WordPress environments. |
11
-
|[`wpgraphql-logging`](./wpgraphql-logging/README.md)| Logging for WPGraphQL requests with granular lifecycle events and Monolog integration. |
12
-
|[`wpgraphql-debug-extensions`](./wpgraphql-debug-extensions/README.md)| Advanced debugging, performance analysis, and metric collection for WPGraphQL. |
9
+
|[hwp-previews](./hwp-previews/README.md)| Headless Previews solution for WordPress: fully configurable preview URLs via the settings page which is framework agnostic. |
10
+
|[wpgraphql-webhooks](./wpgraphql-webhooks/README.md)| Extends WPGraphQL to support webhook subscriptions and dispatching for headless WordPress environments. |
11
+
|[wpgraphql-logging](./wpgraphql-logging/README.md)| Logging for WPGraphQL requests with granular lifecycle events and Monolog integration. |
12
+
|[wpgraphql-debug-extensions](./wpgraphql-debug-extensions/README.md)| Advanced debugging, performance analysis, and metric collection for WPGraphQL. |
0 commit comments