Ticket Assistance
Get fast, reliable help for any issue related to your products. Our support team guides you with clear answers and efficient solutions.
Frequently asked questions
Everything you need to know about zeroShop. Can't find the answer here? Contact our support team.
The full documentation is included in the zeroShop application — available to all users after activation.
Your hosting must have: PHP 8.2 or newer, and the following PHP extensions: mysqli, cURL,
GD, mbstring, intl, JSON,
OpenSSL, zip. The mod_rewrite Apache module
must be enabled.
Installation runs in 3 screens and takes about 10 minutes. Unzip the package to your
web root, then access https://your-domain.com/zeroshop/installation/ in your browser.
- Step 1: Verifies your Purchase Code (Order ID).
- Step 2: Configures your database and administrator account.
- Step 3: Confirms success.
Yes. The installer does not create the database — it only imports the tables. Create
it in cPanel (MySQL Databases) or phpMyAdmin before running the installer. Use
collation utf8mb4_unicode_ci. Then create a database user and add
the user to the database with ALL privileges.
The zeroshop/backups/ directory must be set to 777.
The installer checks three writable paths:
- zeroshop/installation/,
- zeroshop/writable/,
- zeroshop/app/Config/Database.php.
If any of these are not writable, the installation will be blocked.
After installation do the following (not mandatory, but strongly recommended):
- Delete the installation folder,
- Rename the admin,
- Rename zeroshop application folders to unique names (Admin > Configuration > Rename folders),
- Remove the default admin@admin.com account,
- Enable htaccess protection on the admin directory (Admin > Configuration > Back-office protection).
Yes. zeroShop works on both Apache and Nginx.
A sample Nginx configuration file is included in the documentation to set up URL rewriting, security headers, and static file caching.
- CSRF protection,
- HTTPS enforcement,
- honeypot anti-bot + rate limiting,
- systematic output escaping (esc(), purify_html()),
- granular permissions per page/action,
- filtered uploads,
- .htaccess blocking access to app/, system/, writable/,
- and HTTP security headers (X-Content-Type-Options, X-Frame-Options).
Navigate to your-domain.com/zeroshop/admin and log in with the
credentials you created during installation. The default admin account should be deleted once your
own Super Administrator account is created.
Go to Admin > Edit/Add > Product & Service, click "Add Product/Service," fill in the reference (SKU), name, and price, then choose your variation mode (None, Combinations, or Components).
A buy button snippet is automatically generated — a self-contained HTML form with embedded CSS and JavaScript.
No external dependencies is required.
Three types:
- Tangible products (physical items, non-downloadable, weight >0),
- Downloadable products (digital files, downloadable, weight = 0),
- Services (intangible, non-downloadable, weight = 0).
- Combinations are variations of the same product (size, color, capacity) — each with its own stock, price, SKU, and image.
- Components are multiple distinct items forming one product (e.g. a custom-built computer, a gift box, a service package) — each component can have its own stock, price, and SKU.
Copy the generated HTML/JavaScript snippet and paste it anywhere on your page. On WordPress, you can use the shortcode. The snippet also provides direct links to the cart. A CSS Generator is available to style the button without writing code.
Go to Admin > Configuration > Email Settings. Set your email address and choose the sending mode (PHP mail() or SMTP). You can use any valid email address (Gmail, Outlook, etc.).
Note: zeroShop does not create email addresses — you need to create one through your hosting provider first.
Go to Admin > Configuration > General Settings.
In the Business Infos section, configure your details. Then check your Web Site URL — it must match your real domain. Upload your logo in the Logos section (recommended sizes: 600x150px for header, 500x250px for footer).
Go to Admin > Configuration > Back-office protection to add htaccess/htpasswd protection on the admin directory. You can create multiple users. A password prompt will appear when accessing the admin folder.
Yes. Go to Admin > Configuration > Team.
The Super Administrator has full access. You can create additional profiles with specific rights (import, export, add, delete, update) per page or action.
zeroShop uses a Plug & Play language system. Languages are automatically detected
by scanning the app/Language/ directory. No core code modification is
required to register a new locale.
You can activate up to 27 languages.
- Create a new folder in zeroshop/app/Language/ using the two-letter language code (e.g. de for German).
- Add an info.php file with the language metadata (id, name, local_name, hreflang, tiny_lang, product_folder slug).
- Mirror the directory structure from the en/folder.
- Enable the language in Admin > Configuration > General Settings > Languages.
Yes. The documentation includes a ready-to-use Expert Prompt for AI translation (Gemini, ChatGPT, etc.).
The prompt handles the full recursive localization of the en/ directory into your target language, preserving placeholders, HTML
tags, PHP syntax, and UTF-8 encoding. It processes files in batches of 5 with
verification after each batch.
Never translate or modify placeholders (%s, %d,
{0}, {fn}, {__field__}). Keep all HTML
tags exactly as in the source. Most files use return [...]; arrays;
Validation.php uses $lang['key'] = 'value'; syntax.
Escape apostrophes correctly based on string delimiters.
The front_custom.php file is for user-specific overrides.
front.php may be updated by the system, but front_custom.php is never overwritten.
Use it to customize translations without losing changes during application updates.
Yes, if needed. After adding a language folder and configuring info.php, you must complete all empty translation fields in the admin panel.
Payment Gateways, Subscription Plans, Products & Services, Shipping Methods, Terms & Conditions, Privacy Statement, and Payments Page.
zeroShop provides 3 themes: Default, Dark, Mono.
Select one in Admin > Configuration > Settings under the Themes section.
Yes. Open zeroshop/assets/css/custom.php and set variables like $body_font_type, $body_font_color,$links_color, etc. between the double quotes.
Save and refresh.
You can also pick colors using the Color Picker tool.
Add your CSS rules to the zeroshop/assets/css/custom.css file.
Your styles will be loaded after the theme styles and will take precedence.
Yes. Open zeroshop/assets/css/scss/themes/{theme}/_variables.scss, override the SASS variables, and recompile.
The output must be written to the corresponding bs-saw.css, bs-dark.css, orbs-mono.css file. Full theme structure is documented.
Yes. zeroShop includes a built-in backup tool for your database and configuration files.
Go to the backup section in the admin panel to export everything in one click. This is especially important before migration or updates.
zeroShop uses OpenStreetMap and Leaflet — a totally free map system.
Go to Admin > Configuration > General Settings > Contact Page, enable the map, click "Geolocate yourself HERE," drag the marker to your exact location, and save.
zeroShop supports a dual-mode calculation engine.
For every transaction, both Net and Gross values are computed and stored simultaneously. It handles cascading taxes (Level 2 calculated on Net + Tax1), federal/provincial tax names, and toggles between "Tax included" and "Plus tax" display modes without recalculating base data.
A direct payment link is a special URL you create for one customer and one product.
When the customer clicks it, they are taken straight to the checkout with the product already in their cart — without having to log in. Ideal for email, chat, or SMS payment requests.
Each link is valid for 48 hours.
During that time, the customer can click it as many times as needed — each click resets the cart to the link's content.
After 48 hours, generate a new one in one click.
Yes. zeroShop supports recurring billing via Stripe.
Create a subscription article, then add plans (daily, weekly, monthly, or yearly) in Admin > Configuration & Management > Subscription Plans.
Stripe handles all payment processing, renewals, and the Customer Portal where subscribers can change plans, update payment methods, or cancel.
Yes. zeroShop supports TSV (Tab Separated Values) import.
Prepare your data in Excel or Google Sheets, export as .tsv or .txt with UTF-8 encoding, then upload via Admin > Goodies > Import products/services.
Column headers map to database fields — column order does not matter. A sample file and column structure file are available for download.
Yes. The admin dashboard shows real-time sales data, revenue graphs, top products, and customer insights. You can export reports as CSV for further analysis.
Yes. The link automatically includes the options currently selected in the Snippet Preview (size, color, etc.).
The customer receives the exact variation you see in the preview, ready to pay.
Change the selection in the preview before clicking "Generate payment link" to offer a different variation.
zeroShop uses a modular plugin architecture based on a hook system. Plugins are
folders placed in zeroshop/plugins/ with a manifest.json
file. They can hook into front-end views, admin pages, and data models.
No core code modification is required.
Three types:
- Front-End Hooks (public website views),
- Admin Hooks (dashboard pages and sidebar),
- Data Hooks (backend model interception for database operations). Data hooks can target specific URIs, view template names, or intercept email and model operations.
Yes. Plugins can define automatic database creation and alteration using Up/Down methods.
The naming convention is strict — table and field names must follow the plugin's prefix convention. The system handles migration automatically when the
plugin is enabled.
Yes. The product_custom_fields system lets plugins declare custom fields with a prefix convention, read them, and add them to the product form.
Fields are automatically managed throughout the product lifecycle.
Yes. Plugins can include translation files and use translations in controllers, views, and events (sidebar, headers).
They can also override core translations for advanced customization.
Extend the AdminController base class. Define your routes in the
plugin's routes configuration, and the system handles sidebar integration,
permissions, and page rendering automatically.
zeroShop supports 10 payment gateways: Stripe, PayPal, Mollie, Square (online), plus manual methods: Bank Transfer, Bank Check, Cash on Delivery, Money Order, Western Union, and Phone Ordering.
Go to Admin > Configuration > Payment Gateways. In the Stripe section:
enable Stripe, paste your Publishable Key (pk_test_...) and Secret Key
(sk_test_...), set your currency, and save.
For subscriptions, also enable "Enable Subscriptions." You can add an extra fee (fixed or percentage) on Stripe payments.
In the Stripe Dashboard, go to Developers > Webhooks > Add destination.
Select these events:
charge.failed,
charge.refunded,
checkout.session.async_payment_failed,
checkout.session.completed,
payment_intent.payment_failed,
payment_intent.succeeded,
invoice.paid,
customer.subscription.updated,
customer.subscription.deleted.
Enter the Endpoint URL from zeroShop's help section, then paste the Signing secret (whsec_...) in the Webhook Secret field.
Use Stripe's test mode with test keys (pk_test_..., sk_test_...).
Pay with the test card 4242 4242 4242 4242 (any future expiry, any CVC).
No real money moves.
When ready, replace test keys with live keys (pk_live_..., sk_live_...) and make one small real purchase to confirm everything works.
- Prices are immutable on Stripe. Changing the amount, currency, or interval of an existing plan creates a new price for new customers only — existing customers keep their original terms.
- Deleting a plan used by customers is forbidden on Stripe. zeroShop deactivates (archives) it instead of deleting it.
The most common cause is that the webhook is not configured or the Signing Secret
(whsec_...) is missing or incorrect. Check that all required events
are selected in the Stripe Dashboard and that the endpoint URL is reachable from
the internet.
Yes. After payment, customers can access Stripe's Customer Portal from their
account area to change plans, update payment methods, cancel, or resume their
subscription.
Each renewal generates a new order/invoice.
Can't find the answer you're looking for? Our support team is here to help.
Get in touch and we'll respond as quickly as possible.