https://github.com/xwp/wp-customizer-everywhere
Customizer Everywhere plugin for WordPress
https://github.com/xwp/wp-customizer-everywhere
Last synced: 9 months ago
JSON representation
Customizer Everywhere plugin for WordPress
- Host: GitHub
- URL: https://github.com/xwp/wp-customizer-everywhere
- Owner: xwp
- Created: 2013-09-26T08:21:27.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2015-03-04T05:13:57.000Z (almost 11 years ago)
- Last Synced: 2025-04-12T15:08:28.702Z (9 months ago)
- Language: PHP
- Homepage: http://wordpress.org/plugins/customizer-everywhere/
- Size: 604 KB
- Stars: 8
- Watchers: 67
- Forks: 5
- Open Issues: 4
-
Metadata Files:
- Readme: readme.md
- Contributing: contributing.md
Awesome Lists containing this project
README
# Customizer Everywhere
Promote and enhance the use of customizer in more places; open post previews in the customizer and promote customize link to top of admin bar.
**Contributors:** [xwp](http://profiles.wordpress.org/xwp), [westonruter](http://profiles.wordpress.org/westonruter)
**Tags:** [customizer](http://wordpress.org/plugins/tags/customizer), [preview](http://wordpress.org/plugins/tags/preview), [widget-customizer](http://wordpress.org/plugins/tags/widget-customizer), [admin-bar](http://wordpress.org/plugins/tags/admin-bar)
**Requires at least:** 3.6
**Tested up to:** 3.8
**Stable tag:** trunk (master)
**License:** [GPLv2 or later](http://www.gnu.org/licenses/gpl-2.0.html)
[](https://travis-ci.org/xwp/wp-customizer-everywhere)
## Description ##
The “Preview” button when editing a post is replaced with a “Preview & Customize” button,
which opens the customizer with the current post's preview loaded into the customizer preview window.
A separate window is opened for each edited post being previewed, as opposed to all previews going into the same window named `wp-preview`.
When a customizer preview is opened for previewing a post, clicking the Back (Close or Cancel) button in the
customizer controls, the opened window will close and the opener window will be focused on. This will rapidly take
you back to the page from which you opened the preview, assuming it is still open.
It is not helpful to see in browser tabs "Customize Twenty Twelve — WordPress". This title assumes the primary
purpose of the customizer is to preview themes, when in reality it seems the primary purpose is to customize your
already-selected theme. In this latter case, it makes much more sense for the title to reflect the page currently
being previewed. So when in the customizer, the parent document title will reflect the title of the page currently
being previewed. As you navigate around the site within the preview iframe, the page's title will update. This allows
you to see which page is being customized just by looking at the label on your browser's tab.
In the Admin Bar, the “Customize” link is promoted from a submenu to a top-level position right after the Edit post
link.
This prominent placement of the “Customize” link in the admin bar, along with the customizer being opened when
previewing a post/page, are designed to encourage the use of the customizer in many more places than just the site's
front page. The [Widget Customizer](http://wordpress.org/plugins/widget-customizer/) plugin conditionally shows
control sections in the customizer based on whether or not that sidebar is currently rendered in the customizer
preview. Therefore, for some customizer controls to be accessed, the user must navigate—either within the customizer
or outside—to a page that has the element which a control customizes.
**Development of this plugin is done [on GitHub](https://github.com/xwp/wp-customizer-everywhere). Pull requests welcome. Please see [issues](https://github.com/xwp/wp-customizer-everywhere/issues) reported there before going to the plugin forum.**
## Screenshots ##
### The “Preview” button is replaced with a “Preview & Customize” button
### The “Customize” link in the Admin Bar is promoted to the top.
### Close button in customizer actually closes window, returning focus to opening window. Browser tab includes title from page currently being previewed.
## Changelog ##
### 0.1.2 ###
Improve logic for filtering preview_post_link
### 0.1.1 ###
Add Travis CI integration and pre-commit with various tests
### 0.1 ###
First Release