RapidCart Pro 5 Manual

REV. 2022-03-03

Introduction

What is RapidCart Pro

RapidCart Pro is a plugin for RapidWeaverâ„¢ 8 that allows you to create and manage an e-commerce store with just few clicks. You can choose among several customization options in order to configure your store, enabling different payment methods, setting different countries tax rates and more. In addition, multiple layout options let you change store graphic layout to better suit your needs.

Main Features

  • Product catalog with customizable versions and options
  • Support for both physical and digital product version delivery
  • Multiple online and offline payment methods
  • Integrated image gallery
  • Searchable categories and tags
  • Fully responsive interface for optimal user experience on mobile devices
  • Stacks suite to build custom pages
  • Per-category, per-tag or per-cart options
  • Advanced market countries selection and tax rates, including multiple tax tiers.
  • Rule-based additional costs and discounts
  • Shipping methods management
  • Stock management
  • Coupon codes support
  • Advanced SEO support
  • Language localization
  • Advanced layout configuration
  • News & Tips section

Requirements

Following the same design philosophy of other products that are members of RapidCart line-up, RapidCart Pro tries to minimize system requirements.

RapidCart Pro plugin requires RapidWeaverâ„¢ 8.

On server side, RapidCart Pro requires PHP 7 and TLS 1.2 support. Additional features like coupon codes, stock management and digital downloads limit require support for MySQL 5.1+ on your server. On client side, we suggest a modern browser (Chrome, Firefox, Safari or Edge) for an optimal user experience.

An active Internet connection is definitely recommended while using the plugin.

RapidCart Pro requires a valid Web Address set in RapidWeaver's general project settings in order to work.

Conventions used in this manual

In this manual, some typographic conventions help you highlighting important concepts.

Blue boxes contain suggestion and ideas to make the best out of RapidCart Pro.
Yellow boxes contain important info about RapidCart Pro design and working logic.
Pay attention to these boxes to learn important info on the plugin.

Get Started

Download

Get your copy of RapidCart Pro from product page on our site http://4gnd.com/rcpro.

Installation

Double click on file RapidCartPro.rapidweaverplugin you'll find inside downloaded DMG image. RapidWeaverâ„¢ will open and RapidCart Pro will be automatically installed.

RapidCart Pro requires RapidWeaverâ„¢ 8.

Sample project

Having a look at our demo store project is a great way to get you started with RapidCart Pro.

Tooltips

Hover your mouse over control labels in Customization Settings and Cart Payment windows to get usage tooltips.

Registration

Unlimited commercial use of RapidCart Pro requires a license you can purchase from our store at http://4gnd.com/buy.

RapidCart Pro license comes in two flavours: Starter or Advanced. For more info, check out RapidCart Pro Starter vs. RapidCart Pro Advanced comparison table.

After buying a license of the product, you'll receive an email containing the license key to unlock the plugin. Insert your license key in the about panel of plugin's inspector, which will appear clicking the red Unregistered button on the top right corner of plugin interface.

If you've not received the email containing your license key, don't forget to check your spam folder.

Unregistered RapidCart Pro can handle only up to 2 products, options, versions, additional costs, shipping methods and will show a Made with unregistered copy message in published pages.

Demo Project

We suggest to download our sample project from http://4gnd.com/rapidcartpro to familiarize with plugin. Keeping an eye on it will help you understanding this manual.

Checklist and Debug

