fix: update checker — fall back to /tags when no formal Gitea Release exists (v3.3.2)

The v3.3.0 update checker only queried Gitea's /releases/latest
endpoint, which requires a formal Release object (created via the
Gitea web UI with optional notes + zip assets attached). A plain
"git tag v3.3.x && git push --tags" from the terminal does NOT
create that Release object — so the checker kept returning "No
releases tagged on the Gitea repo yet" even when tags existed.

wp_notes_fetch_latest_release() now falls back to the
/tags?limit=1 endpoint when /releases/latest returns 404 (or any
non-200). It synthesises a release-like payload from the newest
tag — tag_name, html_url pointing at the tag view, tag message as
the body, empty assets[] so the existing download-URL logic falls
through to Gitea's source-archive URL pattern (/archive/<tag>.zip).

Net effect: the "Check now" button now finds the latest version
whether David creates formal Gitea Releases OR just pushes tags
with "git push --tags". No workflow change required.

Discovered while diagnosing why "Check now" wasn't seeing today's
v3.1.0/v3.2.0/v3.3.0/v3.3.1 tags (just pushed in this session)
— the tags were there, the formal Release objects were not.

KNOWN LIMITATION (not a bug — flagged)
The Gitea repo ranger/a-wp-notes-v3 is currently private. Anonymous
API requests get a 404 (Gitea's standard behaviour for private
repos). The updater code is correct but can't actually reach the
API on a private repo without authentication. Fix: change the
repo visibility to public on Gitea — appropriate anyway for a
GPL-licensed plugin headed for the WordPress.org marketplace.

