post_exists( string $title, string $content = '', string $date = '', string $type = '', string $status = '' )
Determines if a post exists based on title, content, date and type.
Parameters
- $title
-
(string) (Required) Post title.
- $content
-
(string) (Optional) post content.
Default value: ''
- $date
-
(string) (Optional) post date.
Default value: ''
- $type
-
(string) (Optional) post type.
Default value: ''
- $status
-
(string) (Optional) post status.
Default value: ''
Return
(int) Post ID if post exists, 0 otherwise.
Source
File: wp-admin/includes/post.php
function post_exists( $title, $content = '', $date = '', $type = '', $status = '' ) {
global $wpdb;
$post_title = wp_unslash( sanitize_post_field( 'post_title', $title, 0, 'db' ) );
$post_content = wp_unslash( sanitize_post_field( 'post_content', $content, 0, 'db' ) );
$post_date = wp_unslash( sanitize_post_field( 'post_date', $date, 0, 'db' ) );
$post_type = wp_unslash( sanitize_post_field( 'post_type', $type, 0, 'db' ) );
$post_status = wp_unslash( sanitize_post_field( 'post_status', $status, 0, 'db' ) );
$query = "SELECT ID FROM $wpdb->posts WHERE 1=1";
$args = array();
if ( ! empty( $date ) ) {
$query .= ' AND post_date = %s';
$args[] = $post_date;
}
if ( ! empty( $title ) ) {
$query .= ' AND post_title = %s';
$args[] = $post_title;
}
if ( ! empty( $content ) ) {
$query .= ' AND post_content = %s';
$args[] = $post_content;
}
if ( ! empty( $type ) ) {
$query .= ' AND post_type = %s';
$args[] = $post_type;
}
if ( ! empty( $status ) ) {
$query .= ' AND post_status = %s';
$args[] = $post_status;
}
if ( ! empty( $args ) ) {
return (int) $wpdb->get_var( $wpdb->prepare( $query, $args ) );
}
return 0;
} Changelog
| Version | Description |
|---|---|
| 5.8.0 | Added the $status parameter. |
| 5.2.0 | Added the $type parameter. |
| 2.0.0 | Introduced. |
© 2003–2021 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/post_exists