=== Pixellize Site Issue Scanner ===
Contributors: shubhamralli91
Tags: seo, audit, broken links, image optimization, crawler
Requires at least: 5.0
Tested up to: 6.9
Stable tag: 0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Text Domain: pixellize-site-issue-scanner

Powerful SEO auditor by Pixellize. Crawls your site to fix broken links, missing meta tags, and unoptimized images.

== Description ==

Pixellize Site Issue Scanner is a comprehensive toolkit designed to improve your website's health and search engine performance. By performing deep site audits, it identifies critical issues that impact user experience and search rankings.

= ✨ Core Capabilities =

== 🔍 Precision SEO Audit ==

Audit your site's structural SEO with deep inspection of every page:

- Meta Tag Integrity: Detects missing, short, or excessively long Meta Titles and Descriptions.
- Heading Hierarchy: Flags missing H1 tags, multiple H1 tags, and skipped heading levels.
- Indexation Monitoring: Identifies pages hidden from search engines via noindex tags.
- Sitemap Verification: Robust multi-method check for sitemap.xml, sitemap_index.xml, and robots.txt entries.
- Canonical Tag Audit: Detects pages missing a canonical link tag, pages with multiple conflicting canonical tags, and canonicals pointing to a different page or cross-domain URL. One-click Edit Canonical popup writes to Yoast, Rank Math, AIOSEO, and SEO Framework.
- Open Graph + Twitter Card Audit: Flags missing og:title, og:image, twitter:card, twitter:image. Detects og:image dimensions below the recommended 1200x630 (uses declared meta tags or fetches the image once and caches the result).

== 🔗 Link & Asset Guardian ==

Maintain a seamless browsing experience by staying ahead of broken assets:

- Internal & External Links: Validates every link on your site, identifying 404 errors and unreachable URLs.
- Redirect Mapping: Flags 301/302 redirects to help you minimize "hops" and save crawl budget.
- Critical Asset Health: Monitors JavaScript, CSS, and Iframes for availability and load errors.
- External Link Best Practices: Identifies external links missing target="_blank" or security attributes.

== 🖼️ Image Optimization ==

Ensure your visual content is fast and accessible:

- Broken Image Detection: Finds images that fail to load from your server or external CDNs.
- Accessibility Check: Flags missing alt attributes critical for screen readers and SEO.
- Missing Dimensions: Detects images without width/height attributes to prevent Layout Shifts (CLS).
- Oversized Assets: Highlights images exceeding 250KB that slow down page loads.

== 🚀 Pro Actionable Fixes ==

Pixellize Site Issue Scanner doesn't just find problems; it helps you fix them in seconds:

- Integrated Meta Editor: Edit Meta Titles and Descriptions across your site with real-time character counting. Syncs automatically with Yoast, Rank Math, AIOSEO, and more.
- Bulk Find & Replace: Safely replace broken URLs across post content, meta fields, and serialized option data.
- One-Click "target='_blank'": Automatically update external links to open in a new tab.
- Auto-Dimension Fixer: Intelligent tool that fetches image files, determines their true size, and injects missing width/height attributes into your HTML.
- Noindex Removal: Quickly toggle off the noindex tag for pages that should be visible to search engines.

== 📊 Intelligent Dashboard ==

- Site Health Score: A bird's-eye view of your website's overall health and SEO readiness.
- Real-Time Crawling: Watch the crawler navigate your site asynchronously, with the ability to pause and resume.
- Resume After Crash: Crawl progress is persisted in the database, so a closed tab or page reload won't lose your scan. A resume banner appears on return with a single click to continue.
- Diff Between Scans: Each report shows how many issues are new and how many were fixed since the previous scan, so you can track progress at a glance.
- Issue Breakdown: Categorized reports with specific "How to Fix" guidance for every error or warning.
- Crawl History: Save and manage multiple scan batches to compare site health over time.
- CSV Export: Take your data anywhere with professional CSV reports of all identified issues.

== ⚙️ Advanced Configuration ==

Fine-tune the engine to match your server's capabilities:
- Selective Scanning: Filter by Post Type and Post Status to focus your audits.
- Max Pages to Crawl: Cap the number of pages per scan to control server load.

