=== AdminForge – Admin Management Toolkit ===
Contributors: solankisoftware
Tags: admin, dashboard, roles, menu, ui
Donate link: https://paypal.me/kirtikumar89
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Streamline wp-admin with role-based menu visibility, dashboard widget cleanup, and lightweight admin UI customization.

== Description ==

AdminForge – Admin Management Toolkit (Free) helps site owners clean up the WordPress admin area without editing theme files or writing custom code.

This version focuses on practical day-to-day admin improvements:

* Hide admin menu items per role.
* Hide core dashboard widgets per role.
* Customize the admin footer text.
* Hide the front-end admin bar for selected roles.

All settings are available from a single screen under **Settings -> Admin Toolkit**.

= Main Features =

* **Admin menu control**
  * Detects currently registered admin menu slugs.
  * Lets you hide selected menu items for each role.
  * Helpful for reducing clutter for editors, authors, and shop managers.

* **Dashboard widget manager**
  * Toggle common core dashboard widgets per role.
  * Keeps the Dashboard focused on only what each role needs.

* **Admin UI customization**
  * Replace the default admin footer text.
  * Hide the front-end admin bar for specific roles.
  * Uses safe sanitization for saved values.

= Included in this free version =

* Admin menu control
* Dashboard widget control
* Admin footer customization
* Front-end admin bar visibility by role

= Not included in this free version =

* Role-based wp-admin access restriction
* Performance tuning options
* Login branding and role-based login redirects
* XML-RPC and hardening toggles

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate **Admin Toolkit** in Plugins.
3. Go to **Settings -> Admin Toolkit**.
4. Configure options by tab and click **Save Changes**.

== Usage ==

1. Open **Settings -> Admin Toolkit**.
2. Choose a tab:
   * **Admin menu control** - hide selected menu slugs per role.
   * **Dashboard widgets** - hide selected core dashboard widgets per role.
   * **Admin UI customization** - set custom footer text and admin bar visibility.
3. Save changes.

= Tips =

* Menu slug list is generated from current admin menus.  
  If a plugin menu is missing, open any admin page once, then reload the tab.
* Role-based settings apply to users who have that role.
* Front-end admin bar visibility only affects the site front end, not wp-admin screens.

== Frequently Asked Questions ==

= Who can change plugin settings? =

Only users with the `manage_options` capability can access and save settings.

= Can this lock me out of wp-admin? =

No. This free version does not include wp-admin access restriction features.

= Does it remove plugin-added dashboard widgets? =

The built-in toggles target common core widget IDs. Third-party widgets may require their own widget IDs.

= Does this plugin edit theme or plugin files? =

No. It only stores settings and applies WordPress hooks/filters at runtime.

= Where are settings stored? =

Settings are stored in one WordPress option: `afamt_options`.

== Screenshots ==

1. Admin Menu Control Tab
2. Dashboard widget Tab  
3. Admin UI customization Tab


== Uninstall ==

When deleted from the Plugins screen, the plugin removes its saved option (`afamt_options`).

== Changelog ==

= 1.0.0 =
* Initial public release.
* Free feature set includes:
  * Admin menu control by role
  * Dashboard widget control by role
  * Admin footer text customization
  * Front-end admin bar visibility by role