=== Apex SEO Intelligence ===
Contributors: mixtapepsds, apexdigital
Tags: seo, google search console, analytics, dashboard, reporting
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Turn Google Search Console data into clear SEO priorities, optimization opportunities, and reporting inside WordPress.

== Description ==

Apex SEO Intelligence helps WordPress site owners understand what is working in organic search, where traffic is being lost, and which improvements deserve attention first.

Instead of forcing you to dig through raw Search Console tables, the plugin organizes your search performance into a focused WordPress dashboard. You can quickly see movement in clicks, impressions, click-through rate, average position, top pages, top queries, device trends, country performance, and priority opportunities.

The goal is simple: help you make better SEO decisions with less guesswork. Apex SEO Intelligence highlights pages that are gaining traction, keywords that may be close to ranking higher, content that could earn more clicks, and optimization work that can have a practical business impact.

The plugin connects to Google Search Console through a secure OAuth flow and keeps the experience inside WordPress, so teams can review search performance where they already manage content.

== Features ==

= Monitoring =

* Connects to Google Search Console for authorized properties.
* Tracks clicks, impressions, CTR, and average position.
* Includes 7, 30, and 90 day performance views.
* Shows top pages, top queries, device performance, and country trends.
* Provides visual performance charts for fast review.

= Optimization =

* Highlights quick-win SEO opportunities.
* Surfaces pages and queries that may benefit from CTR improvements.
* Prioritizes optimization tasks using rule-based insights.
* Helps identify content that is close to stronger search visibility.
* Provides an Action Center for recommended next steps.

= Business Intelligence =

* Adds an SEO Score for a quick health snapshot.
* Estimates organic search value and opportunity.
* Helps identify missed traffic and revenue potential.
* Connects SEO movement to business-focused decision making.
* Makes Search Console data easier for owners, marketers, and content teams to discuss.

= Reporting =

* Exports reports for review and planning.
* Organizes performance data into a WordPress-native dashboard.
* Provides concise views for regular SEO check-ins.
* Supports team workflows by keeping search insights close to content management.

== Installation ==

1. Install Apex SEO Intelligence from the WordPress Plugins screen, or upload the `apex-seo-intelligence` folder to `/wp-content/plugins/`.
2. Activate the plugin from Plugins > Installed Plugins.
3. Open Apex SEO Intelligence in the WordPress admin menu.
4. Choose Connect Google Search Console.
5. Sign in with the Google account that has access to your Search Console property.
6. Authorize the connection when prompted.
7. Return to WordPress and select the property you want to review.
8. Open the dashboard to review search performance, opportunities, and reports.

Before connecting, make sure your site is already verified in Google Search Console and that your Google account has permission to view the property.

== Frequently Asked Questions ==

= Do I need a Google Search Console account? =
Yes. This plugin requires a connected Google Search Console account.

= Do I need to verify my site with Google first? =
Yes. Your website should already be verified in Google Search Console before you connect the plugin.

= Which Google account should I use? =
Use the Google account that has access to the Search Console property you want to review.

= Why do I not see my property after connecting? =
Confirm that the connected Google account has Search Console access for the site. If the property was recently added or verified, wait a short time and refresh the connection.

= Does Apex SEO Intelligence create or edit Search Console data? =
No. The plugin reads authorized Search Console data and presents it in WordPress. It does not change your Google Search Console account.

= Does this plugin modify my site SEO automatically? =
No. The plugin provides insights and recommendations. You decide what changes to apply.

= Will the plugin slow down my website? =
The dashboard runs in the WordPress admin area and is designed to keep front-end impact minimal.

= Can multiple team members use the dashboard? =
Administrators and authorized WordPress users with the required permissions can review the dashboard from the WordPress admin area.

= Can I export my data? =
Yes. CSV and PDF export options are included.

= What should I do first after connecting? =
Start with the overview dashboard, then review Quick Wins, Top Pages, and Top Keywords to find practical improvements.

= Is historical data available immediately? =
The dashboard displays the Search Console data available for the connected property and selected date range.

= Can I disconnect the plugin? =
Yes. You can remove the connection from the plugin settings. Uninstalling the plugin also removes plugin-owned stored options.

== What's Coming ==

Future releases are planned to expand Apex SEO Intelligence with more advanced workflows while keeping the free plugin useful on its own.

Planned Pro-focused capabilities may include deeper automation, expanded reporting workflows, agency/client views, enhanced business intelligence, and advanced recommendation models.

These items are roadmap direction only. They are not required to use the current free plugin, and they are not included until officially released.

== External Services ==

This plugin connects to Google Search Console APIs to retrieve search performance and indexing data for sites authorized by the user.

Data transmitted:

* Authorized Google OAuth tokens
* Search Console property URLs
* Search Console query requests

Google Privacy Policy:
https://policies.google.com/privacy

Google Terms:
https://policies.google.com/terms

This plugin also connects to the Apex Digital OAuth Broker service to securely manage Google OAuth authentication.

Data transmitted:

* OAuth authorization codes
* OAuth refresh tokens
* Authentication requests

Privacy Policy:
https://apexdigital.design/privacy-policy/

Terms of Service:
https://apexdigital.design/terms-of-service/

== Screenshots ==

1. Dashboard overview with SEO score, traffic metrics, and performance trend charts.
2. Keyword intelligence view with top queries and opportunity scoring.
3. Page performance analysis with actionable Search Console insights.
4. Quick Wins panel showing prioritized SEO opportunities.
5. Revenue intelligence dashboard with estimated SEO value and lost opportunity analysis.
6. Device and country breakdown for organic search traffic.
7. Settings screen for connecting Google Search Console.

== Changelog ==

= 1.1.0 =
* Improved the WordPress.org description to focus on user outcomes and decision-making value.
* Reorganized features into Monitoring, Optimization, Business Intelligence, and Reporting categories.
* Expanded onboarding, setup, and troubleshooting FAQ content.
* Improved installation guidance for first-time Google Search Console users.
* Added a roadmap-safe What's Coming section.
* Added dashboard screenshots to the WordPress.org assets directory.

= 1.0.0 =
* Initial release
* Advanced analytics dashboard
* Revenue intelligence and opportunity tracking
* Action insights and action center
* Export functionality

== Upgrade Notice ==

= 1.1.0 =
Improves the WordPress.org listing presentation, onboarding guidance, FAQ coverage, and screenshot assets.

= 1.0.0 =
Initial release of Apex SEO Intelligence
