> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Découvrez comment étendre Login by Auth0 WordPress Plugin à l’aide de hooks, de filtres et de fonctions.

# Étendre Login by Auth0 WordPress Plugin

Les plugins WordPress peuvent être étendus pour répondre à vos besoins précis à l’aide d’actions et de filtres, afin d’exécuter du code personnalisé à des points précis durant l’exécution. Ce document présente les hooks existants dans le plugin Login by Auth0. Nous serons ravis d’examiner et d’approuver de nouveaux filtres et de nouvelles actions qui vous permettront d’intégrer encore davantage ce plugin. Pour en savoir plus, consultez la section Contributing dans le [`README` du dépôt GitHub du plugin](https://github.com/auth0/wordpress?tab=readme-ov-file#contributing).

<div id="wordpress-actions">
  ## Actions de WordPress
</div>

Les actions de WordPress exécutent du code personnalisé à des étapes précises du traitement. Pour en savoir plus sur les actions de WordPress, consultez [WordPress Plugin Handbook: Actions sur wordpress.org](https://developer.wordpress.org/plugins/hooks/actions/).

<div id="auth0_before_login">
  ### auth0\_before\_login
</div>

Cette action s’exécute dans `WP_Auth0_LoginManager` après qu’un utilisateur a été authentifié avec succès, mais avant qu’il ne soit connecté à WordPress. Elle peut servir à interrompre le processus de connexion au besoin à l’aide de `wp_die()` ou en lançant une exception.

<div id="auth0_user_login">
  ### auth0\_user\_login
</div>

Cette action s’exécute dans `WP_Auth0_LoginManager` après qu’un utilisateur a été authentifié avec succès et connecté à WordPress. Elle peut servir à définir des métadonnées précises, à envoyer des notifications ou à envoyer une requête ping à d’autres services.

<div id="wpa0_user_created">
  ### wpa0\_user\_created
</div>

Cette action s’exécute dans `WP_Auth0_Users` juste après la création réussie d’un utilisateur WordPress. Elle peut servir à modifier les données de l’utilisateur, à définir des métadonnées utilisateur supplémentaires ou à déclencher d’autres actions liées aux nouveaux utilisateurs.

<div id="filters">
  ## Filtres
</div>

Dans WordPress, les filtres exécutent également du code personnalisé à des étapes précises du processus, mais ils renvoient toujours une valeur modifiée du même type que celle transmise. Pour en savoir plus sur les filtres, consultez [WordPress Plugin Handbook: Filters on wordpress.org](https://developer.wordpress.org/plugins/hooks/filters/).

<div id="auth0_create_user_data">
  ### auth0\_create\_user\_data
</div>

Ce filtre peut être utilisé pour modifier le tableau de données utilisateur lors de la création d’un nouvel utilisateur dans WordPress à partir d’un utilisateur Auth0 reçu. Il reçoit 2 paramètres :

* `$user_data` correspond aux données utilisateur extraites du profil Auth0.
* `$userinfo` correspond au profil utilisateur Auth0.

Ce filtre doit toujours retourner un tableau de données qui sera transmis à la fonction de base `wp_insert_user()`.

<div id="auth0_get_wp_user">
  ### auth0\_get\_wp\_user
</div>

Ce filtre est appelé une fois que l’extension a trouvé l’utilisateur correspondant pour la connexion (à partir du `user_id` Auth0) et sert à remplacer le comportement par défaut par des règles de correspondance personnalisées (par exemple, toujours faire la correspondance par courriel).

Si le filtre renvoie null, la recherche se fera par courriel. Pour en savoir plus, consultez [Intégrer à WordPress](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress).

<div id="auth0_verify_email_page">
  ### auth0\_verify\_email\_page
</div>

Ce filtre est exécuté dans `WP_Auth0_Email_Verification` pour modifier le HTML affiché lorsqu’un utilisateur qui se connecte doit vérifier son courriel avant d’avoir accès au site. Notez que ce HTML est transmis à `wp_die()`, où il est modifié avant d’être affiché (consultez la définition de `_default_wp_die_handler()` dans le noyau pour plus d’informations).

<div id="auth0_get_auto_login_connection">
  ### auth0\_get\_auto\_login\_connection
</div>

Ce filtre est utilisé dans `WP_Auth0_LoginManager` pour modifier la connexion utilisée pour le processus de connexion automatique. Le réglage défini dans wp-admin est récupéré, puis soumis à ce filtre.

<div id="wp_auth0_get_option">
  ### wp\_auth0\_get\_option
</div>

Ce filtre est utilisé par les fonctions et les méthodes de récupération d’options pour modifier la valeur renvoyée.

<div id="auth0_migration_ws_authenticated">
  ### auth0\_migration\_ws\_authenticated
</div>

Ce filtre est utilisé dans `WP_Auth0_Routes` pour modifier l’objet WP\_User encodé en JSON et renvoyé à Auth0 dans le cadre d’une migration d’utilisateurs.

<div id="wpa0_should_create_user">
  ### wpa0\_should\_create\_user
</div>

Ce filtre est utilisé dans `WP_Auth0_Users` pour déterminer si un utilisateur doit être créé. La valeur initiale transmise est `TRUE`. Si `FALSE` est renvoyé pour une raison quelconque, l’inscription sera rejetée et l’utilisateur en cours d’inscription verra un message d’erreur (`WP_Auth0_UsersRepo::create()`).

<div id="auth0_login_css">
  ### auth0\_login\_css
</div>

Ce filtre sert à modifier le CSS de la page de connexion, y compris celui du widget de connexion lui-même. Ce filtre s’exécute avant que le CSS ne soit récupéré depuis la page Settings de wp-admin.

<div id="auth0_login_form_tpl">
  ### auth0\_login\_form\_tpl
</div>

Filtre le modèle utilisé pour le formulaire de connexion Auth0. Cette fonction doit renvoyer le chemin d’accès à un fichier contenant du HTML qui remplace le contenu de `wp-content/plugins/auth0/templates/auth0-login-form.php`. Le script JS standard d’initialisation de Lock recherche l’attribut ID `auth0-login-form` pour instancier le formulaire de connexion; assurez-vous donc qu’il est présent, ou remplacez le fichier `wp-content/plugins/auth0/assets/js/lock-init.js` par le vôtre.

<div id="auth0_settings_fields">
  ### auth0\_settings\_fields
</div>

Ce filtre sert à modifier un champ de formulaire existant ou à en ajouter un nouveau. Il doit retourner un tableau `$options` modifié contenant vos changements ou vos ajouts. Les nouveaux champs doivent avoir une fonction de rappel pour le champ, comme indiqué ci-dessous.

<div id="auth0_auth_scope">
  ### auth0\_auth\_scope
</div>

Ce filtre permet aux développeurs d’ajouter ou de modifier le scope demandé lors de la connexion. Il peut servir à ajouter des [custom claims](/docs/fr-ca/secure/tokens/json-web-tokens/create-custom-claims) ou à demander un <Tooltip tip="Refresh Token : jeton utilisé pour obtenir un nouvel Access Token sans obliger les utilisateurs à se connecter de nouveau." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Refresh+Token">Refresh Token</Tooltip>.

<div id="auth0_nonce_cookie_name">
  ### auth0\_nonce\_cookie\_name
</div>

Utilisez ce filtre pour modifier le nom du cookie servant à la validation du <Tooltip tip="Nonce : Nombre arbitraire émis une seule fois dans un protocole d’authentification afin de détecter et de prévenir les attaques par rejeu." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=nonce">nonce</Tooltip>. Consultez le filtre `auth0_state_cookie_name` ci-dessous pour obtenir un exemple.

<div id="auth0_state_cookie_name">
  ### auth0\_state\_cookie\_name
</div>

Utilisez ce filtre pour modifier le nom du cookie utilisé pour la valeur du paramètre state. Vous pouvez ainsi ajouter un préfixe ou un suffixe, ou remplacer complètement la chaîne. Pour en savoir plus sur le paramètre state, consultez [Prévenir les attaques et rediriger les utilisateurs avec les paramètres state d’OAuth 2.0](/docs/fr-ca/secure/attack-protection/state-parameters).
Assurez-vous d’utiliser uniquement des caractères valides dans les modifications apportées :

`A <cookie-name> can be any US-ASCII characters except control characters (CTLs), spaces, or tabs. It also must not contain a separator character like the following: ( ) < > @ , ; : \ " / ? = { }.`

Pour en savoir plus sur l’en-tête de réponse HTTP `Set-Cookie`, consultez [Set-Cookie dans MDN Web Docs](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Set-Cookie).

<div id="auth0_settings_constant_prefix">
  ### auth0\_settings\_constant\_prefix
</div>

Utilisez ce filtre pour modifier le préfixe de la constante servant à redéfinir les réglages de l’extension. Veuillez noter que ce filtre **doit** être exécuté avant le chargement de l’extension Auth0 ; il doit donc être placé dans une extension MU. Pour en savoir plus sur les extensions MU, consultez [Must Use Plugins on wordpress.org](https://developer.wordpress.org/advanced-administration/plugins/mu-plugins/).

<div id="auth0_authorize_url_params">
  ### auth0\_authorize\_url\_params
</div>

Ce filtre permet aux développeurs d’ajuster, au besoin, les paramètres du point de terminaison `/authorize`. La fonction doit retourner un tableau de type dictionnaire de paramètres d’URL. Pour en savoir plus sur l’utilisation de ces paramètres, consultez [Authentication API Explorer: Login](https://auth0.com/docs/api/authentication#login).

<div id="auth0_authorize_url">
  ### auth0\_authorize\_url
</div>

Ce filtre permet aux développeurs de modifier l’URL `/authorize` au complet avant son utilisation. La fonction doit renvoyer une URL valide sous forme de chaîne de caractères. Pour en savoir plus sur l’utilisation de cette URL, consultez [Authentication API Explorer : Login](https://auth0.com/docs/api/authentication#login).

<div id="auth0_die_on_login_output">
  ### auth0\_die\_on\_login\_output
</div>

Ce filtre vous permet de modifier ou de remplacer le contenu HTML envoyé à `wp_die()` lorsqu’une erreur survient lors de la connexion. Ce filtre n’a aucune incidence sur le contenu de la vérification du courriel (voir auth0\_verify\_email\_page).

<div id="auth0_coo_auth0js_url">
  ### auth0\_coo\_auth0js\_url
</div>

Ce filtre vous permet de remplacer l’URL CDN par défaut d’Auth0.js lors du chargement de la page de solution de secours du COO.

<div id="auth0_slo_return_to">
  ### auth0\_slo\_return\_to
</div>

Ce filtre vous permet de remplacer l’URL `returnTo` par défaut lors de la déconnexion d’Auth0.

<div id="auth0_logout_url">
  ### auth0\_logout\_url
</div>

Ce filtre vous permet de remplacer l’URL de déconnexion d’Auth0. Pour en savoir plus sur son utilisation, consultez [Logout](/docs/fr-ca/authenticate/login/logout).

<div id="auth0_use_management_api_for_userinfo">
  ### auth0\_use\_management\_api\_for\_userinfo
</div>

Ce filtre détermine si les données du profil utilisateur récupérées à partir de l’<Tooltip tip="Management API : un produit qui permet aux clients d’effectuer des tâches administratives." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Management+API">Management API</Tooltip> doivent être utilisées lorsque vous n’utilisez pas le flux de connexion implicite. Retournez la valeur booléenne `true` (par défaut) pour utiliser l’API, ou `false` pour utiliser le <Tooltip tip="ID token : informations d'identité à propos de l'utilisateur authentifié et détails sur l'événement d'authentification." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=ID+token">jeton d’identité</Tooltip>.

<div id="auth0_lock_options">
  ### auth0\_lock\_options
</div>

Ce filtre peut être utilisé pour modifier les options du formulaire de connexion Lock intégré utilisé dans les shortcodes, les widgets et sur la page wp-login.php lorsque l’option **Fonctionnalités > <Tooltip tip="Universal Login : votre application redirige vers Universal Login, hébergé sur le serveur d’autorisation d’Auth0, pour vérifier l’identité d’un utilisateur." cta="Voir le glossaire" href="/docs/fr-ca/glossary?term=Universal+Login">Universal Login</Tooltip> Page** est désactivée.

<div id="auth0_jwt_leeway">
  ### auth0\_jwt\_leeway
</div>

Ce filtre vous permet d’ajuster la marge de tolérance utilisée pour valider les jetons d’identité et doit renvoyer un nombre entier de secondes.

<div id="auth0_jwt_max_age">
  ### auth0\_jwt\_max\_age
</div>

Ce filtre vous permet d’ajuster le paramètre d’URL `max_age` envoyé dans l’URL d’autorisation.

<div id="auth0_authorize_state">
  ### auth0\_authorize\_state
</div>

Ce filtre vous permet de filtrer les données state avant qu’elles soient encodées et utilisées pour la connexion. Ces données seront vérifiées après une connexion réussie et fournies telles quelles afin que vous puissiez les utiliser.

<div id="learn-more">
  ## En savoir plus
</div>

* [Intégrer avec WordPress](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Installer Login by Auth0](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/install-login-by-auth0)
* [Configurer Login by Auth0](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Résoudre les erreurs « invalid state » du plugin WordPress](/docs/fr-ca/customize/integrations/cms/wordpress-plugin/troubleshoot-wordpress-plugin-invalid-state-errors)