# WordPress.org Plugin Assets

This directory contains the assets for the WordPress.org plugin page.

## REQUIRED FILES

### Banner (IMPORTANT)
Header image displayed at the top of the plugin page

- **banner-772x250.png** (REQUIRED)
  - Size: 772 x 250 pixels
  - Format: PNG or JPG
  
- **banner-1544x500.png** (Optional, for Retina displays)
  - Size: 1544 x 500 pixels
  - Format: PNG or JPG

### Icon (IMPORTANT)
Plugin icon shown in search results and next to the plugin name

- **icon-128x128.png** (REQUIRED)
  - Size: 128 x 128 pixels
  - Format: PNG or JPG
  
- **icon-256x256.png** (Optional, for Retina displays)
  - Size: 256 x 256 pixels
  - Format: PNG or JPG

### Screenshots (Recommended)
Show how the plugin looks and works

- **screenshot-1.png** - Settings page with status
- **screenshot-2.png** - Schema.org JSON-LD in HTML
- **screenshot-3.png** - LLMO Ready Dashboard
- **screenshot-4.png** - Knowledge Pack Editor

**Format:** PNG or JPG (PNG recommended for screenshots)
**Size:** Maximum 1200px width recommended

## DESIGN GUIDELINES

### Banner
- **Background:** LLMO Ready brand color
- **Logo:** LLMO Ready logo prominently displayed
- **Text:** "AI-Optimized Schema Markup for WooCommerce"
- **Icons:** ChatGPT, Google, Perplexity logos (small)
- **Style:** Modern, clean, professional

### Icon
- **Base:** LLMO Ready logo
- **Background:** Transparent or brand color
- **Design:** Simple, recognizable even at small sizes
- **Colors:** Consistent with brand identity

### Screenshots
- **Quality:** High resolution, sharp
- **Content:** Real examples (no Lorem Ipsum)
- **Annotations:** Arrows/highlights for important features
- **Consistency:** Same style across all screenshots

## UPLOAD PROCESS

When all assets are ready:

```bash
cd /Users/mag/Documents/GitHub/llmo/llmoready-saas/wordpress-plugin
bash deploy-assets.sh
```

The script will:
1. Check out the SVN repository (assets branch)
2. Copy all files from this directory
3. Upload them to WordPress.org

## IMPORTANT NOTES

- **Filenames MUST be exact** (case-sensitive)
- **No special characters** in filenames
- **No spaces** in filenames
- **Optimize file size:** Banner < 500 KB, Screenshots < 200 KB
- **Test locally:** Open images and verify quality before upload

## DIRECTORY STRUCTURE

```
assets/
├── banner-772x250.png          Standard banner
├── banner-1544x500.png         Retina banner
├── icon-128x128.png            Standard icon
├── icon-256x256.png            Retina icon
├── screenshot-1.png            Settings page
├── screenshot-2.png            JSON-LD output
├── screenshot-3.png            Dashboard
└── screenshot-4.png            Knowledge Pack Editor
```

## RESOURCES

- **WordPress.org Assets Guide:** https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/
- **Canva (Design Tool):** https://www.canva.com
- **TinyPNG (Image Optimization):** https://tinypng.com
- **Screenshot Tool macOS:** Cmd+Shift+4

## AFTER UPLOAD

Assets will appear after 10-15 minutes on:
https://wordpress.org/plugins/llmo-schema-markup/

Cache can take up to 1 hour to fully refresh.