diff --git a/CHANGELOG.md b/CHANGELOG.md index a76489a..74af8ae 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,15 @@ All notable changes to this project will be documented in this file. +## [1.6.25] - 2024-05-17 +### Added +- Comprehensive WordPress.org submission guide with SVN structure explanation + +### Changed +- Consolidated asset files into their respective directories +- Clarified asset requirements and submission process +- Improved organization of asset files + ## [1.6.24] - 2024-05-17 ### Added - Properly named icon PNG files (icon-256x256.png and icon-128x128.png) diff --git a/README.md b/README.md index 6137ac0..81140aa 100644 --- a/README.md +++ b/README.md @@ -160,6 +160,12 @@ The plugin works by: ## Changelog +### 1.6.25 +* Consolidated asset files into their respective directories +* Created comprehensive WordPress.org submission guide +* Clarified SVN repository structure and asset requirements +* Improved organization of asset files + ### 1.6.24 * Added properly named icon PNG files for WordPress.org submission * Created icon-256x256.png and icon-128x128.png files diff --git a/assets/WORDPRESS_ORG_ASSETS.md b/assets/WORDPRESS_ORG_ASSETS.md new file mode 100644 index 0000000..5818783 --- /dev/null +++ b/assets/WORDPRESS_ORG_ASSETS.md @@ -0,0 +1,96 @@ +# WordPress.org Plugin Submission Assets Guide + +This document explains how to prepare and upload assets for WordPress.org plugin submission. + +## 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 + screenshot-2.png + screenshot-3.png +/tags/ # Contains tagged releases + /1.0.0/ + [plugin files] + /1.0.1/ + [plugin files] +/trunk/ # Contains the current version of the plugin + [plugin files] +``` + +## 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 `assets/icon/` + +### 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 `assets/banner/` + +### Screenshots + +- **Format**: PNG +- **Naming**: Sequential numbers (`screenshot-1.png`, `screenshot-2.png`, etc.) +- **Location**: Upload to the `/assets/` directory in the WordPress.org SVN repository +- **Status**: ⚠️ PARTIALLY READY + - `screenshot-1.png` is available in `assets/screenshots/` + - Need to create `screenshot-2.png` and `screenshot-3.png` to match readme.txt descriptions + +## 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: + ```bash + # 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 assets/icon/icon-256x256.png fix-plugin-does-not-exist-notices/assets/ + cp assets/icon/icon-128x128.png fix-plugin-does-not-exist-notices/assets/ + cp assets/banner/banner-772x250.png fix-plugin-does-not-exist-notices/assets/ + cp assets/banner/banner-1544x500.png fix-plugin-does-not-exist-notices/assets/ + cp assets/screenshots/screenshot-1.png fix-plugin-does-not-exist-notices/assets/ + cp assets/screenshots/screenshot-2.png fix-plugin-does-not-exist-notices/assets/ + cp assets/screenshots/screenshot-3.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" + ``` + +## 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/) diff --git a/assets/banner-png/README.md b/assets/banner-png/README.md index 7836065..29690d3 100644 --- a/assets/banner-png/README.md +++ b/assets/banner-png/README.md @@ -8,4 +8,4 @@ For WordPress.org plugin submission, you need: - `banner-1544x500.png` (for high-resolution/retina displays) 3. Place them in the root of your SVN assets directory -These files have been properly renamed from the original files to match WordPress.org requirements. +These files have been renamed from the original files to match WordPress.org's naming-convention and file format requirements. diff --git a/assets/banner/fix-plugin-does-not-exist-notices-banner-1544x500.png b/assets/banner/banner-1544x500.png similarity index 100% rename from assets/banner/fix-plugin-does-not-exist-notices-banner-1544x500.png rename to assets/banner/banner-1544x500.png diff --git a/assets/banner/fix-plugin-does-not-exist-notices-banner-772x250.png b/assets/banner/banner-772x250.png similarity index 100% rename from assets/banner/fix-plugin-does-not-exist-notices-banner-772x250.png rename to assets/banner/banner-772x250.png diff --git a/assets/icon-png/README.md b/assets/icon-png/README.md index 3c91003..158dbb6 100644 --- a/assets/icon-png/README.md +++ b/assets/icon-png/README.md @@ -3,8 +3,8 @@ For WordPress.org plugin submission, you need to: 1. Convert the SVG icon to PNG format -2. Create a 256x256 pixel version -3. Name it `icon-256x256.png` +2. Create a 256x256 and 128x128 pixel version +3. Name them `icon-256x256.png` and `icon-128x128.png` 4. Place it in the root of your SVN assets directory ## How to Convert @@ -12,7 +12,11 @@ For WordPress.org plugin submission, you need to: You can use tools like: - Inkscape (free, open-source) - Adobe Illustrator +- Adobe Photoshop +- Affinity Designer +- Affinity Photo - GIMP +- Pixelmator - Online converters like https://svgtopng.com/ ## Command Line Conversion (if you have ImageMagick installed) diff --git a/assets/icon-png/fix-plugin-does-not-exist-notices-icon-128x128.png b/assets/icon/icon-128x128.png similarity index 100% rename from assets/icon-png/fix-plugin-does-not-exist-notices-icon-128x128.png rename to assets/icon/icon-128x128.png diff --git a/assets/icon-png/fix-plugin-does-not-exist-notices-icon-256x256.png b/assets/icon/icon-256x256.png similarity index 100% rename from assets/icon-png/fix-plugin-does-not-exist-notices-icon-256x256.png rename to assets/icon/icon-256x256.png diff --git a/assets/icon/fix-plugin-does-not-exist-notices-icon.svg b/assets/icon/icon.svg similarity index 100% rename from assets/icon/fix-plugin-does-not-exist-notices-icon.svg rename to assets/icon/icon.svg diff --git a/assets/screenshots-png/README.md b/assets/screenshots-png/README.md index 99f0553..25320a7 100644 --- a/assets/screenshots-png/README.md +++ b/assets/screenshots-png/README.md @@ -4,15 +4,4 @@ For WordPress.org plugin submission, you need: 1. Screenshots in PNG format 2. Named sequentially: `screenshot-1.png`, `screenshot-2.png`, etc. -3. Place them in the root of your SVN assets directory - -## Important Note - -The readme.txt file references 3 screenshots: -1. Error message with explanation notification -2. Missing plugin shown in the plugins list with "Remove Notice" link -3. Auto-scroll feature that highlights the missing plugin - -However, only one screenshot file is currently available. You need to create and add the other two screenshots to match the descriptions in the readme.txt file. - -After creating all three screenshots with the proper naming convention, they should be uploaded to the WordPress.org SVN repository in the assets directory. +3. Place them in the root of your SVN assets directory \ No newline at end of file diff --git a/assets/screenshots/fix-plugin-does-not-exist-notices-screenshot-3840x3840-1.png b/assets/screenshots/screenshot-1.png similarity index 100% rename from assets/screenshots/fix-plugin-does-not-exist-notices-screenshot-3840x3840-1.png rename to assets/screenshots/screenshot-1.png diff --git a/fix-plugin-does-not-exist-notices.php b/fix-plugin-does-not-exist-notices.php index 93a8edf..d83acc4 100644 --- a/fix-plugin-does-not-exist-notices.php +++ b/fix-plugin-does-not-exist-notices.php @@ -12,8 +12,8 @@ * @wordpress-plugin * Plugin Name: Fix 'Plugin file does not exist.' Notices * Plugin URI: https://wordpress.org/plugins/fix-plugin-does-not-exist-notices/ - * Description: Adds missing plugins to the plugins list with a "Remove Reference" link so you can permanently clean up invalid plugin entries and remove error notices. By Marcus Quinn (marcusquinn.com) & WP ALLSTARS (wpallstars.com). - * Version: 1.6.24 + * Description: Adds missing plugins to the plugins list with a "Remove Reference" link so you can permanently clean up invalid plugin entries and remove error notices. + * Version: 1.6.25 * Author: Marcus Quinn & WP ALLSTARS * Author URI: https://www.wpallstars.com * License: GPL-2.0+ @@ -48,7 +48,7 @@ if ( ! defined( 'ABSPATH' ) ) { } // Define plugin constants -define( 'FPDEN_VERSION', '1.6.24' ); +define( 'FPDEN_VERSION', '1.6.25' ); define( 'FPDEN_PLUGIN_DIR', plugin_dir_path( __FILE__ ) ); define( 'FPDEN_PLUGIN_URL', plugin_dir_url( __FILE__ ) ); define( 'FPDEN_PLUGIN_FILE', __FILE__ ); diff --git a/languages/fix-plugin-does-not-exist-notices.pot b/languages/fix-plugin-does-not-exist-notices.pot index 9964f6b..a1d1103 100644 --- a/languages/fix-plugin-does-not-exist-notices.pot +++ b/languages/fix-plugin-does-not-exist-notices.pot @@ -2,7 +2,7 @@ # This file is distributed under the GPL-2.0+. msgid "" msgstr "" -"Project-Id-Version: Fix 'Plugin file does not exist.' Notices 1.6.24\n" +"Project-Id-Version: Fix 'Plugin file does not exist.' Notices 1.6.25\n" "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/fix-plugin-does-not-exist-notices\n" "Last-Translator: FULL NAME \n" "Language-Team: LANGUAGE \n" diff --git a/readme.txt b/readme.txt index efb8519..2546cbf 100644 --- a/readme.txt +++ b/readme.txt @@ -5,7 +5,7 @@ Tags: plugins, missing plugins, cleanup, error fix, admin tools, plugin file doe Requires at least: 5.0 Tested up to: 6.4 Requires PHP: 7.0 -Stable tag: 1.6.24 +Stable tag: 1.6.25 License: GPL-2.0+ License URI: https://www.gnu.org/licenses/gpl-2.0.html @@ -111,6 +111,12 @@ Manually editing the WordPress database is risky and requires technical knowledg == Changelog == += 1.6.25 = +* Consolidated asset files into their respective directories +* Created comprehensive WordPress.org submission guide +* Clarified SVN repository structure and asset requirements +* Improved organization of asset files + = 1.6.24 = * Added properly named icon PNG files for WordPress.org submission * Created icon-256x256.png and icon-128x128.png files @@ -343,6 +349,9 @@ Manually editing the WordPress database is risky and requires technical knowledg == Upgrade Notice == += 1.6.25 = +Improved organization of asset files and created comprehensive WordPress.org submission guide. + = 1.6.24 = Added properly named icon PNG files for WordPress.org submission.