Index: lams_monitoring/conf/language/lams/ApplicationResources.properties
===================================================================
diff -u -ra9c9257fe4de2c325006255af0e79af54aef3bc0 -r8dc1d75924ecfcc0742ba8f8fff00b22f656a284
--- lams_monitoring/conf/language/lams/ApplicationResources.properties	(.../ApplicationResources.properties)	(revision a9c9257fe4de2c325006255af0e79af54aef3bc0)
+++ lams_monitoring/conf/language/lams/ApplicationResources.properties	(.../ApplicationResources.properties)	(revision 8dc1d75924ecfcc0742ba8f8fff00b22f656a284)
@@ -305,6 +305,40 @@
 force.complete.learner.command.message  =The instructor has moved you to another activity.
 index.emailnotifications  =Notifications
 label.email  =Email
+label.tour  =Tour
+tour.intro.title  =Monitor Tour
+tour.intro.content  =This short tour will show you the features of the LAMS Monitoring screen. You can stop the tour at any time by clicking End Tour, and restart it again by clicking on the Tour button.
+tour.end.title  =End Of Tour
+tour.end.content  =Thank you for taking the tour. To restart the tour, click the Tour button again. Remember you can get more help on Monitoring by clicking the Help button on each tab.
+tour.tab.selection.title=Tab Selection
+tour.tab.selection.content=<p>Monitoring is broken into three areas, accessed by these titles at the top of the page.</p><p><strong>Lesson</strong> gives the overall lesson details.</p><p><strong>Sequence</strong> gives an overview of the lesson sequence and is used to access the activities within the lesson.</p><p><strong>Learners</strong> shows the details about each learner.</p>
+tour.tab.refresh.content=Updates the screen.
+tour.help.content=Additional help may be accessed using the Help button.
+tour.lesson.state.content=<p>Click on the current status to change the status. The lesson can be Started, Suspended, Archived or Removed.</p></p><strong>Started</strong> or Activated lessons are available for learners to participate in.</p></p><strong>Suspended</strong> or Disabled lessons are lessons that have been disabled by a monitor. Learners cannot see but not access disabled lessons. Learners currently in the lesson (with a learner window open) can progress through the lesson.</p><p><strong>Archived</strong> lessons do not appear on learner's main screen, but are available for Monitors to view.</p><p><strong>Removed</strong> lessons are removed altogether and cannot be retrieved.</p>
+tour.lesson.count.learners.content=<p>This area shows the number of learners who have started the sequence so far, and the total number of learners who are able to access the sequence.</p><p>Note that this does NOT indicate the number of learners online at this moment, but rather how many learners have joined the sequence since it was started.</p>
+tour.learner.in.class.content=<p>Display the learners in the class. From the resulting learner list you can email a particular learner.</p>
+tour.edit.class.content=<p>Add or Remove learners from the lesson.</p>
+tour.email.notifications.content=<p>Send an email notification to one or more learners. Notifications can be scheduled for later sending.</p>
+tour.lesson.im.content=<p>Click on <strong>Presence</strong> to allow learners to see who is currently online. </p><p>Once Presence is on, the number of learners online is shown on the Presence button. Click <strong>Instant Messaging</strong> to allow learners to message each other.</p><p>Click on Presence and Instant Messaging again to disable.</p><p>View the learners' messages using <strong>Open IM</strong>.</p>
+tour.completion.chart.content=<p>Graph showing the proportion of learners who have not started the lesson, are in progress or have completed the lesson. Hover over the graph sections to see the percentages.</p>
+tour.tab.sequence.content=The sequence tab allows you to manage where learners are in the sequence or make changes to the lesson sequence.
+tour.activity.content=<p>Double click on any activity to see the details for that activity</p>
+tour.move.learners.title=View and Move Learners
+tour.move.learners.small.content=<p>If you have a small number of learners in an activity, hover over each person icon in an activity to find the right learner, then click on the learner to open a view of their current activity or click and drag the icon to move them to another activity</p>
+tour.move.learners.affect.content=<p>Moving a learner forward to a new activity marks them as completed in the earlier activity or activities, without the learner completing the activity themselves.</p>
+tour.move.learners.large.content=<p>If you have a large number of learners in an activity, click on the group/people icon on the top right of the activity. This will bring up a box allowing you to select one or more learners to move, or to see the current activity view for a particular learner.</p>
+tour.completed.learners.title=Completed Learners
+tour.completed.learners.content=<p>The completed learners appear at the bottom of the screen. To make a learner complete the lesson, click and drag the learner's icon from their current activity to this area at the bottom of the screen.</p>
+tour.learner.search.title=Learner Search
+tour.learner.search.content=<p>Enter a first name, last name or login to search for a learner.</p>
+tour.live.edit.title=Live Edit
+tour.live.edit.content=<p>Change the lesson sequence. You can only change the parts not yet accessed by learners, such as adding new activities later in the sequence.</p>
+tour.tab.learners.content=<p>Learners gives a learner by learner view of lesson progression. More learners are available via paging.</p>
+tour.learners.progress.content=<p>Blue circles indicate activities which have been completed by the learner.</p><p>Red squares indicate the current position of the learner in the sequence</p><p>Green triangles represent activities not yet reached.</p>
+tour.completion.sorting.title=Sorting
+tour.completion.sorting.content=<p>Turn on to sort the completed learners first or turn off to sort alphabetically.</p>
+tour.journal.entries.content=<p>View the entries in the learner's journal. These are entries are made in Learner, using the <strong>Save to Journal</strong> option in the <strong>Notebook</strong>.</p>
+tour.email.content=<p>Send an email to a particular learner.</p>
+tour.this.is.disabled=This function is disabled while the tour is running.
 
