How to load JavaScript like a WordPress Master

How to load JavaScript like a WordPress Master

WordPress - an open source powerful PHP platform to develop personal web blogs, WordPress is the most used blog system at present, and I also opened a personal blog base this platform recently.

At the time of this free HTML JavaScript tutorial, the WordPress founding organization has released version 3 - an extreme worthwhile upgrade. And if you're a WordPress developer, maybe you know the WordPress's disadvantages, one of them is the way to organize data, source code seems to be changed in every new version.

Only including JavaScript files in the WordPress platform, also is a big problem. So under the view of a web developer, which solution we should choose to have a better performance? Please go to the detailed post for more instructions about including JavaScript like a WordPress master.


Sampled by © JavaScriptBank.com

Ifyou're involved in WordPress development, a challenge that you're goingto face sooner or later is how to include JavaScript files efficiently.

In this tutorial, I'm going to show you the best way to do that.

Let's say you have a plugin that adds a custom shortcode. The shortcode needs some JavaScript code which requires jQuery.

If you're just starting out with WordPress development, you might be tempted to write something like this:

How a WordPress Youngling does it

add_action('wp_head', 'add_my_script'); function add_my_script() { ?><script type="text/javascript" src="<?php bloginfo('wpurl'); ?>/wp-content/plugins/my-plugin/jquery.js"></script><script type="text/javascript" src="<?php bloginfo('wpurl'); ?>/wp-content/plugins/my-plugin/my-script.js"></script><?php }

Let's see what's wrong with that approach:

Firstly, since WordPress 2.6, the user can move the wp-content directory wherever he wants. What does that mean? That's right: instant plugin breakage.

Secondly, if the user installs another plugin that also uses jQuery, the page will end up with jQuery being loaded twice.

Fortunately, WordPress lends us a hand with these two problems:

How a young Padawan does it

add_action('template_redirect', 'add_my_script'); function add_my_script() {wp_enqueue_script('my-script', plugins_url('my-script.js', __FILE__), array('jquery'), '1.0', true);}

The above script ultimately does what the first one does, except:

  • it gets the correct path for the file
  • it checks if jQuery has already been included or not
  • the script tag is written in the footer, so the page loads faster

That's an obvious improvement. But what if the shortcode appears on a single page?

You're needlessly including a file 99% of the time, causing slower page loads.

Notice that in the last two examples, we've been using the template_redirect action.

The trouble with wp_enqueue_script() is that you have to call it before wp_head()fires. So, before the page is rendered, you have to decide if youshould add your script or not. Not an easy call to make, is it?

Well, there's a secret method that will let you enqueue scripts after the entire page has been displayed.

The Jedi Knight way

add_action('wp_footer', 'print_my_script'); function print_my_script() {global $add_my_script, $wp_scripts; if ( ! $add_my_script )return; wp_register_script('my-script', plugins_url('my-script.js', __FILE__), array('jquery'), '1.0', true); $wp_scripts->do_items('my-script');}

In this case, the script will be enqueued only if the $add_my_script global was set at some point during the rendering of the page.

The key here is that you're calling $wp_scripts directly, instead of relying on WordPress to do it for you.

It will still check if jQuery was already enqueued or not.

You can set the $add_my_script flag from any function or method, including from a shortcode handler:

add_shortcode('myshortcode', 'my_shortcode_handler'); function my_shortcode_handler($atts) {global $add_my_script; $add_my_script = true; // actual shortcode handling here}

So, the script will be added if [myshortcode ...] was found in any of the posts on the current page.

Nothing more to do here, except wrap it up in a nice class:

The Jedi Master way

class My_Shortcode {static $add_script; function init() {add_shortcode('myshortcode', array(__CLASS__, 'handle_shortcode'));add_action('wp_footer', array(__CLASS__, 'add_script'));} function handle_shortcode($atts) {self::$add_script = true; // actual shortcode handling here} function add_script() {global $wp_scripts; if ( ! self::$add_script )return; wp_register_script('my-script', plugins_url('my-script.js', __FILE__), array('jquery'), '1.0', true); $wp_scripts->do_items('my-script');}} My_Shortcode::init();

I hope this tutorial has helped you on your way to mastering WordPress script loading.

Further reading:

Language
Translate this page to English Translate this page to French Translate this page to Vietnamese

Recent articles
Powerful JavaScript Applications Optimized for Mobile Platform with QRCode
10 Awesome CSS3 Tips & Tricks
Awesome WebGL Experiments with Stunning JavaScript Applications
Basis of JavaScript Structure with Dojo
2 Useful Tips about JavaScript Conditionals
Awesome JavaScript Tutorials to Create JavaScript Animations
Learn more about JavaScript Inheritance with Tiny JavaScript Example Codes
16 Best JavaScript Libraries for Wrapping HTML5 Canvas
CSS3 box-shadow Property Basics
Best jQuery / JavaScript Color Pickers


Top view articles
65 Free JavaScript Photo Gallery Solutions
Top 10 Beautiful Christmas Countdown Timers
Top 50 Most Addictive and Popular Facebook mini games
50+ Beautiful Resources of HTML Form using CSS and JavaScript
HTML5 Web Workers Multithreading in JavaScript
Top 10 Best JavaScript eBooks that Beginners should Learn
Using JavaScript to Change Your Web Page Font Size
Learn more about JavaScript Inheritance with Tiny JavaScript Example Codes
Top 10 Free Web Chat box Plug-ins and Add-ons
The Ultimate JavaScript Tutorial in Web Design


Free JavaScript Tutorials & Articles
at www.JavaScriptBank.com
<center>This page uses FRAME but your browser do not support. You can enter through <a href="http://www.javascriptbank.com/javascript/article/How_to_load_JavaScript_like_a_WordPress_Master.php">http://www.javascriptbank.com/javascript/article/How_to_load_JavaScript_like_a_WordPress_Master.php</a> </center>