forked from wp-graphql/wp-graphql-smart-cache
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
209 lines (125 loc) · 8.63 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
=== WPGraphQL Smart Cache ===
Contributors: WPGraphQL, markkelnar, jasonbahl
Tags: WPGraphQL, Cache, API, Invalidation, Persisted Queries, GraphQL, Performance, Speed
Requires at least: 5.6
Tested up to: 6.1
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
=== Description ===
Do you want your API data _fast_ or _accurate_? With WPGraphQL Smart Cache, you can have both.
WPGraphQL Smart Cache is a free, open-source WordPress plugin that provides support for caching and cache invalidation of WPGraphQL Queries.
To get the most out of this plugin, we recommend using GET requests with Network Caching, which requires your WordPress install to be on a [supported host](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/network-cache.md#supported-hosts).
*BREAKING CHANGES:* We may make breaking changes in the future to improve functionality and experience. If we do, we will use semver to do so. Pay attention to release notes and upgrade notices before updating.
== Video Overview ==
<a href="https://youtu.be/t_y6q02q7K4" target="_blank"><img src="https://github.com/wp-graphql/wp-graphql-smart-cache/raw/main/docs/images/banner-wp-graphql-smart-cache-v1.jpg" width="640px" /></a>
== Docs ==
- [Overview](https://github.com/wp-graphql/wp-graphql-smart-cache#overview)
- [Quick Start](https://github.com/wp-graphql/wp-graphql-smart-cache#-quick-start)
- Features
- [Network Cache](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/network-cache.md)
- [Object Cache](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/object-cache.md)
- [Persisted Queries](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/persisted-queries.md)
- [Cache Invalidation](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/cache-invalidation.md)
- [Extending / Customizing Functionality](https://github.com/wp-graphql/wp-graphql-smart-cache/blob/main/docs/extending.md)
- [FAQ and Troubleshooting](https://github.com/wp-graphql/wp-graphql-smart-cache#faq--troubleshooting)
- [Known Issues](https://github.com/wp-graphql/wp-graphql-smart-cache#known-issues)
- [Providing Feedback](https://github.com/wp-graphql/wp-graphql-smart-cache#providing-feedback)
= Upgrading =
It is recommended that anytime you want to update WPGraphQL Smart Cache that you get familiar with what's changed in the release.
WPGraphQL Smart Cache publishes [release notes on GitHub](https://github.com/wp-graphql/wp-graphql-smart-cache/releases).
WPGraphQL Smart Cache will follow Semver versioning.
The summary of Semver versioning is as follows:
- *MAJOR* version when you make incompatible API changes,
- *MINOR* version when you add functionality in a backwards compatible manner, and
- *PATCH* version when you make backwards compatible bug fixes.
You can read more about the details of Semver at [semver.org](https://semver.org)
== Privacy Policy ==
WPGraphQL Smart Cache uses [Appsero](https://appsero.com) SDK to collect some telemetry data upon user's confirmation. This helps us to troubleshoot problems faster & make product improvements.
Appsero SDK **does not gather any data by default.** The SDK only starts gathering basic telemetry data **when a user allows it via the admin notice**. We collect the data to ensure a great user experience for all our users.
Integrating Appsero SDK **DOES NOT IMMEDIATELY** start gathering data, **without confirmation from users in any case.**
Learn more about how [Appsero collects and uses this data](https://appsero.com/privacy-policy/).
== Upgrade Notice ==
= 0.2.0 =
This release removes a lot of code that has since been released as part of WPGraphQL core.
In order to use v0.2.0+ of WPGraphQL Smart Cache, you will need WPGraphQL v1.12.0 or newer.
== Changelog ==
= 1.1.1 =
**Chores / Bugfixes**
- [#221](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/221) fix: updating menus not assigned to locations doesn't purge menus, even if their model is public
= 1.1.0 =
**New Features**
- [#215](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/215) feat: graphql_purge_logs
**Chores / Bugfixes**
- [#214](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/214) fix: over-purging tags
= 1.0.4 =
- [#210](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/210) fix: post_exists being called even though the `post_exists` function doesn't exist in this context. Check instanceof WP_Post instead.
= 1.0.3 =
- [#207](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/207) fix: ignore updates to "apple_news_update" meta key. Add `graphql_cache_ignored_meta_keys` filter for modifying the list of ignored meta keys.
- [#205](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/205) fix: ErrorException Warning: Attempt to read property "post_type" on null. Thanks @izzygld!
= 1.0.2 =
**Chores / Bugfixes**
- [#202](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/202) fix: ErrorException Warning: Attempt to read property "post_type" on null. Thanks @izzygld!
= 1.0.1 =
**Chores / Bugfixes**
- Add workflow to update plugin assets/readme when those files are changed
- update links to docs. Thanks @rodrigo-arias!
- set internal taxonomies to public => false, add tests.
- fix bug with the "purge cache" button in the settings page not properly purging all caches for WPEngine users
= 1.0 =
- Version change. no functional changes.
= 0.3.9 =
- fix: vendor directory not properly deploying to WordPress.org.
= 0.3.8 =
- fix: rename constant that didn't get updated in 0.3.4. Thanks @colis!
= 0.3.7 =
- chore: update readme.txt file which is displayed on WordPress.org
= 0.3.6 =
- fix: correct slug in deploy workflow
= 0.3.5 =
- ([#189](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/189)): chore: add workflow to deploy to the WordPress.org repo
= 0.3.4 =
- ([#188](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/188)): fix: update constant name for min required version of WPGraphQL. Conflict with constant name defined in WPGraphQL for ACF.
= 0.3.3 =
- ([#184](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/184)): fix: update min required version of WPGraphQL. This plugin relies on features introduced in v1.12.0 of WPGraphQL.
= 0.3.2 =
**New Features**
- ([#178](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/178)): feat: add new "graphql_cache_is_object_cache_enabled" filter
**Chores/Bugfixes**
- ([#179](https://github.com/wp-graphql/wp-graphql-smart-cache/pull/179)): fix: prevent error when users install the plugin with Composer
= 0.3.1 =
- chore: update readme.txt with tags, updated "tested up to" version
- chore: update testing matrix to run tests on more versions of WordPress and PHP
- chore: update docs
- chore: add icons and banner for WordPress.org
= 0.3.0 =
- feat: a LOT of updates to the documentation
- feat: add opt-in telemetry via Appsero.
= 0.2.3 =
- fix: fixes a bug where X-GraphQL-Keys weren't being returned properly when querying a persisted query by queryId
= 0.2.2 =
- fix bug with patch. Missing namespace
= 0.2.1 =
- add temporary patch for wp-engine users. Will be removed when the wp engine mu plugin is updated.
= 0.2.0
- chore: remove unreferenced .zip build artifact
- feat: remove a lot of logic from Collection.php that analyzes queries to generate cache keys and response headers, as this has been moved to core WPGraphQL
- feat: reference core WPGraphQL functions for storing cache maps for object caching
- chore: remove unused "use" statements in Invalidation.php
- feat: introduce new "graphql_purge" action, which can be hooked into by caching clients to purge caches by key
- chore: remove $collection->node_key() method and references to it.
- feat: add "purge("skipped:$type_name)" event when purge_nodes is called
- chore: remove model class prefixes from purge_nodes() calls
- chore: rename const WPGRAPHQL_LABS_PLUGIN_DIR to WPGRAPHQL_SMART_CACHE_PLUGIN_DIR
- chore: update tests to remove "node:" prefix from expected keys
- chore: update tests to use self::factory() instead of $this->tester->factory()
- chore: update Plugin docblock
- feat: add logic to ensure minimum version of WPGraphQL is active before executing functionality needed by it
- chore: remove filters that add model definitions to Types as that's been moved to WPGraphQL core
= 0.1.2 =
- Updates to support batch queries
- move save urls out of this plugin into the wpengine cache plugin
- updates to tests
= 0.1.1 =
- Initial release to beta users