add_action( string $tag, callable $function_to_add, int $priority = 10, int $accepted_args = 1 )

Attache une fonction ou une méthode à une action spécifique.

Paramètres

$tag(string)requis

Nom de l'action.

$function_to_add(callable)requis

Nom de la fonction à attacher à $tag.

$priority(int)optionnel

Utilisé pour spécifier l'ordre dans lequel les fonctions attachées à $tag doivent être exécutées.

Valeur par défaut : 10

$accepted_args(int)optionnel

Le nombre d'arguments que la fonction accepte.

Valeur par défaut : 1

Description / Informations supplémentaires

Les actions sont les hooks que WordPress lance à des points précis durant son exécution ou quand des évènements spécifiques se produisent.

Retourne

(bool) Retourne toujours true.

Déclaration et structure de la fonction add_action()

function add_action( $hook_name, $callback, $priority = 10, $accepted_args = 1 ) {
    return add_filter( $hook_name, $callback, $priority, $accepted_args );
}
add_filter()

Attache une fonction ou une méthode à un filtre spécifique.

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

Exemples

Usage basique :
function wpdocs_save_post( $post_ID, $post, $update ) {
   // code ici...
}
add_action( 'save_post', 'wpdocs_save_post', 10, 3 );
Utilisation au sein d'une classe :
class WP_Docs_Class {
 
    /* Constructor */
    
    public function __construct() {
        add_action( 'save_post', array( $this, 'wpdocs_save_posts' ) );
    }
 
    public function wpdocs_save_posts() {
        // code ici...
    }
}
 
return new WP_Docs_Class();

Sources

Codex WordPress : add_action()

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

Retour