theme-customizer is a set of classes introduced in 3.4 for customizing themes using a live ajax preview. Theme developers can use these classes for theme options.

learn more… | top users | synonyms (1)

22
votes
4answers
4k views

How To extend WP_Customize_Control

I'm looking for a way to add a new kind of control to the customize live preview panel. I have seen how to add new sections to the panel using add_action( 'customize_register'... The control I want ...
14
votes
2answers
1k views

Settings API vs Theme Customizer

When would it be appropriate to use the settings API, and when would it be better to use the theme customizer? Having Googled around all morning, I haven't been able to find any well considered and ...
12
votes
2answers
682 views

New WP_Customize API - how does it work under the hood?

I noticed that if you make changes trough the new "customize" feature, when you navigate on a different page within the iframe preview document, your changes still apply, even if they are unsaved. It ...
9
votes
4answers
5k views

get_option() vs get_theme_mod(): Why is one slower?

I've been using get_theme_mod() for some time in various projects of mine. I decided to take advantage of the Theme Customization API in WordPress v3.4 once it was available as I felt it was an ...
9
votes
2answers
585 views

Customizer JS API

Okay so I have been trying to educate myself to create new panels sections and controls dynamically using customizer's JS API. It has been frustrating few days and I was unable to get the exact way ...
8
votes
2answers
1k views

Theme customizer - settings order

If I add more than 5 Settings to a single section, the order of the settings gets weird. For example: // Link color $wp_customize->add_setting( 'tonal_'.$themeslug.'_settings[link_color1]', ...
8
votes
1answer
727 views

Is it Possible to Extend WP Customize JS Methods?

I’m wondering if it’s possible to extend the methods of the anonymous api object in wp-admin/js/customize-control.js. I need to overwrite one of these methods with my own custom logic but I suspect ...
7
votes
1answer
319 views

Get entered value of customiser field for live preview

