=== Wildebeest Easy Reviews ===
Contributors: sanax65
Tags: google reviews, review button, google business, app store, google play
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 2.2.7
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add Google Business, Google Play, and App Store review buttons with smart mobile routing, popups, and local analytics.

== Description ==

Wildebeest Easy Reviews helps site owners send visitors to the right review destination without requiring a paid service or API key.

Supported destinations:

* Google Business
* Google Play
* Apple App Store

Features:

* Shortcode: `[wildebeest_reviews_reviews]`
* Show all configured destinations or use smart device routing
* Upload custom platform images through the WordPress Media Library
* Images-only, image-and-text, cards, and text-only layouts
* Left, center, and right alignment
* Responsive mobile stacking
* Same-tab, new-tab, and native-app-preferred link behavior
* Optional popup after a selected number of visits
* “Maybe Later” delay
* Never ask again after a destination is clicked
* Local click analytics
* First-run setup wizard
* Built-in Help page
* Import and export settings
* Reset settings and statistics
* No external telemetry

Easy Reviews stores its settings and click counters only in the site’s own WordPress database.

== Installation ==

1. Upload the plugin ZIP through Plugins > Add New > Upload Plugin.
2. Activate Wildebeest Easy Reviews.
3. Complete the setup wizard.
4. Add `[wildebeest_reviews_reviews]` to any page, post, or shortcode block.

== Frequently Asked Questions ==

= Do I need a Google API key? =

No. Paste the direct Google Business review-request link from the business profile.

= Does the plugin verify whether a visitor completed a review? =

No. Google and Apple do not provide completion information to the website. The optional “never ask again” setting treats a click as completed on that device.

= Does this plugin send analytics to Wildebeest Marketing? =

No. Click counters remain in the site’s own WordPress database.

= Are platform images included? =

No. Site owners upload artwork they are authorized to use and should follow each platform’s brand guidelines.


== Screenshots ==

1. Easy Reviews settings page.
2. First-run setup wizard.
3. Platform review choices with uploaded images.
4. Smart mobile review button.
5. Popup review prompt.
6. Import, export, reset, and local analytics controls.

== Changelog ==

= 2.2.7 =
* Replaced the temporary wildeare prefix with the permanent wildebeest_reviews prefix.
* Updated functions, constants, options, transients, nonces, AJAX actions, settings groups, and JavaScript globals.
* Replaced the shortcode with [wildebeest_reviews].
* Added migration support for both easy_reviews and wildeare legacy option names.
* No visual or feature changes.

= 2.2.6 =
* Replaced the generic shortcode with the unique [wildebeest_reviews_reviews] shortcode.
* Updated the setup wizard, Help page, Quick Start instructions, and readme documentation.
* Removed the generic shortcode registration completely.
* No other functional or visual changes.

= 2.2.5 =
* Added sanax65 to Contributors.
* Replaced generic internal identifiers with the unique WILDEARE / wildeare prefix.
* Renamed options, transients, nonces, AJAX actions, callbacks, and JavaScript globals.
* Added migration for settings and statistics from earlier builds.
* Preserved the public [wildebeest_reviews_reviews] shortcode.

= 2.2.4 =
* Corrected the placement of the final two Plugin Check annotations.
* Kept upload-array validation and field-by-field settings sanitization unchanged.
* No functional or visual changes.

= 2.2.3 =
* Resolved the final two Plugin Check input-validation warnings.
* Documented the safe handling of the WordPress upload array.
* Documented the field-by-field sanitization of imported setup settings.
* No functional or visual changes.

= 2.2.2 =
* Resolved all issues from the WordPress Plugin Check report.
* Added safer nonce-aware request handling.
* Improved JSON import validation, unslashing, and sanitization.
* Escaped generated destination markup before output.
* Removed the discouraged manual translation loader.
* Updated Tested up to to WordPress 7.0.
* Reduced tags to the five-tag directory limit.
* Shortened the directory short description to fewer than 150 characters.
* Prefixed the uninstall variable.
* No feature changes.

= 2.2.1 =
* Removed both optional Plugin URI and Author URI headers to prevent submission-form URI comparison errors.
* Corrected the internal version constant to 2.2.1.
* No functional changes.

= 2.2.0 =
* Renamed the public plugin to Wildebeest Easy Reviews.
* Removed the Plugin URI header because it matched the Author URI.
* Kept the Wildebeest Marketing Author URI.
* Updated the plugin folder, main file, text domain, admin slugs, and documentation.
* Preserved all existing functionality and settings.

= 2.1.0 =
* Completed full Easy Reviews branding cleanup.
* Removed the old shortcode and all former naming from the public plugin.
* Standardized the admin slug, internal prefixes, database option names, CSS classes, JavaScript namespace, and documentation.
* Renamed the plugin folder and primary file to the clean Easy Reviews slug.
* Preserved all Version 2.0 features.

= 2.0.0 =
* Renamed and rebranded as Wildebeest Easy Reviews.
* Changed developer branding to Wildebeest Marketing.
* Added GPL-2.0-or-later metadata and public-release documentation.
* Added first-run setup wizard.
* Added built-in Help page.
* Added settings export and import.
* Added reset settings and reset statistics controls.
* Added optional data deletion on uninstall.
* Added new `[wildebeest_reviews_reviews]` shortcode.
* Preserved review links, platform images, popup controls, smart routing, native-app behavior, and analytics.

== Upgrade Notice ==

= 2.2.4 =
Final Plugin Check annotation correction; no feature changes.

= 2.2.3 =
Final WordPress Plugin Check cleanup; no feature changes.

= 2.2.2 =
WordPress Plugin Check compliance and submission-readiness update.

= 2.2.1 =
Submission metadata correction only; no functional changes.

= 2.2.0 =
WordPress.org submission build with corrected plugin identity and URI metadata.

= 2.1.0 =
Final branding-cleanup release before WordPress.org submission.

= 2.0.0 =
Public-release candidate with new branding, onboarding, documentation, and management tools.
