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>
122 lines
4.3 KiB
PHP
122 lines
4.3 KiB
PHP
<?php
|
|
/**
|
|
* Buddy — a friendly pet for your WordPress dashboard
|
|
*
|
|
* Plugin Name: Buddy
|
|
* Plugin URI: https://icanhelp.ie/buddy
|
|
* Description: Adopt a small companion that lives in your WordPress dashboard. Its mood reflects your site's health — published posts feed it, outdated plugins make it sick, clearing spam makes it happy. Gamifies WordPress maintenance with a bit of charm.
|
|
* Version: 0.1.1
|
|
* Requires at least: 5.0
|
|
* Requires PHP: 7.4
|
|
* Author: David Keane
|
|
* Author URI: https://rangersmyth.xyz/
|
|
* License: GPL v2 or later
|
|
* License URI: https://www.gnu.org/licenses/gpl-2.0.html
|
|
* Text Domain: buddy
|
|
*
|
|
* @package Buddy
|
|
*/
|
|
|
|
if ( ! defined( 'ABSPATH' ) ) { exit; }
|
|
|
|
// Plugin coordinates.
|
|
if ( ! defined( 'BUDDY_VERSION' ) ) { define( 'BUDDY_VERSION', '0.1.1' ); }
|
|
if ( ! defined( 'BUDDY_FILE' ) ) { define( 'BUDDY_FILE', __FILE__ ); }
|
|
if ( ! defined( 'BUDDY_PATH' ) ) { define( 'BUDDY_PATH', plugin_dir_path( __FILE__ ) ); }
|
|
if ( ! defined( 'BUDDY_URL' ) ) { define( 'BUDDY_URL', plugin_dir_url( __FILE__ ) ); }
|
|
if ( ! defined( 'BUDDY_BASENAME' ) ) { define( 'BUDDY_BASENAME', plugin_basename( __FILE__ ) ); }
|
|
|
|
// Includes — each file owns one concern.
|
|
require_once BUDDY_PATH . 'inc/state.php'; // user_meta storage + stat helpers
|
|
require_once BUDDY_PATH . 'inc/sprite.php'; // inline-SVG character renderer
|
|
require_once BUDDY_PATH . 'inc/dashboard-widget.php'; // the pet on WP Dashboard
|
|
require_once BUDDY_PATH . 'inc/admin-page.php'; // dedicated Buddy admin page
|
|
require_once BUDDY_PATH . 'inc/about.php'; // About page
|
|
require_once BUDDY_PATH . 'inc/settings.php'; // Settings page
|
|
require_once BUDDY_PATH . 'inc/updater.php'; // self-hosted update checker against Gitea
|
|
|
|
/**
|
|
* Admin menu registration. Buddy gets its own top-level menu — the pet
|
|
* is a discrete enough thing to deserve a sidebar entry rather than
|
|
* being buried under Tools or Settings. Icon is dashicons-pets for the
|
|
* literal-match-to-purpose vibe (paw print).
|
|
*/
|
|
add_action( 'admin_menu', 'buddy_register_admin_menu' );
|
|
function buddy_register_admin_menu() {
|
|
add_menu_page(
|
|
__( 'Buddy', 'buddy' ),
|
|
__( 'Buddy', 'buddy' ),
|
|
'read', // any logged-in user with read access can see their own pet
|
|
'buddy',
|
|
'buddy_render_main_page',
|
|
'dashicons-pets',
|
|
72 // sits below Comments, above plugin entries
|
|
);
|
|
|
|
// "My Buddy" — main landing submenu. Same slug as parent so clicking
|
|
// either entry lands on the same page. Empty callback so only the
|
|
// parent's renderer fires (lesson learned from Logbook's duplicate-
|
|
// form bug).
|
|
add_submenu_page(
|
|
'buddy',
|
|
__( 'My Buddy', 'buddy' ),
|
|
__( 'My Buddy', 'buddy' ),
|
|
'read',
|
|
'buddy',
|
|
''
|
|
);
|
|
|
|
add_submenu_page(
|
|
'buddy',
|
|
__( 'Settings', 'buddy' ),
|
|
__( 'Settings', 'buddy' ),
|
|
'manage_options',
|
|
'buddy-settings',
|
|
'buddy_render_settings_page'
|
|
);
|
|
|
|
add_submenu_page(
|
|
'buddy',
|
|
__( 'About', 'buddy' ),
|
|
__( 'About', 'buddy' ),
|
|
'read',
|
|
'buddy-about',
|
|
'buddy_render_about_page'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Enqueue Buddy's CSS + JS on its own admin pages and on the main
|
|
* dashboard (where the widget lives).
|
|
*/
|
|
add_action( 'admin_enqueue_scripts', 'buddy_enqueue_admin_assets' );
|
|
function buddy_enqueue_admin_assets( $hook ) {
|
|
$buddy_hooks = array(
|
|
'index.php', // WP Dashboard (the widget lives here)
|
|
'toplevel_page_buddy', // Buddy main page
|
|
'buddy_page_buddy-settings', // Settings
|
|
'buddy_page_buddy-about', // About
|
|
);
|
|
if ( ! in_array( $hook, $buddy_hooks, true ) ) { return; }
|
|
|
|
wp_enqueue_style(
|
|
'buddy-admin',
|
|
BUDDY_URL . 'assets/css/buddy.css',
|
|
array(),
|
|
BUDDY_VERSION
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Activation hook: ensure the version option is set so the updater can
|
|
* track it.
|
|
*/
|
|
register_activation_hook( __FILE__, 'buddy_on_activate' );
|
|
function buddy_on_activate() {
|
|
if ( false === get_option( 'buddy_version' ) ) {
|
|
add_option( 'buddy_version', BUDDY_VERSION );
|
|
} else {
|
|
update_option( 'buddy_version', BUDDY_VERSION );
|
|
}
|
|
}
|