1. Start
  2. Installation
  3. Upgrade
  4. Page setup
  5. e-Commerce
  6. Theme Options
  7. Sliders
  8. Custom slyles
  9. How to...
  10. Sources and Credits
  11. Changelog
  12. Theme Support

Shoppica WP – Premium Wordpress Theme

Compatible with: WooCommerce 1.6.x/2.x, WP E-commerce 3.8.8.x / 3.8.9.x


Thank you for purchasing our theme. If you have any questions that are beyond the scope of this help file, please visit the Shoppica Wordpress theme support forums.

Installation


Before installing the Shoppica WP ecommerce theme, it is assumed that you have a working Wordpress installation.


1Upload to your sever

Extract the .ZIP archive from themeforest to a local folder on your PC. It should contain a subfolder named shoppica-package, which should contain the following folder structure:

The most important file there is shoppica.zip. You can install Shoppica like any other Wordpress theme by uploading it via FTP, or by using the Wordpress theme upload menu. Choose your prefered upload method below:

Upload Using FTP Client
Or Upload Using Wordpress Admin

2Activate the theme

After uploading the theme to your server, you should activate it.

3Set Image Size

For WP e-Commerce:

For WooCommerce:

4Upload Wordpress Sample Data (optional)

In the archive that you download from Themeforest there is a folder named "Sample Data". There are three files there - Shoppica_Data.xml, WPEC_Products.xml, WooCommerce_Data.xml.

Here's how to import a sample data file:

The Shoppica_Data.xml file import some menus, pages, blog posts, portfolio and testimonial items. These items are extracted from the Shoppica demo site - shoppica-wordpress.com. You may want to assign menus from the imported data. Go to "Appereance -> Menus", select and save the 'Theme Location' options:

Important! The WooCommerce_Data.xml file contains WooCommerce records. If you don't have WooCommerce installed, you will recieve warnings while importing the data.

Important! The WPEC_Products.xml file contains WP e-Commerce records. If you don't have WP e-Commerce installed, you will recieve warnings while importing the data.

Upgrade


IT IS RECOMMEND TO ALWAYS BACKUP YOUR SYSTEM BEFORE MAKING ANY UPGRADES OR CHANGES!

Upgrade WordPress

You can read, how to upgrade your WordPress version, by going to Updating WordPress

Upgrade Shoppica

Download the latest version of Shoppica WP from your Themeforest account. Make sure it supports the WordPress version you are currently using.

To upgrade Shoppica, simply re-upload Shoppica files. You can refer back to step 1 from the installation guide.

General Hints

If you have done customizations to the theme and you don't want to re-upload and overwrite all of the files, you can take a look at the files changelog. You could copy only these files which have been changed since your last update. If you have hard times comparing and updating the changed files, check how you can easily compare two files.

Setting up pages and posts


In addition to the default wordpress post types, Shoppica WP adds two additional custom post types - Portfolio and Testimonials pages.

  1. General Page Setup
  2. Home Page
  3. Blog Page
  4. Portfolio
  5. Testimonials

General Page Setup

