| 1 |
=== Customify - Intuitive Website Styling === |
| 2 |
Contributors: pixelgrade, vlad.olaru, babbardel, razvanonofrei, gorby31 |
| 3 |
Tags: design, customizer, fonts, colors, gutenberg, font palettes, color palettes |
| 4 |
Requires at least: 4.9.14 |
| 5 |
Tested up to: 5.5.3 |
| 6 |
Stable tag: 2.10.1 |
| 7 |
Requires PHP: 5.4.0 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
|
| 11 |
Customify is a theme Customizer booster to easily customize Fonts, Colors, and other options for a certain WordPress theme. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
With [Customify](https://github.com/pixelgrade/customify), developers can easily create **advanced theme-specific options** inside the WordPress Customizer. Using those options, a user can make presentational changes without having to know or edit the theme code. |
| 16 |
|
| 17 |
This plugin is **primarily intended** to be used together with [Pixelgrade themes](https://wordpress.org/themes/author/pixelgrade/). So the best way to get acquainted with it's capabilities is to study the way [one of Pixelgrade's themes](https://github.com/pixelgrade/rosa2-lite/tree/master/inc/integrations/customify) integrates with it. |
| 18 |
|
| 19 |
**Made with care by Pixelgrade** |
| 20 |
|
| 21 |
== Credits == |
| 22 |
|
| 23 |
* [Select2](https://select2.github.io) JavaScript library - License: MIT |
| 24 |
* [CSSOM.js](https://github.com/NV/CSSOM) JavaScript library - License: MIT |
| 25 |
* [Ace Editor](https://ace.c9.io/) JavaScript editor - License: BSD |
| 26 |
* [jQuery React](https://github.com/natedavisolds/jquery-react) JavaScript jQuery plugin - License: MIT |
| 27 |
* [Web Font Loader](https://github.com/typekit/webfontloader) JavaScript library - License: Apache 2.0 |
| 28 |
* [Fuse.js](http://fusejs.io) Lightweight fuzzy-search JavaScript library - License: Apache 2.0 |
| 29 |
* Default [image](https://unsplash.com/photos/OgM4RKdr2kY) for Style Manager Color Palette control - License: [Unsplash](https://unsplash.com/license) |
| 30 |
|
| 31 |
== Changelog == |
| 32 |
|
| 33 |
= 2.10.1 = |
| 34 |
* Fix live preview for the advanced Dark Mode control introduced in 2.10.0 |
| 35 |
|
| 36 |
= 2.10.0 = |
| 37 |
* Add an enhanced version of the Dark Mode control that can be enabled by themes. |
| 38 |
|
| 39 |
= 2.9.2 = |
| 40 |
* Fix compatibility with WordPress 5.5. |
| 41 |
* Styling fixes and improvements. |
| 42 |
|
| 43 |
= 2.9.1 = |
| 44 |
* Fixes errors with Google Fonts in some instances. |
| 45 |
|
| 46 |
= 2.9.0 = |
| 47 |
* **Feature:** Introduces the ability to easily **search through all Customizer settings, menus, and widgets** |
| 48 |
* **Feature:** Introduces the ability to migrate parent theme customization options when switching to a child theme; this way you don't lose your existing customizations |
| 49 |
* **Improvement:** Switches to using **modern browser capabilities for fonts loading** on the frontend of your site; this should lead to better web performance and user experience, and save CO2 |
| 50 |
* **Improvement:** Use the swap font-display technique for better performance and PageSpeed score |
| 51 |
* Updates the Google Fonts list |
| 52 |
* Switches to using the Google Fonts CSS API V2 instead of the previous V1 |
| 53 |
* Removes the font subsets control since it is no longer needed; the needed (and available) subsets will be loaded automatically by the browser |
| 54 |
|
| 55 |
= 2.8.0 = |
| 56 |
* **Improvement:** **Better font palettes logic** for even more accurate site typography |
| 57 |
* **Improvement:** All fonts now have **fallback font stacks** added for the font family CSS property |
| 58 |
* **Improvement:** Made it much easier to use system fonts instead or beside web fonts |
| 59 |
* **Improvement:** Allow font palettes to provide font stacks instead of a single font family |
| 60 |
* Fix inconsistencies between fonts behavior in the Customizer preview and site frontend |
| 61 |
* Properly sanitize font family names before using them in CSS |
| 62 |
* Convert inconsistent font variants to standard values (regular, normal, bold) |
| 63 |
* Handle both numerical and string font variant values |
| 64 |
* Fix missing fonts loaded class and JavaScript event when no web fonts used |
| 65 |
* Fix backward compatibility with WordPress 4.9.14 |
| 66 |
|
| 67 |
= 2.7.3 = |
| 68 |
* Fixes for some edge situations when fonts would not apply on the frontend, after some time. Mainly related to cache issues. |
| 69 |
* Fix for missing font fields CSS properties. |
| 70 |
* Fix compatibility with the The Events Calendar plugin. |
| 71 |
|
| 72 |
= 2.7.2 = |
| 73 |
* Better handle legacy font values upon upgrade. |
| 74 |
|
| 75 |
= 2.7.1 = |
| 76 |
* Fixed a couple of inconsistencies related to cache invalidation |
| 77 |
* Added integrations for the main caching plugins to prevent them minifying or moving the Web Font Loader script |
| 78 |
|
| 79 |
= 2.7.0 = |
| 80 |
* Overall performance improvements, especially on the client-side (JavaScript). |
| 81 |
* Overall logic cleanup with a focus on consistency both on the server-side and client-side. |
| 82 |
* Standardized data throughout the server-side and client-side. |
| 83 |
* More consistent behavior in the Customizer, but also when editing posts or in the frontend. |
| 84 |
* Fixed inconsistencies in block editor and classic editor integration. |
| 85 |
* Styling fixes for the Customizer controls. |
| 86 |
* Behavior fixes and improvements for Customizer controls, with a big focus on font controls. |
| 87 |
* Fixed custom background control. |
| 88 |
* Improved web font handling. |
| 89 |
* Updated the Google Fonts list. |
| 90 |
* Enhanced configuration capabilities for font field type CSS selectors (ability to specify allowed CSS properties per selector). |
| 91 |
* Removed 'typography' field type with automatic conversion to the new 'font' field type. |
| 92 |
* Minor fixes for the Style Manager behavior. |
| 93 |
* Tested with the latest WordPress version (v5.4). |
| 94 |
* Increased minimum required PHP version to 5.4. |
| 95 |
|
| 96 |
= 2.6.0 = |
| 97 |
* Fixes related to cache invalidation. |
| 98 |
* Improvements to Font Palettes. |
| 99 |
* Fixes for missing Customizer theme controls. |
| 100 |
|
| 101 |
= 2.5.9 = |
| 102 |
* Fixes Style Presets preview display |
| 103 |
* Fixes Color Palettes integration with Gutenberg |
| 104 |
* Improve display of radio and range controls in Customizer |
| 105 |
|
| 106 |
= 2.5.8 = |
| 107 |
* Styling fixes for Color Palettes. |
| 108 |
* Added reset font logic for better default font palettes. |
| 109 |
* Fixes for Font Palettes font weights. |
| 110 |
|
| 111 |
= 2.5.7 = |
| 112 |
* Styling fixes for the Font control. |
| 113 |
* Bug fixes for the Font control. |
| 114 |
* Added RTL stylesheets. |
| 115 |
|
| 116 |
= 2.5.6 = |
| 117 |
* Improved styling for the Font control. |
| 118 |
* Improved handling of minimal required PHP version. |
| 119 |
* Cleanup stylesheets and scripts for better performance and easier maintenance. |
| 120 |
* Updated Google Fonts list to include the latest additions. |
| 121 |
* Compatibility with WordPress 5.3.0. |
| 122 |
|
| 123 |
= 2.5.5 = |
| 124 |
* Fixed an issue with the default font weight for the Typography field. |
| 125 |
* Improved range field behavior when writing directly in the numerical field. |
| 126 |
* Fixed inconsistency on switch theme with the Style Manager coloration level, diversity and shuffle controls. |
| 127 |
|
| 128 |
= 2.5.4 = |
| 129 |
* Improved default font palettes configuration. |
| 130 |
|
| 131 |
= 2.5.3 = |
| 132 |
* Fixed as series of issues with Font Palettes in Style Manager. |
| 133 |
* Improved the Color Palettes. |
| 134 |
* Fixes a series of edge-cases in the Customizer. |
| 135 |
|
| 136 |
= 2.5.2 = |
| 137 |
* Improved the predictability and resilience of the Style Manager controls. |
| 138 |
|
| 139 |
= 2.5.1 = |
| 140 |
* Styling improvements to the Style Manager controls. |
| 141 |
* Fixed a strange bug that would result in a fatal error upon activation. |
| 142 |
|
| 143 |
= 2.5.0 = |
| 144 |
* JavaScript cleanup and performance enhancements |
| 145 |
* Fixed some bugs with the Style Manager. |
| 146 |
* Fixed some rare bugs with the plugin config merge. |
| 147 |
|
| 148 |
= 2.4.0 = |
| 149 |
* Big performance enhancements related to how customization settings and configurations get loaded. |
| 150 |
* Fixed a nasty regression that caused customization settings saved in a option to not be loaded, causing styles to be missing. |
| 151 |
* Pretty important code refactoring and cleanup to make things more predictable and stable. |
| 152 |
|
| 153 |
= 2.3.5.1 = |
| 154 |
* Minor configuration fix. |
| 155 |
|
| 156 |
= 2.3.5 = |
| 157 |
* Minor refactoring. |
| 158 |
* Fixed issues where customization values were not stored properly. |
| 159 |
|
| 160 |
= 2.3.4 = |
| 161 |
* Fixed warnings that were appearing when PHP has version 7.2.0+. |
| 162 |
|
| 163 |
= 2.3.3 = |
| 164 |
* Fixed Google Fonts not working in the new block editor (Gutenberg). |
| 165 |
|
| 166 |
= 2.3.2 = |
| 167 |
* Fixed the fact that Customizer style changes were not reflected in the live preview. A problem introduced in the previous update. |
| 168 |
|
| 169 |
= 2.3.1 = |
| 170 |
* Fixed some warnings that appeared in certain situations. |
| 171 |
|
| 172 |
= 2.3.0 = |
| 173 |
* Improved support for the new **Gutenberg block editor.** Compatible with the latest WordPress 5.0 beta version. |
| 174 |
* Big **performance improvements** both in the frontend and also in the Customizer. |
| 175 |
* Cleanup regarding old and deprecated features. |
| 176 |
|
| 177 |
= 2.2.0 = |
| 178 |
* Added support for the new **Gutenberg block editor.** |
| 179 |
|
| 180 |
= 2.1.3 = |
| 181 |
* Improve Customizer section grouping in the Theme Options Panel |
| 182 |
* Fix Font Palettes giving huge sizes to font options set in ems |
| 183 |
|
| 184 |
= 2.1.2 = |
| 185 |
* Avoid short array syntax to ensure PHP 5.2 compatibility |
| 186 |
|
| 187 |
= 2.1.1 = |
| 188 |
* Hide the Fonts section for themes that do not declare support for Font Palettes |
| 189 |
|
| 190 |
= 2.1.0 = |
| 191 |
* This new version of Customify lets you conveniently change the design of your site with font palettes. Easy as pie. |
| 192 |
* Added previews for color palette filters. |
| 193 |
|
| 194 |
= 2.0.2 = |
| 195 |
* Fixed bug where no CSS was output for some settings with default value. |
| 196 |
|
| 197 |
= 2.0.1 = |
| 198 |
* Minor fix for the color pickers. |
| 199 |
|
| 200 |
= 2.0.0 = |
| 201 |
* Added the much improved and overall awesome **Color Palettes v2.0 styling system** (all modesty aside). |
| 202 |
* Minor improvements that are secondary to the one above. Enjoy. |
| 203 |
|
| 204 |
= 1.9.1 = |
| 205 |
* Fixed the Customizer JS crash due to wrong merge. |
| 206 |
|
| 207 |
= 1.9.0 = |
| 208 |
* Added ability to modify existing Customizer panels, sections, controls |
| 209 |
* Added system for admin notifications |
| 210 |
* Overall enhancements for more performance and stability |
| 211 |
|
| 212 |
= 1.8.0 = |
| 213 |
* Added altered state for colors in the current color palette when any of the controls connected to the color has been modified |
| 214 |
* Added the colors from the current palette to all the color pickers in the Theme Options section |
| 215 |
* Fixed bug where default values were being forced in Customizer Preview at first load |
| 216 |
* Fixed bug preventing CSS output for color controls in the Style Manager section of the Customizer |
| 217 |
|
| 218 |
= 1.7.4 = |
| 219 |
* Reorganized Customizer custom sections and grouped them into Theme Options, thus making the Style Manager panel stand out. |
| 220 |
* Refactored parts for more performance and clarity. |
| 221 |
|
| 222 |
= 1.7.3 = |
| 223 |
* Added HEX field for colors in the current Color Palette |
| 224 |
* Updated Google Webfonts list |
| 225 |
|
| 226 |
= 1.7.2 = |
| 227 |
* Fixed issue with **Color Palettes** working only after choosing one variation |
| 228 |
* Fixed bug preventing some options to live update the Customizer preview |
| 229 |
|
| 230 |
= 1.7.1 = |
| 231 |
* Fixed issue with **Color Palettes** overwriting custom colors in Live Preview |
| 232 |
|
| 233 |
= 1.7.0 = |
| 234 |
* Added **Dynamic Color Palettes** for a smoother experience |
| 235 |
* Fixed issue with the Style Manager crashing the Customizer when not using a theme with support for it. |
| 236 |
|
| 237 |
= 1.6.5 = |
| 238 |
* Added **Color Palettes Variations** to the Style Manager Customizer section |
| 239 |
* Improved Color Palettes logic to better handle differences between various color palettes |
| 240 |
* Improved master color connected fields logic to allow for a smoother experience |
| 241 |
* Updated Google Fonts list |
| 242 |
* Fixed some issues with the connected fields logic |
| 243 |
* Fixed some Customizer preview scaling issues |
| 244 |
* Fixed a potential bug with the options' CSS config (multiple configs with the same property but with different selectors) |
| 245 |
|
| 246 |
= 1.6.0 = |
| 247 |
* Added **Style Manager** Customizer section with theme supports logic |
| 248 |
* Added connected fields logic for easy chaining of Customizer controls |
| 249 |
* Fixed a couple of styling inconsistencies regarding the Customizer |
| 250 |
|
| 251 |
= 1.5.7 = |
| 252 |
* Improved development logic for easier testing |
| 253 |
* Improved and fixed reset settings buttons |
| 254 |
* Fixed a couple of styling inconsistencies regarding the Customizer |
| 255 |
|
| 256 |
= 1.5.6 = |
| 257 |
* New Fields Styling Improvements |
| 258 |
|
| 259 |
= 1.5.5 = |
| 260 |
* Added Compatibility with WordPress 4.9 |
| 261 |
|
| 262 |
= 1.5.4 = |
| 263 |
* Allow 0 values for fonts line-height and letter-spacing |
| 264 |
* Improved the plugin loading process and the CSS inline output |
| 265 |
* Fixed small style issues for the Customizer bar |
| 266 |
|
| 267 |
= 1.5.3 = |
| 268 |
* Update Style for WordPress 4.8 |
| 269 |
* Updated Google Fonts list |
| 270 |
* Fixed the double output of the custom CSS |
| 271 |
* Fixed Menu Add Button overlap |
| 272 |
|
| 273 |
= 1.5.2 = |
| 274 |
* Fixed Background field output |
| 275 |
* Fixed Font's preview in wp-editor |
| 276 |
* Added Reset Theme Mods tool |
| 277 |
|
| 278 |
= 1.5.1 = |
| 279 |
* Added support for `active_callback` argument for customizer controls |
| 280 |
* Customizer assets refactor |
| 281 |
|
| 282 |
= 1.5.0 = |
| 283 |
* Plugin core refactored for a better performance |
| 284 |
* Fixed Font Weight saving |
| 285 |
* Fixed Font Subset saving |
| 286 |
* Fix Select2 enqueue_script |
| 287 |
|
| 288 |
= 1.4.2 = |
| 289 |
* Improved Font style output in front-end. Now is just one style element with all the fonts inside. |
| 290 |
* Improved Fonts panels, now only one can be opened to avoid confusion |
| 291 |
* Fixed Presets with fonts |
| 292 |
* Fixed Google Fonts with italic weights |
| 293 |
* Fixed Range input field |
| 294 |
* Small Fixes |
| 295 |
|
| 296 |
= 1.4.1 = |
| 297 |
* Fixed Multiple local fonts |
| 298 |
|
| 299 |
= 1.4.0 = |
| 300 |
* Make Customify compatible with the [4.7 customizer changes](https://make.wordpress.org/core/2016/10/12/customize-changesets-technical-design-decisions) |
| 301 |
* Add `show_if` [config option](https://github.com/pixelgrade/customify#conditional-fields) |
| 302 |
* Fix Conflict with Jetpack - Related posts |
| 303 |
* Fix Javascript callbacks loss |
| 304 |
* Switch de default storage from option to theme_mod |
| 305 |
* Fixed Incorrect Color Panel Height |
| 306 |
* Fixed Font field weight in customizer preview |
| 307 |
|
| 308 |
= 1.3.1 = |
| 309 |
* Fixed compatibility with PHP <= 5.3.x |
| 310 |
|
| 311 |
= 1.3.0 = |
| 312 |
* Added the new and awesome `font` selector |
| 313 |
* The live CSS editor is now removed for 4.7, but don't worry, your style will be imported into the new [CSS Editor](https://make.wordpress.org/core/2016/11/26/extending-the-custom-css-editor/) |
| 314 |
* Added compatibility with 4.7 |
| 315 |
|
| 316 |
= 1.2.7 = |
| 317 |
* Added capability to control the Jetpack Sharing default options |
| 318 |
|
| 319 |
= 1.2.6 = |
| 320 |
* Added capability to define Jetpack default and hidden modules |
| 321 |
|
| 322 |
= 1.2.5 = |
| 323 |
* Fixed WordPress 4.7 incompatibilities |
| 324 |
|
| 325 |
= 1.2.4 = |
| 326 |
* Added: Support for Fonto plugin |
| 327 |
* Improved the font selector |
| 328 |
* Fixed presets on ssl |
| 329 |
|
| 330 |
= 1.2.3 = |
| 331 |
* Added: Support for conditional fields display |
| 332 |
* Fixed weights for local fonts |
| 333 |
* Fixed Ace editor warnings |
| 334 |
* Fixed some rare PHP warnings |
| 335 |
|
| 336 |
= 1.2.2 = |
| 337 |
* Added: Customizer styling |
| 338 |
* Fixed some rare warnings with google fonts |
| 339 |
|
| 340 |
= 1.2.1 = |
| 341 |
* Improve default fonts parse, and fix some legacy cases |
| 342 |
* Remove google api code when google fonts is disabled |
| 343 |
|
| 344 |
= 1.2.0 = |
| 345 |
* Added: Compatibility with WordPress 4.4.0 |
| 346 |
* Added: Presets can now set fonts and font weights |
| 347 |
* Fixed: Now range fields can have `0` as default |
| 348 |
* Fixed: Font subsets style |
| 349 |
* Fixed: Fixed some PHP and javascript warnings |
| 350 |
* Updated: Font field style |
| 351 |
|
| 352 |
= 1.1.7 = |
| 353 |
* Added: Compatibility with WordPress 4.3.1 |
| 354 |
* Added: Custom fonts can be used now as defaults |
| 355 |
* Fixed: Fonts preview |
| 356 |
* Fixed: Some rare errors with PHP 5.2.x |
| 357 |
* Fixed: Some font variants warnings with PHP 5.2.x |
| 358 |
|
| 359 |
= 1.1.6 = |
| 360 |
* Added: Custom background field with bacgkround-* css properties selects |
| 361 |
* Added: Compatibility with WordPress 4.3.x |
| 362 |
* Added: Compatibility with PHP 5.2.x |
| 363 |
* Improved: Live CSS Editor is now live...for real |
| 364 |
* Updated: ACE Editor |
| 365 |
* Updated: The list of google fonts is now up to date |
| 366 |
|
| 367 |
|
| 368 |
= 1.1.5 = |
| 369 |
* Added: Live-preview support for `text` and `textarea` fields. |
| 370 |
* Added: **Unit** parameter for css values(now we can use all the css units like em, rem, vh, all of them :D). |
| 371 |
* Fixed: Editor style for Typekit fonts. |
| 372 |
* Fixed: Editor style with default values. |
| 373 |
* Fixed: Live Preview small fixes |
| 374 |
* Updated: The list of google fonts is now up to date |
| 375 |
|
| 376 |
= 1.1.4 = |
| 377 |
* Added: Ace Editor field. |
| 378 |
* Added: HTML field. |
| 379 |
* Added: Sanitize callbacks parameter and a default sanitizer for the checkbox field. |
| 380 |
* Fixed: Slight styling issues. |
| 381 |
|
| 382 |
= 1.1.2 = |
| 383 |
* Added: Option to add Customify's changes in the editor. |
| 384 |
* Added: Possibility to load Typekit fonts through config. |
| 385 |
|
| 386 |
= 1.1.1 = |
| 387 |
* Added: Radio input with image label. |
| 388 |
* Added: Javascript callback for css properties. |
| 389 |
* Update: Updated Ace editor. |
| 390 |
|
| 391 |
= 1.1.0 = |
| 392 |
* Added: [Preset](https://github.com/pixelgrade/customify/blob/master/README.md#presets_title) field type. |
| 393 |
* Added: Reset buttons (disabled by default). |
| 394 |
* Added: Button field. |
| 395 |
|
| 396 |
== Installation == |
| 397 |
|
| 398 |
1. Install Customify either via the WordPress.org plugin directory, or by uploading the files to your `/wp-content/plugins/` directory |
| 399 |
2. After activating Customify go to `Appearance → Customize` and have fun with the new felds |
| 400 |
3. For further instructions and how to setup your own fields, read our [detailed documentation](http://github.com/pixelgrade/customify/blob/dev/README.md) |
| 401 |
|
| 402 |
== Frequently Asked Questions == |
| 403 |
|
| 404 |
= Is there a way to reset Customify to defaults? = |
| 405 |
Reset buttons are available for all the options or for individual sections or panels. |
| 406 |
They are disabled by default to avoid useless/accidental resets. |
| 407 |
To enable them simply go to Dashboard -> Settings -> Customify and check "Enable Reset Buttons" |
| 408 |
|
