REV. 2022-03-03
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.
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.
Web Address set in RapidWeaver's general project settings in order to work.In this manual, some typographic conventions help you highlighting important concepts.
Get your copy of RapidCart Pro from product page on our site http://4gnd.com/rcpro.
Double click on file RapidCartPro.rapidweaverplugin you'll find inside downloaded DMG image. RapidWeaverâ„¢ will open and RapidCart Pro will be automatically installed.
Having a look at our demo store project is a great way to get you started with RapidCart Pro.
Hover your mouse over control labels in Customization Settings and Cart Payment windows to get usage tooltips.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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:
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.
Here's the step required to load your files in Amazon S3:
Everyone in Permissions section.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.
0 to allow unlimited download until Link Expiration time is reached.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.
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.
All subsequent purchases from those address will be blocked as well.
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.
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.
Further tax customization options are described in Cart section.
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.
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.
Cart and setting an Amount of 5.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.
Product type discount, set desired Mode and Amount, finally enter discounted products SKUs into Values field.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.
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.
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.
Countries control in Shipping panel can be used to limit the availability of a given shipping method to some countries.
In-Store Pick Up, check Free shipping over total amount of and set it to 0, then enable it only for you Country.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.
0.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.
Here's the step by step instruction to enable access:
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.
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.
Complete documentation about Stripe API keys is available on Stripe website.
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 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.
Cash On Delivery is conceptually identical to Direct Order. Use it to apply a different commission or Receipt message to a second offline payment.
Every store created with RapidCart Pro can be localized using your native language from Customization Localization panel.
%d or %s that are automatically replaced by RapidCart Pro with right value. Do not remove these values from your localized string.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 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.
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.
RapidCart Pro allows to customize loads of features, from style to offered service configuration.
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.
Styled Text format Header or Footer to @import(()) other pages with PlusKit.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.
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).
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.
Checking Save Order Details, order details will be automatically stored into database once orders are placed.
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 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.
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).
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.
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.
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.
1 column for small devices and 2 columns for medium devices to achieve optimal rendering on every device.Toolbar subsection allows to customize size and content for toolbar located on the right in catalog page.
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.
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 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.
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.
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.
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.
100 as Discount value and select Only shipping in Apply To field.Starting with RapidCart Pro 4.1, online administration and store stats are available.
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).
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).
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:
You'll now receive a notification every time an order is placed on 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.
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.
payment:paypal as search string.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.
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 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 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 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.
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.
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'));
?>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.
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.
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.
woman tag and sorting by Date.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.
Use this part to display a product box including thumbnails, title, short description and either Add to Cart or View Product button.
Use this part to display complete product image gallery.
Use this part to display available product versions including Add To Cart button. Setting a Version SKU value you can display a specific version.
Use this part to display a simple Add To Cart button for the version specified by Version SKU.
Use this part to display tags and Categories buttons for product.
Use this part to display share buttons for enabled social networks.
Use this part to display long product description.
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.
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.
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.
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.
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.
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.
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.
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:
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):
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.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.1 if product is "promoted". 0 if product is not promoted. Requires RapidCart Pro 4.5 or better.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.| character, e.g. sport|woman|man| character, e.g. tennis|jogging|promo|blue| 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.| 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
. must be used as decimal separator.. must be used as decimal separator.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.1 or yes if version is digitally delivered. Any other value is interpreted as no. Requires RapidCart Pro 1.2 or better.1 or yes if version is available. Any other value is interpreted as no.1 or yes if Stock Management is enabled. Any other value is interpreted as no. Requires RapidCart Pro 4.7 or better.1 or yes if version is taxable. Any other value is interpreted as no.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):
text, textarea, date, time, number, select, checkbox, radio.1 or yes if option is required. Any other value is interpreted as no.number option type only.number option type only.number option type only. Requires RapidCart Pro 4.1.2 or better.date option type only. Requires RapidCart Pro 1.1 or better.date option type only. Requires RapidCart Pro 1.1 or better.| 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]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.
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.
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.
You'll need to ask for support to your hosting provider, which is preventing PHP code from sending emails.
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.
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.
Double check your files are stored in a S3 region supporting signature version 2.
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.
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.
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.