Title: EffortLess Simple Role Initializer
Author: domclic
Published: <strong>15 de Julho, 2026</strong>
Last modified: 15 de Julho, 2026

---

Pesquisar plugins

![](https://ps.w.org/effortless-simple-role-initializer/assets/banner-772x250.jpg?
rev=3609496)

![](https://ps.w.org/effortless-simple-role-initializer/assets/icon-256x256.jpg?
rev=3609496)

# EffortLess Simple Role Initializer

 Por [domclic](https://profiles.wordpress.org/domclic/)

[Baixar](https://downloads.wordpress.org/plugin/effortless-simple-role-initializer.1.2.14.zip)

 * [Detalhes](https://pt-ao.wordpress.org/plugins/effortless-simple-role-initializer/#description)
 * [Avaliações](https://pt-ao.wordpress.org/plugins/effortless-simple-role-initializer/#reviews)
 *  [Instalação](https://pt-ao.wordpress.org/plugins/effortless-simple-role-initializer/#installation)
 * [Desenvolvimento](https://pt-ao.wordpress.org/plugins/effortless-simple-role-initializer/#developers)

 [Suporte](https://wordpress.org/support/plugin/effortless-simple-role-initializer/)

## Descrição

**EffortLess Simple Role Initializer** is a powerful network administration tool
designed specifically for WordPress multisite installations. It provides comprehensive
role management capabilities across your entire network from a single, intuitive
interface.

#### Key Features

 * **Reinitialize Default Roles**: Reset all roles to WordPress defaults across 
   all sites or selected sites
 * **Bulk Role Changes**: Change users from one role to another across multiple 
   sites simultaneously
 * **Role Preview**: See what changes would be made before applying them
 * **Network Role Summary**: View role distribution across your entire network at
   a glance
 * **Automatic Backups**: Create JSON backups of current roles before making changes
 * **Selective Site Targeting**: Choose to apply changes to all sites or specific
   sites only
 * **AJAX-Powered Interface**: Real-time feedback and smooth user experience

#### Perfect For

 * **Network Administrators** managing large multisite installations
 * **Agencies** maintaining multiple client sites
 * **Educational Institutions** with numerous department sites
 * **Organizations** with distributed site management needs
 * **Developers** working on multisite projects

#### Use Cases

 1. **Site Migration**: Quickly standardize roles when migrating sites into a network
 2. **Role Cleanup**: Remove custom roles and restore WordPress defaults
 3. **Bulk User Management**: Change multiple users’ roles across sites simultaneously
 4. **Network Standardization**: Ensure consistent role structure across all network
    sites
 5. **Permission Auditing**: Review and adjust user permissions network-wide

#### Safety Features

 * **Confirmation Dialogs**: Prevents accidental changes with confirmation prompts
 * **Role Backups**: Automatic backup creation before making changes
 * **Preview Mode**: See changes before applying them
 * **Detailed Logging**: Clear feedback on all operations performed
 * **Capability Checks**: Only network administrators can access functionality

### Advanced Usage

#### Backup File Format

Backup files are saved in JSON format with the following structure:
 `{ "site_id":{"
role_name": { "name": "Role Display Name", "capabilities": { "capability_name": 
true/false } } } }

#### Performance Considerations

 * Operations on large networks may take time to complete
 * AJAX timeouts are handled gracefully with progress indicators
 * Backup files can become large with many sites and custom roles

### Support

For support, bug reports, or feature requests, please use the plugin’s support forum
on WordPress.org.

## Instalação

#### Minimum Requirements

 * WordPress 6.0 or higher
 * WordPress Multisite installation
 * PHP 7.4 or higher
 * Network Administrator privileges

#### Installation Steps

 1. **Upload** the plugin files to `/wp-content/plugins/effortless-simple-role-initializer/`
    directory
 2. **Network Activate** the plugin through the ‘Network Admin > Plugins’ menu
 3. **Navigate** to ‘Network Admin > Settings > Role Initializer’ to access the features

#### Important Notes

 * This plugin **requires** a WordPress Multisite installation
 * Only works in Network Admin – not available on individual sites
 * Requires `manage_network_options` capability

## FAQ

### Does this plugin work on single-site WordPress installations?

No, this plugin is designed exclusively for WordPress Multisite installations. It
will display an error notice on single-site installations.

### Can I undo role changes after they’re made?

If you enabled the backup option before making changes, you can restore roles from
the JSON backup file created in your uploads directory (`wp-content/uploads/effortless-
role-backups/`). The plugin does not provide an automatic undo feature.

### What happens to custom roles when I reinitialize?

When you reinitialize roles, all custom roles are removed and only the default WordPress
roles (Administrator, Editor, Author, Contributor, Subscriber) are recreated. Make
sure to backup if you need to preserve custom roles.

### Can I select which sites to apply changes to?

Yes, you can choose to apply changes to all sites in the network or select specific
sites from a dropdown list.

### Is there a preview feature?

Yes, the “Change User Roles” feature includes a preview option that shows you exactly
how many users would be affected on which sites before you make any actual changes.

### Where are backup files saved?

Backup files are saved in `wp-content/uploads/effortless-role-backups/` with the
naming format: `role-backup-YYYY-MM-DD-HH-ii-ss.json`

### What user capabilities are required?

Users must have the `manage_network_options` capability, which is typically only
available to Super Administrators in a multisite network.

## Avaliações

There are no reviews for this plugin.

## Contribuidores e desenvolvedores

“EffortLess Simple Role Initializer” é um software com código aberto. As seguintes
pessoas contribuíram para este plugin.

Contribuidores

 *   [ domclic ](https://profiles.wordpress.org/domclic/)

[Traduzir “EffortLess Simple Role Initializer” para o seu idioma.](https://translate.wordpress.org/projects/wp-plugins/effortless-simple-role-initializer)

### Interessado no desenvolvimento?

[Navegue pelo código](https://plugins.trac.wordpress.org/browser/effortless-simple-role-initializer/),
dê uma olhada no [repositório SVN](https://plugins.svn.wordpress.org/effortless-simple-role-initializer/)
ou assine o [registro de desenvolvimento](https://plugins.trac.wordpress.org/log/effortless-simple-role-initializer/)
via [RSS](https://plugins.trac.wordpress.org/log/effortless-simple-role-initializer/?limit=100&mode=stop_on_copy&format=rss).

## Registro de alterações

#### 1.2.14

 * Fixed: the “requires Multisite” error notice rendered on every admin page, indefinitely,
   with no dismiss option, whenever the plugin was somehow active on a single-site
   install — a Plugin Check “Guideline 11” (don’t hijack the admin dashboard) concern.
   Activation is now blocked outright via `register_activation_hook()` (the plugin
   deactivates itself and shows a one-time activation error); the runtime notice
   is now a defensive fallback scoped to the Plugins screen only.
 * Verified: the donate notice (`ELSRI_Donate_Notice`) only ever registers its `
   admin_notices`/`network_admin_notices` callbacks after a `current_screen` match
   against the Role Initializer settings page — it cannot render on any other admin
   screen.

#### 1.2.13

 * Fixed: `PrefixAllGlobals.NonPrefixedClassFound` warning on `ELSRI_Donate_Notice`
   resurfaced once `phpcs.xml.dist` was excluded from the submission zip (it can’t
   ship there — see 1.2.12). Re-added a scoped `phpcs:disable`/`phpcs:enable` pair
   around the class since no ruleset-file fix can reach the automated scanner without
   also failing it.

#### 1.2.12

 * Fixed: WordPress.org’s automated plugin scan failed with `phpcs.xml.dist ERROR:
   application_detected: Application files are not permitted.` — dev-tooling config
   files must never ship in the submission zip. `phpcs.xml.dist` stays in git for
   local linting but is now excluded from the release zip.

#### 1.2.11

 * Changed: replaced the 1.2.10 `phpcs:disable`/`phpcs:enable` suppression for `
   ELSRI_Donate_Notice` with a `phpcs.xml.dist` ruleset declaring `elsri`/`effortless_simple_role_initializer`
   as accepted prefixes via `PrefixAllGlobals`‘s standard `prefixes` property — 
   a real sniff-configuration fix instead of a per-line suppression.
 * Changed: `ajax_apply_role_change()` now reads `rc_backup_roles` inside `get_role_change_targets()`(
   same scope as the `check_ajax_referer()` call) instead of via a suppressed direct`
   $_POST` read, removing the last non-essential `phpcs:ignore` in the plugin.

#### 1.2.10

 * Fixed: the 1.2.9 `phpcs:ignore` for `ELSRI_Donate_Notice` didn’t actually suppress
   the warning because a docblock sat between the ignore comment and the class declaration,
   breaking PHPCS’s line association; replaced with a scoped `phpcs:disable`/`phpcs:
   enable` pair bracketing the docblock and class line.

#### 1.2.9

 * Fixed: Plugin Check flagged `ELSRI_Donate_Notice` (`WordPress.NamingConventions.
   PrefixAllGlobals.NonPrefixedClassFound`) because its auto-detection only recognizes
   prefixes derived literally from the slug/text domain, not the suite’s initialism
   convention; added a scoped `phpcs:ignore` since the class is already correctly
   prefixed.

#### 1.2.8

 * Changed: renamed the internal `emrm_` prefix (leftover from an earlier plugin
   name) to `elsri_`/`ELSRI_`, matching the project’s EffortLess-suite prefix convention(
   hooks, nonces, the JS global, CSS classes, and DOM ids).

#### 1.2.7

 * Fixed: `.wrap` div on the admin page now carries a second class with a margin
   override, per the project’s admin page layout convention.
 * Fixed: readme description, screenshots, and “Network Integration” section still
   referenced the removed top-level “EffortLess” dashboard/menu.
 * Fixed: FAQ and Advanced Usage sections still described role backups as saved 
   to `wp-content/` instead of the uploads directory.
 * Fixed: removed unsupported “visit our website”/documentation/contribution claims
   from the Support section.

#### 1.2.6

 * Changed: moved the Role Initializer page from its own top-level “EffortLess” 
   network admin menu into a submenu under Network Admin > Settings.

#### 1.2.5

 * Fixed: plugin header `Requires at least` was stale at 5.0 while readme.txt already
   required 6.0 — header now matches readme.

#### 1.2.4

 * Added: Bulk Role Change tool with a per-site preview before applying, and an 
   optional backup of affected users’ prior role.
 * Fixed: moved inline `<script>`/`<style>` blocks into enqueued assets/js/admin.
   js and assets/css/admin.css (WordPress.org Plugin Check flags inline script/style
   tags).
 * Fixed: role backup files now save under the uploads directory instead of directly
   in wp-content/.
 * Added: donate notice on the Role Initializer admin screen; added the missing 
   Donate link.
 * Fixed: corrected the stale install-path folder name in readme.txt.
 * Fixed: renamed the main plugin file to match the plugin slug.

#### 1.2.3

 * Fixed role backup capturing wrong site data (wp_roles singleton doesn’t refresh
   across switch_to_blog)
 * Fixed stale WP_Roles singleton after populate_roles — unset global before reinitializing
 * Fixed backup success message shown even when filesystem write failed
 * Fixed get_users() O(sites×users) memory exhaustion in role summary — replaced
   with count_users()
 * Added try/finally guards around switch_to_blog loops to prevent corrupted blog
   context on error
 * Fixed XSS risk: response messages now inserted via .text() instead of .html()
   in JS
 * Replaced deprecated get_blog_details() with get_site()
 * Fixed PHPCS EscapeOutput violations in list_network_sites() and admin_notices
   callback

#### 1.2.2

 * Fixed WordPress coding standards violations
 * Improved inline comment formatting with proper punctuation
 * Enhanced role reinitialization process by properly clearing cache
 * Replaced direct file operations with WordPress filesystem API
 * Removed deprecated global variable overrides
 * Code optimization and security improvements

#### 1.2.1

 * Fixed AJAX nonce handling inconsistencies
 * Improved error handling and validation
 * Enhanced JavaScript form submission handling
 * Added role validation to prevent invalid changes
 * Better backup file creation with error checking
 * Security improvements and code optimization

#### 1.2.0

 * Added main EffortLess dashboard page
 * Improved user interface with card-based layout
 * Enhanced role summary display
 * Better integration with EffortLess suite
 * Updated admin menu structure

#### 1.1.0

 * Added bulk user role change functionality
 * Implemented preview mode for role changes
 * Added role summary display
 * Improved AJAX handling
 * Enhanced backup system

#### 1.0.0

 * Initial release
 * Role reinitialization functionality
 * Site targeting options
 * Backup system
 * Network admin integration

## Meta

 *  Version **1.2.14**
 *  Last updated **2 dias atrás**
 *  Active installations **Menos de 10**
 *  WordPress version ** 6.0 ou maior **
 *  Tested up to **7.0.1**
 *  PHP version ** 7.4 ou maior **
 *  Language
 * [English (US)](https://wordpress.org/plugins/effortless-simple-role-initializer/)
 * Tags
 * [multisite](https://pt-ao.wordpress.org/plugins/tags/multisite/)[network admin](https://pt-ao.wordpress.org/plugins/tags/network-admin/)
   [role manager](https://pt-ao.wordpress.org/plugins/tags/role-manager/)[roles](https://pt-ao.wordpress.org/plugins/tags/roles/)
   [user management](https://pt-ao.wordpress.org/plugins/tags/user-management/)
 *  [Panorama avançado](https://pt-ao.wordpress.org/plugins/effortless-simple-role-initializer/advanced/)

## Classificações

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/effortless-simple-role-initializer/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/effortless-simple-role-initializer/reviews/)

## Contribuidores

 *   [ domclic ](https://profiles.wordpress.org/domclic/)

## Suporte

Tem algo a dizer? Precisa de ajuda?

 [Ver fórum de suporte](https://wordpress.org/support/plugin/effortless-simple-role-initializer/)

## Doar

Gostaria de apoiar o desenvolvimento deste plugin?

 [ Faça uma doação a este plugin ](https://id7.dev/donate/?plugin=effortless-simple-role-initializer)