Scott Taylor
ef6315a7a2
After [32656], add @access annotations to methods that have no doc block in wp-includes/*.
...
Makes it easier to search for no doc blocks via `}[\n\t\r ]+(protected|private|public)`.
See #32444 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32657 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-29 21:36:38 +00:00
Scott Taylor
c8a44d437a
Add @static* annotations where they are missing.
...
Initialize all static vars that are not, most to `null`.
See #32444 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32650 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-29 15:42:40 +00:00
Scott Taylor
39ef6a72c5
Use void instead of null where appropriate when pipe-delimiting @return types. If a @return only contains void, remove it.
...
See #32444 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32568 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-24 05:39:47 +00:00
Scott Taylor
febd12c957
Clean up @global doc blocks/imports for class-wp-customizer-*.php and friends.
...
See #32444 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32542 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-22 05:05:19 +00:00
Scott Taylor
9333337992
In class-wp-customize-*, clarify/add some @param/@return blocks. Disambiguate some functions that are trying to return the void response of another function they call internally.
...
See #32444 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32535 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-21 22:04:29 +00:00
Sergey Biryukov
5af9ac0ea2
Customizer: Use a semantic, accessible element for Remove Header Image button.
...
Make the button more noticeable on dark, light, and busy images.
props afercia, RDall, melchoyce.
fixes #32227 , #31325 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32382 602fd350-edb4-49c9-b593-d223f7449a82
2015-05-06 10:53:07 +00:00
Dominik Schilling (ocean90)
f029572866
Theme Switcher: Provide an easier way to reset back to the current active theme.
...
* Add control for the active theme when doing a theme preview
* Highlight an active theme and move it to the top
props valendesigns, ocean90.
fixes #32002 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32265 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-22 16:15:01 +00:00
Dominik Schilling (ocean90)
7fba67e4b7
Customizer: Escape theme preview URLs.
...
props johnbillion, ocean90.
see #31896 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32134 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-15 16:32:03 +00:00
Dominik Schilling (ocean90)
e9196a321a
Customizer Theme Switcher: Lazy load theme screenshots.
...
props westonruter, ocean90.
fixes #31793 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32088 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-08 20:51:39 +00:00
Dominik Schilling (ocean90)
379393651b
Customizer Theme Switcher: Fix preview URL for subfolder installs.
...
Use `$_SERVER['HTTP_HOST']` and `$_SERVER['REQUEST_URI']` instead of `site_url()` and `$_SERVER['REQUEST_URI']`.
fixes #31896 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32086 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-08 18:58:08 +00:00
Drew Jaynes
88ccda8ae8
Add documentation for the $type and $theme properties in WP_Customize_Theme_Control.
...
Also add some missing `@access` tags to various DocBlocks.
See [31533]. See #31888 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32028 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-05 14:52:28 +00:00
Drew Jaynes
1463a2c88c
Add documentation for the $type, $mime_type, and $button_labels properties in WP_Customize_Media_Control.
...
See [31698]. See #31888 .
git-svn-id: https://develop.svn.wordpress.org/trunk@32023 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-04 23:04:51 +00:00
Dominik Schilling (ocean90)
f6e4d76e5b
Customizer Theme Switcher: Update JavaScript template after [31975].
...
see #31289 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31976 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-01 23:05:41 +00:00
Dominik Schilling (ocean90)
365ed7a6cb
Customizer Theme Switcher: Remove "Add New" references.
...
The current iteration takes you out of the customizer context, which isn't great UX and doesn't really fit into the flows targeted by this particular UI.
fixes #31837 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31968 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-01 19:49:41 +00:00
Dominik Schilling (ocean90)
b194676876
Customizer Theme Switcher: Switch the details/live preview buttons.
...
props celloexpressions, ocean90.
fixes #31791 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31954 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-01 12:35:26 +00:00
Dominik Schilling (ocean90)
8f1a04d2fb
Customizer Theme Switcher: Fix invalid HTML markup when New Theme control is added.
...
see #31203 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31950 602fd350-edb4-49c9-b593-d223f7449a82
2015-04-01 11:34:23 +00:00
ocean90
c0104d6cc2
Customizer: Revert [31911]. We want to preserve url and return URL parameters to make the experience smoother.
...
see #31782 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31933 602fd350-edb4-49c9-b593-d223f7449a82
2015-03-30 19:21:01 +00:00
Dominik Schilling (ocean90)
e054f53d9e
Customizer: Use proper preview URL for Live Preview links.
...
props mattwiebe.
fixes #31782 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31911 602fd350-edb4-49c9-b593-d223f7449a82
2015-03-27 20:35:26 +00:00
Dominik Schilling (ocean90)
4b3cc5c55e
Improve newly added strings for i18n:
...
* Use a placeholder for the theme name to be able to reorder words.
* Uppercase D for "Theme Details" to match existing strings.
* Merge two revision date formats.
* Add translator comment to strings with placeholders.
props obenland.
see #31776 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31905 602fd350-edb4-49c9-b593-d223f7449a82
2015-03-26 20:55:34 +00:00
Dominik Schilling (ocean90)
179a1b7a4c
Customizer: Introduce WP_Customize_Media_Control.
...
`WP_Customize_Media_Control` is a new base class for all Customizer media controls. If used directly it supports the ID of an attachment instead of an URL like `WP_Customize_Upload_Control`.
props celloexpressions.
fixes #29215 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31698 602fd350-edb4-49c9-b593-d223f7449a82
2015-03-10 18:01:42 +00:00
Dominik Schilling (ocean90)
305a44617c
Customizer: Add audio/video previews for upload controls.
...
props celloexpressions, Fab1en, wonderboymusic.
fixes #30850 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31661 602fd350-edb4-49c9-b593-d223f7449a82
2015-03-07 11:05:57 +00:00
Drew Jaynes
575c60ac39
Add a missing file header and clean up class DocBlocks in wp-includes/class-wp-customize-control.php.
...
* Adds a file header separate from the `WP_Customize_Control` class block
* Fixes formatting for the `WP_Customize_Control`, `WP_Customize_Color_Control`, `WP_Customize_Upload_Control`, `WP_Customize_Image_Control`, `WP_Customize_Background_Image_Control`, `WP_Customize_Theme_Control`, `WP_Customize_New_Theme_Control`, `WP_Widget_Area_Customize_Control`, and `WP_Widget_Form_Customize_Control` class DocBlocks.
* Adds a missing class DocBlock for `WP_Customize_Header_Image_Control`
See #31446 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31539 602fd350-edb4-49c9-b593-d223f7449a82
2015-02-25 07:55:55 +00:00
Mark Jaquith
f1bb5c2fd7
Add theme browsing and theme switching to the Customizer
...
* Brings into core the Customizer Theme Switcher feature plugin
* You can now browse, preview, and activate themes right from the Customizer
fixes #31303 .
props celloexpressions, afercia, westonruter, folletto, designsimply
git-svn-id: https://develop.svn.wordpress.org/trunk@31533 602fd350-edb4-49c9-b593-d223f7449a82
2015-02-24 20:30:22 +00:00
Scott Taylor
85595b73cc
Overriding methods should do more than simply call the same method in the super class.
...
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31101 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-08 21:19:24 +00:00
Scott Taylor
101e00314d
In Customizer classes:
...
* `public final function` methods should be `final public function` - confusing Hack and aligns with PSR2
* Some methods were missing access modifiers
See #30799 .
git-svn-id: https://develop.svn.wordpress.org/trunk@31083 602fd350-edb4-49c9-b593-d223f7449a82
2015-01-08 06:01:08 +00:00
Dominik Schilling (ocean90)
c05e46e4d1
Customizer: Improve IE 8 compatibility.
...
* Use square bracket notation for `default` keywords.
* Use Underscores `indexOf` for arrays.
props westonruter, ocean90.
fixes #30781 for trunk.
git-svn-id: https://develop.svn.wordpress.org/trunk@30991 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-23 17:04:47 +00:00
Dominik Schilling (ocean90)
c959c4d4b3
Customizer: Add _wp_attachment_is_custom_background meta to uploaded background images.
...
Adds `$type` property to `WP_Customize_Background_Image_Control` (PHP) and introduces `wp.customize.BackgroundControl` (JS).
see #30707 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30885 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-15 23:27:17 +00:00
Dominik Schilling (ocean90)
326d7f8c5f
Customizer: Re-add the possibility to remove and restore a default background image.
...
see #21483 .
fixes #30683 for trunk.
git-svn-id: https://develop.svn.wordpress.org/trunk@30849 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-14 19:36:27 +00:00
Dominik Schilling (ocean90)
4a662deaa5
Customizer: Don't escape control descriptions in JavaScript templates.
...
fixes #30682 for trunk.
git-svn-id: https://develop.svn.wordpress.org/trunk@30847 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-14 19:23:49 +00:00
Scott Taylor
29bcbb62e1
Show title, album, and artist info for audio files displayed in WP_Customize_Upload_Control().
...
See #21483 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30737 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-04 01:58:56 +00:00
Dominik Schilling (ocean90)
5158511ceb
Customizer: Enhance Background Image/Upload controls.
...
* Adopt the Header Image layout to the Background Image/Upload control.
* Remove templates for interactive audio/video previews. They haven't worked yet.
* Don't show a "Remove" button when the default value is set.
* Avoid calculating of container/placeholder heights which are unrelated to custom headers.
see #21483 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30712 602fd350-edb4-49c9-b593-d223f7449a82
2014-12-02 21:54:42 +00:00
Scott Taylor
5817aa262d
Improve various @param docs for src/wp-includes/class-wp-customize*.php.
...
See #30224 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30676 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-30 23:32:31 +00:00
Drew Jaynes (DrewAPicture)
e587324180
Docs Formatting: Backtick-escape inline code for all remaining dynamic hook docs in wp-includes/*.
...
Affects DocBlocks for the following hooks:
* `auth_post_meta_{$meta_key}`
* `term_links-$taxonomy`
* `customize_render_control_ . $this->id`
* `customize_render_panel_{$this->id}`
* `customize_render_section_{$this->id}`
* `customize_preview_{$this->id}`
* `customize_save_ . $this->id_data[ 'base' ]`
* `customize_update_ . $this->type`
* `customize_value_ . $this->id_data[ 'base' ]`
* `customize_sanitize_js_{$this->id}`
* `comment_form_field_{$name}`
* `comment_{$old_status}_to_{$new_status}`
* `comment_{$new_status}_{$comment->comment_type}`
* `extra_{$context}_headers`
* `get_template_part_{$slug}`
* `get_the_generator_{$type}`
* `get_{$adjacent}_post_join`
* `get_{$adjacent}_post_where`
* `get_{$adjacent}_post_sort`
* `{$adjacent}_post_rel_link`
* `{$adjacent}_post_link`
* `{$adjacent}_image_link`
* `blog_option_{$option}`
* `$permastructname . _rewrite_rules`
* `{$type}_template`
* `theme_mod_{$name}`
* `pre_set_theme_mod_$name`
* `current_theme_supports-{$feature}`
* `get_user_option_{$option}`
* `edit_user_{$field}`
* `pre_user_{$field}`
* `user_{$field}`
See #30552 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30656 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-30 12:09:56 +00:00
Drew Jaynes (DrewAPicture)
5b30d9e1ac
4.1 Docs Audit: Improve inline documentation for various properties and methods in the WP_Customize_Control and WP_Customize_Upload_Control classes.
...
See #30469 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30605 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-28 09:19:06 +00:00
Dominik Schilling (ocean90)
1b920af543
Customizer: Only show the default button in the upload control if there is a default attachment.
...
props celloexpressions.
see #21483 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30553 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-24 22:30:25 +00:00
Dominik Schilling (ocean90)
8d476eee4f
Customizer: Improve ability to filter active state for widget area Customizer sections.
...
* Mark panels, sections, controls as active if preview explicitly indicates.
* Introduce `WP_Customize_Sidebar_Section` PHP class, and `SidebarSection` JS class.
* Move logic for determining whether a sidebar section is active from the `SidebarControl` to `SidebarSection`.
props westonruter.
fixes #30235 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30329 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-13 12:18:01 +00:00
Dominik Schilling (ocean90)
9c6b323976
Customizer: Prevent double-encoding in WP_Customize_Control.
...
Control's label and description may include HTML.
fixes #29572 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30326 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-13 11:43:06 +00:00
Dominik Schilling (ocean90)
4175d8a922
Customizer: Add support for the media library in Background Image controls.
...
`WP_Customize_Upload_Control` (PHP) and `api.UploadControl` (JS) can now open the media modal.
props celloexpressions, and ericlewis for docs.
see #21483 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30309 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-11 23:51:48 +00:00
Dominik Schilling (ocean90)
507243a3e2
Customizer: Add stable sorting for panels, sections and controls in JS. Improve sorting in PHP.
...
props westonruter.
fixes #30225 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30214 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-03 21:34:44 +00:00
Scott Taylor
b808e1af70
Declare the $uploaded_headers and $default_headers properties for WP_Customize_Header_Image_Control.
...
See #30224 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30172 602fd350-edb4-49c9-b593-d223f7449a82
2014-11-01 23:17:48 +00:00
Dominik Schilling (ocean90)
90182015e7
Improve/introduce Customizer JavaScript models for Controls, Sections, and Panels.
...
* Introduce models for panels and sections.
* Introduce API to expand and focus a control, section or panel.
* Allow deep-linking to panels, sections, and controls inside of the Customizer.
* Clean up `accordion.js`, removing all Customizer-specific logic.
* Add initial unit tests for `wp.customize.Class` in `customize-base.js`.
https://make.wordpress.org/core/2014/10/27/toward-a-complete-javascript-api-for-the-customizer/ provides an overview of how to use the JavaScript API.
props westonruter, celloexpressions, ryankienstra.
see #28032 , #28579 , #28580 , #28650 , #28709 , #29758 .
fixes #29529 .
git-svn-id: https://develop.svn.wordpress.org/trunk@30102 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-29 22:50:21 +00:00
John Blackbourn
d62320bff5
Correct some logic to populate the defaultValue variable when data.defaultValue begins with a hash symbol.
...
Props antpb
Fixes #30125
git-svn-id: https://develop.svn.wordpress.org/trunk@30087 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-29 02:42:35 +00:00
John Blackbourn
37a3642183
Add the ability for a customizer control to render its controls via a JavaScript template. Switches the default color picker control to a JavaScript template. See #29572 . Props celloexpressions
...
git-svn-id: https://develop.svn.wordpress.org/trunk@30014 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-24 16:31:54 +00:00
Dominik Schilling (ocean90)
ab128698ad
Customizer: Change instances of "Theme Customizer" to just "Customizer", as the Customizer isn't necessarily theme-specific.
...
Also capitalize "Customizer".
See also https://make.wordpress.org/core/2014/07/08/customizer-improvements-in-4-0/ .
props studionashvegas, tareq1988.
fixes #29947 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29903 602fd350-edb4-49c9-b593-d223f7449a82
2014-10-15 17:20:34 +00:00
Sergey Biryukov
8cfdbf1167
Use https for apps.wordpress.org links.
...
props pento.
fixes #29595 for trunk.
git-svn-id: https://develop.svn.wordpress.org/trunk@29721 602fd350-edb4-49c9-b593-d223f7449a82
2014-09-09 06:28:33 +00:00
Andrew Nacin
84681ddd39
Link to apps.wordpress.org instead of wordpress.org/mobile.
...
props pento.
fixes #29496 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29703 602fd350-edb4-49c9-b593-d223f7449a82
2014-09-04 14:21:13 +00:00
Drew Jaynes (DrewAPicture)
e52c954fad
Inline documentation cleanup for 4.0 audit.
...
phpDoc tweaks for methods, properties, and filters added in [29051]:
* `WP_Customize_Control->$active_callback` property
* `WP_Customize_Control::active()` method
* `WP_Customize_Control::active_callback()` method
* `WP_Widget_Area_Customize_Control::active_callback()` method
* `WP_Widget_Form_Customize_Control::active_callback()` method
* 'customize_control_active' filter
Added in [28930]:
* `WP_Customize_Control::input_attrs()` method
See #27993 and #28885 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29156 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-14 00:31:22 +00:00
Sergey Biryukov
1477277b53
Customizer: Introduce WP_Customize_Control::active() method to determine whether the control is relevant to the current context (i.e. to the current URL being previewed).
...
Control can indicate its active state by a subclass overriding the 'active_callback' method, by supplying a callable 'active_callback' argument into the control's constructor, or by filtering 'customize_control_active'.
props westonruter.
see #27993 .
git-svn-id: https://develop.svn.wordpress.org/trunk@29051 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-09 23:57:29 +00:00
Helen Hou-Sandi
6d8c6d8728
Don't escape customizer control descriptions, just as section descriptions are not escaped. These are set programmatically, not via user input. props tollmanz. fixes #27981 .
...
git-svn-id: https://develop.svn.wordpress.org/trunk@28980 602fd350-edb4-49c9-b593-d223f7449a82
2014-07-03 20:10:29 +00:00
Dominik Schilling (ocean90)
6f51a5f972
Customizer: Support textarea and commonly-used input types as control type in WP_Customize_Control.
...
Add `input_attrs` property to support custom input attributes.
(Demo plugin attached to ticket.)
props celloexpressions.
fixes #28477 .
git-svn-id: https://develop.svn.wordpress.org/trunk@28930 602fd350-edb4-49c9-b593-d223f7449a82
2014-06-30 19:47:56 +00:00