README

Support Access Manager is a lightweight PHP class for WordPress that allows temporary admin accounts to be created with expiration and access limits. It can be easily dropped into any project or installed via Composer.

✅ Create temporary admin accounts
✅ Set expiration times (e.g., auto-delete after 24 hours)
✅ Limit number of logins per account
✅ Secure login URLs for support access
✅ Cron-based cleanup of expired accounts

Install via Composer (Recommended)

To include Support Access Manager in your WordPress plugin or theme, add it as a dependency:

composer require derekashauer/support-access-manager

Then run:

composer update

Usage

Once installed be sure to include the autoload file:

require_once ABSPATH . 'vendor/autoload.php';

Manually Include the Class

If you prefer not to use Composer, simply download class-support-access-manager.php and include it in your project:

require_once 'path/to/class-support-access-manager.php';

Usage

Basic Usage (Single Instance)

// Get the instance with default settings
Support_Access_Manager::instance();

// Or get the instance with custom settings
Support_Access_Manager::instance( array(
    'menu_label' => 'Support Users',
    'menu_slug'  => 'support-users',
    'textdomain' => 'my-plugin',
    'defaults'   => array(
        'duration'      => 2,
        'duration_unit' => 'days',
        'role'          => 'editor',
    ),
) );

Custom Instance

If you need a completely separate instance with its own settings, you can extend the class:

class My_Custom_Support_Access extends Support_Access_Manager {
    // Override the singleton functionality
    public static function instance( $args = array() ) {
        return new self( $args );
    }

    // Make constructor public
    public function __construct( $args = array() ) {
        parent::__construct( $args );
    }
}

// Create your custom instance
$my_support = My_Custom_Support_Access::instance( array(
    'menu_slug'   => 'my-custom-support',
    'menu_label'  => 'My Custom Support',
    'parent_slug' => 'tools.php',
    'textdomain'  => 'my-plugin',
) );

This approach allows you to:

1. Have multiple instances with different settings
2. Override or extend functionality
3. Place the menu item in different locations
4. Use your own translations

Menu Settings

• menu_slug (string) - The URL slug for the admin page

  • Default: 'support-access'
  • Example: 'temp-users'

• menu_label (string) - The text shown in the admin menu

  • Default: 'Support Access'
  • Example: 'Temporary Users'

• parent_slug (string) - Where to place the menu item

  • Default: 'users.php' (Users menu)
  • Common values: 'tools.php', 'options-general.php', 'settings.php'

• textdomain (string) - Text domain for translations

  • Default: 'support-access'
  • Example: 'my-plugin'
  • Use your plugin's textdomain to provide your own translations

Form Defaults

The defaults array allows you to set default values for all form fields:

• duration (int) - Default number for duration

  • Default: 1
  • Example: 2

• duration_unit (string) - Default time unit

  • Default: 'weeks'
  • Options: 'hours', 'days', 'weeks', 'months'

• timeout (int|string) - Default link timeout in hours

  • Default: '' (empty string)
  • Example: 24 (link expires after 24 hours)
  • Set to empty string for no timeout

• usage_limit (int|string) - Default usage limit

  • Default: '' (empty string)
  • Example: 3 (link can be used 3 times)
  • Set to 0 or empty string for unlimited uses

• role (string) - Default WordPress role

  • Default: 'administrator'
  • Options: Any valid WordPress role ('editor', 'author', etc.)

• locale (string) - Default language

  • Default: '' (site default)
  • Example: 'es_ES' (Spanish)
  • Use WordPress locale codes

Example Configurations

Set custom defaults for menu label, duration, role

new Support_Access_Manager( array(
    'menu_label' => 'Contractor Access',
    'defaults'   => array(
        'duration'      => 1,
        'duration_unit' => 'months',
        'role'          => 'author',
    ),
) );

Set custom defaults for login link timeout, usage limit, language

new Support_Access_Manager( array(
    'defaults' => array(
        'timeout'       => 48,
        'usage_limit'   => 5,
        'role'          => 'editor',
        'locale'        => 'es_ES',
    ),
) );

Use custom text domain

new Support_Access_Manager( array(
    'textdomain' => 'my-plugin',
) );

Then in your plugin's translation files, you can include translations for all the strings used by Support Access Manager.

Notes

• All default values can be overridden when creating individual temporary users
• The menu will only be visible to users with the 'manage_options' capability
• Temporary users are automatically deleted when they expire
• Access URLs can be configured to expire independently of the user account

License

This project is licensed under the MIT License.

See the LICENSE file for details.

Contributing

If you'd like to contribute, fork the repository and submit a pull request. Issues and feature requests are welcome.

Author

Derek Ashauer
GitHub

My Plugins: Conversion Bridge | WP Sunshine | Sunshine Photo Cart