Changeset 938

Timestamp:

10/26/2014 11:40:46 PM (12 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] );
         }