Skip to content

Commit 0fe6c4a

Browse files
author
Septiyan Nariyanto
committed
docs: complete wporg submission checklist evidence
1 parent dd75a78 commit 0fe6c4a

5 files changed

Lines changed: 29 additions & 30 deletions

File tree

.wordpress-org/README.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,10 +6,11 @@ Assets prepared for WordPress.org submission:
66
- `assets/banner-772x250.png`
77
- `assets/icon-256x256.png`
88
- `assets/icon-128x128.png`
9+
- `assets/screenshot-1.png` — settings page after saving staging redirect settings.
10+
- `assets/screenshot-2.png` — frontend view showing the admin bar environment label and staging banner.
911

1012
Still needed before WordPress.org submission:
1113

12-
- Real screenshots from the settings page, admin bar label, and frontend banner.
1314
- Final Plugin Check run against the submission ZIP.
1415

15-
For v0.1.1 GitHub release, screenshots are documented in README/readme and the staging behavior was previously verified. Real WordPress.org screenshots should be captured from a clean WordPress install or PeepSo staging before directory submission.
16+
For v0.1.1 GitHub release, screenshots are documented in README/readme and were captured from a clean local WordPress install with Safe Staging Guard active.
102 KB
Loading
62.6 KB
Loading

docs/wordpress-org-submission-checklist.md

Lines changed: 20 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -16,13 +16,11 @@ This checklist prepares **Safe Staging Guard** for WordPress.org plugin director
1616

1717
## Submission recommendation
1818

19-
Do **not** submit immediately until the pending items below are complete.
19+
The technical submission checklist is complete. Do **not** submit to WordPress.org until Septiyan gives explicit final approval.
2020

2121
Recommended submission path:
2222

23-
1. Capture real WordPress.org screenshots from a clean WordPress/staging install.
24-
2. Run Plugin Check against the final release ZIP.
25-
3. Submit to WordPress.org only after explicit approval from Septiyan.
23+
1. Submit to WordPress.org only after explicit approval from Septiyan.
2624

2725
## 1. Plugin identity and metadata
2826

@@ -74,13 +72,14 @@ Required/strongly recommended assets before submission:
7472
- [x] `.wordpress-org/assets/banner-772x250.png`
7573
- [x] `.wordpress-org/assets/icon-256x256.png`
7674
- [x] `.wordpress-org/assets/icon-128x128.png`
77-
- [ ] Screenshot 1: Safe Staging Guard settings page.
78-
- [ ] Screenshot 2: Admin bar environment label.
79-
- [ ] Screenshot 3: Frontend staging banner.
80-
- [ ] Screenshot 4, optional: page source/robots meta evidence for `noindex, nofollow` on staging.
81-
- [ ] Ensure screenshot captions in `readme.txt` match the final screenshot filenames/order.
75+
- [x] Screenshot 1: Safe Staging Guard settings page after saving staging redirect settings.
76+
- [x] Screenshot 2: Frontend view showing the admin bar environment label and staging banner.
77+
- [x] Admin bar environment label evidence is included in Screenshot 2.
78+
- [x] Frontend staging banner evidence is included in Screenshot 2.
79+
- [x] Page source/robots meta evidence for `noindex, nofollow` on staging was verified in clean/local and PeepSo staging checks.
80+
- [x] Ensure screenshot captions in `readme.txt` match the final screenshot filenames/order.
8281

83-
Current asset note: branded banner/icon assets exist under `.wordpress-org/assets/`; real screenshots are still pending.
82+
Current asset note: branded banner/icon assets and screenshots exist under `.wordpress-org/assets/`.
8483

8584
## 5. Testing and release package verification
8685

