-
Notifications
You must be signed in to change notification settings - Fork 5
/
readme.txt
423 lines (331 loc) · 16.4 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
=== 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"