Admin Settings UI #8

New Issue

2026-09-13T07:24:50Z

kevin.bataille commented

2026-09-13 07:24:50 +00:00

Problem Statement

Users need a way to configure the plugin features. Settings should be organized, easy to understand, and accessible from the WordPress admin.

Solution

Create an admin settings page with tabs for each feature area, a dashboard for cache statistics, and admin bar integration for quick actions.

User Stories

As a site owner, I want a settings page under Settings > WP Recache, so that I can configure the plugin
As a site owner, I want settings organized by feature (Cache, CSS, JS, Images), so that I can find options easily
As a site owner, I want a dashboard tab with cache statistics, so that I can monitor performance
As a site owner, I want a purge all cache button in the admin bar, so that I can quickly clear cache
As a site owner, I want a purge individual page button next to each post, so that I can clear specific pages
As a site owner, I want import/export settings, so that I can migrate configurations
As a site owner, I want a setup wizard on first activation, so that basic settings are configured
As a site owner, I want tooltips explaining each setting, so that I understand what they do
As a site owner, I want to see which features are enabled/disabled, so that I have an overview
As a site owner, I want a link to documentation, so that I can learn more
As a site owner, I want to see server compatibility information, so that I know if features will work
As a site owner, I want one-click rollback to previous settings, so that I can recover from mistakes

Implementation Decisions

WordPress Settings API for settings registration
Tabbed interface using WordPress admin tabs
Admin bar integration via wp_admin_bar_menu hook
Settings stored in wp_options table
Import/export via JSON format
Setup wizard using transients for state tracking

Testing Decisions

Test settings page loads correctly
Test settings are saved and retrieved
Test admin bar buttons work
Test import/export works
Test setup wizard completes
Test tooltips display correctly
Test rollback works

Out of Scope

Feature implementations (separate issues)
License management (not needed for open source)

Further Notes

Admin UI should be built first as it is needed to configure all other features.

## Problem Statement Users need a way to configure the plugin features. Settings should be organized, easy to understand, and accessible from the WordPress admin. ## Solution Create an admin settings page with tabs for each feature area, a dashboard for cache statistics, and admin bar integration for quick actions. ## User Stories 1. As a site owner, I want a settings page under Settings > WP Recache, so that I can configure the plugin 2. As a site owner, I want settings organized by feature (Cache, CSS, JS, Images), so that I can find options easily 3. As a site owner, I want a dashboard tab with cache statistics, so that I can monitor performance 4. As a site owner, I want a purge all cache button in the admin bar, so that I can quickly clear cache 5. As a site owner, I want a purge individual page button next to each post, so that I can clear specific pages 6. As a site owner, I want import/export settings, so that I can migrate configurations 7. As a site owner, I want a setup wizard on first activation, so that basic settings are configured 8. As a site owner, I want tooltips explaining each setting, so that I understand what they do 9. As a site owner, I want to see which features are enabled/disabled, so that I have an overview 10. As a site owner, I want a link to documentation, so that I can learn more 11. As a site owner, I want to see server compatibility information, so that I know if features will work 12. As a site owner, I want one-click rollback to previous settings, so that I can recover from mistakes ## Implementation Decisions - WordPress Settings API for settings registration - Tabbed interface using WordPress admin tabs - Admin bar integration via wp_admin_bar_menu hook - Settings stored in wp_options table - Import/export via JSON format - Setup wizard using transients for state tracking ## Testing Decisions - Test settings page loads correctly - Test settings are saved and retrieved - Test admin bar buttons work - Test import/export works - Test setup wizard completes - Test tooltips display correctly - Test rollback works ## Out of Scope - Feature implementations (separate issues) - License management (not needed for open source) ## Further Notes Admin UI should be built first as it is needed to configure all other features.

kevin.bataille added the phase-1 label 2026-09-13 07:28:59 +00:00

kevin.bataille referenced this issue from a commit

2026-09-13 11:45:05 +00:00

feat: implement Phase 1 - Core Page Cache and Admin Settings UI

kevin.bataille closed this issue

2026-09-13 11:45:05 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: kevin.bataille/wp-recache#8