Shoppica adds some convenient features when creating pages in wordpress. One of them is the visual composer plugin, which is integrated into the theme (you don't have to buy/install it separately). It is used to generate shortcodes, so you don't have to type them manually. There is an extensive documentation and video tutorial on how to work with it. In addition to the default visual composer content blocks, we have added also the following ones:

Important! Always switch to visual composer when creating page content (even for simple text sentences). It adds special shortcodes, which improve the text formatting.

Under the content editor there is a "Page Options" panel, which allows you to assign a dynamic sidebar to your page and to adjust various other settings. It contains the following options:

Shoppica adds several predefined templates to the the "Page Attributes" box:


Home Page

We assume you have already created at least one wordpress page(e.g. named Home). In order to set your homepage, you should navigate to Settings -> Reading, then click on the "static page" radiobox and choose the page you have created from the "Front page" select box. Click Save.

Warning! Leave the "Posts page" select box to its default value to avoid problems with your blog template.


Blog Page

You can create a page to list your blog posts very easily. Just go to Page > Add new and select "Blog..." template from the "Page Attributes" box. There are three blog post layouts you can choose:

These templates define the image position for every post in the listing.

You do not need to enter any content on this page - it will just list your blog posts in chronological order.


Portfolio

To setup a page, where your portfolios will be displayed, you should create a page and choose a "Portfolio ..." template from the "Page Attributes" box. You can limit the displayed portfolio items to a single portfolio category from the "Portfolio Page Parent Category" setting in the "Page Options" box.

To add a new portfolio item, navigate to Portfolio > Add New. Here you can add a brief description of the project, assign various categories and upload images.

Portfolio is using Featured Image option, so make sure you always set one from the Featured Image box.

Portfolio Item Options:


Testimonials

To configure a page with testimonials listing, you should create a page and choose the "Testimonials" template from the "Page Attributes" box.

To add a new testimonials item, navigate to Testimonials > Add New. Here you can add a brief description of the project, assign various categories and upload images.

Testimonials is using Featured Image option, so make sure you always set one from the Featured Image box.

Testimonials Item Options:

e-Commerce


WooCommerce

Shoppica WP is fully compatible with WooCommerce 1.6.x. This is extremly popular wordpress e-commerce system, which is also free. It has detailed documentation. You can read how to install and configure it here.

WP e-Commerce

Shoppica WP is also compatible with WP e-Commerce 3.8.x. This is another free and popular wordpress cart. The WP e-Commerce plugin has extensive documentation. You can read here how to install and configure it.

Jigoshop

Jigoshop integration is in active development. It will be released soon.

Shoppica Theme options


Shoppica provides many configuration options, divided by sections - you can access them form a dedicated admin panel menu, called "Theme Options". In order to get the most from this theme, read carefully the descriptions and instructions below.

Important! Shoppica theme is two columns only (it does not support 3 columns layout).

  1. General
  2. Layout -> Common
  3. Layout -> Products
  4. Layout -> Sidebars
  5. Theme Colors
  6. Theme Fonts
  7. Design -> Common
  8. Design -> Background
  9. Design -> Payments
  10. Design -> Stylesheet
  11. Intro
  12. Store
  13. Widgets -> Facebook
  14. Widgets -> Contact Form
  15. Backup Options

General


Layout - Common


Layout - Products


Layout - Sidebars

This section allows you to create unlimited widgetized sidebars. Each Page / Post / Product / Portfolio / Testimonials can have a custom sidebar. Each sidebar is essentially a widget area. After you add a dynamic sidebar in the shoppica admin panel, you can fill if with widgets by navigating to Appearance -> Widgets.


Theme Colors

This section allows you to set custom colors to your website.

Alternatively you can go to Appearance -> Themes -> Customize to change and preview the theme colors live.


Theme Fonts

This section allows you to change theme fonts. You have more than 500 web optimized typefaces to choose from.

Warning! Using too many different typefaces may decrease your site performance!

Using many font styles and subsets can slow down your webpage, so only select the font styles that you actually need. Some fonts does not support different languages and styles. Be practical with your font choise.

Usefull links:
1. Google WebFonts - you can easily filter and preview and fonts for your shop here.
2. This article contains recommendations to some stylish fonts.
3. Another selection of good fonts.


Design - Common


Design - Background

This section allows you to upload custom website backgrounds.

You can set pattern over background color or custom image.

If you want to add new patterns, go to your ftp theme folder. Go to 'images/bg'. Upload as much patterns as you want, accepted image files are .png or .jpg. They will automatically appear in patterns.

Background Image Settings - (background position, background repeat and background attachment) this is used only when you upload custom Background Image.


Design - Payments

This section allows you to put logo (or other) images for the different payment methods. You could also specify a link for each image.

The most recommend size for each image is 51 x 32 pixels.


Design - Stylesheet

This section allows you to append custom styles to the main theme stylesheet without manually modifying any theme files.


Theme Intro

This section allows you to controll the top slideshow. You can have different intro for every page and category.

No intro

No intro is the first and default option for every newly created page or category. With this option selected, no slideshow is displayed when you browse a category. There are only the page/category name and a breadcrumbs navigation.

Product slideshow

The product slideshow option allows you to create a set of products and rotate them. Open the product listing dialog and choose the items for your slideshow.

Use the size option to control the product thumbnail dimentions.

Image slideshow

The Image slideshow options allows you to rotate static images. The maximum width of the images should be 920px

The additional options for the image slideshow are:

Layer Slider

Choose a slider created with Layer Slider. ( You must first create slider in LayerSlider WP ).

UnoSlider

Choose a slider created with Unoslider. ( You must first create slider in Unoslider ).


Store


Widgets - Facebook


Widgets - Contact Form

To use this contact form please register at http://www.google.com/recaptcha for captcha Public and Pricate Key.


Backup Options

This theme support Theme Options backup, you can Backup your Theme Options before do any changes and all can be restored.

Also you can Import / Export your Theme Options.

Sliders


Shoppica is shipped with two sliders integrated to the theme - Layer Slider and UnoSlider. There is one additional slider from visual composer - NivoSlider.

LayerSlider

LayerSlider is highly customazible parallax effect slider. You can create as many layers and sublayers as you want. You can use unlimited images with links. The script is very user-friendly, you can add global settings or local (per slide) settings to each layer or sublayer. You can change delay times, easing types, durations and much more. There is a dedicated LayerSlider menu in the admin panel. There is also a LayerSlider content type in the visual composer - you can use it to insert your predefined sliders into the pages you create. Another option is to choose LayderSlider as Intro type for a Category/Page/Post in theme options.

Go to LayerSlider documentation to learn how to create slides with it.

Important!
If you use LayerSlider thumbnail navigation, you should set your thumbnail width and height to 65 x 40 px.


UnoSlider

UnoSlider is an advanced image and content slider which is built with responsive design and mobile devices in mind. There is a dedicated UnoSlider menu in the admin panel. There is also a UnoSlider content type in the visual composer - you can use it to insert your predefined sliders into the pages you create. Another option is to choose UnoSlider as Intro type for a Category/Page/Post in theme options.

Go to UnoSldier documentation to find out more about it.


NivoSlider

This slider can be used only inside Visual Composer when adding a new page. There is a special content type for it - "Image Gallery". Click on it to enter the interface for slide creation.


Product Slideshow

This slideshow can be configured as "Intro Type" from theme options only. A nice way to show your specials or bestsellers. You only need to select, which products you want in the slideshow.


Simple Image Slideshow

This slideshow can be configured as "Intro Type" only from theme options only. It is very light and simplified images slider with several configuration options.

Custom styles


Vertical Tabs

  1. Add a "Tabs" content block
  2. Use the s_vtabs class in the "Extra Class Name" field
  3. Save

Custom Bulleted Lists

  1. Create an unordered list in the WYSIWYG editor
  2. Click on ul from the Path section at the bottom of the editor
  3. Select List Style 1 or List Style 2 from the Styles dropdown
  4. Save

How to...


Localize Shoppica

This theme uses .po and .mo files for translation. If you want to translate the theme to your language do following:

1Download PoEdit http://www.poedit.net/

2Use PoEdit to translate .po file located in theme folder 'languages'

3Generate .po and .mo file with PoEdit and save them as 'de_DE', 'nl_NL', etc.

4Upload your new files to 'languages' folder.

5Go to your wordpress root folder and open wp-config.php file.

6Find line define('WPLANG', ''); and change it to ('WPLANG', 'de_DE'); which is german translation for example. Save.

The WP E-commerce plugin is translated likewise - http://getshopped.org/news/translating-wp-e-commerce-is-now-easy
If you want to read more about Wordpress Translation go to http://codex.wordpress.org/WordPress_in_Your_Language


Compare two versions of the same file

Consider the following situation: you have modified a Shoppica template file to suit your needs and you find in the latest changelog that this file has been modified. It is unpleasant surprise because now you have to wonder, what tiny things we have changed to fix a bug or to add a feature. Luckily, there are free tools, which can assist you greatly. Such a tool is winmerge.

Just install it, and select the two files you want to compare:

After you click 'Ok' the program will compare the files line by line and will show you the difference in a very convenient way:

Now you can easily see we have added only two lines to the file and you can add them by hand.

Sources and Credits


We have used the following images, icons or other files as listed.

Changelog


Version 1.3.0 - 3 July 2013
- added – WP e-Commerce 3.8.12 compatibility
- added – Child Theme Support
- added – Google Plus Widget
- added – Twitter Widget API 1.1
- fixed – Layerslider Loading Bug
- fixed – Portfolio Bug
- fixed – Related Products, Up Sells, Cross Sells
- fixed – WP e-Commerce clear cart
- fixed – a few minor php and css bugs

Version 1.2.2 - 25 March 2013
- added - Woocommerce 2.0.4 compatibility
- added - Latest/Popular posts components
- added - Latest testimonials component
- added - Latest portfolios component
- fixed - Visual Composer bugs
- fixed - a few css bugs

Version 1.2.0 - 7 March 2013
- added - Woocommerce 2.0 compatibility
- added - Product gallery only for WooCommerce
- added - WP E-commerce option to upload file with purchase
- added - Products sidebar to appear when there is no attached sidebar for product
- fixed - some language variables
- fixed - author box bug
- fixed - Layer Slider preload bug
- fixed - Woocommerce intro category and products page bug
- fixed - Woocommerce resgistration bug
- fixed - Visual Composer bug on small screens
- fixed - Visual Composer price size bug
- fixed - few css bugs

Version 1.1 – 31 January 2013
- added - Woocommerce compatibility
- added - option to search only in products (for Woocommerce only)
- added - related products slider with option to change number, size and price label
- added - option to hide Cart from menu
- updated - Visual Composer to 3.4.13; added compatibility with WPEC description
- updated - Layer Slider to 3.6.2
- fixed - product category breadcrumbs bug
- fixed - with adding new slides to UnoSLider
- fixed - register link with default permalinks
- fixed - mobile version error notices
- fixed - issue with hiding the intro
- fixed - some language variables

Version 1.0 – 15 December 2012 – Initial release

Theme Support


If you experience problems with the ThemeBurn products, you can post a topic in the appropriate category in our free support forum. This forum is only intended to offer support for setting up your themes/plugins and addressing any bugs you encounter with them. Be sure to read our support policy first.

We will try our best to answer any general questions you have within 2 business days, but during busy periods, or when solving serious issue, this may take longer. In the "How to" section, we have also prepared several step by step instructions that explain common modifications.

Bear in mind that we do not support Shoppica copies obtained from all sorts of warez, nulled scripts, free download, torrents and filesharing sites. Beside from not respecting our work, they often contain malicious modifications to the code which exposes your server and personal data to exploiters. The only legal and safe way to obtain Shoppica is by purchasing it from Themeforest.