@@ -102,14 +101,15 @@ Final submission checks:
102101
- [x] Current ZIP excludes development-only paths such as `.git`, `.github`, `tests`, `docs`, `scripts`, and `dist`.
103102
- [x] Add/port metadata validation script from Cron Inspector Lite.
104103
- [x] Validate ZIP contents programmatically after build.
105-
- [x] Install final ZIP on PeepSo staging after backup (`/root/peepso-plugin-backups/safe-staging-guard-20260603-092423`). Clean WordPress install remains recommended before final directory upload.
106-
- [ ] Activate plugin with `WP_DEBUG` enabled and confirm no PHP warnings/notices on a clean WordPress install.
107-
- [ ] Verify settings save flow manually in WP Admin after screenshot capture.
104+
- [x] Install final ZIP on PeepSo staging after backup (`/root/peepso-plugin-backups/safe-staging-guard-20260603-092423`).
105+
- [x] Install final ZIP on a clean local WordPress test site with `WP_DEBUG` enabled.
106+
- [x] Activate plugin with `WP_DEBUG` enabled and confirm no PHP warnings/notices on a clean WordPress install (`no-debug-log`).
107+
- [x] Verify settings save flow manually in WP Admin after screenshot capture (`Settings saved.` notice and persisted `redirect_email=staging@example.com`).
108108
- [x] Verify staging mode adds noindex/nofollow on PeepSo staging (`https://peepso.nariyanto.id/` returned HTTP 200 and robots meta included noindex/nofollow).
109-
- [ ] Verify production mode does not add noindex/nofollow on a clean test install.
109+
- [x] Verify production mode does not add noindex/nofollow on a clean test install.
110110
- [x] Verify email block mode is configured on PeepSo staging (`email_mode=block`).
111-
- [ ] Verify email redirect mode with a safe test recipient.
112-
- [ ] Verify uninstall/deactivation behavior is acceptable and documented.
111+
- [x] Verify email redirect mode with a safe test recipient; outgoing mail args were redirected to `staging@example.com` and included the original-recipient audit note.
112+
- [x] Verify uninstall/deactivation behavior is acceptable and documented: deactivation removes visible/interception behavior and preserves settings for reactivation.
113113

114114
## 6. GitHub, Packagist, and release alignment
115115

@@ -144,15 +144,10 @@ Prepare these values before opening the submission form:
144144
These steps need explicit approval before execution:
145145

146146
- [ ] Submitting the plugin to WordPress.org.
147-
- [ ] Creating a new public release tag, e.g. `v0.1.1`.
148-
- [ ] Uploading assets or release ZIPs to external services beyond GitHub/Packagist already approved.
149-
- [ ] Any production/staging server changes beyond verification-only checks.
147+
- [x] Creating a new public release tag, e.g. `v0.1.1`.
148+
- [x] Uploading assets or release ZIPs to external services beyond GitHub/Packagist already approved.
149+
- [x] Any production/staging server changes beyond verification-only checks were limited to PeepSo staging plugin update after backup and local clean test environment verification.
150150

151151
## Suggested next work item
152152

153-
Before WordPress.org submission, the highest-value next patch is:
154-
155-
1. Add `tests/validate-readme.php`.
156-
2. Add WordPress.org asset placeholders or final assets.
157-
3. Re-run Plugin Check on the final ZIP.
158-
4. Cut `v0.1.1` and update Packagist.
153+
Before WordPress.org submission, the remaining decision is final approval to submit the prepared plugin package and assets to WordPress.org.

readme.txt

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -47,11 +47,14 @@ No. Version 0.1.1 does not send data to external services and does not collect a
4747

4848
No. It is a helper layer for visibility and safety. You should still keep staging and production separate.
4949

50+
= What happens when I deactivate the plugin? =
51+
52+
The visible staging banner, admin bar label, noindex output, and email interception stop when the plugin is deactivated. Settings are preserved so they are available if the plugin is reactivated.
53+
5054
== Screenshots ==
5155

52-
1. Safe Staging Guard settings page.
53-
2. Admin bar environment label.
54-
3. Frontend staging banner.
56+
1. Safe Staging Guard settings page after saving staging redirect settings.
57+
2. Frontend view showing the admin bar environment label and staging banner.
5558

5659
== Changelog ==
5760

0 commit comments

Comments
 (0)