wp_dropdown_roles()

WordPressの関数wp_dropdown_roles()は、ユーザー役割を選択するためのドロップダウンリストを生成します。この関数は、管理者がユーザー役割を選択するためのフォームを作成する際に役立ちます。

シンタックス

wp_dropdown_roles( string $selected = '' );

• $selected (string) — 予め選択された役割を指定します。

例1: デフォルトの役割のドロップダウン

デフォルトの役割リストを生成し、予め選択された役割を設定しません。

<?php wp_dropdown_roles(); ?>

例2: 特定の役割を選択した状態でドロップダウンを表示

予め「administrator」を選択した状態で役割のドロップダウンを生成します。

<?php wp_dropdown_roles('administrator'); ?>
[/code>

<h3>例3: カスタムフォーム内での使用</h3>

フォーム内で役割選択のドロップダウンを表示し、送信後に選択された役割を処理する例です。

[code language="php"]
<form method="post">
    <label for="user_role">役割を選択:</label>
    <?php wp_dropdown_roles('editor'); ?>
    <input type="submit" value="送信">
</form>

例4: ドロップダウンをカスタマイズする

追加の引数を使用してドロップダウンをカスタマイズする例です。

<?php wp_dropdown_roles('subscriber'); ?>

例5: 選択肢にデフォルトの役割を追加

「選択してください」というオプションを最初に追加する例です。

<select name="role">
    <option value=""><?php _e('選択してください'); ?></option>
    <?php wp_dropdown_roles(); ?>
</select>

注意事項

• 関数は管理画面でのみ有効で、フロントエンドでは適切に動作しない場合があります。
• 引数を指定することで、事前に選択された役割を設定できます。