BuyShop Documentation by 20script

### “BuyShop” WordPress WooCommerce Theme Documentation by “eTheme” v1.0

# “BuyShop”

Created: 31/03/2014
By: eTheme
Email: etheme2@gmail.com

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

## Table of Contents

1. Package structure
2. Installation
3. Theme Customize
4. Import Sample Data
5. Extensions Configuration
   - Twitter Feed Plugin
   - Facebook Block Plugin
   - Widgets Area (Sidebars)
6. Attaching Video to Products
7. Theme Options
8. Theme Translation
9. Multilingual setup (WPML plugins)
10. Sources and Credits

### 1) Package structure - top

- Buyshop - theme files.
- Sample Data - Sample data for pages, products, etc.
- Documentation - documentation files for current package.

### 2) Installation - top

Current documentation was created to help you with quick installation and configuration of BuyShop theme. Please, read it carefully to avoid most of potential problems with incorrect configuration.

Once you will have activated the theme you will need to change some of the pages and settings for optimal performance. That's why, please, do not contact Support beforehand. Read firstly the documentation, implement all the steps following the instructions and only after that, if the issues persist, contact us.

Before installing BuyShop theme, it is assumed that you have a working WordPress already installed. You should also install WooCommerce plugin for the correct work of our theme. The link for the plugin is provided below.

- Step 1
  Install WordPress. For detailed Wordpress installation instructions visit http://codex.wordpress.org/Installing_WordPress
- Step 2
  Install WooCommerce plugin. For detailed WooCommerce installation instructions or for more information visit http://www.woothemes.com/woocommerce/
- Step 3
  After activation WooCommerce plugin will ask if you want to install it's pages. Do it.
- Step 4
  Copy "Buyshop" folder from package to your_site_folder/wp-content/themes and activate it at Appearance -> Themes page.
  After activation system will ask you to activate required plugins. Click "Begin installing plugins"
  Check top checkbox to select all plugins, switch "Install" option from selectbox and click "Apply". That's may take a while. Sometimes it's needed to increase max_execution_time directive in php.ini on your server.

### 3) Theme Customize - top

Basically theme is installed and is ready to work. Now you may want to add new products, create pages, categories, navigation menu, etc.

- Visual Composer
  We use Visual Composer plugin built-in with our theme. It is a page builder that greatly helps you to construct new pages and edit existing. General information about this plugin can be found on the developers site.
  To create page go to Pages -> Add New and make sure that Visual Composer is enabled.
  You can now add row, choose desired layout and begin to add elements to the page.
  Don't forget to click "Publish" button when you finish.
- Creating menu
  Go to Admin -> Appearance -> Menus page and add new menu.
  It is possible to create columns, to add images or you can just use standard dropbox. To get access to this features you need to show CSS classes and Description (check options in Screen options).
  To create column add item to menu (usually Link item type), open item properties and type "col" in CSS classes field. For best view also add "widemenu" class to parent item of your columns.
  To add image do as described about columns, but CSS class must be "image-item". Also you need to type path to image in Description field.
  Shortcode [template_url] will be replaced by system with URL "~your_site_url~/wp-content/themes/buyshop". If you want to set URL for image that is not in the Buyshop folder just type it here without [template_url] shortcode.
  On the tab "Manage locations" you can use different menus for your site: Main menu - menu that will be used on desktops, Mobile Menu - menu for mobile platforms and Account menu - menu for authorized customers. You can
  By default our theme uses classic narrow dropdown box for child items. If you want wide dropdown list with columns, add "widemenu" to your CSS class field.
- Account menu in WooCommerce 2.1+
  In WooCommerce version starting from 2.1.0 developers replaced some shortcodes with endpoints. So old Account pages and Account menu is no longer work.
  If you want to create "My Account" menu with such links like "Change password", "View Order", "Edit account", etc. you should create links with URL to corresponding endpoint.
  More detailed instruction about how to do it you can find here.

We recommend you to import our Sample data to have good example of the way how things are configured by us.

### 4) Import Sample Data - top

After successful installation you may want to import our sample pages, posts, menus, sidebars settings, main slider sample, etc.

- Step 1
  Go to Tools -> Import.
  And click WordPress
  Browse to file Sample Data/main_data.xml and click "Upload file and Import" button.
  Select "Admin" from selectbox, check "Download and import file attachments" option and click "Submit" button.
  That's may be quite long because system will download files from our host.
- Step 2
  Now go to Tools -> Widget Settings Import, select file Sample Data/widget_data.json and click "Show Widget Settings".
  Select all options and begin import
  This must import sidebars settings (widgets area), but sometimes it can import not all settings. So it's possible that you'll need to setup widgets area manually. Instructions about how to do this can be found in this documentation.
- Step 3
  To import Revolution Slider sample go to Revolution Slider settings and click "Import" button.
  Browse to Sample Data/revslider_sample.zip file and click "Import Slider".

