readme.txt

=== Customify - Intuitive Website Styling ===
Contributors: pixelgrade, vlad.olaru, babbardel, razvanonofrei, gorby31
Tags: design, customizer, fonts, colors, gutenberg, font palettes, color palettes
Requires at least: 4.9.14
Tested up to: 5.9.5
Stable tag: 2.10.5
Requires PHP: 5.6.40
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Customify is a theme Customizer booster to easily customize Fonts, Colors, and other options for a certain WordPress theme.

== Description ==

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.

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.

**Made with care by Pixelgrade**

== Credits ==

* [Select2](https://select2.github.io) JavaScript library - License: MIT
* [CSSOM.js](https://github.com/NV/CSSOM) JavaScript library - License: MIT
* [Ace Editor](https://ace.c9.io/) JavaScript editor - License: BSD
* [jQuery React](https://github.com/natedavisolds/jquery-react) JavaScript jQuery plugin - License: MIT
* [Web Font Loader](https://github.com/typekit/webfontloader) JavaScript library - License: Apache 2.0
* [Fuse.js](http://fusejs.io) Lightweight fuzzy-search JavaScript library - License: Apache 2.0
* Default [image](https://unsplash.com/photos/OgM4RKdr2kY) for Style Manager Color Palette control - License: [Unsplash](https://unsplash.com/license)

== Changelog ==

= 2.10.5 =
* Security fixes.

= 2.10.4 =
* Tested with the latest WordPress version.
* Better handling of third-party provided fonts.
* Provide the pixelgrade_option() getter for better compatibility.

= 2.10.3 =
* Avoid invisible text failure in the Customizer Preview when all webfonts fail to load.
* Better missing font-variants handling.
* Update the Google Webfonts list.

= 2.10.2 =
* Improve Font Palettes behavior for a fresh installation (no Font Palette selected).

= 2.10.1 =
* Fix live preview for the advanced Dark Mode control introduced in 2.10.0

= 2.10.0 =
* Add an enhanced version of the Dark Mode control that can be enabled by themes.

= 2.9.2 =
* Fix compatibility with WordPress 5.5.
* Styling fixes and improvements.

= 2.9.1 =
* Fixes errors with Google Fonts in some instances.

= 2.9.0 =
* **Feature:** Introduces the ability to easily **search through all Customizer settings, menus, and widgets**
* **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
* **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
* **Improvement:** Use the swap font-display technique for better performance and PageSpeed score
* Updates the Google Fonts list
* Switches to using the Google Fonts CSS API V2 instead of the previous V1
* Removes the font subsets control since it is no longer needed; the needed (and available) subsets will be loaded automatically by the browser

= 2.8.0 =
* **Improvement:** **Better font palettes logic** for even more accurate site typography
* **Improvement:** All fonts now have **fallback font stacks** added for the font family CSS property
* **Improvement:** Made it much easier to use system fonts instead or beside web fonts
* **Improvement:** Allow font palettes to provide font stacks instead of a single font family
* Fix inconsistencies between fonts behavior in the Customizer preview and site frontend
* Properly sanitize font family names before using them in CSS
* Convert inconsistent font variants to standard values (regular, normal, bold)
* Handle both numerical and string font variant values
* Fix missing fonts loaded class and JavaScript event when no web fonts used
* Fix backward compatibility with WordPress 4.9.14

= 2.7.3 =
* Fixes for some edge situations when fonts would not apply on the frontend, after some time. Mainly related to cache issues.
* Fix for missing font fields CSS properties.
* Fix compatibility with the The Events Calendar plugin.

= 2.7.2 =
* Better handle legacy font values upon upgrade.

= 2.7.1 =
* Fixed a couple of inconsistencies related to cache invalidation
* Added integrations for the main caching plugins to prevent them minifying or moving the Web Font Loader script

= 2.7.0 =
* Overall performance improvements, especially on the client-side (JavaScript).
* Overall logic cleanup with a focus on consistency both on the server-side and client-side.
* Standardized data throughout the server-side and client-side.
* More consistent behavior in the Customizer, but also when editing posts or in the frontend.
* Fixed inconsistencies in block editor and classic editor integration.
* Styling fixes for the Customizer controls.
* Behavior fixes and improvements for Customizer controls, with a big focus on font controls.
* Fixed custom background control.
* Improved web font handling.
* Updated the Google Fonts list.
* Enhanced configuration capabilities for font field type CSS selectors (ability to specify allowed CSS properties per selector).
* Removed 'typography' field type with automatic conversion to the new 'font' field type.
* Minor fixes for the Style Manager behavior.
* Tested with the latest WordPress version (v5.4).
* Increased minimum required PHP version to 5.4.

= 2.6.0 =
* Fixes related to cache invalidation.
* Improvements to Font Palettes.
* Fixes for missing Customizer theme controls.

= 2.5.9 =
* Fixes Style Presets preview display
* Fixes Color Palettes integration with Gutenberg
* Improve display of radio and range controls in Customizer

= 2.5.8 =
* Styling fixes for Color Palettes.
* Added reset font logic for better default font palettes.
* Fixes for Font Palettes font weights.

= 2.5.7 =
* Styling fixes for the Font control.
* Bug fixes for the Font control.
* Added RTL stylesheets.

= 2.5.6 =
* Improved styling for the Font control.
* Improved handling of minimal required PHP version.
* Cleanup stylesheets and scripts for better performance and easier maintenance.
* Updated Google Fonts list to include the latest additions.
* Compatibility with WordPress 5.3.0.

= 2.5.5 =
* Fixed an issue with the default font weight for the Typography field.
* Improved range field behavior when writing directly in the numerical field.
* Fixed inconsistency on switch theme with the Style Manager coloration level, diversity and shuffle controls.

= 2.5.4 =
* Improved default font palettes configuration.

= 2.5.3 =
* Fixed as series of issues with Font Palettes in Style Manager.
* Improved the Color Palettes.
* Fixes a series of edge-cases in the Customizer.

= 2.5.2 =
* Improved the predictability and resilience of the Style Manager controls.

= 2.5.1 =
* Styling improvements to the Style Manager controls.
* Fixed a strange bug that would result in a fatal error upon activation.

= 2.5.0 =
* JavaScript cleanup and performance enhancements
* Fixed some bugs with the Style Manager.
* Fixed some rare bugs with the plugin config merge.

= 2.4.0 =
* Big performance enhancements related to how customization settings and configurations get loaded.
* Fixed a nasty regression that caused customization settings saved in a option to not be loaded, causing styles to be missing.
* Pretty important code refactoring and cleanup to make things more predictable and stable.

= 2.3.5.1 =
* Minor configuration fix.

= 2.3.5 =
* Minor refactoring.
* Fixed issues where customization values were not stored properly.

= 2.3.4 =
* Fixed warnings that were appearing when PHP has version 7.2.0+.

= 2.3.3 =
* Fixed Google Fonts not working in the new block editor (Gutenberg).

= 2.3.2 =
* Fixed the fact that Customizer style changes were not reflected in the live preview. A problem introduced in the previous update.

= 2.3.1 =
* Fixed some warnings that appeared in certain situations.

= 2.3.0 =
* Improved support for the new **Gutenberg block editor.** Compatible with the latest WordPress 5.0 beta version.
* Big **performance improvements** both in the frontend and also in the Customizer.
* Cleanup regarding old and deprecated features.

= 2.2.0 =
* Added support for the new **Gutenberg block editor.**

= 2.1.3 =
* Improve Customizer section grouping in the Theme Options Panel
* Fix Font Palettes giving huge sizes to font options set in ems

= 2.1.2 =
* Avoid short array syntax to ensure PHP 5.2 compatibility

= 2.1.1 =
* Hide the Fonts section for themes that do not declare support for Font Palettes

= 2.1.0 =
* This new version of Customify lets you conveniently change the design of your site with font palettes. Easy as pie.
* Added previews for color palette filters.

= 2.0.2 =
* Fixed bug where no CSS was output for some settings with default value.

= 2.0.1 =
* Minor fix for the color pickers.

= 2.0.0 =
* Added the much improved and overall awesome **Color Palettes v2.0 styling system** (all modesty aside).
* Minor improvements that are secondary to the one above. Enjoy.

= 1.9.1 =
* Fixed the Customizer JS crash due to wrong merge.

= 1.9.0 =
* Added ability to modify existing Customizer panels, sections, controls
* Added system for admin notifications
* Overall enhancements for more performance and stability

= 1.8.0 =
* Added altered state for colors in the current color palette when any of the controls connected to the color has been modified
* Added the colors from the current palette to all the color pickers in the Theme Options section
* Fixed bug where default values were being forced in Customizer Preview at first load
* Fixed bug preventing CSS output for color controls in the Style Manager section of the Customizer

= 1.7.4 =
* Reorganized Customizer custom sections and grouped them into Theme Options, thus making the Style Manager panel stand out.
* Refactored parts for more performance and clarity.

= 1.7.3 =
* Added HEX field for colors in the current Color Palette
* Updated Google Webfonts list

= 1.7.2 =
* Fixed issue with **Color Palettes** working only after choosing one variation
* Fixed bug preventing some options to live update the Customizer preview

= 1.7.1 =
* Fixed issue with **Color Palettes** overwriting custom colors in Live Preview

= 1.7.0 =
* Added **Dynamic Color Palettes** for a smoother experience
* Fixed issue with the Style Manager crashing the Customizer when not using a theme with support for it.

= 1.6.5 =
* Added **Color Palettes Variations** to the Style Manager Customizer section
* Improved Color Palettes logic to better handle differences between various color palettes
* Improved master color connected fields logic to allow for a smoother experience
* Updated Google Fonts list
* Fixed some issues with the connected fields logic
* Fixed some Customizer preview scaling issues
* Fixed a potential bug with the options' CSS config (multiple configs with the same property but with different selectors)

= 1.6.0 =
* Added **Style Manager** Customizer section with theme supports logic
* Added connected fields logic for easy chaining of Customizer controls
* Fixed a couple of styling inconsistencies regarding the Customizer

= 1.5.7 =
* Improved development logic for easier testing
* Improved and fixed reset settings buttons
* Fixed a couple of styling inconsistencies regarding the Customizer

= 1.5.6 =
* New Fields Styling Improvements

= 1.5.5 =
* Added Compatibility with WordPress 4.9

= 1.5.4 =
* Allow 0 values for fonts line-height and letter-spacing
* Improved the plugin loading process and the CSS inline output
* Fixed small style issues for the Customizer bar

= 1.5.3 =
* Update Style for WordPress 4.8
* Updated Google Fonts list
* Fixed the double output of the custom CSS
* Fixed Menu Add Button overlap

= 1.5.2 =
* Fixed Background field output
* Fixed Font's preview in wp-editor
* Added Reset Theme Mods tool

= 1.5.1 =
* Added support for `active_callback` argument for customizer controls
* Customizer assets refactor

= 1.5.0 =
* Plugin core refactored for a better performance
* Fixed Font Weight saving
* Fixed Font Subset saving
* Fix Select2 enqueue_script

= 1.4.2 =
* Improved Font style output in front-end. Now is just one style element with all the fonts inside.
* Improved Fonts panels, now only one can be opened to avoid confusion
* Fixed Presets with fonts
* Fixed Google Fonts with italic weights
* Fixed Range input field
* Small Fixes

= 1.4.1 =
* Fixed Multiple local fonts

= 1.4.0 =
* Make Customify compatible with the [4.7 customizer changes](https://make.wordpress.org/core/2016/10/12/customize-changesets-technical-design-decisions)
* Add `show_if` [config option](https://github.com/pixelgrade/customify#conditional-fields)
* Fix Conflict with Jetpack - Related posts
* Fix Javascript callbacks loss
* Switch de default storage from option to theme_mod
* Fixed Incorrect Color Panel Height
* Fixed Font field weight in customizer preview

= 1.3.1 =
* Fixed compatibility with PHP <= 5.3.x

= 1.3.0 =
* Added the new and awesome `font` selector
* 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/)
* Added compatibility with 4.7

= 1.2.7 =
* Added capability to control the Jetpack Sharing default options

= 1.2.6 =
* Added capability to define Jetpack default and hidden modules

= 1.2.5 =
* Fixed WordPress 4.7 incompatibilities

= 1.2.4 =
* Added: Support for Fonto plugin
* Improved the font selector
* Fixed presets on ssl

= 1.2.3 =
* Added: Support for conditional fields display
* Fixed weights for local fonts
* Fixed Ace editor warnings
* Fixed some rare PHP warnings

= 1.2.2 =
* Added: Customizer styling
* Fixed some rare warnings with google fonts

= 1.2.1 =
* Improve default fonts parse, and fix some legacy cases
* Remove google api code when google fonts is disabled

= 1.2.0 =
* Added: Compatibility with WordPress 4.4.0
* Added: Presets can now set fonts and font weights
* Fixed: Now range fields can have `0` as default
* Fixed: Font subsets style
* Fixed: Fixed some PHP and javascript warnings
* Updated: Font field style

= 1.1.7 =
* Added: Compatibility with WordPress 4.3.1
* Added: Custom fonts can be used now as defaults
* Fixed: Fonts preview
* Fixed: Some rare errors with PHP 5.2.x
* Fixed: Some font variants warnings with PHP 5.2.x

= 1.1.6 =
* Added: Custom background field with bacgkround-* css properties selects
* Added: Compatibility with WordPress 4.3.x
* Added: Compatibility with PHP 5.2.x
* Improved: Live CSS Editor is now live...for real
* Updated: ACE Editor
* Updated: The list of google fonts is now up to date


= 1.1.5 =
* Added: Live-preview support for `text` and `textarea` fields.
* Added: **Unit** parameter for css values(now we can use all the css units like em, rem, vh, all of them :D).
* Fixed: Editor style for Typekit fonts.
* Fixed: Editor style with default values.
* Fixed: Live Preview small fixes
* Updated: The list of google fonts is now up to date

= 1.1.4 =
* Added: Ace Editor field.
* Added: HTML field.
* Added: Sanitize callbacks parameter and a default sanitizer for the checkbox field.
* Fixed: Slight styling issues.

= 1.1.2 =
* Added: Option to add Customify's changes in the editor.
* Added: Possibility to load Typekit fonts through config.

= 1.1.1 =
* Added: Radio input with image label.
* Added: Javascript callback for css properties.
* Update: Updated Ace editor.

= 1.1.0 =
* Added: [Preset](https://github.com/pixelgrade/customify/blob/master/README.md#presets_title) field type.
* Added: Reset buttons (disabled by default).
* Added: Button field.

== Installation ==

1. Install Customify either via the WordPress.org plugin directory, or by uploading the files to your `/wp-content/plugins/` directory
2. After activating Customify go to `Appearance → Customize` and have fun with the new felds
3. For further instructions and how to setup your own fields, read our [detailed documentation](http://github.com/pixelgrade/customify/blob/dev/README.md)

== Frequently Asked Questions ==

= Is there a way to reset Customify to defaults? =
Reset buttons are available for all the options or for individual sections or panels.
They are disabled by default to avoid useless/accidental resets.
To enable them simply go to Dashboard -> Settings -> Customify and check "Enable Reset Buttons"