Skip to content

Configuration

Overview · Installation · Usage · Developer notes · FAQ

Open Add-ons → Manage add-ons → Scheduled Supplier Feed Import → Settings. The settings apply to the whole installation; each feed has its own options on its feed page (see Usage).

Settings: cron command and URL, limits and vendor feeds

Setting Default Description
Feeds and cron Link to Products → Feed import, the cron command and the cron URL with your key.
Cron key created on install Secret key of the cron command and URL. Change it if it was shared by mistake, then update your cron job.
Vendors can manage their own feeds (Multi-Vendor) On Vendors get Products → Feed import in the vendor panel. Their feeds import only into their own products, cannot use server paths or private network addresses, and cannot create categories or feature values. When you switch it off, vendor feeds stop running and vendors no longer see the page; their feeds are kept.
Allow feeds from private network addresses Off Feed and image URLs that point to this server, localhost or a private network (10.x, 172.16–31.x, 192.168.x, link-local and similar IPv4 and IPv6 ranges) are refused. Turn it on only if your supplier feed is on your own network. It never applies to vendor feeds.
Maximum feed size (MB) 50 Larger downloads and uploads are stopped. Compressed (.gz) feeds count with their unpacked size.
Download timeout (seconds) 60 Time limit for downloading one feed file. Images use the same guard with at most 30 seconds and 10 MB per image.
Rows per step 100 Imports run in short steps (also in the admin panel), so feeds with tens of thousands of rows never hit a PHP time limit. Lower it on slow servers.
Time per cron call (seconds) 50 How long one cron call keeps importing. Keep it below the PHP time limit of your cron.
Runs kept in the history per feed 30 Older runs and their row logs are deleted after each run.

The feed pages use the core Manage catalog privilege, like the CS-Cart import. Administrators without it cannot open the feeds. In Multi-Vendor with the Vendor privileges add-on, vendor user groups need the same privilege.

The license status is shown in a License card at the top of the add-on page, above the tabs, so you see it on every tab. The License tab holds the key itself. The key is stored once for the whole installation.

License card on the add-on page: status, licensed domain, storefronts, last and next check, with Change license key, Check now and Manage license

The License card shows:

  • the status in color: green when valid, blue for a development host or the 14-day period before a key is required (with the days left), amber when the license server could not be reached (with the days left) or a Marketplace number is still being verified, red when the add-on is switched off;
  • in plain words what the status means and, when the add-on is (or will be) switched off, what stops: new imports stop (the cron skips all feeds and Run now is switched off); feeds, mappings, presets, the preview and the run history stay available, and a run that has already started finishes;
  • the licensed domain, every storefront with its result (covered, development host, not covered), the end of the updates and support period, the last and the next check, and the key in use (masked);
  • the actions Enter license key / Change license key (opens the License tab), Check now (verifies at once and stays on the page), Manage license (your licenses on cs-cart.kaviolabs.com) and, without a valid license, Buy a license.

In Add-ons → Manage add-ons the add-on’s row shows a small license badge next to its name, for example License: Valid or License: Pending · 9 days left.

The feed pages show the license status in a bar at the top: a small green chip when the license is valid, or a banner with the status, what is switched off and the same actions as the card. Vendors never see license information.

Setting Description
License key Your Kavio Labs license key (KAVIO-XXXX-XXXX-XXXX-XXXX, from My licenses on cs-cart.kaviolabs.com) or your CS-Cart Marketplace license number. If you entered the Marketplace license number in Add-ons → Manage add-ons (the add-on’s license field), leave this empty: the add-on uses that number.
License status Points to the License card and explains what the check sends.

What the license covers. A license is bound to the base domain you entered at purchase (for example example.com) and covers every subdomain of it (www.example.com, shop.example.com, staging.example.com). Local development hosts are always allowed: localhost, 127.0.0.1 and other private IP addresses, and host names ending in .localhost, .test, .local, .example or .invalid. A store on a different base domain needs its own license. If you move your store to a new domain, contact support.

When the add-on checks. When you save the key, and then once a day. The check runs only in the admin panel (on a page you open) or from cron, never while customers browse the storefront or place orders, and takes a few seconds at most. A cron job keeps the license verified even when nobody opens the admin panel:

php /path/to/store/admin.php --dispatch=kv_scheduled_feed_import_license.check

What is sent. The check sends this to https://cs-cart.kaviolabs.com and nothing else: the license key, the add-on ID and version, the host names of your storefronts, your CS-Cart version and edition, and a random one-time value. No customer, vendor, order, product or personal data is sent. The server answers with a digitally signed result, so a forged answer is ignored.

Statuses.

Status (card) Color What happens
Valid Green The license is valid for this domain. Everything works.
Development host Blue The store runs on a local development host, which every license covers. Everything works.
Pending verification Amber A CS-Cart Marketplace license number was accepted, but the Marketplace has not confirmed it yet. Everything works.
Pending · N days left Blue No verified key yet (a new installation). Everything works for 14 days.
Grace period · N days left Amber The last checks failed (for example a network problem). The add-on keeps working for 14 days after the first failed check.
Not activated, Invalid key, Revoked, Domain mismatch, Not verified Red New imports stop: scheduled runs and Run now are switched off. Feeds, mappings, presets, the preview and the run history stay available, and a run that has already started finishes. Your products and the store are not affected. Domain mismatch shows the licensed domain next to the domain your store runs on.

When your updates and support period ends, the add-on keeps working. Only updates and support stop.

License information appears in the admin panel only, and only for administrators who may manage add-ons; vendors and customers never see it. When the add-on is switched off, other admin pages also show a notice once per session with a link to the add-on page; the add-on page and the feed pages show the card or the status bar instead.