SureCommerce — User Guide

Products support variants (e.g., color, size). Each variant has its own price, SKU, stock, and warranty duration.

1. Create Attributes (e.g., Color, Size) at Products › Attributes.
2. Add Attribute Values (e.g., Red, Blue, S, M, L).
3. In the product form, select attributes and the system automatically generates variants.
4. Fill in price / SKU / stock / warranty duration for each variant individually.

The Warranty Information tab in the product form contains a free-text editor field to describe the warranty policy displayed on the product detail page.

The Related Products tab includes two fields to suggest additional products to customers on the detail page.

Filters help customers narrow down products by criteria such as RAM, color, size, etc. on category pages. The system loads automatically when the admin selects a Category in the form.

• Each category can be assigned its own Filter groups — configure at Products › Filters and assign to the category on the category edit page.
• When selecting a category in the product form, the Filters section loads via AJAX and displays checkboxes belonging to that category's filter groups.
• Admin checks the appropriate filter values for the product (e.g., RAM 8GB, Color Black).
• Values are saved to the product_filter_maps table linking the product to filter values.

1. Go to the Product List page.
2. Apply the desired filters (name, category, status, product type, creation date range).
3. Click the Export Excel button on the action bar.
4. The system generates a products_{timestamp}.xlsx file and returns it for download.

The exported file has the same column structure as the Import template, so it can be reused for editing and re-importing.

• No — row number.
• Slug, Name — identifier and product name.
• Attribute — list of product attributes.
• Id, Variant name, Variant attribute — variant information.
• Content, Description — detailed description and short description.
• Brand, Category — brand and category.
• Sku, Price, Price origin, Quantity, Weight — sales and inventory information per variant.
• Avatar, Slide images — thumbnail and slide images.
• Seo title, Seo description — SEO data.
• Product type, Digital attachments — product type and attached files for digital products.

During export, the system loads all relationships to ensure the data file is complete:

• productAttributes — list of product-level attributes.
• productVariants + variantAttributeValues + productAttribute + attributeValue — sufficient information to reconstruct variants.
• productVariants.productWarehouse — stock quantity.
• brand, category, seo — classification and metadata.

• The system temporarily raises the timeout to 3600s and memory to 300MB to handle large files.
• For very large lists (≥ 10,000 variants), it is recommended to export by category or by date range to reduce server load and output file size.
• On low-resource environments, consider increasing memory_limit in php.ini if out-of-memory errors still occur.

1. Go to the Product List page, click the Import button above the table.
2. Download the template file in the popup to learn the correct column structure.
3. Fill in data in the template file: each row is a variant; variants sharing the same slug are grouped into one product.
4. Return to the popup, select a .xlsx, .xls or .csv file.
5. Check Download images to server (save_image) if you want the system to automatically download images from URLs in the file to public/uploads.
6. Click Import. The system pushes data into the queue (every 5 products per ImportProductExcel job) and returns a notification with the number of products queued.

• The file is parsed using PhpSpreadsheet, reading according to standard columns in the template file.
• Data is grouped by slug; each group of 5 products is pushed into one job DreamTeam\Ecommerce\Jobs\ImportProductExcel.
• Jobs run asynchronously in the default queue, so a queue worker must be running for data to actually be created.
• If Download images to server is enabled, image URLs will be downloaded to public/uploads; if disabled, the original URLs are kept.
• Timeout/memory are temporarily increased (3600s, 300MB) to prevent failures when importing large files.

Each category can be configured with its own filters displayed on the listing page. For example: the Shirts category can filter by Color, Size; the Shoes category filters by Size, Material.

Go to Products › Filters to create a filter, then assign it to a category in the category edit page.

After creating a label, go to the Add / Edit Product page and select the label in the Product Label section. A product can have multiple labels assigned at once.

Labels will be displayed in the top corner of the product image on the product listing page and product detail page.

Each Flash Sale can contain multiple products (per variant). Configure individual prices and limited quantities for each variant:

• The Flash Sale price is joined directly into the product query via scopeQueryVariant — no additional relation loading needed.
• Flash Sale data is cached for 30 days (cache_flash_sales). Cache is automatically cleared when the promotion is updated.
• A variant can belong to multiple Flash Sales, but the system only uses the Flash Sale with the lowest price that still has stock and has not expired.
• When an order is Completed, quantity_used of the Flash Sale increases accordingly.

Status flow: New → Received → Delivering → Completed. Can be cancelled at the Received or Delivering step (if a tracking code exists).

Admin can create an order on behalf of a customer via the Add Order button. The system automatically creates a user account if the email doesn't exist.

Click on the order code to view details. Actions that can be performed here:

Click the Export Excel button on the order list to download a .xlsx file. Data is exported according to the currently applied filter (status, created date, customer...). Requires the orders_export permission.

Each coupon can limit its applicable scope. Choose one of 5 types:

