=== MobileRank - Mobile Performance Diagnostics ===
Contributors: outlawgt
Tags: seo, mobile, pagespeed, optimize, core web vitals
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Your mobile site is killing your SEO. MobileRank finds and fixes the issues Google is penalizing you for.

== Description ==

**Google ranks mobile-first. Is your WordPress site ready?**

MobileRank scans your pages using Google's PageSpeed Insights API and tells you exactly what's broken on mobile, why it's hurting your Google rankings, and gives you the code to fix it.

Your caching plugin makes your site fast. **MobileRank makes your mobile site fast *and* usable.**

= What MobileRank Does =

* **Scans your pages** at mobile viewport using Google PageSpeed Insights
* **Flags every issue** with plain-English explanations (not developer jargon)
* **Maps each issue to its SEO impact** so you know what to fix first
* **Provides copy-paste fixes** — CSS, HTML, and PHP snippets you can use immediately
* **Tracks Core Web Vitals** — LCP, CLS, and INP scores per page
* **Color-coded severity** — see at a glance what's critical vs. minor

= Issues MobileRank Detects =

* Layout shift (CLS) causing content to jump on mobile
* Oversized images served at desktop resolution on phones
* Missing lazy loading on off-screen images
* Tap targets too small or too close together
* Text too small to read without zooming
* Render-blocking CSS and JavaScript
* Missing or misconfigured viewport meta tag
* Unused CSS and JavaScript wasting bandwidth
* Slow Largest Contentful Paint (LCP)
* Missing text compression (gzip/brotli)
* And more...

= Who Is MobileRank For? =

* **Site owners** who see bad mobile PageSpeed scores but don't know why
* **Bloggers** dependent on Google organic traffic
* **WooCommerce store owners** losing mobile conversions
* **Freelancers & agencies** who need to diagnose and fix client sites

= How It Works =

1. Install and activate MobileRank
2. Click "Run Your First Scan"
3. MobileRank analyzes up to 10 pages using Google's PageSpeed Insights API
4. See your Mobile Health Score and every issue mapped to SEO impact
5. Click any issue to see the fix — copy, paste, done

= Free Version Includes =

* Scan up to 10 pages
* Full mobile performance diagnostics
* Core Web Vitals tracking (LCP, CLS, INP)
* SEO impact mapping for every issue
* Copy-paste fix suggestions
* Manual and scheduled scanning
* Clean, modern dashboard

== Installation ==

1. Upload the `mobilerank` folder to `/wp-content/plugins/`
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to the MobileRank menu item in your admin sidebar
4. Click "Run Your First Scan" to analyze your site

= Optional: Google API Key =

MobileRank works without an API key, but adding one increases scanning speed. Get a free key from the [Google Cloud Console](https://developers.google.com/speed/docs/insights/v5/get-started).

Enter your key in MobileRank → Settings → Google PageSpeed API Key.

== Frequently Asked Questions ==

= Does MobileRank slow down my site? =

No. MobileRank only runs in the WordPress admin dashboard. It doesn't add any code, scripts, or styles to your frontend. Visitors to your site are completely unaffected.

= How is this different from running PageSpeed Insights manually? =

PageSpeed Insights gives you raw technical data. MobileRank translates that into visual, actionable results with plain-English explanations and copy-paste fixes. It also tracks your scores over time and scans multiple pages at once.

= Does MobileRank replace my caching plugin? =

No. MobileRank works alongside your existing performance stack (WP Rocket, LiteSpeed Cache, etc.). Your caching plugin handles delivery optimization. MobileRank handles mobile responsiveness and usability issues that caching can't fix.

= Why is the free version limited to 10 pages? =

The Google PageSpeed Insights API has rate limits, and each page scan takes several seconds. 10 pages covers the most important pages on most small-to-medium sites (homepage, key landing pages, popular posts).

= Does it work with any theme? =

Yes. MobileRank is a diagnostic tool that works with any WordPress theme. The fix suggestions are universal CSS/HTML/PHP solutions that apply regardless of your theme.

== Screenshots ==

1. Mobile Health Score — Your overall mobile performance score with Core Web Vitals (LCP, CLS, INP)
2. Mobile Preview — See your site in a phone frame with issues highlighted directly on the page
3. Scanned Pages — Per-page scores with SEO impact, status, and device switching
4. Image Audit — Find missing alt text, oversized images, and non-WebP formats (no API key required)
5. Content Scanner — Detect unresponsive tables, hardcoded widths, and mobile-breaking patterns (no API key required)
6. Mobile Readiness Checklist — Security, SEO, and Mobile UX checks with pass/fail results
7. Performance Checks — JavaScript count, CSS count, jQuery Migrate, and plugin impact analysis

== External Services ==

This plugin connects to the Google PageSpeed Insights API to analyze the mobile performance of your website pages.

= Google PageSpeed Insights API =

* **What it does:** Runs Google Lighthouse audits on your pages to measure mobile performance, Core Web Vitals (LCP, CLS, INP), and detect mobile usability issues.
* **When data is sent:** Only when you manually click "Run Scan" or when a scheduled scan runs (if configured). No data is sent automatically on plugin activation or page load.
* **What data is sent:** The public URL of the page being scanned. No personal data, cookies, or user information is transmitted.
* **Service provider:** Google LLC
* **Terms of Service:** [Google APIs Terms of Service](https://developers.google.com/terms)
* **Privacy Policy:** [Google Privacy Policy](https://policies.google.com/privacy)

The standalone features (Image Audit, Mobile Readiness Checklist, and Content Scanner) run entirely on your server and do not connect to any external services.

== Changelog ==

= 1.0.0 =
* Initial release
* Google PageSpeed Insights API integration
* Mobile Health Score dashboard
* Core Web Vitals tracking (LCP, CLS, INP)
* 15+ issue types with fix suggestions
* Image Audit — find missing alt text, oversized images, non-WebP formats (no API key required)
* Mobile Readiness Checklist — 12 instant server-side checks (no API key required)
* Content Scanner — detect unresponsive tables, hardcoded widths, missing image dimensions (no API key required)
* Pages list with scores and SEO impact
* Mobile Preview with device switching
* One-click Quick Fixes for common issues
* Email scan reports
* Onboarding wizard with Mobi mascot
* Settings with API key and scan scheduling

== Upgrade Notice ==

= 1.0.0 =
Initial release. Scan your site and find out what's hurting your mobile SEO.
