# My Creative SEO (AEO + Readability) - Installation Guide

## Quick Start

### Automatic Installation (Recommended)
1. Log into your WordPress admin dashboard
2. Navigate to **Plugins → Add New**
3. Search for "My Creative SEO"
4. Click "Install Now" then "Activate"
5. You're ready to go!

### Manual Installation
1. Download the plugin ZIP file
2. Go to **Plugins → Add New → Upload Plugin**
3. Choose the ZIP file and click "Install Now"
4. Click "Activate Plugin"

## First Steps After Installation

### 1. Configure Global Settings
- Go to **My Creative SEO → Settings**
- Set up your title templates
- Configure your organization/personal information
- Set a default social media image

### 2. Start Optimizing Content
- Edit any post or page
- Look for the "My Creative SEO" meta box (Classic Editor) or sidebar panel (Gutenberg)
- Add your SEO title, meta description, and focus keyphrase
- Watch the live recommendations update as you type

### 3. Use the Analyzer Tool
- Go to **My Creative SEO → Analyzer**
- Enter your domain name to get a comprehensive SEO audit
- Review the recommendations and implement improvements

### 4. Bulk Edit SEO (Optional)
- Go to **Tools → Bulk SEO Editor**
- Quickly update SEO titles and descriptions for multiple posts
- Focus on the most recently updated content first

## Plugin Structure

```
my-creative-seo/
├── my-creative-seo.php     # Main plugin file
├── readme.txt              # WordPress.org readme
├── assets/                 # JavaScript, CSS, and images
│   ├── editor.js          # Gutenberg integration
│   ├── editor.css         # Admin styles
│   ├── icon-256x256.png   # Plugin icon
│   └── mc-logo.png        # Brand logo
├── includes/               # Additional PHP classes
│   └── analyzer.php       # Content analysis engine
└── languages/              # Translation files
    └── my-creative-seo.pot # Translation template
```

## Key Features Overview

### Content Optimization
- **SEO Titles & Meta Descriptions**: Full control over how your content appears in search results
- **Focus Keyphrase Analysis**: Real-time content analysis with actionable recommendations
- **Readability Scoring**: Ensure your content is easy to read and understand
- **Cornerstone Content**: Mark your most important content for stricter analysis

### Gutenberg Integration
- **Live Analysis**: See SEO recommendations update as you type
- **Snippet Preview**: Preview how your content will look in search results
- **Traffic Light System**: Quick visual indicators for SEO performance
- **Sidebar Panel**: All SEO tools accessible from the editor sidebar

### Technical SEO
- **Schema Markup**: Automatic JSON-LD structured data
- **Social Media Tags**: Open Graph and Twitter Card optimization
- **Breadcrumbs**: SEO-friendly navigation with schema markup
- **Meta Tags**: Complete control over all meta elements

### Site-Wide Tools
- **Content Analyzer**: Comprehensive SEO audit for entire websites
- **Bulk Editor**: Efficiently manage SEO settings across multiple posts
- **Template System**: Consistent title formats across your site
- **REST API**: Programmatic access for headless WordPress setups

## System Requirements

- **WordPress**: 5.0 or higher
- **PHP**: 7.4 or higher
- **Browser**: Modern browser with JavaScript enabled

## Optional Enhancements

### Playwright Integration (Advanced)
For JavaScript-heavy sites, you can configure a Playwright microservice for more accurate content analysis:

1. Add this to your `wp-config.php`:
   ```php
   define('MC_RENDER_URL', 'http://localhost:8787/render');
   ```

2. This enables the analyzer to properly evaluate single-page applications and sites with dynamic content.

## Troubleshooting

### Common Issues

**Q: The Gutenberg sidebar doesn't appear**
A: Make sure you're using the Block Editor and have JavaScript enabled. The sidebar appears in the right panel.

**Q: Meta tags aren't showing in the source code**
A: Check that you don't have another SEO plugin active that might be conflicting.

**Q: The analyzer returns errors**
A: Ensure the target website is accessible and not blocking requests. Some sites may have security measures in place.

**Q: Translations aren't loading**
A: Check that the `/languages/` directory exists and contains the appropriate translation files.

### Performance Considerations

- The plugin is lightweight and optimized for performance
- Content analysis happens client-side in the editor
- External analysis (via the Analyzer tool) requires network requests
- For large sites, use the bulk editor in batches

## Support & Documentation

- **Documentation**: [mycreativeplan.com/docs/my-creative-seo](https://mycreativeplan.com/docs/my-creative-seo)
- **Support Forums**: [WordPress.org Support](https://wordpress.org/support/plugin/my-creative-seo/)
- **Contact**: [mycreativeplan.com/contact](https://mycreativeplan.com/contact)

## Contributing

My Creative SEO is open source software. If you'd like to contribute:

1. Report bugs or suggest features via the support forums
2. Translate the plugin into your language
3. Share your optimization tips and best practices

## License

My Creative SEO is licensed under the GPL v2 or later. You're free to use, modify, and distribute it according to the terms of the GNU General Public License.