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

# Auth0 Wordpressプラグインのログイン時間を延長する

> フック、フィルター、関数を使用して、Login by Auth0 WordPressプラグインを拡張する方法を学びます。

WordPressプラグインは、アクションとフィルターを使用して実行時の特定の時点でカスタムコードを実行することで、特定の要件に合わせて拡張できます。このドキュメントでは、Login by Auth0プラグインの既存のフックについて説明します。このプラグインをさらに統合する上で役立つ、新しいフィルターとアクションをレビューして承認します。詳細については、[プラグインのGitHubリポジトリのReadMe](https://github.com/auth0/wp-auth0/blob/master/README.md)でContributing（貢献）セクションをお読みください。

## WordPressアクション

WordPressアクションは、処理中の特定の時点でカスタムコードを実行します。WordPressアクションの詳細については、[WordPressプラグインハンドブック: wordpress.orgのアクション](https://developer.wordpress.org/plugins/hooks/actions/)をお読みください。[GitHubリポジトリの例](https://github.com/auth0/wp-auth0/tree/master/examples)

### auth0\_before\_login

このアクションは、ユーザーが正常に認証された後、WordPressにログインする前に`WP_Auth0_LoginManager`で実行されます。必要に応じて、`wp_die()`を使用するか例外をスローして、ログインプロセスを停止するために使用できます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_before_login.php)

### auth0\_user\_login

このアクションは、ユーザーが正常に認証され、WordPressにログインした後に`WP_Auth0_LoginManager`で実行されます。特定のメタ値を設定したり、通知を送信したり、他のサービスにpingを送信したりするために使用できます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_user_login.php)

### wpa0\_user\_created

このアクションは、WordPressユーザーが正常に作成された直後に`WP_Auth0_Users`で実行されます。ユーザーの値を変更したり、追加のユーザーメタを設定したり、他の新しいユーザーアクションをトリガーしたりするために使用できます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/wpa0_user_created.php)

## フィルター

WordPress のフィルターも、処理中に特定の時点でカスタムコードを実行しますが、常に渡されたのと同じタイプの変更された値を返します。フィルターの詳細については、[WordPressプラグインハンドブック: wordpress.orgのフィルター](https://developer.wordpress.org/plugins/hooks/filters/)をお読みください。[GitHubリポジトリの例](https://github.com/auth0/wp-auth0/tree/master/examples)

### auth0\_create\_user\_data

このフィルターは、受信したAuth0ユーザーからWordPressに新しいユーザーを作成する際、ユーザーデータ配列を変更するために使用できます。2つのパラメーターを受け取ります。

* `$user_data`は、Auth0プロファイルから解析されたユーザーデータです。
* `$userinfo`は、Auth0ユーザープロファイルです。

このフィルターは常に、コアの`wp_insert_user()`関数に渡されるデータの配列を返します。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_create_user_data.php)

### auth0\_get\_wp\_user

このフィルターは、プラグインがログインする関連ユーザーを見つけた後に呼び出されます（auth0 `user_id`に基づく）。このフィルターは、カスタム一致ルール（常にメールで一致させるなど）でデフォルトの動作を上書きするために使用されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_get_wp_user.php)

フィルターがnullを返す場合は、メールで検索します。詳細については、[WordPressとの統合](/docs/ja-jp/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)をお読みください。

### auth0\_verify\_email\_page

このフィルターは`WP_Auth0_Email_Verification`で実行され、ログインしているユーザーがサイトにアクセスする前にメールを確認する必要がある場合にレンダリングされるHTMLを変更します。このHTMLは`wp_die()`に渡され、表示される前に変更されることに注意してください（詳細については、コアの`_default_wp_die_handler()`定義を参照してください）。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_verify_email_page.php)

### auth0\_get\_auto\_login\_connection

このフィルターは`WP_Auth0_LoginManager`で使用され、自動ログインプロセスに使用される接続を変更します。wp-adminの設定が取得され、このフィルターに渡されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_get_auto_login_connection.php)

### wp\_auth0\_get\_option

このフィルターは、オプション取得関数とメソッドによって出力値を変更するために使用されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/wp_auth0_get_option.php)

### auth0\_migration\_ws\_authenticated

