Changeset 44591

Timestamp:

01/15/2019 01:53:02 AM (8 years ago)

Author:

pento

Message:

Link Template: In get_adjacent_post(), move the sanitisation of $excluded_terms earlier.

This is a followup to [42828], ensuring that the get_{$adjacent}_post_excluded_terms filter is always passed an array, as expected.

Props soulseekah, zottto.
Fixes #43521.

Location:

trunk

Files:

• src/wp-includes/link-template.php (modified) (2 diffs)
• tests/phpunit/tests/link/getAdjacentPost.php (modified) (1 diff)

trunk/src/wp-includes/link-template.php

@@ -1688 +1688 @@
         $adjacent = $previous ? 'previous' : 'next';
 
+        if ( ! empty( $excluded_terms ) && ! is_array( $excluded_terms ) ) {
+                // back-compat, $excluded_terms used to be $excluded_terms with IDs separated by " and "
+                if ( false !== strpos( $excluded_terms, ' and ' ) ) {
+                        _deprecated_argument( __FUNCTION__, '3.3.0', sprintf( __( 'Use commas instead of %s to separate excluded terms.' ), "'and'" ) );
+                        $excluded_terms = explode( ' and ', $excluded_terms );
+                } else {
+                        $excluded_terms = explode( ',', $excluded_terms );
+                }
+
+                $excluded_terms = array_map( 'intval', $excluded_terms );
+        }
+
         /**
          * Filters the IDs of terms excluded from adjacent post queries.
@@ -1696 +1708 @@
          * @since 4.4.0
          *
-         * @param string $excluded_terms Array of excluded term IDs.
+         * @param array $excluded_terms Array of excluded term IDs.
          */
         $excluded_terms = apply_filters( "get_{$adjacent}_post_excluded_terms", $excluded_terms );
 
         if ( $in_same_term || ! empty( $excluded_terms ) ) {
-                if ( ! empty( $excluded_terms ) && ! is_array( $excluded_terms ) ) {
-                        // back-compat, $excluded_terms used to be $excluded_terms with IDs separated by " and "
-                        if ( false !== strpos( $excluded_terms, ' and ' ) ) {
-                                _deprecated_argument( __FUNCTION__, '3.3.0', sprintf( __( 'Use commas instead of %s to separate excluded terms.' ), "'and'" ) );
-                                $excluded_terms = explode( ' and ', $excluded_terms );
-                        } else {
-                                $excluded_terms = explode( ',', $excluded_terms );
-                        }
-
-                        $excluded_terms = array_map( 'intval', $excluded_terms );
-                }
-
                 if ( $in_same_term ) {
                         $join  .= " INNER JOIN $wpdb->term_relationships AS tr ON p.ID = tr.object_id INNER JOIN $wpdb->term_taxonomy tt ON tr.term_taxonomy_id = tt.term_taxonomy_id";

trunk/tests/phpunit/tests/link/getAdjacentPost.php

@@ -313 +313 @@
         }
 
+        /**
+         * @ticket 43521
+         */
+        public function test_excluded_terms_filter_empty() {
+                register_taxonomy( 'wptests_tax', 'post' );
+
+                $terms = self::factory()->term->create_many(
+                        2,
+                        array(
+                                'taxonomy' => 'wptests_tax',
+                        )
+                );
+
+                $p1 = self::factory()->post->create( array( 'post_date' => '2015-08-27 12:00:00' ) );
+                $p2 = self::factory()->post->create( array( 'post_date' => '2015-08-26 12:00:00' ) );
+                $p3 = self::factory()->post->create( array( 'post_date' => '2015-08-25 12:00:00' ) );
+
+                wp_set_post_terms( $p1, array( $terms[0], $terms[1] ), 'wptests_tax' );
+                wp_set_post_terms( $p2, array( $terms[1] ), 'wptests_tax' );
+                wp_set_post_terms( $p3, array( $terms[0] ), 'wptests_tax' );
+
+                $this->go_to( get_permalink( $p1 ) );
+
+                $this->exclude_term = $terms[1];
+                add_filter( 'get_previous_post_excluded_terms', array( $this, 'filter_excluded_terms' ) );
+
+                $found = get_adjacent_post( false, array(), true, 'wptests_tax' );
+
+                remove_filter( 'get_previous_post_excluded_terms', array( $this, 'filter_excluded_terms' ) );
+                unset( $this->exclude_term );
+
+                $this->assertSame( $p3, $found->ID );
+        }
+
         public function filter_excluded_terms( $excluded_terms ) {
                 $excluded_terms[] = $this->exclude_term;