getButterfly Logo

OneCart Documentation

Note: This instructions, tutorials and code snippets may be deprecated/obsolete and subject to change while OneCart is in beta.

Getting Started

Import demo content/sample data

The official theme demo site can be imported via a dummy_content.xml file.

First, locate the demo content file. Please extract the package you downloaded from getButterfly. You will get a folder called Demo. Inside that folder there is a demo file called dummy_content.xml.

How to import the file?

  1. Login to your WordPress dashboard
  2. Click on ToolsImport
  3. Choose WordPress
  4. If prompted to install a plugin, please install it
  5. Click on Browse and select dummy_content.xml file
  6. Upload file and import it

This process gives you the same look, slides and products as seen in the official demo. It is also a good starting point for your own store.

Installing OneCart

Server Requirements

Almost every web host provides the minimum requirements for OneCart platform. However please make sure that you have the following minimum server requirements before installing the theme:

  • A self-hosted WordPress 4.8 or greater
  • PHP 5.5 or greater
  • MySQL 5.5 or greater
  • The mod_rewrite Apache module (for permalinks)
  • fsockopen support (for payment gateway IPN access)

Installation

The installation of OneCart is really simple. Please follow these steps to install the theme properly on your site:

  1. Unzip the package you downloaded from getButterfly
  2. After extracting you should have a onecart.zip file which is the installable theme and main package which you will install
  3. Login to your WordPress Dashboard and go to AppearanceThemes
  4. Click on Install Themes
  5. Browse your platform and select the onecart.zip file from your system then click on Install Now
  6. Once the theme is installed properly, activate it

Upgrading OneCart

Upgrade

  1. Rename your existing theme installation folder to something else via your FTP client or file manager. The theme is located under /wp-content/themes/
  2. Unzip the package you downloaded from getButterfly
  3. After extracting you should have a onecart.zip file which is the installable theme and main package which you will install
  4. Login to your WordPress Dashboard and go to AppearanceThemes
  5. Click on Install Themes
  6. Browse your platform and select the onecart.zip file from your system then click on Install Now
  7. Once the theme is installed properly, activate it

Tutorials

Activate and use the enhanced navigation menu

Please log in to your WordPress dashboard and go to ocCommerce → Settings → Customization tab.

Under Main Menu Style option, please select Enhanced Multi-level menu (the 2nd choice).

Save changes in your settings panel.

The second step after activating the main navigation menu is to build a navigation menu using the Menus dashboard.

Please go to Appearance → Menus, create a new menu and name it Main Navigation for example. Please fill in the menu using the links on left. Add custom links, categories, pages, or any other attributes to the menu then save your created menu.

Please make sure that you have selected which menu appears in each location. Under Theme Location → Main Navigation set this to your main navigation menu that you’ve just created.

Save menu and you are done!

Add a custom currency

If you cannot find your currency in the built-in, available currencies you can add your custom currency or any number of custom currencies to the framework. Please follow these steps to add a custom currency:

  1. Go to ocCommerce → Settings panel
  2. Click on Setup Payments tab
  3. In Supported Currencies option, add your new/custom currency code to the list with a comma. That list is a comma separated list of all available currencies in your store. For example: USD, EUR, JPY
  4. Save Changes

After saving changes, your new currency will be available now in the Primary currency code dropdown list If you want to make your new currency the primary currency (Default currency) please select it from the dropdown list and then save changes.

Your primary currency is the default currency in your store. Make sure you set this option to your primary/default currency code.

Supported currencies are the currencies you offer/support in front-end store besides your Default currency, they are available only if you have activated the Multi-Currency Module to offer users the choice of converting from the base currency to the supported currencies.

Add a custom currency symbol

  1. Open your functions.php file
  2. Find the following line: case 'USD': $code = '$'; break;
  3. Below it add: case 'JPY': $code = '¥'; break;
  4. Save the file and close

That is it. The above example, adds the symbol of JPY (Japanese Yen) you can add any custom symbol for your currency code (which is 3-letters) easily and using the same instruction.

Add custom product options/attributes

The theme has functionality to let you add or create unlimited product options or attributes.

A product attribute is a term you can use to describe/sell and filter products like: color, size, style, model, metal, etc.

To add a custom product attribute please open your WordPress admin, go to ocCommerce → Settings → Product Attributes tab.

