Easily load site specific functions, scripts and CSS files into your site without editing your theme's `functions.php` or other source files.
Author: | Gary Gale (profile at wordpress.org) |
WordPress version required: | 4.8 |
WordPress version tested: | 4.8.3 |
Plugin version: | 1.0.2 |
Added to WordPress repository: | 05-06-2013 |
Last updated: | 09-11-2017
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
|
Rating, %: | 100 |
Rated by: | 2 |
Plugin URI: | http://www.vicchi.org/codeage/wp-customizer/ |
Total downloads: | 3 880 |
Active installs: | 40+ |
Click to start download |
Screenshots
Settings and Options: Functions Tab
Settings and Options: Scripts Tab
Settings and Options: CSS Tab
Settings and Options: Colophon Tab
Settings and Options: Debug Tab
Settings and Options: Functions Tab with Contextual Help
Installation Instructions
- You can install WP Customizer automatically from the WordPress admin panel. From the Dashboard, navigate to the Plugins / Add New page and search for “WP Customizer” and click on the “Install Now” link.
- Or you can install WP Customizer manually. Download the plugin Zip archive and uncompress it. Copy or upload the
wp-customizer
folder to thewp-content/plugins
folder on your web server. - Activate the plugin. From the Dashboard, navigate to Plugins and click on the “Activate” link under the entry for WP Customiser.
- Prepare your customization files. By default, WP Customizer looks for front-end functions in a directory named
functions
, for front-end scripts in a directory namedscripts
and for front-end CSS files in a directory namedcss
. - Admin screen customizations are placed in a similar set of directories, prefixed with
admin_
, as inadmin_functions
,admin_scripts
andadmin_css
. - Customizations common to both the front-end and the admin screens are placed in directories prefixed with
common_
, as incommon_functions
,common_scripts
andcommon_css
. - You can either create the default directories and place your customization files in them or create your own directory hierarchy.
- Now you can configure the loading of each type of supported customization. From the Dashboard navigate to Settings / WP Customizer and enable loading of the customization files as you require.
- If you choose to use a non-default set of directory name, you should ensure the plugin’s options are updated to reflect this.
Why should I use this plugin?
A standard WordPress install is incredibly powerful and flexible. For a lot of people, WordPress out of the box plus one of the stock WordPress themes is enough. But the possibilities for customization are endless; you can add plugins and other themes. Sometimes these do just what you want. Sometimes you need to … tweak WordPress. A very high proportion of the customization advice you’ll find on the web starts with these lines … add the following to the end of your theme’s functions.php
or even worse, advises that you modify the source code of your theme or your plugins. This is bad for many reasons:
- Editing your theme’s
functions.php
makes theme specific customizations; change your theme and your customizations will no longer get loaded. - When your theme and plugins get updated you’ll find all your careful hand crafted customizations get overwritten and lost.
- A lot of theme and plugin authors won’t offer support for changes you might have made to the source code.
- Your customizations might work; but you might also inadvertently make some other changes which will stop things working.
WordPress doesn’t yet support a way for site specific customizations to be made and loaded without touching theme, plugin or core files; that’s what this plugin is for. When WordPress does support such a way, this plugin will thankfully be obsolete.
How do I get help or support for this plugin?
In short, very easily. But before you read any further, take a look at Asking For WordPress Plugin Help And Support Without Tears before firing off a question. In order of preference, you can ask a question on the WordPress support forum; this is by far the best way so that other users can follow the conversation. You can ask me a question on Twitter; I’m @vicchi. Or you can drop me an email instead. I can’t promise to answer your question but I do promise to answer and do my best to help.
Is there a web site for this plugin?
Absolutely. Go to the WP Customizer home page for the latest information. There’s also the official WordPress plugin repository page and the source for the plugin is on GitHub as well.
I’ve installed this plugin but it doesn’t do anything?
By default the plugin installs with no customizations loading; you’ll need to enable them as you need. See the Installation section for more details on how to do this.
I don’t know PHP or JavaScript or jQuery or CSS; what customizations do I need?
To answer the first part of this question, it’s probably best to start at the beginning and get a solid grounding in these tools and technologies before you start making customizations.
To answer the second part of this question, if you don’t know what customizations you need then this plugin probably isn’t for you.
I don’t want to load all of the functions, scripts or CSS files I have; can I select which ones get loaded?
WP Customizer looks in each of the directories that you’ve configured (or left as the default) for each type of customization to load. To stop a specific file loading, simply rename it so that the first character of the file name is the underscore (_
) character and that file will be skipped over when the plugin is looking for files to load. If other words, just rename foo.php
to _foo.php
.
I’m a WordPress power user and want to specify things like dependencies for my scripts or make my CSS customizations load in the page footer; can I do this?
Yes you can. Take a look at the Filter Support and Usage section for information on how to use the plugin’s filters to do all of this and more. In fact, by using the plugin’s filters you can specify every single option that the WordPress wp_enqueue_script
and wp_enqueue_style
API calls accept.
I’ve enabled functions/scripts/css and supplied a path but my function/script/css isn’t loading?
There’s a couple of things that might be happening here. Your file type might be incorrect; your path might not exist or be readable, your file might not exist or be readable or your file might be disabled (starting with an ‘_’). The plugin’s Debug tab is designed to help
diagnose this sort of thing. The Debug tab performs a dry run, without actually loading any files, and checks that files and directories exist and are readable. If you see any entries highlighted in yellow then this will indicate that a file is probably disabled. If you see any entries highlighted in red then this will indicate that a file or directory either doesn’t exist or is not able to be read.
WP Customizer has crashed my website/killed my cat/made it rain; what do I do?
This is unlikely but always possible. A customization file with errors in it can have unforeseen consequences. If this does happen firstly disable all your customization files by renaming them to have an underscore (_
) as the first character. Hopefully things will be OK again. Now rename each customization file back by removing the underscore, one by one, to narrow down which one breaks things. Now would also be a good time to define WP_DEBUG
in your wp-config.php
file to get some helpful error messages in your PHP log file.
For the cases of expired felines or sudden precipitation, this is way outside what a WordPress plugin can do; it’s probably an unfortunate coincidence.
What is all this talk of “customization”; I’m British and it’s spelt “customisation” … ?
I’m British too and yes, it’s spelt customisation over here, not customization. As both Oscar Wilde and George Bernard Shaw are quoted as saying ‘(Britain and America are) two nations, separated by a common language‘. By default, WP Customizer uses American English, but if you’re British and you want British English instead, simply define WP_LANG
to have a value of en_GB
in your site’s wp-config.php
and WP Customizer will automagically become WP Customiser.
WP Customizer isn’t available in my language; can I submit a translation?
WordPress and this plugin use the gettext tools to support internationalisation. The source file containing each string that needs to be translated ships with the plugin in wp-customizer/lang/src/wp-customizer.po
. See the I18n for WordPress Developers page for more information or get in touch for help and hand-holding.
I want to amend/hack/augment this plugin; can I do this?
Totally; this plugin is licensed under the GNU General Public License v2 (GPLV2). See http://www.gnu.org/licenses/old-licenses/gpl-2.0.txt for the full license terms.
The current version is 1.0.1 (2013.09.18)
1.0.1
- Release 2013.09.18
- Fixed: Annoying Markdown syntax in plugin overview text.
- Fixed: Pointer help file is now included; this was missing in v1.0.0.
- Added: Pointer text for the Debug tab.
1.0.0
- Released 2013.05.29
- First version of WP Customizer released