api.jqueryui.com: Add links for all versions in the sidebar and make it clear which version the current docs apply to. Fixes jquery#234.

Author: scottgonzalez

themes/api.jqueryui.com/functions.php

@@ -0,0 +1,22 @@
+<?php
+
+function jq_ui_api_versions() {
+	// Must be listed with newest first
+	return array(
+		"1.10" => "1.6 and newer",
+		"1.9" => "1.6 and newer",
+		"1.8" => "1.3.2 and newer",
+	);
+}
+
+function jq_ui_api_version_latest() {
+	$versions = jq_ui_api_versions();
+	return key( $versions );
+}
+
+function jq_ui_api_version_current() {
+	$thisVersion = explode( "/", JQUERY_LIVE_SITE );
+	return count( $thisVersion ) === 2 ?
+		$thisVersion[ 1 ] :
+		jq_ui_api_version_latest();
+}

themes/api.jqueryui.com/index.php

@@ -2,16 +2,9 @@
 	get_header();
 	the_post();
 
-	// Must be listed with newest first
-	$versions = array(
-		"1.10" => "1.6 and newer",
-		"1.9" => "1.6 and newer",
-		"1.8" => "1.3.2 and newer",
-	);
-
-	$latestVersion = key( $versions );
-	$thisVersion = explode( "/", JQUERY_LIVE_SITE );
-	$thisVersion = count( $thisVersion ) === 2 ? $thisVersion[ 1 ] : $latestVersion;
+	$versions = jq_ui_api_versions();
+	$latestVersion = jq_ui_api_version_latest();
+	$thisVersion = jq_ui_api_version_current();
 	$rootUrl = $thisVersion === $latestVersion ? '' : "/$thisVersion";
 ?>
 

themes/api.jqueryui.com/sidebar.php

@@ -0,0 +1,33 @@
+<?php
+	$versions = jq_ui_api_versions();
+	$thisVersion = jq_ui_api_version_current();
+	$latestVersion = jq_ui_api_version_latest();
+?>
+
+<div id="sidebar" class="widget-area" role="complementary">
+	<aside id="categories" class="widget">
+		<h3 class="widget-title">jQuery UI <?php echo $thisVersion; ?></h3>
+		<ul>
+			<?php wp_list_categories( array(
+				'depth' => 2,
+				'title_li' => '',
+				'current_category' => jq_post_category(),
+				'use_desc_for_title' => false
+			) ); ?>
+		</ul>
+	</aside>
+
+	<aside id="categories" class="widget">
+		<h3 class="widget-title">Other Versions</h3>
+		<ul>
+			<?php foreach( $versions as $version => $_ ) {
+				if ( $version === $thisVersion ) {
+					continue;
+				}
+
+				$url = $version === $latestVersion ? '/' : "/$version/";
+				echo "<li><a href=\"$url\">jQuery UI $version</a></li>";
+			} ?>
+		</ul>
+	</aside>
+</div>