Files
wp-fix-plugin-does-not-exis…/assets/WORDPRESS_ORG_SUBMISSION.md
Marcus Quinn 5049557e04
Some checks failed
Build Release / Build and Create Release (push) Has been cancelled
Build Release / Deploy to WordPress.org (push) Has been cancelled
ci/woodpecker/push/woodpecker Pipeline failed
ci/woodpecker/tag/woodpecker Pipeline failed
Consolidate asset documentation and clarify RTL support (v1.6.28)
2025-04-12 19:50:23 +01:00

2.6 KiB

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 in assets/icon/icon.svg
  • PNG files created in assets/icon/icon-256x256.png and assets/icon/icon-128x128.png

Banner

  • Both sizes available in assets/banner/
  • Properly named files: banner-772x250.png and banner-1544x500.png

Screenshots

  • One screenshot available in assets/screenshots/screenshot-1.png
  • Screenshot description in readme.txt updated to reference only one screenshot

SVN Directory Structure

When submitting to WordPress.org, your SVN repository will have this structure:

/assets/
    icon-256x256.png
    icon-128x128.png
    banner-772x250.png
    banner-1544x500.png
    screenshot-1.png
/tags/
    /1.6.27/
        [plugin files]
    /1.6.26/
        [plugin files]
/trunk/
    [current plugin files]

Action Items

  1. Ensure all files follow the proper naming convention
  2. Upload all assets to the WordPress.org SVN repository in the /assets directory using these commands:
# Copy assets to WordPress.org SVN assets directory
cp assets/icon/icon-256x256.png /path/to/wordpress-svn/assets/
cp assets/icon/icon-128x128.png /path/to/wordpress-svn/assets/
cp assets/banner/banner-772x250.png /path/to/wordpress-svn/assets/
cp assets/banner/banner-1544x500.png /path/to/wordpress-svn/assets/
cp assets/screenshots/screenshot-1.png /path/to/wordpress-svn/assets/

Resources