{"id":13810375,"url":"https://github.com/JoryHogeveen/view-admin-as","last_synced_at":"2025-05-14T10:33:15.224Z","repository":{"id":52378040,"uuid":"49593458","full_name":"JoryHogeveen/view-admin-as","owner":"JoryHogeveen","description":"View the WordPress admin as a different role, switch between users, temporarily change your capabilities, set default screen settings for roles, manage your roles and capabilities.","archived":false,"fork":false,"pushed_at":"2024-07-30T15:10:49.000Z","size":5282,"stargazers_count":45,"open_issues_count":37,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-07-30T19:06:40.227Z","etag":null,"topics":["access","admin","capabilities","defaults","permission-manager","role-manager","role-switching","roles","switch","user-switching","users","view","visitor","wordpress","wordpress-admin","wordpress-development","wordpress-plugin","wp-plugin"],"latest_commit_sha":null,"homepage":"https://wordpress.org/plugins/view-admin-as/","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JoryHogeveen.png","metadata":{"files":{"readme":"readme.txt","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"license.txt","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"JoryHogeveen","custom":"https://www.keraweb.nl/donate.php?for=view-admin-as"}},"created_at":"2016-01-13T18:33:32.000Z","updated_at":"2024-07-30T19:06:40.228Z","dependencies_parsed_at":"2024-04-29T16:47:27.390Z","dependency_job_id":"7d897a69-13dc-49d1-8814-e651449ab4a0","html_url":"https://github.com/JoryHogeveen/view-admin-as","commit_stats":null,"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoryHogeveen%2Fview-admin-as","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoryHogeveen%2Fview-admin-as/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoryHogeveen%2Fview-admin-as/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JoryHogeveen%2Fview-admin-as/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JoryHogeveen","download_url":"https://codeload.github.com/JoryHogeveen/view-admin-as/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":213870383,"owners_count":15650179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["access","admin","capabilities","defaults","permission-manager","role-manager","role-switching","roles","switch","user-switching","users","view","visitor","wordpress","wordpress-admin","wordpress-development","wordpress-plugin","wp-plugin"],"created_at":"2024-08-04T02:00:51.627Z","updated_at":"2024-08-04T02:01:47.867Z","avatar_url":"https://github.com/JoryHogeveen.png","language":"PHP","funding_links":["https://github.com/sponsors/JoryHogeveen","https://www.keraweb.nl/donate.php?for=view-admin-as"],"categories":["WordPress Plugins"],"sub_categories":[],"readme":"=== View Admin As ===\nContributors: keraweb\nDonate link: https://www.keraweb.nl/donate.php?for=view-admin-as\nTags: admin, view, roles, users, switch, user switching, role switching, capabilities, caps, screen settings, defaults, visitor\nRequires at least: 4.1\nTested up to: 6.5\nRequires PHP: 5.2.4\nStable tag: 1.8.9\n\nView the WordPress admin as a different role or visitor, switch between users, temporarily change your capabilities, set screen settings for roles.\n\n== Description ==\n\n= The ultimate User switcher and Role manager =\n\nThis plugin will add a menu item to your admin bar where you can change your view in the WordPress admin.  \nSwitch to other users without the need to login as that user or even switch roles and temporarily change your own capabilities.\n\nWhen you're viewing as a different user, you can also change this user's preferences; like screen settings on various admin pages.\n\nWith the \"Role defaults\" module you can set default screen settings and metabox locations for roles and apply them to users through various bulk actions.\n\nIt also features a \"Role manager\" module to add, edit or remove roles and grant or deny them capabilities.\n\n= Overview / Features =\n\n*\tSwitch between user accounts\n\t*\tEdit this user's screen preferences and settings\n*\tSwitch between roles\n*\tTemporarily change your own capabilities (non-destructively)\n*\tView your site as an unregistered visitor\n*\tSwitch language/locale on backend and frontend\n*\tMake combinations of the above view types\n*\tEasily switch back anytime\n*\tCompletely secure (see *Security* below)\n*\tDo all the above without logging out!\n\n= Module: Role defaults (screen settings) =\n\n*\tSet default screen settings for roles\n*\tApply defaults to a user\n*\tApply defaults to all users of a role\n*\tApply defaults when registering a new user (in a multisite this is done when a user is added to its first blog)\n*\tCopy defaults from one role to another (or multiple)\n*\tImport/Export role defaults, can also download (and upload) setting files\n*\tDisable the \"screen settings\" option and/or lock the meta boxes for all users that don't have access to this plugin\n\n[Click here for Role Defaults documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Role-Defaults)\n\n= Module: Role manager (role editor) =\n\n*Note: Changes made with the Role Manager are permanent!*\n\n*\tAdd, edit or delete roles\n*\tGrant and/or add capabilities to roles\n*\tRename roles\n*\tClone roles\n*\tImport/Export roles, can also download (and upload) setting files\n*\tUpdate role capabilities from current view\n*\tAutomatically migrate users to another role after deleting a role\n\n[Click here for Role Manager documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Role-Manager)\n\n= Compatibility \u0026 Integrations =\n\nThis plugin will work with most other plugins but these are tested:\n\n*\t**Advanced Access Manager** *(Pro version not verified)*\n*\t**bbPress**\n*\t**BuddyPress**\n*\t**Genesis Framework** *(and probably other theme frameworks)*\n*\t**Google Site Kit**\n*\t**Gravity Forms**\n*\t**Groups 2.1+** *(Custom integration: adds a view type for groups. Pro version not tested)*\n*\t**Pods Framework 2.0+**\n*\t**Members**\n*\t**Restrict User Access 0.13+** *(Custom integration: adds a view type for access levels)*\n*\t**User Roles and Capabilities**\n*\t**User Role Editor** *(Pro version not verified)*\n*\t**User Switching** *(Not sure why you'd want this but yes, switch-ception is possible!)*\n*\t**WPFront User Role Editor**\n*\t**WP Admin UI Customize 1.5.11+**\n*\t**Yoast SEO**\n\nFull list of tested plugins and details: [Compatibility \u0026 Integrations](https://github.com/JoryHogeveen/view-admin-as/wiki/Compatibility-\u0026-Integrations)\n\n= I can't switch back! =\n\nSee item **3** at [FAQ](https://wordpress.org/plugins/view-admin-as/faq/).\n\n= It's not working! / I found a bug! =\n\nPlease let me know through the support and add a plugins and themes list! :)\n\n= Security =\n\nThis plugin is completely safe and will keep your users, passwords and data secure.  \nFor more info see item **7** at [FAQ](https://wordpress.org/plugins/view-admin-as/faq/)!\n\n= Developer notes =\n\nThis plugin will only be useful for admins (network super admins or regular admins). It will not add functionalities for other roles unless you specifically apply custom capabilities for those users.  \nAlso keep in mind that switching to users that have equal roles is disabled. (regular admins to regular admins + super admins to super admins)\n\nI've created this at first for myself since I'm a developer and often need to see the outcome on roles which my clients use.\n\nSo, when you are developing a plugin or theme that does anything with roles or capabilities you can use this plugin to easily check if everything works.\nNo more hassle of creating test users and constantly logging out and in anymore!\n\nThis plugin is also useful to support your clients and/or users. For example; make screen display presets of the edit and overview pages before you let them log in.\n\n== Installation ==\n\nInstallation of this plugin works like any other plugin out there. Either:\n\n1. Upload and unpack the zip file to the '/wp-content/plugins/' directory\n2. Activate the plugin through the 'Plugins' menu in WordPress\n\nOr search for \"View Admin As\" via your plugins menu.\n\n= Minimum Requirements =\n\n* WordPress 4.1 or greater (Though I always recommend to update to the latest version!)\n\n= Install as a must-use plugin =\nMove the `view-admin-as.php` file into the root of your mu-plugins directory, not in the `view-admin-as` subdirectory.  \nThis is a limitation of WordPress and probably won't change soon.  \n\n**Example:**  \nAll files dir: `/wp-content/mu-plugins/view-admin-as/...`  \nMain file dir: `/wp-content/mu-plugins/view-admin-as.php`  \n\n== Frequently Asked Questions ==\n\n= 1. How do I switch to a user, role or visitor? =\nJust click on the link in the toolbar!\n\nIf the amount of users and roles combined is more than 15 you can find the users under their roles or you can search for them.\n  \nIf the amount of users is more than 100 the plugin will switch to AJAX search and won't load users in advance for performance.  \nThis limit can be changed through the filter: [`view_admin_as_user_query_limit`](https://github.com/JoryHogeveen/view-admin-as/wiki/Filters#view_admin_as_user_query_limit)\n\n= 2. How does the capability system work? =\nOnly the capabilities that are allowed for your user are shown.\nYou can deselect the capabilities by clicking on them. When you would like to see the results just click the apply button on the upper left.\n\n*Please note that as an administrator you don't have all capabilities marked as enabled by default. This is because WP overrules some capability checks for super admins. **This does not happen when you are in a view!***\n\nYou can also filter the roles by name or select/deselect all capabilities.\nNote: When you select/deselect capabilities while you've filtered them only the capabilities shown by your filter are affected!\n\nWhen you disable a capability that prevents you from viewing a screen, you can reset the view, see next item.\n\n= 3. I can't switch back! =\nWhen a view is selected there is a reset button available on the dropdown.\nIf you get a 403 page of WordPress you can return with the link that this plugin will add to those pages.\nAnd if even that doesn't work just add \"?reset-view\" in the address bar and you're good to go! This will work on all pages as long as you are logged in.\n\nExample: http://www.your.domain/wp-admin/?reset-view\n\n= 4. How do the Role Defaults and Role Manager modules work? =\n* [Click here for Role Defaults documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Role-Defaults)\n* [Click here for Role Manager documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Role-Manager)\n\n= 5. I can't find a user! =\nCould it be that this user is an equal user to your's? Example: you are both Admins?\nIf so, these are filtered. Viewing Admins can only be done when you are a Super Admin within a network installation.\n\nWhy? To protect your fellow admin! You have no power over equal users..\n*Unless you are a superior admin... [Read more](https://github.com/JoryHogeveen/view-admin-as/wiki/Filters#view_admin_as_superior_admins)*\n\nIf this is not the case, please make sure you aren't overlooking something.  \nIf that is not the case, please contact me! See next item.\n\n= 6. It's not working! / I found a bug! =\nPlease let me know through the support and add a plugins and themes list! :)\n\n= 7. Is this plugin safe? Even for production websites? =\nYou have nothing to worry about.  \nAll the plugin functionality is only run if the user is logged in AND is allowed to use this plugin (website admin or custom capabilities).  \n**This plugin will do absolutely nothing if the above requirements are not met.**\n\n* Your view is stored separately so your user will keep the normal roles and capabilities.\n* All settings, views, capabilities, etc. are verified before applied.\n* Passwords are not (and cannot be) revealed.\n* Fully written with the WordPress coding and security standards.\n* Full support for SSL (https).\n\nSo basically if your admin users are safe, this plugin will be safe.\nNote: if your admin users aren't safe, this plugin is the last one to worry about ;)\n\n= 8. Does this plugin work as a must-use plugin (mu-plugin)? =\nYes, see *Install as a must-use plugin* on the *Installation* tab.\n\n== Screenshots ==\n\n1. Default dropdown\n2. Dropdown with grouped users\n3. Search users\n4. Quickly (de)select capabilities\n5. Large popup for better overview of capabilities\n6. Admin bar when a view is selected + the reset button location\n7. Settings window\n8. Module Role defaults window (tabs are normally closed)\n9. Module Role manager main window (tabs are normally closed)\n10. Module Role manager capability window (tabs is normally closed)\n11. View combinations\n12. Access levels taken from the \"Restrict User Access\" plugin\n\n== Changelog ==\n\n= 1.8.9 =\n\n*\t**Fix:** Event bubbling for select elements [#130](https://github.com/JoryHogeveen/view-admin-as/issues/130)\n*\t**Fix:** Check if removable query args exists before adding removal script on front-end\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/131)\n\n= 1.8.8 =\n\n*\t**Enhancement:** RTL support. [#122](https://github.com/JoryHogeveen/view-admin-as/issues/122)\n*\t**Enhancement:** User context for checking the `edit_user` capability.\n*\t**Enhancement:** Enhance front-end CSS by preventing theme overrides. [#120](https://github.com/JoryHogeveen/view-admin-as/issues/120)\n*\t**Enhancement/Fix:** JSON/REST call checks.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/123)\n\n= 1.8.7 =\n\n*\t**Enhancement:** Added hooks `vaa_view_admin_as_reset_all_views`, `vaa_view_admin_as_cleanup_views`, `vaa_view_admin_as_reset_view`, `vaa_view_admin_as_update_view`.\n*\t**Enhancement/Compatibility:** Fix compatibility issue with MetaSlider block preview (JSON/AJAX requests) [#117](https://github.com/JoryHogeveen/view-admin-as/issues/117)\n*\t**Compatibility:** Fixed issues with capability filters overwriting available capabilities.\n*\t**Compatibility:** Remove redundant canonical tag. [#119](https://github.com/JoryHogeveen/view-admin-as/issues/119)\n*\t**Compatibility:** WordPress 5.7 UI.\n*\t**Fixed:** Missing textdomain parameter.\n*\t**Refactor:** Added action logs.\n*\t**Refactor:** Enhance view type classes.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/118)\n\n= 1.8.6 =\n\n*\t**Compatibility:** WordPress 5.4 `apply_shortcodes()` function. [#111](https://github.com/JoryHogeveen/view-admin-as/issues/111)\n*\t**Compatibility:** Add Google Site Kit capabilities. [#110](https://github.com/JoryHogeveen/view-admin-as/issues/110)\n*\t**Compatibility:** User Role Editor capability filter format. [#112](https://github.com/JoryHogeveen/view-admin-as/issues/112)\n*\t**Enhancement:** Always show `force-ajax-users` setting to optionally prevent query.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/113)\n\n= 1.8.5 =\n\n*\t**Compatibility:** CSS compatibility for WP 5.3\n*\t**Compatibility:** Roles are now translated in all cases since WP 5.2.\n*\t**Enhancement:** JS performance.\n*\t**Enhancement:** Enhance AJAX checks.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/107)\n\n= 1.8.4 =\n\n*\t**Enhancement:** Role Manager: Reload when in a user view and the user's role has been modified. [#105](https://github.com/JoryHogeveen/view-admin-as/issues/105)\n*\t**Compatibility:** WordPress 5.2 admin bar arrow icon update. [WP Core #37513](https://core.trac.wordpress.org/ticket/37513)\n*\t**Compatibility:** [Dark Mode](https://nl.wordpress.org/plugins/dark-mode/) ([Github](https://github.com/danieltj27/Dark-Mode))\n*\t**Fix:** Role Defaults: Only return screen setting overwrite if found. [#104](https://github.com/JoryHogeveen/view-admin-as/issues/104)\n*\t**API:** Added API method `is_view_active()`. ([Documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/PHP-API#is_view_active))\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/106)\n\n= 1.8.3 =\n\n*\t**Compatibility:** Users always have the exists capability. [Go to issue](https://wordpress.org/support/topic/compatibility-with-view-admin-as-2/)\n*\t**Compatibility:** WordPress 4.9.6 privacy capabilities.\n*\t**API:** Added several API methods \u0026 enhancements.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/102)\n\n= 1.8.2 =\n\n*\t**Enhancement/Fix:** Support AJAX search in the Role Defaults module. [#100](https://github.com/JoryHogeveen/view-admin-as/issues/100)\n*\t**Enhancement:** Add support for `X-Redirect-By` header since WordPress 5.0. [#42313](https://core.trac.wordpress.org/ticket/42313)\n*\t**Enhancement:** Improve uninstall script.\n*\t**Enhancement:** Use latest WPCS v1.1 update and fix code standard notices.\n*\t**UI:** Change the default top level node text to \"View As\" (same as Facebook uses).\n*\t**Updated:** Screenshots\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/98)\n\n= 1.8.1 =\n\n*\t**Feature:** Support searching users by multiple user columns like email, url, etc. [#95](https://github.com/JoryHogeveen/view-admin-as/issues/95)\n*\t**Feature:** User setting to force AJAX search for users. [#96](https://github.com/JoryHogeveen/view-admin-as/issues/96)\n*\t**Feature:** New filter: `view_admin_as_user_ajax_search` to force AJAX search for user at all times.\n*\t**Fix:** Prevent \"form changed\" popup which showed in various pages. [#93](https://github.com/JoryHogeveen/view-admin-as/issues/93)\n*\t**Enhancement:** Improve Pods Framework compatibility when in a view.\n*\t**Enhancement:** Improve getting view data on load.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/94)\n\n= 1.8 =\n\n*\t**Feature:** View combinations UI. [#18](https://github.com/JoryHogeveen/view-admin-as/issues/18)\n*\t**Feature/Enhancement:** Limit user query to max 100 users for performance. Switch to AJAX search if there are more users than this limit. [#19](https://github.com/JoryHogeveen/view-admin-as/issues/19)\n*\t**Accessibility:** New filter: `view_admin_as_user_query_limit` to change the limit used to query users.\n*\t**Accessibility:** New filters: `vaa_admin_bar_view_title_role` \u0026 `vaa_admin_bar_view_title_user` \u0026 `vaa_admin_bar_view_title_locale` to change the titles for role, users and languages.\n*\t**Accessibility:** New filter: `vaa_admin_bar_view_title_user_show_roles` to remove the roles from user nodes.\n*\t**Accessibility:** New filter: `view_admin_as_full_access_capabilities` for single site installations to change the capabilities required to gain full access to this plugin.\n*\t**Enhancement:** Use a class autoloader.\n*\t**Enhancement:** Stop using the `rel` attribute for view type data.\n*\t**Enhancement:** Access validation logic.\n*\t**Compatibility:** Patch Yoast SEO compatibility. [Yoast SEO #9365](https://github.com/Yoast/wordpress-seo/pull/9365)\n*\t**Refactoring:** Action/Filter hook manager class. [#77](https://github.com/JoryHogeveen/view-admin-as/issues/77)\n*\t**Refactoring:** Refactor all view types as separate modules. [#84](https://github.com/JoryHogeveen/view-admin-as/issues/84)\n*\t**Fix:** Use `prop` instead of `attr` for `checked` attributes in checkbox inputs.\n*\t**Updated/Added:** Screenshots.\n\nDetailed info: [PR on GitHub](https://github.com/JoryHogeveen/view-admin-as/pull/78)\n\n= Older versions =\n\n[Complete changelog](https://github.com/JoryHogeveen/view-admin-as/wiki/Changelog)\n\n== Other Notes ==\n\n= You can find me here: =\n\n*\t[Keraweb](http://www.keraweb.nl/)\n*\t[GitHub](https://github.com/JoryHogeveen/view-admin-as/)\n*\t[LinkedIn](https://nl.linkedin.com/in/joryhogeveen)\n\n= Translations =\n\nPlease help translating this plugin on [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/view-admin-as)!\n\n= Actions \u0026 Filters =\n\n*\t[Click here for Action documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Actions)\n*\t[Click here for Filter documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Filters)\n\n= Plugin capabilities =\n\n[Click here for documentation](https://github.com/JoryHogeveen/view-admin-as/wiki/Custom-capabilities)\n\n= Ideas? =\n\nPlease let me know on [GitHub](https://github.com/JoryHogeveen/view-admin-as/issues/new)!\n\n== Upgrade Notice ==\n\n= 1.7 =\nVersion 1.7 introduces some radical code changes to the plugin and requires WordPress 4.1 or higher. Please clear your cache after updating.\n\n= 1.5 =\nVersion 1.5 introduces some radical code changes to the plugin. Please clear your cache after updating.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJoryHogeveen%2Fview-admin-as","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FJoryHogeveen%2Fview-admin-as","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FJoryHogeveen%2Fview-admin-as/lists"}