You will now view fields to create/add a new attribute:

  1. New Attribute Slug/Shortname Enter your new attribute slug or shortname here. For example: model
  2. New Attribute Plural Word Enter your plural attribute form. For example: models
  3. New Attribute Single Word Enter your single attribute form. For example: model

Save Changes. Now your new attribute is ready to be used in your store.

Add custom shipping zones/rates

You can add unlimited custom shipping zones and rates to take control of your shipping/tax rates based on customer location/region.

Please login to your WordPress dashboard, and go to ocCommerce → Settings → Shipping and Tax tab.

You are now prompted to add a new zone. Each zone can contain countries, regions, cities, and zip codes and custom shipping/tax rates. Follow these steps to add a sample zone:

  1. Enter a name for the zone in the name field
  2. In Regions field please add regions to the zone separated by a comma. For example: United States, New York, 10012
  3. Charge Fixed Tax Rate Enter a number here if you wish to charge a fixed tax when customers from the specified regions purchase from your store for example: 10 this will add $10 as tax
  4. Charge Percentage Tax Rate Enter a number here if you wish to charge a percentage based tax when customers from the specified regions purchase from your store for example: 25.50 this will charge tax as 25.50% based on Cart subtotal
  5. Charge Fixed Shipping Rate Enter a number here if you wish to charge a fixed shipping fee when customers from the specified regions purchase from your store for example: 24.99 this will add $24.99 as shipping charges
  6. Charge Percentage Shipping Rate Enter a number here if you wish to charge a percentage based shipping fee when customers from the specified regions purchase from your store for example: 20 this will charge shipping as 20% based on Cart subtotal

Click now on Add New Zone. You new zone is now available and can be edited from Edit Zones below.

Now you can test your new zone settings from front-end. Here are the steps:

  1. Add a product to cart
  2. View cart
  3. Enter any of the regions you specified in test zone
  4. Click on Calculate
  5. Shipping and tax rates are now applied via ajax on the cart

Add different prices for product options

You can set different prices for the different product options you have inside each product, this means that you can have a special option or options that have extra price than your original price. To set this up please follow these steps:

  1. Open your Products panel
  2. Edit product
  3. Under Pricing settings, you can see the different options/terms for your product, every option has a field where you can put the change in price if that option is selected by customer
  4. The change needs to be positive or negative, for example: +10 or -5 that tells the theme if this option is selected the original product price will be changed by that setting
  5. Save your product

The price changes are done dynamically and do not interfere with each other, means that If you sell a product at $50 and If you have a White option that costs $60, and a Small size which offers the same product for $45. The price will be $55 if customer selected these two options before purchase $50 + $10 – $5 = $55.

Enabling Multi-Language Store

Please go to ocCommerce → Settings admin panel and click on the first tab General Settings. Now in the second option where it says Enable Multi-Language Module please make sure that is Enabled then save changes in your dashboard.

Payment Gateways

Authorize.net

This plugin enables Authorize.net payment gateway on your store. Take credit card payments through Authorize.net.

iDeal Mollie

iDeal Mollie is a gateway plugin which extends OneCart allowing you to take payments with iDeal via Mollie. When an order is placed, the customer chooses their bank and is taken to iDeal to make a secure payment via Mollie. Because iDeal handle the payment process for you, no SSL certificate is required on your site.

PagosOnline

This plugin enables PagosOnline payment gateway on your store. Start taking payments via PagosOnline payment gateway.

PayEx

This plugin enables PayEx Norwegian payment gateway on your store. Take credit card payments through PayEx.

PayPal Payflow Pro

This plugin enables Payflow Pro payment processing on your store. This is for vendors who wish to have their own credit card processing form and use Payflow Pro to process and accept credit card transactions.

PayPal Standard

This plugin enables PayPal standard payment gateway on your store. You can start accepting PayPal payments after installing this plugin.

Realex Payments (UK)

This plugin enables Realex payments on your store. A leading payments provider in the UK.

Skrill (Moneybookers)

This plugin enables Skrill (Moneybookers) payment gateway on your store. You can start taking payments via Skrill/Moneybookers.

Zaakpay

This plugin enables Zaakpay payment gateway on your store. Start accepting payments via the popular Indian gateway.

Language Packs

Coming soon.


Subscribe to our mailing list