dimitribouteille / wc-ajax-cart

Librairie Wordpress qui permet de créer un panier en Ajax pour le plugin Woocommerce.

Wordpress Ajax Cart for Woocommerce

Librairie Wordpress qui permet de créer un panier en Ajax pour le plugin Woocommerce. Pour le moment, la librairie contient que la partie back-end, c'est-à-dire le PHP. La partie en Javascript reste à la charge du développeur.

À l'heure d'aujourd'hui, seules les actions suivantes sont supportées par la librairie :

• Ajout et réduction de la quantité d'un produit
• Suppression d'un produit du panier
• Ajout d'un code promo
• Suppression d'un code promo

Installation

Si vous utilisez composer :

composer require dbout/wc-ajax-cart

Si vous n'utilisez pas composer, importez la classe Dbout\Woocommerce\WcAjaxCart\WcAjaxCart dans le fichier functions.php de votre thème :

<?php

require_once DIR_TO_PATH.'/WcAjaxCart.php';

use Dbout\Woocommerce\WcAjaxCart;
WcAjaxCart::getInstance()->loadFiles();

Utilisation

Afin d'enregistrer les actions ajax dans Wordpress, ajoutez ces quelques lignes en haut du fichier functions.php de votre thème :

<?php

use Dbout\Woocommerce\WcAjaxCart\WcAjaxCart;
WcAjaxCart::getInstance()->register();

Et voilà, les actions ajax sont enregistrées dans Wordpress !

Afin de gérer au mieux les URL(endpoints) des actions, la librairie propose plusieurs fonctions d'aides pour chaque action :

• ajaxCartAddQuantityUrl(string $itemId) : Retourne l'URL qui permet d'augmenter la quantité d'un produit.

• ajaxCartRemoveQuantityUrl(string $itemId) : Retourne l'URL qui permet de réduire la quantité d'un produit.

• ajaxCartRemoveCouponUrl(string $coupon) : Retourne l'URL qui permet de supprimer un code promo.

• ajaxCartAddCouponUrl(string $coupon = null) : Retourne l'URL qui permet d'ajouter un code promo.

Réponse Ajax

Par défaut, l'ensemble des actions retournent un objet Dbout\Woocommerce\WcAjaxCart\Response\InterfaceWcAjaxCartResponse qui une fois envoyé au navigateur a le format suivant :

{
    "status": {
        "code": 200,
        "error_message": null
    },
    "results": {}
}

Il est possible de modifier la structure de la réponse, à l'aide de deux filtres (filter en Wordpress) :

• dbout_wc_ajax_cart_response : Qui est appelé juste avant l'envoi de la réponse au navigateur.

add_filter('dbout_wc_ajax_cart_response', function($response, $action) {

    // Do someting ..
    
    return $response;
});

• dbout_wc_ajax_cart_response_success : Qui est appelé uniquement lorsque l'action a correctement abouti.

add_filter('dbout_wc_ajax_cart_response_success', function($response, $action) {

    // Do someting ..
    
    return $response;
});