wpallstars/wp-fix-plugin-does-not-exist-notices
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 15 Wiki Activity
Files
0ced75f9b7930bdf1f785bd71f024b128832964c
wp-fix-plugin-does-not-exis…/assets/WORDPRESS_ORG_ASSETS.md
marcusquinn 009b67c0cc
Some checks failed
ci/woodpecker/push/woodpecker Pipeline is pending
Details
ci/woodpecker/tag/woodpecker Pipeline is pending
Details
Plugin Asset Update / Push assets to WordPress.org (push) Has been cancelled
Details
Build Release / Build and Create Release (push) Has been cancelled
Details
Build Release / Deploy to WordPress.org (push) Has been cancelled
Details
Deduplicate asset storage and update documentation
2025-04-13 14:49:29 +01:00

4.2 KiB
Raw Blame History

WordPress.org Plugin Submission Assets Guide

This document explains how to prepare and upload assets for WordPress.org plugin submission. This is the main reference document for all asset-related information.

WordPress.org SVN Repository Structure

When submitting a plugin to WordPress.org, you'll work with an SVN repository that has this structure:

/assets/         # Contains assets for the WordPress.org plugin page
    icon-256x256.png
    icon-128x128.png
    banner-772x250.png
    banner-1544x500.png
    screenshot-1.png
/tags/           # Contains tagged releases
    /1.6.27/
        [plugin files]
    /1.6.26/
        [plugin files]
/trunk/          # Contains the current version of the plugin
    [plugin files]

Right-to-Left (RTL) Support

For languages that read from right to left (like Hebrew and Arabic), you can provide RTL-specific versions of your assets by appending -rtl to the filename. For example:

  • banner-772x250-rtl.png
  • icon-256x256-rtl.png

Note: -rtl is specifically for Right-to-Left language support, not for dark theme versions.

Asset Requirements

Icon

  • Format: PNG
  • Sizes:
    • Required: 256x256 pixels (icon-256x256.png)
    • Optional: 128x128 pixels (icon-128x128.png)
  • Location: Upload to the /assets/ directory in the WordPress.org SVN repository
  • Status: ✅ READY - Files are in .wordpress-org/assets/

Banner

  • Format: PNG
  • Sizes:
    • Required: 772x250 pixels (banner-772x250.png)
    • Optional: 1544x500 pixels (banner-1544x500.png) for high-DPI displays
  • Location: Upload to the /assets/ directory in the WordPress.org SVN repository
  • Status: ✅ READY - Files are in .wordpress-org/assets/

Screenshots

  • Format: PNG
  • Naming: screenshot-1.png
  • Location: Upload to the /assets/ directory in the WordPress.org SVN repository
  • Status: ✅ READY - Files are in .wordpress-org/assets/

Submission Process

  1. Prepare Plugin Files:

    • Ensure all plugin files are ready in your local repository
    • Make sure version numbers are consistent across all files

  2. Prepare Assets:

    • Ensure all assets follow the naming conventions above
    • Verify that screenshots match the descriptions in readme.txt

  3. Upload to WordPress.org:

    • When you receive SVN access, use these commands:
    # Check out the repository
svn checkout https://plugins.svn.wordpress.org/fix-plugin-does-not-exist-notices/

# Copy plugin files to trunk
cp -r [your-local-plugin-files]/* fix-plugin-does-not-exist-notices/trunk/

# Copy assets to assets directory
cp .wordpress-org/assets/icon-256x256.png fix-plugin-does-not-exist-notices/assets/
cp .wordpress-org/assets/icon-128x128.png fix-plugin-does-not-exist-notices/assets/
cp .wordpress-org/assets/banner-772x250.png fix-plugin-does-not-exist-notices/assets/
cp .wordpress-org/assets/banner-1544x500.png fix-plugin-does-not-exist-notices/assets/
cp .wordpress-org/assets/screenshot-1.png fix-plugin-does-not-exist-notices/assets/

# Add new files
cd fix-plugin-does-not-exist-notices
svn add --force trunk/*
svn add --force assets/*

# Commit changes
svn commit -m "Initial plugin submission"

Image Conversion Tools

For converting SVG to PNG or creating different sizes of images, you can use:

  • Graphic Design Software:

    • Adobe Photoshop
    • Adobe Illustrator
    • Affinity Designer
    • Affinity Photo
    • GIMP (free, open-source)
    • Inkscape (free, open-source)
    • Pixelmator

  • Online Converters:

  • Command Line (using ImageMagick):

    # For 256x256 icon
convert -background none -size 256x256 assets/icon/icon.svg assets/icon/icon-256x256.png

# For 128x128 icon
convert -background none -size 128x128 assets/icon/icon.svg assets/icon/icon-128x128.png

Resources