Title: Customizer Dev Tools Author: Weston Ruter Published: August 19, 2016 Last modified: November 9, 2017 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/customizer-dev-tools.svg) # Customizer Dev Tools By [Weston Ruter](https://profiles.wordpress.org/westonruter/) [Download](https://downloads.wordpress.org/plugin/customizer-dev-tools.0.1.1.zip) * [Details](https://wordpress.org/plugins/customizer-dev-tools/#description) * [Reviews](https://wordpress.org/plugins/customizer-dev-tools/#reviews) * [Development](https://wordpress.org/plugins/customizer-dev-tools/#developers) [Support](https://wordpress.org/support/plugin/customizer-dev-tools/) ## Description The customizer is a single-page application that includes a lot of events, messages, and state changes which drive the application. Being aware of these things is essential for developing JavaScript for the customizer. To use, activate the plugin, open the customizer and the browser console and enter: ``` CustomizerDevTools.startLogging() ``` You can then either start interacting with the customizer app to see the log entries from that point, or you can reload the customizer to see the log entries emitted during the customizer initialization. Not everything in the customizer is currently implemented to emit a log entry. File an issue for any specific event that may be needed. Features: * Start logging of customizer events via running `CustomizerDevTools.startLogging()` from your browser console, and stop via `CustomizerDevTools.stopLogging()`. In the former, you can filter what is logged out by passing a string or regular expression (`RegExp` object) to match against the given log, or you can use the browser console’s built-in log filtering. * Logs out all events triggered on `wp.customize`. * Logs out additions and changes to to `wp.customize.state`. * Logs changes to the `active` and `expanded` states for panels, sections, and controls. * Logs out messages sent and received by the pane (controls) and preview. * Logs out dynamic addition and removal of panels, sections, controls, partials, and settings (after the `ready` event triggers). * The `wp.customize` object from the Customizer preview is made persistently available from the parent frame via `CustomizerDevTools.previewCustomize`. This reference is updated whenever the preview refreshes, so you no longer have to change the frame window context to access this object. * In the same way, the current Customizer preview `window` is exposed as `CustomizerDevTools. previewWindow`. This is a shortcut for doing `wp.customize.previewer.targetWindow. get()`, and it has the added benefit of allowing the browser’s dev tools to provide auto-completion. Make sure you also install the [Customizer Browser History](https://github.com/xwp/wp-customizer-browser-history) and [Customize Snapshots](https://github.com/xwp/wp-customize-snapshots) plugins so that you can reload the browser window and have the Customizer load with the same state as before you reloaded, including the persistence of the focused panel, section, control, the previewed URL, the scroll position in the preview, and which device is being previewed. Requires PHP≥5.3. ## Screenshots * [[ * Messages sent/received and events triggered during Customizer load. * [[ * Logging the changing of the Site Title. * [[ * Logging the change of a nav menu item from a saved sate. * [[ * Expanding the Site Identity section and then navigating to edit a widget. * [[ * Changes to `wp.customize.state` when saving the customizer changes. * [[ * State changes, messages, and events related to saving. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “Customizer Dev Tools” is open source software. The following people have contributed to this plugin. Contributors * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) * [ XWP ](https://profiles.wordpress.org/xwp/) [Translate “Customizer Dev Tools” into your language.](https://translate.wordpress.org/projects/wp-plugins/customizer-dev-tools) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/customizer-dev-tools/), check out the [SVN repository](https://plugins.svn.wordpress.org/customizer-dev-tools/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/customizer-dev-tools/) by [RSS](https://plugins.trac.wordpress.org/log/customizer-dev-tools/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.1.1 [2017-11-14] * Add setting change listener for settings in preview. * Tested up to 4.9. #### 0.1.0 [2016-08-18] Initial release ## Meta * Version **0.1.1** * Last updated **9 years ago** * Active installations **Fewer than 10** * WordPress version ** 4.7 or higher ** * Tested up to **4.9.29** * Tags * [customize](https://wordpress.org/plugins/tags/customize/)[customizer](https://wordpress.org/plugins/tags/customizer/) [debug](https://wordpress.org/plugins/tags/debug/)[debugging](https://wordpress.org/plugins/tags/debugging/) [dev-tools](https://wordpress.org/plugins/tags/dev-tools/) * [Advanced View](https://wordpress.org/plugins/customizer-dev-tools/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/customizer-dev-tools/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/customizer-dev-tools/reviews/) ## Contributors * [ Weston Ruter ](https://profiles.wordpress.org/westonruter/) * [ XWP ](https://profiles.wordpress.org/xwp/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/customizer-dev-tools/)