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

Marque quelque chose comme étant incorrectement appelée.

Paramètres

$function(string)requis

La fonction qui a été appelé.

$message(string)requis

Un message expliquant ce qui a été fait incorrectement.

$version(string)requis

La version de WordPress où le message a été ajouté.

Description / Informations supplémentaires

Le hook doing_it_wrong_run qui sera appelé peut être utilisé pour garder la trace d'un fichier ou d'une fonction dépréciée.

Le comportement actuel est de cibler une erreur utilisateur si la constante WP_DEBUG est à true.

Retourne

(void) Cette fonction ne retourne rien.

Déclaration et structure de la fonction _doing_it_wrong()

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

    /**
     * Fires when the given function is being used incorrectly.
     *
     * @since 3.1.0
     *
     * @param string $function_name 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_name, $message, $version );

    /**
     * Filters whether to trigger an error for _doing_it_wrong() calls.
     *
     * @since 3.1.0
     * @since 5.1.0 Added the $function_name, $message and $version parameters.
     *
     * @param bool   $trigger       Whether to trigger the error for _doing_it_wrong() calls. Default true.
     * @param string $function_name 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_name, $message, $version ) ) {
        if ( function_exists( '__' ) ) {
            if ( $version ) {
                /* translators: %s: Version number. */
                $version = sprintf( __( '(This message was added in version %s.)' ), $version );
            }

            $message .= ' ' . sprintf(
                /* translators: %s: Documentation URL. */
                __( 'Please see <a href="%s">Debugging in WordPress</a> for more information.' ),
                __( 'https://developer.wordpress.org/advanced-administration/debug/debug-wordpress/' )
            );

            $message = sprintf(
                /* translators: Developer debugging message. 1: PHP function name, 2: Explanatory message, 3: WordPress version number. */
                __( 'Function %1$s was called <strong>incorrectly</strong>. %2$s %3$s' ),
                $function_name,
                $message,
                $version
            );
        } else {
            if ( $version ) {
                $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://developer.wordpress.org/advanced-administration/debug/debug-wordpress/'
            );

            $message = sprintf(
                'Function %1$s was called <strong>incorrectly</strong>. %2$s %3$s',
                $function_name,
                $message,
                $version
            );
        }

        wp_trigger_error( '', $message );
    }
}
__()

Retourne la traduction d'un texte.

do_action()

Exécute des fonctions attachées à un hook spécifique.

apply_filters()

Appel les fonctions qui ont été attaché à un filtre (hook).

doing_it_wrong_run

Se lance quand la fonction donnée est utilisée incorrectement.

doing_it_wrong_trigger_error

Se lance quand une erreur est ciblée.

Où est utilisée la fonction _doing_it_wrong() dans le CMS WordPress

Sources

Codex WordPress : _doing_it_wrong()

Autres fonctions dans le même fichier : wp-includes/functions.php

Retour