Added Bower

Author: dmhendricks

.bowerrc

@@ -0,0 +1,6 @@
+{
+  "directory" : "assets/components",
+  "ignoredDependencies": [
+    "jquery"
+  ]
+}

.gitignore

@@ -49,7 +49,7 @@ package-lock.json
 
 # Bower #
 #########
-assets/bower_components/*
+assets/components/
 
 # Codekit #
 ###########

README.md

@@ -14,7 +14,7 @@ It may also be used as the means of [separating custom code](http://www.billeric
 
 * Namespaces & dependency autoloading
 * Version checking (PHP, Carbon Fields)
-* [Gulp](https://gulpjs.com/) for JavaScript/SASS processing & minification (see [Gulp](https://github.com/dmhendricks/wordpress-base-plugin/wiki#gulp) notes)
+* Powered by [Composer](https://getcomposer.org/), [Gulp](https://gulpjs.com/) and [Bower](https://bower.io/)
 * Object caching (where available; [usage examples](https://github.com/dmhendricks/wordpress-toolkit/wiki/ObjectCache))
 * Automatic translation file (`.pot`) creation. See [Translation](https://github.com/dmhendricks/wordpress-base-plugin/wiki#translation).
 * Shortcodes, widgets and custom post type (via [PostTypes](https://github.com/jjgrainger/PostTypes/)) examples
@@ -36,8 +36,29 @@ It may also be used as the means of [separating custom code](http://www.billeric
 
 ### Composer
 
-1. Modify `composer.json` to suit your needs
-1. Run `composer install` to install dependencies and autoload namespace
+1. Modify `composer.json` to suit your needs.
+1. Run `composer install` to install dependencies and autoload namespace.
+
+### NPM
+
+1. Modify `package.json` to suit your needs. Specifically, change the `config` section.
+1. Run `npm install` to install dependencies.
+
+### Bower
+
+This step is only necessary for the "Clear Cache" Ajax example. Whether or not you choose to use Bower is up to you. Alternatively, you may put JavaScript dependencies in `src/vendor` and enqueue `assets/js/wordpress-base-plugin-vendor.js` as needed.
+
+```
+$ bower install
+```
+
+### Gulp
+
+Using Gulp is also optional (but recommended). If you wish to try the base plugin with all of its examples, you will need to run Gulp to process the JavaScripts:
+
+```
+$ gulp
+```
 
 ### Next Steps
 
@@ -49,13 +70,17 @@ This plugin loads many of its defaults & settings from `plugin.json`. See [Confi
 
 ## Planned Features & TODO
 
+#### Before 3.0 Pre-Release
+
 * Update documentation to reflect recent changes
-* Add encrypt/decrypt example (`password` field with encrypted `hidden` field)
+* Add gulp task to package plugin as ZIP file; move NPM scripts to gulp tasks
+* Use [TGMPA](http://tgmpluginactivation.com/) for Carbon Fields dependency checking
+* Simplify/clean-up version checking in general
+
+#### Future Releases
+
 * Add Customizer example
 * Add dynamically-created CSS/JS files based on settings
-* Add gulp task to package plugin as zip file
-* Use [Bower](https://bower.io/) to manage vendor scripts and move `./src/js/vendor` to `./src/components`
-* Use [TGMPA](http://tgmpluginactivation.com/) for Carbon Fields dependency checking
 
 ## Change Log
 
@@ -65,6 +90,7 @@ Release changes are noted on the [Releases](https://github.com/dmhendricks/wordp
 
 * Bumped minimum PHP version check to 5.6
 * Added [Gulp](https://gulpjs.com/) for task automation (SASS, JS processing)
+* Added [Bower](https://bower.io/) to (optionally) load third-party scripts
 * Drastically refactored configuration management
 * Split out settings pages, shortcodes, CPT & widgets into separate files/classes (thanks [obstschale](https://github.com/obstschale/wordpress-base-plugin))
 * Added `wp-pot-cli` to `package.json` to create `.pot` translation file

app/EnqueueScripts.php

@@ -31,13 +31,13 @@ function __construct() {
   public function enqueue_frontend_scripts() {
 
     // Enqueue script dependencies
-    $this->enqueue_vendor_scripts();
+    $this->enqueue_bower_scripts();
 
     // Enqueuing custom CSS for child theme (Twentysixteen was used for testing)
     wp_enqueue_style( 'wordpress-base-plugin', $this->get_script_url('assets/css/wordpress-base-plugin.css'), null, $this->get_script_version('assets/css/wordpress-base-plugin.css') );
 
     // Enqueue frontend JavaScript
-    wp_enqueue_script( 'wordpress-base-plugin', $this->get_script_url('assets/js/wordpress-base-plugin.js'), array('jquery', 'wordpress-base-plugin-vendor'), $this->get_script_version('assets/js/wordpress-base-plugin.js'), true );
+    wp_enqueue_script( 'wordpress-base-plugin', $this->get_script_url('assets/js/wordpress-base-plugin.js'), array('jquery', 'jquery-waituntilexists'), $this->get_script_version('assets/js/wordpress-base-plugin.js'), true );
     wp_localize_script( 'wordpress-base-plugin', 'wpbp_ajax_filter_params', array( 'ajax_url' => admin_url( 'admin-ajax.php' ) ) );
 
   }
@@ -49,25 +49,25 @@ public function enqueue_frontend_scripts() {
   public function enqueue_admin_scripts() {
 
     // Enqueue script dependencies
-    $this->enqueue_vendor_scripts();
+    $this->enqueue_bower_scripts();
 
     // Enqueuing custom CSS for child theme (Twentysixteen was used for testing)
     wp_enqueue_style( 'wordpress-base-plugin', $this->get_script_url('assets/css/wordpress-base-plugin-admin.css'), null, $this->get_script_version('assets/css/wordpress-base-plugin-admin.css') );
 
     // Enqueue WP Admin JavaScript
-    wp_enqueue_script( 'wordpress-base-plugin-admin', $this->get_script_url('assets/js/wordpress-base-plugin-admin.js'), array('jquery', 'wordpress-base-plugin-vendor'), $this->get_script_version('assets/js/wordpress-base-plugin-admin.js'), true );
+    wp_enqueue_script( 'wordpress-base-plugin-admin', $this->get_script_url('assets/js/wordpress-base-plugin-admin.js'), array('jquery', 'jquery-waituntilexists'), $this->get_script_version('assets/js/wordpress-base-plugin-admin.js'), true );
     wp_localize_script( 'wordpress-base-plugin-admin', 'wpbp_ajax_filter_params', array( 'ajax_url' => admin_url( 'admin-ajax.php' ) ) );
 
   }
 
   /**
-    * Enqueue vendor scripts compiled from src/js/vendor
+    * Enqueue Bower components from assets/components
     * @since 0.3.0
     */
-  private function enqueue_vendor_scripts() {
+  private function enqueue_bower_scripts() {
 
     // Enqueue common (frontend/backend) JavaScript
-    wp_enqueue_script( 'wordpress-base-plugin-vendor', $this->get_script_url('assets/js/wordpress-base-plugin-vendor.js'), array('jquery'), $this->get_script_version('assets/js/wordpress-base-plugin-vendor.js'), true );
+    wp_enqueue_script( 'jquery-waituntilexists', $this->get_script_url('assets/components/jq.waituntilexists/jquery.waitUntilExists.min.js', false), array('jquery'), '0.1.0' );
 
   }
 
@@ -77,7 +77,7 @@ private function enqueue_vendor_scripts() {
     */
   public function enqueue_font_awesome() {
 
-    wp_enqueue_style( 'font-awesome', '//maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css', null, '4.7.0' );
+    wp_enqueue_style( 'font-awesome', '//maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css', null, '4.7.0', true );
 
   }
 

bower.json

@@ -0,0 +1,7 @@
+{
+  "name": "wordpress-base-plugin",
+  "dependencies": {
+    "jq.waituntilexists": "*"
+  },
+  "private": true
+}