Changeset 55207 for trunk/src/wp-includes/deprecated.php

Timestamp:

02/03/2023 03:56:10 AM (2 years ago)

Author:

peterwilsoncc

Message:

Posts, Post Types: Deprecate get_page_by_title() in favour of WP_Query.

Formally deprecate get_page_by_title(). In its current form the function is unpredictable in that it may return a result that leads to a 404 error and will return different results depending on the database version/engine combination used.

It is recommended developers use WP_Query instead:

$query = new WP_Query(
 array(
  'post_type' => 'page',
  'title'     => 'Sample Page',
 )
);

Props TimothyBlynJacobs, costdev, mukesh27, spacedmonkey, peterwilsoncc.
Fixes #57041.

File:

• trunk/src/wp-includes/deprecated.php (modified) (1 diff)

trunk/src/wp-includes/deprecated.php

@@ -4529 +4529 @@
     return $clauses;
 }
+
+/**
+ * Retrieves a page given its title.
+ *
+ * If more than one post uses the same title, the post with the smallest ID will be returned.
+ * Be careful: in case of more than one post having the same title, it will check the oldest
+ * publication date, not the smallest ID.
+ *
+ * Because this function uses the MySQL '=' comparison, $page_title will usually be matched
+ * as case-insensitive with default collation.
+ *
+ * @since 2.1.0
+ * @since 3.0.0 The `$post_type` parameter was added.
+ * @deprecated 6.2.0 Use WP_Query.
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ *
+ * @param string       $page_title Page title.
+ * @param string       $output     Optional. The required return type. One of OBJECT, ARRAY_A, or ARRAY_N, which
+ *                                 correspond to a WP_Post object, an associative array, or a numeric array,
+ *                                 respectively. Default OBJECT.
+ * @param string|array $post_type  Optional. Post type or array of post types. Default 'page'.
+ * @return WP_Post|array|null WP_Post (or array) on success, or null on failure.
+ */
+function get_page_by_title( $page_title, $output = OBJECT, $post_type = 'page' ) {
+    _deprecated_function( __FUNCTION__, '6.2.0', 'WP_Query' );
+    global $wpdb;
+
+    if ( is_array( $post_type ) ) {
+        $post_type           = esc_sql( $post_type );
+        $post_type_in_string = "'" . implode( "','", $post_type ) . "'";
+        $sql                 = $wpdb->prepare(
+            "
+            SELECT ID
+            FROM $wpdb->posts
+            WHERE post_title = %s
+            AND post_type IN ($post_type_in_string)
+        ",
+            $page_title
+        );
+    } else {
+        $sql = $wpdb->prepare(
+            "
+            SELECT ID
+            FROM $wpdb->posts
+            WHERE post_title = %s
+            AND post_type = %s
+        ",
+            $page_title,
+            $post_type
+        );
+    }
+
+    $page = $wpdb->get_var( $sql );
+
+    if ( $page ) {
+        return get_post( $page, $output );
+    }
+
+    return null;
+}