FAQ
Can I price by area, like width × height?
Section titled “Can I price by area, like width × height?”Yes. Give the width and height options the codes width and height, make them number inputs and write width * height / 10000 * 25 (price per square metre with sizes in cm) as the product formula or as the formula of the height option. Use a material option with formula values per variant to make the rate depend on the material.
Do the core option modifiers still work?
Section titled “Do the core option modifiers still work?”Yes. Fixed and percentage modifiers of variants are applied first, and the add-on adds its amounts on top. The formula variable price contains the price with the core modifiers.
Is a one-time fee multiplied by the quantity?
Section titled “Is a one-time fee multiplied by the quantity?”No. Fees set to Once per cart line and the setup fee are charged once per cart line and shown as One-time fees in the totals. They are taxed with the product’s tax classes (or not at all, see the settings).
Can options appear only when another option is selected?
Section titled “Can options appear only when another option is selected?”Yes, with conditions in Advanced pricing & rules → Show this option. Use Required when shown instead of the core Required checkbox for such options.
Are the checks done on the server too?
Section titled “Are the checks done on the server too?”Yes. Number limits, text limits, required options and conditions are checked again when the product is added to the cart or the cart is updated, also for REST API and admin orders. Hidden options never reach the order.
Can a formula run code or break my store?
Section titled “Can a formula run code or break my store?”No. Formulas are read by the add-on’s own parser with a fixed list of operators and functions; there is no way to call PHP. A formula that fails at runtime (for example a division by zero) counts as 0 and the admin test calculator shows the error.
What happens to placed orders when I change a rule?
Section titled “What happens to placed orders when I change a rule?”Nothing. Orders keep their prices, fees and breakdowns. When you edit a placed order, unchanged items keep their amounts.
Do catalog promotions and discounts apply to formula prices?
Section titled “Do catalog promotions and discounts apply to formula prices?”Yes. Catalog and cart promotions are calculated after the options, so they apply to the full price per item.
Does it work with global options?
Section titled “Does it work with global options?”Yes. Rules are stored per option, so a global option carries its rule to every product it is linked to. Codes must be unique within each product.
Does it work with product variations?
Section titled “Does it work with product variations?”Each variation is a product with its own options; rules are copied when options are cloned (for example when variations are created) and when a product is cloned.
What about the full page cache of CS-Cart 4.21?
Section titled “What about the full page cache of CS-Cart 4.21?”The product page shows the breakdown for the default selection, the same for every visitor, and option changes are recalculated with POST requests that the cache does not store. Nothing personal is cached.
Can vendors use it?
Section titled “Can vendors use it?”On Multi-Vendor you decide: with Vendors can edit price rules on, vendors edit the rules of their own products.
What happens if the license lapses?
Section titled “What happens if the license lapses?”Without a valid license (no key after the 14-day start period, an invalid or revoked key, a domain the license does not cover, or no successful check for 14 days), formula prices, one-time fees, number limits and conditional options stop for new carts and products use the core option prices. Placed orders keep their prices, fees and breakdowns. Your rules stay.
The admin panel shows a license notice.
Section titled “The admin panel shows a license notice.”Open Add-ons → Manage add-ons → Advanced Product Options & Price Formulas → Settings → License. The status line says what is wrong: no key, a key for another add-on, a revoked license, or a domain that the license does not cover. Fix it and click Check now. See License.
Does the add-on work on my staging copy?
Section titled “Does the add-on work on my staging copy?”Yes. Subdomains of your licensed domain (for example staging.yourstore.com) and local development hosts (localhost, private IP addresses, *.local, *.test) are covered by the same license.
What happens if your license server is down?
Section titled “What happens if your license server is down?”The add-on keeps working. If the check fails, it retries every hour and keeps working for 14 days after the first failed check.
Does the license check slow down my storefront or checkout?
Section titled “Does the license check slow down my storefront or checkout?”No. The check runs only in the admin panel or from cron, never on storefront or checkout requests.
Can customers add these products from the B2B quick order form?
Section titled “Can customers add these products from the B2B quick order form?”No. A product that needs input (a required option, or a number or text field) is refused in the quick order form with a notice; the customer opens the product page and chooses the options. Products without such options work as before.
Do cost and profit reports include the one-time fees?
Section titled “Do cost and profit reports include the one-time fees?”The Product Cost & Profit reports show the one-time setup and artwork fees as an order surcharge, not as part of the item lines, so the Items figures exclude them. The order total and invoices include them.
Still stuck?
Section titled “Still stuck?”Work through the troubleshooting guide, then contact support with your CS-Cart version, edition, PHP version and the add-on version (1.0.0).