1st update from Kristi's edits

lib/WebGUI/Help/Macro_AOIRank.pm

@@ -8,13 +8,16 @@ our $HELP = {
 		fields => [
 		],
 		related => [
-			{
-				tag => 'macros using',
-				namespace => 'Macros'
-			},
 			{
 				tag => 'metadata manage',
 				namespace => 'Asset'
+			{
+				tag => 'settings',
+				namespace => 'WebGUI'
+			},
+			{
+				tag => 'macros using',
+				namespace => 'Macros'
 			},
 		]
 	},

lib/WebGUI/i18n/English/Asset.pm

@@ -599,8 +599,8 @@ each asset under the tab &quot;Meta&quot; in the asset properties.</p>
     WebGUI config file.</p>
   </li>
   <li><p><b>Areas of Interest Ranking</b><br />
-    Metadata in combination with passive profiling produces AOI (Areas of
+    Metadata in combination with passive profiling produces AOI (<b>Areas of
-    Interest) information. You can retrieve the value of a metadata property
+    Interest</b>) information. You can retrieve the value of a metadata property
     with the &#94;AOIRank(); and &#94;AOIHits(); macros.</p>
   </li>
   <li><p><b>Show content based upon criteria</b><br />
@@ -619,7 +619,7 @@ each asset under the tab &quot;Meta&quot; in the asset properties.</p>
     to create meta tags from meta data, including the tags from the Dublin Core standard.</p></li>
 </ul>|,
                 context => q|Metadata help|,
-                lastUpdated => 1162233025
+                lastUpdated => 1165356337
         },
 
 	'metadata edit property' => {

lib/WebGUI/i18n/English/Macro_AOIHits.pm

@@ -8,21 +8,38 @@ our $I18N = {
     },
 
     'aoi hits title' => {
-        message => q|AOI Hits Macro|,
+        message => q|Areas of Interest Hits Macro|,
-        lastUpdated => 1112466408,
+        lastUpdated => 1165355347,
     },
 
 	'aoi hits body' => {
 		message => q|
 <p><b>&#94;AOIHits();</b><br />
 <b>&#94;AOIHits(<i>metadata property</i>, <i>metadata value</i>);</b><br />
-This macro is for displaying Areas of Interest Hits, which is based on passive profiling
+This macro displays to a user how many times they have visited Assets
-of which wobjects are viewed by users, on a per user basis.  The macro takes two arguments,
+of a given type, based on Metadata and Passive Profiling.  To use the
-a metadata property and metadata value, and returns how many times the current user has
+macro, you will need to enable Passive Profiling in the WebGUI Settings
-viewed content with that property and value.</p>
+admin screen, and then add Metadata to the Assets in your site.</p>
-<p>&#94;AOIHits(contenttype,sport); would display 99 if this user has looked at content that was tagged "contenttype = sport" 99 times.</p>
+
+<p>Here's an example:</p>
+
+<p>Suppose you run a news site, and you want to tell the user how many times they have
+visited several kinds of stories.
+You enable Passive Profiling in the WebGUI Settings, then create a new Metadata
+field called "contentType".  As your content managers add stories to the site, they also classify
+the stories by giving the Metadata field contentType a value, such as "Sports", "General Interest",
+"Regional", "Business", "Entertainment" and so on.  On each page, you add
+you place these &#94;AOIHits() macro calls to show the user how many times they have
+visited Sports, Regional and Business stories:</p>
+
+<p>You visited sports stories: &#94;AOIHits(contentType,Sports); times<br />
+You visited sports stories: &#94;AOIHits(contentType,Regional); times<br />
+You visited sports stories: &#94;AOIHits(contentType,Business); times</p>
+
+<p>You must give &#94;AOIRank(); two arguments, the Metadata property to use and the
+Metadata value whose count you want displayed to the user.</p>
 |,
-		lastUpdated => 1146626467,
+		lastUpdated => 1165363159,
 	},
 };
 

lib/WebGUI/i18n/English/Macro_AOIRank.pm

@@ -8,24 +8,40 @@ our $I18N = {
     },
 
     'aoi rank title' => {
-        message => q|AOI Rank Macro|,
+        message => q|Areas of Interest Rank Macro|,
-        lastUpdated => 1112466408,
+        lastUpdated => 1165355407,
     },
 
 	'aoi rank body' => {
 		message => q|
-
 <p>
 <b>&#94;AOIRank(<i>metadata property</i>, [<i>rank</i>]);</b><br />
-This macro is for displaying Areas of Interest Rankings, which is based on passive profiling
+This macro is for displaying which Assets are the most frequently viewed on your site, based on 
-of which wobjects are viewed most frequently by users, on a per user basis.  The macro
+Metadata and Passive Profiling.  To use the macro, you will need to enable Passive Profiling in the 
-takes up to two arguments, a metadata property and the rank of the metadata value to
+WebGUI Settings admin screen, and then add Metadata to the Assets in your site.</p>
-be returned.  If the rank is left out, it defaults to 1, the highest rank.<br />
-&#94;AOIRank(contenttype); would display "sport" if the current user has looked at content tagged "contenttype = sport" the most.<br />
-&#94;AOIRank(contenttype, 2); would return the second highest ranked value for contenttype.</p>
 
+<p>Here's an example:</p>
+
+<p>Suppose you run a news site, and you want to know what kinds of news stories are the
+most popular.  You enable Passive Profiling in the WebGUI Settings, then create a new Metadata
+field called "contentType".  As your content managers add stories to the site, they also classify
+the stories by giving the Metadata field contentType a value, such as "Sports", "General Interest",
+"Regional", "Business", "Entertainment" and so on.  Next, on a separate page of your site,
+you place these &#94;AOIRank() macro calls:</p>
+
+<p>Most popular kind of story: &#94;AOIRank(contentType);<br />
+Second-most popular kind of story: &#94;AOIRank(contentType,2);<br />
+Third most popular kind of story: &#94;AOIRank(contentType,3);</p>
+
+<p>By default, &#94;AOIRank(contentType); will always display the most popular Metadata property,
+which in our case is called contentType.  If you wish to see which Metadata properties are lower
+ranked, pass the macro the rank that you want to see.</p>
+
+<p>As users visit your site, each story they read will be counted up and added to the counter for
+the correct contentType.  As you visit you separate page, you'll see the three most popular types
+of stories.</p>
 |,
-		lastUpdated => 1146627736,
+		lastUpdated => 1165361640,
 	},
 };