User Guide

### “OneCart WordPress Theme” Documentation by “ThemeFluent” v1.0

# “OneCart WordPress Theme”

Updated: 12 November, 2012
By: ThemeFluent
Email: support@themefluent.com

Thank you for purchasing my theme. If you have any questions that are beyond the scope of this help file, please feel free to email via my user page contact form here. Thanks so much!

## Table of Contents

1. Basic Structure
2. Installation
3. Setting up your Theme
4. Adding Theme Widgets
5. Adding Theme Menus
6. Adding a Sample Product
7. How to Add/Edit Slides
8. How to Manage Received Orders
9. How Email Notifications Work
10. Installing Demo Content

### A) Basic Structure - top

- ZIP Package (original downloaded file)
  - onecart.zip (The theme's ZIP file, the one you upload to your theme's directory in WordPress)
  - onecart-child.zip (Use this child theme to customize your store, CSS, skins, images, and languages)
  - /PSD (The PSD version of this theme)
  - /HTML (The HTML version of this theme)
  - /Licensing
  - /Manual (This help file)
  - /Demo (XML file with demo content)
  - /Fonts

### B) Installation - top

1. Unzip the theme file you downloaded on your PC
2. Open your WordPress dashboard and go to Appearance > Themes
3. Click on Install Themes then choose Upload
4. Browse and upload the main theme's ZIP file onecart.zip
5. Activate your theme

### C) Setting up your Theme - top

When you activate this theme, default settings will be automatically populated to help you get started quickly. The theme includes a dashboard called ocCommerce where you can manage and edit theme options, it is right in your WordPress dashboard menu.

However, before you go live with your store there are specific settings that need your attention. Please open up the ocCommerce panel and click on Setup Payments tab and configure your payment settings like global currency, your PayPal email address, and switch on/off PayPal test mode.

Take a few moments to setup your theme settings and click through the different tabs. Every setting in this dashboard is explained to you on the right of the screen.

### D) Adding Theme Widgets - top

If your footer and sidebar content look plain after theme installation that is normal. The theme sidebar and footer are widgetized areas, there are custom widgets which are coded especially for this theme and are ready for use with many options to configure.

Please follow the screenshots below to add your theme widgets on startup. The following screenshots tell you (for example) which widgets are placed in sidebar and footer. (Widgets will be loaded with default settings unless you edit them)

Footer Widgets Sample

Sidebar Widgets Sample

### E) Adding Theme Menus - top

This theme supports two custom menus, a main menu for header, and another menu for the footer. The following simple instructions help you create and make use of your custom menus.

1. Open your WordPress dashboard and go to Appearance > Menus
2. Add new menu name e.g. Header Menu
3. Assign theme location on left to Header Menu for your header menu
4. Add links and pages to the custom menu and save your work
5. Do the same for setting up your footer menu

### F) Adding a Sample Product - top

These instructions help you add a sample product to show you how to add products easily to your store. See the screenshot after text instructions for more visual help.

To add a new product, login to your dashboard and click on Add New under Products main menu.

1. Title: Add your product title in the title field (e.g. My First Product)
2. Content: Add your product description in the content area (e.g. This is the latest jacket from Armani collection.)
3. Sale Price: Enter your product active price in that field. This is the sale price meaning users will see that price while buying or browsing this item. Please do not put any currency signs or symbols in that field. (e.g. 99.45, 67.00, 25 are valid prices)
4. Regular Price: Enter the price of product before any active discount. Regular price of a product does not affect the sale price, it only shows that your product has a discount.
5. Stock Condition: By default, new products are marked as In Stock. However you might want to mark a specific product as New Stock, On Sale, etc. You can select a stock condition from that list for your product.
6. Image Size: The image size for your product as it appears in main catalog. You might want to choose a different size depending on your product type. (e.g. Small image size for presenting a Shoe)
7. Image Crop: By default, all product images are cropped towards center. You can choose if you want to crop this specific product from top, bottom or center.
8. Image Hover: Add at least 2 attached images to your product to be able to select a hover image. Hover image effect is perfect for showing product from the front and back for example.
9. Product SKU: Ths is your product reference in inventory. (Example: 21324626463UC)
10. Stock Quantity: If this product has a limited quantity in inventory, please add that quantity here. If you leave this field blank, it assumes that your product has unlimited quantity by default. (e.g. 2500)
11. Categories: Add or edit product category from that field. For example, If you're adding a Shoe add the category Shoes for this product. You can also add sub-categories, for example you can place your product under Shoes, and under For Men.
12. Brands: You may enter the brand of this product here. For example: Adidas or Nike or any other brand.
13. Colors: Enter the available colors from this product here. For example: Blue, Black, White, etc.
14. Sizes: Enter the available sizes from this product here. For example: 2, 4, 6, 8, 10, etc.
15. Set Featured Image: Use the image upload screen here to attach your product pictures. Please upload your product images and various looks only from that screen. After uploading all images for this product, please make sure you set product featured image to be your primary or main image for the selected product.

