ranger
c7d49b383a
Documents the wink-probability tune-down (f661eab) as a proper
patch release. No code behaviour change in this commit — purely
version metadata, changelog, and user-facing about-page history.
CHANGES
- buddy.php: Version header + BUDDY_VERSION constant 0.1.1 → 0.1.2
- CHANGELOG.md: new [0.1.2] entry above [0.1.1], explains the
tuning rationale + what's intentionally unchanged (wink visuals,
trigger threshold mood >= 75)
- inc/about.php: version-history card leads with v0.1.2 (latest
badge), v0.1.1 demoted to second slot
Why a patch release: the wink fires far less often now than it
did in v0.1.1. From a user's point of view that IS a behaviour
change worth a version. Following SemVer: PATCH bump because the
public API and feature set are unchanged; only the tuning of an
existing behaviour was adjusted.
Co-Authored-By: Claude Opus 4.7 (1M context) <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.2
|
|
* 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.2' ); }
|
|
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 );
|
|
}
|
|
}
|