wpallstars/wp-fix-plugin-does-not-exist-notices
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 15 Wiki Activity
Files
f4e09e02872cc3494c544906c5fb289282e1e204
wp-fix-plugin-does-not-exis…/.wordpress-org/WORDPRESS_ORG_ASSETS.md

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
    /2.2.3/
        [plugin files]
    /2.2.2-stable/
        [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

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/wp-fix-plugin-does-not-exist-notices/

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

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

# Add new files
cd wp-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 .wordpress-org/assets/icon.svg .wordpress-org/assets/icon-256x256.png

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

Resources