Merge branch 'master' of github.com:parisholley/wordpress-asynchronous-javascript

git-svn-id: http://plugins.svn.wordpress.org/asynchronous-javascript/trunk@654901 b8457f37-d9ea-0310-8a92-e5e31aec5664

Author: parisholley

README.txt

@@ -0,0 +1,32 @@
+=== Asynchronous Javascript ===
+Contributors: parisholley
+Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=paris%40holleywoodproductions%2ecom&lc=US&item_name=Paris%20Holley&no_note=0&currency_code=USD&bn=PP%2dDonationsBF%3abtn_donateCC_LG%2egif%3aNonHostedGuest
+Tags: async,headjs,asynchronous,performance,javascript
+Requires at least: 3.5
+Tested up to: 3.5
+Stable tag: trunk
+
+== Description ==
+
+Improve page load performance by asynchronously loading javascript using head.js
+
+
+== Installation ==
+
+1. Upload `asynchronous-javascript` folder to the `/wp-content/plugins/` directory
+2. Activate the plugin through the 'Plugins' menu in WordPress
+
+== Frequently Asked Questions ==
+
+= How do I include a script that I do not control but has a dependency on another script? =
+
+In your theme, use the static AsynchronousJS::wp_enqueue_async_script() method, which is API compatible with wp_enqueue_script($handle, $src, $deps). Using this method will cause the $src to load ONLY when scripts with the handles defined in $deps have been loaded.
+
+= Is there any potential problems with other plugins? =
+
+As long as those plugins are using the built-in wordpress script queuing and not attempting to output scripts manually (such as invoking wp_print_scripts()), you should have no problems.
+
+== Changelog ==
+
+= 1.0 =
+* Initial release, seems to work. :)

asynchronous-javascript.php

@@ -0,0 +1,102 @@
+<?php
+/*
+Plugin Name: Asynchronous Javascript
+Plugin URI: https://github.com/parisholley/wordpress-asynchronous-javascript
+Description: Improve page load performance by asynchronously loading javascript and files using head.js in your wordpress website.
+Version: 1.0
+Author: Paris Holley
+Author URI: http://www.linkedin.com/in/parisholley
+Author Email: mail@parisholley.com
+License:
+
+  Copyright 2013 Paris Holley (mail@parisholley.com)
+
+  This program is free software; you can redistribute it and/or modify
+  it under the terms of the GNU General Public License, version 2, as 
+  published by the Free Software Foundation.
+
+  This program is distributed in the hope that it will be useful,
+  but WITHOUT ANY WARRANTY; without even the implied warranty of
+  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+  GNU General Public License for more details.
+
+  You should have received a copy of the GNU General Public License
+  along with this program; if not, write to the Free Software
+  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
+  
+*/
+class AsynchronousJS {
+	private static $queue = array();
+	private static $depends = array();
+	private static $head_loaded = false;
+
+	function init() {
+		if(!defined('WP_ADMIN') || !WP_ADMIN){
+			add_action('wp_print_scripts', 'AsynchronousJS::action_prevent_script_output' );
+			add_filter('script_loader_src', 'AsynchronousJS::filter_queue_script', 10, 2 );
+			add_filter('print_footer_scripts', 'AsynchronousJS::filter_headjs' );
+			add_filter('print_head_scripts', 'AsynchronousJS::filter_headjs' );
+		}
+	}
+
+	/**
+	 * Prevent wordpress from outputing scripts to page
+	 **/
+	function action_prevent_script_output() {
+		global $wp_scripts, $concatenate_scripts;
+
+		$concatenate_scripts = true;
+		$wp_scripts->do_concat = true;
+	}
+	
+
+	/**
+	 * Wordpress has no ability to hook into script queuing, so this is a work around
+	 **/
+	function filter_queue_script($src, $handle) {
+		self::$queue[$handle] = "{'{$handle}': '$src'}";
+	}
+
+	/**
+	 * Outputs headjs code in header or footer
+	 **/
+	function filter_headjs(){
+		if(count(self::$queue) > 0){
+			if(!self::$head_loaded){
+				echo '<script type="text/javascript" src="' . plugins_url( '/js/head.load.min.js', __FILE__ ) . '"></script>';
+			
+				self::$head_loaded = true;
+			}
+
+			echo '<script type="text/javascript">head.js(' . implode(',', self::$queue) . ')</script>';
+
+			self::$queue = array();
+		}
+
+		if(count(self::$depends) > 0){
+			foreach(self::$depends as $handle => $depend){
+				if(is_array($depend['deps'])){
+					echo '<script type="text/javascript">head.ready("' . implode(',', $depend['deps']) . '", function(){head.js({"' . $handle . '": "' . $depend['src'] . '"})})</script>';
+				}elseif(is_string($depend['deps'])){
+					echo '<script type="text/javascript">head.ready("' . $depend['deps'] . '", function(){head.js({"' . $handle . '": "' . $depend['src'] . '"})})</script>';
+				}else{
+					echo '<script type="text/javascript">head.js({"' . $handle . '": "' . $depend['src'] . '"});</script>';
+				}
+			}
+
+			self::$depends = array();
+		}
+
+		return false; // prevent printing of javascript
+	}
+
+	function wp_enqueue_async_script($handle, $src, $deps){
+		self::$depends[$handle] = array(
+			'src' => $src,
+			'deps' => $deps
+		);
+	}
+}
+
+AsynchronousJS::init();
+?>