Prepare assets for WordPress.org plugin submission (v1.6.23)

2025-04-12 18:58:26 +01:00
parent c6687eebcc
commit 120363da0b
18 changed files with 168 additions and 4 deletions
--- a/assets/WORDPRESS_ORG_SUBMISSION.md
+++ b/assets/WORDPRESS_ORG_SUBMISSION.md
@ -0,0 +1,76 @@
+# WordPress.org Plugin Submission Assets Guide
+
+This document outlines the requirements for assets when submitting a plugin to the WordPress.org plugin repository.
+
+## Asset Requirements
+
+### Icon
+
+- **Format**: PNG
+- **Size**: 256x256 pixels
+- **Filename**: `icon-256x256.png`
+- **Location**: SVN `/assets` directory (not included in the plugin zip)
+- **Optional**: You can also include `icon-128x128.png` for backward compatibility
+
+### Banner
+
+- **Format**: PNG
+- **Sizes**:
+  - Regular: 772x250 pixels (`banner-772x250.png`)
+  - High-DPI: 1544x500 pixels (`banner-1544x500.png`)
+- **Location**: SVN `/assets` directory (not included in the plugin zip)
+
+### Screenshots
+
+- **Format**: PNG
+- **Naming**: Sequential numbers (`screenshot-1.png`, `screenshot-2.png`, etc.)
+- **Location**: SVN `/assets` directory (not included in the plugin zip)
+- **Important**: The number and order must match the descriptions in the `readme.txt` file
+
+## Current Status
+
+### Icon
+- ✅ SVG source available
+- ❌ Need to create `icon-256x256.png` from the SVG
+
+### Banner
+- ✅ Both sizes available
+- ✅ Properly renamed versions created in `assets/banner-png/`
+
+### Screenshots
+- ❌ Only 1 of 3 referenced screenshots available
+- ❌ Need to create `screenshot-2.png` and `screenshot-3.png`
+- ✅ Properly renamed version of the first screenshot created in `assets/screenshots-png/`
+
+## SVN Directory Structure
+
+When submitting to WordPress.org, your SVN repository will have this structure:
+
+```
+/assets/
+    icon-256x256.png
+    banner-772x250.png
+    banner-1544x500.png
+    screenshot-1.png
+    screenshot-2.png
+    screenshot-3.png
+/tags/
+    /1.0.0/
+        [plugin files]
+    /1.0.1/
+        [plugin files]
+/trunk/
+    [current plugin files]
+```
+
+## Action Items
+
+1. Convert the SVG icon to a 256x256 PNG file
+2. Create the missing screenshots (2 and 3)
+3. Ensure all files follow the proper naming convention
+4. Upload all assets to the WordPress.org SVN repository in the `/assets` directory
+
+## Resources
+
+- [WordPress Plugin Developer Handbook - Plugin Assets](https://developer.wordpress.org/plugins/wordpress-org/plugin-assets/)
+- [WordPress Plugin Directory README.txt Standard](https://developer.wordpress.org/plugins/wordpress-org/how-your-readme-txt-works/)