After import is finished go to Appearance -> Customize -> Navigation and set Main menu and Account menu as shown on screenshot
Now open "Static Front Page" and select Home page for Front page and Blog for Posts page.
Click "Save & Publish".

### 4) Extensions Configuration - top

Here you will find instructions about how to set up some plugins manually.

WFT Twitter Feed

Twitter feed widget for your site.

- To create new Widget follow this link and than copy widget code into "Widget Embed Code" field at the Options tab.
- Screen Name - enter different twitter user name to show his tweets. Please note that you still need base "Widget embed code" to be set.
- Height - Adjust block height.
- Show Header - Show header information in block.
- Show Replies - Show replies form.
- Show Borders - Show block borders.
- Show Footer - Show footer information.
- Show Scrollbar - Show scrollbar at the right border of the block.
- Link color - Links color in messages.

WFT Facebook Likebox

Facebook likebox widget.

- Facebook Page URL - followers of this page will be shown in the likebox. Please note that this is not Facebook users page.
- Height - block height.
- Width - block width.
- Show Facebook Avatars - show or not avatars of followers.
- Show Facebook Block Header - show header information.
- Show Facebook Stream - show stream feed.
- Show Block Border - show block border.
- Like Box Theme - Choose between the default light theme or the dark theme.

### 5) Theme Options - top

Our theme uses Options Tree plugin to extend theme settings. To view/edit them follow Appearance -> Theme Options. Here you can customize colors, fonts, choose another header layout, display labels on product or not, turn on/off some scripts like "isotope" animation, etc.

Besides this you can export/import your settings. To proceed to Export/Import of Theme options go to Appearance -> Theme Options -> Import/Export and follow instructions.

If you need to reset some field it's usually enough to just clear value of that option and save.

### 6) Attaching Video to Products - top

You can attach YouTube video to your product. To do this go to Product edit page, scroll down to "Add New Custom Field" and click "Enter new"
Enter name "video" and value is your Video ID on YouTube service. You can see it in video URL on YouTube site
Now it's available on product details page

### 7) Theme Translation - top

To transalte your theme open file /wp-content/themes/buyshop/languages/default.po with POEdit program. Use the translation field to make replacements. More instructions about how to do this you can find here From the file menu, save file with your language name e.g en_GB.po. It will generate both a .po and .mo file for your translation. Place these files into languages folder /wp-content/themes/buyshop/languages. Next edit wp-config.php located in the root folder of Wordpress and define the WPLANG prefix with your language name which should be similar to the translation file name.
If you want to create multilingual site you have to install WPML plugins package.

### 8) Multilingual setup (WPML plugins) - top

Our theme is fully compatible with WPML plugins.

WPML stands for The WordPress Multilingual Plugin - it's actually few plugins that are used to translate your content in different languages.
These plugins are not included in BuyShop theme and you have to buy them separately.
Plugins that you need:

- sitepress-multilingual-cms
- woocommerce-multilingual
- wpml-media
- wpml-string-translation
- wpml-translation-management

After you purchased plugins and activated them WPML menu will appear on the left sidebar of your Admin panel:
You can add new languages at menu WPML -> Languages. Also you can setup Language switcher there, but we recommend you to use WFT Language Switcher instead. You may find it at Appearance -> Widgets.
You can translate theme texts at WPML -> Theme and plugin localization. Before you go there you need to generate .po and .mo file as described above in part 7 - Theme Translation. After you generated .po and .mo files and put them into folder /wp-content/themes/buyshop/languages/ do these steps:

- go to WPML -> Theme and plugin localization
- Chose "Translate using .mo files."
- Check "Automatically load the theme's .mo file using 'load_theme_textdomain'."
- Enter textdomain value: "buyshop"
- Click Save

### 9) Sources and Credits - top

This theme uses following plugins.

1. Revolution Slider - Slider Revolution is the highly acclaimed slide-based displaying solution, thousands of businesses, theme developers and everyday people use and love!
2. WPBakery Visual Composer - Drag and Drop Frontend and Backend Page Builder Plugin for WordPress
3. YITH WooCommerce Wishlist - adds a Wishlist feature to your website.
4. Newsletter - adds newsletter subscription feature to your site
5. Sitemap - [pagelist], [subpages], [siblings] and [pagelist_ext] shortcodes. Plugin for building sitemaps and page lists.
6. Widget Data - Setting Import/Export Plugin - Adds functionality to export and import widget data
7. WordPress Social Login - Allow your visitors to comment and login with social networks such as Twitter, Facebook, Google, Yahoo and more.
8. WPML full package - adds multilingual functionality to your site. NOT INCLUDED!

Once again, thank you so much for purchasing this theme. As I said at the beginning, I'd be glad to help you if you have any questions relating to this theme. No guarantees, but I'll 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.

eTheme