Personalization DOM adjuments

[doublejosh]

This change allows easily personalized pages via simple HTML attributes based on a user's preferences (or overridden via URL params for transactional/marketing links and debugging).

The DOM choices were discussed here: #32

Docs updates are staged here: Full-Docs, they will no longer be included in README files within the codebase.

Here's the crux...

groucho.config.adjust = [{
  dataAttribute: 'groucho-region',
  userProperty: 'user.region',
  paramOverride: 'utm_region',
  helperCallback: myNameSpace.regionCodeToName,
}];

<div class="groucho-personal">
  <span data-groucho-region="north-america">Self-Important Tag Line</span>
  <span data-groucho-region="europe">Multicultural Tag Line</span>
  <span data-groucho-region="APAC">Appropriate Tag Line</span>
  <span data-groucho-region="default">Standard Tag Line</span>
</div>

OR

<span class="groucho-personal" data-groucho-region="north-america">Self-Important Tag Line</span>

...the class ensure explicit intent to hide content and allows marking topical content for recording interest but NOT adjusting visually.

[doublejosh]

Down to 82% code coverage 😢

[Etroid]

First pass look 🆗

[Etroid]

• This seems overkill if you're using for (var x in list)

[doublejosh]

jshint says otherwise ;)

[Etroid]

• Is this just checking whether or not jQuery is enabled. Seems redundant imho.

[doublejosh]

This library works across many versions of jQuery and other selector libraries as available dependencies, so this kind of thing ends required.

[Etroid]

• docblock

[Etroid]

• nit, not necessary?

[doublejosh]

jshint

[Etroid]

Gotcha, prototype...: http://www.codexpedia.com/javascript/jslint-the-body-of-a-for-in-should-be-wrapped-in-an-if-statement-to-filter-unwanted-properties-from-the-prototype/

[doublejosh]

@Etroid I'll need to make some changes after the thread about DOM choices...
#32

Looking to partner a bit with folks to make very sustainable choices.

[doublejosh]

• Would rather separate the param overriding of user preferences out of the adjustment configs, so they can be used for general user property sets (if empty). That config would need to be independent and shared.