Skip to content

Commit fe735b4

Browse files
author
Septiyan Nariyanto
committed
docs: prepare safe staging guard release notes
1 parent 1672005 commit fe735b4

6 files changed

Lines changed: 92 additions & 0 deletions

File tree

.wordpress-org/README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# WordPress.org Asset Plan
2+
3+
Assets to add before WordPress.org submission:
4+
5+
- `banner-1544x500.png`
6+
- `banner-772x250.png`
7+
- `icon-256x256.png`
8+
- `icon-128x128.png`
9+
- screenshots from the settings page, admin bar label, and frontend banner.
10+
11+
For v0.1.0 GitHub release, screenshots are documented in README/readme and verified on staging. Real WordPress.org assets can be finalized after the plugin is ready for submission.

CHANGELOG.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Changelog
2+
3+
## 0.1.0 - 2026-06-03
4+
5+
Initial portfolio/staging release.
6+
7+
### Added
8+
9+
- Environment mode: Local, Staging, Production.
10+
- Admin bar environment label for administrators.
11+
- Frontend staging banner for logged-in users.
12+
- Noindex/nofollow robots control for local and staging environments.
13+
- Email safety modes: block, redirect, and allow.
14+
- Production mode guard that disables noindex and email interception.
15+
- Settings page under Settings > Safe Staging Guard.
16+
- Pure PHP tests for settings, email safety, and noindex behavior.
17+
- GitHub Actions CI and clean release ZIP builder.

README.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -21,6 +21,15 @@ Safe Staging Guard adds a small safety layer for WordPress staging/local environ
2121
- Email block or redirect mode.
2222
- Production mode disables email interception and noindex.
2323

24+
## Staging verification
25+
26+
Installed and verified on `peepso.nariyanto.id` staging with:
27+
28+
- staging environment mode enabled,
29+
- `noindex, nofollow` robots meta active,
30+
- email safety mode set to block,
31+
- Plugin Check completed with no errors.
32+
2433
## Development
2534

2635
Run tests:

docs/release-checklist.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# Safe Staging Guard Release Checklist
2+
3+
## v0.1.0
4+
5+
- [x] Keep first release narrow and non-destructive.
6+
- [x] Add pure PHP tests for business logic.
7+
- [x] Run local PHP tests.
8+
- [x] Run PHP syntax checks.
9+
- [x] Build clean release ZIP.
10+
- [x] Deploy ZIP to PeepSo staging.
11+
- [x] Activate and configure staging mode.
12+
- [x] Verify HTTP 200 site health.
13+
- [x] Verify `noindex, nofollow` robots meta on staging.
14+
- [x] Verify email interception is active in staging mode.
15+
- [x] Run Plugin Check on staging.
16+
- [x] Fix Plugin Check i18n findings.
17+
18+
## WordPress.org later
19+
20+
- Add real screenshots from WP Admin.
21+
- Add banner and icon assets.
22+
- Re-run Plugin Check against final ZIP.
23+
- Submit only after Cron Inspector Lite review flow is stable.

docs/worklog-notes.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Worklog Notes: Safe Staging Guard v0.1.0
2+
3+
## Summary
4+
5+
Safe Staging Guard is the second WordPress plugin in the Nariyanto GitHub portfolio roadmap. It focuses on staging-site safety: visible environment labels, noindex controls, and safe email handling.
6+
7+
## Milestone
8+
9+
- Created public GitHub repository.
10+
- Built v0.1.0 with TDD-friendly pure PHP services.
11+
- Deployed to `peepso.nariyanto.id` staging.
12+
- Configured staging mode with noindex and email blocking.
13+
- Ran Plugin Check and fixed i18n issues until no errors remained.
14+
15+
## Technical decisions
16+
17+
- Keep v0.1.0 non-destructive and review-friendly.
18+
- Use `safe-staging-guard` as the WordPress.org-facing slug to avoid restricted `WP` wording.
19+
- Make Production mode automatically disable noindex and email interception.
20+
- Keep email blocking local to WordPress mail flow and avoid external calls.
21+
- Use pure service classes for testable logic before WordPress admin glue.
22+
23+
## Verification
24+
25+
- CI passed.
26+
- Local PHP tests passed.
27+
- PHP syntax checks passed.
28+
- Plugin Check: no errors found.
29+
- PeepSo staging returned HTTP 200.
30+
- Public HTML contained `noindex, nofollow` robots meta.
31+
- Email interception returned active in staging mode.

scripts/build-release.sh

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -12,6 +12,7 @@ rsync -a "$ROOT/" "$BUILD/" \
1212
--exclude='dist' \
1313
--exclude='tests' \
1414
--exclude='docs' \
15+
--exclude='.wordpress-org' \
1516
--exclude='scripts' \
1617
--exclude='.gitignore'
1718
if command -v zip >/dev/null 2>&1; then

0 commit comments

Comments
 (0)