cloudflare/Cloudflare-WordPress
Publicmirrored fromhttps://github.com/cloudflare/Cloudflare-WordPress
readme.txt
288lines · modecode
5 years ago
| 1 | === Cloudflare === |
| 2 | Contributors: icyapril, manatarms, thillcf, deuill, epatryk |
| 3 | Tags: cloudflare, seo, ssl, ddos, speed, security, cdn, performance, free |
| 4 | Requires at least: 3.4 |
| 5 | Tested up to: 5.2.2 |
| 6 | Stable tag: 3.5.0 |
| 7 | License: BSD-3-Clause |
| 8 | |
| 9 | All of Cloudflare’s performance and security benefits in a simple one-click install of recommended settings specifically developed for WordPress. |
| 10 | |
| 11 | == Description == |
| 12 | |
| 13 | = What this plugin can do for you = |
| 14 | |
| 15 | **One-click WordPress-optimized settings** |
| 16 | |
| 17 | The easiest way to setup Cloudflare for your WordPress site. |
| 18 | |
| 19 | **Web application firewall (WAF) rulesets** |
| 20 | |
| 21 | Available on all of Cloudflare’s paid plans, the WAF has built-in rulesets, including rules that mitigate WordPress specific threats and vulnerabilities. These security rules are always kept up-to-date, once the WAF is enabled, you can rest easy knowing your site is protected from even the latest threats. |
| 22 | |
| 23 | **Automatic cache purge on website updates** |
| 24 | |
| 25 | Occurs when you change the appearance of your website. This means that you can focus on your website, while we ensure that the latest content is always available to your visitors. |
| 26 | |
| 27 | **Automatic individual URL cache purge on page/post/custom post type edits** |
| 28 | |
| 29 | Cloudflare’s plugin for WordPress automatically refreshes the Cloudflare cache of each post/page/custom post type when you update the content. |
| 30 | |
| 31 | = Additional features = |
| 32 | |
| 33 | * Header rewrite to prevent a redirect loop when Cloudflare’s Universal SSL is enabled |
| 34 | |
| 35 | * Change Cloudflare settings from within the plugin itself without needing to navigate to the cloudflare.com dashboard. You can change settings for cache purge, security level, Always Online, and image optimization |
| 36 | |
| 37 | * View analytics such as total visitors, bandwidth saved, and threats blocked |
| 38 | |
| 39 | * Support for [HTTP2/Server Push](https://blog.cloudflare.com/announcing-support-for-http-2-server-push-2/) |
| 40 | |
| 41 | == Installation == |
| 42 | |
| 43 | = Prerequisite = |
| 44 | Make sure your PHP version is 5.3.10 or higher. |
| 45 | |
| 46 | = From your WordPress Dashboard = |
| 47 | |
| 48 | 1. Visit “Plugins” → Add New |
| 49 | 2. Search for Cloudflare |
| 50 | 3. Activate Cloudflare from your Plugins page. |
| 51 | |
| 52 | = From WordPress.org = |
| 53 | |
| 54 | 1. Download Cloudflare |
| 55 | 2. Upload the “cloudflare” directory to your “/wp-content/plugins/” directory, using ftp, sftp, scp etc. |
| 56 | 3. Activate Cloudflare from your Plugins page. |
| 57 | |
| 58 | = Once Activated = |
| 59 | |
| 60 | 1. Go to cloudflare.com |
| 61 | 2. Login with your cloudflare account. (If you don’t have a Cloudflare account first sign up for Cloudflare) |
| 62 | 3. Press your account name on top right corner and select “My Settings” |
| 63 | 4. Scroll down to “API Key” → “Global API Key” → View API Key |
| 64 | 5. Copy the API key |
| 65 | 6. Return back to WordPress Cloudflare Plugin page |
| 66 | 7. Enter your email address and paste your API key |
| 67 | 8. Press Login. |
| 68 | |
| 69 | == Frequently Asked Questions == |
| 70 | |
| 71 | = Do I need a Cloudflare account to use the plugin? = |
| 72 | |
| 73 | Yes, on install and activation the plugin, first time users will be asked to enter their email address (used to sign-up for an account at cloudflare.com) and their user API key. This is needed to support all the features offered by the plugin. |
| 74 | |
| 75 | = What settings are applied when I click "Apply Default Settings" in Cloudflare's WordPress plugin? = |
| 76 | |
| 77 | You can review the recommended settings that are applied [here](https://support.cloudflare.com/hc/en-us/articles/227342487). |
| 78 | |
| 79 | = Does the plugin work if I have Varnish enabled? = |
| 80 | |
| 81 | Yes, Cloudflare works with, and helps speed up your site even more, if you have Varnish enabled. |
| 82 | |
| 83 | == Screenshots == |
| 84 | |
| 85 | 1. Cloudflare Plugin |
| 86 | |
| 87 | == Changelog == |
| 88 | |
| 89 | = 3.5.0 - 2020-06-26 = |
| 90 | |
| 91 | *Fixed* |
| 92 | |
| 93 | * Disable HTTP/2 Push on wp-admin pages [#214](https://github.com/cloudflare/Cloudflare-WordPress/pull/214) |
| 94 | * Fix PHP 7.4 notice [#256](https://github.com/cloudflare/Cloudflare-WordPress/pull/256) |
| 95 | |
| 96 | *Added* |
| 97 | |
| 98 | * Purge attachment URLs [#208](https://github.com/cloudflare/Cloudflare-WordPress/pull/208) |
| 99 | * Purge URLs on page/post update [#206](https://github.com/cloudflare/Cloudflare-WordPress/pull/206) |
| 100 | * Turn on IPv6 by default [#229](https://github.com/cloudflare/Cloudflare-WordPress/pull/229) |
| 101 | * Add constants for better control HTTP/2 Server Push [#213](https://github.com/cloudflare/Cloudflare-WordPress/pull/213) |
| 102 | * Allow custom actions for purge url and purge everything actions [#212](https://github.com/cloudflare/Cloudflare-WordPress/pull/212) |
| 103 | |
| 104 | = 3.4.1 - 2019-08-29 = |
| 105 | |
| 106 | *Fixed* |
| 107 | |
| 108 | * Updated list of contributors. |
| 109 | * Updated tested Wordpress version to latest (5.2.2). |
| 110 | |
| 111 | = 3.4.0 - 2019-08-29 = |
| 112 | |
| 113 | *Added* |
| 114 | |
| 115 | * Added support for API Token authentication. |
| 116 | |
| 117 | = 3.3.2 - 2017-12-12 = |
| 118 | |
| 119 | *Fixed* |
| 120 | |
| 121 | * Bug in cf-ip-rewrite |
| 122 | |
| 123 | *Added* |
| 124 | |
| 125 | * Added a new filter cloudflare_purge_by_url allowing users to have better control on automatically purged urls. |
| 126 | |
| 127 | = 3.3.1 - 2017-6-29 = |
| 128 | |
| 129 | *Fixed* |
| 130 | |
| 131 | * Potential bug by using $_GET. |
| 132 | |
| 133 | = 3.3.0 - 2017-6-29 = |
| 134 | |
| 135 | *Added* |
| 136 | |
| 137 | * Added a new Splash Screen |
| 138 | * Added userConfig.js file allowing custom configurations. |
| 139 | * Added logs in debug mode for Automatic Cache Purge. |
| 140 | * Added logs for oversized Server Push HTTP headers. |
| 141 | |
| 142 | *Changed* |
| 143 | |
| 144 | * Automatic Cache Purge now purges Autoptimize by everything rather than by URL. |
| 145 | * Updated IP Ranges |
| 146 | |
| 147 | *Fixed* |
| 148 | |
| 149 | * Bug where domains which had capital letters not working. |
| 150 | * Bug where Automatic Cache Purge couldn't purge front page. |
| 151 | * Bug related to work with IWP. |
| 152 | * Bug where if PHP is compiled with ipv6-disable flag, it crashed the site. |
| 153 | |
| 154 | = 3.2.1 - 2017-3-14 = |
| 155 | |
| 156 | *Fixed* |
| 157 | |
| 158 | * Bug where accounts which had more than 20 zones would not show up correctly. |
| 159 | |
| 160 | = 3.2.0 - 2017-3-1 = |
| 161 | |
| 162 | *Added* |
| 163 | |
| 164 | * Bypass Cache By Cookie functionality. |
| 165 | * HTTP/2 Server Push functionality (disabled by default). |
| 166 | |
| 167 | *Changed* |
| 168 | |
| 169 | * Lowered the plugin size. |
| 170 | * Automatic Cache Management feature includes purging taxonomies. |
| 171 | * Automatic Cache Management feature supports sites which use both HTTP and HTTPS. |
| 172 | |
| 173 | *Fixed* |
| 174 | |
| 175 | * Admin bar disappearing from the plugin. |
| 176 | * Bug where spinner was loading forever. |
| 177 | * Bug where the backend errors where not being shown in the frontend. |
| 178 | * Issues where IE11 was not working properly. |
| 179 | |
| 180 | = 3.1.1 - 2016-11-17 = |
| 181 | |
| 182 | *Changed* |
| 183 | |
| 184 | * Moved Admin Bar behind Automatic Cache Purge toggle. |
| 185 | |
| 186 | = 3.1.0 - 2016-11-17 = |
| 187 | |
| 188 | *Added* |
| 189 | |
| 190 | * Added ability to automatically purge cache when a post is published, edited or deleted. (Thanks to brandomeniconi and mike503) |
| 191 | * Added ability to work with WordPress MU Domain Mapping plugin. (Thanks to brandomeniconi) |
| 192 | |
| 193 | *Changed* |
| 194 | |
| 195 | * Changed the UI to look more like cloudflare.com dashboard. |
| 196 | * Changed plugin description. |
| 197 | * Disabled showing WordPress Admin Bar and Edit Post Link to avoid caching problems for users using HTML Caching. |
| 198 | |
| 199 | *Fixed* |
| 200 | |
| 201 | * Fixed bug where require vendor folders was not working. |
| 202 | * Fixed bug where static files were cached which caused issues updating the plugin. |
| 203 | * Fixed dependencies which caused issues with PHP Compatibility Checker plugin. |
| 204 | |
| 205 | = 3.0.6 - 2016-10-6 = |
| 206 | |
| 207 | *Added* |
| 208 | |
| 209 | * Added ability to toggle Development Mode. |
| 210 | |
| 211 | *Fixed* |
| 212 | |
| 213 | * Fixed bug where active zone dropdown was not working properly. |
| 214 | |
| 215 | *Changed* |
| 216 | |
| 217 | * Compressed resources to lower plugin size. |
| 218 | * Updated Cloudflare logo. |
| 219 | |
| 220 | = 3.0.5 - 2016-09-28 = |
| 221 | |
| 222 | *Fixed* |
| 223 | |
| 224 | * Fixed bug where refactored Flexible SSL fix was causing the settings page hook not to load. |
| 225 | |
| 226 | = 3.0.4 - 2016-09-27 = |
| 227 | |
| 228 | *Added* |
| 229 | |
| 230 | * Ability for users to toggle Automatic HTTPS Rewrites (enabled by default, solves for most mixed content errors). |
| 231 | |
| 232 | *Fixed* |
| 233 | |
| 234 | * Fixed an issue where low PHP version where getting syntax error. |
| 235 | * Fixed issue where some users using Flexible SSL where not able to login to wp-admin . |
| 236 | * Fixed a bug where the active zone selector was not paginating through the whole zone list. |
| 237 | * Fixed an issue where the setting for Image Optimization was being displayed incorrectly. |
| 238 | * Fixed a bug in Analytics where the Uniques Visitors data was not displaying accurately. |
| 239 | |
| 240 | *Changed* |
| 241 | |
| 242 | * Compressed assets to lower plugin size. |
| 243 | * Hooks loading logic refactored to make it more simple and readable. |
| 244 | |
| 245 | = 3.0.3 - 2016-09-21 = |
| 246 | |
| 247 | *Fixed* |
| 248 | |
| 249 | * Fixed an issue where some domains were being incorrectly propagated to the domain selector dropdown |
| 250 | * Fixed an issue where the Web Application Firewall was accidentally triggering RFI Attack Rules |
| 251 | * Fixed an issue where image optimization was not being enabled for Pro and higher Cloudflare plans |
| 252 | |
| 253 | = 3.0.2 - 2016-09-16 = |
| 254 | |
| 255 | *Fixed* |
| 256 | |
| 257 | * Disabled HTTP/2 Server Push which was leading to 520 and 502 errors for some websites. |
| 258 | |
| 259 | = 3.0.1 - 2016-09-16 = |
| 260 | |
| 261 | *Fixed* |
| 262 | |
| 263 | * Fixed HTTP/2 Server Push exceeding the header limit Cloudflare has which caused 520 errors. |
| 264 | * Fixed warning message in HTTP/2 Server Push. |
| 265 | |
| 266 | = 3.0.0 - 2016-09-15 = |
| 267 | |
| 268 | *Added* |
| 269 | |
| 270 | * Added one-click application oft WordPress specific recommended settings |
| 271 | * Added ability to purge the Cloudflare cache |
| 272 | * Integrated with WordPress cache management to automatically clear the Cloudflare cache on updating site appearance |
| 273 | * Added ability to change Cloudflare settings (Always Online mode, I’m Under Attack, Image Optimization, Security Level, Web Application Firewall) |
| 274 | * Added Analytics showing Cached Requests, bandwidth used, unique visitors, threats blocked |
| 275 | * Added Header rewrite to prevent a redirect loop when Cloudflare’s Universal SSL is enabled |
| 276 | * Added HTTP/2 Server Push support |
| 277 | * Added Support for PHP 5.3+ |
| 278 | |
| 279 | *Removed* |
| 280 | |
| 281 | * Removed HTTPS Protocol Rewriting |
| 282 | * Removed submission of spam comments |
| 283 | * Removed ability to toggle Development Mode On/Off |
| 284 | |
| 285 | *Changed* |
| 286 | |
| 287 | * Updated user interface |
| 288 | * Started to support WordPress 3.4+ instead of 2.8+ because we depend on the [WordPress Options API](https://codex.wordpress.org/Options_API) |