feat: allow installments for subscription

Author: RafaMelazzo

assets/javascripts/front/checkout/model/payment/card.js

@@ -1,12 +1,13 @@
 /* globals wc_pagarme_checkout */
-
+/*jshint esversion: 8 */
 let pagarmeCard = {
     limitTokenize: 10,
     tokenExpirationAttribute: 'data-pagarmecheckout-expiration',
     cardNumberTarget: 'input[data-element="pagarme-card-number"]',
     brandTarget: 'input[data-pagarmecheckout-element="brand-input"]',
     valueTarget: 'input[data-pagarmecheckout-element="order-value"]',
     installmentsTarget: '[data-pagarme-component="installments"]',
+    installmentsInfoTarget: '[data-pagarme-component="installments-info"]',
     mundiCdn: 'https://cdn.mundipagg.com/assets/images/logos/brands/png/',
     tokenElement: '[data-pagarmecheckout-element="token"]',
     fieldsetCardElements: 'fieldset[data-pagarmecheckout="card"]',
@@ -262,12 +263,16 @@ let pagarmeCard = {
         }
         let cardForm = elem.closest("fieldset");
         let select = cardForm.find(this.installmentsTarget);
-        if (!total)
+        let info = cardForm.find(this.installmentsInfoTarget);
+        if (!total) {
             total = cartTotal;
+        }
         if ((!total) ||
             (select.data("type") === 2 && !brand) ||
-            (select.data("type") === 1 && elem.data('element') !== "order-value"))
+            (select.data("type") === 1 && elem.data('element') !== "order-value")
+        ) {
             return false;
+        }
         let storageName = btoa(brand + total);
         sessionStorage.removeItem(storageName);
         let storage = sessionStorage.getItem(storageName);
@@ -283,7 +288,7 @@ let pagarmeCard = {
                 }
             });
             ajax.done(function (response) {
-                pagarmeCard._done(select, storageName, cardForm, response);
+                pagarmeCard._done(select, info, storageName, cardForm, JSON.parse(response));
             });
             ajax.fail(function () {
                 pagarmeCard._fail(cardForm);
@@ -293,8 +298,12 @@ let pagarmeCard = {
         return true;
     },
 
-    _done: function (select, storageName, event, response) {
-        select.html(response);
+    _done: function (select, info, storageName, event, response) {
+        info.addClass('pagarme-hidden');
+        if(response.installmentsConfig > 1) {
+            info.removeClass('pagarme-hidden');
+        }
+        select.html(response.optionsHtml);
         sessionStorage.setItem(storageName, response);
         this.removeLoader(event);
     },

assets/stylesheets/front/style.css

@@ -1,3 +1,7 @@
+.pagarme-hidden {
+    display: none!important;
+}
+
 #wcmp-checkout-errors {
     display: none;
 }
@@ -67,6 +71,13 @@
     pointer-events: none;
 }
 
+#payment .payment_methods li[class*="pagarme"] .payment_box .pagarme-installments-info {
+    display: block;
+    margin: 0 .75em .25em;
+    font-size: .9em;
+    font-style: italic;
+}
+
 .woocommerce-order .woocommerce-message .pagarme-response p:last-child {
     margin-bottom: 0;
 }
@@ -132,7 +143,7 @@
 
 /* sm  */
 /* @media (min-width: 576px) {
-    
+
 } */
 
 /* md  */
@@ -151,10 +162,10 @@
 
 /* xl  */
 /* @media (min-width: 1200px) {
-    
+
 } */
 
 /* xxl  */
 /* @media (min-width: 1400px) {
-    
+
 } */

languages/woo-pagarme-payments-pt_BR.mo

@@ -5,7 +5,7 @@ msgstr ""
 "Project-Id-Version: WooCommerce Pagar.me Payments 1.0\n"
 "Report-Msgid-Bugs-To: https://wordpress.org/support/plugin/woo-pagarme-payments\n"
 "POT-Creation-Date: 2018-06-22 13:58-0300\n"
-"PO-Revision-Date: 2024-01-17 10:24-0300\n"
+"PO-Revision-Date: 2024-01-19 11:54-0300\n"
 "Last-Translator: Pagar.me\n"
 "Language-Team: \n"
 "Language: pt_BR\n"
@@ -1287,3 +1287,18 @@ msgstr "Habilita boleto para assinatura"
 
 msgid "Activates billet payment method for subscriptions."
 msgstr "Ativa o método de pagamento de boleto para assinaturas."
+
+msgid "Allow installments for subscription"
+msgstr "Permitir parcelamento para assinatura"
+
+msgid "Enable installments for subscription"
+msgstr "Habilita parcelamento para assinatura"
+
+msgid "Activates credit card installments for subscriptions."
+msgstr "Ativa parcelamento de cartão de crédito para assinaturas."
+
+msgid "Works only for monthly and yearly subscriptions."
+msgstr "Funciona apenas para assinaturas mensais e anuais."
+
+msgid "Your cart has one or more daily or weekly subscription products, which do not allow installments."
+msgstr "Seu carrinho possui um ou mais produtos de assinatura diário ou semanal, que não permitem parcelamentos."

languages/woo-pagarme-payments-pt_BR.po

@@ -14,11 +14,10 @@
 use Woocommerce\Pagarme\Block\Checkout\Gateway;
 use Woocommerce\Pagarme\Helper\Utils;
 use Woocommerce\Pagarme\Model\CardInstallments;
+use Woocommerce\Pagarme\Model\Subscription;
 use Woocommerce\Pagarme\View\Checkouts;
 
-global $woocommerce;
-
-defined( 'ABSPATH' ) || exit;
+defined('ABSPATH') || exit;
 
 /**
  * Class Installments
@@ -34,6 +33,19 @@ class Installments extends Gateway
     /** @var int  */
     protected $sequence = 1;
 
+    /** @var int  */
+    protected $cardInstallments;
+
+    /** @var Subscription  */
+    protected $subscription;
+
+    public function __construct()
+    {
+        parent::__construct();
+        $this->cardInstallments = new CardInstallments();
+        $this->subscription = new Subscription();
+    }
+
     /**
      * @param int $sequence
      * @return $this
@@ -89,8 +101,7 @@ public function getInstallmentsComponent()
 
     public function render_installments($total)
     {
-        $cardInstallments = new CardInstallments();
-        return $cardInstallments->getInstallmentsByType($total);
+        return $this->cardInstallments->getInstallmentsByType($total);
     }
 
     /**
@@ -100,4 +111,65 @@ public function render()
     {
         return $this->render_installments($this->getCartTotals());
     }
+
+    /**
+     * @return bool
+     */
+    public function hasSubscriptionProductInCart()
+    {
+        return Subscription::hasSubscriptionProductInCart();
+    }
+
+    /**
+     * @return bool
+     */
+    public function subscriptionAllowInstallments() {
+        return $this->subscription->allowInstallments();
+    }
+
+    /**
+     * @return bool
+     */
+    public function hasOneInstallmentPeriodInCart()
+    {
+        return $this->subscription->hasOneInstallmentPeriodInCart();
+    }
+
+    /**
+     * @return bool
+     */
+    public function isCcInstallmentTypeByFlag() {
+        $type = intval($this->cardInstallments->config->getCcInstallmentType()) ?? 1;
+        return $type === CardInstallments::INSTALLMENTS_BY_FLAG;
+    }
+
+    /**
+     * @return int
+     */
+    public function getConfiguredMaxCcInstallments(): int {
+        if ($this->isCcInstallmentTypeByFlag()) {
+            $flag = Utils::get('flag', false, 'esc_html');
+            $configByFlags = $this->cardInstallments->config->getCcInstallmentsByFlag();
+            return intval($configByFlags['max_installment'][$flag]);
+        }
+        return intval($this->cardInstallments->config->getCcInstallmentsMaximum());
+    }
+
+    /**
+     * @return bool
+     */
+    public function showOneInstallmentInfo()
+    {
+        if (!$this->hasSubscriptionProductInCart()) {
+            return false;
+        }
+        if (
+            $this->subscriptionAllowInstallments()
+            && $this->hasOneInstallmentPeriodInCart()
+            && ($this->getConfiguredMaxCcInstallments() > 1 || $this->isCcInstallmentTypeByFlag())
+        ) {
+            return true;
+        }
+        return false;
+    }
 }

