ranger cba0df9439 chore: wp.org submission prep — v0.1.3
Rebrand to RangerHQ Buddy and prepare for the WordPress.org Plugin
Directory. Same workflow as rangerhq-radio v0.7.0 → v0.7.5.

Changes:
- Plugin Name: Buddy → RangerHQ Buddy (matches family naming)
- Plugin URI: icanhelp.ie/buddy → davidtkeane.com/rangerhq-buddy
- Author URI: rangersmyth.xyz → davidtkeane.com
- Text Domain: buddy → rangerhq-buddy (62 occurrences across 8 PHP files)
- Add LICENSE file (full GPL v2 text from gnu.org)
- Add wp.org-format readme.txt with all 8 required headers
- Remove inc/updater.php (self-hosted Gitea updater forbidden for
  wp.org-hosted plugins per the rangerhq-radio v0.7.3 walkback)
- Replace mt_rand with wp_rand in inc/state.php for better RNG
- Add 5 translator comments for printf-style i18n placeholders
- Wrap 2 dashboard-widget.php printf placeholders in (int) casts
- Add tests/ to .gitignore (PCP reports are local-only)

PCP audit: 85 issues → ~1 (the .gitignore file itself, stripped from
the submission zip).
Plugin Check Namer Tool: "Generally Allowable" verdict on both name
and slug.
Plugin URI https://davidtkeane.com/rangerhq-buddy/ returns HTTP 200.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-07 01:56:26 +01:00

🐾 Buddy

A friendly little companion that lives in your WordPress dashboard.

Adopt a small virtual pet that lives in your WordPress admin. Right now Buddy just exists — they bob, they blink, they show their mood. As the plugin grows, their stats will reflect how well you take care of your WordPress site itself: published posts feed them, outdated plugins make them sick, clearing spam makes them happy.

Gamifies WordPress maintenance with a bit of charm.


What this is

  • A standalone WordPress plugin, GPL v2+ licensed.
  • The spiritual successor to the tamagotchi feature that once lived inside A-WP-Notes v1.1.5 (now gracefully retired). Rebuilt from scratch, with all the v3-discipline lessons baked in from day one.
  • Sister plugin to Logbook in the RangerHQ plugin family. Logbook is work. Buddy is play.

What it does

  • Dashboard widget shows your Buddy with name, mood, and four stats bars.
  • Dedicated Buddy admin page for the bigger view.
  • Settings page where you can rename your Buddy and check for updates.
  • Each WP admin gets their own Buddy stored per-user in user_meta — nothing leaves your site's database.

What it doesn't do (yet)

  • No interactions — feed / play / clean / sleep coming in Phase B.
  • No time-based stat decay yet — Phase C.
  • Only one species available right now — Phase D will add dog, dragon, sprite, etc.
  • The killer feature — having Buddy's stats reflect your actual WP site health — is Phase E.

See CHANGELOG.md for the full version history and roadmap.

Install

  1. Download the latest release zip from Gitea.
  2. WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
  3. Find Buddy in the admin sidebar (paw-print icon).

The plugin self-checks for updates via the Gitea repo — see Settings → Buddy → Settings → Updates.

Project pace

This is a side project built at a side-project pace. No commercial pressure, no release deadlines. Issues and feedback welcome via Gitea.

Licence

GPL v2 or later — see LICENSE.

S
Description
No description provided
Readme GPL-2.0 130 KiB
Languages
PHP 79.4%
CSS 20.6%