このフィルターは、`WP_Auth0_Routes`で使用され、ユーザー移行中にJSONエンコードされてAuth0に返されるWP\_Userオブジェクトを変更します。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_migration_ws_authenticated.php)

### wpa0\_should\_create\_user

このフィルターは、ユーザーを作成するかどうかを決定するときに`WP_Auth0_Users`で使用されます。渡される初期値は`TRUE`です。何らかの理由で`FALSE`が返された場合、登録は拒否され、登録ユーザーにはエラーメッセージ（`WP_Auth0_UsersRepo::create()`）が表示されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/wpa0_should_create_user.php)

### auth0\_login\_css

このフィルターは、ログインウィジェット自体を含むログインページのCSSを変更するために使用されます。このフィルターは、wp-admin設定ページからCSSが取得される前に実行されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_login_css.php)

### auth0\_login\_form\_tpl

Auth0ログインフォームに使用されるテンプレートをフィルターします。これは、`wp-content/plugins/auth0/templates/auth0-login-form.php`にあるものを置き換えるHTMLを含むファイルへのパスを返します。標準のロック開始JSは、ログインフォームをインスタンス化するために`auth0-login-form`のID属性を検索するため、これが存在することを確認するか、`wp-content/plugins/auth0/assets/js/lock-init.js`ファイルを独自のものに置き換えます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_login_form_tpl.php)ことができます。

### auth0\_settings\_fields

このフィルターは、既存のフォームフィールドを変更したり、新しいフィールドを追加したりするために使用されます。これにより、変更または追加が反映された変更された`$options`配列が返されます。以下に示すように、新しいフィールドにはフィールドコールバックが必要です。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_settings_fields.php)ことができます。

### auth0\_auth\_scope

このフィルターを使用すると、開発者はログイン時に要求されたスコープを追加または変更できます。これを使用して、[カスタムクレーム](/docs/ja-jp/secure/tokens/json-web-tokens/create-custom-claims)を追加したり、更新トークンを要求したりできます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_auth_scope.php)ことができます。

### auth0\_nonce\_cookie\_name

このフィルターを使用して、<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=nonce" tip="Nonce: リプレイ攻撃を検出および防止するために、認証プロトコルで1回だけ発行される任意の数値。" cta="用語集の表示">nonce</Tooltip>検証に使用されるCookie名を変更します。例については、以下の`auth0_state_cookie_name`フィルターを参照してください。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_nonce_cookie_name.php)ことができます。

### auth0\_state\_cookie\_name

このフィルターを使用して、状態パラメーター値に使用されるCookie名を変更します。これにより、プレフィックスまたはサフィックスを追加したり、文字列全体を置き換えたりできます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_state_cookie_name.php)状態パラメーターの詳細については、[OAuth 2.0状態パラメーターを使って攻撃を防ぎ、ユーザーをリダイレクトする](/docs/ja-jp/secure/attack-protection/state-parameters)をお読みください。変更を加える場合は、必ず有効な文字を使用してください。

`<cookie-name>には、制御文字（CTL）、スペース、タブを除く任意のUS-ASCII文字を使用できます。また、次のような区切り文字を含めることはできません。( ) < > @ , ; :\ " / ?= { }.`

`Set-Cookie` HTTP応答ヘッダーの詳細については、[MDN Web DocsのSet-Cookie](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie)を参照してください。

### auth0\_settings\_constant\_prefix

