# fluent-cart/1.6.5/app/Services/Renderer/CheckoutRenderer.php

FluentCart A New Era of eCommerce – Faster, Lighter, and Simpler, version 1.6.5. 1,049 lines.

- Page: https://pluginprobe.com/plugins/fluent-cart/1.6.5/code/app/Services/Renderer/CheckoutRenderer.php
- Raw: https://pluginprobe.com/plugins/fluent-cart/1.6.5/raw/app/Services/Renderer/CheckoutRenderer.php
- Modified: 2026-09-24T15:16:34+00:00

Line numbers below start at 1. Link to a line or a range by appending a fragment to the
page URL, for example `https://pluginprobe.com/plugins/fluent-cart/1.6.5/code/app/Services/Renderer/CheckoutRenderer.php#L10-L20`.

```php
<?php

namespace FluentCart\App\Services\Renderer;

use FluentCart\Api\PaymentMethods;
use FluentCart\Api\Resource\CustomerResource;
use FluentCart\Api\Resource\FrontendResource\CustomerAddressResource;
use FluentCart\Api\StoreSettings;
use FluentCart\App\App;
use FluentCart\App\Helpers\AddressHelper;
use FluentCart\App\Helpers\CartHelper;
use FluentCart\App\Models\Cart;
use FluentCart\App\Services\Localization\LocalizationManager;
use FluentCart\App\Services\URL;
use FluentCart\Framework\Support\Arr;

class CheckoutRenderer
{

    private $cart;

    private $requireShipping;

    private $hasSubscription = false;

    private $config = [];

    private $billingAddress = [];

    private $shippingAddress = [];

    private $storeSettings;

    public function __construct(Cart $cart, $config = [])
    {
        $this->cart = $cart;
        $this->requireShipping = $cart->requireShipping();
        $this->hasSubscription = $cart->hasSubscription();

        $formData = Arr::get($cart->checkout_data, 'form_data', []);
        $this->storeSettings = new StoreSettings();

        $fallbackCountry = '';
        $HTTP_CF_IP_COUNTRY = Arr::get(App::request()->server(), 'HTTP_CF_IPCOUNTRY');

        if ($HTTP_CF_IP_COUNTRY) {
            $fallbackCountry = $HTTP_CF_IP_COUNTRY;
        }

        $this->billingAddress = [
            'full_name' => trim($this->cart->first_name . ' ' . $this->cart->last_name),
            'country' => Arr::get($formData, 'billing_country', $fallbackCountry),
            'address_1' => Arr::get($formData, 'billing_address_1', ''),
            'address_2' => Arr::get($formData, 'billing_address_2', ''),
            'city' => Arr::get($formData, 'billing_city', ''),
            'state' => Arr::get($formData, 'billing_state', ''),
            'postcode' => Arr::get($formData, 'billing_postcode', ''),
            'company_name' => Arr::get($formData, 'billing_company_name', ''),
            'phone' => Arr::get($formData, 'billing_phone', ''),
        ];

        if ($this->requireShipping) {
            if (Arr::get($formData, 'ship_to_different', '') === 'yes') {
                $shippingCountry = Arr::get($formData, 'shipping_country', $fallbackCountry);
                $shippingValidations = array_filter(CheckoutFieldsSchema::getCheckoutFieldsRequirements('shipping', 'physical'));
                if (!Arr::has($shippingValidations, 'country')) {
                    $shippingCountry = Arr::get($formData, 'billing_country');
                }

                $this->shippingAddress = [
                    'full_name' => Arr::get($formData, 'shipping_full_name', ''),
                    'country' => $shippingCountry,
                    'address_1' => Arr::get($formData, 'shipping_address_1', ''),
                    'address_2' => Arr::get($formData, 'shipping_address_2', ''),
                    'city' => Arr::get($formData, 'shipping_city', ''),
                    'state' => Arr::get($formData, 'shipping_state', ''),
                    'postcode' => Arr::get($formData, 'shipping_postcode', ''),
                    'company_name' => Arr::get($formData, 'shipping_company_name', ''),
                    'phone' => Arr::get($formData, 'shipping_phone', ''),
                ];
            } else {
                $this->shippingAddress = $this->billingAddress;
            }
        }

        $this->config = $config;
    }

    public function render($config = [])
    {
        if ($config) {
            $this->config = wp_parse_args($config, $this->config);
        }

        $this->wrapperStart();
        $this->renderNotices();

        $this->renderCheckoutForm();

        $this->wrapperEnd();
    }

    public function getFragment($fragmentName)
    {
        $maps = [
            'shipping_methods' => 'renderShippingOptions',
            'payment_methods' => 'renderPaymentMethods',
            'cart_summary_fragment' => 'renderSummaryFragment'
        ];

        if (isset($maps[$fragmentName])) {
            ob_start();
            $this->{$maps[$fragmentName]}();
            return ob_get_clean();
        }
        return '';

    }

    public function wrapperStart()
    {
        $classNames = [
            'fluent-cart-checkout-page',
            'fct-checkout',
            'fct-checkout-type-' . $this->cart->cart_group
        ];
        $configClass = Arr::get($this->config, 'wrapper_class', '');

        if ($configClass) {
            $classNames[] = $configClass;
        }

        $classNames = apply_filters('fluent_cart/checkout_page_css_classes', $classNames, [
            'cart' => $this->cart
        ]);

        $classNames = array_filter(array_unique($classNames));

        $atts = [
            'class' => implode(' ', $classNames),
            'data-fluent-cart-checkout-page' => '',
        ];

        do_action('fluent_cart/before_checkout_page_start', [
            'cart' => $this->cart
        ]);
        ?>
        <div <?php RenderHelper::renderAtts($atts); ?> role="main"
            aria-label="<?php esc_attr_e('Checkout Page', 'fluent-cart'); ?>">
            <?php
            $hookData = [
                'cart' => $this->cart
            ];
            do_action('fluent_cart/after_checkout_page_start', $hookData);
    }

    public function renderNotices()
    {
        $notices = Arr::get($this->cart->checkout_data, '__cart_notices', []);
        $hookedNotices = apply_filters('fluent_cart/checkout_page_notices', [], [
            'cart' => $this->cart
        ]);
        if (!$notices && !$hookedNotices) {
            return;
        }
        ?>
            <div class="fct-cart-notices" role="status" aria-live="polite">
                <?php foreach ($notices as $notice):
                    if (empty($notice['content'])) {
                        continue;
                    } ?>
                    <div class="fct-alert">
                        <?php echo wp_kses_post($notice['content']); ?>
                    </div>
                <?php endforeach; ?>
                <?php foreach ($hookedNotices as $notice):
                    if (empty($notice['content'])) {
                        continue;
                    } ?>
                    <div class="fct-alert">
                        <?php echo wp_kses_post($notice['content']); ?>
                    </div>
                <?php endforeach; ?>
            </div>
            <?php
    }

    public function renderCheckoutForm()
    {
        global $wp;
        $current_url = home_url(add_query_arg([], $wp->request));
        $current_url = add_query_arg(App::request()->all(), $current_url);

        $formAttributes = [
            'method' => 'POST',
            'data-fluent-cart-checkout-page-checkout-form' => '',
            'class' => 'fct_checkout fluent-cart-checkout-page-checkout-form',
            'action' => $current_url,
            'enctype' => 'multipart/form-data',
        ];
        do_action('fluent_cart/before_checkout_form', ['cart' => $this->cart]);
        ?>
            <form <?php RenderHelper::renderAtts($formAttributes); ?>
                aria-label="<?php esc_attr_e('Checkout Form', 'fluent-cart'); ?>">
                <?php do_action('fluent_cart/checkout_form_opening', ['cart' => $this->cart]); ?>
                <div class="fct_checkout_inner">
                    <div class="fct_checkout_form">
                        <div class="fct_checkout_form_items">
                            <?php $this->renderNameFields(); ?>

                            <?php $this->renderCreateAccountField(); ?>

                            <?php do_action('fluent_cart/before_billing_fields', ['cart' => $this->cart]); ?>

                            <?php $this->renderAddressFields(); ?>
                            <div class="fct_checkout_shipping_methods <?php echo $this->requireShipping ? '' : 'is-hidden' ?>">
                                <?php $this->renderShippingOptions(); ?>
                            </div>

                            <?php $this->agreeTerms(); ?>

                            <?php do_action('fluent_cart/before_payment_methods', ['cart' => $this->cart]); ?>

                            <div class="fct_checkout_payment_methods " data-fluent-cart-checkout-payment-methods>
                                <?php $this->renderPaymentMethods(); ?>
                            </div>

                            <?php do_action('fluent_cart/after_payment_methods', ['cart' => $this->cart]); ?>

                            <?php $this->renderCheckoutButton(); ?>

                            <?php do_action('fluent_cart/after_checkout_button', ['cart' => $this->cart]); ?>

                        </div>
                    </div>
                    <div class="fct_checkout_summary">
                        <div class="fct_summary active" data-fluent-cart-checkout-page-checkout-form-order-summary
                            aria-labelledby="order-summary-heading">
                            <span id="order-summary-heading" class="sr-only">
                                <?php esc_html_e('Order Summary', 'fluent-cart'); ?>
                            </span>

                            <?php (new CartSummaryRender($this->cart))->render(); ?>
                            <?php $this->renderOrderNoteField(); ?>
                            <?php do_action('fluent_cart/after_order_notes', ['cart' => $this->cart]); ?>
                        </div>
                    </div>
                </div>
            </form>
            <?php
            do_action('fluent_cart/after_checkout_form', ['cart' => $this->cart]);
    }

    public function wrapperEnd()
    {
        do_action('fluent_cart/before_checkout_page_close', [
            'cart' => $this->cart
        ]);
        ?>
        </div>
        <?php
        do_action('fluent_cart/after_checkout_page', [
            'cart' => $this->cart
        ]);
    }

    public function renderCreateAccountField($atts = [])
    {
        //check store settings also
        $attr_title = Arr::get($atts, 'title');
        $extraClass = Arr::get($atts, 'wrapper_atts') ? '' : 'fct-has-default-font-size';

        ?>
            <?php if (!is_user_logged_in() && $this->storeSettings->get('user_account_creation_mode') === 'user_choice'): ?>
                <div class="fct_allow_create_account_wrapper <?php echo esc_attr($extraClass); ?>">
                    <?php
                        $formRender = new FormFieldRenderer();
                        $label = __('Create an account?', 'fluent-cart');
                        if (!empty($attr_title)) {
                            $label = $attr_title;
                        }
                        $formRender->renderField([
                            'type' => 'checkbox',
                            'id' => 'allow_create_account',
                            'name' => 'allow_create_account',
                            'checkbox_value' => 'yes',
                            'label' => $label,
                            'value' => Arr::get($this->cart->checkout_data, 'form_data.allow_create_account', ''),
                            'wrapper_class' => 'fct_create_account_wrapper',
                        ]);
                    ?>
                </div>
            <?php endif;?>

        <?php
    }

    public function renderNameFields()
    {
        $schema = CheckoutFieldsSchema::getNameEmailFieldsSchema($this->cart);
        if (!$schema) {
            return;
        }
        (new FormFieldRenderer())->renderSection($schema);
    }

    public function renderB2BToggle()
    {
        if (!CheckoutFieldsSchema::hasAnyBusinessFields()) {
            return;
        }

        if (CheckoutFieldsSchema::isB2BOnlyMode()) {
            $this->renderBusinessDetailsSection(true);
            return;
        }

        $isB2B = Arr::get($this->cart->checkout_data, 'form_data.is_business', 'no') === 'yes';

        $hasBusinessSection = CheckoutFieldsSchema::isCompanyNameEnabled()
            || CheckoutFieldsSchema::isLegalRegistrationIdEnabled()
            || CheckoutFieldsSchema::isVatNumberEnabled();

        $extraAtts = [
            'data-fluent-cart-b2b-toggle' => 'yes',
            'aria-expanded'               => $isB2B ? 'true' : 'false',
        ];
        if ($hasBusinessSection) {
            $extraAtts['aria-controls'] = 'fct_b2b_business_section';
        }
        ?>
        <div class="fct_b2b_toggle_wrapper fct-has-default-font-size">
            <?php
            (new FormFieldRenderer())->renderField([
                'type'           => 'checkbox',
                'id'             => 'is_business',
                'name'           => 'is_business',
                'checkbox_value' => 'yes',
                'label'          => __('I am purchasing as a business', 'fluent-cart'),
                'value'          => $isB2B ? 'yes' : '',
                'extra_atts'     => $extraAtts,
            ]);
            ?>
        </div>
        <?php
        $this->renderBusinessDetailsSection($isB2B);
    }

    public function renderBusinessDetailsSection($isVisible)
    {
        $hasCompany  = CheckoutFieldsSchema::isCompanyNameEnabled();
        $hasLegalReg = CheckoutFieldsSchema::isLegalRegistrationIdEnabled();
        $hasVat      = CheckoutFieldsSchema::isVatNumberEnabled();

        if (!$hasCompany && !$hasLegalReg && !$hasVat) {
            return;
        }

        $formData         = Arr::get($this->cart->checkout_data, 'form_data', []);
        $isCompanyRequired = CheckoutFieldsSchema::isCompanyNameRequired();
        $isLegalRequired  = CheckoutFieldsSchema::isLegalRegistrationIdRequired();
        $style = $isVisible ? '' : 'display:none';
        ?>
        <div id="fct_b2b_business_section"
             data-fluent-cart-b2b-section
             class="fct_checkout_form_section fct_b2b_business_section"
             style="<?php echo esc_attr($style); ?>"
             role="group"
             aria-label="<?php esc_attr_e('Business Details', 'fluent-cart'); ?>">
            <div class="fct_form_section_body">
                <div class="fct_checkout_input_group">
                    <?php if ($hasCompany): ?>
                        <?php
                        $companyLabel = __('Company Name', 'fluent-cart');
                        $companyValue = Arr::get($formData, 'billing_company_name', '');
                        ?>
                        <div data-fluent-cart-checkout-page-form-input-wrapper
                             class="fct_input_wrapper"
                             id="billing_company_name_wrapper">
                            <label for="billing_company_name" class="sr-only">
                                <?php echo esc_html($companyLabel); ?>
                            </label>
                            <input type="text"
                                   name="billing_company_name"
                                   id="billing_company_name"
                                   autocomplete="organization"
                                   placeholder="<?php echo esc_attr($companyLabel . ($isCompanyRequired ? ' *' : '')); ?>"
                                   value="<?php echo esc_attr($companyValue); ?>"
                                   aria-label="<?php echo esc_attr($companyLabel); ?>"
                                   <?php if ($isCompanyRequired): ?> data-b2b-required="yes"<?php endif; ?>
                                   <?php if ($isCompanyRequired && $isVisible): ?> required aria-required="true"<?php endif; ?>
                            />
                        </div>
                    <?php endif; ?>

                    <?php if ($hasLegalReg): ?>
                        <?php
                        $legalLabel = __('Legal Registration ID', 'fluent-cart');
                        $legalValue = Arr::get($formData, 'billing_legal_registration_id', '');
                        ?>
                        <div data-fluent-cart-checkout-page-form-input-wrapper
                             class="fct_input_wrapper"
                             id="billing_legal_registration_id_wrapper">
                            <label for="billing_legal_registration_id" class="sr-only">
                                <?php echo esc_html($legalLabel); ?>
                            </label>
                            <input type="text"
                                   name="billing_legal_registration_id"
                                   id="billing_legal_registration_id"
                                   autocomplete="off"
                                   placeholder="<?php echo esc_attr($legalLabel . ($isLegalRequired ? ' *' : '')); ?>"
                                   value="<?php echo esc_attr($legalValue); ?>"
                                   aria-label="<?php echo esc_attr($legalLabel); ?>"
                                   <?php if ($isLegalRequired): ?> data-b2b-required="yes"<?php endif; ?>
                                   <?php if ($isLegalRequired && $isVisible): ?> required aria-required="true"<?php endif; ?>
                            />
                        </div>
                    <?php endif; ?>
                    <?php do_action('fluent_cart/checkout/b2b_extra_fields', ['cart' => $this->cart]); ?>
                </div>
            </div>
        </div>
        <?php
    }

    public function validateAddressField($config, $fields)
    {

        $type = Arr::get($config, 'type', 'billing'); // billing or shipping

        $customer = CustomerResource::getCurrentCustomer();
        if ($customer) {
            $requirementsFields = CheckoutFieldsSchema::getCheckoutFieldsRequirements(
                $type,
                Arr::get($config, 'product_type'),
                Arr::get($config, 'with_shipping')
            );
            $allowedAddresses = AddressHelper::getCustomerValidatedAddresses($config, $customer);

            if (!empty($allowedAddresses)) {
                $primaryAddress = AddressHelper::getPrimaryAddress(
                    $allowedAddresses,
                    $config,
                    $customer,
                    $type
                );


                $addressLabel = $type === 'billing' ?
                    __('Billing Address', 'fluent-cart') :
                    __('Shipping Address', 'fluent-cart');

                $countries = LocalizationManager::getInstance()->countries();

                return [
                    'address_select' => [
                        'type' => 'address_select',
                        'address_type' => $type,
                        'options' => $allowedAddresses,
                        'title' => $addressLabel,
                        'label' => '',
                        'countries' => $countries,
                        'primary_address' => $primaryAddress,
                        'value' => Arr::get($primaryAddress, 'id'),
                        'requirements_fields' => $requirementsFields
                    ]
                ];
            }

            return $fields;
        }

        return $fields;
    }

    public function renderAddressFields()
    {
        $requireShipping = $this->requireShipping;
        //        $formData = Arr::get($this->cart->checkout_data, 'form_data', []);


        //        $billingAddress = $this->billingAddress;


        //        $billingAddress['type'] = 'billing';
//        $billingAddress['product_type'] = $requireShipping ? 'physical' : 'digital';
//        $billingAddress['with_shipping'] = $requireShipping && Arr::get($formData, 'ship_to_different', '') !== 'yes';
//        $billingAddress['billing_address_id'] = Arr::get($formData, 'billing_address_id', '');

        //        $billingFields = CheckoutFieldsSchema::getAddressBaseFields($billingAddress);

        //        $billingFields = $this->validateAddressField($billingAddress, $billingFields);


        //        foreach ($billingFields as &$field) {
//            if(empty($field['wrapper_atts'])) {
//                $field['wrapper_atts'] = [];
//            }
//            $field['wrapper_atts']['data-fluent-cart-checkout-page-form-input-wrapper'] = '';
//        }

        //        $billingFields = $this->maybeRearrangeAddressFields($billingFields);


        //        $billingFields = apply_filters('fluent_cart/checkout_renderer/billing_fields', $billingFields, [
//                'checkout_renderer' => $this,
//                'cart' => $this->cart
//        ]);


        //        $formRender = new FormFieldRenderer();

        echo '<div class="fct_checkout_billing_and_shipping">';

        $this->renderBillingAddressFields();

        $this->renderB2BToggle();

        if (!$requireShipping) {
            echo '</div>';
            return;
        }

        $this->renderShipToDifferentField();
        do_action('fluent_cart/after_billing_fields_section', ['cart' => $this->cart]);

        $this->renderShippingAddressFields();
        echo '</div>';
    }

    public function renderBillingAddressFields($section_title = '')
    {

        $formData = Arr::get($this->cart->checkout_data, 'form_data', []);
        $requireShipping = $this->requireShipping;
        $billingAddress = $this->billingAddress;

        $billingAddress['type'] = 'billing';
        $billingAddress['product_type'] = $requireShipping ? 'physical' : 'digital';
        $billingAddress['with_shipping'] = $requireShipping && Arr::get($formData, 'ship_to_different', '') !== 'yes';
        $billingAddress['billing_address_id'] = Arr::get($formData, 'billing_address_id', '');
        $billingAddress['order_id'] = $this->cart->order_id ?? null;

        $billingFields = CheckoutFieldsSchema::getAddressBaseFields($billingAddress);

        $billingFields = $this->validateAddressField($billingAddress, $billingFields);

        foreach ($billingFields as &$field) {
            if (empty($field['wrapper_atts'])) {
                $field['wrapper_atts'] = [];
            }
            $field['wrapper_atts']['data-fluent-cart-checkout-page-form-input-wrapper'] = '';
        }

        $billingFields = $this->maybeRearrangeAddressFields($billingFields);


        $billingFields = apply_filters('fluent_cart/checkout_renderer/billing_fields', $billingFields, [
            'checkout_renderer' => $this,
            'cart' => $this->cart
        ]);

        do_action('fluent_cart/before_billing_fields_section', ['cart' => $this->cart]);

        $formRender = new FormFieldRenderer();
        $title = __('Billing Address', 'fluent-cart');
        if (!empty($section_title)) {
            $title = $section_title;
        }

        $formRender->renderSection([
            'id' => 'billing_address_section_section',
            'type' => 'section',
            'heading' => $title,
            'fields' => $billingFields,
            'wrapper_atts' => [
                'data-fluent-cart-checkout-page-form-section' => '',
                'role' => 'region',
                'aria-label' => __('Billing Address', 'fluent-cart')
            ]
        ]);
    }

    public function renderShipToDifferentField($atts = [])
    {
        $formRender = new FormFieldRenderer();
        $attr_title = Arr::get($atts, 'title');
        $extraClass = Arr::get($atts, 'wrapper_atts') ? '' : 'fct-has-default-font-size';
        $title = __('Ship to a different address?', 'fluent-cart');
        if (!empty($attr_title)) {
            $title = $attr_title;
        }

        ?>

        <div class="fct_ship_to_different_wrapper <?php echo esc_attr($extraClass); ?>">
            <?php
                $formRender->renderField([
                    'type' => 'checkbox',
                    'id' => 'ship_to_different',
                    'name' => 'ship_to_different',
                    'checkbox_value' => 'yes',
                    'label' => $title,
                    'value' => Arr::get($this->cart->checkout_data, 'form_data.ship_to_different', ''),
                    'extra_atts' => [
                        'data-fluent-cart-ship-to-different-address' => 'yes',
                        'aria-controls' => 'shipping_address_section_section',
                    ],
                ]);
            ?>
        </div>

        <?php
    }

    public function renderShippingAddressFields($section_title = '')
    {
        $formData = Arr::get($this->cart->checkout_data, 'form_data', []);

        $formRender = new FormFieldRenderer();

        $shippingAddress = $this->shippingAddress;
        $shippingAddress['type'] = 'shipping';
        $shippingAddress['product_type'] = 'physical';
        $shippingAddress['shipping_address_id'] = Arr::get($formData, 'shipping_address_id', '');

        $shippingFields = CheckoutFieldsSchema::getAddressBaseFields($shippingAddress);

        $shippingFields = $this->validateAddressField($shippingAddress, $shippingFields);

        $shippingFields = apply_filters('fluent_cart/checkout_renderer/shipping_fields', $shippingFields, [
            'checkout_renderer' => $this,
            'cart' => $this->cart
        ]);

        foreach ($shippingFields as &$field) {
            if (empty($field['wrapper_atts'])) {
                $field['wrapper_atts'] = [];
            }
            $field['wrapper_atts']['data-fluent-cart-checkout-page-form-input-wrapper'] = '';
        }

        $shippingFields = $this->maybeRearrangeAddressFields($shippingFields);

        $title = __('Shipping Address', 'fluent-cart');
        if (!empty($section_title)) {
            $title = $section_title;
        }

        do_action('fluent_cart/before_shipping_fields_section', ['cart' => $this->cart]);
        $formRender->renderSection([
            'id' => 'shipping_address_section_section',
            'type' => 'section',
            'heading' => $title,
            'fields' => $shippingFields,
            'wrapper_atts' => [
                'data-fluent-cart-checkout-page-shipping-fields' => '',
                'style' => Arr::get($this->cart->checkout_data, 'form_data.ship_to_different', '') === 'yes' ? '' : 'display:none',
                'role' => 'region',
                'aria-label' => __('Shipping Address', 'fluent-cart')
            ]
        ]);
        do_action('fluent_cart/after_shipping_fields_section', ['cart' => $this->cart]);
    }

    public function renderOrderNoteField($attr_title = '')
    {
        if (
            !$this->requireShipping &&
            apply_filters('fluent_cart/disable_order_notes_for_digital_products', true, [
                'cart' => $this->cart
            ])
        ) {
            return;
        }

        $noteTitle = __('Leave a Note', 'fluent-cart');
        if (!empty($attr_title)) {
            $noteTitle = $attr_title;
        }
        $fieldId = 'order_notes';

        (new FormFieldRenderer())->renderField([
            'type' => 'textarea',
            'id' => $fieldId,
            'name' => 'order_notes',
            'aria-label' => __('Order Notes', 'fluent-cart'),
            'placeholder' => __('Notes about your order, e.g. Leave it at my doorstep.', 'fluent-cart'),
            'extra_atts' => [
                'rows' => 4
            ],
            'wrapper_atts' => [
                'data-fct-item-toggle' => '',
                'class' => 'fct-toggle-field fct_order_note'
            ],
            'before_callback' => function ($field) use ($fieldId, $noteTitle) {
                $toggleId = 'order_notes_toggle';
                $wrapperId = 'order_notes_wrapper';
                ?>

            <button type="button" data-fct-item-toggle-control id="<?php echo esc_attr($toggleId); ?>"
                class="fct-toggle-control fct_order_note_toggle" aria-expanded="false"
                aria-controls="<?php echo esc_attr($wrapperId); ?>">
                <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none">
                    <path d="M15.6 12.0001L10.2 17.4001V6.6001L15.6 12.0001Z" fill="currentColor" />
                </svg>
                <?php echo esc_html($noteTitle); ?>
            </button>

            <div id="<?php echo esc_attr($wrapperId); ?>" class="fct_toggle-wrapper fct_order_note_wrapper" aria-hidden="true">
                <?php
            },
            'after_callback' => function ($field) {
                echo '</div>';
            }
        ]);

        do_action('fluent_cart/after_order_notes_field', ['cart' => $this->cart]);
    }

    public function renderShippingOptions()
    {
        if (!$this->requireShipping) {
            return;
        }

        $countryCode = $this->shippingAddress['country'] ?: $this->billingAddress['country'];
        $stateCode = $this->shippingAddress['state'] ?: $this->billingAddress['state'];
        $billingValidations = array_filter(CheckoutFieldsSchema::getCheckoutFieldsRequirements('billing', 'physical'));

        if (!isset($billingValidations['country'])) {
            $countryCode = (new StoreSettings())->get('store_country');
        }

        $availableShippingMethods = AddressHelper::getShippingMethods($countryCode, $stateCode);


        $selectedId = Arr::get($this->cart->checkout_data, 'shipping_data.shipping_method_id', '');

        $selectedId = CartHelper::resolveAutoSelectShippingMethod($this->cart, $availableShippingMethods ?: [], $selectedId);

        if (!$availableShippingMethods || is_wp_error($availableShippingMethods)) {
            (new ShippingMethodsRender($availableShippingMethods, $selectedId))->render();
        } else {
            foreach ($availableShippingMethods as $method) {
                $method->charge_amount = CartHelper::calculateShippingMethodCharge($method, $this->cart->cart_data);
            }

            (new ShippingMethodsRender($availableShippingMethods, $selectedId))->render();
        }
    }

    /**
     * Get available shipping methods considering cart's shipping classes.
     * This is used by the frontend to display profile-aware methods.
     */
    public function getProfileAwareShippingMethods($countryCode, $stateCode)
    {
        // Get general methods (backward compatible)
        $methods = AddressHelper::getShippingMethods($countryCode, $stateCode);

        if (is_wp_error($methods) || empty($methods)) {
            return $methods;
        }

        return $methods;
    }

    public function renderPaymentMethods($atts = [])
    {
        if ($this->cart->getEstimatedTotal() <= 0) {
            if (!$this->cart->hasSubscription() || $this->cart->getEstimatedRecurringTotal() <= 0) {
                return '';
            }
        }

        $selectedPaymentMethod = Arr::get($this->cart->checkout_data, 'form_data._fct_pay_method', '');
        $activePaymentMethods = PaymentMethods::getActiveMethodInstance($this->cart);
        $hadActiveMethods = !empty($activePaymentMethods);

        $activePaymentMethods = apply_filters('fluent_cart/checkout_active_payment_methods', $activePaymentMethods, [
            'cart' => $this->cart
        ]);

        if (!$selectedPaymentMethod && !empty($activePaymentMethods)) {
            // reset() not [0] — the filter above may return a non-zero-indexed array.
            $firstMethod = reset($activePaymentMethods);
            $selectedPaymentMethod = $firstMethod ? $firstMethod->getMeta('route') : '';
        }

        /**
         * The payment method rendered as checked. An add-on that renders its own
         * selector outside this list (e.g. saved payment methods) returns a route
         * that is not in the list, so no gateway here is checked — the page then
         * arrives with the add-on's choice already selected instead of a gateway
         * being checked first and switched over by JS after load.
         *
         * @param string $selectedPaymentMethod
         * @param array  $context ['cart' => Cart, 'payment_methods' => array]
         */
        $selectedPaymentMethod = (string) apply_filters('fluent_cart/checkout/selected_payment_method', $selectedPaymentMethod, [
            'cart'            => $this->cart,
            'payment_methods' => $activePaymentMethods
        ]);

        $checkoutMethodStyle = $this->storeSettings->get('checkout_method_style', 'logo');

        ?>
            <div id="fluent_payment_methods" class="fluent_payment_methods">
                <div class="fct_checkout_form_section" aria-labelledby="payment_methods_label" role="radiogroup">
                    <div class="fct_form_section_header">
                        <h4 id="payment_methods_label" class="fct_form_section_header_label">
                            <?php esc_html_e('Payment', 'fluent-cart'); ?>
                        </h4>
                    </div>
                    <div class="fct_form_section_body">
                        <div
                            class="fct_payment_methods_list fct_payment_method_mode_<?php echo esc_attr($checkoutMethodStyle); ?>">
                            <?php if (!empty($activePaymentMethods)): ?>
                                <?php foreach ($activePaymentMethods as $method): ?>
                                    <?php
                                    $isSelected = ($selectedPaymentMethod === $method->getMeta('route'));

                                    $this->renderPaymentMethod($method, [
                                        'selected_id' => $selectedPaymentMethod,
                                        'style' => $checkoutMethodStyle,
                                        'aria_checked' => $isSelected ? 'true' : 'false',
                                        'role' => 'radio'
                                    ]);
                                    ?>
                                <?php endforeach; ?>
                            <?php else: ?>
                                <?php
                                if ($hadActiveMethods) {
                                    $emptyText = esc_html__('None of the available payment methods can process this order. Please contact the store.', 'fluent-cart');
                                } else {
                                    $emptyText = esc_html__('No Payment method is activated for this site yet.', 'fluent-cart');
                                }
                                if (current_user_can('manage_options')) {
                                    $emptyText .= '<a href="' . esc_url(URL::getDashboardUrl('settings/payments')) . '" target="_blank">' . esc_html__('Activate from settings.', 'fluent-cart') . '</a>';
                                }
                                echo '<div class="fct-empty-state">' . wp_kses_post($emptyText) . '</div>';
                                ?>
                            <?php endif; ?>
                        </div>
                    </div>
                </div>
            </div>
            <?php
    }

    public function renderCheckoutButton($atts = '')
    {

        $placeOrderButtonText = apply_filters('fluent_cart/checkout_page_order_button_text', __('Place order', 'fluent-cart'));
        $attributes = [
            'type' => 'submit',
            'class' => 'fct_place_order_btn large',
            'id' => 'fluent_cart_order_btn',
            'data-fluent-cart-checkout-page-checkout-button' => '',
            'data-value' => $placeOrderButtonText,
            'disabled' => ''
        ];

        // Parse $atts using WordPress shortcode_atts or wp_parse_args
        if (!empty($atts)) {
            // Extract attributes from string
            $parsed = shortcode_parse_atts($atts);

            if (isset($parsed['class'])) {
                $attributes['class'] .= ' ' . $parsed['class'];
                unset($parsed['class']);
            }

            $attributes = array_merge($attributes, $parsed);
        }

        ?>
            <div class="fct_place_order_btn_wrap">
                <button <?php RenderHelper::renderAtts($attributes); ?>>
                    <?php echo esc_html($placeOrderButtonText); ?>
                </button>
            </div>
            <?php
    }

    protected function renderPaymentMethod($method, $config = [])
    {
        $route = $method->getMeta('route');
        $methodTitle = $method->getMeta('title');
        $methodStyle = Arr::get($config, 'style', 'logo');

        $inputAttributes = array_filter([
            'class' => 'form-radio-input',
            'type' => 'radio',
            'name' => '_fct_pay_method',
            'id' => 'fluent_cart_payment_method_' . $route,
            'value' => $route,
            'required' => true,
            'checked' => $route === Arr::get($config, 'selected_id', '') ? 'true' : '',
            'role' => Arr::get($config, 'role', 'radio'),
            'aria-checked' => Arr::get($config, 'aria_checked', 'false'),
        ]);

        $wrapperClass = $methodStyle === 'logo' ? 'fct_payment_method_logo' : 'fct_payment_method';

        $wrapperAttributes = [
            'class' => $wrapperClass . ' ' . 'fct_payment_method_wrapper fct_payment_method_' . $route,
            'tabindex' => '0',
            'role' => 'presentation'
        ];

        ?>
            <div <?php RenderHelper::renderAtts($wrapperAttributes); ?>>
                <span class="fct-payment-method-loader">
                    <svg xmlns="http://www.w3.org/2000/svg" width="18" height="18" viewBox="0 0 24 24">
                        <circle cx="12" cy="12" r="10" opacity="0.2" fill="none" stroke="currentColor" stroke-miterlimit="10"
                            stroke-width="2.5"></circle>

                        <path d="m12,2c5.52,0,10,4.48,10,10" fill="none" stroke="currentColor" stroke-linecap="round"
                            stroke-miterlimit="10" stroke-width="2.5">
                            <animateTransform attributeName="transform" attributeType="XML" type="rotate" dur="0.5s"
                                from="0 12 12" to="360 12 12" repeatCount="indefinite"></animateTransform>
                        </path>
                    </svg>
                </span>

                <input <?php RenderHelper::renderAtts($inputAttributes); ?> />
                <label for="<?php echo esc_attr('fluent_cart_payment_method_' . $route); ?>">
                    <?php
                    if ($methodStyle === 'logo') {
                        $method->prepare('logo', $this->hasSubscription);
                    } else {
                        $method->prepare('radio', $this->hasSubscription);
                    }
                    ?>

                    <?php echo esc_html($methodTitle); ?>
                </label>
                <?php if ($method->getMeta('instructions')): ?>
                    <div class="fct_payment_method_instructions" style="display: none;">
                        <?php echo wp_kses_post($method->getMeta('instructions')); ?>
                    </div>
                <?php endif; ?>
                <div class="fluent-cart-checkout_embed_payment_wrapper">
                    <?php
                    $pmContext = [
                        'route' => $route,
                        'method_title' => $methodTitle,
                        'method_style' => $methodStyle,
                    ];
                    $paymentMethodClass = '';
                    $paymentMethodClass = apply_filters('fluent_cart/payment_method_list_class', $paymentMethodClass, $pmContext);

                    ?>
                    <div class="<?php echo "fluent-cart-checkout_embed_payment_container fluent-cart-checkout_embed_payment_container_" . esc_attr($route . ' ' . $paymentMethodClass); ?>"
                        aria-hidden="true">
                        <?php do_action(
                            'fluent_cart/checkout_embed_payment_method_content',
                            [
                                'method' => $method,
                                'cart' => $this->cart,
                                'route' => $route
                            ]
                        ); ?>
                    </div>
                </div>
            </div>
            <?php
    }

    private function maybeRearrangeAddressFields($fields)
    {
        if (isset($fields['city']) && isset($fields['postcode'])) {
            $cityField = $fields['city'];
            $postcodeField = $fields['postcode'];
            unset($fields['city'], $fields['postcode']);
            $fields['city_postal'] = [
                'type' => 'sub_section',
                'wrapper_class' => 'fct_2_columns fct_checkout_city_postcode',
                'fields' => [
                    'city' => $cityField,
                    'postcode' => $postcodeField
                ],
            ];
        }

        if (isset($fields['phone'])) {
            $phoneField = $fields['phone'];
            unset($fields['phone']);
            $fields['phone'] = $phoneField;
        }

        if (isset($fields['company_name'])) {
            $companyField = $fields['company_name'];
            unset($fields['company_name']);
            $fields['company_name'] = $companyField;
        }

        return $fields;
    }


    public function agreeTerms($atts = [])
    {
        if (!CheckoutFieldsSchema::isTermsVisible()) {
            return;
        }

        $termsText = CheckoutFieldsSchema::getTermsText();
        $sectionId = 'agree_terms_section';
        $extraClass = Arr::get($atts, 'wrapper_atts') ? '' : 'fct-has-default-font-size';
        $title = Arr::get($atts, 'title');

        ?>
            <div class="fct_checkout_form_section <?php echo esc_attr($extraClass); ?>" role="group" aria-labelledby="agree_terms_label" data-fct-checkout-form-section>
                <div class="fct_form_section_body">
                    <div class="fct_checkout_agree_terms">
                        <div>
                            <label for="agree_terms" class="fct_input_label fct_input_label_checkbox">
                                <input data-fluent-cart-agree-terms="yes" type="checkbox" class="fct-input fct-input-checkbox"
                                    id="agree_terms" name="agree_terms" value="yes" required aria-required="true"
                                    aria-label="<?php echo esc_attr($termsText); ?>">
                                <?php
                                if (!empty($title)) {
                                    echo esc_html($title);
                                } else {
                                    echo wp_kses_post($termsText);
                                } ?>
                            </label>
                            <span
                                id="<?php echo esc_attr($sectionId); ?>"
                                data-fluent-cart-checkout-page-form-error=""
                                class="fct_form_error fct_error_<?php echo esc_attr($sectionId); ?>"
                                role="alert"
                                aria-live="polite"
                            ></span>
                        </div>
                    </div>
                </div>
            </div>
        <?php }

    private function renderSummaryFragment()
    {
        (new CartSummaryRender($this->cart))->render(false);
    }
}

```