Athenian Clear Cart Button for WooCommerce
Overview
Product overview
WooCommerce carts are often used as working spaces. Shoppers test configurations, compare bundles, revise larger orders, and abandon one build to start a new one. Native cart flows still make the "start over" action heavier than it should be, especially when multiple items have to be removed one by one.
Athenian Clear Cart Button solves that with a configurable reset action placed directly in the cart experience. It works across Classic Cart and Cart Block implementations, prefers a modern REST-based request flow, can fall back to AJAX, and gives administrators a stronger control panel with visual templates, settings, diagnostics, and developer hooks.
Use cases
- Cart reset
- Cart-builder workflows
- Checkout preparation
- Storefront UX
Developer
Developer starting point
This baseline documents the cart-reset implementation and integration surfaces. It does not claim that a live cart was cleared, a session was mutated, or a checkout flow was exercised.
Executive summary
WooCommerce carts are often used as working spaces. Shoppers test configurations, compare bundles, revise larger orders, and abandon one build to start a new one. Native cart flows still make the "start over" action heavier than it should be, especially when multiple items have to be removed one by one.
Athenian Clear Cart Button solves that with a configurable reset action placed directly in the cart experience. It works across Classic Cart and Cart Block implementations, prefers a modern REST-based request flow, can fall back to AJAX, and gives administrators a stronger control panel with visual templates, settings, diagnostics, and developer hooks.
Core marketing message
Athenian Clear Cart Button makes cart reset simple for customers and deployment-ready for operators.
What changed in the expanded product
The plug-in is no longer just a basic WooCommerce submenu and a frontend button injector. It now includes:
- A top-level Athenian admin presence for better suite alignment
- Template-driven setup so merchants can choose a starting visual treatment quickly
- A richer settings surface for behavior, placement, redirect flow, styling, and developer overrides
- Diagnostics and support snapshots for rollout and troubleshooting
- Integration hooks and frontend events that make it easier to connect future Athenian cart tooling
The problem it solves
- Customers often need to reset a cart quickly but must otherwise remove each line item manually.
- Mixed WooCommerce environments may use both Classic Cart and Cart Block experiences.
- Small cart UX upgrades are often implemented as brittle theme edits or one-off snippets.
- Platform teams need more than a feature toggle: they need presets, diagnostics, and clear rollout controls.
What Athenian Clear Cart Button does
1. Adds one-click cart clearing
Customers can empty the cart immediately from the cart experience.
2. Supports both major WooCommerce cart surfaces
The plugin works in:
- Classic Cart templates
- Cart Block experiences
3. Uses a resilient request strategy
The plugin prefers a primary REST route, preserves a legacy REST-compatible path, and can fall back to admin-ajax when needed.
4. Gives merchants more control
Administrators can configure:
- Button label
- Icon
- Confirmation behavior
- Placement preference
- Hide-on-empty behavior
- Redirect behavior after clearing
- Template preset
- Width, shadow, color, spacing, radius, and typography
- Custom CSS
- Selector overrides
- Debug mode
5. Adds deployment diagnostics
The admin screen includes environment checks, route visibility, file presence checks, and a copyable support snapshot for debugging rollout differences between stores.
6. Prepares the plugin for the Athenian suite
The plugin now fits better into a larger plug-in suite by exposing:
- consistent admin navigation
- stronger visual setup options
- support and diagnostic artifacts
- WordPress actions and frontend DOM events for future integrations
Why this matters commercially
- Reduces friction when customers want to restart a cart
- Helps stores with larger or more experimental cart-building behavior
- Avoids brittle custom cart template work
- Makes deployment easier across multiple storefronts
- Gives agencies and internal teams a reusable, configurable cart-reset feature instead of a one-off customization
Install
- Reviewed source folder: athenian-clear-cart-button
- Plugin version reviewed: 1.1.0
- Local source inventory: 15 files (temporary, test, and Git metadata excluded).
- GitHub baseline: https://github.com/Athenian-Brands/athenian-clear-cart-button at baseline/devdocs-1.1.0-20261006d / a49c4759e870f0ad5d3b67687036187707023fb2.
- WordPress and WooCommerce.
- Cart session behavior, block compatibility, redirects, customer state, and checkout effects require separate target-environment verification.
Configuration
- Updated positioning — see the linked technical reference excerpt.
- Executive summary — see the linked technical reference excerpt.
- Core marketing message — see the linked technical reference excerpt.
- What changed in the expanded product — see the linked technical reference excerpt.
- The problem it solves — see the linked technical reference excerpt.
- What Athenian Clear Cart Button does — see the linked technical reference excerpt.
- Why this matters commercially — see the linked technical reference excerpt.
- Suggested messaging pillars — see the linked technical reference excerpt.
- Short-form copy options — see the linked technical reference excerpt.
- Best-fit use cases — see the linked technical reference excerpt.
- Positioning statement — see the linked technical reference excerpt.
- Notes for future refinement — see the linked technical reference excerpt.
Usage
- Shortcodes detected in local PHP source: 0
- Static action/filter hooks detected in local PHP source: 15
- REST route registrations detected in local PHP source: 2
Shortcodes
- No static add_shortcode registrations were detected by the baseline scanner.
REST Endpoints
- accb/v1 — includes/class-accb-plugin.php
- wc/store/v1 — includes/class-accb-plugin.php
Hooks
- admin_enqueue_scripts — includes/class-accb-admin.php
- admin_init — includes/class-accb-admin.php
- admin_menu — includes/class-accb-admin.php
- admin_post_accb_apply_preset — includes/class-accb-admin.php
- admin_post_accb_reset_defaults — includes/class-accb-admin.php
- before_woocommerce_init — includes/class-accb-plugin.php
- init — includes/class-accb-plugin.php
- plugins_loaded — athenian-clear-cart-button.php
- plugins_loaded — includes/class-accb-plugin.php
- plugin_action_links_ — includes/class-accb-plugin.php
- rest_api_init — includes/class-accb-plugin.php
- woocommerce_cart_actions — includes/class-accb-plugin.php
- wp_ajax_accb_clear_cart — includes/class-accb-plugin.php
- wp_ajax_nopriv_accb_clear_cart — includes/class-accb-plugin.php
- wp_enqueue_scripts — includes/class-accb-plugin.php
Data Model
- See the source reference sections above for the documented persistence boundary.
API Reference
- Local source digest: c6fdc69898a8d8f9abb9bb09b2bf2420a9e96a6f709aff70d7623bc5ccca6fe6
- Repository URL: https://github.com/Athenian-Brands/athenian-clear-cart-button
- Repository reference: baseline/devdocs-1.1.0-20261006d
- Repository commit: a49c4759e870f0ad5d3b67687036187707023fb2
Source files include: assets/css/accb-admin.css, assets/css/accb-frontend.css, assets/js/accb-admin.js, assets/js/accb-frontend.js, athenian-clear-cart-button-icon.png, athenian-clear-cart-button.php, athenian-clear-cart-button.php.bak, docs/athenian-platform-marketing.md, docs/athenian-platform-technical.md, docs/marketing-document.md, includes/class-accb-admin.php, includes/class-accb-plugin.php, includes/class-accb-settings.php, readme.txt, uninstall.php
Troubleshooting
This baseline documents the cart-reset implementation and integration surfaces. It does not claim that a live cart was cleared, a session was mutated, or a checkout flow was exercised.
- Confirm the deployed plugin version, active dependencies, and current repository tree before using implementation details as a release contract.
Treat payment, carrier, vendor, shipment, inventory, account, credential, tax, AI, and external-provider behavior as integration-dependent until exercised in the target environment.
FAQ
What is this page intended to establish?
A versioned, product-linked starting point for iterative developer documentation. It combines the local implementation reference with a detected-code inventory and a committed GitHub baseline.
Is the linked repository baseline verified?
Yes. The repository URL, ref, and commit recorded on this page were verified from the clean GitHub baseline prepared for this documentation pass. That does not by itself prove fleet deployment parity.
What remains for release-grade documentation?
Reconcile the recorded source baseline with the deployed plugin version, then exercise the relevant authenticated, store, provider, payment, tax, carrier, or generated-artifact paths in the target environment.