<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>David Simpson &#187; wiki</title>
	<atom:link href="http://davidsimpson.me/tag/wiki/feed/" rel="self" type="application/rss+xml" />
	<link>http://davidsimpson.me</link>
	<description>Developing the web, one page at a time.</description>
	<lastBuildDate>Wed, 16 May 2012 20:14:56 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.1</generator>
		<item>
		<title>Wiki web fonts</title>
		<link>http://davidsimpson.me/2011/12/09/wiki-web-fonts/</link>
		<comments>http://davidsimpson.me/2011/12/09/wiki-web-fonts/#comments</comments>
		<pubDate>Fri, 09 Dec 2011 10:09:17 +0000</pubDate>
		<dc:creator>David</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[atlassian]]></category>
		<category><![CDATA[confluence]]></category>
		<category><![CDATA[fonts]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://davidsimpson.me/?p=1346</guid>
		<description><![CDATA[Want to use some &#8220;hot&#8221; new web fonts to pimp your Confluence wiki? It&#8217;s really straightforward. This post describes a method by which you can change all the headings to use web fonts hosted by Google. Site-wide web fonts Using Rokkitt font Browse to Confluence Administration &#124; Look and Feel &#124; Custom HTML In At [...]]]></description>
			<content:encoded><![CDATA[<div id="tweetbutton1346" class="tw_button" style=""><a href="http://twitter.com/share?url=http%3A%2F%2Fdavidsimpson.me%2F2011%2F12%2F09%2Fwiki-web-fonts%2F&amp;via=dvdsmpsn&amp;text=Wiki%20web%20fonts&amp;related=&amp;lang=en&amp;count=horizontal&amp;counturl=http%3A%2F%2Fdavidsimpson.me%2F2011%2F12%2F09%2Fwiki-web-fonts%2F" class="twitter-share-button"  style="width:55px;height:22px;background:transparent url('http://davidsimpson.me/wp-content/plugins/wp-tweet-button/tweetn.png') no-repeat  0 0;text-align:left;text-indent:-9999px;display:block;"></a></div><p>Want to use some &#8220;hot&#8221; new web fonts to pimp your Confluence wiki? </p>
<p>It&#8217;s <em>really</em> straightforward.  This post describes a method by which you can change all the headings to use web fonts <a href="http://www.google.com/webfonts">hosted by Google</a>.<br />
<span id="more-1346"></span></p>
<h2>Site-wide web fonts</h2>
<h3>Using <a href="http://www.google.com/webfonts/specimen/Rokkitt">Rokkitt font</a></h3>
<p>Browse to <b>Confluence Administration | Look and Feel | Custom HTML</b></p>
<p>In <b>At end of the HEAD</b> paste:</p>
<pre class="brush: xml; title: ;">
&lt;!-- Fonts for headings --&gt;
&lt;link href='http://fonts.googleapis.com/css?family=Rokkitt:400,700'
      rel='stylesheet' type='text/css'&gt;
&lt;style&gt;
#com-atlassian-confluence h1,
#com-atlassian-confluence h2,
#com-atlassian-confluence h3,
#com-atlassian-confluence h4,
#com-atlassian-confluence h5,
#com-atlassian-confluence h6 {
	font-family: 'Rokkitt', serif;
	font-weight : bold;
}
&lt;/style&gt;
</pre>
<p>Please note that adding inline styles is <a href="http://line25.com/articles/10-html-tag-crimes-you-really-shouldnt-commit">not big or clever</a>, but it is quick and easy for the purpose of this blogpost.</p>
<p>This results in a layout similar to the screenshot below:</p>
<p><a href="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts.png" rel="lightbox[1346]" title="Rokkitt headings in Confluence"><img src="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts.png" alt="" title="Rokkitt headings in Confluence" width="100%"  /></a></p>
<h3>Using <a href="http://www.google.com/webfonts/specimen/Leckerli+One">Leckerli One font</a></h3>
<p>Was that too corporate? Then lets have some handwriting&#8230;</p>
<p>Browse to <b>Confluence Administration | Look and Feel | Custom HTML</b></p>
<p>In <b>At end of the HEAD</b> paste:</p>
<pre class="brush: xml; title: ;">
&lt;!-- Fonts for headings --&gt;
&lt;link href='http://fonts.googleapis.com/css?family=Leckerli+One:400'
      rel='stylesheet' type='text/css'&gt;
&lt;style&gt;
#com-atlassian-confluence h1,
#com-atlassian-confluence h2,
#com-atlassian-confluence h3,
#com-atlassian-confluence h4,
#com-atlassian-confluence h5,
#com-atlassian-confluence h6 {
	font-family: 'Leckerli One', cursive;
}
&lt;/style&gt;
</pre>
<p>Now, you&#8217;ll get something like this:</p>
<p><a href="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts2.png" rel="lightbox[1346]" title="Leckerli One headings in Confluence"><img src="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts2.png" alt="" title="Leckerli One headings in Confluence" width="100%" /></a></p>
<p>I&#8217;m not sure that this is a good look, but never mind.</p>
<h2>Web fonts for a single space</h2>
<p>Want to just mess up the fonts in a single space?</p>
<p>Then, duplicate the content of  the Google hosted stylesheet &#8212; for example <a href="http://fonts.googleapis.com/css?family=Leckerli+One:400">http://fonts.googleapis.com/css?family=Leckerli+One:400</a> and add to the space stylesheet&#8230;</p>
<p>Browse to <b>Browse | Space Admin | Look and Feel | Stylesheet</b>.</p>
<p>Click on <b>Edit</b> and paste in:</p>
<pre class="brush: css; title: ;">
/* Duplicated from http://fonts.googleapis.com/css?family=Leckerli+One:400 */
@font-face {
  font-family: 'Leckerli One';
  font-style: normal;
  font-weight: normal;
  src: local('LeckerliOne'), url('http://themes.googleusercontent.com/static/fonts/leckerlione/v2/S2Y_iLrItTu8kIJTkS7DrKRDOzjiPcYnFooOUGCOsRk.woff') format('woff');
}

/* Targetting Confluence heading  */
#com-atlassian-confluence h1,
#com-atlassian-confluence h2,
#com-atlassian-confluence h3,
#com-atlassian-confluence h4,
#com-atlassian-confluence h5,
#com-atlassian-confluence h6 {
	font-family: 'Leckerli One', cursive;
}
</pre>
<p>This will only affect the space in which you add the CSS and will override the global styles.  </p>
<p><a href="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts3.png" rel="lightbox[1346]" title="Space only web font"><img src="http://davidsimpson.me/wp-content/uploads/2011/12/wiki-web-fonts3.png" alt="" title="Space only web font" width="100%" /></a></p>
<p>I&#8217;m not sure whether the <a href="http://themes.googleusercontent.com/static/fonts/leckerlione/v2/S2Y_iLrItTu8kIJTkS7DrKRDOzjiPcYnFooOUGCOsRk.woff">URL</a> for the font will remain constant in the long term though, so you <em>may</em> have to repeat this process.</p>
<h2>Be careful</h2>
<p>There are plenty of web font services and many, many fonts to choose from.  With <a href="http://www.youtube.com/watch?v=IKmQW7JTb6s">great power comes great responsibility</a>, so be careful.</p>
<!-- PHP 5.x -->]]></content:encoded>
			<wfw:commentRss>http://davidsimpson.me/2011/12/09/wiki-web-fonts/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>Analytics Plugin for Confluence 1.2 released</title>
		<link>http://davidsimpson.me/2010/06/24/analytics-plugin-for-confluence-12-released/</link>
		<comments>http://davidsimpson.me/2010/06/24/analytics-plugin-for-confluence-12-released/#comments</comments>
		<pubDate>Thu, 24 Jun 2010 11:39:35 +0000</pubDate>
		<dc:creator>David</dc:creator>
				<category><![CDATA[analytics]]></category>
		<category><![CDATA[web]]></category>
		<category><![CDATA[atlassian]]></category>
		<category><![CDATA[confluence]]></category>
		<category><![CDATA[google analytics]]></category>
		<category><![CDATA[plugin]]></category>
		<category><![CDATA[web analytics]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://davidsimpson.me/?p=865</guid>
		<description><![CDATA[Last week I released Analytics Plugin for Confluence 1.2 on the Atlassian Plugin Exchange. It&#8217;s been 6 months since the initial release which was only tested on Confluence 3.0. This time I&#8217;ve added a new dashboard section, full support for Confluence 3.1 &#038; 3.2 and a pile of macro parameters as requested by Guy Fraser. [...]]]></description>
			<content:encoded><![CDATA[<div id="tweetbutton865" class="tw_button" style=""><a href="http://twitter.com/share?url=http%3A%2F%2Fdavidsimpson.me%2F2010%2F06%2F24%2Fanalytics-plugin-for-confluence-12-released%2F&amp;text=Analytics%20Plugin%20for%20Confluence%201.2%20released&amp;related=&amp;lang=en&amp;count=horizontal&amp;counturl=http%3A%2F%2Fdavidsimpson.me%2F2010%2F06%2F24%2Fanalytics-plugin-for-confluence-12-released%2F" class="twitter-share-button"  style="width:55px;height:22px;background:transparent url('http://davidsimpson.me/wp-content/plugins/wp-tweet-button/tweetn.png') no-repeat  0 0;text-align:left;text-indent:-9999px;display:block;"></a></div><p><img src="/wp-content/uploads/2010/06/analytics-plugin-icon-60pc.png" alt="analytics-plugin-icon-60pc" title="analytics-plugin-icon-60pc" width="153" height="124" class="alignleft size-full wp-image-875" /> Last week I released <a href="https://plugins.atlassian.com/plugin/details/16722">Analytics Plugin for Confluence 1.2</a> on the Atlassian Plugin Exchange.  </p>
<p>It&#8217;s been  6 months since the initial release which was only tested on Confluence 3.0.  This time I&#8217;ve added a new dashboard section, full support for Confluence 3.1 &#038; 3.2 and a pile of macro parameters <a href="/2010/01/02/announcing-google-analytics-plugin-for-confluence/comment-page-1/#comment-487">as requested</a> by Guy Fraser.     The <a href="https://studio.plugins.atlassian.com/wiki/display/CGAP/Analytics+Plugin+1.2+-+Release+Notes">release notes are here</a>.   Confluence 3.3  is just around the corner, so I&#8217;ll add an update for that when it comes out.</p>
<h3>Thank you</h3>
<p>The Confluence community has shown a great deal of support and encouragement since the plugin was originally released.   For example, <a href="http://blogs.atlassian.com/confluence/2009/12/report-confluence-activity-using-google-analytics-in-the-wiki.html">Atlassian blogged about it</a> before I got a chance to.  So thanks to all for your support.  </p>
<p>The plugin was name checked by Sherif Mansour &#8211; Atlassian&#8217;s  Product Manager for Confluence in the <a href="http://www.atlassian.com/summit/2010/presentations/collaboration-and-projects/confluence-state-of-union.jsp">Confluence State of the Union</a> presentation at <a href="http://www.atlassian.com/summit/2010/">Atlassian Summit 2010</a> at the start of the month.  Watch it all, but concentrate especially around 5:10!</p>
<p>This week Google approved the plugin for their <a href="http://www.google.com/analytics/apps/">Google Analytics Application Gallery</a> &mdash;  <a href="http://www.google.com/analytics/apps/about?app_id=229002">take a look here</a>.  The Apps Gallery has only been going for about a month so I&#8217;m really excited about being a part of it.  The slight name change and new logo were done to fit in with the Application Gallery Policy.<br />
<span id="more-865"></span></p>
<h3>In the future</h3>
<p>The next release should support Confluence 3.3  and also complete tracking of all pages in a space  &mdash; not just those with a URL starting /display/spaceKey/  &mdash; based on <a href="/2010/04/09/meta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics/">this hack</a> :</p>
<pre class="brush: jscript; title: ;">
// Add a page-level custom variable to record the space-key
if (typeof jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;) == 'string')
{
  pageTracker._setCustomVar(
    1, // This custom var is set to slot #1 of 5

    // The name acts as a kind of category for the user activity
    'confluence-space-key',    

    // This value of the custom variable
    jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;), 

    3 // Sets the scope to page-level
  );
}
</pre>
<p>&mdash; If you want to use this hack now, try out <a href="http://www.google.com/analytics/reporting/edit_custom_report?share=gKOvaSkBAAA.5cmZVfTgv7FSDQaf3SApcJ_A8fPPw5P0SVumf1XIBw6dZ9IfubVqvpdV97TN5wj9PYWeLHgMbDxm22PtwyLU0Q.tBCFvr4UE3alVuAccnjeMA">this custom Google Analytics report</a> which will allow you to take advantage of it now.</p>
<p>I&#8217;d also like to add full space specific tracking for attachments too.</p>
<h3>A quick demo</h3>
<p>And finally, this is what the new version looks like:</p>
<p><object height="350" width="425" class="alignleft"><param value="http://www.youtube.com/v/0JgoBwlQT_4&amp;hl=en_US&amp;fs=1&amp;" name="movie"><param value="true" name="allowFullScreen"><param value="always" name="allowscriptaccess"><embed height="350" width="425" allowfullscreen="true" allowscriptaccess="always" type="application/x-shockwave-flash" src="http://www.youtube.com/v/0JgoBwlQT_4&amp;hl=en_US&amp;fs=1&amp;"></object> &nbsp;</p>
<h3>Related Posts</h3>
<ul>
<li><a href="/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/">Tracking Atlassian Confluence usage with Google Analytics</a></li>
<li><a href="/2009/04/16/4-useful-tips-on-google-analytics-reporting-for-confluence/">4 Useful Tips on Google Analytics Reporting for Confluence</a></li>
<li><a href="/2010/01/02/announcing-google-analytics-plugin-for-confluence/">Announcing: Google Analytics plugin for Confluence</a> &#8211; original release</li>
</ul>
<!-- PHP 5.x -->]]></content:encoded>
			<wfw:commentRss>http://davidsimpson.me/2010/06/24/analytics-plugin-for-confluence-12-released/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Meta tags are your friend part 2: Space specific tracking in Confluence with Google Analytics</title>
		<link>http://davidsimpson.me/2010/04/09/meta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics/</link>
		<comments>http://davidsimpson.me/2010/04/09/meta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics/#comments</comments>
		<pubDate>Fri, 09 Apr 2010 01:14:54 +0000</pubDate>
		<dc:creator>David</dc:creator>
				<category><![CDATA[analytics]]></category>
		<category><![CDATA[web]]></category>
		<category><![CDATA[atlassian]]></category>
		<category><![CDATA[confluence]]></category>
		<category><![CDATA[Google]]></category>
		<category><![CDATA[google analytics]]></category>
		<category><![CDATA[web analytics]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://davidsimpson.me/?p=719</guid>
		<description><![CDATA[I&#8217;ve previously written a number of posts about Confluence and Google Analytics (GA), including how to set up GA on Confluence and pointers for GA reports you should consider. Lastly, I wrote the Confluence Google Analytics Plugin (CGAP) which provides space specific GA reports from within Confluence. However, I&#8217;ve not been entirely happy because there [...]]]></description>
			<content:encoded><![CDATA[<div id="tweetbutton719" class="tw_button" style=""><a href="http://twitter.com/share?url=http%3A%2F%2Fdavidsimpson.me%2F2010%2F04%2F09%2Fmeta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics%2F&amp;text=Meta%20tags%20are%20your%20friend%20part%202%3A%20Space%20specific%20tracking%20in%20Confluence%20with%20Google%20Analytics&amp;related=&amp;lang=en&amp;count=horizontal&amp;counturl=http%3A%2F%2Fdavidsimpson.me%2F2010%2F04%2F09%2Fmeta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics%2F" class="twitter-share-button"  style="width:55px;height:22px;background:transparent url('http://davidsimpson.me/wp-content/plugins/wp-tweet-button/tweetn.png') no-repeat  0 0;text-align:left;text-indent:-9999px;display:block;"></a></div><p>I&#8217;ve previously written a number of posts about Confluence and Google Analytics (GA), including <a href="/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/">how to set up GA on Confluence</a> and pointers for <a href="/2009/04/16/4-useful-tips-on-google-analytics-reporting-for-confluence/">GA reports you should consider</a>.  Lastly, I wrote the <a href="/2010/01/02/announcing-google-analytics-plugin-for-confluence/">Confluence Google Analytics Plugin</a> (CGAP) which provides space specific GA reports from within Confluence.</p>
<p>However, I&#8217;ve not been entirely happy because there wasn&#8217;t a method to allow complete tracking of all space specific Confluence pages using CGAP or the reports that I&#8217;ve previously described.</p>
<p>This has been <a href="http://forums.atlassian.com/thread.jspa?messageID=257303418">documented</a> <a href="http://blogs.atlassian.com/confluence/2009/12/report-confluence-activity-using-google-analytics-in-the-wiki.html#comment-210247">elsewhere</a>, but briefly, the problem is with&#8230;</p>
<ul>
<li>pages with punctuation in the title e.g. <a href="http://workspace.nottingham.ac.uk/pages/viewpage.action?pageId=45947608" title="http://workspace.nottingham.ac.uk/pages/viewpage.action?pageId=45947608">This page is bad for Analytics, isn&#8217;t it?</a> (hover on the link to see the URI)</li>
<li>short URLs e.g. /x/2Bq9Ag</li>
<li>space administration e.g. /spaces/spaceadmin.action?key=spaceKey</li>
<li>page edits e.g./pages/editpage.action?pageId=XXXX</li>
<li>page creation e.g. /pages/createpage.action?spaceKey=spaceKey&#038;fromPageId=XXXX</li>
<li>add/view attachments e.g. /pages/viewpageattachments.action?pageId=XXXX</li>
<li>page history e.g. /pages/viewpreviousversions.action?pageId=XXXX</li>
<li>view wiki markup e.g. /pages/viewpagesrc.action?pageId=XXXX</li>
</ul>
<p>&#8230;and so on.  I think you get the picture.</p>
<p>For any page where there is a real interaction with the wiki &mdash; such as page creation or page edits, attachment viewing or uploading &mdash; it is very difficult associate that interaction to the space where the interaction took place.  Damn.  That&#8217;s the main point really. Wikis are for collaboration &mdash; editing and creating content &mdash; not just passively reading.  </p>
<p>It really bugs me that the URIs in Confluence aren&#8217;t built up so that they always provide a context of where you are.  But what can we do?</p>
<p>This post suggests 2 possible solutions to this problem:  </p>
<ol>
<li>A Javascript only method</li>
<li>A Javascript and velocity templating method</li>
</ol>
<p>Both have their drawbacks, but they do let you get a little closer to understanding what your users are doing within your Confluence spaces. Try them out and please report back on your preference or your own alternative solution.</p>
<p><span id="more-719"></span></p>
<h2>The Javascript only method</h2>
<p>In this method, we track a custom variable in GA where possible, so that we can attach a page view to the corresponding Confluence space.</p>
<p>Atlassian handily provide the following (example) meta tag on every page that has an associated space:</p>
<pre class="brush: xml; title: ;">&lt;meta id=&quot;confluence-space-key&quot; name=&quot;confluence-space-key&quot; content=&quot;~cczdas&quot;&gt;</pre>
<p>We can check for that meta tag and pass it into a custom variable in Google Analytics.</p>
<p>In Confluence, go to <b>Dashboard | Administration | Look and Feel | Custom HTML</b></p>
<p>Click on the “Edit” button and add this javascript snippet (with your tracker code) to the “At end of the BODY” section:</p>
<pre class="brush: jscript; title: ;">
&lt;script type=&quot;text/javascript&quot;&gt;
var gaJsHost = ((&quot;https:&quot; == document.location.protocol) ? &quot;https://ssl.&quot; : &quot;http://www.&quot;);
document.write(unescape(&quot;%3Cscript src='&quot; + gaJsHost + &quot;google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E&quot;));
&lt;/script&gt;
&lt;script type=&quot;text/javascript&quot;&gt;

	window.onload = function(){
		try
		{
			var pageTracker = _gat._getTracker(&quot;UA-XXXXX-XX&quot;);

			// Add a page-level custom variable to record the space-key
			if (typeof jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;) == 'string')
			{
				pageTracker._setCustomVar(
				     1,                         // This custom var is set to slot #1 of 5
				     'confluence-space-key',    // The name acts as a kind of category for the user activity
				     jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;), // This value of the custom variable
				     3                          // Sets the scope to page-level
				);
			}
		}
		catch (err) {}
	}

&lt;/script&gt;
</pre>
<p>This means for each page, we&#8217;ve added a custom variable which can later be check against.  We can now therefore easily check which page belongs to which space.</p>
<p>In Google Analytics, the custom variables report looks like this:</p>
<p><a href="http://localhost/davidsimpson.me/wp-content/uploads/2010/04/confluence-ga-custom-variable-report.png" rel="lightbox[719]" title="confluence-ga-custom-variable-report"><img src="http://davidsimpson.me/wp-content/uploads/2010/04/confluence-ga-custom-variable-report-440x316.png" alt="confluence-ga-custom-variable-report" title="confluence-ga-custom-variable-report" width="440" height="316" class="size-medium wp-image-725" /></a></p>
<p>This doesn&#8217;t really tell us much, other than the number of page views for a space and a little more.  To get at the real power of custom variables, we need to create a custom segment for each space.  This will allow us to see all the interactions for the space.</p>
<p>Here&#8217;s a short video guide to creating custom segments for Confluence spaces:</p>
<p><object width="480" height="385"><param name="movie" value="http://www.youtube.com/v/gOBoqG7LNLc&#038;hl=en_US&#038;fs=1&#038;"></param><param name="allowFullScreen" value="true"></param><param name="allowscriptaccess" value="always"></param><embed src="http://www.youtube.com/v/gOBoqG7LNLc&#038;hl=en_US&#038;fs=1&#038;" type="application/x-shockwave-flash" allowscriptaccess="always" allowfullscreen="true" width="480" height="385"></embed></object></p>
<h3>Pros</h3>
<ul>
<li>It&#8217;s really simple. Anyone with Confluence administration rights can cut and paste this code.</li>
<li>It&#8217;s pure. This should not be affected by upgrades to the platform.</li>
<li>It&#8217;s easily to support. Lots of people know Javascript.</li>
</ul>
<h3>Cons</h3>
<ul>
<li>You&#8217;re moving into slightly advanced Google Analytics territory here.</li>
<li>You&#8217;ll need to set up a separate custom advanced segment for each space.  This may be somewhat dull.</li>
</ul>
<p>I really like this approach, but haven&#8217;t managed to successfully add it into CGAP yet <a href="http://www.google.com/support/forum/p/Google+Analytics/thread?tid=23eb6e88efbd4ac3&#038;hl=en">whilst maintaining access to historical data</a>.</p>
<h2>Javascript and velocity templating method</h2>
<p>In this method, we trick Google Analytics into reporting the URL in a the format that works with content drill-down e.g.</p>
<ul>
<li>/pages/viewpage.action?pageId=XXXX becomes /display/spaceKey/Page+Title</li>
<li>/x/2Bq9Ag (short URL) becomes /display/spaceKey/Page+Title</li>
<li>/pages/editpage.action?pageId=XXX becomes /display/spaceKey/Page+Title/edit</li>
<li>/pages/viewpageattachments.action?pageId=XXX becomes /display/spaceKey/Page+Title/view-attachments</li>
</ul>
<p>We do this by adding a custom meta tag named &#8220;analytics.url.fix&#8221; from which we read the &#8220;fixed&#8221; URL using a little Javascript.	</p>
<h3>Edits</h3>
<p><b>page.vmd</b> in your theme:</p>
<pre class="brush: plain; title: ;">
## Add Google Analytics support for page edits, attachment views etc.
## Called by $!sitemeshPage.getProperty(&quot;page.googleAnalyticsUrlFix&quot;) in main.vmd
&lt;content tag=&quot;googleAnalyticsUrlFix&quot;&gt;
	#if ($mode == &quot;view&quot;)
		&lt;meta name=&quot;analytics.url.fix&quot; desc=&quot;$req.contextPath/display/$page.spaceKey/$page.title&quot; /&gt;
	#else
		&lt;meta name=&quot;analytics.url.fix&quot; desc=&quot;$req.contextPath/display/$page.spaceKey/$page.title/$mode&quot; /&gt;
	#end
&lt;/content&gt;
</pre>
<p><b>main.vmd</b> in your theme:<br />
Add after the title node in /html/head/title</p>
<pre class="brush: plain; title: ;">
## Call the googleAnalyticsUrlFix content tag in page.vmd, fail silently:
$!sitemeshPage.getProperty(&quot;page.googleAnalyticsUrlFix&quot;)
</pre>
<p>In Confluence, go to <b>Dashboard | Administration | Look and Feel | Custom HTML</b></p>
<p>Click on the “Edit” button and add this javascript snippet (with your tracker code) to the “At end of the BODY” section:</p>
<pre class="brush: jscript; title: ;">
&lt;script type=&quot;text/javascript&quot;&gt;
var gaJsHost = ((&quot;https:&quot; == document.location.protocol) ? &quot;https://ssl.&quot; : &quot;http://www.&quot;);
document.write(unescape(&quot;%3Cscript src='&quot; + gaJsHost + &quot;google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E&quot;));
&lt;/script&gt;
&lt;script type=&quot;text/javascript&quot;&gt;
	window.onload = function(){
		try
		{
			var pageTracker = _gat._getTracker(&quot;UA-XXXXXX-X&quot;); 

			// Test for the meta[name=analytics.url.fix] tag &amp; fix the url
			if (typeof jQuery('meta[name=analytics.url.fix]').attr(&quot;content&quot;) == 'string')
			{
	 			// console.debug('corrected pageview');
	   			var pageUri = jQuery('meta[name=analytics.url.fix]').attr(&quot;content&quot;).replace(/s+/gi, '+');
				pageTracker._trackPageview(pageUri);
			}
			else
			{
				// console.debug('default pageview');
				pageTracker._trackPageview();
			}
		}
		catch (err) {}
	}
&lt;/script&gt;
</pre>
<h3>Pros</h3>
<ul>
<li>You don&#8217;t have to do anything on the Google Analytics side at all</li>
<li>
		This is just great for the content drilldown screen in Google Analytics.</p>
<ul>
<li>It means that pages with punctuation in the title can now be seen within their correct space.</li>
<li>The space owners can now be sure of the stats for viewing and editing pages within their space.</li>
</ul>
</li>
<li>
		This is great for the Google Analytics plugin for Confluence (CGAP)</p>
<ul>
<li>All the page edits should be shown in the analytics report</li>
<li>It&#8217;s easily supportable. Lots of people know Javascript</li>
</ul>
</li>
</ul>
<h3>Cons</h3>
<ul>
<li>It&#8217;s a bit messy.</li>
<li>You&#8217;ll have to apply this to every theme you support.</li>
<li>Editing velocity templates isn&#8217;t everyone&#8217;s cup of tea.</li>
<li>I&#8217;ve no idea what will happen when you upgrade Confluence.</li>
<li>It niggles me that we&#8217;re sending incorrect (though easily readable) pageview data to Google Analytics.</li>
<li>It still doesn&#8217;t tie everything to the space, just the page interactions</li>
</ul>
<p>To my mind, this is less elegant, but provides pretty much instant results.</p>
<h2>Which one to choose?</h2>
<p>I really like the simplicity of the first solution. Just a little bit of Javascript to read a meta tag that&#8217;s already there.  It&#8217;s likely to easily survive an upgrade. But I&#8217;m  disappointed that as yet, I can&#8217;t get it to work nicely with CGAP.</p>
<p>For ongoing support reasons, I&#8217;d always say <b>don&#8217;t mess with the platform</b>. Don&#8217;t do anything which makes it more difficult to upgrade to the latest and greatest version. If you agree, then steer well clear of the latter option.  If however, you absolutely have to start complete space specific tracking right now, no matter what, then the latter is then choice for you.</p>
<!-- PHP 5.x -->]]></content:encoded>
			<wfw:commentRss>http://davidsimpson.me/2010/04/09/meta-tags-are-your-friend-part-2-space-specific-tracking-in-confluence-with-google-analytics/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Some thoughts on developing my first Confluence plugin</title>
		<link>http://davidsimpson.me/2010/01/25/some-thoughts-on-developing-my-first-confluence-plugin/</link>
		<comments>http://davidsimpson.me/2010/01/25/some-thoughts-on-developing-my-first-confluence-plugin/#comments</comments>
		<pubDate>Mon, 25 Jan 2010 12:42:04 +0000</pubDate>
		<dc:creator>David</dc:creator>
				<category><![CDATA[Uncategorised]]></category>
		<category><![CDATA[web]]></category>
		<category><![CDATA[analytics]]></category>
		<category><![CDATA[atlassian]]></category>
		<category><![CDATA[confluence]]></category>
		<category><![CDATA[google analytics]]></category>
		<category><![CDATA[java]]></category>
		<category><![CDATA[plugin]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://davidsimpson.me/?p=503</guid>
		<description><![CDATA[I recently started building Confluence plugins. The first one being my Google Analytics plugin for Confluence. This post outlines my &#8220;journey&#8221; into Confluence plugin development. It documents a beginner&#8217;s pitfalls when developing with the Atlassian Plugin SDK. Hopefully others can learn from, or at least laugh at my mistakes. Where I was starting from: No [...]]]></description>
			<content:encoded><![CDATA[<div id="tweetbutton503" class="tw_button" style=""><a href="http://twitter.com/share?url=http%3A%2F%2Fdavidsimpson.me%2F2010%2F01%2F25%2Fsome-thoughts-on-developing-my-first-confluence-plugin%2F&amp;text=Some%20thoughts%20on%20developing%20my%20first%20Confluence%20plugin&amp;related=&amp;lang=en&amp;count=horizontal&amp;counturl=http%3A%2F%2Fdavidsimpson.me%2F2010%2F01%2F25%2Fsome-thoughts-on-developing-my-first-confluence-plugin%2F" class="twitter-share-button"  style="width:55px;height:22px;background:transparent url('http://davidsimpson.me/wp-content/plugins/wp-tweet-button/tweetn.png') no-repeat  0 0;text-align:left;text-indent:-9999px;display:block;"></a></div><p><img class="alignnone" title="ga-idea" src="/wp-content/uploads/2010/01/ga-idea2.png" alt="ga-idea" /></p>
<p><!-- Some thoughts on developing my first Confluence plugin  or A bluffer's guide to developing Confluence plugins --></p>
<p>I recently started building Confluence plugins.  The first one being my <a href="/2010/01/02/announcing-google-analytics-plugin-for-confluence/">Google Analytics plugin for Confluence</a>. This post outlines my &#8220;journey&#8221; into Confluence plugin development.  It documents a beginner&#8217;s pitfalls when developing with the Atlassian Plugin SDK. Hopefully others can learn from, or at least laugh at my mistakes.</p>
<p>Where I was starting from:</p>
<ul>
<li>No experience of <a href="http://maven.apache.org/">maven</a></li>
<li>No understanding of how Confluence plugins work or how they are written</li>
<li>Some experience of Java &#8211; Mainly <a href="http://www.jasig.org/uportal">uPortal</a>/<a href="http://www.sungardhe.com/products/luminis-platform">Luminis</a> portal development for the <a href="http://my.nottingham.ac.uk/">University of Nottingham</a> and some consultancy work e.g. for Astra Zeneca, Documentum and 3Com</li>
<li>No experience of unit testing or integration testing in Java &#8211; oh dear</li>
<li>I prefer UI work to real programming</li>
</ul>
<p><span id="more-503"></span></p>
<h2>Initial failure</h2>
<p>I tried to setup a development environment for plugin development using Atlassian&#8217;s <a href="http://confluence.atlassian.com/display/DEVNET/How+to+Build+an+Atlassian+Plugin">documentation</a> a little before the beta release of version 3 of the Atlassian Plugin SDK.  It was a pain. This was no fault of the documentation — it was really just to do with my schedules and available time to experiment.</p>
<p>The problem was two-fold:</p>
<ol>
<li>I&#8217;d not done this before, so was clueless to what was involved</li>
<li>The setup was a complete ball-ache considering the time restraints</li>
</ol>
<p>I was well aware of point 1 and the pain it was likely to cause.  Point 2 seemed to be the old chestnut &#8211; install and configure the exact correct versions of the software you need in the correct sequence, then start.</p>
<p>Wait.  I don&#8217;t know what that means, see point 1. Yes, I&#8217;ve got maven installed on my MacBook! Woo! Let&#8217;s go.  Hang on, it&#8217;s not the correct version. Where do I get that from?</p>
<p>In many ways, it reminded me of my initial experience of building and installing Apache 1.x on Solaris SPARC boxes back in the day:</p>
<blockquote><p>cd /path/to/apache/source; make; make install;<br />
Oh. Wrong version of make. Where do I get that from?  Hmmm.<br />
Install correct version of make. Damn, make needs the correct version of gcc. Where do I get that from?<br />
And so on. Moving further and further away from the problem you&#8217;re trying to solve.</p></blockquote>
<p>So, I stopped there.  No shiny Confluence plugins for me.  I&#8217;ve got plenty of other things to do anyway thank you very much.</p>
<h2>Reboot</h2>
<p>Then Atlassian released the Plugin SDK beta and all this nastiness was removed.  Everything you need to build an Atlassian plugin was bundled in one place.  Refreshing. All commands have been wrapped and so are prefixed with <code>atlas-</code> to prevent conflict with whatever else you&#8217;ve got installed.</p>
<p>For the impatient, this really drives down the barriers to entry for plugin development.</p>
<p>Following the documentation for <a href="http://confluence.atlassian.com/display/DEVNET/Setting+up+your+Plugin+Development+Environment">installing the Plugin SDK</a> was a piece of cake.  It just worked.</p>
<ul>
<li>Download</li>
<li>Unzip</li>
<li>Add some environment settings. Edit <code>~/.profile</code> and add:
<pre class="brush: bash; title: ;">
PATH=$PATH:.
PATH=$PATH:$HOME/
PATH=$PATH:$HOME/bin
PATH=$PATH:$HOME/atlassian-plugin-sdk/atlassian-plugin-sdk-3.0-beta3
PATH=$PATH:$HOME/atlassian-plugin-sdk/atlassian-plugin-sdk-3.0-beta3/bin
export PATH
</pre>
</li>
<li>Start building a plugin</li>
</ul>
<p>Starting out to build your Atlassian plugin is <a href="http://confluence.atlassian.com/display/DEVNET/Developing+your+Plugin+using+the+Atlassian+Plugin+SDK">documented here</a>. It&#8217;s a fairly straightforward set of instructions.</p>
<p>You start by doing something like this:</p>
<pre class="brush: bash; title: ;">
mkdir ~/projects/davidsimpson.me/
mkdir ~/projects/davidsimpson.me/confluence
cd  ~/projects/davidsimpson.me/confluence

atlas-create-confluence-plugin
...
...
...
When prompted
Define value for groupId: : me.davdsimpson.confluence.plugins
Define value for artifactId: : googleanalytics
Define value for version:  1.0-SNAPSHOT: :
Define value for package:  me.davdsimpson.confluence.plugins: :
Confirm properties configuration:
groupId: me.davdsimpson.confluence.plugins
artifactId: googleanalytics
version: 1.0-SNAPSHOT
package: me.davdsimpson.confluence.plugins
</pre>
<p>Then type&#8230;</p>
<pre class="brush: bash; title: ;">cd googleanalytics
atlas-run</pre>
<p>&#8230;and sit back.  If maven doesn&#8217;t fall over for lack of memory at this point, you&#8217;re laughing.  Go away, have a beer or two.  This may take some time.</p>
<p><img class="aligncenter size-medium wp-image-525" title="Beer" src="/wp-content/uploads/2010/01/iStock_000009660877XSmall.jpg" alt="Beer" width="440" height="175" /></p>
<p>On your return, maven will hopefully have finished dragging all manner of nonsense from Australia and installed a working copy of Confluence, together with an empty plugin onto your computer. Nice.  Next, write some code.</p>
<p><strong>I like to run before I can walk.</strong> It seems like much more fun to attempt something that&#8217;s harder.  You do fall over a lot more often though.  So rather than some kind of silly little hello world or equivalent plugin, my first plugin was an integration of Google Analytics with Confluence using the Google Analytics API to fetch data from Google.  It requires some additional JARs from Google.</p>
<p>Google doesn&#8217;t have a public maven repository to my knowledge and I&#8217;d no idea how to get these JARs added into maven.  Luckily, people had already written about <a href="http://www.techbits.de/2009/08/06/adding-googles-gdata-java-api-to-your-maven-repository/">parts</a> of <a href="http://blog.stuartlewis.com/2009/05/29/surfacing-google-analytics-stats-in-dspace/">this</a>, so I put 2 and 2 together.</p>
<p><strong>Add Google Analytics JARs to maven:</strong></p>
<pre class="brush: bash; title: ;">
atlas-mvn install:install-file -DgroupId=com.google.gdata
    -DartifactId=gdata-core
    -Dversion=1.0
    -Dpackaging=jar
    -Dfile=/path/to/gdata-core-1.0.jar
    -DgeneratePom=true

atlas-mvn install:install-file -DgroupId=com.google.gdata
    -DartifactId=gdata-analytics
    -Dversion=2.0
    -Dpackaging=jar
    -Dfile=/path/to/gdata-analytics-2.0.jar
    -DgeneratePom=true

atlas-mvn install:install-file -DgroupId=com.google.collect
    -DartifactId=google-collect
    -Dversion=1.0
    -Dpackaging=jar
    -Dfile=/path/to/google-collect-1.0-rc3.jar
</pre>
<p><strong>Edit the Project Object Model (POM) to add the dependencies</strong></p>
<p>Edit the pom:</p>

<div class="wp_syntax"><div class="code"><pre class="bash" style="font-family:monospace;"><span style="color: #c20cb9; font-weight: bold;">vi</span> ~<span style="color: #000000; font-weight: bold;">/</span>projects<span style="color: #000000; font-weight: bold;">/</span>davidsimpson.me<span style="color: #000000; font-weight: bold;">/</span>confluence<span style="color: #000000; font-weight: bold;">/</span>googleanalytics<span style="color: #000000; font-weight: bold;">/</span>pom.xml</pre></div></div>

<p>Add this bit to the end of the dependencies node:</p>
<pre class="brush: xml; title: ;">
&lt;!-- Add Google Analytics dependencies: --&gt;

       com.google.gdata
       gdata-core
       1.0

       com.google.gdata
       gdata-analytics
       2.0

	com.google.collect
	google-collect
	1.0
</pre>
<p><strong>Next, fire up your IDE</strong></p>
<p>My chosen IDE is <a href="http://www.jetbrains.com/idea/">IntelliJ IDEA</a>.</p>
<ul>
<li>Open the pom.xml in IntelliJ IDEA (File | Open project)</li>
<li>Override/set the maven home directory:

<div class="wp_syntax"><div class="code"><pre class="bash" style="font-family:monospace;"><span style="color: #000000; font-weight: bold;">/</span>Users<span style="color: #000000; font-weight: bold;">/</span>davidsimpson<span style="color: #000000; font-weight: bold;">/</span>atlassian-plugin-sdk-<span style="color: #000000;">3.0</span>-beta3<span style="color: #000000; font-weight: bold;">/</span>apache-maven</pre></div></div>

</li>
<li>Set the JDK for build as 1.5 or 1.6</li>
<li>Start editing the plugin</li>
</ul>
<h2>Hiccups</h2>
<p>It&#8217;s not all straightforward.  Here&#8217;s some of the annoyances that I came across.</p>
<h3>Maven needs more memory</h3>
<p>I needed more memory for maven.  Not really a problem &#8211; append to <code>~/.profile</code>:</p>
<pre class="brush: bash; title: ;">
MAVEN_OPTS=-Xmx512m
export MAVEN_OPTS
</pre>
<h3>Annoying warnings on <code>atlas-run</code></h3>
<p>I noticed this on running <code>atlas-run</code> &#8211; it probably shouldn&#8217;t be there:</p>

<div class="wp_syntax"><div class="code"><pre class="bash" style="font-family:monospace;"><span style="color: #7a0874; font-weight: bold;">&#91;</span>WARNING<span style="color: #7a0874; font-weight: bold;">&#93;</span> Using platform encoding <span style="color: #7a0874; font-weight: bold;">&#40;</span>MacRoman actually<span style="color: #7a0874; font-weight: bold;">&#41;</span> to copy filtered resources, i.e. build is platform dependent<span style="color: #000000; font-weight: bold;">!</span></pre></div></div>

<p>Of course, someone has already blogged about it — <a href="http://www.redleopard.com/2009/04/macroman-encoding-creeps-into-maven/">Red Leopard</a> — and it&#8217;s easily fixed by editing the POM to add the correct encoding.</p>
<pre class="brush: xml; title: ;">
3.0.2
    3.0

    &lt;!-- Fix for MacRoman warnings on build --&gt;
    UTF-8
    UTF-8
</pre>
<p>Now, we have no nasty warnings.</p>
<h3>The macro browser icon</h3>
<p>I love the Macro Browser in Confluence.  It&#8217;s a nice step forward in the evolution of the UI.  So as a result, I wanted my macro to have a  shiny icon in the macro browser.   That damn Macro Browser icon ate up several hours of my life.  Looking at the comments on the <a href="http://confluence.atlassian.com/display/CONFDEV/Updating+macros+for+the+Macro+Browser">documentation</a> page, several other people have had a whole load of fun getting their pretty icon to show up too.</p>
<div id="attachment_521" class="wp-caption alignnone" style="width: 450px"><a href="http://localhost/davidsimpson.me/wp-content/uploads/2010/01/macro-browser1.png" rel="lightbox[503]" title="macro-browser"><img class="size-medium wp-image-521" title="macro-browser" src="http://davidsimpson.me/wp-content/uploads/2010/01/macro-browser1.png" alt="The macro browser icon: What we're aiming for"  /></a><p class="wp-caption-text">The macro browser icon: What we</p></div>
<p>Could I get the Macro Browser to show my plugin&#8217;s icon. No.  I followed the <a href="http://confluence.atlassian.com/display/CONFDEV/Updating+macros+for+the+Macro+Browser">documentation</a>.  It did not work.  I looked again. This time I <em>really</em> paid attention.  Was it my fat fingers?  Was I just being stupid? (Probably.)  I ignored this for a while — maybe it would be better after a night&#8217;s sleep.</p>
<p>Everything <a href="http://twitter.com/dvdsmpsn/status/5796289204">seemed to work a whole lot better</a> when I dropped the beta and moved to version 3.0.2 of the Plugin SDK.<br />
<strong>Note:</strong> I had to update my <code>~/.profile</code> to point to the new version of the SDK and update the references to maven in Intelli-J at this point.</p>
<p>I also followed a different tack on getting the macro browser icon to work</p>
<ul>
<li>Find a macro that has a custom icon in the macro browser</li>
<li>Go to the Atlassian public subversion repository and browse to the source for that macro plugin.</li>
<li>Copy the exact syntax from the <code>atlassian-plugin.xml</code> and paste into your macro&#8217;s own <code>atlassian-plugin.xml</code></li>
<li>Name the icon exactly the same as in the <code>atlassian-plugin.xml</code> and put it in the correct place in the directory structure</li>
</ul>
<p>I&#8217;m not entirely sure whether it was the copy and paste approach that helped or moving away from the beta.  It works now, so I&#8217;m not going to loose sleep on why.</p>
<h3>Adding a configuring UI to the plugin</h3>
<p>My plugin needed to store Google account credentials and display a list of Google Analytics sites, so you can choose the correct profile.   How do you do that?  Hmmm. Go back to the <a href="http://confluence.atlassian.com/display/CONFDEV/Adding+a+Configuration+UI+for+your+Plugin">documentation</a>.  It wasn&#8217;t nearly detailed enough for my liking, so time to vent a <a href="http://twitter.com/dvdsmpsn/status/5719013792">little</a>.</p>
<p>Again, it seemed the best way to learn was to find a plugin that has a similar kind of configuration to that you&#8217;re hoping for and start appropriating the code.</p>
<h3>Unit testing and integration testing</h3>
<p>This is a good idea. Period. Did I have a clue how to do it for Confluence?  Of course not.</p>
<p>Again, the community helped out.  Atlassian partners at Adaptavist, Comala Technology and Customware have written about this:</p>
<ul>
<li><a href="http://www.customware.net/repository/display/GREENHOUSE/2009/03/18/Integration+Testing+of+Confluence+Plugins">Integration Testing of Confluence Plugins</a> by Bo Wang</li>
<li><a href="http://www.adaptavist.com/display/~erobertshaw/2009/08/17/Unit+testing+a+Confluence+Action">Unit testing a Confluence Action</a> by Edward Robertshaw</li>
<li><a href="http://www.adaptavist.com/display/~erobertshaw/Unit+testing+a+Confluence+Macro">Unit testing a Confluence Macro</a> by Edward Robertshaw</li>
<li><a href="http://www.mundoreves.com/display/HOME/2009/01/29/Confluence+plugin+integration+testing"> Confluence plugin integration testing </a> by Roberto Dominguez</li>
</ul>
<p>Browsing around the Atlassian public subversion repository was also a help.  I&#8217;ve got to say that I&#8217;m an easy convert to testing.  It just makes sense.</p>
<p><strong>Update (2010-05-04):</strong> A nice feature of the SDK is running or testing your plugin against different versions of the product.  This is straightforward:</p>
<pre class="brush: bash; title: ;">
# Integration tests for different versions
atlas-integration-test -v 3.0
atlas-integration-test -v 3.1
atlas-integration-test -v 3.2
# Run different versions of Confluence
atlas-run -v 3.0
atlas-run -v 3.1
atlas-run -v 3.2
</pre>
<h2>Wrapping up</h2>
<p>After a good deal of stumbling around, it turns out that I can write a Confluence plugin after all.  Everything started working a lot better after I updated from the beta version, but that could just be coincidence.  The documentation <em>could</em> be a little better to help the uninitiated  but it was equally my fault for not learning to walk first.  There is a lot of good information, but it is spread over a few different spaces.</p>
<p>My next step was to get the plugin added to Atlassian <a href="https://plugins.atlassian.com/plugin/home">Plugin Exchange</a>.  It took a little while to get this done — maybe that&#8217;s best saved for a follow up post.  The plugin is now <a href="https://plugins.atlassian.com/plugin/details/16722">available</a> on Atlassian Plugin Exchange.  I hope other people get some use out of it.</p>
<!-- PHP 5.x -->]]></content:encoded>
			<wfw:commentRss>http://davidsimpson.me/2010/01/25/some-thoughts-on-developing-my-first-confluence-plugin/feed/</wfw:commentRss>
		<slash:comments>6</slash:comments>
		</item>
		<item>
		<title>Tracking Atlassian Confluence usage with Google Analytics</title>
		<link>http://davidsimpson.me/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/</link>
		<comments>http://davidsimpson.me/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/#comments</comments>
		<pubDate>Wed, 18 Mar 2009 17:45:56 +0000</pubDate>
		<dc:creator>David</dc:creator>
				<category><![CDATA[analytics]]></category>
		<category><![CDATA[Uncategorised]]></category>
		<category><![CDATA[atlassian]]></category>
		<category><![CDATA[confluence]]></category>
		<category><![CDATA[google analytics]]></category>
		<category><![CDATA[wiki]]></category>

		<guid isPermaLink="false">http://davidsimpson.me/?p=177</guid>
		<description><![CDATA[Updated 2011-06-30: Changed to asynchronous Google Analytics tracking You&#8217;ve chosen Confluence as your Enterprise wiki and got it installed. People are using it. But how many people? You could have a look at the Global Activity page on Confluence, but this might confuse matters. You&#8217;ll get to see graphs, but what do they really mean? [...]]]></description>
			<content:encoded><![CDATA[<div id="tweetbutton177" class="tw_button" style=""><a href="http://twitter.com/share?url=http%3A%2F%2Fdavidsimpson.me%2F2009%2F03%2F18%2Ftracking-atlassian-confluence-usage-with-google-analytics%2F&amp;text=Tracking%20Atlassian%20Confluence%20usage%20with%20Google%20Analytics&amp;related=&amp;lang=en&amp;count=horizontal&amp;counturl=http%3A%2F%2Fdavidsimpson.me%2F2009%2F03%2F18%2Ftracking-atlassian-confluence-usage-with-google-analytics%2F" class="twitter-share-button"  style="width:55px;height:22px;background:transparent url('http://davidsimpson.me/wp-content/plugins/wp-tweet-button/tweetn.png') no-repeat  0 0;text-align:left;text-indent:-9999px;display:block;"></a></div><p><strong>Updated 2011-06-30: Changed to asynchronous Google Analytics tracking</strong><br />
You&#8217;ve chosen <a href="http://www.atlassian.com/software/confluence/">Confluence</a> as your Enterprise wiki and got it installed.  People are using it.  But how many people?</p>
<p>You could have a look at the <strong>Global Activity</strong> page on Confluence, but this might confuse matters.  </p>
<p><a href="/wp-content/uploads/2009/03/confluence-global-activity1.png" rel="lightbox[177]" title="Confluence - Global Activity"><img src="http://davidsimpson.me/wp-content/uploads/2009/03/confluence-global-activity1-284x300.png" alt="" title="Confluence - Global Activity" width="284" height="300" class="alignnone size-medium wp-image-217" /></a></p>
<p>You&#8217;ll get to see graphs, but what do they really mean?  The Global Activity statistics are at best very basic.</p>
<p>Better still, install Google Analytics and you&#8217;ll have a much more accurate idea of what&#8217;s going on.  Best of all, it&#8217;s really easy to install.<br />
<span id="more-177"></span></p>
<h2>How to install Google Analytics on Confluence</h2>
<p>I&#8217;m assuming (for my sake) that you already know your way around Google Analytics.</p>
<h3>In Google Analytics</h3>
<p>Login to Google Analytics and add a new website profile</p>
<p>The settings will roughly mirror those in the screenshot below</p>
<p><a href="/wp-content/uploads/2009/03/google-analytics-account-settings.png" rel="lightbox[177]" title="Google Analytics - Account Settings"><img src="/wp-content/uploads/2009/03/google-analytics-account-settings-300x279.png" alt="" title="Google Analytics - Account Settings" width="300" height="279" class="alignnone size-medium wp-image-204" /></a></p>
<p>Make sure that you check &#8220;Do Track Site Search&#8221; against Site Search.  Add <strong>queryString</strong> as the Query Parameter. This will allow you to monitor who is searching for what.  </p>
<p><strong>Update (2009-11-12)</strong><br />
<em>Edit the Search Settings configuration like in the image to see search terms grouped by spaceKey in the internal search categories reports.  Further details why can be seen <a href="http://davidsimpson.me/2009/04/16/4-useful-tips-on-google-analytics-reporting-for-confluence/">here</a></em> </p>
<p><!--***--><div id="attachment_306" class="wp-caption alignnone" style="width: 160px"><a href="/wp-content/uploads/2009/04/settings-site-search.png" rel="lightbox[177]" title="settings-site-search"><img src="/wp-content/uploads/2009/04/settings-site-search-150x150.png" alt="Settings - Site Search" title="settings-site-search" width="150" height="150" class="size-thumbnail wp-image-306" /></a><p class="wp-caption-text">A screenshot of the Site Search Setting section</p></div></p>
<p>The top search terms will suggest either content that&#8217;s missing from the site, or something that is not easily found in the current information architecture.  Either way, tracking this and acting on the findings should improve the user experience.</p>
<h3>In Confluence</h3>
<p>Login to Confluence as an administrator and add the GA tracking javascript code to the end of the page body&#8230;</p>
<p>Navigate to:</p>
<p>Dashboard | Administration | Look and Feel | Custom HTML</p>
<p><a href="/wp-content/uploads/2009/03/confluence-custom-html-1.png" rel="lightbox[177]" title="Confluence - Custom HTML"><img src="/wp-content/uploads/2009/03/confluence-custom-html-1-150x150.png" alt="" title="Confluence - Custom HTML" width="150" height="150" class="alignnone size-thumbnail wp-image-203" /></a></p>
<p>Click on the &#8220;Edit&#8221; button and add the javascript sample (with your tracker code) to the &#8220;At end of the HEAD&#8221; section:</p>
<p><a href="/wp-content/uploads/2009/03/confluence-custom-html-2.png" rel="lightbox[177]" title="Confluence - Edit Custom HTML "><img src="/wp-content/uploads/2009/03/confluence-custom-html-2-150x150.png" alt="" title="Confluence - Edit Custom HTML " width="150" height="150" class="alignnone size-thumbnail wp-image-202" /></a></p>
<pre class="brush: jscript; title: ;">
&lt;script type=&quot;text/javascript&quot;&gt;
  // See: http://davidsimpson.me/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/
  // Put this in Confluence Administration | Look and Feel | Custom HTML -- &quot;At end of the HEAD&quot;

  var _gaq = _gaq || [];
  _gaq.push(['_setAccount', 'UA-XXXX-XX']); // Your GA code here
  _gaq.push(['_trackPageview']);

  // Add a page-level custom variable to record the space-key
  if (typeof jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;) == 'string') {
    _gaq.push(['_setCustomVar',
      1,                        // This custom var is set to slot #1 of 5
      'confluence-space-key',   // The name acts as a kind of category for the user activity
      jQuery('meta[name=confluence-space-key]').attr(&quot;content&quot;),  // This value of the custom variable
      3                         // Sets the scope to page-level
    ]);
  }

  (function() {
    var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
    ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
    var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
  })();

&lt;/script&gt;
</pre>
<h2>Results</h2>
<p>This works nicely, particularly as the custom variable allows us to easily track all space related content separately, and thus facilitate the use of the <a href="https://plugins.atlassian.com/plugin/details/16722">(Google) Analytics reporting plugin for Confluence</a>.</p>
<p>Screenshot of Content by Title report:<br />
<a href="/wp-content/uploads/2009/03/ga-results-content-by-title1.png" rel="lightbox[177]" title="Google Analytics Results - Content by Title"><img src="http://davidsimpson.me/wp-content/uploads/2009/03/ga-results-content-by-title1-300x231.png" alt="" title="Google Analytics Results - Content by Title" width="300" height="231" class="alignnone size-medium wp-image-211" /></a></p>
<p>Screenshot of Site Search Terms report:<br />
<a href="/wp-content/uploads/2009/03/ga-results-site-search.png" rel="lightbox[177]" title="Google Analytics Results - Site Search"><img src="http://davidsimpson.me/wp-content/uploads/2009/03/ga-results-site-search-300x141.png" alt="" title="Google Analytics Results - Site Search" width="300" height="141" class="alignnone size-medium wp-image-214" /></a></p>
<h3>Related Posts <small>(Updated)</small></h3>
<ul>
<li><a href="http://davidsimpson.me/2009/04/16/4-useful-tips-on-google-analytics-reporting-for-confluence/">4 Useful Tips on Google Analytics Reporting for Confluence</a></li>
<li><a href="http://davidsimpson.me/2010/01/02/announcing-google-analytics-plugin-for-confluence/">Announcing: Google Analytics plugin for Confluence</a></li>
<li><a href="http://www.bitvoodoo.ch/display/web/How+to+track+Confluence+usage+with+Google+Analytics">How to track Confluence usage with Google Analytics</a> by Remo Siegwart</li>
</ul>
<!-- PHP 5.x -->]]></content:encoded>
			<wfw:commentRss>http://davidsimpson.me/2009/03/18/tracking-atlassian-confluence-usage-with-google-analytics/feed/</wfw:commentRss>
		<slash:comments>38</slash:comments>
		</item>
	</channel>
</rss>

