| 1 |
=== Force Refresh === |
| 2 |
Stable tag: 3.2.1 |
| 3 |
Contributors: jordanleven |
| 4 |
Tags: refresh, reload, live reload, page refresh, scheduled |
| 5 |
Requires PHP: 7.4 |
| 6 |
Requires at least: 5.9 |
| 7 |
Tested up to: 7.1 |
| 8 |
License: GPLv2 or later |
| 9 |
Force Refresh lets you request page refreshes for visitors viewing your site, whether you want to refresh the whole site or a single page. |
| 10 |
|
| 11 |
|
| 12 |
== Description == |
| 13 |
Force Refresh gives you a fast, reliable way to request or schedule browser refreshes for visitors currently viewing your site. It's ideal for single-page applications, live feeds, and any experience where fresh content matters. |
| 14 |
|
| 15 |
== Features == |
| 16 |
- Request a browser refresh with a single click, using the client-side refresh interval you've configured. |
| 17 |
- Schedule any number of site refreshes in advance. |
| 18 |
- Refresh individual pages or posts when you need a more targeted update. |
| 19 |
- Choose refresh intervals from 30 seconds up to four hours. |
| 20 |
- Extend refresh permissions to any role with the "Invoke Force Refresh" capability. |
| 21 |
- Works with both parent and child themes. |
| 22 |
|
| 23 |
== Feature Requests and Bug Reports == |
| 24 |
- Report bugs through the [Support tab](https://wordpress.org/support/plugin/force-refresh). |
| 25 |
- Share feature requests on [GitHub](https://github.com/jordanleven/force-refresh/issues). Force Refresh is open source, and pull requests are welcome. |
| 26 |
|
| 27 |
== Installation == |
| 28 |
Upload Force Refresh to your site and activate it. When you're ready to request a refresh, go to "Tools", select "Force Refresh", and click "Refresh Site." |
| 29 |
|
| 30 |
== Screenshots == |
| 31 |
1. Under Tools, you'll find all settings for Force Refresh. |
| 32 |
2. Use Schedule Force Refresh to pick a specific date and time for the refresh: no need to be at your desk when it goes out. |
| 33 |
3. You can enable Force Refresh in the WordPress admin bar for quick access from anywhere in the dashboard. |
| 34 |
4. Choose from popular refresh intervals or set a custom one. You'll receive confirmation that browsers were requested to refresh. |
| 35 |
5. To refresh a single page or post, locate the "Force Refresh" section under any page. |
| 36 |
6. Want to see the latest features? Clicking "View Release Notes" will display the most recent features and fixes for Force Refresh. |
| 37 |
7. If you're having trouble, clicking on "Troubleshooting" will allow you to view the current settings for Force Refresh and allow you to enter Debugging Mode: an enhanced browser console logging mode that can be used to diagnose issues. |
| 38 |
|
| 39 |
== Changelog == |
| 40 |
#### 3.2.1 |
| 41 |
_Released on September 13, 2026_ |
| 42 |
|
| 43 |
##### **Changes** |
| 44 |
* Performance enhancements and bug fixes. |
| 45 |
|
| 46 |
#### 3.2.0 |
| 47 |
_Released on August 13, 2026_ |
| 48 |
|
| 49 |
##### **Changes** |
| 50 |
* Add support for WordPress 7.1. |
| 51 |
* Performance enhancements and bug fixes. |
| 52 |
|
| 53 |
#### 3.1.2 |
| 54 |
_Released on August 1, 2026_ |
| 55 |
|
| 56 |
##### **Changes** |
| 57 |
* Performance enhancements and bug fixes. |
| 58 |
|
| 59 |
#### 3.1.1 |
| 60 |
_Released on June 13, 2026_ |
| 61 |
|
| 62 |
##### **Changes** |
| 63 |
* Performance enhancements and bug fixes. |
| 64 |
|
| 65 |
#### 3.1.0 |
| 66 |
_Released on May 16, 2026_ |
| 67 |
|
| 68 |
##### **New Features** |
| 69 |
* Static file polling is now available as an opt-in setting. Enable it to reduce server load on high-traffic sites by serving version checks from a static file instead of a live API request. |
| 70 |
|
| 71 |
##### **Changes** |
| 72 |
* Add support for WordPress 7.0. |
| 73 |
|
| 74 |
#### 3.0.0 |
| 75 |
_Released on April 22, 2026_ |
| 76 |
|
| 77 |
##### **New Features** |
| 78 |
* Introducing scheduled refreshes. Plan site-wide refreshes in advance so they happen exactly when you need them. |
| 79 |
* Force Refresh now supports a wider range of older WordPress and PHP versions, including WordPress 5.9 and PHP 7.4. |
| 80 |
* Redesigned the troubleshooting section with a clearer layout for debug controls, site details, health checks, and added an easier way to submit debugging information when you need help. |
| 81 |
|
| 82 |
##### **Changes** |
| 83 |
* Performance enhancements and bug fixes. |
| 84 |
|
| 85 |
#### 2.17.0 |
| 86 |
_Released on April 12, 2026_ |
| 87 |
|
| 88 |
##### **New Features** |
| 89 |
* Release notes are now grouped by minor version for easier browsing. You can also click any release to view the full details on the official GitHub repository. |
| 90 |
|
| 91 |
##### **Changes** |
| 92 |
* Resolves an issue where Force Refresh unnecessarily contained WordPress.org plugin marketing assets. |
| 93 |
* Updated plugin status messaging in the admin interface to better highlight available updates, pre-release builds, and debugging mode. |
| 94 |
* Performance enhancements and bug fixes. |
| 95 |
|
| 96 |
#### 2.16.2 |
| 97 |
_Released on April 8, 2026_ |
| 98 |
|
| 99 |
##### **Changes** |
| 100 |
* Performance enhancements and bug fixes. |
| 101 |
|
| 102 |
#### 2.16.1 |
| 103 |
_Released on March 10, 2026_ |
| 104 |
|
| 105 |
##### **Changes** |
| 106 |
* Performance enhancements and bug fixes. |
| 107 |
|
| 108 |
#### 2.16.0 |
| 109 |
_Released on February 24, 2026_ |
| 110 |
|
| 111 |
##### **Changes** |
| 112 |
* Update minimum PHP version to 8.2. |
| 113 |
|
| 114 |
#### 2.15.0 |
| 115 |
_Released on February 24, 2026_ |
| 116 |
|
| 117 |
##### **Changes** |
| 118 |
* Update minimum WordPress version to 6.3. |
| 119 |
|
| 120 |
#### 2.14.0 |
| 121 |
_Released on November 29, 2025_ |
| 122 |
|
| 123 |
##### **New Features** |
| 124 |
* Add support for WordPress 6.9. |
| 125 |
|
| 126 |
#### 2.13.2 |
| 127 |
_Released on August 29, 2025_ |
| 128 |
|
| 129 |
##### **Fixes** |
| 130 |
* Resolves an issue where Force Refresh could fail to activate on sites running PHP 8.2. |
| 131 |
|
| 132 |
#### 2.13.1 |
| 133 |
_Released on August 9, 2025_ |
| 134 |
|
| 135 |
##### **Changes** |
| 136 |
* Performance enhancements and bug fixes. |
| 137 |
|
| 138 |
#### 2.13.0 |
| 139 |
_Released on April 21, 2025_ |
| 140 |
|
| 141 |
##### **New Features** |
| 142 |
* Add support for WordPress 6.8. |
| 143 |
|
| 144 |
#### 2.12.1 |
| 145 |
_Released on January 12, 2025_ |
| 146 |
|
| 147 |
##### **Changes** |
| 148 |
* Performance enhancements and bug fixes. |
| 149 |
|
| 150 |
#### 2.12.0 |
| 151 |
_Released on October 28, 2024_ |
| 152 |
|
| 153 |
##### **New Features** |
| 154 |
* Add support for WordPress 6.7. |
| 155 |
|
| 156 |
#### 2.11.1 |
| 157 |
_Released on September 15, 2024_ |
| 158 |
|
| 159 |
##### **Changes** |
| 160 |
* Performance enhancements and bug fixes. |
| 161 |
|
| 162 |
#### 2.11.0 |
| 163 |
_Released on July 7, 2024_ |
| 164 |
|
| 165 |
##### **New Features** |
| 166 |
* Add support for WordPress 6.6. |
| 167 |
|
| 168 |
#### 2.10.2 |
| 169 |
_Released on May 27, 2024_ |
| 170 |
|
| 171 |
##### **Changes** |
| 172 |
* Performance enhancements and bug fixes. |
| 173 |
|
| 174 |
#### 2.10.1 |
| 175 |
_Released on March 24, 2024_ |
| 176 |
|
| 177 |
##### **Changes** |
| 178 |
* Performance enhancements and bug fixes. |
| 179 |
|
| 180 |
#### 2.10.0 |
| 181 |
_Released on March 24, 2024_ |
| 182 |
|
| 183 |
##### **New Features** |
| 184 |
* Add support for WordPress 6.5. |
| 185 |
|
| 186 |
##### **Fixes** |
| 187 |
* Resolves an issue where missing build files showed an unclear activation error. |
| 188 |
|
| 189 |
#### 2.9.4 |
| 190 |
_Released on February 10, 2024_ |
| 191 |
|
| 192 |
##### **Fixes** |
| 193 |
* Resolves an issue where icons could fail to load in the admin UI. |
| 194 |
|
| 195 |
#### 2.9.3 |
| 196 |
_Released on December 9, 2023_ |
| 197 |
|
| 198 |
##### **Fixes** |
| 199 |
* Resolves an issue where the Release Notes modal did not load correctly. |
| 200 |
|
| 201 |
#### 2.9.2 |
| 202 |
_Released on November 17, 2023_ |
| 203 |
|
| 204 |
##### **Fixes** |
| 205 |
* Resolves an issue where the admin bar confirmation message did not include the selected refresh interval. |
| 206 |
* Resolves an issue where the refresh button label in the WordPress admin bar was incorrect. |
| 207 |
* Resolves an issue where search results pages could refresh continuously. |
| 208 |
* Resolves an issue where refreshing an individual page or post did not save correctly. |
| 209 |
* Resolves an issue where Admin Bar refresh settings were not saved correctly in the plugin options. |
| 210 |
|
| 211 |
#### 2.9.1 |
| 212 |
_Released on November 10, 2023_ |
| 213 |
|
| 214 |
##### **Fixes** |
| 215 |
* Resolves an issue where activating Force Refresh could cause a site to crash. |
| 216 |
|
| 217 |
#### 2.9.0 |
| 218 |
_Released on November 10, 2023_ |
| 219 |
|
| 220 |
##### **New Features** |
| 221 |
* Add support for WordPress 6.4. |
| 222 |
|
| 223 |
#### 2.8.3 |
| 224 |
_Released on September 9, 2023_ |
| 225 |
|
| 226 |
##### **Changes** |
| 227 |
* Performance enhancements and bug fixes. |
| 228 |
|
| 229 |
#### 2.8.2 |
| 230 |
_Released on August 9, 2023_ |
| 231 |
|
| 232 |
##### **Fixes** |
| 233 |
* Resolves an issue where release notes could display duplicate periods. |
| 234 |
* Resolves an issue where release notes could break on sites running PHP 7.4. |
| 235 |
|
| 236 |
#### 2.8.1 |
| 237 |
_Released on August 5, 2023_ |
| 238 |
|
| 239 |
##### **Changes** |
| 240 |
* Performance enhancements and bug fixes. |
| 241 |
|
| 242 |
#### 2.8.0 |
| 243 |
_Released on August 5, 2023_ |
| 244 |
|
| 245 |
##### **New Features** |
| 246 |
* Add support for leaving plugin reviews from the admin UI. |
| 247 |
* Add support for custom refresh intervals between thirty seconds and four hours. |
| 248 |
* Add support for viewing plugin release notes from within the admin UI. |
| 249 |
|
| 250 |
##### **Fixes** |
| 251 |
* Resolves an issue where dismissed admin notifications could block interaction with the rest of the admin interface. |
| 252 |
* Resolves an issue where logo animations in the admin interface did not run with the intended timing. |
| 253 |
|
| 254 |
#### 2.7.0 |
| 255 |
_Released on July 26, 2023_ |
| 256 |
|
| 257 |
##### **New Features** |
| 258 |
* Add support for WordPress 6.3. |
| 259 |
|
| 260 |
#### 2.6.1 |
| 261 |
_Released on March 4, 2023_ |
| 262 |
|
| 263 |
##### **Changes** |
| 264 |
* Performance enhancements and bug fixes. |
| 265 |
|
| 266 |
#### 2.6.0 |
| 267 |
_Released on June 11, 2022_ |
| 268 |
|
| 269 |
##### **New Features** |
| 270 |
* Add support for opening the troubleshooting page directly from the main admin screen. |
| 271 |
|
| 272 |
##### **Fixes** |
| 273 |
* Resolves an issue where the refresh instructions read awkwardly on sites without a configured site name. |
| 274 |
|
| 275 |
#### 2.5.2 |
| 276 |
_Released on January 23, 2022_ |
| 277 |
|
| 278 |
##### **Fixes** |
| 279 |
* Resolves an issue where the production release workflow shipped the beta JavaScript bundle instead of the production build. |
| 280 |
|
| 281 |
#### 2.5.1 |
| 282 |
_Released on January 23, 2022_ |
| 283 |
|
| 284 |
##### **New Features** |
| 285 |
* Add support for troubleshooting version checks that include development version strings. |
| 286 |
* Update WordPress version requirements. |
| 287 |
|
| 288 |
#### 2.5.0 |
| 289 |
_Released on January 8, 2022_ |
| 290 |
|
| 291 |
##### **New Features** |
| 292 |
* Add support for showing an admin notice when the installed plugin version is out of date. |
| 293 |
|
| 294 |
#### 2.4.0 |
| 295 |
_Released on December 4, 2021_ |
| 296 |
|
| 297 |
##### **New Features** |
| 298 |
* Add support for debug logging during the refresh countdown when Debug Mode is enabled. |
| 299 |
* Add support for a troubleshooting screen with debug information and a browser-console Debug Mode toggle. |
| 300 |
|
| 301 |
##### **Fixes** |
| 302 |
* Resolves an issue where the refresh flow could continue after an unsuccessful refresh request. |
| 303 |
* Resolves an issue where refresh checks could fail for site visitors. |
| 304 |
|
| 305 |
#### 2.3.0 |
| 306 |
_Released on March 7, 2021_ |
| 307 |
|
| 308 |
##### **Fixes** |
| 309 |
* Resolves an issue where the admin options UI did not show the default 120-second interval as selected. |
| 310 |
* Resolves an issue where the admin bar button label incorrectly said "Force Refresh Sites." |
| 311 |
|
| 312 |
#### 2.2.0 |
| 313 |
_Released on November 29, 2020_ |
| 314 |
|
| 315 |
##### **New Features** |
| 316 |
* Add support for WordPress 5.5.3. |
| 317 |
* Add support for a Vue-powered admin UI in place of the legacy Handlebars interface. |
| 318 |
|
| 319 |
##### **Fixes** |
| 320 |
* Resolves an issue where per-page refresh controls did not work correctly for posts whose slugs contained encoded characters. |
| 321 |
|
| 322 |
#### 2.1.6 |
| 323 |
_Released on September 29, 2020_ |
| 324 |
|
| 325 |
##### **Fixes** |
| 326 |
* Resolves an issue where client refresh checks ignored the configured refresh interval. |
| 327 |
|
| 328 |
#### 2.1.5 |
| 329 |
_Released on September 17, 2020_ |
| 330 |
|
| 331 |
##### **Fixes** |
| 332 |
* Resolves issues running Force Refresh on sites using PHP 7.2. |
| 333 |
|
| 334 |
#### 2.1.4 |
| 335 |
_Released on September 16, 2020_ |
| 336 |
|
| 337 |
##### **Fixes** |
| 338 |
* Resolves an issue where pages without a stored refresh version could enter a refresh loop after activation. |
| 339 |
* Resolves an issue where the admin panel did not display the default refresh interval as the selected option. |
| 340 |
|
| 341 |
#### 2.1.3 |
| 342 |
_Released on September 16, 2020_ |
| 343 |
|
| 344 |
##### **Fixes** |
| 345 |
* Resolves an issue where users without the Force Refresh capability could still request refreshes. |
| 346 |
|
| 347 |
#### 2.1.2 |
| 348 |
_Released on September 7, 2020_ |
| 349 |
|
| 350 |
##### **Changes** |
| 351 |
* Performance enhancements and bug fixes. |
| 352 |
|
| 353 |
#### 2.1.1 |
| 354 |
_Released on September 7, 2020_ |
| 355 |
|
| 356 |
##### **Changes** |
| 357 |
* Performance enhancements and bug fixes. |
| 358 |
|
| 359 |
#### 2.1.0 |
| 360 |
_Released on October 19, 2018_ |
| 361 |
|
| 362 |
##### **New Features** |
| 363 |
* Add support for requesting refreshes on custom post types. |
| 364 |
|
| 365 |
#### 2.0.0 |
| 366 |
_Released on October 11, 2018_ |
| 367 |
|
| 368 |
##### **New Features** |
| 369 |
* Add support for HTML templating with LightnCandy. |
| 370 |
|
| 371 |
#### 1.1.2 |
| 372 |
_Released on February 28, 2018_ |
| 373 |
|
| 374 |
##### **Changes** |
| 375 |
* Performance enhancements and bug fixes. |
| 376 |
|
| 377 |
#### 1.1.1 |
| 378 |
_Released on February 28, 2018_ |
| 379 |
|
| 380 |
##### **Changes** |
| 381 |
* Performance enhancements and bug fixes. |
| 382 |
|
| 383 |
#### 1.0.0 |
| 384 |
_Released on October 5, 2017_ |
| 385 |
|
| 386 |
##### **New Features** |
| 387 |
* Initial release. |
