=== CloudFlare === Contributors: littlebizzy Donate link: https://www.patreon.com/littlebizzy Tags: cloudflare, api, cache, cdn, dev mode Requires at least: 4.4 Tested up to: 4.9 Requires PHP: 7.2 Multisite support: No Stable tag: 1.3.2 License: GPLv3 License URI: http://www.gnu.org/licenses/gpl-3.0.html Prefix: CLDFLR Easily connect your WordPress website to free optimization features from CloudFlare, including one-click options to purge cache and enable dev mode. == Description == Easily connect your WordPress website to free optimization features from CloudFlare, including one-click options to purge cache and enable dev mode. * [**Join our FREE Facebook group for support!**](https://www.facebook.com/groups/littlebizzy/) * [**Worth a 5-star review? Thank you!**](https://wordpress.org/support/plugin/cf-littlebizzy/reviews/?rate=5#new-post) * [Plugin Homepage](https://www.littlebizzy.com/plugins/cloudflare) * [Plugin GitHub](https://github.com/littlebizzy/cloudflare) *Our related OSS projects:* * [SlickStack (LEMP stack automation)](https://slickstack.io) * [WP Lite boilerplate](https://wplite.org) * [Starter Theme](https://starter.littlebizzy.com) #### The Long Version #### This plugin was designed to load faster, be more secure, and perform much better than the official CloudFlare plugin. We focus on offering only the key features desired by most developers, while allowing some of the other CloudFlare settings to be better managed at your account over at CloudFlare.com rather than turning WordPress into a bloated control panel with every setting possible which is nearly impossible to keep up with anyways (esp. with stable/secure code). If you wish to define the CloudFlare API key and API email address on your `wp-config.php` or `functions.php` file you can do that to avoid your clients removing that data, especially during staging site syncing, migrations, etc. Plus it will load the data faster via PHP Opcache and server/Linux RAM memory caching rather than needing database queries or Options API cache. You can also use those defined constants to better automate server/WordPress setup using bash scripts etc. Features: * `define('CLOUDFLARE_API_KEY', '123456789');` * `define('CLOUDFLARE_API_EMAIL', 'user@example.com');` * one-click "dev" mode * one-click purge CloudFlare cache * automatic CloudFlare domain detection * real visitor IP address sent to server/WordPress * much lighter/faster code than "official" CloudFlare plugin * uses CloudFlare API version 4.0+ * no integration with Akismet #### Defined Constants #### * `define('DISABLE_NAG_NOTICES', true);` * `define('CLOUDFLARE_API_KEY', '123456789');` * `define('CLOUDFLARE_API_EMAIL', 'user@example.com');` #### Compatibility #### This plugin has been designed for use on LEMP (Nginx) web servers with PHP 7.0 and MySQL 5.7 to achieve best performance. All of our plugins are meant for single site WordPress installations only; for both performance and security reasons, we highly recommend against using WordPress Multisite for the vast majority of projects. #### Plugin Features #### * Settings Page: Yes * Premium Version Available: Yes ([Speed Demon](https://www.littlebizzy.com/plugins/speed-demon)) * Includes Media (Images, Icons, Etc): No * Includes CSS: No * Database Storage: Yes * Transients: No * Options: Yes * Creates New Tables: No * Database Queries: Backend Only (Options API) * Must-Use Support: Yes (Use With [Autoloader](https://github.com/littlebizzy/autoloader)) * Multisite Support: No * Uninstalls Data: Yes #### WP Admin Notices #### This plugin generates multiple [Admin Notices](https://codex.wordpress.org/Plugin_API/Action_Reference/admin_notices) in the WP Admin dashboard. The first is a notice that fires during plugin activation which recommends several related free plugins that we believe will enhance this plugin's features; this notice will re-appear approximately once every 6 months as our code and recommendations evolve. The second is a notice that fires a few days after plugin activation which asks for a 5-star rating of this plugin on its WordPress.org profile page. This notice will re-appear approximately once every 9 months. These notices can be dismissed by clicking the **(x)** symbol in the upper right of the notice box. These notices may annoy or confuse certain users, but are appreciated by the majority of our userbase, who understand that these notices support our free contributions to the WordPress community while providing valuable (free) recommendations for optimizing their website. If you feel that these notices are too annoying, than we encourage you to consider one or more of our upcoming premium plugins that combine several free plugin features into a single control panel, or even consider developing your own plugins for WordPress, if supporting free plugin authors is too frustrating for you. A final alternative would be to place the defined constant mentioned below inside of your `wp-config.php` file to manually hide this plugin's nag notices: define('DISABLE_NAG_NOTICES', true); Note: This defined constant will only affect the notices mentioned above, and will not affect any other notices generated by this plugin or other plugins, such as one-time notices that communicate with admin-level users. #### Inspiration #### * [CloudFlare](https://wordpress.org/plugins/cloudflare/) #### Special Thanks #### [Alex Georgiou](https://www.alexgeorgiou.gr), [Automattic](https://automattic.com), [Brad Touesnard](https://bradt.ca), [Daniel Auener](http://www.danielauener.com), [Delicious Brains](https://deliciousbrains.com), [Greg Rickaby](https://gregrickaby.com), [Matt Mullenweg](https://ma.tt), [Mika Epstein](https://halfelf.org), [Mike Garrett](https://mikengarrett.com), [Samuel Wood](http://ottopress.com), [Scott Reilly](http://coffee2code.com), [Jan Dembowski](https://profiles.wordpress.org/jdembowski), [Jeff Starr](https://perishablepress.com), [Jeff Chandler](https://jeffc.me), [Jeff Matson](https://jeffmatson.net), [Jeremy Wagner](https://jeremywagner.me), [John James Jacoby](https://jjj.blog), [Leland Fiegel](https://leland.me), [Luke Cavanagh](https://github.com/lukecav), [Paul Irish](https://www.paulirish.com), [Rahul Bansal](https://profiles.wordpress.org/rahul286), [Roots](https://roots.io), [rtCamp](https://rtcamp.com), [Ryan Hellyer](https://geek.hellyer.kiwi), [WP Chat](https://wpchat.com), [WP Tavern](https://wptavern.com) #### Disclaimer #### We released this plugin in response to our managed hosting clients asking for better access to their server, and our primary goal will remain supporting that purpose. Although we are 100% open to fielding requests from the WordPress community, we kindly ask that you keep the above-mentioned goals in mind... thanks! == Installation == 1. Upload to `/wp-content/plugins/cf-littlebizzy` 2. Activate via WP Admin > Plugins 3. COnfigure at `/wp-admin/options-general.php?page=cloudflare` == FAQ == = How can I change this plugin's settings? = Configure at `/wp-admin/options-general.php?page=cloudflare` = What version of the CloudFlare API is used? = It currently uses CloudFlare API version 4. = Does this plugin purge `cache everything` pages? = No, it does not support caching HTML with CloudFlare, it is only meant to purge static resources. The "cache everything" option is generally not recommended for the vast majority of dynamic websites as it causes conflicts. = Can I define the API key and email address? = Yes you can use the supported defined constants to input the API key and email address in static PHP files like `wp-config.php` or `functions.php` to avoid database queries and data loss during staging sync or migrations. = I have a suggestion, how can I let you know? = Please avoid leaving negative reviews in order to get a feature implemented. Instead, we kindly ask that you post your feedback on the wordpress.org support forums by tagging this plugin in your post. If needed, you may also contact our homepage. == Changelog == = 1.3.2 = * remove Admin Toolbar link hover titles (tooltips) = 1.3.1 = * make drop-down menu appear on frontend too (not just backend) * drop-down menu parent now links to `/wp-admin/options-general.php?page=cloudflare` = 1.3.0 = * added drop-down menu on Admin Toolbar * enabled a dual mode in the plugin page, supporting both GET requests and POST submits to perform the clear cache and enable dev mode actions (GET requests are too secured by WP nonce system) = 1.2.1 = * updated plugin meta = 1.2.0 = * tested with PHP 7.1 * tested with PHP 7.2 * better settings data management for mixed scenarios (form values + defined constants) * (defined constants will now never "save" to the database) * `UPDATE SETTINGS` button now hidden if defined constants are recognized * API domain check now performed for `dev mode` and `purge cache` options (not only for `Update Settings` button) * (all button/actions are now "real" API results rather than relying on stored data values) * API notices now include specific API errors from CloudFlare = 1.1.1 = * added warning for Multisite installations * updated recommended plugins = 1.1.0 = * versioning correction (new major features in 1.0.4) * (no code changes) = 1.0.4 = * added support for `CLOUDFLARE_API_KEY` * added support for `CLOUDFLARE_API_EMAIL` = 1.0.3 = * minor code optimization = 1.0.2 = * fix: `Class 'LittleBizzy\CloudFlare\CLDFLR_Admin_Notices' not found` = 1.0.1 = * tested with WP 4.9 * added support for `DISABLE_NAG_NOTICES` * added recommended plugins notice * added WP.org rating request notice = 1.0.0 = * initial release * forked (kinda) from plugin *CloudFlare v1.3.24* * tested with PHP 7.0 * plugin uses PHP namespaces * object-oriented code