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.
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 audit → Vibers 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.
| Bucket | Path | Use for | Survives core upgrade? |
|---|---|---|---|
| 1. Add-on | app/addons/[my_addon]/ | New features, hooks, scheme entries, custom controllers | Yes (isolated) |
| 2. Theme | design/themes/[theme]/templates/ | Storefront layout, blocks, custom .tpl partials | Yes (per-theme) |
| 3. Theme override | design/themes/[theme]/templates/overrides/ | Replace a single template from another theme/addon non-destructively | Yes |
| ❌ Core | app/functions/, app/Tygh/ | Never edit. Always wrap in an add-on hook instead. | No — wiped on upgrade |
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
- Install the SimpleReview Chrome extension from the Chrome Web Store. Free with your own AI key (Claude Code or Codex).
- Connect your CS-Cart store. Either install the
simplereviewadd-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. - 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.
Translate "Add to Cart" / "Buy Now" / button text
Two routes, depending on whether you want runtime or code-level changes:
- Admin: Languages → Translations → search "Add to Cart" → edit. Survives core upgrades, no file change.
- Code:
var/langs/[lang_code]/[area]/...po. Useful for version-controlled multi-store deployments.
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:
- Smarty cache: Storefront → Themes → Settings → "Cache compiled" = on, "Block cache" = on.
- Backend cache to Redis in
config.local.php:$config['cache_backend'] = 'redis'; $config['cache_redis_server'] = '127.0.0.1:6379'; - Reindex & clean:
php var/run/cache_clean.phpafter 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):
- Download the
.zipfrom the marketplace. - Add-ons → Manage add-ons → "+" icon → Local file → upload.
- Click Install, then Activate.
- 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
| Step | CS-Cart freelancer | SimpleReview agent |
|---|---|---|
| Brief | 30 min Skype + screenshots | One sentence in the popup |
| Repo / SFTP setup | 30-60 min, every time | Once, then cached |
| Find the right file | 30-90 min — addons + theme + overrides + hooks | Instant — file layout indexed |
| Make the edit | 5-30 min | 5-30 seconds |
| Open a PR | If they use Git at all | Always |
| 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:
- Multi-vendor RBAC + commission rules — vendor plans, commission tiers, payout cycles. Wrong logic = wrong payouts to real people.
- Custom payment gateway — PSP integration, PCI compliance, refund flow, webhook idempotency. Money moves; humans review.
- ERP integration — 1C, SAP, NetSuite. Bidirectional sync, conflict resolution, retry policy.
- Custom shipping method — DHL, UPS, EasyPost. Live rate calculation, label generation, return labels.
- Performance audit — Redis cache tuning, slow-MySQL
EXPLAINreview, missing indexes oncscart_products/cscart_orders/cscart_product_options.
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
.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.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.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.app/addons/, design/themes/, schemas/, hooks), opens a PR in seconds, and is free with your own AI key.Related
Sources
- docs.cs-cart.com — Official add-on, theme, and hook documentation
- marketplace.cs-cart.com — 1,500+ add-ons and themes (incl. SimpleReview, in approval)
- github.com/cscart/ — Reference repository the agent indexes against
- forum.cs-cart.com — Community-sourced fixes for white-screen, hook collisions, Multi-Vendor edge cases
- SimpleReview — Click element → leave comment → get PR