├── AsyncDeferScripts.php
├── README.md
├── composer.json
└── functions.php


/AsyncDeferScripts.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 
 3 | namespace wpscholar\WordPress;
 4 | 
 5 | /**
 6 |  * Class DeferScripts
 7 |  * @package wpscholar\WordPress
 8 |  */
 9 | class AsyncDeferScripts {
10 | 
11 |     public static function initialize() {
12 |         add_filter( 'script_loader_tag', array( __CLASS__, 'deferScripts' ), 10, 2 );
13 |         add_filter( 'script_loader_tag', array( __CLASS__, 'asyncScripts' ), 10, 2 );
14 |     }
15 | 
16 |     public static function deferScripts( $tag, $handle ) {
17 |         if ( wp_scripts()->get_data( $handle, 'defer' ) ) {
18 |             $tag = str_replace( '></', ' defer></', $tag );
19 |         }
20 | 
21 |         return $tag;
22 |     }
23 | 
24 |     public static function asyncScripts( $tag, $handle ) {
25 |         if ( wp_scripts()->get_data( $handle, 'async' ) ) {
26 |             $tag = str_replace( '></', ' async></', $tag );
27 |         }
28 | 
29 |         return $tag;
30 |     }
31 | 
32 | }
33 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # WordPress Async/Defer Scripts
 2 | 
 3 | A Composer library for asynchronously loading or deferring scripts in WordPress.
 4 | 
 5 | ## Requirements
 6 | 
 7 | - PHP 5.3+
 8 | - WordPress 4.2+
 9 | 
10 | ## Installation
11 | 
12 | Add the module to your code base via Composer
13 | 
14 | ```
15 | composer require wpscholar/wp-async-defer-scripts
16 | ```
17 | 
18 | Be sure to require the Composer autoloader in your project
19 | 
20 | ```php
21 | <?php
22 | 
23 | require __DIR__ . '/vendor/autoload.php';
24 | ```
25 | 
26 | ## Usage
27 | 
28 | How to asynchronously load a script:
29 | ```php
30 | <?php
31 | 
32 | add_action( 'wp_enqueue_scripts', function () {
33 | 	wp_enqueue_script( 'recaptcha', 'https://www.google.com/recaptcha/api.js' );
34 | 	wp_scripts()->add_data( 'recaptcha', 'async', true );
35 | } );
36 | ```
37 | 
38 | How to defer loading of a script:
39 | ```php
40 | <?php
41 | 
42 | add_action( 'wp_enqueue_scripts', function () {
43 | 	wp_enqueue_script( 'recaptcha', 'https://www.google.com/recaptcha/api.js' );
44 | 	wp_scripts()->add_data( 'recaptcha', 'defer', true );
45 | } );
46 | ```
47 | 
48 | ## Initialization
49 | 
50 | In most cases, you can simply follow the installation instructions and things will just work. However, if you are including this library outside of a WordPress plugin or theme, you may have to manually initialize the class:
51 | 
52 | ```php
53 | <?php
54 | 
55 | wpscholar\WordPress\AsyncDeferScripts::initialize();
56 | ```
57 | 


--------------------------------------------------------------------------------
/composer.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "name": "wpscholar/wp-async-defer-scripts",
 3 |     "type": "library",
 4 |     "license": "GPL-2.0+",
 5 |     "authors": [
 6 |         {
 7 |             "name": "Micah Wood",
 8 |             "email": "micah@wpscholar.com"
 9 |         }
10 |     ],
11 |     "autoload": {
12 |         "files": [
13 |             "functions.php"
14 |         ],
15 |         "psr-4": {
16 |             "wpscholar\\WordPress\\": ""
17 |         }
18 |     }
19 | }
20 | 


--------------------------------------------------------------------------------
/functions.php:
--------------------------------------------------------------------------------
1 | <?php
2 | 
3 | use \wpscholar\WordPress\AsyncDeferScripts;
4 | 
5 | // Only call our initialization function automatically if we are in a valid WordPress context
6 | if ( function_exists( 'add_filter' ) ) {
7 |     AsyncDeferScripts::initialize();
8 | }
9 | 


--------------------------------------------------------------------------------