In the coupon list, the Used column shows the number of times the coupon has been successfully applied. Each application is recorded in the coupon_useds table along with order info, user, and price before/after discount.

The warehouse page displays all products and variants with their current stock quantity. You can edit the quantity directly in the table without going into each individual product.

Supports bulk stock updates via Excel file:

1. Click Export Excel to download a template file with the current product list.
2. Edit the Quantity column in the file.
3. Click Import Excel, select the edited file, and the system will update the stock.

Select the corresponding static Pages to link in the footer/checkout. Leave blank if not applicable.

1. Go to Posts → Add Post.
2. Enter the Title. The Slug will be auto-generated; edit if needed.
3. Write the Content in the editor. Upload images directly into the editor or via the Media Library.
4. Select a Category and upload a Thumbnail.
5. Fill in SEO Title and SEO Description in the SEO tab.
6. Set the status to Active and click Save.

The number of posts displayed on the list and category pages is configured at Settings → Reading Settings, field "Posts per page".

The Post module injects this field into the Reading Settings page via the hook BASE_FILTER_ADD_PAGINATION_CONFIG with key post_paginate, default value 10. In code, retrieve it with: $readingConfig['post_paginate'] ?? 10.

The list page displays all static pages in a table format, including: page name, URL (slug), order, SEO score and status.

1. Go to Static Pages → Add New Page.
2. Enter the Title — a slug will be automatically generated.
3. Write the Content with the editor.
4. Switch to the SEO tab to fill in the SEO Title and Meta Description.
5. Select a Status and click Save.

Click "Create New Batch" to open the popup. Fill in the following fields:

1. Click "Download Excel Template" — the template file is auto-populated with the existing workspace + product list.
2. Fill in the 3 required columns: Batch Name, Quantity, Warranty Period. Keep the Workspace ID and Product ID already present.
3. Click "Import" and upload the completed file.
4. The system validates each row, creates batches for valid rows, and reports errors for invalid rows.

Click "Export Excel" to export all serials based on the current filter. If viewing serials of a specific batch, the exported file will only contain serials from that batch.

• Each row is a complete activation URL: SERIAL.
• The file can be used for input into a QR printer or shared with distribution partners.
• Required permission: serials_exports.

Admin can change the serial status to Inactive (status = 0) to deactivate it. A deactivated serial will not allow customer activation and will be recorded as blocked_serial in counterfeit reports if someone attempts to activate it.

Click the detail view icon to open the full page of a warranty. Information displayed includes:

From the list, admin clicks the toggle button Resolved / Unresolved on each report. The action calls AJAX to POST /counterfeit_reports/toggle-resolved and updates immediately without page reload.

The report detail page displays full information: serial, batch, workspace, customer-entered data, and history linked to the actual warranty (if the code was previously activated legitimately).

Configure reCAPTCHA for the warranty lookup page. Settings located at:

When reCAPTCHA is enabled, the warranty activation and lookup forms will require reCAPTCHA verification before submission.

Warranty settings are saved as JSON in the settings table with setting_name = 'warranty_config'. Click "Save Settings" to apply changes.

1. Enter the Menu name and click Create menu.
2. Add items to the menu: select from Pages, Articles, Categories, Custom links...
3. Drag and drop to reorder and create sub-menus.
4. Assign the menu to a display location (Menu location).
5. Click Save menu.

Each menu item can be further customized:

• Display title — set a custom display name instead of the default name.
• Icon — assign an icon to the menu item.
• CSS class — for custom styling (for those familiar with CSS).
• Open in new tab — enable to open the link in a new tab.

Write custom CSS in the editor area. The CSS will be automatically applied to the entire website.

• Change the interface without editing theme files.
• Change fonts, colors, spacing per project requirements.
• Show/hide specific elements.

Inject custom JavaScript. The JS will be automatically added to the end of the page.

• Add tracking code (Google Analytics, Facebook Pixel...).
• Integrate livechat, chatbot.
• Other custom scripts.

After saving the configuration, enter an email address in the "Send test email" field and click the test button. The system sends a sample email to that address immediately.

• If you receive the email → SMTP configuration is correct.
• If not received → check host, port, encryption, and App Password again.

Customize HTML content for each type of system email (order confirmation, warranty...) at:

This feature delays the execution of injected scripts until the user interacts with the page (scroll, click, mouse move). This helps improve Core Web Vitals and PageSpeed scores.

1. Go to google.com/recaptcha/admin/create.
2. Enter a name for the site, select the type reCAPTCHA v2 → "I'm not a robot".
3. Add your website's domain to the allowed list.
4. Click Submit — Google will provide the Site Key and Secret Key.
5. Copy both keys into the settings form and save.

Once enabled and configured, reCAPTCHA is automatically applied at the following points:

• Warranty activation form — customer serial activation page.
• Warranty lookup form — warranty information lookup page.
• Ecommerce checkout — order form on the checkout page (when Ecommerce has captcha option enabled).

