1GETTING STARTED
1.1 Introduction
First of all, I would like to thank you for purchasing this theme. We’ve put in lots of love in developing this wordpress theme and are excited that you’ve chosen this theme for your website. We hope you find it easy to use our theme. This documentation guides you through the main features of the theme and guides you how to use and customize the theme.
1.2 System Requirements
At the basic level, this theme will require the following conditions:
- Apache 2.x or Microsoft IIS 7
- PHP 5.3.x
- MySQL 5.0.4 or higher
- WordPress 3.9+, 4.0+
Recommended PHP Configuration Limits: Many issues you may run into such as; white screen, demo content fails when importing, empty page content and other similar issues are all related to low PHP configuration limits. The solution is to increase the PHP limits. You can contact with your web host and ask them to increase those limits to a minimum or You can do this on your own by finding php.ini file in your root directory as follows:
- max_execution_time 180
- memory_limit 128M
- post_max_size 32M
- upload_max_filesize 32M
1.3 Key Features
- Compatible with IE9+, Firefox 4+, Netscape, Safari, Opera 9.5 and Chrome
- Responsive layout for all devices
- WooCommerce included
- Advanced widget options
- Unlimited colors and over 500 Google web fonts
- Allow to set site title, tagline, logo and Analytics ID
- WPML Compatible & RTL Ready
- Support menu with Mega and dropdown style
- Support primary menu location, widget sidebars
- 5 Preset Color Styles: Default, blue, Emerald, Green, Tangerine.
- Fully integrated with Font Awesome Icon
- Support to add custom CSS/JS
- Social Networks integration
- CSS3 table-less design
- LESS for advanced development
- Custom style for plugin Contact Form 7 and SEO Plugins to allow higher ranks.
1.4 WordPress Information
To install this theme you must have a working version of WordPress already installed. If you need help installing WordPress, follow follow the instructions in WordPress Codex or you can watch the Instructional Video created by Woo Themes. Below are all the useful links for WordPress information.
- WordPress Codex – General info about WordPress and how to install on your server.
- Instructional Video – Awesome How-To video created by Woo Themes.
- First Steps With WordPress – General info about multiple topics about WordPress.
- FAQ New To WordPress – The most popular FAQ’s regarding WordPress.
- WordPress 101 Tutorial videos – Some great videos from WordPress 101 Tutorial Series.
2INSTALLATION
2.1 Files Structure
At first, you need to download the package about my computer and then unzip the package. The Main Files Gives You All The Content Listed Below
- Theme folder – Contains the sw_maxshop_theme_version1.0.0.zip file and sw_maxshop-child-theme.zip WordPress Theme. The child theme is only for users who make code changes.
- Data folder - Contains the sample_data.xml file and widget.wie file.
2.2 Theme Installation
You can install the theme in two ways: through WordPress, or via FTP.
Note: If the theme file size is larger than 8M, please upload to FTP (File Transfer Protocol).
2.2.1 Theme Via FTP Installation
- Extract themename_version.zip.
- Load your FTP client, such as FileZilla.
- Upload the themename_version folder to the /wp-content/themes directory.
- In the left menu sidebar, go to Appearance >> Themes.
- Click Activate underneath the theme’s named section.
2.2.2 Theme Via WordPress Admin Panel Installation
Step 1 – Open the wp-admin panel (navigate through web browser to the folder where you have installed the WordPress e.g (www.your_domain.com/wp-admin/).
Step 2 – Login to your WordPress Dashboard and navigate to Appearance >> Themes. At the top of the page click the Add New button.
Step 3 – Click the Upload Theme button >> Choose File in Import from your computer section. Navigate to previously zipped theme package and open theme installator folder: Select your “sw_maxshop_theme.zip” file and click Install Now.
Step 4 – The uploading process will be started. You will see the message that Theme installed successfully.
Step 5 – After the installation you will be able to activate the theme to do this click the “blue” activation link.
Once theme is installed, you need to install Required Plugins to get full features working.
2.3 Required Plugins Installation
After installing and activating the theme you will see a yellow popup at the top of the page. Saying: “This theme requires the following plugins…” please click the ‘Begin Installing plugins’ link.
You will be redirected to ‘Install Required Plugins’ page, here you will find all of the theme required plugins. To install them just check all of them and from the drop down select install once installed do the same to activate them.
2.4 Sample Data Installation
Step 1 - In the Administrator page, please navigate to Tools >> Import.
Step 2 - Please choose “WordPress” to import.
Step 3 - In Import WordPress page, click “choose file” button to select file “sample_data.xml” to upload.
2.5 Change Product Image Sizes
You can change the image size in “Woocommerce > Settings > Products > Display” section.
After change the images sizes, you should regenerate all the thumbnails. For this, you should install and activate “Regenerate Thumbnails” plugin.
2.6 Widget Installation
Step 1 – In the Administrator page, please navigate to Tools >> Widget Importer & Exporter.
Step 2 – After that choose “widget_data.wie” file >> press Import Widgets button.
3THEME OPTIONS
In your Admin Panel, navigate to Appearance >> Theme Options
3.1 General
- Color Scheme - Select one of 5 predefined schemes: Default, Green, Blue, Orange, Cyan.
- Background Image - Browse to select image file that you want for background image.
- Background Repeat - This option determines if the background image is repeated (Used for boxed layout).
- Favicon Icon - Use the Upload button to upload the new favicon and get URL of the favicon.
- Responsive Support - Support reponsive layout, if you do not want to use this function, please uncheck.
- Logo Image - Use the Upload button to upload the new logo and get URL of the logo.
3.2 Layout
- Box Layout - Select Layout Box or Wide.
- Background Box Image - Browse to select image that you want.
- Left Sidebar Expand - Select width of left sidebar.
- Right Sidebar Expand – Select width of right sidebar medium desktop.
- Left Sidebar Medium Desktop Expand - Select width of left sidebar medium desktop.
- Right Sidebar Medium Desktop Expand - Select width of right sidebar.
- Left Sidebar Tablet Expand - Select width of left sidebar tablet.
- Right Sidebar Tablet Expand - Select width of right sidebar tablet.
- Layout product - Select style layout blog.
- Blog column - Select style number column blog.
3.3 Header
- Header Style - Have 5 Header Style for your selection.
- Phone number - Fill here your phone number to be displayed in header.
- Search form - Hide or show search form
- Menu Type – Select “Mega Menu” or “Dropdown Menu” type.
3.5 Typography
- Use Google Webfont – Insert font style that you actually need on your webpage.
- Webfont Weight – For weight, see Google Fonts to custom for each font style.
- Webfont Assign to – Select the place will apply the font style headers, every where or custom.
- Webfont Custom Selector – Insert the places will be custom here, after selected custom Webfont assign.
3.7 Advanced
- Show cPanel – Turn on/off Cpanel.
- Widget Advanced – Turn on/off Widget Advanced.
- Developer Mode – Turn on/off preset.
- Webfont Custom Selector – Insert the places will be custom here, after selected custom Webfont assign.
- Back to top – Turn on/off Back to top.
- Direction – Left To Right / Right To Left.
- Active Effect Scroll – Check to active effect scroll in homepage.
- Google Analytics ID – Enter Google Analytics code.
- Custom CSS/JS – Insert your own CSS into this block. This overrides all default styles located throughout the theme.
4PAGES
Pages are the backbone of your website, and most likely you will setup several of them. Pages are a blank canvas that allow you to add content with our shortcode elements. There are different page templates to choose from, each serving a purpose to help you build a finished site.
The following sections will cover these different topics that are listed below.
4.1 Plugin Visual Composer
SW Maxshop uses the Plugin Visual Composer. This gives the user the possibility to create all the page and post using only the Visual Composer, no code needed. We developed some shortcode as the image below or you can navigate to “Content” tab to add element that you want.
4.2 How To Use Page Builder
4.2.1 Activate Page builder
Step 1 - Log in to your WordPress Administration Panel.
Step 2 - Click on Pages >> Add New.
Step 3 - Click on Backend Editor.
4.2.2 Add shortcodes
For example: YTC_Gallery at Home page
Note: You can edit/delete/clone shortcodes both backend and frontend
Step 1 - Go to your page / post, first activate the backend editor and click Add Element.
Step 2 - Select the YTC_Gallery shortcodes
Step 3 - Click on the Edit This Row (pencil icon) to Edit this shortcode ( in our example we used the YTC_Gallery shortcode at backend)
Step 4 - You can change images, gallery size… as you want and Save Changes
4.2.3 Duplicate shortcodes
Pages Icon - To Duplicate Row or Module you need to click the Pages icon.
4.2.4 Remove shortcodes
Trash Box Icon - To Remove Row, Column or Module you need to click the Trash Box icon.
4.3 How To Set your Homepage
Step 1 - Go to Settings > Reading in your WordPress Dasrdoard panel.
Step 2 - Set “Front page displays” to a “Static Page”.
Step 3 - In the drop down menu for “Front Page” choose a page which will be your home page.
Step 4 - Leave the drop down menu for “Posts page” empty, as this is not used by the theme.
Step 5 - Save changes.
5MENU SETUP
You must define a menu before you can add items to it.
1. Login to the WordPress Dashboard.
2. From the ‘Appearance’ menu on the left-hand side of the Dashboard, select the ‘Menus’ option to bring up the Menu Editor.
3. Select Create a new menu at the top of the page
4. Enter a name for your new menu in the Menu Name box or select a menu.
5.2 Add Items to a Menu
The Screen Options allow you to choose which items you can use to add to a menu. Click on the Screen Options tab to expand the options available for a particular Screen, check (or unchecked) the desired options, then click the Screen Options hanging tab to collapse the Screen Options.
1. For example, Locate the pane entitled Pages.
2. Within this pane, select the View All link to bring up a list of all the currently published Pages on your site.
3. Select the Pages that you want to add by clicking the checkbox next to each Page’s title.
4. Click the Add to Menu button located at the bottom of this pane to add your selection(s) to the menu that you created in the previous step.
5. Click the Save Menu button once you’ve added all the menu items you want. Your custom menu has now been saved.
For more info about the menu creation please go to http://en.support.wordpress.com/menus
5.3 Custom Menu Items
The Navigation Label This field specifies the title of the item on your custom menu. This is what your visitors will see when they visit your site/blog. The Title Attribute This field specifies the Alternative (‘Alt’) text for the menu item. This text will be displayed when a user’s mouse hovers over a menu item.
1. Click on the arrow in the top right-hand corner of the menu item to expand it.
2. Enter the values for the Navigation Label and Title Attribute that you want to assign to the item.
3. Click the Save Menu button to save your changes.
Click on “Show/Hide Advanced Menu Config” button to configure Mega Menu
It will show as the image below:
1. Advanced Mega menu – With Level 1:
- Active mega menu: Allow to activate/inactivate Mega Menu
- Icon: Using icon-* class to display Icon for any menu item with Font Awesome intergrated. Refercence Font Awesome for details
- Dropdown Size: Set the width of dropdown menu. (ex: min = 1 (= 150px); max = 6 (= 900px)).
- Dropdown Align
- Only for menu items level 1 – If you want dropdown (if have) align by right direction, config it to ‘Right’ instead of ‘Left’ or ‘Default’ – ‘Default’: no class be add to dropdown, everything are nature by default css. – ‘Left’ / ‘Right’: add to dropdown an utility class for float it left/ right. Make it align as you want.
- Show Description as Subtitle
- Mean as the name. – Description is core attribute of menu item. You may need check to show it in the metabox screen.
- Hide Title
- Sometime you need hide the title of menu, select ‘Yes’ value please. In this case, Icon or Subtitle or Advanced Content are need to show as replacer.
- Disable Link: Allow to disable link.
- Advanced:
- Some advanced functions are placed here. – ‘Default’: NOOP, do nothing. Sure, it is not advanced – ‘Use as Divider’: Show any icon, title, subtitle, content. Divider style only. – ‘Append Advanced Content’: Append content after menu title block (icon+title+subtitle) – ‘Append Advanced Content with Shortcode’: as above, but ‘do_shortcode’ with this before append.
- Advanced content: Insert content follow Advanced ( input HTML, image… not included js & css)
- Menu Thumbnail: Allow to upload thumbnail for menu
2. Advanced Mega menu – With Level 2:
- Dropdown sub size: Set the width of dropdown submenu. (ex: default/ min = 1 (= 150px)/ max = 6 (= 900px)).
6WOOCOMMERCE
SW Market Theme is fully compatible with WooCommerce plugin. WooCommerce is external plugin and all info about this awesome plugin you can find plugin’s author page. Below you have all friendly links that will be useful:
6.1 How to install WooCommerce
At first please go to Plugins > Add new section and type “WooCommerce” into search field. Then press “enter”".
After that you will results and what you need to do is click on “Install now” button next to “WooCommerce – excelling eCommerce” plugin.
After that plugin will be installed and please click “Activate plugin” link.
6.2 How to add new product
Go to Products >> Add product section. After that you will see page wich looks like below and all you need to do is fill those fields with own values.
All info about adding new product you can read on http://docs.woothemes.com/document/managing-products/
6.3 Registration Options
You need to show registration form on My Account page, you should check “Enable registration on the “My Account” page” in “Woocommerce > Settings > Products > Accounts” section.
7POST
7.1 Creating/Editing Posts
Step 1 - Navigate to Posts in your WordPress admin sidebar.
Step 2 - Click on the Add New option to make a new post. Create a title, and insert your post content in the editing field. You can use visual composer or Ya shortcodes elements inside the post.
Step 3 - Select Post Format from the right side.
Step 4 - Add Categories from the right side. To assign it to the post, check the box next to the Category name.
Step 5 - Add Tags from the right side. Type the name of the tag in the field, separate multiple tags with commas.
Step 6 - For a single image, click the first Featured Image Box, select an image and click the Set Featured Image button.
Step 7 - Once you are finished, click Publish or Update to save the post.
Here Is A Screenshot That Shows The Various Areas Of The Post Page Described Above.
8WIDGETS
8.1 To Add Widgets, Follow The Steps Below.
Step 1 - Navigate to Appearance > Widgets to access the list of widgets and widget sections that they can be added to. The left hand side shows all the widgets you can use. The right hand side shows all the different sections you can add widgets to.
Step 2 - Simply drag and drop the widget you want into the widget section you want on the right hand side.
Step 3 - When finished, make sure to click Save in the widget editing box to save the widgets added to your sidebar.
Here Is A Screenshot That Shows The Various Areas Of The Widget Section Described Above.
Below is the description of widgets parameter:
- Title – Input Title of widget
- Select Menu – Allow to select menu
- Advanced Options – Support 3 options for your advance
- Widget Style – Style of widget ( container is selection )
- Widget Display – Option select widget display. There are 3 option:
- All - Widget will display all in theme in the sidebar that’s selected.
- Except on selected – Allow to choose pages that don’t want to show widget
- Only on selected – Allow to choose pages that want to show widget
- Users – Allow to be shown for user pages (login/ not login)
- General – Check into the checkbox that you want to show the sidebar( blog, archive…)
- Taxonomy Slugs – Input Taxonomy Slugs of pages that you want to display widget, if have many taxonomies then separate them by “,” mark.
- Posts type – Input Posts type of pages that you want to display widget, if have many posts type then separate them by “,” mark.
- Categories ID & Posts ID – ID of Categories or Posts, if have many IDs then separate them by “,” mark.
- Menu – Allow to choose menu that you want to display widget.
- Advanced Options – Support 3 options for your advance
The Frontend Appearance of Footer:
8.2.1 Position Above Footer
1. Text Widget
- Please go in “Appearance > Widgets” on admin sidebar.
- You should add “Text” widget in the sidebar.
- You should configure the fields and save.
Frontend Appearance
Backend Settings
Copy & Paste the code into text editor:
[row] <div class="col-lg-3 col-md-3"> <div class="socials-wrap"> <ul> <li><a href="http://www.facebook.com/SmartAddons.page"><span class="icon-facebook"></span></a></li> <li><a href="https://twitter.com/smartaddons"><span class="icon-twitter"></span></a></li> <li><a class="icon-google-plus show_google" title="Google+" href="https://plus.google.com/u/0/+Smartaddons/posts" target="_blank" data-icon="g"></a></li> <li><a class="icon-pinterest show_pinterest" title="Pinterest" href="#" target="_blank" data-icon="&"></a></li> <li><a class="icon-linkedin show_linkedin" title="Linkedin" href="#" target="_blank" data-icon="i"></a></li> </ul> </div> </div> <div class="col-lg-9 col-md-9"> <div class="block-subscribe-footer"> <div class="title-block"> <h2>SIGN UP FOR OUR NEWSLETTER </h2> <p>Duis at ante non massa consectetur iaculis id non tellus</p> </div> <div class="block-content"> [contact-form-7 id="497" title="newsletter"] </div> </div> </div> [/row]
8.2.2 Position Footer
1. Text Widget
- Please go in “Appearance > Widgets” on admin sidebar.
- You should add “Text” widget in the sidebar.
- You should configure the fields and save.
Frontend Appearance
Backend Settings
Copy & Paste the code into text editor:
<div class="content-block-footer"> <h2 class="footer-logo"><img alt="Madison Island" src="[bloginfo show="wpurl" filter="raw"]/wp-content/themes/sw_maxshop/assets/img/[colorset]/logo-footer.png"><span style="display:none;">Madison Island</span></h2> <p>Lorem Ipsum is simply dummy text of the printing and typesetting industry. Lorem Ipsum is simply dummy text of the printing and typesetting industry.</p> </div>
2. Custom Menu: MY ACCOUNT
- Please go in “Appearance > Widgets” on admin sidebar.
- You should add “Custom Menu” widget in the sidebar.
- You should configure the fields and save.
Frontend Appearance
Backend Settings
3. Custom Menu: INFORMATION
- Please go in “Appearance > Widgets” on admin sidebar.
- You should add “Custom Menu” widget in the sidebar.
- You should configure the fields and save.
Frontend Appearance
Backend Settings
4. Text: CONTACT US
- Please go in “Appearance > Widgets” on admin sidebar.
- You should add “Text” widget in the sidebar.
- You should configure the fields and save.
Frontend Appearance
Backend Settings
Copy & Paste the code into text editor:
<ul class="contact-us"> <li><span class="sp-ic icon-home" style="font-size: 16px; position: relative; top: 1px;"> </span>8901 Marmora Road, Glasgow, D04 89GR</li> <li style="margin-top: -4px;"><span class="sp-ic icon-mobile-phone" style="font-size: 22px; position: relative; top: 4px;"> </span>Telephone: <a title="Call:(801) 2345 - 6789" href="tel:+84123456789">(801) 2345 - 6789</a></li> <li><span class="sp-ic icon-envelope" style="font-size: 13px; position: relative;"> </span>E-mail: <a title="support@maxshop.com" href="mailto:name@email.com">support@maxshop.com</a></li> </ul> <ul class="payment-method"> <li><a title="Payment Method" href="#"><img src="http://dev.ytcvn.com/ytc_templates/wordpress/sw_maxshop/wp-content/uploads/2015/04/payment-1.png" alt="Payment"></a></li> <li><a title="Payment Method" href="#"><img src="http://dev.ytcvn.com/ytc_templates/wordpress/sw_maxshop/wp-content/uploads/2015/04/payment-2.png" alt="Payment"></a></li> <li><a title="Payment Method" href="#"><img src="http://dev.ytcvn.com/ytc_templates/wordpress/sw_maxshop/wp-content/uploads/2015/04/payment-3.png" alt="Payment"></a></li> <li><a title="Payment Method" href="#"><img src="http://dev.ytcvn.com/ytc_templates/wordpress/sw_maxshop/wp-content/uploads/2015/04/payment-4.png" alt="Payment"></a></li> <li><a title="Payment Method" href="#"><img src="http://dev.ytcvn.com/ytc_templates/wordpress/sw_maxshop/wp-content/uploads/2015/04/payment-5.png" alt="Payment"></a></li> </ul>
9WPML
WPML is the most popular plugin for multi language support, our theme is fully compatible with WPML. Below you will find documentation their team created for using WPML plugin with this theme. If you’ve purchased WPML and have any questions or issues, please check the links below.
- WPML Plugin- The highly recommended plugin to manage multi-lingual sites.
- WPML Forum Support - If you bought WPML then you get free support from their amazing team.
- Translating Widgets – Tutorial recommended by wpml team for translating widgets
Please Click Here To Purchase WPML Plugin!
10OTHER
- SUPPORT – If you have any questions that are beyond the scope of this help file, please send us via: Support Tickets System
- FAQs – Go to Here to view more the Frequently Asked Questions.
3.6 Social Share