-
 #======= End labels: Exported 299 labels for en AU =====
Index: lams_monitoring/web/includes/javascript/monitorLesson.js
===================================================================
diff -u -r78d36040b1f0d2787187f414544fb3c52f791cb0 -r8dc1d75924ecfcc0742ba8f8fff00b22f656a284
--- lams_monitoring/web/includes/javascript/monitorLesson.js	(.../monitorLesson.js)	(revision 78d36040b1f0d2787187f414544fb3c52f791cb0)
+++ lams_monitoring/web/includes/javascript/monitorLesson.js	(.../monitorLesson.js)	(revision 8dc1d75924ecfcc0742ba8f8fff00b22f656a284)
@@ -1,4 +1,4 @@
-// ********** GLOBAL VARIABLES **********
+// ********** GLOBAL VARIABLES **********
 // copy of lesson SVG so it does no need to be fetched every time
 var originalSequenceCanvas = null,
 // DIV container for lesson SVG
@@ -42,7 +42,7 @@
  * Sets up lesson tab.
  */
 function initLessonTab(){
-	// sets presence availability
+	// sets presence availability. buttons may be temporarily disable by the tour.
 	$('#presenceButton').click(function(){
 		var checked = $(this).toggleClass('btn-success').hasClass('btn-success');
 		$.ajax({
@@ -56,9 +56,9 @@
 			},
 			success : function() {
 				updatePresenceAvailableCount();
-				
 				if (checked) {
 					$('#imButton').show();
+					$('#imButton').prop('disabled', false);
 					alert(LABELS.LESSON_PRESENCE_ENABLE_ALERT);
 				} else {
 					$('#imButton').removeClass('btn-success').hide();
@@ -83,6 +83,7 @@
 			success : function() {
 				if (checked) {
 					$('#openImButton').show();
+					$('#openImButton').prop('disabled', false);
 					alert(LABELS.LESSON_IM_ENABLE_ALERT);
 				} else {
 					$('#openImButton').hide();
@@ -811,7 +812,7 @@
 			}
 			
 			var learnerTotalCount = learnerCount + response.completedLearnerCount;
-			$('#learnersStartedPossibleCell').text(learnerTotalCount + ' / ' + response.numberPossibleLearners);
+			$('#learnersStartedPossibleCell').html('<span id="tour-learner-count">'+learnerTotalCount + ' / ' + response.numberPossibleLearners+'</span>');
 			addCompletedLearnerIcons(response.completedLearners, response.completedLearnerCount, learnerTotalCount);
 			
 			$.each(response.activities, function(activityIndex, activity){
@@ -1676,7 +1677,7 @@
 		  '<tr><td class="active" id="progressBarLabel;00;"><strong>;11;</strong>';
 
 		learnerProgressCellsTemplate +=
-			'<a class="btn btn-xs btn-default pull-right" href="#" onClick="javascript:showEmailDialog(;00;)"><i class="fa fa-envelope-o"></i> '
+			'<a class="btn btn-xs btn-default pull-right tour-email-button" href="#" onClick="javascript:showEmailDialog(;00;)"><i class="fa fa-envelope-o"></i> '
 		+ LABELS.EMAIL_BUTTON
 		+ '</a></td></tr><tr><td class="progressBarCell" id="progressBar;00;"></td></tr>';
 	}
Index: lams_monitoring/web/monitor.jsp
===================================================================
diff -u -r75765d2caf035efe57e40cad41337756253d488f -r8dc1d75924ecfcc0742ba8f8fff00b22f656a284
--- lams_monitoring/web/monitor.jsp	(.../monitor.jsp)	(revision 75765d2caf035efe57e40cad41337756253d488f)
+++ lams_monitoring/web/monitor.jsp	(.../monitor.jsp)	(revision 8dc1d75924ecfcc0742ba8f8fff00b22f656a284)
@@ -12,6 +12,7 @@
 
 	<link rel="stylesheet" href="<lams:LAMSURL/>css/jquery-ui.timepicker.css" type="text/css" media="screen" />
 	<link href="/lams/css/defaultHTML_learner.css" rel="stylesheet" type="text/css">
+	<link rel="stylesheet" href="<lams:LAMSURL />css/bootstrap-tour.min.css"> 
   	<link rel="stylesheet" href="<lams:LAMSURL/>css/jquery-ui-bootstrap-theme.css" type="text/css" media="screen">	
 	<link rel="stylesheet" href="<lams:LAMSURL/>css/progressBar.css" type="text/css" />
 	<link rel="stylesheet" href="<lams:LAMSURL/>/css/chart.css" type="text/css" />
@@ -35,6 +36,7 @@
 	<script type="text/javascript" src="<lams:WebAppURL />includes/javascript/monitorLesson.js"></script>
 	<script type="text/javascript" src="<lams:LAMSURL/>includes/javascript/bootstrap.min.js"></script>
 	<script type="text/javascript" src="<lams:LAMSURL/>includes/javascript/bootstrap.tabcontroller.js"></script>
+	<script type="text/javascript" src="<lams:LAMSURL />includes/javascript/bootstrap-tour.min.js"></script> 
 	<script type="text/javascript" src="<lams:LAMSURL/>includes/javascript/dialog.js"></script>
 
 	
@@ -50,6 +52,7 @@
 			presenceEnabled =  false,
 			hasDialog = false,
 			sequenceTabShowInfo = ${sequenceTabShowInfo eq true},
+			tourInProgress = false;
 			
 			LAMS_URL = '<lams:LAMSURL/>',
 			
@@ -168,7 +171,9 @@
 				<fmt:message key="label.lesson.introduction" var="LESSON_INTRODUCTION_VAR"/>
 				LESSON_INTRODUCTION : '<c:out value="${LESSON_INTRODUCTION_VAR}" />',
 				<fmt:message key="label.email" var="EMAIL_TITLE_VAR"/>
-				EMAIL_TITLE : '<c:out value="${EMAIL_TITLE_VAR}" />'
+				EMAIL_TITLE : '<c:out value="${EMAIL_TITLE_VAR}" />',
+				<fmt:message key="tour.this.is.disabled" var="TOUR_DISABLED_ELEMENT_VAR"/>
+				TOUR_DISABLED_ELEMENT : '<c:out value="${TOUR_DISABLED_ELEMENT_VAR}" />'
 			}
 	    
 		$(document).ready(function(){
@@ -188,6 +193,14 @@
 		});
 			
         function doSelectTab(tabId) {
+        	if ( tourInProgress )  {
+        		alert(LABELS.TOUR_DISABLED_ELEMENT);
+        		return;
+        	}
+        	actualDoSelectTab(tabId);
+        }
+
+        function actualDoSelectTab(tabId) {
 	    	selectTab(tabId);
 			var sequenceInfoDialog = $('#sequenceInfoDialog');
 	    	if ( tabId == '2' ) {
@@ -201,6 +214,8 @@
         }
         
 
+    	<%@ include file="monitorTour.jsp" %> 
+
 	</script>
 	
 	
@@ -225,10 +240,14 @@
 				<lams:TabBody id="1" titleKey="label.basic">
 					<div class="row">
 						<div class="col-xs-12">
-							<a target="_blank" class="btn btn-sm btn-default pull-right" title="<fmt:message key='button.help.tooltip'/>"
+							<a id="tour-help-button" target="_blank" class="btn btn-sm btn-default pull-right" title="<fmt:message key='button.help.tooltip'/>"
 							   href="http://wiki.lamsfoundation.org/display/lamsdocs/monitoringlesson">
 							<i class="fa fa-question-circle"></i> <span class="hidden-xs"><fmt:message key="button.help"/></span></a>
-							<a class="btn btn-sm btn-default pull-right roffset10" title="<fmt:message key='button.refresh.tooltip'/>"
+							
+							<a href="javascript:;" onclick="javascript:startTour();" class="btn btn-sm btn-default pull-right roffset10"> 
+							<i class="fa fa-question-circle"></i> <span class="hidden-xs"><fmt:message key="label.tour"/></span></a>
+							
+							<a id="tour-refresh-button" class="btn btn-sm btn-default pull-right roffset10" title="<fmt:message key='button.refresh.tooltip'/>"
 							   href="#" onClick="javascript:refreshMonitor('lesson')">
 							<i class="fa fa-refresh"></i> <span class="hidden-xs"><fmt:message key="button.refresh"/></span></a>				
 							<p id="tabLessonLessonName">
@@ -332,7 +351,7 @@
 								<!-- IM & Presence -->
 								<dt><fmt:message key="lesson.im"/>:</dt>
 								<dd>
-									<div class="btn-group btn-group-xs" role="group">
+									<div class="btn-group btn-group-xs" role="group" id="tour-lesson-im">
 										<button id="presenceButton" class="btn btn-default roffset10
 											<c:if test="${lesson.learnerPresenceAvailable}">
 												btn-success
@@ -499,7 +518,7 @@
 								   href="#" onClick="javascript:refreshMonitor('learners')">
 								   <i class="fa fa-refresh"></i> <span class="hidden-xs"><fmt:message key="button.refresh"/></span></a>
 								<a class="btn btn-sm btn-default" title="<fmt:message key='button.journal.entries.tooltip'/>"
-						   		   href="#"
+						   		   href="#" id="journalButton"
 						           onClick="javascript:openPopUp('<lams:LAMSURL/>learning/notebook.do?method=viewAllJournals&lessonID=${lesson.lessonID}', 'JournalEntries', 648, 1152, true)">
 						           <i class="fa fa-book"></i> <span class="hidden-xs"><fmt:message key="button.journal.entries"/></span></a>
 							</td>
Index: lams_monitoring/web/monitorTour.jsp
===================================================================
diff -u
--- lams_monitoring/web/monitorTour.jsp	(revision 0)
+++ lams_monitoring/web/monitorTour.jsp	(revision 8dc1d75924ecfcc0742ba8f8fff00b22f656a284)
@@ -0,0 +1,205 @@
+	<%--  The definition of Bootstrap Tour for monitor.jsp. Use storage: false so that it always starts at the first step otherwise the multiple tabs confuses matters. --%>
+	var tour = null;
+	function startTour() {
+	debugger;
+		tourInProgress = true;
+		if ( tour == null ) {
+			tour = new Tour({
+			  name: "LAMSMonitorTour",
+		      steps: [
+		          {
+			        title: "<fmt:message key="tour.intro.title"/>",
+			        content: "<fmt:message key="tour.intro.content"/>",
+			        orphan: true
+			      }, {
+			        element: "#page-tabs",
+			        title: "<fmt:message key="tour.tab.selection.title"/>",
+			        content: "<fmt:message key="tour.tab.selection.content"/>",
+		        	placement: "bottom",
+			      },{
+			      	element: "#tour-refresh-button",
+			        title: "<fmt:message key="button.refresh"/>",
+			        content: "<fmt:message key="tour.tab.refresh.content"/>",
+		        	placement: "bottom",
+			      }, {
+			      	element: "#tour-help-button",
+			        title: "<fmt:message key="button.help"/>",
+			        content: "<fmt:message key="tour.help.content"/>",
+		        	placement: "left",
+			      },{
+			        element: "#lessonStateLabel:first-child",
+			        title: "<fmt:message key="lesson.state"/>",
+			        content: "<fmt:message key="tour.lesson.state.content"/>",
+			        placement: "right",
+			      },{
+			        element: "#tour-learner-count",
+			        title: "<fmt:message key="lesson.learners"/>",
+			        content: "<fmt:message key="tour.lesson.count.learners.content"/>",
+			        placement: "right",
+			      },{
+			        element: "#viewLearnersButton",
+			        title: "<fmt:message key="button.view.learners"/>",
+			        content: "<fmt:message key="tour.learner.in.class.content"/>",
+			        placement: "top",
+			      },{
+			        element: "#editClassButton",
+			        title: "<fmt:message key="button.edit.class"/>",
+			        content: "<fmt:message key="tour.edit.class.content"/>",
+			        placement: "top",
+			      },{
+			        element: "#notificationButton",
+			        title: "<fmt:message key="email.notifications"/>",
+			        content: "<fmt:message key="tour.email.notifications.content"/>",
+			        placement: "top",
+			      },{
+			        element: "#tour-lesson-im",
+			        title: "<fmt:message key="lesson.im"/>",
+			        content: "<fmt:message key="tour.lesson.im.content"/>",
+			        placement: "bottom",
+			        onShow: revealIM,
+			        onHide: hideIM
+			      },{
+			        element: "#chartDiv",
+			        title: "<fmt:message key="lesson.chart.title"/>",
+			        content: "<fmt:message key="tour.completion.chart.content"/>",
+			        placement: "bottom",
+			        onNext: switchToSequence
+			      },{
+			      	title: "<fmt:message key="tab.sequence"/>",
+			        content: "<fmt:message key="tour.tab.sequence.content"/>",
+			        orphan: true,
+			        onPrev: switchToLesson
+			      },{
+			        element: "#sequenceCanvas",
+			        title: "<fmt:message key="tab.sequence"/>",
+			        content: "<fmt:message key="tour.activity.content"/>",
+			        placement: "top",
+			        backdrop: true
+			      },{
+			        element: "#sequenceCanvas",
+			        title: "<fmt:message key="tour.move.learners.title"/>",
+			        content: "<fmt:message key="tour.move.learners.small.content"/>",
+			        placement: "top",
+					backdrop: true
+			      },{
+			        element: "#sequenceCanvas",
+			        title: "<fmt:message key="tour.move.learners.title"/>",
+			        content: "<fmt:message key="tour.move.learners.affect.content"/>",
+			        placement: "top",
+			        backdrop: true
+			      },{
+			        element: "#sequenceCanvas",
+			        title: "<fmt:message key="tour.move.learners.title"/>",
+			        content: "<fmt:message key="tour.move.learners.large.content"/>",
+			        placement: "top",
+			        backdrop: true
+			      },{
+			        element: "#completedLearnersContainer",
+			        title: "<fmt:message key="tour.completed.learners.title"/>",
+			        content: "<fmt:message key="tour.completed.learners.content"/>",
+			        placement: "top",
+			        backdrop: true
+			      },{
+			        element: "#sequenceSearchPhrase",
+			        title: "<fmt:message key="tour.learner.search.title"/>",
+			        content: "<fmt:message key="tour.learner.search.content"/>",
+			        placement: "bottom",
+			      },{
+			        element: "#liveEditButton",
+			        title: "<fmt:message key="tour.live.edit.title"/>",
+			        content: "<fmt:message key="tour.live.edit.content"/>",
+			        placement: "bottom",
+			        onNext: switchToLearners
+			      },{
+			        title: "<fmt:message key="tab.learners"/>",
+			        content: "<fmt:message key="tour.tab.learners.content"/>",
+			        orphan: true,
+			        onPrev: switchToSequence
+			      },{
+			        element: "#tabLearnersContainer",
+			        title: "<fmt:message key="tab.learners"/>",
+			        content: "<fmt:message key="tour.learners.progress.content"/>",
+			        placement: "top",
+			        backdrop: true,
+			      },{
+			        element: "#learnersSearchPhrase",
+			        title: "<fmt:message key="tour.learner.search.title"/>",
+			        content: "<fmt:message key="tour.learner.search.content"/>",
+			        placement: "bottom",
+			      },{
+			        element: "#orderByCompletionCheckbox",
+			        title: "<fmt:message key="tour.completion.sorting.title"/>",
+			        content: "<fmt:message key="tour.completion.sorting.content"/>",
+			        placement: "bottom",
+			      },{
+			        element: "#journalButton", 
+			        title: "<fmt:message key="button.journal.entries"/>",
+			        content: "<fmt:message key="tour.journal.entries.content"/>",
+			        placement: "bottom",
+			      },{
+			        element: ".tour-email-button:first", 
+			        title: "<fmt:message key="label.email"/>",
+			        content: "<fmt:message key="tour.email.content"/>",
+			        placement: "left",
+			      },{
+					title: "<fmt:message key="tour.end.title"/>",
+			        content: "<fmt:message key="tour.end.content"/>",
+			        placement: "top",
+			        orphan: true
+			      }		     
+			    ],
+			  onEnd: tourEnd,
+			  debug: true,
+			  backdrop: false,
+			  storage: false
+			});
+
+		    tour.init();
+		    tour.start(true);
+
+		} else {
+			tour.restart();
+		}
+	}
+	
+ 	function revealIM(tour) { 
+		var checked = $('#presenceButton').hasClass('btn-success');
+		if (!checked) {
+			$("#imButton").css('display', 'block');
+			$('#imButton').prop('disabled', true);
+		}			
+		checked = $('#imButton').hasClass('btn-success');
+		if (!checked) {
+			$("#openImButton").css('display', 'block');
+			$('#openImButton').prop('disabled', true);
+		}				
+	}
+	
+ 	function hideIM(tour) { 
+		$('#imButton').prop('disabled', false);
+		var checked = $('#presenceButton').hasClass('btn-success');
+		if (!checked) {
+			$("#imButton").css('display', 'none');
+		}				
+		$('#openImButton').prop('disabled', false);
+		checked = $('#imButton').hasClass('btn-success');
+		if (!checked) {
+			$("#openImButton").css('display', 'none');
+		}				
+	}
+	
+	function switchToLesson() {
+		actualDoSelectTab(1);
+	}
+
+	function switchToSequence() {
+		actualDoSelectTab(2);
+	}
+
+	function switchToLearners() {
+		actualDoSelectTab(3);
+	}
+	
+	function tourEnd() {
+		tourInProgress = false;
+	}
\ No newline at end of file