# .wordpress-org/ — WP.org plugin page assets

Files here are copied to `plugins.svn.wordpress.org/printcart-integration/assets/` by `10up/action-wordpress-plugin-deploy` on every tagged release. They render on the plugin's wordpress.org page (banner, icon, screenshots).

## ⚠️ Never empty this folder

If `.wordpress-org/` contains only placeholder files (`.gitkeep`, `README.md`) and no real assets, the 10up action **mirrors that state to SVN** — every real banner, icon, and screenshot on wp.org gets deleted. This happened on the 2.5.3 deploy; recovery took a manual SVN cp per file from an older revision. Don't repeat it.

Rules:

- If you want to update the banner or icon, replace the file here and let the next release copy it up.
- If you don't want to touch assets on this release, keep every file below in place.
- Never commit only a `.gitkeep` here.

## Current files (must all exist)

| File | Purpose | Size |
|---|---|---|
| `icon-256x256.png` | Grid icon (large / retina) | 256 × 256 |
| `icon-128x128.png` | Grid icon (standard) | 128 × 128 |
| `icon.svg` | Vector icon (used when browser supports it) | any |
| `banner-1544x500.gif` | Page header, retina | 1544 × 500 |
| `banner-772x250.gif` | Page header, standard | 772 × 250 |
| `screenshot-1.jpg` … `screenshot-10.jpg` | Screenshots — order matches `== Screenshots ==` in `readme.txt` | ≤ 1200 × 900 recommended |

## Adding a screenshot

1. Add it here as `screenshot-<n>.jpg` (or `.png`) — must be the next number in the sequence.
2. Add a matching line under `== Screenshots ==` in `readme.txt` at the same position.
3. Commit both together.

## References

- Guidelines: https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/
- Deploy action: https://github.com/10up/action-wordpress-plugin-deploy#assets
- Recovery playbook if this folder was accidentally emptied: `docs/SVN-DEPLOY-TROUBLESHOOTING.md` § "Restoring wiped assets"
