Questions tagged [theme-customizer]

The Customizer is a framework for staging changes in WordPress. Settings may model anything in a given site (options, theme mods, widgets nav menus, posts, etc.) and the changes are bundled into changesets which are then previewed, saved as drafts, and even scheduled. Themes and plugins alike may extend the Customizer. Questions should be posed related to the Customize API in WordPress, in either PHP and JS.

Filter by
Sorted by
Tagged with
28
votes
5answers
9k 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 ...
21
votes
2answers
2k 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 ...
19
votes
5answers
22k 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 ...
16
votes
6answers
20k 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?
16
votes
2answers
791 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 ...
14
votes
1answer
14k views

Where is Customizer related data stored is the database?

How would I go about finding if a image (with a certain URL) is used stored in the Customizer data?
11
votes
2answers
8k 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 ...
11
votes
2answers
1k 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 ...
10
votes
1answer
4k views

How do I implement selective refresh with a customizer setting?

I have a section in a page template in the theme I'm making that displays content based on a page the user selects in the customizer using the dropdown-pages control. Right now it's just using the ...
10
votes
2answers
2k 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]', array(...
10
votes
1answer
524 views

Add settings to menu items in the Customizer

WordPress 5.4 added the wp_nav_menu_item_custom_fields_customize_template hook to add custom fields to the Nav Menu Item settings in the customizer. I've figured out how to display the additional ...
9
votes
1answer
14k 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 ...
9
votes
1answer
565 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 ...
9
votes
1answer
2k 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 ...
8
votes
1answer
4k 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 http://mysites.com/wp-admin/customize.php#...
8
votes
1answer
9k views

How to create a theme customizer 'sub' panel?

One of the cool new features of WordPress 4.0 is the add_panel() method. In my situation, i'd like to create a new panel for theme options, that's very straight forward, but is it possible to create ...
8
votes
1answer
192 views

Can a widget in the Customizer be “single-use” (i.e. disabled after 1 instance has been added)?

I’m on a nightly quest to build a custom single-use widget. As soon as one instance of it has been added to a sidebar panel in the Customizer, its control on the Available Widgets panel should be ...
8
votes
0answers
196 views

Hook in wp.media to add a new tab

This is an issue coming up while creating a plugin. I want to add a tab to the wp.media.view.MediaFrame.Select modal or if a general approach helps: In the customizer I want to hook in any modal ...
7
votes
2answers
4k views

Repeater field in Customizer

I'd like to develop a setting/control for Customizer that allows dynamically to add fields. The typical example would be the possibility to add an unlimited number of slides to an slider in a Theme. ...
7
votes
2answers
2k views

wp.customize.bind ready event not fired

I'm trying to add some javascript to my theme customizer. My JS file is loaded no problem and my document ready event works but wp.customize.bind() isn't calling my callback. jQuery(document).on('...
7
votes
1answer
146 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 ...
7
votes
2answers
3k views

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 ...
7
votes
1answer
237 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
3answers
7k 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 ...
6
votes
2answers
6k 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? ...
6
votes
4answers
9k 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 ...
6
votes
1answer
137 views

WP Customizer - Prevent live preview

How do I prevent a widget being updated in the customizer preview if a widget field fails a JS validation check? More generally, is there any actual documentation for the customizer JS API? (I mean ...
6
votes
1answer
819 views

How to upload multiple images with WP_Customize_Media_Control

This question is specifically related to the WordPress Customizer. I am looking for a way to upload multiple images with the WP_Customize_Media_Control. It is easy to do this for metaboxes, but I do ...
6
votes
1answer
76 views

Different customizer previewUrls per section

For example if there is a Customizer section that focuses on Woocommerce options, I'd like the user to be on the shop page for that, to see all these changes, live. I can do http://127.0.0.1/wp-...
6
votes
2answers
864 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 ...
6
votes
2answers
2k 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 ...
6
votes
1answer
297 views

Theme Customization API and child themes

I've recently developed a parent theme that makes heavy use of the Theme Customization API. Is there an easy way to port these settings when a user activates one of my child themes? Currently, the ...
5
votes
2answers
12k 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 ...
5
votes
1answer
2k views

Is there any way to add placeholder for WordPress Customizer text input fields

I am wondering if it is possible to add placeholder text for WordPress Customizer input fields especially text and textarea fields. I have added a input control by the code below. Can anyone tell me ...
5
votes
2answers
3k 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 ...
5
votes
2answers
7k views

Theme Customizer : how to create multiple-level panel

Is there a way to create deep-level sub Panel in Theme Customizer(like roots of plants) ? My theme that I have been developing seem to be more complicated. I think that if we can create deep-level sub ...
5
votes
3answers
2k 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
2answers
4k views

Theme Customizer - Nested Sections?

Is it possible to put sections within sections at all? It would be very helpful for me to be able to do so due to having several options per section and I don't want the user to be overloaded with ...
5
votes
1answer
416 views

How to open the 404 page in the Theme Customizer preview?

I have added option fields in my theme's Customizer that allow you to change how your 404 page looks. Problem is, the user can't actively see the changes. I have a specific section for my fields, ...
5
votes
4answers
6k views

TinyMCE in customizer

I use TinyMce on my customizer (for obv reasons). But i encounter a problem that i do not seem to have the answer to. Let me first share you my code that are crucial: Functions.php // text editor ...
5
votes
1answer
6k views

How to Add Customizer Setting in Child Theme

I would like to add an option to the Customizer of my Child Theme, but I am having some trouble implementing it. I am pretty sure my problem is connected to the name of the arguments I am calling, but ...
5
votes
2answers
1k views

Disable Visible Edit Shortcuts in the Customizer

Is there a way to disable the edit shortcut buttons that was added in WordPress 4.7? I noticed they have a class customize-partial-edit-shortcut-button and I can add display:none in css but trying to ...
5
votes
1answer
903 views

How to refresh WordPress Customizer panel upon entering a value

I have created a variable number of fields to add images to a nivoslider. It works nicely, but I have to manually refresh the entire page and re-select the section from the customizer panel for the ...
5
votes
1answer
887 views

Customizer Active Callback not working

From some reason my active_callback => 'is_front_page' is not working and therefore not showing up inside the customizer on the front-page. I have definitely set my front page to static and ...
5
votes
1answer
218 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 ...
5
votes
1answer
3k 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( ...
5
votes
1answer
270 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 ...
5
votes
1answer
661 views

Looking for a way to load a function after customizer preview refresh complete

I need to load a callback function after a wp.customize.previewer.refresh(). I need this because I want to update a template position which is displayed with a custom hook in my theme and scroll the ...
5
votes
1answer
590 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 ...
5
votes
1answer
730 views

Color Picker (iris) in widget - refresh when edited in Customizer

I have added the WordPress Core color picker (iris) to a widget I developed, but when I edit the color, there is no change triggered. As a result, the iframe (live preview) for the Customizer does not ...

1
2 3 4 5
18