As per the codex, this question an probably any tutorial on the theme customiser out there, you get the value of a customiser field with the following code: ( function( $ ) { //Update site ...
7
votes
1answer
210 views

Is it possible ( or advisable) to allow open access to the new theme customizer for potential clients?

I've been using the new theme customizer and it really has me thinking how awesome it would be to allow potential theme buyers/clients etc to play with the customizer for a demo theme (without being ...
6
votes
2answers
4k views

How do I implement the Wordpress Iris picker into my plugin on the front-end?

This question here is asking the same question as I am, but there were no adequate answers nor a selected correct answer so I am asking again hoping if I ask in a more coherent manner I might get a ...
6
votes
1answer
104 views

Link to specific Customizer section

I've got a site with a few extra Customizer sections. Is there a way to link directly to these so that section open when the page loads? Something like ...
6
votes
1answer
49 views

When cropping a header image, retain meta data (i.e. name, description, etc.) from original image?

I'm currently using WordPress's built in Custom Headers to get images for a slideshow on the homepage of my website. For the most part, this has worked as intended; it allows me to upload a set of ...
6
votes
1answer
138 views

How to adjust the Device Preview sizes used in the WP 4.5 Customizer?

WP 4.5 introduced the Device Preview in the Customizer and it's pretty easy to use. Click one of three icons and see your site at various (predetermined) sizes. The desktop version will always fill ...
5
votes
2answers
2k views

How to remove the Theme Customization Button from the dashboard and themes options page?

In my Wordpress theme that I've currently been building I do not take advantage of the Wordpress Theme Customization API. As much as I would like too, I've invested far too much time into my own ...
5
votes
2answers
149 views

Allow Shortcode in Theme Customizer

All theme dev who follows the wp guidelines properly, now uses ability of default wp customizer to customize their themes, instead of making a different theme option section the admin panel. But what ...
5
votes
1answer
130 views

Is having multiple theme customizers for different pages possible?

If you have a theme that for instance has a blog, front page and misc pages is it possible to have more than one theme customizer, so that you can provide a live preview when editing styles? My theme ...
4
votes
4answers
6k views

How do I remove a pre-existing customizer setting?

My theme doesn't use the tag line, how can I remove it from the customizer?
4
votes
2answers
2k views

Adding a description to theme customizer controls

How could I add a description to $wp_customize->add_control? I've found I really need to include a short description on some of the controls but it doesn't look like it's possible. I noticed you ...
4
votes
1answer
84 views

Custom Image section in Customizer

So I have this Custom Section in the Customizer that controls the Feature Products on the Home Page. There all registered and so on but the problem I'm stuck on is when the client uploads one of the ...
4
votes
1answer
143 views

Theme Customiser Image Control

I'm aware that one can add a control to the theme customiser to add an image. This control returns an image URL however, and I need its attachment ID, not the image URL. Where can I intercept or ...
4
votes
1answer
1k views

How WP_Customize_Background_Image_Control is supposed to work?

I'm trying to add a second background image function to my theme customizer with this code. // HTML Background Image $wp_customize->add_setting( 'html_background_image', array( ...
4
votes
0answers
43 views

How to customize a shortcode using the customizer

General context: I have a plugin which implements a widget and I would like to make the widget into a shortcode. The widget has many options some of them mutually exclusive, and it is never good UX ...
4
votes
0answers
67 views

Custom editable content for front page from Theme Customizer

I developed a very basic theme with underscores. I am looking for custom editable content, or a changeable page, from the Theme Customizer for front-page.php. For example, when a user goes to ...
4
votes
0answers
110 views

SSL breaks customizer: page isn't returned from ajax

I have a WordPress install using a Comodo SSL certificate. I have the WordPress HTTPS plugin installed and I'm using the AZ theme, and the admin is set to load over HTTPS. So far so good. On the ...
4
votes
2answers
176 views

Allow anonymous user to access Themes Customizer

I created a theme and use Themes Customizer. Is there any way I can give anonymous users access to the themes customizer without the ability to save it? It will be very convenient in terms of user ...
3
votes
1answer
225 views

Is the theme customizer slowing down my site?

I have built an awesome theme, which is very flexible, because it has 500 settings in the theme customizer. I generate the live css like it says in the codex: function mytheme_customize_css() { ...
3
votes
2answers
136 views

Get all registered wp theme customizer sections?

Is there a way to retrieve all the registered customizer sections? I'm building out a custom customizer and don't want other plugin or themes who register custom sections to appear on this page. I ...
3
votes
2answers
89 views

How to change the themes “Live Preview” url within the Appearance->Themes page?

I need a way to change the themes "Live Preview" url within the Appearance->Themes page? I want the themes thumbnails to link to a demo site showcasing the theme and not open the customizer. I looked ...
3
votes
2answers
54 views

Theme option : having the ability to select among several predefined headers

I'm in the process of creating my first theme, and I'm using Quark as a starter theme. I would like the theme to have various options, one being header selection. (let's say 5 different headers - ...
3
votes
1answer
890 views

Trigger Customizer saving process with Javascript only

I'm working on a custom theme that uses WordPress Customization API to let the user play with parts of the content of his website, basically the front-page which he can modify by adding/removing ...
3
votes
4answers
169 views

View category in the preview of Theme Customizer

I am building a theme which Theme customizer changes colors, sizes, etc. and has also the option to choose a category and style that category specifically. How can I display that category in the ...
3
votes
1answer
102 views

How to Save Different Settings Options Using Settings API and/or the Theme Optimizer

I would like to allow users to save different versions in the options panel using the Settings API and/or the Theme Optimzer. For instance, imagine that I have styled my site using via an admin panel ...
3
votes
0answers
82 views

Customizer Active Callback not working

From some reason my active_callback => 'is_front_page' is not registering and therefore not showing up inside the customizer on the front-page - I have definitely set my front page to static and ...
3
votes
0answers
44 views

Can I create customizer setting that can handle plugin shortcode?

Can I create a customizer setting which will handle a shortcode from a plugin? Do I violate and rules or guidelines in WordPress theme development? If it's possible what is the best way to sanitize ...
3
votes
1answer
318 views

Internalize get_theme_mod CSS Into Stylesheet?

This code adds custom CSS selections from the theme customizer. What I hate about this code is that it outputs the style tags directly into the site's html, rather than tacking the selections onto my ...
3
votes
0answers
297 views

Customizer preview doesn't update get_option() value properly

I have a setting in index.php if(get_option('cb2_blog_home')){ cb_get_blog_links(); } This code allows the home page blog index to be turned on and off. The cb_get_blog_links() function draws ...
3
votes
1answer
300 views

Need help setting default setting value for radio button in theme customizer

I need help figuring out how the radio button saves it's value in the theme settings. In my theme I added Radio buttons in the theme customizer. So far they are working great. Although I have one ...
3
votes
1answer
134 views

Is it possible to display the admin bar while in the Theme Customizer?

I've been using Debug Bar + Kint Debugger for debugging. Presently I'm working on a custom theme where I'm trying to hook some code into customize_save_after. The code doesn't appear to be running ...
3
votes
2answers
396 views

One button to change all settings in theme customizer?

I have been attempting to create a theme reset button for the theme customizer that automatically removes all of the theme_mod settings. I have tried multiple ways to do this and have never been able ...
2
votes
1answer
2k views

How to add default images into theme customizer image control?

I am trying to figure out how I can pre-load a theme customizer image control with images I have selected. Is their a way to point the control to a directory so they automatically show up in the ...
2
votes
1answer
1k views

Is it possible to get a theme customizer setting from wp.customize using jquery?

I am wondering if it is possible to directly interop with the wp.customize api to get a value of a theme customizer setting. The way I am doing it now is using ajax to get a response from a php ...
2
votes
2answers
1k views

How to remove Customize from admin menu bar after WP 4.3

WordPress 4.3 brought more updates to the customizer. It also added a new option at the top admin menu bar that says 'Cusomize' and has a paintbrush. How can I disable this menu from showing up? We ...
2
votes
2answers
985 views

Use default value of wp_customizer in theme_mod output?

Is there a way to output the default value of a wp_customize text field type using the echo get_theme_mod (); without actually going in the Theme Customizer, modifying something and then saving it? ...
2
votes
1answer
780 views

How to execute conditional script when on new customize.php (Theme Customize) screen

The new "Customize" theme screen is a welcome addition in WordPress 3.4, however, I find it conflicts with my method of loading scripts loaded in the footer: In functions.php if(!is_admin()) { /* ...
2
votes
2answers
3k views

Theme Customizer - Dynamic CSS PHP File

I've recently switched over from using a custom class to enable a theme options panel to the built in Theme Customizer in Wordpress. All is going fairly well - I've got live preview working but I'm a ...
2
votes
2answers
272 views

Add a “loading” notice when Customizer is making changes

I really want to try and add an overlay and "loading" notice to the wordpress customizer when a change is made. For some of my larger theme changes that are made through the customizer, I am using ...
2
votes
1answer
175 views

Make Theme Options Native to Theme Customizer

With the native Theme Customization API it makes no sense to have an independent options panel. So how do I implement my code (below) into the Theme Customizer? Here is the code for my Theme ...
2
votes
2answers
515 views

Changes in widget customizer not triggering 'save and publish'

I'm making some of our widgets customiser friendly, so they work on the customise page and support widget previews. Usually when you update a widget the save button becomes usable and changes to 'save ...
2
votes
2answers
839 views

How do I add customize_register action AFTER adding a custom taxonomy

customize_register only works with the customize_register hook, and regardless of what hook I use to add the custom taxonomy, it always happens after customize_register. (I want to loop through the ...
2
votes
1answer
400 views

Get attachment id from WP Customizer

The WP Customizer's WP_Customize_Image_Control returns the attachment's URL, but I need the ID because I want to output the image like this: echo wp_get_attachment_image( $user_logo_id, ...