is_preview()
Determines whether the query is for a post or page preview.
Description
For more information on this and similar theme functions, check out the Conditional Tags article in the Theme Developer Handbook.
Return
(bool)
Source
File: wp-includes/query.php
function is_preview() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' );
return false;
}
return $wp_query->is_preview();
}
Changelog
| Version | Description |
|---|---|
| 2.0.0 | Introduced. |
is_preview()does NOT check if the user is logged in, or if the user can even edit the post.Use
current_user_can()for checking roles and capabilities.Any visitor can add
?preview=true,?preview=1, or?preview=not_falseto the URL, andis_preview()will returntrue.function comments_template( $file = '/comments.php', $separate_comments = false ) { global $wp_query, $withcomments, $post, $wpdb, $id, $comment, $user_login, $user_ID, $user_identity, $overridden_cpage; if ( ! ( is_single() || is_page() || $withcomments ) || empty( $post ) ) { return; } if ( is_preview() ) { return; }Useful to stop comments showing in the preview, especially if you use Disqus Conditional Load. This made the preview work for me, as DCL stopped them from working. Add this to
wp-includes/comment-template.php.Example
if ( ! is_preview() ) { // Include analytics code }