Supports: Config (Cấu Hình Sicommerce)

Class: \Ecommerce\Supports\Config
Namespace: Ecommerce\Supports

Class Config là lớp truy cập cấu hình cho toàn bộ Sicommerce. Toàn bộ config override được lưu trong một option duy nhất ecommerce_config (bảng system) và được nạp vào config container với prefix sicommerce::.

Class này không có alias toàn cục — luôn use Ecommerce\Supports\Config;.

---

Phương Thức

Config::get(string $keyword)

Lấy một giá trị config theo key dạng dot-notation.

use Ecommerce\Supports\Config;

// Lấy layout trang sản phẩm
$layout = Config::get('general.layout_products');

// Số sản phẩm mỗi trang
$perPage = Config::get('product.index.per_page');

// Có bật tính năng Brands không
$hasBrands = Config::get('general.brands'); // true/false

// Số cột trên desktop
$cols = Config::get('product.index.per_row.desktop'); // 4

// Cấu hình đặt hàng
$layoutDetail = Config::get('general.layout_products');
$weightUnit   = Config::get('general.weight_unit'); // 'gram', 'kg'...

// Thông tin đơn hàng
$securityKey = Config::get('order.securityKey');

Tương đương với:

config('sicommerce::general.layout_products');

Config::all()

Lấy toàn bộ config của Sicommerce dưới dạng mảng phẳng (đã loại bỏ prefix sicommerce::).

$allConfig = Config::all();
// ['general' => [...], 'product' => [...], 'order' => [...], 'checkout' => [...]]

Config::update($key, $value)

Cập nhật một key trong config (lưu vào DB và làm mới container).

// Cập nhật số sản phẩm mỗi trang
Config::update('product.index.per_page', 20);

// Cập nhật layout
Config::update('general.layout_products', 'layout-products-2');

Config::save($config)

Lưu toàn bộ mảng config (thay thế toàn bộ).

$config = Config::all();
$config['product']['index']['per_page'] = 16;
Config::save($config);

---

Cấu Trúc Config Mặc Định

Config được định nghĩa trong plugins/sicommerce/config/. Dưới đây là các nhóm chính:

general – Cấu hình chung

Key	Mô Tả	Giá Trị Mặc Định
general.layout_products	Layout trang sản phẩm	layout-products-1
general.ecommerce	Bật/tắt toàn bộ module giỏ hàng – thanh toán – đơn hàng	true
general.brands	Bật/tắt module Thương hiệu (menu + field chỉ hiện khi bật)	0
general.extras	Bật/tắt Extra Product Options	false
general.product_shipping_info	Bật/tắt thông tin khối lượng & kích thước sản phẩm	1
general.weight_unit	Đơn vị cân nặng	gram
general.jsClass.addCart	Class JS xử lý thêm giỏ ở trang chi tiết	AddToCartHandler
general.jsClass.cartSidebar	Class JS xử lý giỏ hàng sidebar	CartHandler
general.jsClass.checkout	Class JS xử lý trang thanh toán	CheckoutHandler

product – Cấu hình sản phẩm

Key	Mô Tả
product.index.per_page	Số SP mỗi trang
product.index.per_row.desktop	Số cột trên desktop
product.index.per_row.tablet	Số cột trên tablet
product.index.per_row.mobile	Số cột trên mobile
product.object.title.show	Hiển thị tiêu đề trong product item
product.object.title.position	Priority hiển thị tiêu đề
product.object.price.show	Hiển thị giá trong product item
product.object.price.position	Priority hiển thị giá
product.object.img	Cấu hình box ảnh product item

order – Cấu hình đơn hàng

Key	Mô Tả
order.securityKey	Tên tham số security key trong URL
order.created.send_customer	Gửi email xác nhận cho khách
order.created.send_admin	Gửi email thông báo cho admin

checkout – Cấu hình thanh toán

Key	Mô Tả
checkout.fields	Danh sách trường hiển thị ở form thanh toán
checkout.require	Danh sách trường bắt buộc nhập
checkout.policy_url	Đường dẫn trang điều khoản / chính sách
checkout.payment.default	Cổng thanh toán mặc định được chọn sẵn
checkout.shipping.default	Đơn vị vận chuyển mặc định
checkout.getInvoice	Bật/tắt tùy chọn xuất hóa đơn
checkout.taxType	Cách tính thuế: 0 không thuế, 1 theo sản phẩm, 2 theo đơn hàng
checkout.taxRate	Thuế suất áp dụng
checkout.isShippingTaxable	Phí vận chuyển có chịu thuế không
checkout.taxShippingRate	Thuế suất áp dụng cho phí vận chuyển

Đổi bất kỳ key nào trong product.object.* (style của khối sản phẩm) thì phải gọi lại Prd::buildStyle() để build lại CSS.

---

Đọc Config Trong Plugin Của Bạn

// Trong ServiceProvider hoặc bất kỳ file nào của plugin
use Ecommerce\Supports\Config;

// Kiểm tra theme đang dùng layout nào
$layout = Config::get('general.layout_products');
if($layout == 'layout-products-2') {
    // Plugin custom giao diện cho layout 2
}

// Lấy đơn vị cân nặng cho shipping
$weightUnit = Config::get('general.weight_unit');

// Số sản phẩm mỗi trang (dùng cho query)
$limit = (int)Config::get('product.index.per_page');
if($limit <= 0) $limit = 12; // Fallback

---

Thêm Config Của Plugin Vào Sicommerce Config Group

Bạn có thể mở rộng group config của Sicommerce để Admin có thể cấu hình plugin của bạn từ trang Hệ thống → Commerce:

// Đăng ký tab Setting mới
add_filter('admin_system_tabs', function($tabs) {
    $tabs['your_plugin_settings'] = [
        'label'  => 'Your Plugin',
        'group'  => 'commerce',     // Thuộc nhóm Commerce
        'action' => 'admin_your_plugin_setting',
    ];
    return $tabs;
}, 80);

// Render form cấu hình
add_action('admin_your_plugin_setting', function() {
    $apiKey = Config::get('your_plugin.api_key') ?? '';
    $form = form();
    $form->text('your_plugin[api_key]', ['label' => 'API Key'], $apiKey);
    echo $form->html();
});

// Lưu cấu hình
add_action('admin_system_commerce_your_plugin_setting_save', function() {
    $data = request()->input('your_plugin');
    Config::update('your_plugin.api_key', $data['api_key'] ?? '');
    response()->success('Đã lưu cấu hình');
});

Lưu ý: Config của Sicommerce được merge với file config trong database khi load. Nếu bạn thêm key mới, hãy đảm bảo có giá trị fallback trong file config/ của plugin Sicommerce hoặc plugin của bạn, tránh trường hợp Config::get() trả về null khi chưa được cấu hình.