From e2c4f5c629b07627c661a36758cfc63c438796c0 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 20:06:02 -0400
Subject: [PATCH 1/8] working example with testse

---
 packages/plugin-google-analytics/README.md    |  37 ++++++
 packages/plugin-google-analytics/package.json |  21 ++++
 packages/plugin-google-analytics/src/index.js |  20 ++++
 .../test/cases/default/default.spec.js        | 107 ++++++++++++++++++
 .../test/cases/default/greenwood.config.js    |   7 ++
 .../error-analytics-id/greenwood.config.js    |   7 ++
 test/smoke-test.js                            |  14 +--
 7 files changed, 203 insertions(+), 10 deletions(-)
 create mode 100644 packages/plugin-google-analytics/README.md
 create mode 100644 packages/plugin-google-analytics/package.json
 create mode 100644 packages/plugin-google-analytics/src/index.js
 create mode 100644 packages/plugin-google-analytics/test/cases/default/default.spec.js
 create mode 100644 packages/plugin-google-analytics/test/cases/default/greenwood.config.js
 create mode 100644 packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js

diff --git a/packages/plugin-google-analytics/README.md b/packages/plugin-google-analytics/README.md
new file mode 100644
index 000000000..0625cad34
--- /dev/null
+++ b/packages/plugin-google-analytics/README.md
@@ -0,0 +1,37 @@
+# @greenwood/plugin-google-analytics
+
+## Overview
+A composite plugin for Greenwood for adding support for [Google Analytics](https://developers.google.com/analytics/) JavaScript tracker. For more information and complete docs about Greenwood, please visit the [Greenwood website](https://www.greenwoodjs.io/docs).  
+
+> This package assumes you already have `@greenwood/cli` installed.
+
+## Installation
+You can use your favorite JavaScript package manager to install this package.
+
+_examples:_
+```bash
+# npm
+npm -i @greenwood/plugin-google-analytics --save-dev
+
+# yarn
+yarn add @greenwood/plugin-google-analytics --dev
+```
+
+## Usage
+Use this plugin in your _greenwood.config.js_ and simply pass in your Google Analytics ID, e.g. `UA-XXXXX`.
+
+> As this is a composite plugin, you will need to spread the result.
+
+```javascript
+const googleAnalyticsPlugin = require('@greenwood/plugin-google-analytics');
+
+module.exports = {
+  ...
+
+  plugins: [
+    ...googleAnalyticsPlugin('UA-XXXXXX')
+  ]
+}
+```
+
+This will then add the Google Analytics [JavaScript tracker snippet](https://developers.google.com/analytics/devguides/collection/analyticsjs/) to your project's _index.html_.
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/package.json b/packages/plugin-google-analytics/package.json
new file mode 100644
index 000000000..3b868783d
--- /dev/null
+++ b/packages/plugin-google-analytics/package.json
@@ -0,0 +1,21 @@
+{
+  "name": "@greenwood/plugin-google-analytics",
+  "version": "0.3.6",
+  "description": "A composite plugin for Greenwood for adding support for Google Analytics.",
+  "repository": "https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-google-analytics",
+  "author": "Owen Buckley <owen@thegreenhouse.io>",
+  "license": "MIT",
+  "main": "src/index.js",
+  "files": [
+    "src/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@greenwood/cli": "^0.3.6"
+  },
+  "dependencies": {
+
+  }
+}
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/src/index.js b/packages/plugin-google-analytics/src/index.js
new file mode 100644
index 000000000..ff98d1935
--- /dev/null
+++ b/packages/plugin-google-analytics/src/index.js
@@ -0,0 +1,20 @@
+module.exports = (analyticsId) => {
+  return [{
+    type: 'index',
+    provider: () => {
+      return {
+        hookAnalytics: `
+          <!-- Google Analytics -->
+          <script>
+            window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
+            ga('create', '${analyticsId}', 'auto');
+            ga('send', 'pageview');
+          </script>
+          
+          <script async src='https://www.google-analytics.com/analytics.js'></script>
+          <!-- End Google Analytics -->
+        `
+      };
+    }
+  }];
+};
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/default/default.spec.js b/packages/plugin-google-analytics/test/cases/default/default.spec.js
new file mode 100644
index 000000000..41a26e839
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/default/default.spec.js
@@ -0,0 +1,107 @@
+/*
+ * Use Case
+ * Run Greenwood with Google Analytics composite plugin.
+ * 
+ * Uaer Result
+ * Should generate a bare bones Greenwood build with certain plugins injected into index.html.
+ * 
+ * User Command
+ * greenwood build
+ * 
+ * User Config
+ * {
+ *   plugins: [{
+ *     type: 'index',
+ *     provider: () => {
+ *       return {
+ *         hookAnalytics: `
+ *           <!-- Google Analytics setup script -->
+ *         `
+ *       };
+ *     }
+ *  }]
+ * 
+ * }
+ * 
+ * User Workspace
+ * Greenwood default (src/)
+ */
+const expect = require('chai').expect;
+const { JSDOM } = require('jsdom');
+const path = require('path');
+const runSmokeTest = require('../../../../../test/smoke-test');
+const TestBed = require('../../../../../test/test-bed');
+
+describe.only('Build Greenwood With: ', async function() {
+  const LABEL = 'Google Analytics Plugin and Default Workspace';
+  let setup;
+
+  before(async function() {
+    setup = new TestBed();
+    this.context = setup.setupTestBed(__dirname);
+  });
+  
+  describe(LABEL, function() {
+    before(async function() {     
+      await setup.runGreenwoodCommand('build');
+    });
+    
+    runSmokeTest(['public', 'index', 'not-found', 'hello'], LABEL);
+
+    describe('Initialization script at the end of the <body> tag', function() {
+      let inlineScript;
+
+      beforeEach(async function() {
+        const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
+        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
+
+        inlineScript = Array.prototype.slice.call(scriptTags).filter(script => {
+          return !script.src;
+        });
+
+      });
+
+      it('should be one inline <script> tag', function() {
+        expect(inlineScript.length).to.be.equal(1);
+      });
+
+      it('should have the expected code with users analyicsId', function() {
+        const expectedContent = `
+            window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
+            ga('create', 'UA-123456', 'auto');
+            ga('send', 'pageview');
+        `;
+
+        expect(inlineScript[0].textContent).to.contain(expectedContent);
+      });
+    });
+
+    describe('Tracking script at the end of the <body> tag', function() {
+      let trackingScript; 
+
+      beforeEach(async function() {
+        const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
+        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
+        
+        trackingScript = Array.prototype.slice.call(scriptTags).filter(script => {
+          return script.src === 'https://www.google-analytics.com/analytics.js';
+        });
+      });
+
+      it('should have one <script> tag for loading the Google Analytics tracker', function() {
+        expect(trackingScript.length).to.be.equal(1);
+      });
+
+      it('should be an async <script> tag for loading the Google Analytics tracker', function() {
+        const isAsync = trackingScript[0].async !== null;
+
+        expect(isAsync).to.be.equal(true);
+      });
+    });
+  });
+  
+  after(function() {
+    setup.teardownTestBed();
+  });
+
+});
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/default/greenwood.config.js b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
new file mode 100644
index 000000000..175ed3135
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
@@ -0,0 +1,7 @@
+const googleAnalyticsPlugin = require('../../../src/index');
+
+module.exports = {
+  plugins: [
+    ...googleAnalyticsPlugin('UA-123456')
+  ]
+};
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js b/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js
new file mode 100644
index 000000000..c2d3d48ee
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js
@@ -0,0 +1,7 @@
+const googleAnalyticsPlugin = require('../../../src/index');
+
+module.exports = {
+  plugins: [
+    googleAnalyticsPlugin()
+  ]
+};
\ No newline at end of file
diff --git a/test/smoke-test.js b/test/smoke-test.js
index bef95d40b..1c860b4f8 100644
--- a/test/smoke-test.js
+++ b/test/smoke-test.js
@@ -86,14 +86,8 @@ function defaultIndex(label) {
         expect(title).to.be.equal('Greenwood App');
       });
 
-      it('should have three <script> tags in the <body>', function() {
-        const scriptTag = dom.window.document.querySelectorAll('body script');
-
-        expect(scriptTag.length).to.be.equal(3);
-      });
-
-      it('should have two polyfill <script> tags in the <body>', function() {
-        const scriptTags = dom.window.document.querySelectorAll('body script');
+      it('should have two <script> tags for polyfills loaded at the end of the <body> tag', function() {
+        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
         const polyfillScriptTags = Array.prototype.slice.call(scriptTags).filter(script => {
           return script.src.indexOf('//cdnjs.cloudflare.com') >= 0;
         });
@@ -101,8 +95,8 @@ function defaultIndex(label) {
         expect(polyfillScriptTags.length).to.be.equal(2);
       });
 
-      it('should have one bundle <script> tag in the <body>', function() {
-        const scriptTags = dom.window.document.querySelectorAll('body script');
+      it('should have <script> tag for loading main JavaScript bundle at the end of the <body> tag', function() {
+        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
         const bundleScripts = Array.prototype.slice.call(scriptTags).filter(script => {
           const src = script.src;
 

From e63168560a4ffba0f3a3bf52fbea3f735f16d0a5 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 20:20:18 -0400
Subject: [PATCH 2/8] error handling

---
 packages/plugin-google-analytics/src/index.js |  6 +++
 .../test/cases/default/default.spec.js        | 13 ++---
 .../error-analytics-id.spec.js                | 49 +++++++++++++++++++
 .../error-analytics-id/greenwood.config.js    |  2 +-
 4 files changed, 60 insertions(+), 10 deletions(-)
 create mode 100644 packages/plugin-google-analytics/test/cases/error-analytics-id/error-analytics-id.spec.js

diff --git a/packages/plugin-google-analytics/src/index.js b/packages/plugin-google-analytics/src/index.js
index ff98d1935..f131e4d2f 100644
--- a/packages/plugin-google-analytics/src/index.js
+++ b/packages/plugin-google-analytics/src/index.js
@@ -1,4 +1,10 @@
 module.exports = (analyticsId) => {
+  const validId = analyticsId && typeof analyticsId === 'string';
+
+  if (!validId) {
+    throw new Error(`Error: analyticsId should be of type string.  get "${typeof analyticsId}" instead.`);
+  }
+
   return [{
     type: 'index',
     provider: () => {
diff --git a/packages/plugin-google-analytics/test/cases/default/default.spec.js b/packages/plugin-google-analytics/test/cases/default/default.spec.js
index 41a26e839..bf6a13aff 100644
--- a/packages/plugin-google-analytics/test/cases/default/default.spec.js
+++ b/packages/plugin-google-analytics/test/cases/default/default.spec.js
@@ -9,16 +9,11 @@
  * greenwood build
  * 
  * User Config
+ * const googleAnalyticsPlugin = require('@greenwod/plugin-google-analytics');
+ * 
  * {
  *   plugins: [{
- *     type: 'index',
- *     provider: () => {
- *       return {
- *         hookAnalytics: `
- *           <!-- Google Analytics setup script -->
- *         `
- *       };
- *     }
+ *     ...googleAnalyticsPlugin()
  *  }]
  * 
  * }
@@ -32,7 +27,7 @@ const path = require('path');
 const runSmokeTest = require('../../../../../test/smoke-test');
 const TestBed = require('../../../../../test/test-bed');
 
-describe.only('Build Greenwood With: ', async function() {
+describe('Build Greenwood With: ', async function() {
   const LABEL = 'Google Analytics Plugin and Default Workspace';
   let setup;
 
diff --git a/packages/plugin-google-analytics/test/cases/error-analytics-id/error-analytics-id.spec.js b/packages/plugin-google-analytics/test/cases/error-analytics-id/error-analytics-id.spec.js
new file mode 100644
index 000000000..47ef6a996
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/error-analytics-id/error-analytics-id.spec.js
@@ -0,0 +1,49 @@
+/*
+ * Use Case
+ * Run Greenwood with Google Analytics composite plugin.
+ * 
+ * Uaer Result
+ * Should generate an error when not passing in a valid analyticsId.
+ * 
+ * User Command
+ * greenwood build
+ * 
+ * User Config
+ * const googleAnalyticsPlugin = require('@greenwod/plugin-google-analytics');
+ * 
+ * {
+ *   plugins: [{
+ *     ...googleAnalyticsPlugin()
+ *  }]
+ * 
+ * }
+ * 
+ * User Workspace
+ * Greenwood default (src/)
+ */
+const expect = require('chai').expect;
+const TestBed = require('../../../../../test/test-bed');
+
+describe('Build Greenwood With: ', async function() {
+  let setup;
+
+  before(async function() {
+    setup = new TestBed();
+    this.context = setup.setupTestBed(__dirname);
+  });
+    
+  describe('Google Analytics Plugin with a bad value for analyticsId', () => {
+    it('should throw an error that analyticsId must be a string', async () => {
+      try { 
+        await setup.runGreenwoodCommand('build');
+      } catch (err) {
+        expect(err).to.contain('analyticsId should be of type string.  get "undefined" instead.');
+      }
+    });
+  });
+  
+  after(function() {
+    setup.teardownTestBed();
+  });
+
+});
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js b/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js
index c2d3d48ee..597d8216b 100644
--- a/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js
+++ b/packages/plugin-google-analytics/test/cases/error-analytics-id/greenwood.config.js
@@ -2,6 +2,6 @@ const googleAnalyticsPlugin = require('../../../src/index');
 
 module.exports = {
   plugins: [
-    googleAnalyticsPlugin()
+    ...googleAnalyticsPlugin()
   ]
 };
\ No newline at end of file

From fd4814580f493b369edd2de22695e045cbc8a461 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 20:41:43 -0400
Subject: [PATCH 3/8] update GA script and specs and integrated into the
 website

---
 greenwood.config.js                              |  4 ++++
 packages/cli/src/templates/index.html            |  4 ++--
 packages/plugin-google-analytics/src/index.js    | 14 +++++++-------
 .../test/cases/default/default.spec.js           | 16 ++++++++++------
 .../test/cases/default/greenwood.config.js       |  2 +-
 test/smoke-test.js                               |  6 ++++++
 6 files changed, 30 insertions(+), 16 deletions(-)

diff --git a/greenwood.config.js b/greenwood.config.js
index b2b8338d0..d51068ccc 100644
--- a/greenwood.config.js
+++ b/greenwood.config.js
@@ -1,3 +1,4 @@
+const googleAnalyticsPlugin = require('./packages/plugin-google-analytics/src/index');
 const path = require('path');
 
 const META_DESCRIPTION = 'A modern and performant static site generator supporting Web Component based development';
@@ -16,5 +17,8 @@ module.exports = {
     { property: 'og:description', content: META_DESCRIPTION },
     { rel: 'shortcut icon', href: FAVICON_HREF },
     { rel: 'icon', href: FAVICON_HREF }
+  ],
+  plugins: [
+    ...googleAnalyticsPlugin('UA-147204327-1')
   ]
 };
\ No newline at end of file
diff --git a/packages/cli/src/templates/index.html b/packages/cli/src/templates/index.html
index a222def56..8a7f460ef 100644
--- a/packages/cli/src/templates/index.html
+++ b/packages/cli/src/templates/index.html
@@ -14,6 +14,8 @@
     <!-- Error is a known issue: https://github.com/webcomponents/webcomponentsjs/issues/749 -->
     <!-- <script src="https://cdnjs.cloudflare.com/ajax/libs/webcomponentsjs/2.0.2/custom-elements-es5-adapter.js"></script> -->
 
+    <%= htmlWebpackPlugin.options.hookAnalytics %>
+    
     <%= htmlWebpackPlugin.options.hookSpaIndexFallback %>
   </head>
 
@@ -21,8 +23,6 @@
   
     <eve-app></eve-app>
 
-    <%= htmlWebpackPlugin.options.hookAnalytics %>
-
     <%= htmlWebpackPlugin.options.hookPolyfills %>
 
     <!-- JavaScript polyfill FOR IE11 -->
diff --git a/packages/plugin-google-analytics/src/index.js b/packages/plugin-google-analytics/src/index.js
index f131e4d2f..b57bf885f 100644
--- a/packages/plugin-google-analytics/src/index.js
+++ b/packages/plugin-google-analytics/src/index.js
@@ -10,15 +10,15 @@ module.exports = (analyticsId) => {
     provider: () => {
       return {
         hookAnalytics: `
-          <!-- Google Analytics -->
+          <script async src="https://www.googletagmanager.com/gtag/js?id=${analyticsId}"></script>
+          
           <script>
-            window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
-            ga('create', '${analyticsId}', 'auto');
-            ga('send', 'pageview');
+            window.dataLayer = window.dataLayer || [];
+            function gtag(){dataLayer.push(arguments);}
+            gtag('js', new Date());
+
+            gtag('config', '${analyticsId}');
           </script>
-          
-          <script async src='https://www.google-analytics.com/analytics.js'></script>
-          <!-- End Google Analytics -->
         `
       };
     }
diff --git a/packages/plugin-google-analytics/test/cases/default/default.spec.js b/packages/plugin-google-analytics/test/cases/default/default.spec.js
index bf6a13aff..67685cea9 100644
--- a/packages/plugin-google-analytics/test/cases/default/default.spec.js
+++ b/packages/plugin-google-analytics/test/cases/default/default.spec.js
@@ -29,6 +29,8 @@ const TestBed = require('../../../../../test/test-bed');
 
 describe('Build Greenwood With: ', async function() {
   const LABEL = 'Google Analytics Plugin and Default Workspace';
+  const analyticsId = 'UA-123456-1';
+
   let setup;
 
   before(async function() {
@@ -48,7 +50,7 @@ describe('Build Greenwood With: ', async function() {
 
       beforeEach(async function() {
         const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
-        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
+        const scriptTags = dom.window.document.querySelectorAll('head script');
 
         inlineScript = Array.prototype.slice.call(scriptTags).filter(script => {
           return !script.src;
@@ -62,9 +64,11 @@ describe('Build Greenwood With: ', async function() {
 
       it('should have the expected code with users analyicsId', function() {
         const expectedContent = `
-            window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)};ga.l=+new Date;
-            ga('create', 'UA-123456', 'auto');
-            ga('send', 'pageview');
+            window.dataLayer = window.dataLayer || [];
+            function gtag(){dataLayer.push(arguments);}
+            gtag('js', new Date());
+
+            gtag('config', '${analyticsId}');
         `;
 
         expect(inlineScript[0].textContent).to.contain(expectedContent);
@@ -76,10 +80,10 @@ describe('Build Greenwood With: ', async function() {
 
       beforeEach(async function() {
         const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
-        const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
+        const scriptTags = dom.window.document.querySelectorAll('head script');
         
         trackingScript = Array.prototype.slice.call(scriptTags).filter(script => {
-          return script.src === 'https://www.google-analytics.com/analytics.js';
+          return script.src === `https://www.googletagmanager.com/gtag/js?id=${analyticsId}`;
         });
       });
 
diff --git a/packages/plugin-google-analytics/test/cases/default/greenwood.config.js b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
index 175ed3135..af0d429bd 100644
--- a/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
+++ b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
@@ -2,6 +2,6 @@ const googleAnalyticsPlugin = require('../../../src/index');
 
 module.exports = {
   plugins: [
-    ...googleAnalyticsPlugin('UA-123456')
+    ...googleAnalyticsPlugin('UA-123456-1')
   ]
 };
\ No newline at end of file
diff --git a/test/smoke-test.js b/test/smoke-test.js
index 1c860b4f8..23d08b078 100644
--- a/test/smoke-test.js
+++ b/test/smoke-test.js
@@ -86,6 +86,12 @@ function defaultIndex(label) {
         expect(title).to.be.equal('Greenwood App');
       });
 
+      it('should have three <script> tags in the <body>', function() {
+        const scriptTag = dom.window.document.querySelectorAll('body script');
+
+        expect(scriptTag.length).to.be.equal(3);
+      });
+      
       it('should have two <script> tags for polyfills loaded at the end of the <body> tag', function() {
         const scriptTags = dom.window.document.querySelectorAll('body eve-app ~ script');
         const polyfillScriptTags = Array.prototype.slice.call(scriptTags).filter(script => {

From 732bed8530a96a766f14672c6a7e6346169a2a11 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 21:06:18 -0400
Subject: [PATCH 4/8] custom plugins page

---
 www/components/shelf/plugins.json   |  5 +++++
 www/pages/plugins/custom-plugins.md |  8 ++++++++
 www/styles/page.css                 | 12 ++++++++++++
 3 files changed, 25 insertions(+)
 create mode 100644 www/pages/plugins/custom-plugins.md

diff --git a/www/components/shelf/plugins.json b/www/components/shelf/plugins.json
index df75c8a2b..524c64a95 100644
--- a/www/components/shelf/plugins.json
+++ b/www/components/shelf/plugins.json
@@ -3,5 +3,10 @@
     "index": 0,
     "name": "Index Hooks",
     "path": "/plugins/index-hooks"
+  },
+  {
+    "index": 1,
+    "name": "Custom Plugins",
+    "path": "/plugins/custom-plugins"
   }
 ]
\ No newline at end of file
diff --git a/www/pages/plugins/custom-plugins.md b/www/pages/plugins/custom-plugins.md
new file mode 100644
index 000000000..424dd429b
--- /dev/null
+++ b/www/pages/plugins/custom-plugins.md
@@ -0,0 +1,8 @@
+## Custom Plugins
+To support development of Greenwood based projects, Greenwood provides some custom "composite" plugins that you can use to quickly build out your project.  The following components that are built and maintained by the Greenwood team have been provided in the table below, with links to their README's that includes installation and usage steps.
+
+| Name  | Description  |
+|---|---|
+| [Google Analytics](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-google-analytics) | Easily add usage tracking to your site with Google Analytics. |
+
+> See something missing that you would like to have?  Please [request it](https://github.com/ProjectEvergreen/greenwood/issues)!
\ No newline at end of file
diff --git a/www/styles/page.css b/www/styles/page.css
index e2e680a60..4343b7b22 100644
--- a/www/styles/page.css
+++ b/www/styles/page.css
@@ -66,4 +66,16 @@
       height: 100%;
     }
   }
+
+  & table {
+    border: 1px solid #020202;
+    width: 100%;
+    text-align: center;
+    margin-bottom: 20px;
+  }
+
+  & table th {
+    background-color: #f9e7ca;
+    text-decoration: underline;
+  }
 }

From 6dce78c7367950419b7fbe08f7aecf50545650ca Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 21:13:07 -0400
Subject: [PATCH 5/8] finish docs

---
 www/components/shelf/plugins.json      |  4 ++--
 www/pages/plugins/composite-plugins.md | 10 ++++++++++
 www/pages/plugins/custom-plugins.md    |  8 --------
 3 files changed, 12 insertions(+), 10 deletions(-)
 create mode 100644 www/pages/plugins/composite-plugins.md
 delete mode 100644 www/pages/plugins/custom-plugins.md

diff --git a/www/components/shelf/plugins.json b/www/components/shelf/plugins.json
index 524c64a95..43975011d 100644
--- a/www/components/shelf/plugins.json
+++ b/www/components/shelf/plugins.json
@@ -6,7 +6,7 @@
   },
   {
     "index": 1,
-    "name": "Custom Plugins",
-    "path": "/plugins/custom-plugins"
+    "name": "Composite Plugins",
+    "path": "/plugins/composite-plugins"
   }
 ]
\ No newline at end of file
diff --git a/www/pages/plugins/composite-plugins.md b/www/pages/plugins/composite-plugins.md
new file mode 100644
index 000000000..2d46f1dd3
--- /dev/null
+++ b/www/pages/plugins/composite-plugins.md
@@ -0,0 +1,10 @@
+## Compostie Plugins
+Greenwood provides some custom "composite" plugins that are tasked with providing specific functionality to your project, built using the available plugin types already provided by Greenwood.  
+
+The available plugins built and maintained by Greenwood team and contibutors have been provided in the table below, with links to their README with the appropriate installation and usage steps.
+
+| Name  | Description  |
+|---|---|
+| [Google Analytics](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-google-analytics) | Easily add usage tracking to your site with Google Analytics. |
+
+> See something missing?  Please review our [open issues](https://github.com/ProjectEvergreen/greenwood/issues), we might be [working on it](https://github.com/ProjectEvergreen/greenwood/projects)!  Or if not, please request it, we would be interested to learn how you need to use Greenwod and how the team can help!
\ No newline at end of file
diff --git a/www/pages/plugins/custom-plugins.md b/www/pages/plugins/custom-plugins.md
deleted file mode 100644
index 424dd429b..000000000
--- a/www/pages/plugins/custom-plugins.md
+++ /dev/null
@@ -1,8 +0,0 @@
-## Custom Plugins
-To support development of Greenwood based projects, Greenwood provides some custom "composite" plugins that you can use to quickly build out your project.  The following components that are built and maintained by the Greenwood team have been provided in the table below, with links to their README's that includes installation and usage steps.
-
-| Name  | Description  |
-|---|---|
-| [Google Analytics](https://github.com/ProjectEvergreen/greenwood/tree/master/packages/plugin-google-analytics) | Easily add usage tracking to your site with Google Analytics. |
-
-> See something missing that you would like to have?  Please [request it](https://github.com/ProjectEvergreen/greenwood/issues)!
\ No newline at end of file

From 5a71cd15369df16b899f2373860170df9300f676 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Thu, 5 Sep 2019 21:19:39 -0400
Subject: [PATCH 6/8] clean up package.json

---
 packages/plugin-google-analytics/package.json | 3 ---
 1 file changed, 3 deletions(-)

diff --git a/packages/plugin-google-analytics/package.json b/packages/plugin-google-analytics/package.json
index 3b868783d..df5dd1209 100644
--- a/packages/plugin-google-analytics/package.json
+++ b/packages/plugin-google-analytics/package.json
@@ -14,8 +14,5 @@
   },
   "peerDependencies": {
     "@greenwood/cli": "^0.3.6"
-  },
-  "dependencies": {
-
   }
 }
\ No newline at end of file

From e3d49142a2b2aa4026549bb063ce20085cf61384 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Fri, 6 Sep 2019 09:01:24 -0400
Subject: [PATCH 7/8] anonymous IP tracking

---
 greenwood.config.js                           |   4 +-
 nyc.config.js                                 |   3 +-
 packages/plugin-google-analytics/README.md    |  10 +-
 packages/plugin-google-analytics/src/index.js |   6 +-
 .../test/cases/default/default.spec.js        |  15 ++-
 .../test/cases/default/greenwood.config.js    |   4 +-
 .../option-anonymous/greenwood.config.js      |  10 ++
 .../option-anonymous/option-anonymous.spec.js | 110 ++++++++++++++++++
 8 files changed, 150 insertions(+), 12 deletions(-)
 create mode 100644 packages/plugin-google-analytics/test/cases/option-anonymous/greenwood.config.js
 create mode 100644 packages/plugin-google-analytics/test/cases/option-anonymous/option-anonymous.spec.js

diff --git a/greenwood.config.js b/greenwood.config.js
index d51068ccc..00a86aeb2 100644
--- a/greenwood.config.js
+++ b/greenwood.config.js
@@ -19,6 +19,8 @@ module.exports = {
     { rel: 'icon', href: FAVICON_HREF }
   ],
   plugins: [
-    ...googleAnalyticsPlugin('UA-147204327-1')
+    ...googleAnalyticsPlugin({
+      analyticsId: 'UA-147204327-1'
+    })
   ]
 };
\ No newline at end of file
diff --git a/nyc.config.js b/nyc.config.js
index 1e919000f..b45710ae8 100644
--- a/nyc.config.js
+++ b/nyc.config.js
@@ -6,7 +6,8 @@ module.exports = {
     'packages/cli/src/lib/*.js',
     'packages/cli/src/lifecycles/*.js',
     'packages/cli/src/plugins/*.js',
-    'packages/cli/src/tasks/*.js'
+    'packages/cli/src/tasks/*.js',
+    'packages/plugin-*/src/*.js'
   ],
 
   reporter: [
diff --git a/packages/plugin-google-analytics/README.md b/packages/plugin-google-analytics/README.md
index 0625cad34..4008dee32 100644
--- a/packages/plugin-google-analytics/README.md
+++ b/packages/plugin-google-analytics/README.md
@@ -29,9 +29,15 @@ module.exports = {
   ...
 
   plugins: [
-    ...googleAnalyticsPlugin('UA-XXXXXX')
+    ...googleAnalyticsPlugin({
+      analyticsId: 'UA-XXXXXX'
+    })
   ]
 }
 ```
 
-This will then add the Google Analytics [JavaScript tracker snippet](https://developers.google.com/analytics/devguides/collection/analyticsjs/) to your project's _index.html_.
\ No newline at end of file
+This will then add the Google Analytics [JavaScript tracker snippet](https://developers.google.com/analytics/devguides/collection/analyticsjs/) to your project's _index.html_.
+
+### Options
+- `analyticsId` (required) - Your Google Analytics ID
+- `anonymous` (optional) - If tracking of IPs should be done anonymously.  Defaults to `true`
diff --git a/packages/plugin-google-analytics/src/index.js b/packages/plugin-google-analytics/src/index.js
index b57bf885f..ef97a1e6b 100644
--- a/packages/plugin-google-analytics/src/index.js
+++ b/packages/plugin-google-analytics/src/index.js
@@ -1,5 +1,8 @@
-module.exports = (analyticsId) => {
+module.exports = (options = {}) => {
+  const { analyticsId, anonymous } = options;
+
   const validId = analyticsId && typeof analyticsId === 'string';
+  const trackAnon = typeof anonymous === 'boolean' ? anonymous : true;
 
   if (!validId) {
     throw new Error(`Error: analyticsId should be of type string.  get "${typeof analyticsId}" instead.`);
@@ -17,6 +20,7 @@ module.exports = (analyticsId) => {
             function gtag(){dataLayer.push(arguments);}
             gtag('js', new Date());
 
+            gtag('config', '${analyticsId}', { 'anonymize_ip': ${trackAnon} });
             gtag('config', '${analyticsId}');
           </script>
         `
diff --git a/packages/plugin-google-analytics/test/cases/default/default.spec.js b/packages/plugin-google-analytics/test/cases/default/default.spec.js
index 67685cea9..9acb75fe2 100644
--- a/packages/plugin-google-analytics/test/cases/default/default.spec.js
+++ b/packages/plugin-google-analytics/test/cases/default/default.spec.js
@@ -1,6 +1,6 @@
 /*
  * Use Case
- * Run Greenwood with Google Analytics composite plugin.
+ * Run Greenwood with Google Analytics composite plugin with default options.
  * 
  * Uaer Result
  * Should generate a bare bones Greenwood build with certain plugins injected into index.html.
@@ -13,7 +13,9 @@
  * 
  * {
  *   plugins: [{
- *     ...googleAnalyticsPlugin()
+ *     ...googleAnalyticsPlugin({
+ *       analyticsId: 'UA-123456-1'
+ *     })
  *  }]
  * 
  * }
@@ -28,8 +30,8 @@ const runSmokeTest = require('../../../../../test/smoke-test');
 const TestBed = require('../../../../../test/test-bed');
 
 describe('Build Greenwood With: ', async function() {
-  const LABEL = 'Google Analytics Plugin and Default Workspace';
-  const analyticsId = 'UA-123456-1';
+  const LABEL = 'Google Analytics Plugin with default options and Default Workspace';
+  const mockAnalyticsId = 'UA-123456-1';
 
   let setup;
 
@@ -68,7 +70,8 @@ describe('Build Greenwood With: ', async function() {
             function gtag(){dataLayer.push(arguments);}
             gtag('js', new Date());
 
-            gtag('config', '${analyticsId}');
+            gtag('config', '${mockAnalyticsId}', { 'anonymize_ip': true });
+            gtag('config', '${mockAnalyticsId}');
         `;
 
         expect(inlineScript[0].textContent).to.contain(expectedContent);
@@ -83,7 +86,7 @@ describe('Build Greenwood With: ', async function() {
         const scriptTags = dom.window.document.querySelectorAll('head script');
         
         trackingScript = Array.prototype.slice.call(scriptTags).filter(script => {
-          return script.src === `https://www.googletagmanager.com/gtag/js?id=${analyticsId}`;
+          return script.src === `https://www.googletagmanager.com/gtag/js?id=${mockAnalyticsId}`;
         });
       });
 
diff --git a/packages/plugin-google-analytics/test/cases/default/greenwood.config.js b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
index af0d429bd..9b18283c0 100644
--- a/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
+++ b/packages/plugin-google-analytics/test/cases/default/greenwood.config.js
@@ -2,6 +2,8 @@ const googleAnalyticsPlugin = require('../../../src/index');
 
 module.exports = {
   plugins: [
-    ...googleAnalyticsPlugin('UA-123456-1')
+    ...googleAnalyticsPlugin({
+      analyticsId: 'UA-123456-1'
+    })
   ]
 };
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/option-anonymous/greenwood.config.js b/packages/plugin-google-analytics/test/cases/option-anonymous/greenwood.config.js
new file mode 100644
index 000000000..764538e7b
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/option-anonymous/greenwood.config.js
@@ -0,0 +1,10 @@
+const googleAnalyticsPlugin = require('../../../src/index');
+
+module.exports = {
+  plugins: [
+    ...googleAnalyticsPlugin({
+      analyticsId: 'UA-123456-1',
+      anonymous: false
+    })
+  ]
+};
\ No newline at end of file
diff --git a/packages/plugin-google-analytics/test/cases/option-anonymous/option-anonymous.spec.js b/packages/plugin-google-analytics/test/cases/option-anonymous/option-anonymous.spec.js
new file mode 100644
index 000000000..3c07508a2
--- /dev/null
+++ b/packages/plugin-google-analytics/test/cases/option-anonymous/option-anonymous.spec.js
@@ -0,0 +1,110 @@
+/*
+ * Use Case
+ * Run Greenwood with Google Analytics composite plugin with IP anonymization set to false.
+ * 
+ * Uaer Result
+ * Should generate a bare bones Greenwood build with certain plugins injected into index.html.
+ * 
+ * User Command
+ * greenwood build
+ * 
+ * User Config
+ * const googleAnalyticsPlugin = require('@greenwod/plugin-google-analytics');
+ * 
+ * {
+ *   plugins: [{
+ *     ...googleAnalyticsPlugin({
+ *       analyticsId: 'UA-123456-1',
+ *       anonymouse: false
+ *     })
+ *  }]
+ * 
+ * }
+ * 
+ * User Workspace
+ * Greenwood default (src/)
+ */
+const expect = require('chai').expect;
+const { JSDOM } = require('jsdom');
+const path = require('path');
+const runSmokeTest = require('../../../../../test/smoke-test');
+const TestBed = require('../../../../../test/test-bed');
+
+describe('Build Greenwood With: ', async function() {
+  const LABEL = 'Google Analytics Plugin with IP Anonymization tracking set to false and Default Workspace';
+  const mockAnalyticsId = 'UA-123456-1';
+
+  let setup;
+
+  before(async function() {
+    setup = new TestBed();
+    this.context = setup.setupTestBed(__dirname);
+  });
+  
+  describe(LABEL, function() {
+    before(async function() {     
+      await setup.runGreenwoodCommand('build');
+    });
+    
+    runSmokeTest(['public', 'index', 'not-found', 'hello'], LABEL);
+
+    describe('Initialization script at the end of the <body> tag', function() {
+      let inlineScript;
+
+      beforeEach(async function() {
+        const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
+        const scriptTags = dom.window.document.querySelectorAll('head script');
+
+        inlineScript = Array.prototype.slice.call(scriptTags).filter(script => {
+          return !script.src;
+        });
+
+      });
+
+      it('should be one inline <script> tag', function() {
+        expect(inlineScript.length).to.be.equal(1);
+      });
+
+      it('should have the expected code with users analyicsId', function() {
+        const expectedContent = `
+            window.dataLayer = window.dataLayer || [];
+            function gtag(){dataLayer.push(arguments);}
+            gtag('js', new Date());
+
+            gtag('config', '${mockAnalyticsId}', { 'anonymize_ip': false });
+            gtag('config', '${mockAnalyticsId}');
+        `;
+
+        expect(inlineScript[0].textContent).to.contain(expectedContent);
+      });
+    });
+
+    describe('Tracking script at the end of the <body> tag', function() {
+      let trackingScript; 
+
+      beforeEach(async function() {
+        const dom = await JSDOM.fromFile(path.resolve(this.context.publicDir, 'index.html'));
+        const scriptTags = dom.window.document.querySelectorAll('head script');
+        
+        trackingScript = Array.prototype.slice.call(scriptTags).filter(script => {
+          return script.src === `https://www.googletagmanager.com/gtag/js?id=${mockAnalyticsId}`;
+        });
+      });
+
+      it('should have one <script> tag for loading the Google Analytics tracker', function() {
+        expect(trackingScript.length).to.be.equal(1);
+      });
+
+      it('should be an async <script> tag for loading the Google Analytics tracker', function() {
+        const isAsync = trackingScript[0].async !== null;
+
+        expect(isAsync).to.be.equal(true);
+      });
+    });
+  });
+  
+  after(function() {
+    setup.teardownTestBed();
+  });
+
+});
\ No newline at end of file

From 220f89f519f23dc2de766edb67e4fe1d0f2df810 Mon Sep 17 00:00:00 2001
From: Owen Buckley <owenbuckley13@gmail.com>
Date: Tue, 10 Sep 2019 20:53:42 -0400
Subject: [PATCH 8/8] add Google SEO meta tag

---
 greenwood.config.js | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/greenwood.config.js b/greenwood.config.js
index 00a86aeb2..d25ed7c35 100644
--- a/greenwood.config.js
+++ b/greenwood.config.js
@@ -16,7 +16,8 @@ module.exports = {
     { property: 'og:image', content: 'https://s3.amazonaws.com/hosted.greenwoodjs.io/greenwood-logo.png' },
     { property: 'og:description', content: META_DESCRIPTION },
     { rel: 'shortcut icon', href: FAVICON_HREF },
-    { rel: 'icon', href: FAVICON_HREF }
+    { rel: 'icon', href: FAVICON_HREF },
+    { name: 'google-site-verification', content: '4rYd8k5aFD0jDnN0CCFgUXNe4eakLP4NnA18mNnK5P0' }
   ],
   plugins: [
     ...googleAnalyticsPlugin({