Each channel is an independent list of accounts (you can add multiple phone numbers, multiple Zalo accounts...). Each item includes:

Each item also has a Description field (displayed as tooltip) and Google Conversion Tag (to track clicks via Google Ads).

1. Enable the "Enable 2FA" toggle on this page and save.
2. Each admin goes to Account Information → scans the QR code using the Google Authenticator app (iOS / Android).
3. Enter the 6-digit OTP code from the app to confirm the link.
4. From the next login, the system requires entering the OTP after the correct username and password have been entered.

Choose from one of the predefined URL structures or fully customize it:

Enter a prefix string for post categories. Example: enter news → category URL becomes /news/category-name. Leave blank → /category-name.

• Show as .html — adds the .html suffix to category URLs.
• Link structure — creates hierarchical URLs following the parent → child category tree.

Enter a prefix for single pages. Example: enter page → page URL becomes /page/{pagename}. Leave blank → /{pagename}. The {pagename} tag must be at the end.

This section is injected by the Ecommerce module via the hook INIT_LINK_CUSTOM — it only appears when the Ecommerce module is activated.

Paste the content of the ads.txt file into the textarea. Each line is a seller declaration, following the standard:

google.com, pub-XXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0
advertising.com, 12345, RESELLER

The content is saved to the physical file at public/ads.txt. Leave blank to delete the file.

The Tracking page has no hardcoded content — all tabs and forms are injected by other modules via the filter hook FILTER_LIST_DATA_GOOGLE_CONVERSION. Each module registers its own group of tabs.

If no module has registered yet, the page displays the message: "This feature is only available for e-commerce or service platforms!"

The Ecommerce module injects 3 tabs into the Tracking page via renderGoogleConversionSetting():

Each tab has the following fields:

When TOC is enabled, the system analyzes the HTML of the content field (CKEditor), finds all <h2>, <h3>, <h4>... tags, assigns id attributes to each heading, then generates a TOC HTML block and inserts it at the selected position.

The TOC is only generated if the content has 2 or more headings. If there is only 1 heading, TOC will not be displayed.

The lower section of the page allows adding/editing/deleting currencies. Each currency includes:

The Language tab (default) allows adding, editing, deleting and enabling/disabling languages. Each language includes:

Configuration saved with setting_name = 'siteLanguage'. Contains 4 fields:

When multilingual is enabled, visitors can switch languages via the query string ?lang={code}. The system uses LanguageNegotiator to determine the current language by priority order: query string → cookie → Accept-Language header → default language.

Allows users to log in quickly using their Google account instead of creating a separate password. You need to create an OAuth application at Google Cloud Console to obtain the credentials to fill in here.

When users register an account, the form displays the sentence: "By checking and proceeding to register, you agree with us regarding..." along with links to policy pages. Each field below allows selecting a single page already created in the Page module — the system will automatically use that page's URL to create the link.

Click the View icon to open the detail page. At that point:

• If the contact is in the New status, the system automatically changes it to Contacted.
• Displays the full message content, contact information, and the URL of the form submission page.

When an admin permanently deletes a record, the system saves all old data (including slug, language, SEO, related comments) into the log with the action delete_forever.

To restore, open the log detail page and click "Rollback":

1. The system recreates the record in the original table with the old data.
2. Restores with slug, language_metas, meta_seo and comments if any.
3. Removes the log from the list (to avoid duplicate rollbacks).
4. Redirects to the edit page of the restored record.

Use the "Delete Logs" button on the list page (visible if you have the system_logs_delete permission) to delete the filtered logs. This action cannot be undone — the rollback data of the deleted logs will also be lost.

The detail page consists of two parts: basic information (from the payments table) and extended information (injected from the corresponding payment package via the filter PAYMENT_FILTER_PAYMENT_INFO_DETAIL).

Package payment con (VNPay, PayPal, Stripe...) inject detailed content into this page via the filter PAYMENT_FILTER_PAYMENT_INFO_DETAIL. Each package returns its own HTML from its view, for example Vnpay::detail or DreamTeamPayPal::detail. If the package is not installed, this section is empty.

This page displays a table of all payment methods. Each method has a status badge (Enabled/Disabled) and a Settings button to access its configuration page. If it is the default method, a "Default" badge will be displayed.

Each payment method has its own configuration page. The form content is injected via the filter PAYMENT_METHODS_SETTINGS_RENDER_PAGE. Common fields include:

Extension gateways (VNPay, PayPal, Stripe) register into the payment system through 3 main hooks:

Two-column form: the left side is account information, the right side is permissions.

The system has 2 levels of permissions:

The type column identifies which module the comment belongs to. Examples: posts, products, pages. Hidden filters type and type_id allow filtering comments by a specific post/product when opened from the content detail page.

The module supports importing geographic data from Excel files via BulkImportController. Used when importing complete province/district/ward data for a new country.

When you need to add a large number of redirects (for example after migrating an old website), use the import feature: