How to Fix and Customize CS-Cart and CS-Cart Multi-Vendor

CS-Cart powers thousands of single-vendor and marketplace stores worldwide, and unlike OpenCart or PrestaShop it ships 100% open source code (under a paid commercial license). That means your developer has access to everything — but also means the customization surface is huge. SimpleReview's CS-Cart-aware agent knows the addon/theme/template structure (var/themes_repository/, app/addons/, design/themes/[theme]/templates/) so it patches the right file the first time and opens a PR.

mystore.com
SimpleReview extension
+1 (415) 555-0099 · [email protected] Sign in · Wishlist · Cart
Cart · $0.00
+1 (415) 555-0099 · [email protected] Sign in · Wishlist · Cart
Cart · $0.00
CLEANOne newsletter block · footer tightened up
✓ Duplicate newsletter removed · copyright.tpl patched · PR #42 ready
Featured products
Comment×
two duplicate newsletter blocks — remove one|
Fix it ✓ Done
CS-Cart expert · ready
waiting for selection…
Detected
PlatformCS-Cart 4.17
Themeresponsive
Filecopyright.tpl
Fix plan
Remove duplicate {include "newsletter"} in design/themes/responsive/templates/blocks/static_templates/copyright.tpl
Result
One Sign-Up block remains. Layout cleans up by 80px.
✓ PR #42 opened
fix(footer): drop duplicate newsletter block
copyright.tpl · -3 lines
Click SimpleReview → select the duplicate block → Fix it → PR opens, no developer involved
CS-Cart tweak quoted at 90 minutes? → SimpleReview reads design/themes/[theme]/templates/, finds the override, opens a PR.

Key Takeaways

  • CS-Cart customization lives in three places: addons (app/addons/[my_addon]/), themes (design/themes/[theme]/templates/), and overrides (design/themes/[theme]/templates/overrides/).
  • 100% access to source — but never edit app/functions/, app/Tygh/ core; always create an addon or theme override.
  • SimpleReview reads the registered hooks/schemes (schemas/permissions/admin.php, core/hooks/) to find where a feature lives.
  • CS-Cart Marketplace at marketplace.cs-cart.com — мы публикуем addon simplereview. Install: Add-ons → Manage add-ons → upload archive → Install → Settings → SimpleReview → connect Git/SFTP.
  • For multi-vendor RBAC, custom payment gateway, ERP integrations, performance auditVibers human review.

CS-Cart Architecture in 60 Seconds — Addons + Themes + Overrides

Every CS-Cart customization fits into one of three buckets. Knowing which bucket your edit belongs in is the difference between a 5-line PR and a 4-hour debug session that breaks the next core upgrade.

BucketPathUse forSurvives core upgrade?
1. Add-onapp/addons/[my_addon]/New features, hooks, scheme entries, custom controllersYes (isolated)
2. Themedesign/themes/[theme]/templates/Storefront layout, blocks, custom .tpl partialsYes (per-theme)
3. Theme overridedesign/themes/[theme]/templates/overrides/Replace a single template from another theme/addon non-destructivelyYes
❌ Coreapp/functions/, app/Tygh/Never edit. Always wrap in an add-on hook instead.No — wiped on upgrade
Hook system: CS-Cart fires named hooks throughout request lifecycle (e.g. dispatch_before_display, checkout_place_order_pre). Your add-on registers under app/addons/[my_addon]/func.php with fn_register_hooks(...). The agent reads core/hooks/ to discover available hook names.

Three-Click Workflow with SimpleReview

  1. Install the SimpleReview Chrome extension from the Chrome Web Store. Free with your own AI key (Claude Code or Codex).
  2. Connect your CS-Cart store. Either install the simplereview add-on from the CS-Cart Marketplace, or paste a Git/SFTP URL. The extension auto-detects CS-Cart by reading <meta name="generator" content="CS-Cart"> and recognizes Multi-Vendor / B2B / Plus editions from the storefront.
  3. Click any element on the storefront or admin, type the change in plain English ("hide Powered by", "translate Add to Cart to Купить", "fix white screen after addon install"), click Fix it. The agent locates the right addon, theme template, or hook — and opens a Pull Request.

Common CS-Cart Fixes & Customizations

500 / "White Screen" after addon install

CS-Cart writes nice exceptions to var/log/ — first stop, always. Most "white screen" cases are a missing PHP dependency, a hook collision, or a malformed addon.xml scheme. Disable the offending add-on directly via the database when admin is also broken:

-- check the log first
$ tail -100 var/log/cscart.log.$(date +%Y-%m-%d)

-- if admin is also white-screen, kill the addon via DB
UPDATE cscart_addons SET status='D' WHERE addon='offending_addon';

-- clear cache after re-enabling
$ rm -rf var/cache/* var/compiled/*

Add reCAPTCHA to a custom form

CS-Cart has a built-in CAPTCHA system in app/Tygh/Captcha/. For Google reCAPTCHA the cleanest path is the official add-on: Add-ons → Marketplace → reCAPTCHA → Install. If you need it on a non-standard form, register your own via the dispatch_before_* hook and reuse fn_image_verification('recaptcha', ...) instead of rolling Google's JS by hand.

Hide "Powered by CS-Cart" / change copyright

Footer string lives at design/themes/[theme]/templates/blocks/static_templates/copyright.tpl. Edit it via theme override, not core file.

License warning: Removing the "Powered by" notice may violate the CS-Cart commercial license. Plus and Ultimate editions historically include a "powered-by removal" clause; lower tiers do not. Check your edition's license PDF before patching this file.

Translate "Add to Cart" / "Buy Now" / button text

Two routes, depending on whether you want runtime or code-level changes:

The agent picks the right route based on whether your repo tracks var/langs/ or not.

Slow admin / storefront

Three knobs solve 90% of CS-Cart slowness:

  1. Smarty cache: Storefront → Themes → Settings → "Cache compiled" = on, "Block cache" = on.
  2. Backend cache to Redis in config.local.php:
    $config['cache_backend'] = 'redis';
    $config['cache_redis_server'] = '127.0.0.1:6379';
  3. Reindex & clean: php var/run/cache_clean.php after each deploy.

If admin is still slow after this, run a slow-query log on MySQL — cscart_products and cscart_orders are the usual suspects on stores with 50k+ rows.

Multi-Vendor: vendor sees admin or wrong storefront

Symptom: vendor logs in and lands on the global admin, or sees a different storefront than their assigned one. Check User Groups permissions (Admin → Customers → User groups) — vendor accounts must have customer-only privileges plus the auto-created vendor group. Storefront switching itself lives in app/Tygh/Storefront/; the agent reads the Storefront class to confirm the right URL conditions are wired up.

CS-Cart Marketplace — Our Add-on

CS-Cart Marketplace at marketplace.cs-cart.com lists 1,500+ add-ons and themes (most paid). We publish simplereview add-on (in approval).

Standard install (any add-on):

  1. Download the .zip from the marketplace.
  2. Add-ons → Manage add-ons → "+" icon → Local file → upload.
  3. Click Install, then Activate.
  4. Open Settings → SimpleReview → connect your Git or SFTP.

Compatible with CS-Cart 4.x (single-vendor + Multi-Vendor + B2B). Until the add-on lands — SimpleReview Chrome Extension auto-detects via <meta name="generator" content="CS-Cart"> and routes via Git/SFTP, no marketplace install required.

CS-Cart Freelancer vs SimpleReview

StepCS-Cart freelancerSimpleReview agent
Brief30 min Skype + screenshotsOne sentence in the popup
Repo / SFTP setup30-60 min, every timeOnce, then cached
Find the right file30-90 min — addons + theme + overrides + hooksInstant — file layout indexed
Make the edit5-30 min5-30 seconds
Open a PRIf they use Git at allAlways
Cost for a 1-line change$40-100 × 1-2 hr minimum = $80-200$0 (BYO key) or pennies of API usage

When You Want a Senior CS-Cart Developer

Some work earns its hourly rate. Get a human in the loop for:

That's the slice Vibers handles — a real human reviews the PR you flag, sends a fix-up if needed, approves before merge.

Stop Paying $80/hr for One-File CS-Cart Edits

SimpleReview's CS-Cart agent reads your addons, themes, and hooks — and opens a PR for the change you described.

Install SimpleReview Chrome Extension →

Multi-vendor RBAC, payment gateway, ERP integration? Get a human review →

FAQ

Can I customize CS-Cart without a developer?
For most cosmetic and structural edits — yes. CS-Cart admin handles content (products, categories, blocks, banners). For theme templates (.tpl), language strings, hooks, and small add-ons, SimpleReview's CS-Cart-aware agent reads design/themes/[theme]/templates/ and app/addons/ structure and opens a Pull Request from a single browser click.
Does CS-Cart have a free version?
CS-Cart historically offered a Free edition with reduced features; current commercial editions are Standard, Plus (B2B), and Multi-Vendor (Ultimate). All editions ship 100% open source PHP code under the commercial license — that means you can read and patch every file, but redistribution and "Powered by" removal depend on edition. Always check your specific license terms.
Is it safe to remove "Powered by CS-Cart"?
License-dependent. Plus and Ultimate editions historically allow removing the powered-by notice; lower tiers may not. The footer string lives in design/themes/[theme]/templates/blocks/static_templates/copyright.tpl and is trivially editable, but removing it on the wrong edition violates the CS-Cart license agreement. Read your edition's license PDF before patching this file.
Does this work with CS-Cart Multi-Vendor?
Yes. The agent recognizes Multi-Vendor (Ultimate) by reading schemas/permissions/ files and the storefront switching layer in app/Tygh/Storefront/. It handles vendor-specific theme overrides, vendor permissions, commission and plan adjustments, and the customer / vendor / admin area split.
Cheaper than a CS-Cart freelancer (typical $40-100/hr)?
Yes — by an order of magnitude on the routine edits. CS-Cart freelancers commonly charge $40-100/hour with 1-2 hour minimums. Most edits are one-file template overrides or a 5-line addon hook — the actual edit takes seconds. SimpleReview already knows the layout (app/addons/, design/themes/, schemas/, hooks), opens a PR in seconds, and is free with your own AI key.
What about migration to a newer CS-Cart version?
Major version migrations (4.10 → 4.16+, or pre-4 → 4.x) involve deprecated hooks, Smarty engine changes, and database schema migrations. The agent surfaces deprecated calls and obvious template fixes, but a human review is strongly recommended for production migrations — that's the slice Vibers handles.

Related

Sources