=== Bros Clean Admin – Hide Dashboard Ads ===
Contributors: enos1
Author : Enea
Donate link: https://ko-fi.com/W7W51P4XY6
Tags: admin dashboard, clean ads, notices, nag, promotions
Plugin URI: https://github.com/EneaCodes/Bros-Clean-Admin
Requires at least: 5.6
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.1.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Clean up your WordPress admin area by hiding most ads, review nags and promo banners while keeping real warnings and errors visible.

== Description ==

Many plugins flood your wp-admin with:

* "Go Pro / Upgrade" boxes
* Black Friday / Cyber Monday sales
* "Please rate us 5-stars" notices

**Bros Clean Admin – Hide Dashboard Ads** quietly removes that noise so you can focus on your work.

What it does:

* Hides most dashboard promo widgets and sale banners
* Hides annoying "Rate us / Leave a review" nags
* Hides common plugin promo boxes on settings pages
* Keeps core error/warning notices visible
* Simple options page under **Settings → Clean Admin**
* Supports translations via `bros-clean-admin-hide-dashboard-ads` text domain
* Custom promo/review keyword lists for power users
* Settings reset to defaults with one click
* Shows a quick activation notice with direct Settings link

This plugin only runs in `wp-admin` and does not affect your frontend.

If you enjoy this plugin and want to support development, you can buy me a coffee here:
https://ko-fi.com/W7W51P4XY6

Development and source code:

* Author profile: https://github.com/EneaCodes/
* Plugin repository: https://github.com/EneaCodes/Bros-Clean-Admin

== Installation ==

1. Upload the `bros-clean-admin-hide-dashboard-ads` folder to the `/wp-content/plugins/` directory, or install via the Plugins → Add New screen.
2. Activate **Bros Clean Admin – Hide Dashboard Ads** through the "Plugins" menu in WordPress.
3. Go to **Settings → Clean Admin** and choose which types of notices to hide.
4. (Optional) Add your own keywords in the advanced settings to hide more promo/review texts.

== Frequently Asked Questions ==

= Does this affect my site frontend? =

No. Clean Admin only runs in the WordPress admin area (`/wp-admin`).

= Will it hide core error messages? =

The plugin tries to keep anything that looks like a real error or warning (for example WordPress core error notices).
It mainly targets promotional, upsell, and review messages.

= Can this break a plugin? =

It only hides UI elements with CSS/JS based on their text content and classes.
It does not disable hooks or remove code, so in normal cases it should not break functionality.

= Does it support Elementor / similar plugins? =

Yes, Clean Admin can hide many Elementor / ElementsKit / other plugin promo boxes and review nags, but it cannot guarantee 100% coverage for every plugin.

= Where is the Settings link? =

On the Plugins page, there is a direct **Settings** link under Clean Admin, or go to **Settings → Clean Admin**.

== Advanced Usage ==

= Custom Keywords =

You can add your own keywords to hide specific promotions or review requests. For example:

* To hide "Early Bird" offers: add `early bird` to **Custom Promo Keywords**.
* To hide "Beta Tester" requests: add `beta tester` to **Custom Review Keywords**.

Each field accepts a comma-separated list of phrases. Matching is done in a simple "contains text" way, case-insensitive.

= Hooks for Developers =

You can filter the default keyword lists using these filters:

* `brosclad_promo_words` – filter the default promo words array.
* `brosclad_review_words` – filter the default review words array.

Example:

`add_filter( 'brosclad_promo_words', function( $words ) { $words[] = 'early bird'; return $words; } );`

== Screenshots ==

1. Cleaned-up dashboard with most promo boxes removed.
2. Settings page with simple toggles for which ads/nags to hide.
3. Advanced section with custom keyword lists.

== Changelog ==

= 1.1.1 =
* Fixed function prefix to meet WordPress.org requirements (changed from "caa" to "brosclad").
* Fixed CSS enqueuing to use wp_add_inline_style instead of inline styles.
* Updated JavaScript file name to match new prefix.
* Updated contributor username in readme.txt.

= 1.1.0 =
* Added text domain loading for translations.
* Added "Settings" link on Plugins page.
* Added activation notice with direct Settings link.
* Extended promo/review keyword lists and exposed filters.
* New options for custom promo/review keywords.
* Added "Reset to Defaults" button.
* Small performance improvements in JavaScript.

= 1.0.0 =
* Initial release – hide dashboard ads, plugin promos and review nags.

== Upgrade Notice ==

= 1.1.1 =
WordPress.org compliance update: Fixed function prefixes, proper CSS enqueuing, and contributor information. All settings will be preserved during update.

= 1.1.0 =
Translations, activation notice, settings link, advanced keyword controls, and performance improvements for a better admin clean-up experience. 

== Screenshots ==

1. Clean Admin settings page - choose which ads/nags to hide and add custom keywords