Changeset 3420

Timestamp:

06/17/2016 08:27:41 PM (8 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>