Installation
Requirements
Section titled “Requirements”- CS-Cart, CS-Cart Ultimate, Multi-Vendor or Multi-Vendor Ultimate 4.17.2 – 4.21.x, including 4.18.x (tested on CS-Cart Ultimate 4.17.2 and Multi-Vendor 4.17.2 with PHP 8.1; templates compile with the Smarty versions of 4.18 and 4.21).
- PHP 7.2.5 – 8.3, as supported by your CS-Cart version.
- MySQL/MariaDB with InnoDB.
- Optional: a USB or Bluetooth barcode scanner in keyboard mode (any scanner that types the code and presses Enter), a label printer for 62 x 29 mm or 50 x 25 mm labels, or A4 label sheets with 3 x 8 labels.
Download
Section titled “Download”Bought on cs-cart.kaviolabs.com: sign in and open My licenses. Each add-on has its own row with the license key, the licensed domain and Downloads with the archive kv_serial_warranty-<version>.zip. Bought as a guest? Create an account (or sign in) with the e-mail address of the order and open the confirmation link that is e-mailed to you; the purchase then appears under My licenses. Bought on the CS-Cart Marketplace: download the archive from your Marketplace account; the Marketplace license number works as the license key.
Install
Section titled “Install”- Go to Add-ons → Manage add-ons, click the + (upload) button and upload
kv_serial_warranty-<version>.zip. - Find Serial Numbers & Warranty Tracker in the list and click Install. The add-on is active after the installation.
- Enter your license key in Settings → License (or the CS-Cart Marketplace license number in Add-ons → Manage add-ons).
- Check the settings (see Configuration): default warranty, serial number pattern and when serial numbers are assigned.
- Open a product, go to the Serial numbers & warranty tab and tick Track a serial number for every unit of this product, or simply receive stock for it in Products → Serial numbers (the receipt turns tracking on).
No cron job is needed. Installing creates the add-on tables only; no sample data is added.
CS-Cart Ultimate: one license covers every storefront of the installation. The licensed domain is the store’s main domain without www.; www. and other subdomains of that domain are included.
Privileges
Section titled “Privileges”Administrators need View catalog to see the serial number pages and Manage catalog to receive stock, edit units, import and handle claims. Assigning serial numbers on an order needs Edit orders. On Multi-Vendor, the setting Vendors manage the serial numbers of their products decides whether vendors get the pages in their panel (see Configuration).
Upgrading
Section titled “Upgrading”Upload the new package over the installed add-on (or use the Upgrade Center). Serial numbers, receipts, claims and order links are kept; missing tables, settings and texts are added automatically on the next admin page view.
Disabling and uninstalling
Section titled “Disabling and uninstalling”- Disable: customers no longer see serial numbers, serial numbers are not assigned or released automatically, and the admin pages are hidden. Your data is kept.
- Uninstall removes the add-on tables (serial numbers, goods receipts, claims, history, product settings), its settings and texts. Export your serial numbers to CSV first if you may need them later: Products → Serial numbers → gear menu → Export CSV. Products, stock and orders are not changed.