VERSION BUMP
- wp-notes.php header 3.3.1 → 3.3.2
- WP_NOTES_VERSION constant 3.3.1 → 3.3.2
- About page version-history leads with v3.3.2; v3.3.1 demoted

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-All notable changes to **WP Logbook** (formerly **A-WP-Notes** through v3.1.0) are documented here.
+All notable changes to **Logbook** (formerly **A-WP-Notes** through v3.1.0, then **WP Logbook** in v3.2.0–v3.3.0) are documented here.
 Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) — versioning: [SemVer](https://semver.org/).
 
 ---
@@ -9,6 +9,74 @@ Format: [Keep a Changelog 1.1.0](https://keepachangelog.com/en/1.1.0/) — versi
 
 ---
 
+## [3.3.2] — 2026-05-25
+
+### Fixed — update checker now works with tag-only workflows
+The v3.3.0 update checker only queried Gitea's `/releases/latest`
+endpoint, which requires a **formal Release object** (created via
+the Gitea web UI with optional notes + zip assets). A plain
+`git tag v3.3.x && git push --tags` from the terminal doesn't
+create that Release object — so the checker kept returning *"No
+releases tagged on the Gitea repo yet"* even when tags clearly
+existed.
+
+`wp_notes_fetch_latest_release()` now falls back to the
+`/tags?limit=1` endpoint when `/releases/latest` returns 404 (or
+any non-200). It synthesises a release-like payload from the
+newest tag — `tag_name`, an `html_url` pointing at the tag view,
+the tag message as the body, and an empty `assets[]` array so the
+existing download-URL logic falls through to Gitea's source-archive
+URL pattern (`/archive/<tag>.zip`).
+
+**Net effect:** the "Check now" button now finds the latest version
+whether David creates formal Gitea Releases OR just pushes tags
+with `git push --tags`. No workflow change required.
+
+### Known limitation (not a bug — flagged for awareness)
+The Gitea repo `ranger/a-wp-notes-v3` is currently **private**.
+Anonymous API requests get a 404 (Gitea's standard behaviour to
+avoid leaking the existence of private repos). The updater code is
+correct, but it can't actually reach the API on a private repo
+without authentication. **Fix:** change the repo visibility to
+public on Gitea (Settings → Visibility) — appropriate anyway for a
+GPL-licensed plugin headed for the WordPress.org marketplace.
+
+---
+
+## [3.3.1] — 2026-05-25
+
+**Naming: dropped the `WP` prefix. The plugin is now just `Logbook`.**
+
+David's call after a short discussion about WordPress.org marketplace
+considerations — WP.org's trademark policy historically discourages
+plugins implying official endorsement via a `WP` prefix and has been
+known to request a rename during submission review. Dropping it now
+makes the name cleaner *and* sidesteps that future hurdle if/when
+the plugin lands on the marketplace.
+
+### Changed
+- All user-facing brand mentions: `WP Logbook` → `Logbook` across
+  plugin header, admin menu, admin bar, dashboard widget, settings
+  H1, main page H1, About page intro, About page card heading,
+  feedback email subjects/body, error_log prefix, updater panel
+  copy, and styles docblock.
+- About page version-history card gets a new top entry for v3.3.1
+  with the green "latest" pill; v3.3.0 demoted to the previous slot.
+- CHANGELOG header line updated to track the full naming lineage:
+  *A-WP-Notes (≤v3.1.0) → WP Logbook (v3.2.0–v3.3.0) → Logbook
+  (v3.3.1+)*.
+
+### Notably NOT changed
+- Historical CHANGELOG entries for v3.2.0 (the original "WP
+  Logbook" rebrand) still say "WP Logbook" — that was the correct
+  name at the time and rewriting it would be revisionist.
+- Same zero-migration commitment as the v3.2.0 rebrand: internal
+  function names, constants, DB option keys, user_meta keys, file
+  paths, plugin slug, and text domain all unchanged. Pure
+  user-facing string change.
+
+---
+
 ## [3.3.0] — 2026-05-25
 
 **New feature: self-hosted update checker.** WP Logbook is hosted on

inc/admin-bar.php

@@ -40,10 +40,10 @@ function wp_notes_admin_bar_menu($wp_admin_bar) {
         $notes = get_option('wp_notes', array());
         $count = count($notes);
         
-        // Main WP Logbook menu item
+        // Main Logbook menu item
         $wp_admin_bar->add_node(array(
             'id' => 'wp-notes',
-            'title' => sprintf('WP Logbook <span class="count">%d</span>', $count),
+            'title' => sprintf('Logbook <span class="count">%d</span>', $count),
             'href' => admin_url('admin.php?page=wp-notes'),
         ));
 

inc/wp-notes-about.php

@@ -2,7 +2,7 @@
 // wp-notes-about.php
 
 /**
- * Function to display the "About" page for WP Logbook plugin.
+ * Function to display the "About" page for Logbook plugin.
  */
 function wp_notes_about_page() {
     ?>
@@ -53,11 +53,11 @@ function wp_notes_about_page() {
             <div class="wp-notes-about-intro">
                 <div class="wp-notes-about-intro__img">
                     <img src="<?php echo esc_url(WP_NOTES_URL); ?>assets/wp-notes-banner.jpg"
-                         alt="WP Logbook banner">
+                         alt="Logbook banner">
                 </div>
                 <div class="wp-notes-about-intro__body">
-                    <h2>WP Logbook <span style="color:#646970; font-weight:400;">v<?php echo esc_html(WP_NOTES_VERSION); ?></span></h2>
+                    <h2>Logbook <span style="color:#646970; font-weight:400;">v<?php echo esc_html(WP_NOTES_VERSION); ?></span></h2>
-                    <p>WP Logbook is a lightweight task &amp; logbook plugin for WordPress. Log your daily work, mark tasks as done, and keep a tidy record right inside the dashboard &mdash; perfect for freelancers showing clients what's been delivered.</p>
+                    <p>Logbook is a lightweight task &amp; logbook plugin for WordPress. Log your daily work, mark tasks as done, and keep a tidy record right inside the dashboard &mdash; perfect for freelancers showing clients what's been delivered.</p>
                     <p style="margin-bottom:0;">
                         <a href="<?php echo esc_url(admin_url('admin.php?page=wp-notes')); ?>" class="button button-primary">Go to My Log →</a>
                     </p>
@@ -101,10 +101,10 @@ function wp_notes_about_page() {
             }
             </style>
 
-            <!-- What WP Logbook does -->
+            <!-- What Logbook does -->
             <div class="wp-notes-about-card">
-                <h2>What WP Logbook does</h2>
+                <h2>What Logbook does</h2>
-                <p>WP Logbook is a lightweight task &amp; logbook plugin that lives entirely inside the WordPress admin. Type a note, format it with colour / size / font / emoji, mark it done when the work is finished, restore it later if you need to revisit. Everything is stored in the site's own database &mdash; nothing leaves your server.</p>
+                <p>Logbook is a lightweight task &amp; logbook plugin that lives entirely inside the WordPress admin. Type a note, format it with colour / size / font / emoji, mark it done when the work is finished, restore it later if you need to revisit. Everything is stored in the site's own database &mdash; nothing leaves your server.</p>
                 <p>I built it for my own client work as a transparent &ldquo;here's what I did this week&rdquo; logbook, so customers can see clearly what they're paying for. It turned out to be just as useful for any small team or single user who wants notes attached to the WordPress dashboard rather than a separate app.</p>
             </div>
 
@@ -125,7 +125,15 @@ function wp_notes_about_page() {
                 <h2>Version history</h2>
                 <ul>
                     <li>
-                        <span class="ver">v3.3.0</span> &mdash; 25 May 2026 <span class="latest">latest</span><br>
+                        <span class="ver">v3.3.2</span> &mdash; 25 May 2026 <span class="latest">latest</span><br>
+                        Update checker now falls back to Gitea's <code>/tags</code> endpoint when no formal Release object exists for the latest tag. Means a plain <code>git tag &amp;&amp; git push --tags</code> is enough to make the &ldquo;Check now&rdquo; button report a new version &mdash; no need to manually create a Release in the Gitea web UI.
+                    </li>
+                    <li>
+                        <span class="ver">v3.3.1</span> &mdash; 25 May 2026<br>
+                        Dropped the <code>WP</code> prefix &mdash; the plugin is now just <strong>Logbook</strong>. Cleaner name, also clears a potential WordPress.org trademark-policy hurdle if/when the plugin ever lands on the marketplace.
+                    </li>
+                    <li>
+                        <span class="ver">v3.3.0</span> &mdash; 25 May 2026<br>
                         Self-hosted update checker. Settings &rarr; Updates panel polls the Gitea repo via its JSON API, compares against the running version, and shows a download link when a new release is tagged. Includes &ldquo;View on Gitea&rdquo; and &ldquo;View all releases&rdquo; quick links. No auto-install &mdash; manual download keeps things safe.
                     </li>
                     <li>

inc/wp-notes-feedback.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * Feedback Form for WP Logbook Plugin
+ * Feedback Form for Logbook Plugin
  *
  * This file contains the HTML and AJAX handling for the feedback form.
  */
@@ -95,7 +95,7 @@ function wp_notes_submit_feedback() {
 
     // Example: Send feedback via email
     $to = 'david@icanhelp.ie';
-    $subject = 'WP Logbook Feedback';
+    $subject = 'Logbook Feedback';
     $body = "Name: $name\nEmail: $email\nMessage: $message";
     $headers = array('Content-Type: text/plain; charset=UTF-8');
 
@@ -148,7 +148,7 @@ function wp_notes_submit_help() {
 
     // Example: Send help request via email
     $to = 'david@icanhelp.ie';
-    $subject = 'WP Logbook Help Request';
+    $subject = 'Logbook Help Request';
     $body = "Name: $name\nEmail: $email\nMessage: $message";
     $headers = array('Content-Type: text/plain; charset=UTF-8');
 

inc/wp-notes-styles.php

@@ -6,7 +6,7 @@ if (!defined('ABSPATH')) {
 }
 
 /**
- * Add required styles for WP Logbook
+ * Add required styles for Logbook
  */
 function wp_notes_admin_styles() {
     ?>

inc/wp-notes-updater.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * WP Logbook — self-hosted update checker against the Gitea repo.
+ * Logbook — self-hosted update checker against the Gitea repo.
  *
  * Polls the Gitea Releases API for the latest tagged release and
  * compares its tag (e.g. "v3.3.0") against WP_NOTES_VERSION.
@@ -48,18 +48,44 @@ function wp_notes_fetch_latest_release( $force_refresh = false ) {
         if ( is_array( $cached ) ) { return $cached; }
     }
 
-    $api_url  = WP_NOTES_GITEA_HOST . '/api/v1/repos/' . WP_NOTES_GITEA_OWNER . '/' . WP_NOTES_GITEA_REPO . '/releases/latest';
+    $base_api = WP_NOTES_GITEA_HOST . '/api/v1/repos/' . WP_NOTES_GITEA_OWNER . '/' . WP_NOTES_GITEA_REPO;
-    $response = wp_remote_get( $api_url, array( 'timeout' => 8 ) );
 
+    // Try /releases/latest first — that's the canonical endpoint when David
+    // has published a formal Gitea Release via the web UI (with notes + zip
+    // assets attached).
+    $response = wp_remote_get( $base_api . '/releases/latest', array( 'timeout' => 8 ) );
     if ( is_wp_error( $response ) ) {
         return null;
     }
 
     $code = (int) wp_remote_retrieve_response_code( $response );
+    $body = ( $code === 200 ) ? json_decode( wp_remote_retrieve_body( $response ), true ) : null;
 
-    // 404 = repo has no releases yet, OR private. Cache briefly and surface
+    // Fallback: if no formal Release exists (typical for tag-only workflows
-    // a friendly status to the UI.
+    // where you `git tag v3.3.1 && git push --tags` without using the web
-    if ( $code !== 200 ) {
+    // UI), hit /tags instead and synthesise a release-like payload from the
+    // newest tag. Gitea's /tags endpoint sorts by creation order, so [0] is
+    // the most recent.
+    if ( $code !== 200 || ! is_array( $body ) || empty( $body['tag_name'] ) ) {
+        $tags_response = wp_remote_get( $base_api . '/tags?limit=1', array( 'timeout' => 8 ) );
+        if ( ! is_wp_error( $tags_response )
+            && (int) wp_remote_retrieve_response_code( $tags_response ) === 200 ) {
+            $tags = json_decode( wp_remote_retrieve_body( $tags_response ), true );
+            if ( is_array( $tags ) && ! empty( $tags[0]['name'] ) ) {
+                $body = array(
+                    'tag_name'     => $tags[0]['name'],
+                    'html_url'     => wp_notes_gitea_repo_url() . '/src/tag/' . rawurlencode( $tags[0]['name'] ),
+                    'body'         => isset( $tags[0]['message'] ) ? $tags[0]['message'] : '',
+                    'published_at' => isset( $tags[0]['commit']['created'] ) ? $tags[0]['commit']['created'] : null,
+                    'assets'       => array(),
+                );
+                $code = 200;
+            }
+        }
+    }
+
+    // Still nothing usable? Surface a friendly status and short-cache.
+    if ( $code !== 200 || ! is_array( $body ) || empty( $body['tag_name'] ) ) {
         $info = array(
             'version'      => null,
             'html_url'     => wp_notes_gitea_releases_url(),
@@ -72,11 +98,6 @@ function wp_notes_fetch_latest_release( $force_refresh = false ) {
         return $info;
     }
 
-    $body = json_decode( wp_remote_retrieve_body( $response ), true );
-    if ( ! is_array( $body ) || empty( $body['tag_name'] ) ) {
-        return null;
-    }
-
     // "v3.3.0" → "3.3.0" so version_compare() against WP_NOTES_VERSION works cleanly.
     $version = ltrim( (string) $body['tag_name'], 'vV' );
 
@@ -180,7 +201,7 @@ function wp_notes_render_updates_panel() {
     <div class="wp-notes-updates" style="max-width:720px; margin-top:24px; padding:18px 20px; background:#fff; border:1px solid #ccd0d4; border-radius:4px;">
         <h2 style="margin-top:0;">Updates</h2>
         <p style="margin:0 0 12px;">
-            WP Logbook is self-hosted on Gitea. Click <strong>Check now</strong> to ask the repo whether there's a newer release than the one you're running.
+            Logbook is self-hosted on Gitea. Click <strong>Check now</strong> to ask the repo whether there's a newer release than the one you're running.
         </p>
 
         <p id="wp-notes-update-status" style="margin:0 0 12px;">

wp-notes.php

@@ -1,11 +1,11 @@
 <?php
 /**
- * WP Logbook — WordPress work-logbook plugin
+ * Logbook — WordPress work-logbook plugin
  *
- * Plugin Name: WP Logbook
+ * Plugin Name: Logbook
  * Plugin URI: https://icanhelp.ie/wp-notes
  * Description: A lightweight task &amp; logbook plugin for WordPress. Log your daily work, mark tasks done, and keep a tidy record inside the dashboard. Perfect for freelancers showing clients what's been delivered and students proving work to teachers.
- * Version: 3.3.0
+ * Version: 3.3.2
  * Requires at least: 5.0
  * Requires PHP: 7.2
  * Author: IR240474
@@ -33,7 +33,7 @@ if (!isset($wp_notes_init)) {
     $wp_notes_init = true;
     
     // Plugin Constants
-    if (!defined('WP_NOTES_VERSION')) define('WP_NOTES_VERSION', '3.3.0');
+    if (!defined('WP_NOTES_VERSION')) define('WP_NOTES_VERSION', '3.3.2');
     if (!defined('WP_NOTES_FILE')) define('WP_NOTES_FILE', __FILE__);
     if (!defined('WP_NOTES_PATH')) define('WP_NOTES_PATH', plugin_dir_path(__FILE__));
     if (!defined('WP_NOTES_URL')) define('WP_NOTES_URL', plugin_dir_url(__FILE__));
@@ -44,7 +44,7 @@ if (!isset($wp_notes_init)) {
 if (!function_exists('wp_notes_log_error')) {
     function wp_notes_log_error($message) {
         if (defined('WP_DEBUG') && WP_DEBUG === true) {
-            error_log('[WP Logbook] ' . $message);
+            error_log('[Logbook] ' . $message);
         }
     }
 }
@@ -169,8 +169,8 @@ if (defined('WP_NOTES_PATH')) {
 // Admin Menu
 function wp_notes_admin_menu() {
     add_menu_page(
-        'WP Logbook',
+        'Logbook',
-        'WP Logbook',
+        'Logbook',
         'manage_options',
         'wp-notes',
         'wp_notes_page_callback',
@@ -179,7 +179,7 @@ function wp_notes_admin_menu() {
     );
 
     // "My Log" — the main landing submenu. Same slug as the parent
-    // menu so clicking either WP Logbook or My Log lands on the same
+    // menu so clicking either Logbook or My Log lands on the same
     // central dashboard (the parent's wp_notes_page_callback already
     // renders form + active list + completed list).
     //
@@ -218,7 +218,7 @@ function wp_notes_admin_menu() {
         'wp_notes_import_export_page'
     );
 
-    // About submenu — the WP Logbook brand is already carried by the
+    // About submenu — the Logbook brand is already carried by the
     // parent menu, so the submenu can be plain-spoken.
     add_submenu_page(
         'wp-notes',
@@ -291,7 +291,7 @@ function wp_notes_settings_page() {
     settings_errors('wp_notes_settings');
     ?>
     <div class="wrap">
-        <h1>WP Logbook Settings</h1>
+        <h1>Logbook Settings</h1>
         <form method="post" action="options.php">
             <?php
             settings_fields('wp_notes_settings');
@@ -313,7 +313,7 @@ function wp_notes_settings_page() {
 
 // Settings section callback
 function wp_notes_section_callback() {
-    echo '<p>Configure default settings for WP Logbook.</p>';
+    echo '<p>Configure default settings for Logbook.</p>';
 }
 
 // Font setting callback
@@ -705,8 +705,8 @@ function wp_notes_ajax_submit_feedback() {
     ];
     $topics_pretty = array_map(function ($t) use ($topic_labels) { return $topic_labels[$t] ?? $t; }, $topics);
 
-    $subject = sprintf('[%s] WP Logbook feedback from %s', $site, $user->display_name ?: $user->user_login);
+    $subject = sprintf('[%s] Logbook feedback from %s', $site, $user->display_name ?: $user->user_login);
-    $body  = "Feedback received via WP Logbook → About page\n";
+    $body  = "Feedback received via Logbook → About page\n";
     $body .= str_repeat('-', 48) . "\n\n";
     $body .= 'From:    ' . ($user->display_name ?: $user->user_login) . ' <' . $user->user_email . ">\n";
     $body .= 'Site:    ' . home_url() . "\n";
@@ -820,7 +820,7 @@ function wp_notes_save_edit() {
 }
 
 /**
- * Main WP Logbook page — central hub for note management
+ * Main Logbook page — central hub for note management
  */
 function wp_notes_page_callback() {
     if (!current_user_can('edit_posts')) {
@@ -840,7 +840,7 @@ function wp_notes_page_callback() {
     ?>
     <div class="wrap">
         <!-- Header Section with WordPress Admin Styling -->
-        <h1 class="wp-heading-inline">WP Logbook</h1>
+        <h1 class="wp-heading-inline">Logbook</h1>
         <span class="page-title-action">v<?php echo esc_html(WP_NOTES_VERSION); ?></span>
         <hr class="wp-header-end">
 
@@ -1396,7 +1396,7 @@ function wp_notes_dashboard_widget() {
 function wp_notes_add_dashboard_widgets() {
     wp_add_dashboard_widget(
         'wp_notes_dashboard_widget',
-        'WP Logbook',
+        'Logbook',
         'wp_notes_dashboard_widget'
     );
 }
@@ -1407,7 +1407,7 @@ function wp_notes_register_cpt() {
     $labels = array(
         'name'               => __('Notes', 'a-wp-notes'),
         'singular_name'      => __('Note', 'a-wp-notes'),
-        'menu_name'         => __('WP Logbook', 'a-wp-notes'),
+        'menu_name'         => __('Logbook', 'a-wp-notes'),
         'add_new'           => __('Add New', 'a-wp-notes'),
         'add_new_item'      => __('Add New Note', 'a-wp-notes'),
         'edit_item'         => __('Edit Note', 'a-wp-notes'),
@@ -1640,7 +1640,7 @@ function wp_notes_migration_notice() {
         ?>
         <div class="notice notice-info is-dismissible">
             <p>
-                <?php _e('WP Logbook needs to migrate your existing notes to the new storage system.', 'a-wp-notes'); ?>
+                <?php _e('Logbook needs to migrate your existing notes to the new storage system.', 'a-wp-notes'); ?>
                 <a href="<?php echo esc_url(admin_url('admin.php?page=wp-notes-settings&action=migrate')); ?>" class="button button-primary">
                     <?php _e('Start Migration', 'a-wp-notes'); ?>
                 </a>