Fix typo and add some documentation to script_loader

git-svn-id: http://svn.automattic.com/wordpress/trunk@10635 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
azaozz 2009-02-23 08:47:49 +00:00
parent bea9ee50aa
commit b4d02c0898
1 changed files with 18 additions and 7 deletions

View File

@ -6,7 +6,18 @@
* {@link http://backpress.automattic.com/ BackPress}. WordPress themes and * {@link http://backpress.automattic.com/ BackPress}. WordPress themes and
* plugins will only be concerned about the filters and actions set in this * plugins will only be concerned about the filters and actions set in this
* file. * file.
* *
* Several constants are used to manage the loading, concatenating and compression of scripts and CSS:
* define('SCRIPT_DEBUG', true); loads the develppment (non-minified) versions of all scripts
* define('CONCATENATE_SCRIPTS', false); disables both compression and cancatenating,
* define('COMPRESS_SCRIPTS', false); disables compression of scripts,
* define('COMPRESS_CSS', false); disables compression of CSS,
* define('ENFORCE_GZIP', true); forces gzip for compression (default is deflate).
*
* The globals $concatenate_scripts, $compress_scripts and $compress_css can be set by plugins
* to temporarily override the above settings. Also a compression test is run once and the result is saved
* as option 'can_compress_scripts' (0/1). The test will run again if that option is deleted.
*
* @package WordPress * @package WordPress
*/ */
@ -29,6 +40,7 @@ require( ABSPATH . WPINC . '/functions.wp-styles.php' );
* Setup WordPress scripts to load by default for Administration Panels. * Setup WordPress scripts to load by default for Administration Panels.
* *
* Localizes a few of the scripts. * Localizes a few of the scripts.
* $scripts->add_data( 'script-handle', 'group', 1 ); queues the script for the footer
* *
* @since 2.6.0 * @since 2.6.0
* *
@ -46,7 +58,6 @@ function wp_default_scripts( &$scripts ) {
$suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '.dev' : ''; $suffix = defined('SCRIPT_DEBUG') && SCRIPT_DEBUG ? '.dev' : '';
$scripts->add( 'utils', "/wp-admin/js/utils$suffix.js", false, '20090102' ); $scripts->add( 'utils', "/wp-admin/js/utils$suffix.js", false, '20090102' );
$scripts->add( 'common', "/wp-admin/js/common$suffix.js", array('jquery', 'hoverIntent', 'utils'), '20090203' ); $scripts->add( 'common', "/wp-admin/js/common$suffix.js", array('jquery', 'hoverIntent', 'utils'), '20090203' );
@ -536,11 +547,11 @@ function wp_style_loader_src( $src, $handle ) {
* @see wp_print_scripts() * @see wp_print_scripts()
*/ */
function print_head_scripts() { function print_head_scripts() {
global $wp_scripts, $concatenate_scripts;
if ( ! did_action('wp_print_scripts') ) if ( ! did_action('wp_print_scripts') )
do_action('wp_print_scripts'); do_action('wp_print_scripts');
global $wp_scripts, $concatenate_scripts;
if ( !is_a($wp_scripts, 'WP_Scripts') ) if ( !is_a($wp_scripts, 'WP_Scripts') )
$wp_scripts = new WP_Scripts(); $wp_scripts = new WP_Scripts();
@ -549,7 +560,7 @@ function print_head_scripts() {
$wp_scripts->do_head_items(); $wp_scripts->do_head_items();
if ( apply_filters('print_head_scripts', true) ) if ( apply_filters('print_head_scripts', true) )
_pring_scripts(); _print_scripts();
$wp_scripts->reset(); $wp_scripts->reset();
return $wp_scripts->done; return $wp_scripts->done;
@ -571,13 +582,13 @@ function print_footer_scripts() {
$wp_scripts->do_footer_items(); $wp_scripts->do_footer_items();
if ( apply_filters('print_footer_scripts', true) ) if ( apply_filters('print_footer_scripts', true) )
_pring_scripts(); _print_scripts();
$wp_scripts->reset(); $wp_scripts->reset();
return $wp_scripts->done; return $wp_scripts->done;
} }
function _pring_scripts() { function _print_scripts() {
global $wp_scripts, $compress_scripts; global $wp_scripts, $compress_scripts;
$zip = $compress_scripts ? 1 : 0; $zip = $compress_scripts ? 1 : 0;