Advanced Cart for Magento 2

What you get

Magento 2 Advanced Cart Page

Panth Advanced Cart Page adds a set of blocks to the Magento 2 shopping cart page: a free shipping progress bar, trust badges, a continue shopping link, a cart savings line, an estimated delivery range, an order notes textarea and a replacement empty cart page. Order notes are stored on the quote, copied to the order when it is placed, and shown on the customer order view, the admin order view and as a hidden column in the admin order grid.

The module ships two sets of cart templates. The block class selects the Hyva templates (Alpine.js and Tailwind classes) or the Luma templates (inline CSS and vanilla JavaScript) at render time using the theme detection provided by Panth_Core. Every feature has its own enable switch and its settings can be changed per store view.

Product page: kishansavaliya.com/magento-2-advancedcart.html

Features

• Free shipping progress bar above the cart items. It compares the quote base subtotal with the configured threshold (a base currency amount), fills a bar to the matching percentage and prints a progress or achieved message. The threshold and the remaining amount are converted to the store view currency before they are printed. The progress message supports a {{remaining}} placeholder for the formatted remaining amount.
• Continue shopping link above the cart items with a configurable label and a URL resolved against the store base URL.
• Order notes textarea below the cart items. Input is saved to the quote with a debounced AJAX request (800 ms after the last keystroke). HTML tags are stripped and the text is cut to the configured maximum length on the server.
• Order note field injected into the Luma checkout summary sidebar, pre-filled from the quote and saved with the same AJAX endpoint. A status line below the field shows "Saving..." while the request runs and "Saved" for two seconds afterwards.
• Order note copied from the quote to the order by an observer on sales_model_service_quote_submit_before while the order is placed (storefront, REST and GraphQL checkout).
• Order note displayed on the storefront order view page and in a "Customer Order Note" section on the admin order view.
• "Order Note" column added to the admin sales order grid (hidden by default, text filter).
• Cart savings line in the cart summary. The amount is the larger of the applied base discount amount and the difference between product regular prices and the quote item base prices multiplied by quantity, converted to the store view currency. The line is hidden when the amount is zero.
• Estimated delivery range in the cart summary, computed as a minimum and maximum number of business days from the current store date. Saturdays and Sundays are skipped; public holidays are not.
• Trust badges under the cart summary. Six badge keys are available: secure_checkout, money_back, free_returns, fast_shipping, support_24_7, quality_guarantee. Icons are inline SVG in the template.
• Replacement template for the empty cart block with a configurable heading, message and button label.
• Quantity +/- buttons around each cart item quantity input (input[data-role="cart-item-qty"]) on Hyva and Luma. When the theme already renders buttons next to the input, those are kept and no second pair is added. When the setting is off, buttons placed directly next to the input are hidden.

Usage

Cart page

The layout update for checkout_cart_index places the blocks as follows:

• checkout.cart.form.before: free shipping bar, then the continue shopping link
• checkout.cart.widget: order notes textarea (collapsible details element, open by default, with a character counter)
• cart.summary.before: cart savings line, then estimated delivery range (Hyva)
• cart.summary: cart savings line, then estimated delivery range, after the totals (Luma and other themes without cart.summary.before; removed on Hyva by hyva_checkout_cart_index.xml)
• cart.summary: trust badges (last child)
• before.body.end: quantity +/- buttons script
• checkout.cart.empty: template replaced with the module's empty cart template

The same layout update sets the page title classes text-3xl font-bold mb-6 text-center on page.main.title.

Each block renders nothing when its feature is disabled. The order notes textarea posts to advancedcart/cart/savenote with the form key; the response is JSON with a success flag. The endpoint rejects requests without a valid form key and only updates an existing active quote of the current session; it does not create a new quote.

Checkout page (Luma)

On checkout_index_index a script is added at before.body.end (only when the module is enabled). It uses RequireJS and jQuery to insert a labelled textarea into the order summary sidebar (.opc-block-summary), trying in order: before .checkout-methods-items, before the place order action, after the last .payment-option block, or after the totals table. It retries every 600 ms for up to 60 attempts. Changes are saved with the same AJAX endpoint as the cart page. On a body with the class panth-checkout-extended the inline styles are skipped so the theme can style the field.

Order placement

When a quote is converted to an order, the observer Observer\CopyOrderNoteToOrder on sales_model_service_quote_submit_before copies a non-empty panth_order_note from the quote onto the order before the order is saved. No second order save is made.

Order views

• Storefront order view (sales/order/view): an "Order Note" box is printed after the order details when a note exists and the order notes feature is enabled. The block is marked non-cacheable.
• Admin order view: a "Customer Order Note" section is added to the order_additional_info container when a note exists.
• Admin Sales > Orders grid: an "Order Note" column can be enabled from the Columns control. The value is copied into sales_order_grid when the order grid row is written, so orders placed before this version show an empty value until their grid row is refreshed.

Templates

Templates can be overridden in a theme under Panth_AdvancedCart/templates/:

