Fast Permissions Administration
Enhances Drupal's permissions administration page with fast filtering, role selection, and bulk permission management capabilities.
fpa
インストール
composer require 'drupal/fpa:^4.0'
composer require 'drupal/fpa:^3.0'
概要
Fast Permissions Administration（FPA）は、大幅に改善された権限インターフェースを提供することで、Drupalでの権限管理のフラストレーションを軽減するために設計されたモジュールです。このモジュールは、コアの権限管理フォームを完全に置き換え、強力なフィルタリング、検索、一括編集機能を備えた改良版を提供します。
このモジュールは、「permission@module」検索構文を使用して特定の権限をすばやく見つけることができる権限およびモジュールフィルターを追加します。サイドバーのモジュールリストにより、特定のモジュールの権限にすばやくナビゲートでき、ロールフィルタリングにより管理者は必要なロールのみを表示できます。さらに、このモジュールは、一括権限割り当てのためのカラムヘッダーと行ラベルの両方にトグルチェックボックスを提供し、権限の説明やシステム名の表示/非表示を切り替えるトグルボタンも提供します。
FPAには、すべての権限を表示するとPHPのメモリ制限を超える可能性がある場合に管理者に警告するインテリジェントなメモリ管理機能が含まれており、多くのロールと権限を持つサイト向けにFilter Permissionsモジュールをコンパニオンとして推奨します。
Features
- 「permission@module」検索構文を使用した権限フィルタリング - 権限名とモジュール名で同時にフィルタリング可能
- 特定のロールのみを表示するマルチセレクトドロップダウンによるロールフィルタリング
- クイックナビゲーション用のモジュールリストサイドバー - モジュールをクリックするとそのモジュールの権限のみにフィルタリング
- ロールのすべての表示中の権限を一度に切り替えるカラムヘッダーのチェックボックス
- 表示中のロール全体で特定の権限を切り替える行トグルチェックボックス
- 視覚的な煩雑さを減らすための説明の表示/非表示トグル
- 権限とモジュールのマシン名を表示するシステム名の表示/非表示トグル
- 未保存の変更を示すビジュアルインジケーター - 新しくチェックされた項目は緑色の光彩、新しくチェックが外された項目は赤色の光彩
- フォームを元の状態に戻す変更リセットボタン
- チェックボックスのタッチターゲットが大きいモバイルフレンドリーなインターフェース
- ページ読み込み間でフィルター状態を維持するCookieベースのフィルター永続化
- 権限ページがPHPメモリを超える可能性がある場合の警告付きメモリ制限チェック
- スクロール中も表示されたままになるスティッキーテーブルヘッダー
- 大規模サイトでのメモリ最適化のためのFilter Permissionsモジュールとの統合
Use Cases
Bulk assigning permissions to a new role
When creating a new role that needs many permissions, use FPA's column header checkbox to quickly toggle all permissions for that role. First filter to show only the new role using the Roles dropdown, then use the column checkbox to select all permissions at once, and uncheck any that shouldn't apply.
Finding all permissions for a specific module
Click on a module name in the left sidebar to instantly filter the permissions table to show only that module's permissions. This is useful when configuring a newly installed module or auditing permissions for a specific feature.
Auditing which roles have administrative permissions
Use the filter field to search for "admin" to find all permissions containing "admin" in their name. Then use the Roles filter to show specific roles and the "Display permissions that are" checkboxes to show only checked permissions, revealing which roles have administrative access.
Copying permissions between roles
Filter to show only the source role, note which permissions are checked, then filter to show the target role and use the row toggle checkboxes to quickly assign the same permissions.
Finding unassigned permissions
Select a specific role in the Roles filter, then check only "Not Checked" in the display filter. This shows all permissions that the selected role does NOT have, making it easy to audit for missing permissions.
Tips
- Use the "permission@module" syntax to narrow down results quickly - for example "access@node" finds node access permissions
- Click directly on a system name in the table to copy it via a prompt dialog
- The green glow indicates a checkbox was checked since page load, red glow indicates it was unchecked - both represent unsaved changes
- Use Ctrl+click in the Roles dropdown to select multiple specific roles
- The module counter in the sidebar shows how many permissions match your current filter out of the total for each module
Technical Details
Admin Pages 1
/admin/people/permissions
Enhanced permissions administration page that replaces Drupal core's default permissions form. Provides fast filtering, role selection, and bulk permission management capabilities. The page displays all available permissions organized by module with checkboxes for each role.
Hooks 3
hook_help
Provides help text for the permissions page explaining the filter syntax.
hook_form_FORM_ID_alter
Alters the user_admin_permissions form to add memory limit warning when Filter Permissions module is active.
hook_requirements
Checks PHP memory limit against estimated requirements for rendering the permissions page and displays status report warning if insufficient.
Troubleshooting 4
The permissions page requires significant memory when many roles and permissions exist. Install the Filter Permissions module to reduce the number of items rendered at once. Alternatively, increase PHP's memory_limit setting. FPA displays a warning on the status report page if memory may be insufficient.
FPA uses browser cookies to store filter state. Ensure cookies are enabled in your browser. The cookie names are 'fpa_filter', 'fpa_roles', and 'fpa_module_match'.
The column toggle checkboxes only affect visible rows. If permissions are filtered, only the filtered permissions will be toggled. To toggle all permissions for a role, first clear the filter by clicking 'Clear filter'.
Click the 'Show system names' toggle link at the top of the page. The system names column is hidden by default to reduce visual clutter.