# fluent-cart/1.6.4/api/FluentCartGeneralApi.php

FluentCart A New Era of eCommerce – Faster, Lighter, and Simpler, version 1.6.4. 116 lines.

- Page: https://pluginprobe.com/plugins/fluent-cart/1.6.4/code/api/FluentCartGeneralApi.php
- Raw: https://pluginprobe.com/plugins/fluent-cart/1.6.4/raw/api/FluentCartGeneralApi.php
- Modified: 2025-12-02T13:21:10+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.4/code/api/FluentCartGeneralApi.php#L10-L20`.

```php
<?php

namespace FluentCart\Api;

use FluentCart\App\Modules\PaymentMethods\Core\AbstractPaymentGateway;
use FluentCart\App\Modules\PaymentMethods\Core\GatewayManager;
use FluentCart\Framework\Support\Arr;

class FluentCartGeneralApi
{
    /**
     * @var FluentCartGeneralApi
     */
    private static $instance;

    public static function getInstance()
    {
        if (!self::$instance) {
            self::$instance = new self();
        }

        return self::$instance;
    }

    public function addCustomerDashboardEndpoint($slug, $args = [])
    {
        if (!$slug) {
            throw new \Exception(esc_html__('The endpoint slug cannot be empty.', 'fluent-cart'));
        }

        $reserved = ['dashboard', 'purchase-history', 'subscriptions', 'licenses', 'downloads', 'profile'];

        if (in_array($slug, $reserved)) {
            throw new \Exception(
                sprintf(
                    /* translators: %s: The reserved endpoint slug. */
                    esc_html__(
                        'The endpoint slug "%s" is reserved and cannot be used.',
                        'fluent-cart'
                    ),
                    esc_html($slug)
                )
            );

        }

        if (!isset($args['render_callback']) && !isset($args['page_id'])) {
            throw new \Exception(esc_html__('You must provide either a render callback or a page ID for the endpoint.', 'fluent-cart'));
        }

        add_filter('fluent_cart/global_customer_menu_items', function ($items) use ($slug, $args) {
            // Add this new item just before the 'profile' item
            $profileKey = array_search('profile', array_keys($items));
            if ($profileKey !== false) {
                $items = array_slice($items, 0, $profileKey, true) +
                    [$slug => [
                        'label'     => Arr::get($args, 'title'),
                        'css_class' => 'fct-menu-item-' . $slug,
                        'link'      => \FluentCart\App\Services\URL::getCustomerDashboardUrl($slug),
                        'icon_svg'  => Arr::get($args, 'icon_svg'),
                        'icon_url'  => Arr::get($args, 'icon_url'),
                    ]] +
                    array_slice($items, $profileKey, null, true);
            } else {
                // If 'profile' is not found, just append it at the end
                if (!isset($items[$slug])) {
                    $items[$slug] = [
                        'label'     => Arr::get($args, 'title'),
                        'css_class' => 'fct-menu-item-' . $slug,
                        'link'      => \FluentCart\App\Services\URL::getCustomerDashboardUrl($slug),
                        'icon_svg'  => Arr::get($args, 'icon_svg'),
                        'icon_url'  => Arr::get($args, 'icon_url'),
                    ];
                }
            }

            return $items;
        });

        add_filter('fluent_cart/customer_portal/custom_endpoints', function ($endPoints) use ($slug, $args) {

            if (isset($args['render_callback'])) {
                $endPoints[$slug] = [
                    'render_callback' => $args['render_callback'],
                ];
            } else if (isset($args['page_id'])) {
                $endPoints[$slug] = [
                    'page_id' => $args['page_id'],
                ];
            }

            return $endPoints;
        });
    }

    public function registerCustomPaymentMethod($name, $paymentGatewayInstance)
    {
        if(! $paymentGatewayInstance instanceof AbstractPaymentGateway) {
            throw new \Exception(
                sprintf(
                    /* translators: %s: The name of the invalid payment gateway class. */
                    esc_html__(
                        'The payment gateway class "%s" is not valid. It must extend AbstractPaymentGateway.',
                        'fluent-cart'
                    ),
                    esc_html($paymentGatewayClass)
                )
            );

        }
        
        (GatewayManager::getInstance())->register($name, $paymentGatewayInstance);
    }

}

```