=== DawsonyWeb – Admin Utilities ===
Contributors: dawsonyweb
Tags: admin, utilities, copy, environment, dashboard
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A lightweight, modular admin suite that bundles small, high-value quality-of-life tools for developers, site admins, and editors.

== Description ==

**DawsonyWeb – Admin Utilities** is a developer-friendly WordPress plugin that packages the small admin improvements you actually need into one clean, modular plugin. No bloat, no nag banners, no upsells.

Each tool (module) can be independently enabled or disabled. Only enabled modules load their hooks and assets, keeping your admin fast.

= Modules Included =

**Copy Buttons Everywhere**
Adds copy buttons for IDs, permalinks, edit links, and slugs across:

* Post/Page/CPT list tables (row actions)
* Single post edit screens (meta box)
* Users list table
* Taxonomy term list tables

**White Label, Maintenance and Handoff**
The Free plugin also includes login/footer branding, scheduled maintenance mode and a client handoff report. These existing features remain Free.

**Environment Badge**
Shows a color-coded environment indicator (LOCAL / DEV / STAGING / LIVE) in the admin bar. Uses `wp_get_environment_type()` with a `DAWSONY_ENV` constant fallback. Configurable per role.

**Debug Snapshot**
A read-only support snapshot page showing WordPress version, PHP version, server info, memory limits, active theme, active plugins, and more. Includes a one-click "Copy as Text" button for easy sharing with support teams.

**Global Admin Notice Board**
Set a message that appears in wp-admin for selected roles. Supports basic HTML, notice type (info/success/warning/error), optional expiry date, and per-user dismissal with admin reset.

**Dashboard Widget Manager**
Hide or show dashboard widgets per user role. Automatically discovers all registered widgets (core + plugin) and lets you control visibility from a simple settings UI.

= Philosophy =

* Admin tools run in wp-admin; optional maintenance mode and login branding affect the public site when enabled.
* No external tracking, telemetry, or "phone home" behavior
* Validated settings imports with a 1 MB size limit
* Nonces for all actions, capability checks for all settings
* Clean uninstall removes all data

== Installation ==

= Automatic Installation =
1. Go to **Plugins → Add New** in your WordPress admin.
2. Search for "DawsonyWeb – Admin Utilities".
3. Click **Install Now**, then **Activate**.

= Manual Installation =
1. Download the plugin ZIP file.
2. Go to **Plugins → Add New → Upload Plugin**.
3. Upload the ZIP and click **Install Now**.
4. Activate the plugin.

= FTP Installation =
1. Extract the ZIP file.
2. Upload the `dawsony-admin-utilities` folder to `/wp-content/plugins/`.
3. Activate via **Plugins** in the WordPress admin.

== Frequently Asked Questions ==

= Where are the settings? =

Go to **Tools → Dawsony Utilities**. The Modules tab lets you enable/disable each tool. Enabled modules with settings get their own tabs.

= Does this plugin affect the front end? =

Most modules run in wp-admin. The included maintenance mode and login branding deliberately change public output when you enable them.

= What happens when I disable a module? =

Its hooks are immediately unregistered. No assets load, no UI appears. The module's settings are preserved in case you re-enable it.

= What PHP version is required? =

PHP 7.4 or higher.

= Is this plugin multisite compatible? =

The plugin will not cause errors on multisite, but the settings are per-site. Network-wide settings are not yet supported.

= How does the Environment Badge detect the environment? =

It checks `wp_get_environment_type()` (available since WP 5.5). You can override it with the `DAWSONY_ENV` constant in `wp-config.php`.

= Does the Debug Snapshot expose any secrets? =

No. It only shows safe, support-friendly information. No database credentials, API keys, or sensitive constants are included.

== Screenshots ==

1. DawsonyWeb workspace with independent module controls.
2. Environment badge settings and role visibility.

== Changelog ==

= 1.2.0 =
* Fixed unchecked roles and widgets being retained. Validated and size-limited settings imports. Refreshed the DawsonyWeb admin workspace.


= 1.1.5 =
* Compatibility: tested up to WordPress 7.0.

= 1.1.2 =
* Plugin Check: translators comment directly above `esc_html__()`; `map_deep` sanitization for settings POST; view variables use `dawsony_admin_utilities_*` prefix.
* Do not include hidden files (e.g. `.gitignore`, `.DS_Store`) in the zip submitted to WordPress.org.

= 1.1.1 =
* WordPress.org Plugin Check: i18n, escaping, settings input handling, readme alignment.

= 1.0.0 =
* Initial release.
* Copy Buttons Everywhere module.
* Environment Badge module with per-user personal toggle.
* Debug Snapshot module.
* Global Admin Notice Board module with per-user dismissal and admin reset.
* Dashboard Widget Manager module.
* Import / Export settings as JSON.
* Help tab with module summaries and support link.

== Upgrade Notice ==

= 1.1.2 =
Further Plugin Check fixes (i18n, input sanitization, global prefixes, packaging).

= 1.1.1 =
Maintenance release for WordPress.org guidelines and packaging.

= 1.0.0 =
Initial release.

== Privacy ==

DawsonyWeb – Admin Utilities does not collect, store, or transmit any data externally. All data is stored locally in your WordPress database (wp_options and wp_usermeta). No cookies are set. No external requests are made.
