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.

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

$function: (Required) The function that was called.
$message: (Required) A message explaining what has been done incorrectly.
$version: (Required) The version of ClassicPress or WordPress where the message was added.

Source

File: wp-includes/functions.php

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

	/**
	 * Fires when the given function is being used incorrectly.
	 *
	 * @since WP-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 ClassicPress or 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 WP-3.1.0
	 *
	 * @param bool $trigger Whether to trigger the error for _doing_it_wrong() calls. Default true.
	 */
	if ( WP_DEBUG && apply_filters( 'doing_it_wrong_trigger_error', true ) ) {
		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 ClassicPress</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 ClassicPress</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 Source Code View on GitHub

Uses

Uses
Uses	Description
wp-includes/l10n.php: __()	Retrieve the translation of $text.
wp-includes/plugin.php: do_action()	Execute functions hooked on a specific action hook.
wp-includes/plugin.php: apply_filters()	Call the functions added to a filter hook.
wp-includes/functions.php: doing_it_wrong_run	Fires when the given function is being used incorrectly.
wp-includes/functions.php: doing_it_wrong_trigger_error	Filters whether to trigger an error for _doing_it_wrong() calls.

Used By

Used By
Used By	Description
wp-includes/customize/class-wp-customize-partial.php: WP_Customize_Partial::render()	Renders the template partial involving the associated settings.
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-styles.php: wp_add_inline_style()	Add extra CSS styles to a registered stylesheet.
wp-includes/query.php: is_year()	Is the query for an existing year archive?
wp-includes/query.php: is_404()	Is the query a 404 (returns no results)?
wp-includes/query.php: is_embed()	Is the query for an embedded post?
wp-includes/query.php: is_main_query()	Is the query the main query?
wp-includes/query.php: is_search()	Is the query for a search?
wp-includes/query.php: is_single()	Is the query for an existing single post?
wp-includes/query.php: is_singular()	Is the query for an existing single post of any post type (post, attachment, page, custom post types)?
wp-includes/query.php: is_time()	Is the query for a specific time?
wp-includes/query.php: is_trackback()	Is the query for a trackback endpoint call?
wp-includes/query.php: is_month()	Is the query for an existing month archive?
wp-includes/query.php: is_page()	Is the query for an existing single page?
wp-includes/query.php: is_paged()	Is the query for paged result and not for the first page?
wp-includes/query.php: is_preview()	Is the query for a post or page preview?
wp-includes/query.php: is_robots()	Is the query for the robots file?
wp-includes/query.php: is_author()	Is the query for an existing author archive page?
wp-includes/query.php: is_category()	Is the query for an existing category archive page?
wp-includes/query.php: is_tag()	Is the query for an existing tag archive page?
wp-includes/query.php: is_tax()	Is the query for an existing custom taxonomy archive page?
wp-includes/query.php: is_date()	Is the query for an existing date archive?
wp-includes/query.php: is_day()	Is the query for an existing day archive?
wp-includes/query.php: is_feed()	Is the query for a feed?
wp-includes/query.php: is_comment_feed()	Is the query for a comments feed?
wp-includes/query.php: is_front_page()	Is the query for the front page of the site?
wp-includes/query.php: is_home()	Determines if the query is for the blog homepage.
wp-includes/query.php: is_archive()	Is the query for an existing archive page?
wp-includes/query.php: is_post_type_archive()	Is the query for an existing post type archive page?
wp-includes/query.php: is_attachment()	Is the query for an existing attachment page?
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/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-admin-bar.php: WP_Admin_Bar::add_node()	Adds a node to the menu.
wp-includes/capabilities.php: map_meta_cap()	Map meta capabilities to primitive capabilities.
wp-includes/functions.wp-scripts.php: wp_add_inline_script()	Adds extra code to a registered script.
wp-includes/functions.wp-scripts.php: wp_deregister_script()	Remove a registered script.
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/theme.php: add_theme_support()	Registers theme support for a given feature.
wp-includes/plugin.php: register_uninstall_hook()	Set the uninstallation hook for a plugin.
wp-includes/class-wp-customize-manager.php: WP_Customize_Manager::remove_panel()	Remove a customize panel.
wp-includes/rest-api.php: register_rest_route()	Registers a REST API route.
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/taxonomy.php: register_taxonomy()	Creates or modifies a taxonomy object.
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.
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/functions.php: wp_is_uuid()	Validates that a UUID is valid.
wp-admin/includes/template.php: convert_to_screen()	Convert a screen string to a screen object
wp-admin/includes/plugin.php: wp_add_privacy_policy_content()	Helper function for adding content to the Privacy Policy Guide.
wp-admin/includes/plugin.php: add_security_page()	Add submenu page to the Security main menu.

Show 49 more used by Hide more used by

Changelog

Changelog
Version	Description
WP-3.1.0	Introduced.