VI
Nhận NexCMP miễn phí
Áp dụng cho NexCMP 1.6.1·Đã cập nhật ·Xem dưới dạng Markdown

Tùy biến thương hiệu ​

Vị trí trong admin: System › Settings › Brand (/settings/branding). Liên quan: System › Settings › General (/settings) cho URL và thông tin bên bán in trên hóa đơn.

Chức năng ​

NexCMP hỗ trợ white-label: sản phẩm không mang tên nhà cung cấp, mọi thứ khách hàng nhìn thấy đều là thương hiệu của bạn. Cài đặt thương hiệu áp dụng cho các trang đăng nhập và đăng ký, portal, admin console cùng email.

Yêu cầu ​

Hạng mụcYêu cầu
RoleQuản trị viên.
Tệp tinLogo: SVG, PNG, JPEG, WEBP hoặc ICO, dung lượng tối đa 512 KB mỗi tệp.
Thành phần phụ thuộcKhông có.

Các bước thực hiện ​

  1. Mở System › Settings › Brand.

  2. Tại thẻ Identity, điền các thông tin:

    TrườngGhi chú
    Brand name (bắt buộc)Tối đa 60 ký tự. Hiển thị trong portal, email, hóa đơn và các trang pháp lý.
    Tên người bán trên hóa đơnTối đa 120 ký tự. Để trống nghĩa là sử dụng tên thương hiệu.
    Brand colorMàu #rrggbb; nút nhỏ bên cạnh trường này sẽ đặt lại về màu mặc định.
    Site currencyUSD: giá và số dư chỉ hiển thị bằng USD, không có nút chuyển đổi tiền tệ. VND: hiển thị thêm số tiền quy đổi theo tỷ giá được lưu trữ (xem Tiền tệ và tỷ giá).

  3. Nhấp Save.

  4. Trong thẻ Logo & favicon, tải lên ba hình ảnh — Logo (light background), Logo (dark background) và Favicon — bằng Upload (hoặc Replace); Remove sẽ xóa ảnh.

Trang Brand với các trường nhận diện và ba hình ảnh đã tải lên

System › Settings › General có hai tab để hoàn thiện cấu hình:

TabTrường dữ liệu
Branding & URLsBrand name (email, hóa đơn), ngôn ngữ mặc định (tiếng Anh hoặc tiếng Việt), Customer app URL, Console URL, Admin URL (liên kết mạo danh reseller) và Partner console URL (liên kết mời, email reseller). Trình hướng dẫn thiết lập sẽ điền sẵn các mục này bằng https://<domain>, https://<domain>/admin và https://<domain>/console.
Seller & invoicingTên pháp nhân, mã số thuế, địa chỉ, email liên hệ và tiền tố số hóa đơn. Xem Hóa đơn và sổ cái.

From name của email được thiết lập tại System › Settings › Email (SMTP và email).

Các tệp tải lên đều được kiểm tra ​

  • Ảnh raster được nhận diện từ nội dung tệp (không phải từ tên tệp) và được đo kích thước.
  • Tệp SVG được dựng lại từ danh sách các hình khối an toàn. Tệp chứa script, foreignObject, thuộc tính sự kiện, liên kết ngoài, url(...) trỏ ra ngoài, DOCTYPE hoặc entity sẽ bị từ chối (svg_unsafe).
  • Tệp quá lớn sẽ bị từ chối với asset_too_large, sai định dạng với asset_type, kích thước không hợp lệ với asset_dimensions.
  • Các tệp được phân phát từ chính domain của bạn với các security header nghiêm ngặt.

Kiểm tra ​

  1. Mở trang đăng nhập portal trong cửa sổ ẩn danh: logo, tên và màu sắc sẽ xuất hiện.
  2. Kiểm tra tab trình duyệt để xem favicon (trình duyệt lưu cache favicon; hãy tải lại sau khi xóa cache nếu bạn vẫn thấy favicon cũ).
  3. Kích hoạt gửi thử một email (ví dụ Send reset link cho một khách hàng thử nghiệm) và kiểm tra tên thương hiệu trong tiêu đề cùng chân trang.

Hạn mức & lưu ý ​

  • Logo cho nền tối được sử dụng khi khách hàng hoặc admin chuyển sang dark theme.
  • Reseller có thương hiệu riêng; họ tải lên tệp PNG, JPEG, WEBP hoặc ICO dung lượng tối đa 256 KB (không hỗ trợ SVG). Xem Resellers.
  • Thay đổi về màu thương hiệu hoặc logo sẽ hiển thị ở lần tải trang tiếp theo; các email đã gửi sẽ không bị thay đổi.

Xử lý sự cố ​

Hiện tượngNguyên nhânCách khắc phục
Tải lên bị từ chối: svg_unsafeSVG chứa script, liên kết hoặc tham chiếu bên ngoàiXuất tệp SVG thuần (không có script, không có ảnh bên ngoài) hoặc dùng PNG.
asset_too_largeTệp vượt quá 512 KBNén hoặc thay đổi kích thước ảnh.
asset_typeKhông phải SVG, PNG, JPEG, WEBP hoặc ICOChuyển đổi định dạng tệp.
invalid_argument: primaryMàu sắc không phải là #rrggbbSử dụng giá trị hex gồm 6 chữ số.
Vẫn hiển thị logo cũBộ nhớ cache trình duyệtTải lại cứng (hard-reload); favicon có thể mất nhiều thời gian hơn để cập nhật.
Giá chỉ hiển thị bằng USDTiền tệ của trang là USDChuyển sang VND và đảm bảo tỷ giá đã được lưu.