== Installation ==

1. Upload the `pixellize-site-issue-scanner` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Access the dashboard via the **Site Problems** menu item.

== Changelog ==

= 0.4 =

New SEO checks:
* Canonical Tag Audit detects missing, conflicting, or mismatched canonical link tags. One-click Edit Canonical popup writes to Yoast, Rank Math, AIOSEO, and SEO Framework.
* Open Graph and Twitter card audit. Flags missing og:title, og:image, twitter:card, twitter:image, and og:image dimensions below the recommended 1200x630.

New crawl reliability and reporting:
* Resume After Crash. Crawl state is saved to the database every few pages, so a closed tab or page reload shows a Resume banner instead of losing progress.
* Diff Between Scans. Each report shows how many issues are new and how many were fixed since the previous scan.
* Live elapsed-time timer in the crawl progress area.
* Crawl duration shown on Dashboard Recent Reports.
* Bulk select with Delete Selected on Settings page Report Management.
* Top-of-page review prompt linking to wordpress.org reviews. Dismissible per user.

Faster crawl:
* URL list cached 5 minutes so repeat scans start instantly.
* Sitemap presence detection moved to a non-blocking background call. HEAD checks replace full GET so the first scan no longer waits on slow responses.
* Issues are buffered per page and written with a single multi-row INSERT.
* Asset and link timeouts shortened to 8-10 seconds so slow targets fail fast.
* Well-known reliable CDNs (Google Fonts, jsDelivr, cdnjs, jQuery CDN, Bootstrap CDN, Font Awesome, Gravatar, etc.) skipped from broken-status checks.

UI:
* Drill-down report header shows the current issue title and subtitle with a back button on the right.
* Recent Reports rendered as a clean table on the Dashboard.
* How-to-Fix guide moved above the report wrap.
* Find and Replace modal header changed from purple gradient to solid black.
* Start Full Scan and Stop buttons toggle visibility (no more greyed-out states).
* Crawl status text hidden in favor of timer and page-count indicators.

Fixes and removals:
* Pages with a noindex tag are no longer flagged for missing canonical.
* Crawl Mode setting removed (plugin always runs Full Crawl).
* Delete All Data Forever Danger Zone removed (bulk select replaces it).
* Export CSV button and Duration column removed from Settings Report Management table.

= 0.3 =
* Fix: Bug fixes and stability improvements.

= 0.2 =
* UI/UX: Full flat-design overhaul — 4-card stats grid; redesigned report tables, modals, and drill-down pages.
* UI/UX: Toast notifications replace old inline alerts; Recent Reports show date + time.
* UI/UX: Pixellize branding footer added to all admin pages.
* Feature: Configurable Max Pages to Crawl; Settings page redesigned with Post Types (Posts & Pages) and Post Statuses (Publish, Draft, Private) options.
* Feature: Add Alt Text updates all pages/posts where the image is used and skips images that already have alt text.
* Feature: Issues count in Report Management shows only errors, matching Dashboard numbers exactly.
* Fix: Site Health Score no longer shows 0 — uses correct formula and scanned-page denominator.
* Fix: Dashboard Recent Reports now shows correct data and scores for each batch.
* Fix: CSV export corruption resolved; nonce verification added.
* Fix: Relative internal links no longer cause false 404 reports.

= 0.1 =
* Initial Release: Re-imagined crawler engine with high-precision DOM parsing.
* New: Robust Sitemap detection (XML + Robots.txt fallback).
* New: One-click "External Link Target" fixer.
* New: Automated Image Dimension resolution.
* New: Direct Meta tag editing with SEO plugin sync.

== Upgrade Notice ==

= 0.4 =
Major release. Adds Canonical Tag Audit with one-click fix, Open Graph and Twitter card checks, Resume After Crash, scan-to-scan diff tracking, faster crawl startup, live timer, bulk-delete on Report Management, and a refreshed report UI. Recommended for all users.

= 0.2 =
Major UI/UX overhaul with flat design, improved Health Score accuracy, accurate issue counting, Add Alt Text across all pages, false 404 prevention, configurable crawl limit, and multiple bug fixes. Recommended for all users.

= 0.1 =
Initial release of Pixellize Site Issue Scanner.
