Masquerade Toolbar

Introduction

Masquerade Toolbar provides a modern, floating toolbar interface for quick user switching via the Masquerade module. Perfect for developers, site administrators, clients and support teams who frequently need to test permissions or troubleshoot user-specific issues.

Features

• Floating Toolbar Widget - Unobtrusive, collapsible toolbar accessible from any page
• Autocomplete User Search - Quickly find users by name or email address
• Recent Users List - One-click access to recently masqueraded users
• Configurable Positioning - Choose from four corner positions (bottom-right, bottom-left, top-right, top-left)
• User Information Display - Shows current user and original user details when masquerading
• One-Click Switch Back - Instantly return to your original account
• Keyboard Shortcuts - Optional keyboard navigation support
• Mobile Responsive - Works on all devices with optional mobile hiding
• Role Display - See user roles in autocomplete results and user lists
• Performance Optimized - Service-based architecture with proper caching

Use Cases:

• Testing user permissions and role-based access control
• Troubleshooting user-specific issues without requesting login credentials
• Content moderation and user support
• Development and QA testing across different user roles
• Training and demonstrations using different user accounts

Post-Installation

1. Enable the Module
   • Install and enable the module as you would any other Drupal module
   • Ensure the Masquerade module is also enabled (required dependency)
2. Configure Permissions
   • Navigate to admin/people/permissions
   • Grant "Use Masquerade Toolbar" permission to appropriate roles
   • Users must also have Masquerade permissions ("masquerade as any user" or "masquerade as super user")
3. Configure Settings
   • Go to admin/config/people/masquerade-toolbar
   • Choose toolbar position (default: bottom-right)
   • Enable/disable collapsed by default
   • Configure recent users list (show/hide, max number)
   • Toggle role display and keyboard shortcuts
   • Set mobile behavior
4. Start Using the Toolbar
   • The floating toolbar will appear on all pages for users with permission
   • Click the toolbar icon to expand/collapse
   • Use the search field to find users
   • Click on any user to switch accounts
   • Click "Switch Back" to return to your original account

Additional Requirements

• Required: Masquerade module - Provides the core user switching functionality
• Drupal Version: Compatible with Drupal 10 and Drupal 11
• PHP Version: PHP 8.1 or higher (typed properties used throughout)

Required modules/libraries

• Masquerade - The parent module that provides core user switching. Masquerade Toolbar enhances this with a modern floating UI.

Similar projects

• Masquerade Float Block - The original inspiration for this module. Idea was to make MFB module even more user friendly, with non-technical users in mind. Masquerade Toolbar is a complete rewrite for modern Drupal (10/11) with:
  • Service-based architecture instead of procedural code
  • Autocomplete search functionality
  • Recent users tracking
  • More configuration options
  • Better mobile support and accessibility
  • Event-driven architecture for extensibility

Supporting this Module

If you find it useful:

• Report bugs and request features in the issue queue
• Contribute patches and improvements