After first publishing, RapidCart Pro offers the chance to check if your web server satisfies RapidCart requirements. You can be redirected to checklist page pushing Check your deployed page... button, available from plugin's inspector about panel. This page is also available simply adding ?checklist at the end of your store's URL (e.g. http://www.domain.com/store/index.php?checklist).

If you encounter any issues with your RapidCart Pro store, enable Debug Mode from Customization Settings in General section, republish your page and open a support ticket on http://help.4gnd.com. Don't forget to include your store URL in your request.

Build your Catalog

Adding RapidCart Pro to your Project

From RapidWeaverâ„¢'s Add... menu, choose RapidCart Pro. A single RapidCart Pro page will handle your entire product catalog, which will be automatically divided into multiple web pages when published.

Add only one RapidCart Pro page to your RapidWeaverâ„¢ project.

Add a Product

Products panel is used to create and manage your product catalog. From here you can create, remove and duplicate products pushing , and buttons available under product list.

Clicking on first checkbox on the left of product list (the one with the symbol) you can change product state. A product can be enabled (normal state), disabled (that is not exported nor published) or hidden (that is not visible in catalog but still published and reachable using direct URL).

Clicking on second checkbox on the left of product list (the one with the symbol) you set a product as promoted. Promoted products are shown first in catalog page and in Related Products list regardless of product sort settings. A promoted badge appears inside product box in catalog page. The text promoted can be customized in Product section found in Customization Localization panel.

Products General tab contains basic info about your products. Product creation date field is automatically filled in with current date, but you can edit to change catalog sort order in published pages.

Every product can be associated to one or more categories and to one or more tags. Type some text and hit Enter key on your keyboard into Categories or Tags fields to create a new item, contained in a blue inset. Categories and tags will be shown in product catalog and can be used to search and filter products in published page.

Set a Page URL if you prefer to use a custom page for the product, otherwise leave this field blank. This can be useful if you're going to build a custom product page using RapidCart Pro stacks and use it instead of default one.

Duplicating a product pushing button, RapidCart Pro creates a copy of the product that contains same data. This can be used to save time when creating similar products. Just duplicate an existing product, then edit desired details. Duplicate button is available for item lists in plugin (Products, Versions, Options, Costs, Shipping...).

One or more resources (images or videos) can be associated to each product. A resource gallery with lightbox effect support will be hence automatically created in product page. Push button to enter edit mode and link a remote resource typing its URL or a local one, choosing among resources shown in RapidWeaverâ„¢ sidebar.

You can set a smaller thumbnail for each resource in order to speed up page loading. Thumbnails must be images and not videos. You can also set a caption for each resources. Captions are shown when users click on the thumbnails showing full size image or video.

Further gallery customization are available in Product Gallery section of Customization Settings panel. From there you can Enable Autoplay for resource slideshow in order to automatically change displayed resource after given Autoplay Interval. Transition used for slideshow can be chosen using Transition Animation setting. Enable Ken Burn Effect turns on this transition effect for the slideshow.

RapidWeaverâ„¢ resources can also been added simply dragging and dropping them from the sidebar to Resources list. Depending on drop location, you'll be able to create a new resource or editing an existing one, setting either resource URL or thumbnail URL. You can even drop a whole resource folder at once!

Product description

Products Description tab contains comprehensive description for your products.

Short field contains a short description shown in catalog product boxes, in related products and in RapidCart Pro stacks.

Long field contains extended product description shown in product page. This field supports StyledText, HTML and Markdown syntax, that can be used to add links and text formatting.

For more info on Markdown syntax visit http://daringfireball.net/projects/markdown/syntax

Versions and Options

Every product contains at least one version, located in Products Versions tab and can include product options, located in Products Options tab. Product versions consist of various product "models". Each version has a unique identifier (Stock Keeping Unit, also known as SKU), Name, Price, maximum per-order quantity limit (Quantity) and Weight.

Products must contain at least one version.

Product versions can be configured as Physical, shipping, Physical, no shipping, Digital delivery or Digital + physical shipping. The first and second choices can be used for physical goods (e.g. t-shirts) that respectively can or can't be shipped. If, during checkout, cart doesn't contain products requiring shipping, RapidCart Pro will skip shipping window.

Digital versions of your products con be set choosing Digital delivery. This is useful if you're going to sell non-physical goods like digital movies, MP3s, digital pictures, ebooks and software. Digital + physical shipping is used for digital downloads that requires also a physical shipping (e.g. MP3 or ebook download + CD or DVD shipping). For more info see Digital Delivery section of this manual.

Moreover, you can set if each version is subject to taxes checking Apply taxes and if it's Available for purchase. More info are available in Set Tax Rates and Stock Management sections.

Options are product variations that can change price and weight for a given version. Several Types of options are available (Checkbox, Date, Number, Radio, Select, Text, Textarea and Time).

When a product option is set as Required, customer must enter a value for Date, Time, Text, Textarea or Number options, must choose at least one value for Checkbox or Radio options and must choose a value but the first one for Select option.

Use Multiplier field in Number type options to let user enter a custom value that will be multiplied by Multiplier price set.

For instance, if you're selling wood planks at $400 / Cubic Meter, name the option Cubic Meters and set its Multiplier to 400. Customers will be required to enter the Number of Cubic Meters required and price will be automatically calculated.

Stock Management

From Products Versions tab you can manually set if a product version is Available and the Max quantity that can be purchased in a single purchase.

Enabling Stock Management you'll be able to automatically track your inventory and stop selling a product when it is no longer available. Stock quantity set will automatically decrease after each purchase.

If you need to update inventory, set desired Stock quantity and republish your RapidCart Pro page. Current availability is printed in receipt sent to merchant. Stock quantity can also be edited from Products section of Online Administration.

Stock Management is available only in RapidCart Pro Advanced and requires MySQL support on your server, which can be configured in Database section of Customization Settings panel.

Options Sets

Whole Option sets can be automatically associated to every products belonging to a given set of categories or tags. Define them in Cart Option Sets.

Unchecking an option set from option set list you can temporarily disable option set export and publish.

Defining an option set linked to cart, options will be shown during checkout. This is useful to request additional info connected to the order.

Option sets are available only in RapidCart Pro Advanced.

Digital Delivery

Starting with version 1.2, RapidCart Pro supports digital delivery through Amazon S3 fileserver service. Setting up a product version as Digital delivery you'll be able to specify one or more files that will be downloadable with a protected link. For instance, if you're selling digital pictures or ebooks RapidCart Pro will generate and send to your customers temporary protected links to download their digital purchases. Files are accessible only using links generated by RapidCart Pro and thus can't be downloaded by unauthorized people.

Digital delivery is available only in RapidCart Pro Advanced.

Configuring Amazon S3

RapidCart Pro digital delivery relies on Amazon S3 fileserver service, so an Amazon S3 account is required. Amazon S3 offers a free of charge starting tier to new users and a definitely affordable pricing. For more info, visit http://aws.amazon.com/s3/pricing/.

If you need to create an Amazon S3 account:

  1. Go to http://aws.amazon.com and click Sign In to the Console using your existing Amazon account (or apply for a free Amazon account).
  2. Click on your name in the upper right corner of menu bar and choose Security Credentials.
  3. Select Access Keys (Access Key ID and Secret Access Key) section.
  4. Select Create New Access Key and save newly generated credentials.

You'll need to enter your Access Key ID and Secret Key in Digital Delivery section of Customization Settings panel. In the same section you can set link validity (in hours) as well. Once generated links expire, product file downloads are no longer available.

Uploading Your Files to Amazon S3

Here's the step required to load your files in Amazon S3:

  1. Sign in to http://aws.amazon.com and choose S3 service from Storage & Content Delivery.
  2. Create a new Bucket that will be used to upload your files clicking Create bucket in the upper left corner.
  3. Choose a name and a Region for the bucket and click Create.
  4. Open bucket properties and set List permission to Everyone in Permissions section.
  5. Click on the newly created bucket and load you files selecting Upload from Actions menu in the upper left corner.

Some Amazon S3 regions are not supported by RapidCart Pro. Choose a region that supports signature version 2 to store your digital downloads. A complete list of S3 regions and supported signature versions is available on AWS web site.

Choosing Files Used in Product Version

After uploading your files to Amazon S3, you can choose which of them use for a given product version. Each product version can use one or more files.

Select a product version in RapidCart Pro and set them as Digital Delivery. Now click button that will be enabled, check desired files and click Use selected files.

When a Digital delivery product version is sold, RapidCart Pro sends an email containing protected link to purchased digital products. Generated links expires after the number of hours or number of downloads (whatever is reached first) set in Link Expiration and Download Limit found in Digital Delivery section of Customization Settings panel.

Set Download Limit to 0 to allow unlimited download until Link Expiration time is reached.

Digital delivery limit requires MySQL support on your server, which can be configured in Database section of Customization Settings panel.

Manual Sending a Digital Delivery

Product version configured as Digital Delivery can also be manually sent (or resent) to customers. Click button for desired product version, type customer email address and click Send.

Manual send requires your RapidCart Pro page to be published and Amazon S3 credentials to be set.

Blacklist

In case you're aware of an ongoing abuse, you can prevent some customers from accessing your store, placing an order and downloading your files - even before generated links expire - adding their email or IP address in Cart Blacklist panel. Customers IP address is printed in order receipt you receive after each purchase.

Blocking an IP address will prevent any access to the store. Blocking an email address will prevent placing an order using that email address.

All subsequent purchases from those address will be blocked as well.

Many Internet providers assign a dynamic IP to their users. Blocking customer IP address could not be effective for dynamic IP addresses.

Set Up Markets and Taxes

Choose Market Countries

Countries & Taxes tab is used to manage countries and regions where your products are sold, and relevant tax rates. Enabling one or more continents, countries or regions, they will be selectable by customer during checkout. Enabling a continent, or a country that contains other regions (like USA or Italy), children items will be enabled as well. A single item can then be disabled unchecking it.

Set Tax Rates

In a similar way, editing tax rate for a specific continent or country, tax rates of children items (if any) will be updated accordingly. You'll still be able to edit tax rate for a given children item.

During checkout, customer is asked for his/her country (or region) and associated tax rate will be applied.

RapidCart Pro supports up to 3 different tax rates for each country. This means you can setup a different tax tier for different products types (e.g. a default tax rate, a second one for books and a third one for food). Each product version can have a different tax rate set in Products Versions tab.

Shipping costs, payments fees and other cart costs and discounts always use Tax rate 1, if taxes are applied to these prices.

Further tax customization options are described in Cart section.

Add Costs and Discounts

Costs

Costs and Discounts panel is where additional costs, automatically applied on a rule-based logic, are handled. Costs can be calculated as a Fixed amount or as a Percentage of total amount of products they apply to. This is set using Mode dropdown.

You can also define a Start and End date for costs and discounts Validity. When a purchase is made outside validity range (if any), cost or discount is not applied.

When setting a Start and/or End date, keep always in mind that your server time zone may differ from your local time zone.

Costs and discounts can be applied to whole cart (e.g. a fixed cost for order handling), to specific Product SKUs, to products belonging to a given set of categories or tags and can be calculated on cart Total, Weight or number of Items. This is set using Type dropdown.

Changing Type, relevant options for selected costs and discounts calculation are shown. For instance, selecting a cost of Type Category or Tag you can type desired values, while selecting type Total or Weight a list lets you specify a set of Steps and associated Amounts.

You can apply a fixed cost of $5 for order handling simply creating a new cost of type Cart and setting an Amount of 5.

Discounts

Discounts are "negative costs". It's possible to transform a cost into a discount simply typing into Amount field a value less than 0. Same rules of costs applies.

Discounting specific product versions is really straightforward: create a new Product type discount, set desired Mode and Amount, finally enter discounted products SKUs into Values field.

Would you like to apply a 30% discount to shoes during spring? Just create a new Percentage type discount, set a Validity starting in March and ending in June, set desired category typing Shoes and enter -30 in Amount field.

Starting with RapidCart Pro 4.4 discounts automatically applied when adding a product to cart are better highlighted in Catalog and Product pages: previous price is struck-out and discounted price is shown instead.

Coupon Codes

Starting with RapidCart Pro 4.0, additional costs and discounts can be applied only if a specific Coupon code is supplied during checkout.

Enable coupon codes checking Requires coupon code and entering a unique Coupon code. You can also set a Usage limit for coupon codes, which is the maximum number of times a coupon codes can be used to complete a purchase. When limit is reached, that coupon code will be no longer accepted. Setting Usage limit to 0 means no usage limit applies.

Coupon codes require MySQL support on your server, which can be configured in Database section of Customization Settings panel.

Set Up Shipping Fees

If at least a product version configured as Physical, shipping is added to cart, during checkout RapidCart Pro shows a shipping method picker.

Like costs and discounts, shipping methods are calculated as a Fixed or Percentage amount using a rule-based logic. Setting the shipping rule Type you can choose if shipping fees are calculated using the number of Items in cart, order Weight or Total amount. You can define a set of Steps and associated amounts. If you prefer offering free shipping over a total amount, check Free shipping over total amount of and enter desired amount in the text field.

RapidCart Pro does't integrate with online shipping calculator by UPS, FedEx or other courier delivery services company. Shipping fee calculation is based only on rules set in plugin.

Countries control in Shipping panel can be used to limit the availability of a given shipping method to some countries.

If you don not enter any values into Countries control, shipping methods will be available for all countries.

Would you like to offer free In-Store Pick Up for customers in your region? Add a new In-Store Pick Up, check Free shipping over total amount of and set it to 0, then enable it only for you Country.

Set Up Payment Methods

RapidCart Pro supports five payment processors: PayPal, Stripe, Mollie, Direct Order and Cash On Delivery. Payment methods are enabled in Cart Payment panel. Every payment methods can be associated to a custom Name (that is a label shown during checkout), a fixed or percentage (calculated on total amount for order) commission fee and, like shipping methods, a set of countries where given payment methods is available.

For every supported payment processor, you can add a custom Receipt message that will be included in receipt sent to customer after placing an order. This field supports Markdown syntax to add links and format text. Special {customer_name} and {order_id} tags in Receipt Message field are replaced with actual customer name and order id.

Purchase receipt is an email sent by RapidCart Pro when payment is received. Email SMTP settings are customizable from section Email found in Customization Settings panel.

Payment processor like PayPal, Stripe and Mollie requires an actual payment to complete checkout. When enabled, they're a shown only when order total is greater than 0.

Use Position field to set the order used to display different payment options during checkout.

PayPal

PayPal payment is done integrating RapidCart Pro to PayPal gateway through API. You'll gain access credential (API Client ID and Secret) enabling API access in your PayPal account.

You must upgrade your account to PayPal Business to use PayPal API. More info available on PayPal Developer portal.

Here's the step by step instruction to enable access:

  • Log in using your PayPal account to PayPal Developer site: https://developer.paypal.com
  • Click on Dashboard from top menu
  • In My apps section choose Create App button in REST API apps section
  • Type RapidCart Pro in App name and click Create app
  • Clicking Sandbox or Live on the top right you'll finally reach access credential for Sandbox (i.e. test) and Live environments respectively
  • For enhanced security, in App feature option section (for both Sandbox and Live) enable only Accept Payments, then click Save.

Now copy and paste access credentials (API Client ID and Secret).

If you checked Use Sandbox (for testing purposes), use Sandbox credentials. Use Live credentials otherwise.

If you want to test your configuration in Sandbox environment, you must use a Personal test account during payment. Create this account clicking Accounts from Sandbox section of PayPal Developer site.

Stripe

Stripe payment is completely seamless for customers. As suggested by tooltip, test and live keys and additional required credentials can be found on Stripe web site, in Developers API Keys section.

How to enable Stripe in your store

  • Copy Publishable key and Secret key from Developers API keys on Stripe website.
  • Paste them in corresponding fields in Payments Stripe panel in RapidCart Pro plugin.
  • Republish your store page.

Complete documentation about Stripe API keys is available on Stripe website.

Credit cart numbers are NOT stored on your website. Only last 4 digits are printed on purchase receipt.

Mollie

Mollie is a Dutch payment processor that supports multiple payment methods including Credit Card, SOFORT Banking, iDEAL, Bancontact / Mister Cash, Bank Transfer, Belfius Direct Net, PayPal, Bitcoin and Paysafecard.

Mollie API key can be found in Websiteprofielen section (Dutch only) after creating a new test or live profile.

Direct Order

Direct Order payment method doesn't include any actual online payment processing and will send you an email containing order details. This is meant for offline payment processing, like wire transfer or cash on delivery. You can also add a custom Receipt message that will be included in receipt sent to customer. For instance, use this field to include your bank account details for wire transfer. This field supports Markdown syntax to add links and format text.

Checking Enable for free orders only this method is visible only when order total is equal to 0.

Purchase receipt is an email sent by RapidCart Pro when order is received. Email SMTP settings are customizable from section Email found in Customization Settings panel.

Cash On Delivery

Cash On Delivery is conceptually identical to Direct Order. Use it to apply a different commission or Receipt message to a second offline payment.

Localize your Store

Every store created with RapidCart Pro can be localized using your native language from Customization Localization panel.

Some localizable fields contain special values like %d or %s that are automatically replaced by RapidCart Pro with right value. Do not remove these values from your localized string.

Currency

Currency section allows to localize your store prices. It is also used to correctly handle payment when using PayPal. Select the right Currency code in order to accept payments using currency set in your PayPal account.

Date & Time

Date and Type product options and cart option can be localized in Date & Time section. Date Format field accepts any combination of DD, MM and YY values (used for day, month and year respectively). Use YYYY for 4-digit year.

Style Customizer

In Customization Style panel you can edit a custom CSS. Load an external file clicking Load CSS... or start visual online customizer clicking UIKit customizer....

UIKit customizer helps fine tuning every aspect of your CSS. When finished, click Get CSS. If Minify is checked, a compressed CSS version is generated in order to reduce loading time. Open in browser... can be pressed if you prefer using online UIKit customizer in your browser and later import generated CSS using Load CSS... button.

Other Customizations

RapidCart Pro allows to customize loads of features, from style to offered service configuration.

Style

RapidCart Pro offers three graphic styles to better adapt to project theme layout. Style settings are configurable from General section in Customization Settings panel. Force Base Style option, RapidCart Pro pages will adopt a default style for every base element (Heading, Tables, Lists). Check this option only if you encounter visualization issues with some store elements.

Customization Header & Footer panel is used to insert an optional text above and/or below store content. Markdown syntax, Styled Text and HTML formats are supported. From Customization Settings you can also limit the page types (Catalog, Product o Cart) where header and footer are shown.

Use Styled Text format Header or Footer to @import(()) other pages with PlusKit.

Settings Tab

Other customization settings are found in Customization Settings panel. Keep in mind that tooltips will help discovering more about them, but read on to learn more about most important ones.

General Settings Panel

Debug Mode was discussed in Checklist and Debug section of this manual.

If you'd like to put your store temporarily offline, check Enabled Maintenance Mode.

Checking Force HTTPS Protocol enhances the security of your store, forcing an encrypted connection to it. Your web server must support HTTS and supply a TLS/SSL certificate to connecting clients.

Checking Use CDN for Resources, needed Javascript and CSS resources loads from a CDN to speed up loading time and reduce traffic load on your web server.

Time Zone can be used to set your local time zone. Order receipt timestamp reflects this setting.

Session Validity Days settings lets you define the number of days (from a minimum of 1 to a maximum of 30) your store will keep cart content. For instance, setting it to 30, RapidCart Pro will remember cart content for a month.

Cookies Disclaimer controls explicit one time user consent for cookie usage, which is required by European (and some other non EU countries) laws. Uncheck to permanently disable.

Headers & Footer settings were discussed in Header & Footer section of this manual.

Contend Padding settings are useful to set a padding for store pages (catalog, products and cart).

Increase content padding if you're using "blank" themes like Foundation or Bootstrap.

Database Settings Panel

Some RapidCart Pro features like stock management, coupon codes and digital download limit requires MySQL support to work.

Use this panel to enter your database server details.

MySQL support is a service offered by hosting providers. If it's included in your offer, ask your hosting provider for configuration details.

Checking Save Order Details, order details will be automatically stored into database once orders are placed.

Saving order details into database is available only in RapidCart Pro Advanced.

Checking Show Low Availability Badge you can choose whether a low availability badge is automatically shown when available stocks are running out and set low availability quantity.

Checking Enable Rating, average product rating is shown when collected rating count is above Rating Threshold set. Customers receive a link to rate products they buy in order confirmation e-mail.

Cart Settings Panel

Cart section in Customization Settings allows to find a perfect setup for your cart and checkout process. Default Country option is used to set the default choice selected in Country picker.

Minimum Order field allows to set a minimum cart subtotal (that is excluding taxes and additional costs) required to accept order. If minimum amount for the order is not reached, a message warns customer during checkout.

Customer subsection contains settings related to optional fields shown during checkout. Optional fields can be set as hidden, shown or required. When a field is marked as required, customer must fill in it to proceed. Address Field is used to collect customer street address. Company Field is used to collect customer's company name.

Custom fields can be used to collect further customer data during checkout. There are 2 large, 2 medium, 2 small, 2 mini and 2 multiline custom fields available.

Do you want to collect customer's age? Set Require for Custom Field 7 and translate Custom Field 7 string as Age in Customization Localization panel.

Taxes subsection is used for fine tuning how taxes are shown and applied in cart. Show Taxes Split option can enable a detailed view of tax split for each cart element (as requested by German law). Following options can set if taxes are applied to specific items like Costs, Options, Shipping fees and Payment method fees.

EU VAT subsection contains settings useful if you resides in the European Union. Set Show for EU VAT ID Field to allow customers entering their EU VAT ID during checkout. Additionally, entered EU VAT ID can be validated using online VIES website checking Validate EU VAT ID. Doing so, only valid VAT IDs will be accepted. Setting Require for EU VAT ID Field customers will be required to enter a VAT ID number to proceed to checkout. Enable this if you are located in EU and want to sell to registered EU companies only (and not private citizens).

VIES web service is sometimes overloaded and thus unavailable. After a 3 seconds timeout, RapidCart Pro accepts what entered in EU VAT ID field to avoid blocking purchase process.

Order receipts sent to merchant use a check icon to show if supplied VAT ID has been successfully validated by VIES and include a link to learn more about registered company. Validated details may include company name and address (if available).

RapidCart Pro complies to European law on VAT reverse charge: choosing Your Country in EU VAT subsection, taxes are not applied for EU VAT ID owners purchasing from a different EU country.

If you are based in the European Union, set Your Country field in EU VAT subsection accordingly.

Checking Show Prices in Options subsection option prices are shown beside option names. Disclaimer subsection allows to enter a custom disclaimer text. Customer must explicitly accept disclaimer before proceeding to payment. This field supports Markdown syntax to add links and format text.

In Review subsection you can set where checkout button is shown.

Checkout subsection allows to customize "Thank You" page, which can be Default page with button link to catalog (that is default "Thank You" page with a button to go back to Catalog), Default page with button link to home (that is default "Thank You" page with a button to go back to site Home) or a Custom page whose URL is set in Custom "Thank You" page URL field below.

Catalog Settings Panel

In Catalog section you define customization settings for catalog page.

View Mode option controls catalog layout. It can be set to display product in a List view or classic Box view.

Show cart option enables cart content summary in catalog page. If set, cart is shown and when a product is added to cart, total amount is updated and cart content is shown clicking Cart button. If not set, cart is hidden and when a product is added to cart, customer is redirected to cart page.

Products per page option is used to set the number of products shown in each catalog page. When catalog contains more products than set amount, RapidCart Pro automatically handles catalog pagination. Show Add to Cart Button enables Add to Cart button in catalog page if a given product has a single version and no options. Doing so, product can be quickly added to cart, without requiring customer any additional choice.

Show Short Description can display product Short Description below product name, while Show Starting Price and Sort by Price settings can disable base price displaying and price-based sorting. Show Product Tag renders over product box image, at top right corner, a small badge showing first product tag (if available). Highlight Promoted Products sets an highlighted box color for promoted product.

RapidCart Pro is completely responsive and you can define the number of Columns displayed on large, medium and small devices. Catalog content automatically adapts to different screen sizes.

Set 1 column for small devices and 2 columns for medium devices to achieve optimal rendering on every device.

Keep in mind that most settings are strictly related to theme layout. Be sure of choosing a responsive theme and run some tests before going live.

Toolbar subsection allows to customize size and content for toolbar located on the right in catalog page.

Product Settings Panel

Product section is where you set up product page. Show Cart option is similar to the one found for catalog. If set, cart is shown and when a product is added to cart, total amount is updated and cart content is shown clicking Cart button. If not set, cart is hidden and when a product is added to cart, customer is redirected to cart page. Versions Columns sets the number of columns used to display product versions.

By default version boxes fade in while scrolling catalog page. Uncheck Enable scrollspy effect on version boxes to disable this effect if it doesn't fit the theme you've chosen (e.g. version boxes don't appear scrolling the page).

Checking Show Version SKU, RapidCart Pro displays version SKU code in version picker, in cart and in order receipt.

Checking Show Quantity Field displays quantity fields beside "Add to Cart" buttons in catalog and product pages.

Checking Show Option Price displays price variations, if any, beside each product option.

Show Default Taxes applies tax rate for Default Country (see Cart section) to all prices in catalog and product page. This setting, required by German law, shows prices with taxes for information purpose only. If customer proceed checkout and selects a different Country, appropriate tax rate is used.

Subtitle Labels is used to choose what's shown below product title (None, Categories or Tags).

When Show Short Description is checked, short description is displayed between title and long description.

Gallery Position and Gallery Size allow to customize product images. Checking Skip first image all images but first are used in product gallery. This may be useful if you want to show first image in catalog page only.

Choose a Gallery Size that fits theme layout and theme content.

If Enable Lightbox option is checked, when clicking on product image a full screen version is shown. Version Columns allows to define the number of columns shown in versions.

Related Products subsection is used to manage related products shown at the bottom of product page. Products related to the same category or tag are shown in random order.

Social subsection contains settings to enable product sharing on popular social networks like Facebook, Twitter, Google+ and Pinterest. Show Disqus Board can be checked to enable Disqus comment service. Disqus shortname can be found in General Site Identity Shortname section in your Disqus settings page.

Email Settings Panel

Email settings for sending payment or order receipts are located in Email section of Customization Settings panel. By default RapidCart Pro relies on default SMTP set for your web server. Check Use external SMTP if your provider blocks email sending or you prefer to use an external server instead.

Carefully check with your hosting provider which methods are allowed for sending emails. Some provider plan, like Godaddy shared hosting, blocks external SMTP servers. Some others allow sending mails using an external SMTP only.

From and Reply-To subsections are used to set names and email addresses used for receipts. Set an email address in Receive Orders At subsection to receive a copy of every payment and order receipt sent. Since RapidCart Pro 4.5.0, Receive Orders At also accepts a comma-separated list of multiple email addresses.

If you leave Email Address field blank in Receive Orders At subsection, receipts will be sent to Email Address set in From section. Specify a different Receive Orders At email address if your prefer receiving orders on a different email address.

Confirmation email subject includes by default order number using special tag %ORDER_ID%. Confirmation email subject can be customized in Customization Localization panel, in Order section.

Dealer Settings Panel

In this section you can configure up to 2 dealer accounts that can buy with percentage discounts set in Discount field. Dealers can login using a hidden page that can be reached appending ?login to the URL of your RapidCart Pro page. For instance, if your RapidCart Pro page URL is https://www.mydomain.com/rapidcartpro/?catalog/all/-/date/1 you just need to substitute ?catalog/all/-/date/1 with ?login. So dealers will be able to login at the URL https://www.mydomain.com/rapidcartpro/?login.

When a dealer is logged in, a red You are now signed in as a dealer message is shown in every store page. This message can be translated in Customization Localization panel. A red Dealer badge is shown in order receipt as well.

Dealer discount can be applied to whole cart choosing All in Apply To field. Discount can be applied only to products, shipping costs or payment fees selecting the corresponding values.

If you'd like to offer free shipping to your dealers, set 100 as Discount value and select Only shipping in Apply To field.

Online Administration

Starting with RapidCart Pro 4.1, online administration and store stats are available.

Configuration and access

Access details for online administration can be set in Admin section of Customization Settings panel. From here you'll be able to set a main user with full access and a secondary user with read only privileges. There's also an option to choose what's the first page selected right after being logged in, either Stats page or Orders page.

You can reach online administration page pushing Online administration... button, available from plugin's inspector about panel. This page is also available simply adding ?admin at the end of your store's URL (e.g. http://www.domain.com/store/index.php?admin).

Online Administration requires you to set up a main user with non blank password in order to work.

Online Administration is available only in RapidCart Pro Advanced and requires MySQL support on your server, which can be configured in Database section of Customization Settings panel.

On iOS devices, "Add to Home Screen" your admin area and use it like a native app.

Control Toolbar

Use control toolbar of Online Administration area to browse available sections. A red notification badge appears beside section name when something requires your attention. Badge besides Orders button shows orders that need to be shipped. Badge besides Products button shows products using stock management that are running out of stocks (available quantity is less than or equal to 5).

Push Notifications

RapidCart Pro can send a real time push notification when an order is placed on your store. Clicking on the web notification you are redirected to order details in admin area.

In order to activate push notifications:

  1. Check Get push notifications for orders in Admin section of Customization Settings panel.
  2. Republish your store
  3. Visit Admin section using Safari on OS X
  4. Click on Notifications menu on upper right corner of the toolbar
  5. Accept enabling push notifications

You'll now receive a notification every time an order is placed on your store.

Push notifications work only on Safari for OS X and only when HTTPS is enabled for your store.

In order to disable or check push notifications status open Notifications tab in Safari preferences panel and look for RapidCart Pro website entry.

Push notifications are handled through a third party service. Enabling push notifications you accept that some order details are sent to a remote server. Those details remain confidential and are not publicly shared.

Orders Section

From Orders section you can browse order history, perform a full-text search or filter it using a date range or order status.

Full-text search looks up Order ID, Customer Name, Customer Email, Customer Company, Customer EU VAT ID, Product SKU, Payment Type, Payment Name, Coupon, Notes and Referrer fields. Limit text search to a single field using one of the following tags: id, name, email, country, company, vat, sku, payment, coupon, notes or referrer.

Find all orders payed with PayPal using payment:paypal as search string.

Find orders for those coupon code X1234 was applied using coupon:X1234 as search string.

Cancelled or Fully refunded orders are grayed out in this section.

Clicking an order when logged in as main user, you'll be able to edit order status and add a note that will be included in full-text search.

When an order is marked as Refunded, you'll be able to set a refunded amount split into Subtotal, Taxes and Total.

Setting a refunded amount here won't actually refund customers. You'll still need to manually process refunds through your payment gateway or your bank account.

Clicking on Link button located on the upper right corner of order summary page you'll be redirected to online receipt. Linked receipts can be shared with your customers.

Products Section

Products section lists only published products that have Stock Management enabled.

You can filter products using Product Name, Version Name or SKU and sort them by Product name or Available Quantity. Full access user can edit Available Quantity here.

When Available Quantity is less than or equal to 5, products are marked with a red alert icon and Quantity field is red.

Coupons Section

Coupons section shows available coupon codes and their usage limit. Full access user can edit Usage Limit here. When Usage Limit is less than or equal to 5, coupons are marked with a red alert icon and Usage Limit field is red.

Stats Section

Stats section shows stats about your store orders.

Trends subsection shows sale trends for past ´5´ days, ´5´ months or ´5´ years.

Sales subsection shows of past 30 days. Move your mouse (or your finger, on mobile devices) over chart to see total order amount and number of orders for a given day.

Best Seller subsection shows best selling product in terms of number of units sold. Move your mouse (or your finger, on mobile devices) over chart to see total sale amount.

Best Weekday subsection shows total sales split by weekday.

Webhook

If a web address is set in Webhook section of Customization Settings panel, all details are sent in POST method and JSON format to that URL once payments are made or orders are placed. In this way you'll be able to process order and customer data in a custom web app or use them to feed your ERP software.

Webhook is available only in RapidCart Pro Advanced.

JSON data main structure sent to webhook URL is as follows.

{
    "ID": "55B2580A9F4E8",
    "items": [
        {
            "quantity": 1,
            "product": {
                "name": "Nike AW84 Graphic",
                "version": "Volt",
                "SKU": "643383-702",
                "options": [],
                "price": 30
            }
        },
        {
            "quantity": 1,
            "product": {
                "name": "Nike Tech Fleece AW77",
                "version": "Light Photo Blue",
                "SKU": "559592-435",
                "options": [
                    {
                        "name": "Size",
                        "values": [
                            "L"
                        ]
                    }
                ],
                "price": 110
            }
        },
        {
            "quantity": 1,
            "product": {
                "name": "Nike Air Max 90 Essential",
                "version": "Wolf Grey",
                "SKU": "537384-039",
                "options": [
                    {
                        "name": "Size",
                        "values": [
                            "9.5"
                        ]
                    }
                ],
                "price": 110
            }
        }
    ],
    "customer": {
        "name": "Mario Rossi",
        "emailAddress": "mario.rossi@thecompany.it",
        "country": "Italy",
        "countryCode": "IT",
        "company": "The Company spa",
        "VATID": "12345678901",
        "VATIDVerified": true,
        "street": "via Garibaldi, 12",
        "ZIPCode": "30172",
        "city": "Venezia",
        "state": "Veneto",
        "stateCode": "IT-34",
        "IP": "123.456.789.012"
    },
    "options": {
        "price": 0,
        "weight": 0,
        "set": []
    },
    "shipping": {
        "name": "Priority 1-Day",
        "price": 5
    },
    "payment": {
        "method": {
            "name": "Cash on Delivery"
        },
        "price": 0
    },
    "taxes": 0,
    "subtotal": 217,
    "total": 222,
    "taxable": 222,
    "weight": 0,
    "costs": {
        "total": -33,
        "list": [
            {
                "description": "30% Off Shoes - Spring\/Summer 2015",
                "price": -33
            }
        ]
    }
}

Here's a PHP sample code that receives data sent and saves them in a object variable.

<?php

$data = json_decode(file_get_contents('php://input'));

?>

Stacks

RapidCart Pro is designed to work with YourHead Stacks. In RapidCart Pro DMG image used for plugin installation you'll find Cart, Grid, Product and Store stacks. RapidCart Pro stacks can be customized from sidebar panels. Include stacks in your pages to extend RapidCart Pro features.

RapidCart Pro install DMG includes a sample Demo Store project and a link to published Demo Store. Feel free to explore this project to learn more about RapidCart Pro stacks.

Stacks requires main RapidCart Pro page to be published to a web server in order to be populated with actual content. This is why in edit mode they display a layout preview using sample placeholder content.

Cart Stack

Cart stack is used to place a cart button in your page. Cart button shows automatically updated cart total and once clicked redirects your customers directly to cart section.

Grid Stack

A grid is a multi-column set of products, which is automatically populated using the Filter By and Sort By stack controls. You can choose to display here products related to a specific tag, category or keyword and have them sorted by date, name or price. Customers can click on a product to get redirected to product page.

Show newest 4 products in women collection filtering grid by woman tag and sorting by Date.

Product Stack

This stack allows to build a fully functional custom product page, combining together the different parts that make a RapidCart Pro product page.

Product stack lets you display a single Random or Fixed product in your layout. Set a given fixed product typing the corresponding Product ID shown in top right corner in Products General tab of RapidCart Pro plugin page.

A product stack can be configured to display of the following page parts.

Box Part

Use this part to display a product box including thumbnails, title, short description and either Add to Cart or View Product button.

Gallery Part

Use this part to display complete product image gallery.

Versions Part

Use this part to display available product versions including Add To Cart button. Setting a Version SKU value you can display a specific version.

Add to Cart Part

Use this part to display a simple Add To Cart button for the version specified by Version SKU.

Tags / Categories Buttons Part

Use this part to display tags and Categories buttons for product.

Social Buttons Part

Use this part to display share buttons for enabled social networks.

Description Part

Use this part to display long product description.

Store Stack

This stack allows to embed a whole RapidCart Pro store inside a Stacks page, for instance when using blank themes like Foundation.

Even when using Store stack, RapidCart Pro page must be included in your project, but it can be hidden unchecking Show in navigation from Page Options General Settings.

When using Store stack, your store address changes to the URL of the page that includes the stack. New store URL must be set in Customization Settings General Stacks Store URL field.

Store stack has been released starting with RapidCart Pro 4.7. If you can't find it in your stacks library, you'll need to install it from Extras folder of RapidCart Pro install DMG.

Data Exchange

RapidCart Pro supports data import and export from / to external data sources. This is an extremely powerful feature that can be used to create and update your product catalog. Data import wizard can be started pushing button. Data export wizard can be started pushing button.

Both are found in Products panel, at the bottom of product list.

CSV Data Import and Export are available only in RapidCart Pro Advanced.

CSV Data Import

After selecting a CSV text file for import, RapidCart Pro automatically analyzes it and produces a detailed log of what actions and modifications an actual import would make. Serious errors are highlighted in red.

Switching to Raw data tab, you can have a glimpse at CSV data in a tabular form. This is particularly useful when an error occurs during the analyze phase. Push Import data button to start data import.

Carefully examine analyze phase log before performing an actual import.

RapidCart 3.6+ product data import

RapidCart Pro can import product data from RapidCart 3.6+ pages. Start product data import choosing Import RapidCart 3 data.... RapidCart Pro will collect product data from every RapidCart 3.6+ page you've loaded since last RapidWeaverâ„¢ restart.

Be sure to set a unique SKU for each RapidCart 3.6+ product before starting data import in RapidCart Pro.

At the end of import process, you'll be asked to export RapidCart 3 product images to a local folder. You'll need to re-import them as project resource in order to use them in your RapidCart Pro page.

PayLoom 2 product data import

RapidCart Pro can also import product data from PayLoom 2 pages. Start product data import choosing Import PayLoom 2 data.... RapidCart Pro will collect product data from every open RapidWeaverâ„¢ project containing PayLoom pages.

Be sure to set a unique Product ID / Number for each PayLoom product before starting data import in RapidCart Pro.

At the end of import process, you'll be asked to export PayLoom product images to a local folder. You'll need to re-import them as project resource in order to use them in your RapidCart Pro page.

CSV data format

Comma Separated Value (or, in short, CSV) is a common but non-standard format for data exchange using simple text files. More info about CSV are available here.

RapidCart Pro expects an UTF-8 .csv text file that respects following rules:

  • contains a header describing column content
  • , is used as field separator
  • decimal numeric values (e.g. prices) use . as decimal separator
  • line separator and field separator are used only in quoted fields, that is fields enclosed between two quote separators ".
  • strings containing quote separator " can be used only in quoted fields and each of the embedded double-quote characters must be represented by a pair of double-quote characters "".

Any fields may be quoted, even if it does not require quoted fields.

Column order is not relevant, but all lines must have the same number of fields, in the same order.

First line in CSV file is the header line, which describes the content of each column. Each line in CSV describes a single product, 1 to 10 versions and up to 10 available options.

The only mandatory column is versionSKU: all other data are applied to matching SKU. If a product version with given SKU exists, it is updated with supplied values. If a product with given version does not exists, a new product with supplied values is created.

Here's a list of available column types:

  • Product-related types (update existing product containing versionSKU or create a new one):

    • productExportEnabled: 1 or yes if product export is enabled. Any other value is interpreted as no. This key is supported for compatibility purpose only, use productExportState instead.
    • productExportState: 1 if product state is "enabled". -1 if product state is "hidden". 0 if product state is "disabled". Requires RapidCart Pro 4.0 or better.
    • productPromoted: 1 if product is "promoted". 0 if product is not promoted. Requires RapidCart Pro 4.5 or better.
    • productCreationDate: a string in YYYY-MM-DD format containing product creation date, which is used for date sorting in published page. For instance, March 1 2016, would be 2016-03-01.
    • productName: product name. This field cannot be blank.
    • productCategories: a string containing one or more product categories separated using | character, e.g. sport|woman|man
    • productTags: a string containing one or more product tags separated using | character, e.g. tennis|jogging|promo|blue
    • productPageURL: URL for custom product page. Requires RapidCart Pro 4.6.2 or better.
    • productShortDescription: plain text used as product short description.
    • productLongDescriptionMarkdown: markdown string used as product long.
    • productLongDescriptionHTML: HTML string used as product long.
    • productResources: a string containing one or more remote image URLs separated using | character, e.g. http://aaa.com/img/1.jpg|http://aaa.com/img/2.jpg. This key is supported for compatibility purpose only, use productResourceData instead.
    • productResourceData: a special strings containing one or more resource data sets separated using | character. Every resource data set is a quadruple in the format [<type>][<resourceURL>][<thumbnailURL>][<caption>], where <type> can be either image (or just i) or video (or just v), while <resourceURL> and <thumbnailURL> are paths to main resource and thumbnail resource respectively, and <caption> desired caption, e.g. [i][http://us.com/1.jpg][http://us.com/1small.jpg][My cap]|[i][http://us.com/2.jpg][][]. Thumbnail path and caption are optional. Updates existing product resource matching <resourceURL> or create a new one. Requires RapidCart Pro 4.5 or better.

  • Version-related types

    • versionSKU, versionSKU1 ... versionSKU9: version SKU. This field cannot be blank. Updates existing version with supplied SKU or create a new one.
    • versionName, versionName1 ... versionName9: version name. This field cannot be blank.
    • versionPrice, versionPrice1 ... versionPrice9: price for selected version. . must be used as decimal separator.
    • versionWeight, versionWeight1 ... versionWeight9: weight for selected version. . must be used as decimal separator.
    • versionShipping, versionShipping1 ... versionShipping9: 1 or yes if version is shippable. Any other value is interpreted as no. If this value is missing, its default value is yes, so RapidCart Pro assumes version is shippable.
    • versionDigital, versionDigital1 ... versionDigital9: 1 or yes if version is digitally delivered. Any other value is interpreted as no. Requires RapidCart Pro 1.2 or better.
    • versionAvailable, versionAvailable1 ... versionAvailable9: 1 or yes if version is available. Any other value is interpreted as no.
    • versionQuantity, versionQuantity1 ... versionQuantity9: maximum per-order quantity limit.
    • versionStockEnabled, versionStockEnabled1 ... versionStockEnabled9: 1 or yes if Stock Management is enabled. Any other value is interpreted as no. Requires RapidCart Pro 4.7 or better.
    • versionStockQuantity, versionStockQuantity1 ... versionStockQuantity9: available stock quantity. Requires RapidCart Pro 4.7 or better.
    • versionTaxes, versionTaxes1 ... versionTaxes9: 1 or yes if version is taxable. Any other value is interpreted as no.
    • versionTaxRate, versionTaxRate1 ... versionTaxRate9: Applied tax rate tier. Valid values are 1 for Tax rate 1, 2 for Tax rate 2 or 3 for Tax rate 1. More info about tax rates are available in Set Tax Rates section of this manual. Requires RapidCart Pro 4.7 or better.

  • Option-related types (define options for product containing versionSKU):

    • optionType, optionType1 ... optionType9: option type. Accepted valued are: text, textarea, date, time, number, select, checkbox, radio.
    • optionName, optionName1 ... optionName9: option name. This field cannot be blank. Updates existing option with supplied name and type or create a new one.
    • optionRequired, optionRequired1 ... optionRequired9: 1 or yes if option is required. Any other value is interpreted as no.
    • optionMin, optionMin1 ... optionMin9: minimum value for option. Applies to number option type only.
    • optionMax, optionMax1 ... optionMax9: maximum value for option. Applies to number option type only.
    • optionMultiplier, optionMultiplier1 ... optionMultiplier9: multiplier value for option. Applies to number option type only. Requires RapidCart Pro 4.1.2 or better.
    • optionDateMin, optionDateMin1 ... optionDateMin9: minimum value for date option. Applies to date option type only. Requires RapidCart Pro 1.1 or better.
    • optionDateMax, optionDateMax1 ... optionDateMax9: maximum value for date option. Applies to date option type only. Requires RapidCart Pro 1.1 or better.
    • optionValues, optionValues1 ... optionValues9: a special strings containing one or more option values separated using | character. Every option value is a triple in the format [<value>][<price>][<weight>], where <value> is a descriptive string, while <price> and <weight> are numbers using . as decimal separator. Updates existing option value with supplied name or create a new one. Applies to checkbox, radio and select option types only. For instance, a select option value for picking up clothing size could look like this [S][10.00][0.6]|[M][12.50][0.7]|[L][15.00][0.8]

Column type is case sensitive.

As every line contains 1 to 10 versions, columns could be for instance named like versionSKU, versionSKU1, versionSKU2, versionName, versionName1, versionName2. In this example versionSKU2 and versionName2 provide SKU code and name for the same version.

A similar rule applies to options, though they're not linked to a specific version. For instance, CSV could contain columns named optionType, optionType1, optionRequired, optionRequired1. In this case, optionType1 and optionRequired1 refers to the same option.

RapidCart Pro install image includes sample CSV files to help you get started.

🚨🚨 Troubleshooting 🚨🚨

Here's a list of solutions for most common problems and error messages on deployed RapidCart Pro pages.

RapidCart Pro requires TLS 1.2 support: ask your hosting provider to comply to our requirements.

PayPal error 401

Error 401 means your PayPal keys are incorrect. Double check that you're not using Sandbox API keys in Live mode (or viceversa) and that you didn't append trailing spaces or new line chars at the end of the key.

Could not instantiate mail function

You'll need to ask for support to your hosting provider, which is preventing PHP code from sending emails.

Products are not added to cart

RapidCart Pro needs web address you visit exactly matches the one you set in RapidWeaver project settings. Choose the address you want to use (e.g. with or without www. prefix) and update it accordingly.

Cart is empty during checkout or after page reload

RapidCart Pro relies on PHP sessions to temporary store cart content. If cart is empty when you change page or simply refresh, it means that PHP sessions are not correctly configured. Report the problem to your hosting provider.

Files stored in Amazon S3 are not available

Double check your files are stored in a S3 region supporting signature version 2.

Fatal error: Class 'RCUtilities' not found trying to access web store

If you've upgraded to RapidWeaver 8, double check your File Links are: option in RapidWeaver advanced project settings. Set it to default Relative to Page and republish.

Digital delivery fails with error: 'The authorization mechanism you have provided is not supported'

Some Amazon S3 regions are not supported by RapidCart Pro. Choose a region that supports signature version 2 to store your digital downloads. A complete list of S3 regions and supported signature versions is available on AWS web site.

RapidCart error exporting resources

If you're getting an error about invalid or no longer available resources during export or publish, you'll need to check out RapidCart Pro console log in order to understand which resources are generating the error.

Unfortunately, in most recent RapidWeaver releases, console logging has been turned off by default.

In order to turn it on, close RapidWeaver, open a Terminal and paste following command

defaults write com.realmacsoftware.rapidweaver8 RWEnableExceptionHandling NO

Now relaunch RapidWeaver, open Console app and when this message appear look at any relevant log message. You should get a list of linked resources which can't be found by RapidCart Pro.

Once fixed, you can disable logging issuing this Terminal command:

defaults write com.realmacsoftware.rapidweaver8 RWEnableExceptionHandling YES

and restarting RapidWeaver.