• cart/free-shipping-bar.phtml, cart/continue-shopping.phtml, cart/order-notes.phtml, cart/cart-savings.phtml, cart/estimated-delivery.phtml, cart/trust-badges.phtml, cart/qty-buttons.phtml, cart/empty-cart.phtml (Hyva)
• cart/luma/*.phtml with the same file names (Luma; selected by Block\Cart\CartBlock when Panth\Core\Helper\Theme::isHyva() returns false)
• checkout/order_note.phtml (Luma checkout sidebar script)
• order/note.phtml (storefront order view)
• Admin: order/note.phtml (admin order view)

The empty cart block is Magento's own checkout.cart.empty block, so the layout always sets cart/empty-cart.phtml; on non-Hyva themes that template renders cart/luma/empty-cart.phtml instead.

There are no cron jobs, console commands, web API routes or widgets in this module. The only observer is the order note copy described under Order placement.

Documentation

USER_GUIDE.md describes each configuration group, where order notes appear, theme handling and a short troubleshooting list.

Changelog

See CHANGELOG.md.

Compatibility

Composer constraints on Magento packages: magento/framework >= 103.0, magento/module-checkout >= 100.4, magento/module-quote >= 101.2, magento/module-sales >= 103.0, magento/module-store >= 101.1, magento/module-backend >= 102.0, magento/module-config >= 101.2, magento/module-ui >= 101.2, magento/module-catalog >= 104.0.

Requirements

• Magento Open Source or Adobe Commerce 2.4.4 to 2.4.8
• PHP 8.1 or newer
• mage2kishan/module-core ^1.0 (module Panth_Core); the module uses Panth\Core\Helper\Theme for theme detection and declares Panth_Core in its load sequence
• magento/framework, magento/module-checkout, magento/module-quote, magento/module-sales, magento/module-store, magento/module-backend, magento/module-config, magento/module-ui and magento/module-catalog in the versions listed above

No other packages are required or suggested by composer.json.

Installation

composer require mage2kishan/module-advancedcart
bin/magento module:enable Panth_Core Panth_AdvancedCart
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

setup:di:compile is only needed when the store runs in production mode. The module ships no files under view/*/web, so setup:static-content:deploy is not required for this module.

setup:upgrade applies the declarative schema, which adds the panth_order_note column to the quote, sales_order and sales_order_grid tables.

Check the result with:

bin/magento module:status Panth_AdvancedCart

Configuration

Admin path: Stores > Configuration > Panth Extensions > Advanced Cart Page. The section is available at default, website and store view scope. All settings live under the config path prefix panth_advancedcart/.

General Settings

Config path: panth_advancedcart/general/enabled

Free Shipping Progress Bar

Config paths: panth_advancedcart/free_shipping_bar/enabled, .../threshold, .../message_progress, .../message_achieved. The threshold and message fields are only shown when the bar is enabled. The bar does not read the shipping method or cart price rule configuration; set the threshold to match your actual free shipping rule.

Quantity +/- Buttons

Config path: panth_advancedcart/qty_buttons/enabled

Trust Badges

Config paths: panth_advancedcart/trust_badges/enabled, .../badges

Continue Shopping Button

Config paths: panth_advancedcart/continue_shopping/enabled, .../label, .../url

Cart Savings Display

Config path: panth_advancedcart/cart_savings/enabled

Estimated Delivery Date

Config paths: panth_advancedcart/estimated_delivery/enabled, .../min_days, .../max_days, .../label. Dates are printed in the M j format (for example "Oct 2 - Oct 8").

Order Notes

Config paths: panth_advancedcart/order_notes/enabled, .../placeholder, .../max_length

Enhanced Empty Cart

Config paths: panth_advancedcart/empty_cart/enabled, .../heading, .../message, .../button_label

With the default configuration every feature is on as soon as the module is enabled.

Uninstallation

bin/magento module:disable Panth_AdvancedCart
composer remove mage2kishan/module-advancedcart
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Disabling the module leaves the panth_order_note columns on quote, sales_order and sales_order_grid, and the panth_advancedcart/* values in core_config_data, in place. Remove them manually if they are no longer wanted. Keep Panth_Core if other Panth modules use it.

License

Free and open source under the MIT License. See LICENSE.txt.

Developer Notes

• Module name: Panth_AdvancedCart
• Composer package: mage2kishan/module-advancedcart (version 1.0.11)
• PHP namespace: Panth\AdvancedCart
• Load sequence: Panth_Core, Magento_Checkout, Magento_Quote, Magento_Sales, Magento_Catalog
• Frontend route: advancedcart (controller Controller\Cart\SaveNote, POST only, returns JSON)
• Key classes:
• Helper\Data: typed getters for every setting, isEnabled() and isFeatureEnabled(string $group)
• ViewModel\CartEnhancements: subtotal, free shipping percentage and message, cart savings, trust badge data, estimated delivery range, order note values, isHyva()
• Block\Cart\CartBlock: rewrites the template path from cart/ to cart/luma/ on non-Hyva themes
• Block\Checkout\OrderNote, Block\Order\OrderNote, Block\Adminhtml\Order\OrderNote: order note blocks for checkout, storefront order view and admin order view
• etc/events.xml registers Observer\CopyOrderNoteToOrder on sales_model_service_quote_submit_before (all areas).
• etc/theme-config.json declares colour tokens (primary colour, free shipping bar, savings, estimated delivery, trust badges) for use by a Panth theme build.
• Database changes (etc/db_schema.xml): nullable text column panth_order_note on quote, sales_order and sales_order_grid. No new tables are created.
• ACL: no custom resources. The configuration section uses Magento_Config::config.