readme.txt (19500B)
1 === Gutenberg Template Library & Redux Framework === 2 Contributors: dovyp, redux, kprovance 3 Tags: gutenberg, blocks, gutenberg blocks, editor, block, page builder, block editor, block library, editor, templates, library 4 Requires at least: 4.0 5 Requires PHP: 7.1 6 Tested up to: 5.8.1 7 Stable tag: 4.3.1 8 License: GPL-3.0+ 9 License URI: http://www.gnu.org/licenses/gpl-3.0.txt 10 11 Supercharge the Gutenberg editor with our library of block-based templates and patterns! 12 13 == Description == 14 <strong>Redux - Quickly create full pages in WordPress’ Gutenberg</strong> 15 16 Supercharge the Gutenberg editor with our ever-growing library of WordPress Blocks and templates. Discover what's possible and implement any design on your website in virtually no time at all. 17 18 Worried that our templates may not work with your theme? We've got you covered. With our custom <em>page templates</em> option you can override any theme. Missing a plugin a template needs? No worries, we’ll even help you install what you need, all from the Gutenberg editor. 19 20 Don’t waste hours trying to recreate a template you love. With a click of a button it its own website where you can start customizing it for your needs. 21 22 <h4>♥️ What the Plugin does?</h4> 23 <ul> 24 <li><strong>Browse 1,000+</strong> templates from your Gutenberg Editor that you can add to your site immediately.</li> 25 <li><strong>Preview</strong> each template on a demo site.</li> 26 <li><strong>Filter</strong> between the dependencies you want, and find exactly what you're looking for.</li> 27 <li><strong>See instantly</strong> which Gutenberg templates you have everything for, or may need to install some dependencies.</li> 28 <li><strong>Automated install</strong> of anything you may need to install any template.</li> 29 <li><strong>Block Patterns library</strong> support built in.</li> 30 <li>The most trusted option framework in the industry.</li> 31 <li>Developer friendly: clean code, inline documentation</li> 32 </ul> 33 34 <h4>🚀 TYPICAL USE CASE OF THIS PLUGIN</h4> 35 Whether you are building a simple site or a **big site** with **lots of pages**, you just want it to look amazing. With the Extendify Library in Redux, you can begin making pages with various patterns or templates. 36 37 You can browse through the categories, as well as collections of like-styled pages. When you find something you like, we make sure you have everything you need. If a dependency (or required plugin) is missing, you are notified and can install the missing dependency. Worried that our templates may not work with your theme? No problem! With our custom `page templates` options, you can transform any site into precisely what you want it to be, no matter what you are using them for. 38 39 Don’t waste hours trying to recreate a design you love. With a click of a button, you have it on your own site, and you can begin customizing your template for your needs. 40 41 <h4>🎉 Supported Page Builders</h4> 42 Currently Redux supports only the <a href="https://wordpress.org/plugins/gutenberg/"><strong>Gutenberg / Block Editor of WordPress 5.0+</strong></a>. 43 44 <h4>🎨 Supported Themes</h4> 45 Though Redux will work with any theme that uses Gutenberg, we have done extra work to ensure complete compatibility with these themes. 46 47 <ul> 48 <li><a href="https://wordpress.org/themes/astra/"><strong>Astra Theme</strong></a> with <strong>Astra Pro</strong> Add-On Plugin – <strong>Custom Layouts</strong> (for Layouts, Headers, Footers, Hooks)</li> 49 <li><a href="https://wordpress.org/themes/generatepress/"><strong>GeneratePress Theme</strong></a> with <strong>GP Premium</strong> Add-On Plugin – <strong>Elements</strong> (for Layouts, Headers, Hooks)</li> 50 <li><a href="https://wordpress.org/themes/oceanwp/"><strong>OceanWP Theme</strong></a> with <a href="https://wordpress.org/plugins/ocean-extra/"><strong>Ocean Extra</strong></a> free Add-On Plugin – <strong>My Library</strong> (for Layouts, Hooks etc.)</li> 51 <li><strong>Kava Pro Theme/ CrocoBlock Service</strong> with JetThemeCore Plugin – <strong>My Library</strong> (for Layouts, Pages, Headers, Footers, Single, Archive)</li> 52 <li><strong>Genesis Framework</strong> with Genesis Child Themes — via <strong>Blox Lite</strong> and <strong>Blox</strong> (Pro) Plugins – <strong>Global Content Blocks</strong> (for Sections, Hooks)</li> 53 <li><strong>Page Builder Framework</strong> with <strong>WPBF Premium</strong> Add-On Plugin – <strong>Custom Section</strong> (for Sections, Layouts, Hooks etc.)</li> 54 <li><strong>Customify</strong> with <strong>Customify Pro</strong> Add-On Plugin – <strong>Hooks</strong> (for Layouts, Sections, Hooks etc.)</li> 55 <li><strong>Suki</strong> with <strong>Suki Pro</strong> Add-On Plugin – <strong>Custom Blocks</strong> (for Layouts, Sections, Hooks etc.)</li> 56 <li><strong>Neve</strong> with <strong>Neve Pro</strong> Add-On Plugin – <strong>Custom Layouts</strong> (for Layouts, Sections, Hooks etc.)</li> 57 <li><strong>Woostify</strong> with <strong>Woostify Pro</strong> Add-On Plugin – <strong>Header Footer Builder</strong> (for Elementor theming areas – Headers/ Footers)</li> 58 <li><strong>Avada Theme</strong> with Avada Fusion Builder – <strong>Library</strong> (for Templates, Pages, Layouts, Columns, Rows)</li> 59 <li><strong>Divi Theme</strong> with Divi Builder – <strong>Library</strong> (for Templates etc.)</li> 60 <li><strong>Extra Theme</strong> with Divi Builder – <strong>Library</strong> (for Templates etc.) – <strong>Category Templates</strong> (for Layouts, Templates etc.)</li> 61 </ul> 62 63 <h4>👍 BE A CONTRIBUTOR</h4> 64 If you want to translate, <a href="https://translate.wordpress.org/projects/wp-plugins/redux-framework">go to the Translation Portal at translate.wordpress.org</a>. 65 66 You can also contribute code via our <a href="https://github.com/reduxframework/redux-framework/">GitHub Repository</a>. Be sure to use our develop branch to submit pull requests. 67 68 <h4>📝 Documentation and Support</h4> 69 <ul> 70 <li>For more information about the Template Library, check out <a href="https://extendify.com/" rel="nofollow ugc">Extendify</a>.</li> 71 <li>For information about the Redux Options Framework, check out <a href="https://devs.redux.io/" rel="nofollow ugc">Redux Documentation</a>.</li> 72 <li>If you have additional questions, reach out to us at support@redux.io</li> 73 </ul> 74 75 <h4>⚡ Like the Redux Plugin?</h4> 76 <ul> 77 <li>Follow us on <a href="https://www.facebook.com/reduxframework" rel="nofollow ugc">Facebook 💬</a></li> 78 <li><strong>Rate us 5 ⭐ stars</strong> on <a href="https://wordpress.org/support/plugin/redux-framework/reviews/?filter=5/#new-post">WordPress.org</a></li> 79 <li>Follow us on Twitter 🐦: <a href="https://twitter.com/reduxframework" rel="nofollow ugc">@ReduxFramework</a></li> 80 </ul> 81 82 <h4>🔐 Privacy</h4> 83 Redux does not interact with end users on your website. Our templates will continue to work even if Redux is uninstalled. If a product is using Redux the option panel will cease to function without Redux. 84 85 Redux utilizes [AppSero](https://appsero.com/) for account management as well as to enable our premium offerings. You can find their privacy policy here: [https://appsero.com/privacy-policy/](https://appsero.com/privacy-policy/). Activation of Redux is not necessary, but additional features such as Google Font Updates and increased access to the template library will be limited. 86 87 The Redux plugin uses a custom API to fetch our content library and our Gutenberg templates. To improve the service and stability we store logs which may or may not contain the following: 88 <ul> 89 <li>browser type</li> 90 <li>referring site</li> 91 <li>date and time of request</li> 92 <li>category selection or search term</li> 93 <li>anonymized IP address</li> 94 </ul> 95 96 API requests are only made when a user clicks on the Library button, launches the Redux Challenge, or opts into Google Font updates. 97 98 For more details on our privacy policy: [https://redux.io/privacy](https://redux.io/privacy) 99 For more details on our terms and conditions: [https://redux.io/terms](https://redux.io/terms) 100 101 == Installation == 102 1. Upload the entire plugin folder to the `/wp-content/plugins/` directory. 103 2. Activate the plugin through the 'Plugins' menu in WordPress. 104 105 Once Installed and Activated you will be invited to Activate your Redux account. This is entirely voluntary and easily dismissed. 106 107 If you want, you can use the [Gutenberg](https://wordpress.org/plugins/gutenberg/) plugin to get bleeding-edge experiments by the Gutenberg team. 108 109 == Changelog == 110 111 = 4.3.1 = 112 Fixed: `wp_mail has been declared by another process or plugin` message. 113 Fixed: Malformed README wouldn't allow clicking of some support links. 114 Release date: September 22, 2021 115 116 = 4.3.0 = 117 Added: Gutenberg Template Library updated to the new Extendify library. See more information here about this upgrade and how to access the legacy library: [https://redux.io/gutenberg-template-library-upgrade](https://redux.io/gutenberg-template-library-upgrade). 118 Added: Option to enable/disable Template libraries. Found under Settings > Redux > Templates 119 Added: Redux debug data moved to WordPress Site Health Info screen. 120 Removed: Redux Framework Health Screen. 121 Modified: Tools > Redux Framework screen moved to Settings > Redux 122 Modified: Redux Templates disabled by default. 123 Release date: September 21, 2021 124 125 = 4.2.14 = 126 Fixed: Parse error in Import/Export module due to old versions of PHP. 127 Release date: August 11, 2021 128 129 = 4.2.13 = 130 Fixed: #3822 - Default value function returns string or array to prevent type error. 131 Modified: #3820 - Better support for Redux embedded in themes. 132 Modified: `install_plugins` security level now required to install Template blocks that require additional plugins. This was done for security reasons. 133 Added: New global arg `load_on_cron`. Set to true if you require Redux to run within a cron initiated function. 134 Removed: URL based Import/Export option due to security concerns. Manual Import/Export features remain. 135 Removed: Support URL feature due to security issues. Please use WordPress Site Health 'copy to clipboard' compiler to submit system data when reporting issues. 136 Release date: August 11, 2021 137 138 = 4.2.11 = 139 Fixed: Removed type declarations on core return values to support improperly written third-party extensions. 140 Fixed: Added shim to prevent errors on functions calls outdated extensions are still using. 141 Fixed: Removed type declarations on field code to support outdated versions of PHP (PHP 7.4 is the minimum recommendation from WordPress...please update if you are able. [https://wordpress.org/about/requirements](https://wordpress.org/about/requirements). 142 Fixed: Support URL button kicking back a JavaScript error. 143 Release date: July 29, 2021 144 145 = 4.2.10 = 146 Fixed: Output on the frontend triggering error. 147 Fixed: Updated shims to support older extensions not authored by Redux.io 148 Release date: July 28, 2021 149 150 = 4.2.9 = 151 Fixed: WordPress data class now works properly. 152 Release date: July 28, 2021 153 154 = 4.2.8 = 155 Redux instances returning null. Saved options now show on the front end. 156 Release date: July 28, 2021 157 158 = 4.2.7 = 159 Fixed: Options reverting or not saving. 160 Release date: July 28, 2021 161 162 = 4.2.6 = 163 Fixed: Fatal error if passing null as an option section. 164 Fixed: Error in connection banner routine. 165 Release date: July 28, 2021 166 167 = 4.2.5 = 168 Fixed: Type mismatch in Redux Helpers. 169 Release date: July 28, 2021 170 171 = 4.2.4 = 172 Fixed: Taxonomy WordPress data not handled properly in fields that support WordPress data. 173 Release date: July 28, 2021 174 175 = 4.2.3 = 176 Fixed: Return type error in Redux templates. 177 Release date: July 28, 2021 178 179 = 4.2.2 = 180 Fixed: WordPress data options not handling WP_Error properly. 181 Release date: July 28, 2021 182 183 = 4.2.1 = 184 Fixed: Type mismatch regarding select boxes and callbacks. 185 Release date: July 27, 2021 186 187 = 4.2.0 = 188 New: Typography features: Top and bottom margins, text-shadow. 189 New: Media Image Filters (greyscale, sepia, opacity, contrast, invert, blur, saturate, brightness, hue-rotate). 190 New: Filters (type, reach, angle) for Gradient color field. 191 New: Box Shadow field. 192 New: Flyout Submenus: `flyout_submenus` global arg. 193 New: Alpha color option for color field: `color_alpha` field arg for fields that support color pickers. 194 Updated: select2 library to 4.1.0. 195 Updated: readme.txt to conform to wp.org standards. 196 Fixed: Remove PHP 7.2 syntax to keep older versions of PHP 7 happy. 197 Fixed: Redux templates not showing on 'page attributes' for some. 198 Fixed: Additional PHP 8.0 compatibility. 199 Fixed: Widget screen would not load due to conflict with template library. 200 Added: WordPress 5.8 compatibility. 201 Improved: Better Gutenberg block editor detection. 202 Modified: Redux Pro no longer required for automatic Google font updates. 203 Modified: Rename Parsedown class for raw field to avoid conflicts with other plugins. 204 Removed: `async_typography` global arg. Google no longer supports it. Use `font_display` with one of the following `auto|block|swap|fallback|optional`. See: [https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display) 205 Release date: July 27, 2021 206 207 = 4.1.29 = 208 Fixed: All PHP 7.4 specific syntax backed out. It caused older versions of PHP to report fatal errors. 209 Fixed: Index error in the image_select field. 210 Release date: June 29, 2021 211 212 = 4.1.28 = 213 Fixed: Redux templates loading on post types with no block editor. 214 Fixed: Redux theme checks no longer prevent theme check plugin from functioning. 215 Fixed: Heatbeat check no longer eats the function if disregarded. 216 Fixed: Background field image now hides preview image upon removal. 217 Fixed: RAW field in sample config now works. 218 Fixed: Helper function is_field_in_use now returns false, instead of null. 219 Fixed: Palette field rendering improperly. 220 Fixed: Google font update fail. 221 Modified: buttonset() jQuery widget deprecated. Replaced with controlgroup(). 222 Modified: Additional JavaScript updates to fix jQuery deprecation notices. 223 Release date: June 29, 2021 224 225 = 4.1.27 = 226 Fixed: Image select not selecting default value. 227 Modified: Link color field overridden by theme. Added 'important' arg to the output array to fix. See sample config. 228 Fixed: Same config not setting footer background in Twenty-twenty theme due to incorrect class. 229 Fixed: Radio field not displaying text after save/refresh when displaying WordPress data. 230 Modified: Donation text removed. 231 Fixed: Link color CSS compiling incorrectly due to late escaping. 232 233 = 4.1.26 = 234 Added: Menu accent introduced in WordPress 5.7. 235 Updated: ACE Editor 1.4.12. 236 Updated select2 to support cssContainer. 237 Fixed: Multiple submenus in metaboxes; the last submenu it cut off. 238 Fixed: Fatal error: Can't use function return value in write context. 239 Fixed: PHP 8.0 deprecation warnings. 240 Fixed: Malformed HTML causing Redux pro alpha color-picker to not render. 241 Fixed: IMproved class checks for Redux Pro. 242 Fixed: jQuery 3.x deprecation notices. 243 Fixed: Malformed SCSS. 244 Release date: March 17, 2021 245 246 = 4.1.25 = 247 Fixed: Erroneous icon on button_set field after WP 5.6 update. 248 Fixed: Erroneous icon on palette field after WP 5.6 update. 249 Fixed: PHP error in init_delay function during heartbeat API. 250 Fixed: Options object field not rendering. 251 Release date: Jan 21, 2021 252 253 = 4.1.24 = 254 Fixed: Select2 callback fix for select fields. 255 Added: Shim: empty field_*.php files to fix developers including files improperly. 256 Fixed: Changed use of ctype_xdigit to account for hosts where it's disabled. 257 Added: Shim for people using terms data key, but using taxonomies instead of taxonomy. 258 Fixed: Static call mismatch in redux colors. 259 Fixed: CSRF security issue with a flipped if conditional. Thanks, @ErwanLR. 260 Fixed: WordPress 4.6 API warnings. 261 Fixed: WordPress 4.6 customizer issue where fields not displaying properly. 262 Fixed: Massive speed improvement to the library. 263 Fixed: Pro template count error if previously activated and Redux Pro not enabled. 264 Release date: Dec 12, 2020 265 266 = 4.1.23 = 267 Fixed: Massive speed improvement to the library. 268 Fixed: Pro template count error if previously activated and Redux Pro not enabled. 269 Release date: Oct 24, 2020 270 271 = 4.1.22 = 272 Fixed: Menu locations WordPress data object not providing name. 273 Added: Undefined if menu location is not assigned to a menu. 274 Fixed: Another import/export edge case. 275 Fixed: Fix setField API value. 276 Fixed: Older extension compatibility. 277 Fixed: Text field error with data/options args not displaying properly. 278 Fixed: Import/Export now properly respects order of objects. Now using PHP over JS json_encode. 279 Release date: Oct 23, 2020 280 281 = 4.1.21 = 282 Fixed: Fixed connection banner to hide even if JS is broken by jQuery migrate issue (WP 5.5). 283 Fixed: Resolved all remaining legacy extension compatibility issues. 284 Fixed: Custom callback with select field. 285 Fixed: Typography bug when style was hidden. 286 Fixed: Issue with text labels. 287 Fixed: Google fonts HTML validation issues. 288 Added: Feedback modal. 289 Fixed: Import logic flaw. 290 Fixed: Security bug. Thanks, @lenonleite of www.lenonleite.com.br. 291 Release date: Oct 08, 2020 292 293 = 4.1.20 = 294 Added: Properly adjust the blocked editor page width based on template selected. 295 Added: Broke out third-party premium plugins for filtering to help with understanding of what comes with Redux Pro. 296 Added: Update block editor width when selecting a Redux template. 297 Fixed: Some styling issues with preview modal. 298 Fixed: Issue where plugin titles were not alphabetical. 299 Fixed: Disabled third party premium dependencies. 300 Fixed: Issue where crash would occur when Redux could not write out a file. 301 Fixed: CSS selectors with HTML entities, like >, were not getting decoded for the passed compiler values. 302 Fixed: Redux Pro activation issue. 303 Fixed: Invalid logic causing some extensions not to run. 304 Release date: Sep 18, 2020 305 306 ** For a full changelog, see https://github.com/reduxframework/redux-framework/blob/master/CHANGELOG.md ** 307 308 == Frequently Asked Questions == 309 310 = Who should use the Gutenberg Template Library? = 311 312 The Redux Block Library for Gutenberg is a complete package of unique and creative templates that will help you build beautiful pages and posts on a website. It is of value for everyone and for all who love Gutenberg. 313 314 = What are the requirements to use the Gutenberg Template Library? = 315 316 You only need to have the latest version of WordPress on your website, to begin with. Redux is for Gutenberg is basically an addon for the default WordPress block editor. Therefore, the latest WordPress installation along with a theme should be enough, to begin with. 317 318 = What themes do Redux Library for Gutenberg work with? = 319 320 Redux is built to work wonderfully with all themes. 321 322 = Can I use Redux for Gutenberg even while having another Page Builder? = 323 324 The basic need or requirement for the Gutenberg Template Library is the latest WordPress version. Should you need help, you can <a href="https://redux.io/contact/?utm_source=wp-repo&utm_medium=link&utm_campaign=readme" target="_blank" rel="">get in touch with us.</a> 325 326 = Can I use the Gutenberg Template Library on client websites? = 327 328 Yes! You can certainly use Redux on yours as well as your client's websites. 329 330 = Will Redux slow down my website? = 331 332 Absolutely not! The Gutenberg Template Library plugin is built with ease and performance in mind. Its module architecture and the clean code keep it extremely fast. Every performance issue that seems to be coming from Redux is actually the integration code of third-party developers. If you're having issues let us know, and we'll try to help you out.