src/Block/Checkout/Form/Installments.php

@@ -88,6 +88,9 @@ public function getConfigDataProvider()
      */
     public function getElementId(string $id)
     {
+        if (!$this->getPaymentInstance()){
+            return;
+        }
         return WCMP_PREFIX . '[' . $this->getPaymentInstance()->getMethodCode() . ']' . $id;
     }
 

src/Block/Checkout/Gateway.php

@@ -8,6 +8,7 @@
 
 use Pagarme\Core\Payment\Repositories\CustomerRepository;
 use Pagarme\Core\Payment\Repositories\SavedCardRepository;
+use Woocommerce\Pagarme\Block\Checkout\Form\Installments;
 use Woocommerce\Pagarme\Controller\Gateways\AbstractGateway;
 use Woocommerce\Pagarme\Model\CardInstallments;
 use Woocommerce\Pagarme\Model\Config;
@@ -27,13 +28,17 @@ class Checkout
     /** @var CardInstallments */
     protected $cardInstallments;
 
+    /** @var Installments */
+    protected $installments;
+
     /**
      * @var Orders
      */
     protected $ordersController;
 
     public function __construct(
-        CardInstallments $cardInstallments = null
+        CardInstallments $cardInstallments = null,
+        Installments $installments = null
     ) {
         $this->ordersController = new Orders();
         add_action('woocommerce_api_' . Model\Checkout::API_REQUEST, array($this, 'process_checkout_transparent'));
@@ -51,7 +56,11 @@ public function __construct(
         ];
         $this->cardInstallments = $cardInstallments;
         if (!$this->cardInstallments) {
-            $this->cardInstallments = new CardInstallments;
+            $this->cardInstallments = new CardInstallments();
+        }
+        $this->installments = $installments;
+        if (!$this->installments) {
+            $this->installments = new Installments();
         }
     }
 
@@ -109,13 +118,18 @@ public function build_installments()
             exit(0);
         }
 
-        $html = $this->cardInstallments->renderOptions(
+        $installmentsConfig = $this->installments->getConfiguredMaxCcInstallments();
+
+        $optionsHtml = $this->cardInstallments->renderOptions(
             $this->cardInstallments->getInstallmentsByType(
                 Utils::get('total', false),
                 Utils::get('flag', false, 'esc_html')
 
         ));
-        echo wp_kses_no_null($html);
+        echo json_encode([
+            'installmentsConfig' => $installmentsConfig,
+            'optionsHtml' => wp_kses_no_null($optionsHtml)
+        ]);
         exit();
     }
 

src/Controller/Checkout.php

@@ -72,6 +72,7 @@ public function append_form_fields()
             'cc_installments_by_flag' => $this->field_cc_installment_fields('flags'),
             'cc_allow_save' => $this->field_cc_allow_save(),
             'cc_allowed_in_subscription' => $this->field_cc_allowed_for_subscription(),
+            'cc_subscription_installments' => $this->field_cc_subscription_installments(),
         ];
     }
 
@@ -187,6 +188,28 @@ private function field_cc_allowed_for_subscription()
         ];
     }
 
+    /**
+     * @return array
+     */
+    private function field_cc_subscription_installments()
+    {
+        if (!Subscription::hasSubscriptionPlugin()){
+            return [];
+        }
+        return [
+            'title' => __('Allow installments for subscription', 'woo-pagarme-payments'),
+            'type' => 'select',
+            'options' => $this->yesnoOptions->toLabelsArray(true),
+            'label' => __('Enable installments for subscription', 'woo-pagarme-payments'),
+            'default' => $this->config->getData('cc_subscription_installments') ?? strtolower(Yesno::NO),
+            'desc_tip' => __('Activates credit card installments for subscriptions.', 'woo-pagarme-payments'),
+            'description' => __('Works only for monthly and yearly subscriptions.', 'woo-pagarme-payments'),
+            'custom_attributes' => array(
+                'data-field' => 'cc-subscription-installments',
+            ),
+        ];
+    }
+
     /**
      * @return array
      */