Changeset 3420

Timestamp:

06/17/2016 08:27:41 PM (10 years ago)

Author:

obenland

Message:

Plugin Directory: Introduce a reviews shortcode.

Displays a list of reviews about a plugin.
WIP, still need to properly grab an entire review, not just the rating.

See #1719.

Location:

sites/trunk/wordpress.org/public_html/wp-content

Files:

• plugins/plugin-directory/class-plugin-directory.php (modified) (2 diffs)
• plugins/plugin-directory/class-tools.php (modified) (1 diff)
• plugins/plugin-directory/shortcodes/class-reviews.php (added)
• themes/pub/wporg-plugins/template-parts/plugin-single.php (modified) (2 diffs)

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory/class-plugin-directory.php

@@ -247 +247 @@
                 add_shortcode( 'wporg-plugin-upload',       array( __NAMESPACE__ . '\Shortcodes\Upload',      'display' ) );
                 add_shortcode( 'wporg-plugins-screenshots', array( __NAMESPACE__ . '\Shortcodes\Screenshots', 'display' ) );
+                add_shortcode( 'wporg-plugins-reviews',     array( __NAMESPACE__ . '\Shortcodes\Reviews',     'display' ) );
         }
 
@@ -676 +677 @@
                         'screenshots' => '[wporg-plugins-screenshots]',
                         'developers'  => '[wporg-plugins-developers]',
+                        'reviews'     => '[wporg-plugins-reviews]',
                 );
 

sites/trunk/wordpress.org/public_html/wp-content/plugins/plugin-directory/class-tools.php

@@ -27 +27 @@
 
                 return $tonesque->color();
+        }
+
+        /**
+         * Returns the two latest reviews of a specific plugin.
+         *
+         * @global \wpdb $wpdb WordPress database abstraction object.
+         *
+         * @todo Populate with review title/content.
+         *
+         * @param string $plugin_slug The plugin slug.
+         * @return array|false
+         */
+        public static function get_plugin_reviews( $plugin_slug ) {
+                if ( false === ( $reviews = wp_cache_get( "{$plugin_slug}_reviews", 'wporg-plugins' ) ) ) {
+                        global $wpdb;
+
+                        $reviews = $wpdb->get_results( $wpdb->prepare( "SELECT * FROM ratings WHERE object_type = 'plugin' AND object_slug = %s ORDER BY review_id DESC LIMIT 2", $plugin_slug ) );
+                        wp_cache_set( "{$plugin_slug}_reviews", $reviews, 'wporg-plugins', HOUR_IN_SECONDS );
+                }
+
+                return $reviews;
         }
 

sites/trunk/wordpress.org/public_html/wp-content/themes/pub/wporg-plugins/template-parts/plugin-single.php

@@ -45 +45 @@
                 <?php
                         $plugin_sections = Template::get_plugin_sections();
+
                         foreach ( array( 'description', 'screenshots', 'faq', 'reviews', 'changelog', 'developers' ) as $section_slug ) :
-                                if ( ! array_key_exists( $section_slug, $content ) || in_array( $section_slug, array( 'installation', 'other_notes' ) ) ) :
+                                $section_content = trim( apply_filters( 'the_content', $content[ $section_slug ], $section_slug ) );
+
+                                if ( ! array_key_exists( $section_slug, $content ) || in_array( $section_slug, array( 'installation', 'other_notes' ) ) || empty( $section_content ) ) :
                                         continue;
                                 endif;
+
                                 $section = wp_list_filter( $plugin_sections, array( 'slug' => $section_slug ) );
                                 $section = array_pop( $section );
@@ -55 +59 @@
                         <div id="<?php echo esc_attr( $section_slug ); ?>" class="read-more" aria-expanded="false">
                                 <h2><?php echo $section['title']; ?></h2>
-                                <?php echo apply_filters( 'the_content', $content[ $section_slug ], $section_slug ); ?>
+                                <?php echo $section_content; ?>
                         </div>
                         <button type="button" class="button-link section-toggle" aria-controls="<?php echo esc_attr( $section_slug ); ?>"><?php _e( 'Read more', 'wporg-plugins' ); ?></button>