The next screenshots show you the correct setup of adding a new product.

### G) How to Add/Edit Slides - top

The theme's slideshow is very easy to customise via custom post type which is like writing a standard blog post. Every slide consists of a large slideshow image, a title, a description, and a button.

The following screenshots will guide you through adding a sample slide in your slideshow. To add a new Slide, login to your WordPress dahboard and click on Add New under Slides main menu. (See attached images)

Click on Publish and your newly created slide will automatically appear at the beginning of your slideshow.

### H) How to Manage Received Orders - top

When someone places an order, you'll get notified by e-mail about that order. Additionally, the order is added automatically to your orders dashboard where you can view and modify all orders. The Orders dashboard looks like this:

The orders screen shows you order number, order date, order summary, billing and shipping addresses, payment status, order status, selected shipping method, tracking number.

You can easily modify an order by clicking on Modify Order link below the order ID. Click on that link to modify order status, send customer an email about his order, add shipping details, cancel order, etc.

You do not need to do anything about Unpaid orders. When customer pays for an order, the order payment status is updated automatically and order status is updated to Pending. Pending orders are awaiting your action. (e.g. process and ship the items, double check payment, any other action you take)

### I) How Email Notifications Work - top

This theme sends out emails automatically when needed. You do not need to do anything extra to initiate sending emails such as order notifications. Read the below list to know about events which fire sending emails automatically.

Please make sure that your admin e-mail is valid and accessible by you at all times. Your admin e-mail address is used to send you order notifications, reports, etc. To check or setup your WordPress admin email, please login to your WordPress dashboard, click on Settings > General and configure the E-mail Address field (put your primary e-mail address)

- When customer places a new order, invoices are emailed to customer and admin.
- When customer completes payment for an order, an order update is emailed to customer.
- When admin changes the status of an order, an order update is emailed to customer.
- When admin fills the Order Comments field in Modify Order screen, order comments are emailed to customer.
- When admin fills Tracking Number for an order, shipment tracking is emailed to customer.

TIP: You can edit and customise any of the email templates used by logging to your dashboard, click on ocCommerce > Email Templates tab and start editing your email templates. Email templates use simple short tags to easily customise your email without coding knowledge.

Examples of short tags usage:

To print cart items including quantity, price automatically in your template use:

    {cart_items}

To include customer name in your template use:

    {customer_name}

A list of available short tags you can use is already written for you on the screen.

### J) Installing Demo Content - top

Get started quickly by importing theme's demo content file into your WordPress installation. The demo file includes sample data as seen in official theme demo. To import demo content file please follow these easy instructions:

1. Login to your WordPress dashboard
2. Go to Tools > Import > WordPress
3. Click on Browse and select theme demo file to import. (You can find the demo content XML file in the package you downloaded in that folder: /Demo/demo.xml)

That's it! You are good to go now.

Once again, thank you so much for purchasing this theme. As I said at the beginning, I will be happy to help you if you have any questions relating to this theme. I'll always do my best to assist. If you have a more general question relating to the themes on ThemeForest, you might consider visiting the forums and asking your question in the "Item Discussion" section.

ThemeFluent

Go To Table of Contents