Feature/rework ajax cart #1032

Axos11 · 2025-05-27T09:00:55Z

Refactors the mini-cart to use fragments for more granular updates,
improves the user experience, and prevents full page reloads.
Adds support for displaying WooCommerce notices as toasts in the mini-cart and implements a filter to enable or disable toasts.
Improves quantity update functionality in the mini-cart, including validation and handling of cart updates and error messages.
Show removal of products as well.
Splits mini-cart template into separate files

New Filters

Docs

file: ajax-cart.php

/**
 * If set to 'the notifications section in the minicart will be changed to a toast based model to save space
 * default: false
 */
add_filter('bootscore/woocommerce/notifications/mini-cart/use_toasts', '__return_true');

file: ajax-cart.php

/**
 * Enables you to alter the cart Fragments on qty update before they are transmitted back to the frontend via ajax,
The second variable can either be success or error, depending if the update was successfull or failed.
 */
$response_item['fragments_replace'] = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/fragments/replace', $response_item['fragments_replace'], 'error');

file: ajax-cart.php

/**
 * Enables you to alter the complete response item that is transmitted via ajax but with a WC-cart Session state before the qty update is applied
 */
$response_item = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/before-update', $response_item, $cart_item_key);

file: ajax-cart.php

/**
 * Enables you to alter the complete response item that is transmitted via ajax but with a WC-cart Session state after the qty update is applied.
 */
$response_item = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/after-update', $response_item, $updated_item, $cart_item_key, $cart_content_after, $cart_content_before);

file: ajax-cart.php

/**
 * Adds a custom validation of the update process after the standard woocommerce one. If false is returned. the qty won't be updated.
 */
$passed_validation_qty_update = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/validate-update', true, $cart_item_key, $cart_content_before[$cart_item_key], $qty);

file: ajax-cart.php

/**
 * If returned true, forces a complete fragment refresh that will reload the whole ajax cart like stock woocommerce does. That can come in handy if some plugin conflicts or specific products have an issue with partial refreshs.
 * default: false
 */
$response_item['force_fragments_refresh'] = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/force-full-refresh', false, $response_item, $cart_item_key, $qty);

file: ajax-cart.php

/**
 * Change the position of the toast container
 */
function change_toasts_container_position() {
  return 'position-fixed bottom-0 start-0 p-3 px-4';
}
add_filter('bootscore/class/woocommerce/toast-container', 'change_toasts_container_position');

Refactors the mini-cart template into three separate files (item, footer, main) to enable independent AJAX calls for each section. This improves modularity and allows for more efficient updates to specific parts of the mini-cart.

Refactors the mini-cart to use fragments for more granular updates, improves the user experience, and prevents full page reloads. Adds support for displaying WooCommerce notices as toasts in the mini-cart and implements a filter to enable or disable toasts. Improves quantity update functionality in the mini-cart, including validation and handling of cart updates and error messages. Adds a container for WooCommerce messages for improved handling and animation capabilities. Show removal of products as well.

Updates the CSS selector used to refresh the total amount in the mini-cart, ensuring it targets the correct element after recent template changes.

Implements button loader for products in the loop using a PHP filter instead of JavaScript. Should improve performance and cacheability.

Streamlines quantity button handling by using filters for enabling/disabling buttons, removing the need for JavaScript validation. Improves cart updating process by consolidating quantity update logic into a single function. Addresses issues with quantity input focus and blur events, ensuring proper value handling and validation.

Reimplements the quantity button logic for single product pages and legacy cart forms, ensuring correct value updates and button state management. Refactors the existing quantity button handling to differentiate between single product/legacy cart forms and the AJAX mini-cart, preventing conflicts and ensuring proper functionality in both contexts.

Refactors the mini-cart template into three separate files (item, footer, main) to enable independent AJAX calls for each section. This improves modularity and allows for more efficient updates to specific parts of the mini-cart.

Refactors the mini-cart to use fragments for more granular updates, improves the user experience, and prevents full page reloads. Adds support for displaying WooCommerce notices as toasts in the mini-cart and implements a filter to enable or disable toasts. Improves quantity update functionality in the mini-cart, including validation and handling of cart updates and error messages. Adds a container for WooCommerce messages for improved handling and animation capabilities. Show removal of products as well.

Updates the CSS selector used to refresh the total amount in the mini-cart, ensuring it targets the correct element after recent template changes.

Implements button loader for products in the loop using a PHP filter instead of JavaScript. Should improve performance and cacheability.

Streamlines quantity button handling by using filters for enabling/disabling buttons, removing the need for JavaScript validation. Improves cart updating process by consolidating quantity update logic into a single function. Addresses issues with quantity input focus and blur events, ensuring proper value handling and validation.

Reimplements the quantity button logic for single product pages and legacy cart forms, ensuring correct value updates and button state management. Refactors the existing quantity button handling to differentiate between single product/legacy cart forms and the AJAX mini-cart, preventing conflicts and ensuring proper functionality in both contexts.

… into feature/rework-ajax-add-to-cart

Consolidates quantity button handling into woocommerce.js for single product and legacy cart forms. Disables toast messages in the mini cart and reverts to normal messages.

crftwrk · 2025-05-27T10:14:10Z

Looks great!

We should fix the translations at the end https://www.vdzev.de/service/broschueren-und-arbeitsmaterial/#anlagentechnik-oder-heizungsanlagen

Axos11 · 2025-05-27T10:55:30Z

i would do that in one step with the js extraction.

Axos11 · 2025-05-28T06:43:44Z

Filters in ajax-cart.php

file: ajax-cart.php
function: If set to 'the notifications section in the minicart will be changed to a toast based model to save space
default: deactivated
to activate: add_filter('bootscore/woocommerce/notifications/mini-cart/use_toasts', '__return_true');

