Files
rangerhq-buddy/buddy.php
T
ranger 117eaddaa0 chore: v0.1.5 — wp.org reviewer-feedback fix
Reviewer flagged inc/about.php line 19 — an inline <style> block —
asking us to use wp_enqueue_style instead. Per their hint that the
team may not list every instance of an issue, fixed the entire CSS
inline-styling pattern across the plugin:

- inc/about.php: <style> block (lines 19-59) → moved to buddy.css
- inc/about.php: <span style="color:#646970; font-weight:400;">
  → .buddy-about-intro__version class
- inc/about.php: <p style="margin-bottom:0;"> → .buddy-about-intro__cta
- inc/settings.php: <form style="..."> → .buddy-settings-form class
- inc/settings.php: <h2 style="margin-top:0;"> → scoped under form class
- inc/admin-page.php: <p style="max-width:720px;">
  → .buddy-admin-description utility class

The only remaining inline style is in inc/dashboard-widget.php at the
stat-bar width — that is a runtime-computed %d value, legitimately
inline.

The buddy.css file was already enqueued on the About / Settings /
Admin / Dashboard pages via the existing buddy_enqueue_admin_assets
function, so no new enqueue logic was needed.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-08 14:55:04 +01:00

121 lines
4.3 KiB
PHP

<?php
/**
* Buddy — a friendly pet for your WordPress dashboard
*
* Plugin Name: RangerHQ Buddy
* Plugin URI: https://davidtkeane.com/rangerhq-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.5
* Requires at least: 5.0
* Requires PHP: 7.4
* Author: David Keane
* Author URI: https://davidtkeane.com
* License: GPL v2 or later
* License URI: https://www.gnu.org/licenses/gpl-2.0.html
* Text Domain: rangerhq-buddy
*
* @package Buddy
*/
if ( ! defined( 'ABSPATH' ) ) { exit; }
// Plugin coordinates.
if ( ! defined( 'BUDDY_VERSION' ) ) { define( 'BUDDY_VERSION', '0.1.5' ); }
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
/**
* 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', 'rangerhq-buddy' ),
__( 'Buddy', 'rangerhq-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', 'rangerhq-buddy' ),
__( 'My Buddy', 'rangerhq-buddy' ),
'read',
'buddy',
''
);
add_submenu_page(
'buddy',
__( 'Settings', 'rangerhq-buddy' ),
__( 'Settings', 'rangerhq-buddy' ),
'manage_options',
'buddy-settings',
'buddy_render_settings_page'
);
add_submenu_page(
'buddy',
__( 'About', 'rangerhq-buddy' ),
__( 'About', 'rangerhq-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 );
}
}