Alert: This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

_doing_it_wrong( string $function, string $message, string $version )

Mark something as being incorrectly called.

Contents

Description Description

There is a hook ‘doing_it_wrong_run’ that will be called that can be used to get the backtrace up to what file and function called the deprecated function.

The current behavior is to trigger a user error if WP_DEBUG is true.

Parameters Parameters

$function

(string) (Required) The function that was called.

$message

(string) (Required) A message explaining what has been done incorrectly.

$version

(string) (Required) The version of WordPress where the message was added.

Top ↑

Source Source

File: wp-includes/functions.php 

function _doing_it_wrong( $function, $message, $version ) {

	/**
	 * Fires when the given function is being used incorrectly.
	 *
	 * @since 3.1.0
	 *
	 * @param string $function The function that was called.
	 * @param string $message  A message explaining what has been done incorrectly.
	 * @param string $version  The version of WordPress where the message was added.
	 */
	do_action( 'doing_it_wrong_run', $function, $message, $version );

	/**
	 * Filters whether to trigger an error for _doing_it_wrong() calls.
	 *
	 * @since 3.1.0
	 * @since 5.1.0 Added the $function, $message and $version parameters.
	 *
	 * @param bool   $trigger  Whether to trigger the error for _doing_it_wrong() calls. Default true.
	 * @param string $function The function that was called.
	 * @param string $message  A message explaining what has been done incorrectly.
	 * @param string $version  The version of WordPress where the message was added.
	 */
	if ( WP_DEBUG && apply_filters( 'doing_it_wrong_trigger_error', true, $function, $message, $version ) ) {
		if ( function_exists( '__' ) ) {
			if ( is_null( $version ) ) {
				$version = '';
			} else {
				/* translators: %s: version number */
				$version = sprintf( __( '(This message was added in version %s.)' ), $version );
			}
			/* translators: %s: Codex URL */
			$message .= ' ' . sprintf(
				__( 'Please see <a href="%s">Debugging in WordPress</a> for more information.' ),
				__( 'https://codex.wordpress.org/Debugging_in_WordPress' )
			);
			/* translators: Developer debugging message. 1: PHP function name, 2: Explanatory message, 3: Version information message */
			trigger_error( sprintf( __( '%1$s was called <strong>incorrectly</strong>. %2$s %3$s' ), $function, $message, $version ) );
		} else {
			if ( is_null( $version ) ) {
				$version = '';
			} else {
				$version = sprintf( '(This message was added in version %s.)', $version );
			}
			$message .= sprintf(
				' Please see <a href="%s">Debugging in WordPress</a> for more information.',
				'https://codex.wordpress.org/Debugging_in_WordPress'
			);
			trigger_error( sprintf( '%1$s was called <strong>incorrectly</strong>. %2$s %3$s', $function, $message, $version ) );
		}
	}
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.1.0 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/ms-site.php: wp_check_site_meta_support_prefilter()

Aborts calls to site meta if it is not supported.
wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php: WP_REST_Search_Controller::__construct()

Constructor.
wp-includes/class-wp-block-type-registry.php: WP_Block_Type_Registry::register()

Registers a block type.
wp-includes/class-wp-block-type-registry.php: WP_Block_Type_Registry::unregister()

Unregisters a block type.
wp-admin/includes/plugin.php: wp_add_privacy_policy_content()

Helper function for adding content to the Privacy Policy Guide.
wp-includes/functions.php: wp_is_uuid()

Validates that a UUID is valid.
wp-includes/rest-api/endpoints/class-wp-rest-controller.php: WP_REST_Controller::register_routes()

Registers the routes for the objects of the controller.
wp-includes/functions.wp-scripts.php: wp_add_inline_script()

Adds extra code to a registered script.
wp-includes/customize/class-wp-customize-partial.php: WP_Customize_Partial::render()

Renders the template partial involving the associated settings.
wp-includes/rest-api.php: register_rest_route()

Registers a REST API route.
wp-includes/query.php: is_embed()

Is the query for an embedded post?
wp-includes/date.php: WP_Date_Query::validate_date_values()

Validates the given date_query values and triggers errors if something is not valid.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::remove_panel()

Remove a customize panel.
wp-admin/includes/template.php: convert_to_screen()

Convert a screen string to a screen object
wp-includes/capabilities.php: map_meta_cap()

Map meta capabilities to primitive capabilities.
wp-includes/theme.php: add_theme_support()

Registers theme support for a given feature.
wp-includes/pluggable.php: check_admin_referer()

Makes sure that a user was referred from another admin page.
wp-includes/pluggable.php: check_ajax_referer()

Verifies the Ajax request to prevent processing requests external of the blog.
wp-includes/query.php: is_preview()

Determines whether the query is for a post or page preview.
wp-includes/query.php: is_robots()

Is the query for the robots file?
wp-includes/query.php: is_search()

Determines whether the query is for a search.
wp-includes/query.php: is_single()

Determines whether the query is for an existing single post.
wp-includes/query.php: is_singular()

Determines whether the query is for an existing single post of any post type (post, attachment, page, custom post types).
wp-includes/query.php: is_time()

Determines whether the query is for a specific time.
wp-includes/query.php: is_trackback()

Determines whether the query is for a trackback endpoint call.
wp-includes/query.php: is_year()

Determines whether the query is for an existing year archive.
wp-includes/query.php: is_404()

Determines whether the query has resulted in a 404 (returns no results).
wp-includes/query.php: is_main_query()

Determines whether the query is the main query.
wp-includes/query.php: is_attachment()

Determines whether the query is for an existing attachment page.
wp-includes/query.php: is_author()

Determines whether the query is for an existing author archive page.
wp-includes/query.php: is_category()

Determines whether the query is for an existing category archive page.
wp-includes/query.php: is_tag()

Determines whether the query is for an existing tag archive page.
wp-includes/query.php: is_tax()

Determines whether the query is for an existing custom taxonomy archive page.
wp-includes/query.php: is_date()

Determines whether the query is for an existing date archive.
wp-includes/query.php: is_day()

Determines whether the query is for an existing day archive.
wp-includes/query.php: is_feed()

Determines whether the query is for a feed.
wp-includes/query.php: is_comment_feed()

Is the query for a comments feed?
wp-includes/query.php: is_front_page()

Determines whether the query is for the front page of the site.
wp-includes/query.php: is_home()

Determines whether the query is for the blog homepage.
wp-includes/query.php: is_month()

Determines whether the query is for an existing month archive.
wp-includes/query.php: is_page()

Determines whether the query is for an existing single page.
wp-includes/query.php: is_paged()

Determines whether the query is for paged results and not for the first page.
wp-includes/query.php: is_archive()

Determines whether the query is for an existing archive page.
wp-includes/query.php: is_post_type_archive()

Determines whether the query is for an existing post type archive page.
wp-includes/functions.wp-scripts.php: wp_deregister_script()

Remove a registered script.
wp-includes/taxonomy.php: register_taxonomy()

Creates or modifies a taxonomy object.
wp-includes/class-wp-admin-bar.php: WP_Admin_Bar::add_node()

Adds a node to the menu.
wp-includes/functions.wp-styles.php: wp_add_inline_style()

Add extra CSS styles to a registered stylesheet.
wp-includes/shortcodes.php: do_shortcode_tag()

Regular Expression callable for do_shortcode() for calling shortcode hook.
wp-includes/shortcodes.php: add_shortcode()

Adds a new shortcode.
wp-includes/plugin.php: register_uninstall_hook()

Set the uninstallation hook for a plugin.
wp-includes/post.php: wp_insert_post()

Insert or update a post.
wp-includes/post.php: register_post_type()

Registers a post type.
wp-includes/wp-db.php: wpdb::_real_escape()

Real escape, using mysqli_real_escape_string() or mysql_real_escape_string()
wp-includes/wp-db.php: wpdb::prepare()

Prepares a SQL query for safe execution. Uses sprintf()-like syntax.
wp-includes/widgets.php: the_widget()

Output an arbitrary widget as a template tag.
wp-includes/widgets.php: register_sidebar()

Builds the definition for a single sidebar and returns the ID.
Show 52 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.