Opens in a new tab
Deliver toTennessee
0 0 0Cart
Get a Project Quote

Athenian Clear Cart Button for WooCommerce

v1.1.0 October 6, 2026
A configurable, deployment-ready one-click cart reset for classic and block-based WooCommerce carts.

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.

Clear-cart action across Classic Cart and Cart Block experiences.
REST-first request flow with AJAX compatibility fallback.
Admin presets, styling, placement, redirect, and diagnostics controls.
Developer hooks and frontend events for cart-tool integrations.

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

Source and dependencies
  • 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

Implementation reference sections
  • 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

Detected extension surface
  • 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

Detected shortcodes
  • No static add_shortcode registrations were detected by the baseline scanner.

REST Endpoints

Detected REST routes
  • accb/v1 — includes/class-accb-plugin.php
  • wc/store/v1 — includes/class-accb-plugin.php

Hooks

Detected 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

Persistence and integration boundary
  • See the source reference sections above for the documented persistence boundary.

API Reference

Source inventory and provenance
  • 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

Baseline review boundary
  • 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.

Changelog

1.1.0 2026-10-06