From c153688d93f4e289edb1dd240544055753f4049a Mon Sep 17 00:00:00 2001
From: John Bintz <john@coswellproductions.com>
Date: Thu, 8 Oct 2009 21:40:04 -0400
Subject: [PATCH] more cleanup

---
 classes/partials/_how-it-works.inc            | 50 +++++++++++++++++++
 .../partials/_manage-queued-transcripts.inc   | 25 ++++++++--
 classes/partials/admin.inc                    |  1 +
 what-did-they-say.php                         |  7 ---
 4 files changed, 73 insertions(+), 10 deletions(-)
 create mode 100644 classes/partials/_how-it-works.inc

diff --git a/classes/partials/_how-it-works.inc b/classes/partials/_how-it-works.inc
new file mode 100644
index 0000000..e248a70
--- /dev/null
+++ b/classes/partials/_how-it-works.inc
@@ -0,0 +1,50 @@
+<?php if (current_user_can('submit_transcriptions')) { ?>
+  <h3><?php _e('How It Works', 'what-did-they-say') ?></h3>
+
+  <p>
+    <?php _e('<strong>What Did They Say?!?</strong> uses a wspecial workflow to handle the submission and approval of transcripts.', 'what-did-they-say') ?>
+    <?php _e('Below are the typical usage patterns of <strong>What Did They Say?!?</strong>:', 'what-did-they-say') ?>
+  </p>
+
+  <hr />
+
+	<h4><?php _e('A single user updating their own transcripts', 'what-did-they-say') ?></h4>
+
+	<p>
+    <?php _e('If you\'re the only user of the site, you would edit the <strong>Approved transcripts</strong> of each post. You don\'t need to enable transcript submissions for any of your posts.', 'what-did-they-say') ?>
+    <?php _e('All users need to have enough permissions to <strong>Approve Transcripts</strong>.', 'what-did-they-say') ?>
+	</p>
+
+  <hr />
+
+	<h4><?php _e('Multiple users who directly update transcripts on posts', 'what-did-they-say') ?></h4>
+
+	<p>
+    <?php _e('If you trust the other users on your site, you all would edit the <strong>Approved transcripts</strong> of each post. Again, you don\'t need to enable transcript submissions for any of your posts.', 'what-did-they-say') ?>
+    <?php _e('All users need to have enough permissions to <strong>Approve Transcripts</strong>.', 'what-did-they-say') ?>
+	</p>
+
+  <hr />
+	
+	<h4><?php _e('Multiple users, some of which submit transcripts and some that approve transcripts', 'what-did-they-say') ?></h4>
+
+	<p>
+    <?php _e('The users who are allowed to submit transcripts get the <strong>Submit Transcripts</strong> capability.', 'what-did-they-say') ?>
+    <?php _e('The users who aprove transcripts get the <strong>Approve Transcripts</strong> capability.', 'what-did-they-say') ?>
+  </p>
+	
+	<p>
+    <?php _e('For posts where users are allowed to submit transcripts, a user with Approve Transcripts needs to enable <strong>Allow new transcripts for this post</strong>.', 'what-did-they-say') ?>
+  </p>
+
+	<p>
+    <?php _e('Transcript submitters need to submit transcripts from the post directly, not from the Admin interface.', 'what-did-they-say') ?>
+    <?php _e('Transcript submitters submit their transcripts to the queue, making them <strong>Queued Transcripts</strong>.', 'what-did-they-say') ?>
+    <?php _e('Submitters can edit and delete their own transcripts while they\'re in the queue. Once they\'re approved, they can no longer be edited by the submitter.', 'what-did-they-say') ?>
+	</p>
+
+	<p>
+    <?php _e('Transcript approvers can approve, edit, or delete queued transcripts of any users.', 'what-did-they-say') ?>
+    <?php _e('Once a transcript is approved, it\'s removed from the queue and made live on the site.', 'what-did-they-say') ?>
+	</p>
+<?php } ?>
diff --git a/classes/partials/_manage-queued-transcripts.inc b/classes/partials/_manage-queued-transcripts.inc
index f059dcf..b709e2d 100644
--- a/classes/partials/_manage-queued-transcripts.inc
+++ b/classes/partials/_manage-queued-transcripts.inc
@@ -1,7 +1,26 @@
-<?php if ((count($queued_transcripts_for_user) > 0) && !current_user_can('approve_transcriptions') && !is_admin()) { ?>
-  <h3 style="margin-top: 0.5em"><?php _e('Your Submitted Transcripts:', 'what-did-they-say') ?></h3>
+<?php
+
+
+	$transcripts_to_show = array();
+
+	if (current_user_can('approve_transcriptions')) {
+		$transcripts_to_show = $queued_transcripts->get_transcripts();
+		$title = __('All Submitted Transcripts', 'what-did-they-say');
+	} else {
+		if (!is_admin()) {
+	    $user = wp_get_current_user();
+	    if (!empty($user)) {
+	      $transcripts_to_show = $queued_transcripts->get_transcripts_for_user($user->ID);
+				$title = __('Your Submitted Transcripts', 'what-did-they-say');
+	    }
+		}
+	}
+?>
+
+<?php if (!empty($transcripts_to_show)) { ?>
+  <h3 style="margin-top: 0.5em"><?php echo $title ?></h3>
   <?php
-    foreach ($queued_transcripts_for_user as $transcript) {
+    foreach ($transcripts_to_show as $transcript) {
       include(dirname(__FILE__) . '/classes/partials/_display-queued-transcript.inc');
     }
   ?>
diff --git a/classes/partials/admin.inc b/classes/partials/admin.inc
index bb32af4..0eaa1cd 100644
--- a/classes/partials/admin.inc
+++ b/classes/partials/admin.inc
@@ -1,6 +1,7 @@
 <?php
   $pages = array(
     'introduction' => __('Introduction', 'what-did-they-say'),
+    'how-it-works' => __('How It Works', 'what-did-they-say'),
     'capabilities' => array(__('Capabilities', 'what-did-they-say'), 'edit_users'),
     'default-styles' => array(__('Styles', 'what-did-they-say'), 'edit_themes'),
     'change-languages' => array(__('Languages', 'what-did-they-say'), 'change_languages'),
diff --git a/what-did-they-say.php b/what-did-they-say.php
index f44f176..3e1dcfe 100644
--- a/what-did-they-say.php
+++ b/what-did-they-say.php
@@ -184,15 +184,8 @@ function the_media_transcript_queue_editor() {
   global $post;
 
   if (current_user_can('submit_transcriptions')) {
-    $queued_transcripts_for_user = false;
-
     $queued_transcripts = new WDTSQueuedTranscript($post->ID);
 
-    $user = wp_get_current_user();
-    if (!empty($user)) {
-      $queued_transcripts_for_user = $queued_transcripts->get_transcripts_for_user($user->ID);
-    }
-
     $language_options = new WDTSLanguageOptions();
 
     $transcript_options = new WDTSTranscriptOptions($post->ID);