ranger
8c38d38a3a
Buddy now has a fourth mood tone — wink — with one eye closed, an asymmetric smirk, and rosier cheeks. Renders as a small variant inside the existing inline-SVG sprite (still zero image files, no new assets). When overall mood is >= 75, there's a 30% chance on each page render that the wink replaces the standard happy face — gives the pet a touch of unpredictable personality. Why this commit exists: v0.1.0 had three tones (happy / neutral / sad). Adding wink is the smallest possible demo that the SVG expression engine is properly extensible — every future mood, state, accessory or species can land via the same pattern. ~20 lines of PHP, ~2 lines of CSS, no bundle weight, no dependencies. CHANGES - inc/sprite.php: wink added to allowed-tones list. Left eye renders as a closed-eye arc instead of the open circle. Mouth shifts to an asymmetric smirk. Cheek opacity 0.55 → 0.75 for extra cheekiness. - inc/state.php: buddy_mood_label() returns wink ~30% of the time when mood >= 75. - assets/css/buddy.css: new .buddy-widget__mood--wink and .buddy-main__mood--wink rules — warm amber pill. - About-page version-history leads with v0.1.1; v0.1.0 demoted. VERSION - buddy.php header 0.1.0 → 0.1.1 - BUDDY_VERSION constant 0.1.0 → 0.1.1 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
🐾 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
- Download the latest release zip from Gitea.
- WordPress admin → Plugins → Add New → Upload Plugin → choose the zip → Install Now → Activate.
- 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.