このフィルターを使用して、プラグイン設定をオーバーライドするために使用される定数のプレフィックスを変更します。このフィルターは、Auth0プラグインが読み込まれる前に実行する **必要がある** ため、MUプラグインに配置する必要があることに注意してください。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_settings_constant_prefix.php)ことができます。MUプラグインの詳細については、[wordpress.orgのMust Use Plugins](https://wordpress.org/support/article/must-use-plugins/)をお読みください。

### auth0\_authorize\_url\_params

このフィルターを使用すると、開発者は必要に応じて`/authorize`エンドポイントパラメーターを調整できます。この関数は、URLパラメーターの辞書型配列を返す必要があります。これらのパラメーターの使用方法の詳細については、[認証APIエクスプローラー: ログイン](/docs/ja-jp/api/authentication#login)を参照してください。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_authorize_url_params.php)ことができます。

### auth0\_authorize\_url

このフィルターを使用すると、開発者は使用前に完全な`/authorize` URLを調整できます。この関数は、有効なURL文字列を返す必要があります。このURLの使用方法の詳細については、[認証APIエクスプローラー: ログイン](/docs/ja-jp/api/authentication#login)を参照してください。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_authorize_url.php)ことができます。

### auth0\_die\_on\_login\_output

このフィルターを使用すると、ログイン中にエラーが発生した場合に、`wp_die()`に渡されるHTMLコンテンツを変更または置換できます。このフィルターは、メールの内容の検証には影響しません（auth0\_verify\_email\_pageを参照）。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_die_on_login_output.php)ことができます。

### auth0\_coo\_auth0js\_url

このフィルターを使用すると、COOURLフォールバックページを読み込むときに、Auth0.jsのデフォルトCDNをオーバーライドできます。

### auth0\_slo\_return\_to

このフィルターを使用すると、Auth0からログアウトするときにデフォルトの`returnTo` URLをオーバーライドできます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_slo_return_to.php)ことができます。

### auth0\_logout\_url

このフィルターを使用すると、 Auth0ログアウトURLをオーバーライドできます。この使用方法の詳細については、[ログアウト](/docs/ja-jp/authenticate/login/logout)を参照してください。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_logout_url.php)ことができます。

### auth0\_use\_management\_api\_for\_userinfo

このフィルターは、暗黙的ログインフローを使用していない場合に、<Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=management-api" tip="Management API: 顧客が管理タスクを実行できるようにするための製品。" cta="用語集の表示">Management API</Tooltip>から取得したユーザープロファイルデータを取得するかどうかを決定します。APIを使用する場合はブール値`true`（デフォルト）を返し、IDトークンを使用する場合は`false`を返します。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_use_management_api_for_userinfo.php)ことができます。

### auth0\_lock\_options

このフィルターを使用すると、 **Features（機能） > <Tooltip data-tooltip-id="react-containers-DefinitionTooltip-0" href="/docs/ja-jp/glossary?term=universal-login" tip="ユニバーサルログイン: アプリケーションは、Auth0の認可サーバーでホストされているユニバーサルログインにリダイレクトして、ユーザーのアイデンティティを確認します。" cta="用語集の表示">Universal Login</Tooltip> Page（ユニバーサルログインページ）** がオフになっている場合に、ショートコード、ウィジェット、および wp-login.php ページで使用される埋め込みロック ログイン フォームのオプションを変更できます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_lock_options.php)ことができます。

### auth0\_jwt\_leeway

このフィルターを使用すると、IDトークンの検証に使用される余裕時間を調整でき、秒数を整数として返す必要があります。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_jwt_leeway.php)ことができます。

### auth0\_jwt\_max\_age

このフィルターを使用すると、authorizeURLで送信される`max_age` URLパラメーターを調整できます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_jwt_max_age.php)ことができます。

### auth0\_authorize\_state

このフィルターを使用すると、エンコードされてログインに使用される前に状態データをフィルターできます。このデータは、ログインが成功した後に検証され、そのまま提供されます。[GitHubリポジトリで例を見る](https://github.com/auth0/wp-auth0/blob/master/examples/auth0_authorize_state.php)ことができます。

## ユースケース

[GitHubリポジトリで、フィルターを使用したアクションの使用例を見ることができます](https://gist.github.com/evansims/c7116f83040af3e899213422489debc2)

## もっと詳しく

* [WordPressとの統合](/docs/ja-jp/customize/integrations/cms/wordpress-plugin/integrate-with-wordpress)
* [Login by Auth0をインストールする](/docs/ja-jp/customize/integrations/cms/wordpress-plugin/install-login-by-auth0)
* [Login by Auth0を構成する](/docs/ja-jp/customize/integrations/cms/wordpress-plugin/configure-login-by-auth0)
* [WordPressプラグインの無効な状態エラーのトラブルシューティング](/docs/ja-jp/customize/integrations/cms/wordpress-plugin/troubleshoot-wordpress-plugin-invalid-state-errors)
