Changeset 938

Timestamp:

10/26/2014 11:40:46 PM (10 years ago)

Author:

coffee2code

Message:

Code Reference: add changelog support (aka multi-@since)

fixes #653.
props DrewAPicture.

Location:

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer

Files:

• content-reference.php (modified) (2 diffs)
• inc/template-tags.php (modified) (2 diffs)

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/content-reference.php

@@ -15 +15 @@
     </section>
     <section class="return"><p><strong>Return:</strong> <?php echo get_return(); ?></p></section>
-
-    <?php
-    $since = get_since();
-if ( ! empty( $since ) ) : ?>
-    <section class="since">
-        <p><strong>Since:</strong> WordPress <a href="<?php echo get_since_link( $since ); ?>"><?php echo esc_html( $since ); ?></a></p>
-    </section>
-<?php endif; ?>
 
     <?php
@@ -150 +142 @@
     <?php endif; ?>
 
+    <?php
+    $changelog_data = get_changelog_data();
+    if ( ! empty( $changelog_data ) ) :
+        ?>
+        <hr/>
+        <section class="changelog">
+            <h2><?php _e( 'Changelog', 'wporg' ); ?></h2>
+            <ul>
+                <?php foreach ( $changelog_data as $version => $data ) : ?>
+                    <li><?php _e( '<strong>Since:</strong> WordPress', 'wporg' ); ?> <a href="<?php echo esc_url( $data['since_url'] ); ?>"><?php echo esc_html( $version ); ?></a> <?php echo $data['description']; // escaped in get_changelog_data() ?></li>
+                <?php endforeach; ?>
+            </ul>
+        </section>
+    <?php endif; ?>
+
     <?php if ( comments_open() || '0' != get_comments_number() ) : ?>
     <hr/>

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-developer/inc/template-tags.php

@@ -671 +671 @@
 
     /**
-     * Retrieve URL to since version archive
-     *
-     * @param string $name
-     *
-     * @return string
+     * Retrieve changelog data for the current post.
+     *
+     * @param null $post_id Post ID, defaults to the ID of the global $post.
+     *
+     * @return array Associative array of changelog data.
+     */
+    function get_changelog_data( $post_id = null ) {
+        $post_id = empty( $post_id ) ? get_the_ID() : $post_id;
+
+        // Since terms assigned to the post.
+        $since_terms = wp_get_post_terms( $post_id, 'wp-parser-since' );
+
+        // Since data stored in meta.
+        $since_meta = get_post_meta( $post_id, '_wp-parser_tags', true );
+
+        $data = array();
+
+        // Pair the term data with meta data.
+        foreach ( $since_terms as $since_term ) {
+            foreach ( $since_meta as $meta ) {
+                if ( $since_term->name == $meta['content'] ) {
+                    $description = empty( $meta['description'] ) ? '' : '<span class="since-description">' . esc_html( $meta['description'] ) . '</span>';
+
+                    $data[ $since_term->name ] = array(
+                        'version'     => $since_term->name,
+                        'description' => $description,
+                        'since_url'   => get_term_link( $since_term )
+                    );
+                }
+            }
+        }
+        return $data;
+    }
+
+    /**
+     * Retrieve URL to a since version archive.
+     *
+     * @param string $name Since version, e.g. 'x.x.x'.
+     *
+     * @return string Since term archive URL.
      */
     function get_since_link( $name = null ) {
@@ -682 +717 @@
 
         return empty( $since_object ) ? '' : esc_url( get_term_link( $since_object ) );
-    }
-
-    /**
-     * Retrieve name of since version
-     *
-     * @param int $post_id
-     *
-     * @return string
-     */
-    function get_since( $post_id = null ) {
-
-        $since_object = wp_get_post_terms( empty( $post_id ) ? get_the_ID() : $post_id, 'wp-parser-since', array( 'fields' => 'names' ) );
-
-        return empty( $since_object ) ? '' : esc_html( $since_object[0] );
     }