# Pixellize Site Issue Scanner

Pixellize Site Issue Scanner is a powerful SEO and site health auditor. It crawls your site to fix broken links, missing meta tags, and unoptimized images.

## ✨ 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.

### 🔗 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.
- **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:
- **Performance Tuning**: Adjust concurrent requests, timeouts, and crawl delays to prevent server strain.
- **Selective Scanning**: Filter by Post Type and Post Status to focus your audits.

---

## 📦 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 **Pixellize Site Issue Scanner** menu item.

---

## 📜 Changelog

### 0.1 (Current)
*   **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.

---

**Developed with ❤️ by [Pixellize](https://pixellize.com)**