feat(page): add custom route pageviewTemplate

add the possibility to create a custom pageview template directly in a single route

closes #65

Author: MatteoGabriele

docs/page-tracking.md

@@ -114,6 +114,38 @@ Vue.use(VueAnalytics, {
 })
 ```
 
+It is also possible to add custom data structure for each route, using the meta object
+
+```js
+import Vue from 'vue'
+import VueAnalytics from 'vue-analytics'
+import VueRouter from 'vue-router'
+
+const router = new VueRouter({
+  routes: [
+    {
+      name: 'home',
+      path: '/',
+      component: {...},
+      meta: {
+        analytics: {
+          pageviewTemplate (route) {
+            return {
+              title: 'This is my custom title',
+              path: route.path,
+              location: 'www.mydomain.com'
+            }
+          }
+        }
+      }
+    }
+  ]
+}) 
+
+```
+important: the route pageviewTemplate has always priority over the global one.
+
+
 ## Avoid trasnforming route query object into querystring
 It is possible to avoid route query to be sent as querystring using the `transformRouteParams` property
 

src/helpers.js

@@ -64,3 +64,9 @@ export function getQueryString (queryMap) {
 export function isRouteIgnored (name) {
   return config.ignoreRoutes.indexOf(name) !== -1
 }
+
+export function isRoute (route) {
+  // just check some random properties that we know
+  // are inside the route object
+  return route.query && route.params
+}

src/lib/page.js

@@ -1,16 +1,23 @@
 import config from '../config'
 import set from 'lib/set'
 import query from 'lib/query'
-import { noop, getQueryString, isRouteIgnored } from '../helpers'
+import { 
+  noop, 
+  getQueryString, 
+  isRouteIgnored,
+  getRouteAnalytics,
+  isRoute
+} from '../helpers'
 
 export default function page (...args) {
-  if (typeof args[0] !== 'string' && 'currentRoute' in args[0]) {
+  if (isRoute(args[0])) {
     const { transformQueryString } = config.autoTracking
-    const route = args[0].currentRoute
+    const route = args[0]
     const queryString = getQueryString(route.query)
     const path = route.path + (transformQueryString ? queryString : '')
 
     set('page', path)
+
     query('send', 'pageview', {
       page: path,
       title: route.name,
@@ -24,14 +31,16 @@ export default function page (...args) {
   query('send', 'pageview', ...args)
 }
 
-export function trackRoute (proxy, router) {
-  const { currentRoute } = router
-
-  if (isRouteIgnored(currentRoute.name)) {
+export function trackRoute (route) {
+  if (isRouteIgnored(route)) {
     return
   }
-
-  page(proxy ? proxy(currentRoute) : router)
+  
+  const { autoTracking } = config
+  const { meta: { analytics = {} } } = route
+  const proxy = analytics.pageviewTemplate || autoTracking.pageviewTemplate
+  
+  page(proxy ? proxy(route) : route)
 }
 
 export function startAutoTracking () {
@@ -42,13 +51,13 @@ export function startAutoTracking () {
   }
 
   if (autoTracking.pageviewOnLoad) {
-    trackRoute(autoTracking.pageviewTemplate, router)
+    trackRoute(router.currentRoute)
   }
 
   config.router.afterEach(function () {
+    // https://github.com/MatteoGabriele/vue-analytics/issues/44
     setTimeout(function () {
-      // https://github.com/MatteoGabriele/vue-analytics/issues/44
-      trackRoute(autoTracking.pageviewTemplate, router)
+      trackRoute(router.currentRoute)
     }, 0)
   })
 }