Implemented return information template tag.

krogsgard · Jan 12, 2014 · 1afebe4 · 1afebe4
1 parent f9f4f95
commit 1afebe4
Show file tree

Hide file tree

Showing 2 changed files with 29 additions and 1 deletion.
diff --git a/archive-wpapi-function.php b/archive-wpapi-function.php
@@ -24,7 +24,7 @@
 					<?php the_content(); ?>
 				</section>
 
-				<section class="return"><strong>Return:</strong> TODO</section>
+				<section class="return"><strong>Return:</strong> <?php echo get_return(); ?></section>
 
 				<?php
 				$since = get_since();

diff --git a/template-tags.php b/template-tags.php
@@ -58,6 +58,34 @@ function get_current_version() {
 	return $version[0];
 }
 
+/**
+ * Retrieve return type and description if available
+ *
+* @param int $post_id
+ *
+ * @return string
+ */
+function get_return( $post_id = null ) {
+
+	if ( empty( $post_id ) ) {
+		$post_id = get_the_ID();
+	}
+
+	$tags   = get_post_meta( $post_id, '_wpapi_tags', true );
+	$return = wp_filter_object_list( $tags, array( 'name' => 'return' ) );
+
+	if ( empty( $return ) ) {
+		$description = '';
+		$type        = 'void';
+	} else {
+		$return      = array_shift( $return );
+		$description = empty( $return['content'] ) ? '' : esc_html( $return['content'] );
+		$type        = empty( $return['types'] ) ? '' : esc_html( implode( '|', $return['types'] ) );
+	}
+
+	return "<span class='return-type'>{$type}</span> $description";
+}
+
 /**
  * Retrieve URL to since version archive
  *