> ## 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 l’extension WordPress Login by Auth0 à l’aide de hooks, de filtres et de fonctions.

# Étendre l’extension WordPress Login by Auth0

Les extensions WordPress peuvent être adaptées à vos besoins précis à l’aide d’actions et de filtres permettant d’exécuter du code personnalisé à des moments précis de l’exécution. Ce document présente les hooks existants dans l’extension Login by Auth0. Nous serons heureux d’examiner et d’approuver de nouveaux filtres et de nouvelles actions pour vous permettre d’intégrer encore davantage cette extension. Pour en savoir plus, consultez la section Contributing dans le [`README` du dépôt GitHub de l’extension](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 le [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 l’authentification réussie d’un utilisateur, mais avant sa connexion à 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 s’est connecté à WordPress. Elle peut servir à définir des valeurs méta particulières, à envoyer des notifications ou à appeler 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 valeurs 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 eux aussi du code personnalisé à des étapes précises du traitement, mais ils renvoient toujours une valeur modifiée du même type que celle qui leur a été 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 profil 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é après que le plugin a trouvé l’utilisateur correspondant pour la connexion (en fonction du `user_id` d’auth0) et permet de remplacer le comportement par défaut par des règles de correspondance personnalisées (par exemple, toujours faire la correspondance à partir de l’adresse courriel).

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

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

Ce filtre s’exécute dans `WP_Auth0_Email_Verification` pour modifier le code HTML généré lorsqu’un utilisateur qui tente de se connecter doit vérifier son adresse courriel avant d’accéder au site. Notez que ce code 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 en savoir plus).

<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 lors du processus de connexion automatique. Le paramètre défini dans wp-admin est récupéré, puis transmis à ce filtre.

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

Ce filtre est utilisé par les fonctions et les méthodes qui récupèrent des 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`, qui est encodé en JSON et renvoyé à Auth0 lors de la migration d’un utilisateur.

<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 quelque raison que ce soit, l’inscription sera refusée et l’utilisateur qui tente de s’inscrire 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 le widget de connexion lui-même. Il s’exécute avant que le CSS soit récupéré depuis la page des paramètres de wp-admin.

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

Filtre le gabarit utilisé pour le formulaire de connexion Auth0. Cette fonction doit renvoyer le chemin d’accès vers 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 un 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 renvoyer un tableau `$options` modifié contenant vos changements ou ajouts. Les nouveaux champs doivent avoir une fonction de rappel de 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 la portée demandée au moment de la connexion. Il peut servir à ajouter des [revendications personnalisées](/fr-CA/docs/secure/tokens/json-web-tokens/create-custom-claims) ou à demander un <Tooltip tip="Jeton d’actualisation : jeton utilisé pour obtenir un nouveau jeton d’accès sans obliger les utilisateurs à se reconnecter." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Refresh+Token">jeton d’actualisation</Tooltip>.

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

Utilisez ce filtre pour modifier le nom du témoin utilisé pour valider le <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="/fr-CA/docs/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 témoin utilisé pour la valeur du paramètre state. Vous pouvez ajouter un préfixe ou un suffixe, ou remplacer entièrement la chaîne. Pour en savoir plus sur le paramètre state, consultez [Prevent Attacks and Redirect Users with OAuth 2.0 State Parameters](/fr-CA/docs/secure/attack-protection/state-parameters).
Assurez-vous d’utiliser des caractères valides dans toutes 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 in 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 utilisée pour surcharger les réglages du plugin. Veuillez noter que ce filtre **doit** être exécuté avant le chargement du plugin Auth0; il doit donc être placé dans une extension MU. Pour en savoir plus sur les extensions MU, consultez [Must Use Plugins sur 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 associatif 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 complète `/authorize` 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 transmis à `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 du CDN par défaut d’Auth0.js lors du chargement de la page de repli COO.

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

Ce filtre vous permet de remplacer l’URL `returnTo` par défaut au moment 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](/fr-CA/docs/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="API de gestion : un produit permettant aux clients d’effectuer des tâches administratives." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=Management+API">API de gestion</Tooltip> doivent être utilisées lorsque vous n’utilisez pas le flux de connexion implicite. Renvoyez la valeur booléenne `true` (par défaut) pour utiliser l’API, ou `false` pour utiliser le <Tooltip tip="Jeton d’identification : justificatif destiné au client lui-même, plutôt qu’à l’accès à une ressource." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=ID+token">jeton d’identification</Tooltip>.

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

Ce filtre permet de modifier les options du formulaire de connexion Lock intégré utilisé dans les shortcodes, les widgets et sur la page wp-login.php lorsque **Fonctionnalités > page <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="/fr-CA/docs/glossary?term=Universal+Login">Universal Login</Tooltip>** est désactivée.

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

Ce filtre vous permet d’ajuster la marge de temps 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 d’état avant qu’elles ne 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 pour être utilisées.

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

* [Intégrer WordPress](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Installer Login by Auth0](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/install-login-by-auth0)
* [Configurer Login by Auth0](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [Résoudre les erreurs d’état non valide de l’extension WordPress](/fr-CA/docs/customize/integrations/cms/wordpress-plugin/troubleshoot-wordpress-plugin-invalid-state-errors)