file: ajax-cart.php
function: Enables you to alter the cart Fragments on qty update before they are transmitted back to the frontend via ajax,
The second variable can either be success or error, depending if the update was successfull or failed.
$response_item['fragments_replace'] = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/fragments/replace', $response_item['fragments_replace'], 'error');

file: ajax-cart.php
function: Enables you to alter the complete response item that is transmitted via ajax but with a WC-cart Session state before the qty update is applied
$response_item = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/before-update', $response_item, $cart_item_key);

file: ajax-cart.php
function: Enables you to alter the complete response item that is transmitted via ajax but with a WC-cart Session state after the qty update is applied.
$response_item = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/after-update', $response_item, $updated_item, $cart_item_key, $cart_content_after, $cart_content_before);

file: ajax-cart.php
function: Adds a custom validation of the update process after the standard woocommerce one. If false is returned. the qty won't be updated.
$passed_validation_qty_update = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/validate-update', true, $cart_item_key, $cart_content_before[$cart_item_key], $qty);

file: ajax-cart.php
function: If returned true, forces a complete fragment refresh that will reload the whole ajax cart like stock woocommerce does. That can come in handy if some plugin conflicts or specific products have an issue with partial refreshs.
default: false
$response_item['force_fragments_refresh'] = apply_filters('bootscore/woocommerce/ajax-cart/update-qty/response/force-full-refresh', false, $response_item, $cart_item_key, $qty);

file: ajax-cart.php
function: if you want to change the positioning of the toast container in the ajax-cart you can do so by just changing the class.
default: 'position-fixed top-0 end-0 p-3 px-4'
apply_filters('bootscore/class/woocommerce/toast-container', 'position-fixed top-0 end-0 p-3 px-4')

Renames filters to align with Bootscore naming conventions, improving code maintainability and readability.

Moves AJAX cart JavaScript to an external file for better organization and maintainability. Fixes quantity button behavior in the mini-cart, ensuring correct increment/decrement operations. Removes duplicated line of code and updates translation strings.

Disables the quantity input field when it is set to readonly, improving the user experience by preventing interaction with a non-editable field. Improves the display when only one item remains in stock by ensuring the quantity buttons are correctly disabled.

crftwrk

Nice job! 🙏

woocommerce/inc/ajax-cart.php

Axos11 added 13 commits May 26, 2025 15:42

Splits mini-cart template into separate files

45c620a

Refactors the mini-cart template into three separate files (item, footer, main) to enable independent AJAX calls for each section. This improves modularity and allows for more efficient updates to specific parts of the mini-cart.

Fixes CSS selector for mini-cart total update

216cf12

Updates the CSS selector used to refresh the total amount in the mini-cart, ensuring it targets the correct element after recent template changes.

Adds loader to loop items via filter

a2475f0

Implements button loader for products in the loop using a PHP filter instead of JavaScript. Should improve performance and cacheability.

Splits mini-cart template into separate files

db5b64d

Refactors the mini-cart template into three separate files (item, footer, main) to enable independent AJAX calls for each section. This improves modularity and allows for more efficient updates to specific parts of the mini-cart.

Fixes CSS selector for mini-cart total update

1d2e1cc

Updates the CSS selector used to refresh the total amount in the mini-cart, ensuring it targets the correct element after recent template changes.

Adds loader to loop items via filter

fe4d32e

Implements button loader for products in the loop using a PHP filter instead of JavaScript. Should improve performance and cacheability.

Merge remote-tracking branch 'origin/feature/rework-ajax-add-to-cart'…

b6b8822

… into feature/rework-ajax-add-to-cart

crftwrk mentioned this pull request May 27, 2025

remove ajax cart from initial page load #855

Closed

crftwrk added this to v6.2.0 May 27, 2025

crftwrk moved this to In Progress in v6.2.0 May 27, 2025

crftwrk added documentation Improvements or additions to documentation WooCommerce ajax cart feature labels May 27, 2025

Refactors quantity button logic

da461bb

Consolidates quantity button handling into woocommerce.js for single product and legacy cart forms. Disables toast messages in the mini cart and reverts to normal messages.

Axos11 added 3 commits May 28, 2025 08:58

Refactors filter names for consistency

7d8d7fb

Renames filters to align with Bootscore naming conventions, improving code maintainability and readability.

crftwrk self-requested a review May 29, 2025 08:54

crftwrk approved these changes May 29, 2025

View reviewed changes

woocommerce/inc/ajax-cart.php Outdated Show resolved Hide resolved

crftwrk merged commit e3816ae into bootscore:main May 29, 2025

github-project-automation bot moved this from In Progress to Done in v6.2.0 May 29, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Feature/rework ajax cart #1032

Feature/rework ajax cart #1032

Uh oh!

Axos11 commented May 27, 2025 •

edited by crftwrk

Loading

Uh oh!

crftwrk commented May 27, 2025 •

edited

Loading

Uh oh!

Axos11 commented May 27, 2025

Uh oh!

Axos11 commented May 28, 2025 •

edited

Loading

Uh oh!

crftwrk left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Feature/rework ajax cart #1032

Feature/rework ajax cart #1032

Uh oh!

Conversation

Axos11 commented May 27, 2025 • edited by crftwrk Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

New Filters

Docs

Uh oh!

crftwrk commented May 27, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Axos11 commented May 27, 2025

Uh oh!

Axos11 commented May 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

crftwrk left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Axos11 commented May 27, 2025 •

edited by crftwrk

Loading

crftwrk commented May 27, 2025 •

edited

Loading

Axos11 commented May 28, 2025 •

edited

Loading