Gaucho, theme documentation

First, thank you for purchasing our theme!

This guide provides instructions for installation, help on getting started and extensive documentation of features. It is recommended you read it thoroughly to fully leverage the Gaucho theme's capabilities. Please also make sure to check out our Video Tutorials as they explain everything covered in here in greater depth. We hope you enjoy building with Gaucho as much as we enjoyed developing it and continue to develop with new features!

Before beginning the installation and configuring of your new theme, you must first have WordPress already installed on a server.

If you are struggling, here is a very detailed guide at Wordpress Codex that will walk you through every step.

If you prefer something more visual, you can watch this video tutorial on how to install Wordpress by us

(Please note the video shown is from our NUVO Restaurant theme, but the same process applies)

Once you have setup a copy of WordPress, there are two ways you can go about installing the theme:

• 1. FTP Upload
  

  Unzip the download and upload the theme directory /Gaucho/ into your WordPress themes directory /wp-content/themes/.

• 2. WordPress Upload
  

  This is definitely the easier route for most. Simply navigate to Appearance > Themes > Add New > Upload Theme. Click the 'browse' button and locate the still zipped theme folder. The theme will be uploaded and installed in a matter of seconds.

  Here is our video tutorial to help you through the process

  (Please note the video shown is from our NUVO Restaurant theme, but the same process applies)

After you have installed the theme successfully, you can optionally import the supplied dummy data in order to get a feel for things. If you're interested in importing the data, please check the Demo Data section below

Once you have installed and activated our theme you will be prompted to install required and recommended plugins. Just click the link to Begin installing plugins.

Next, check boxes to select all the plugins you want to install, select the bulk action of install from the dropdown box and then click the button to apply.

Next, just click the link to Return to Required Plugins Installer.

Select the plugins you had installed, and then apply the bulk action to activate them.

Finally, you will got a confirmation notice that your plugins were activeded.

Noted: Before you install our themes please read some our tips here:

• How to install sample data using one click in CMS theme 
• How to install sample data using import xml method

To help you set up website with the least efforts, we include in the theme package dummy content file. After installing it, all content seen on the live demo will be imported except for images/videos.

There are two methods you can use, one is using our One-click Importer, the other is Importing manually. To go with the former option, please follow the steps below:

1. 1. Go to Theme Option on the Appearance menu
   

   

2. 2. The Demo Content menu tab will show.
3. 3. Just click Import now and wait for the process to complete.

   

4. 4. After the importation is finished, Save Changes and you are done.

Now you have a website just like our demo, with the pictures replaced by grey images.

To imprort the demo content by yourself, please follow the steps below:

1. 1. Go to Tools > Import.
2. 2. Select Wordpress system then browse for the .xml file. You shoud be able to find it following the path Theme Option > inc > dummy > Gaucho > XML.
3. 3. You will be asked to map the authors in this export file to users on the blog. For each author, you may choose to map to an existing user on the blog or to create a new user.
4. 4. You will then have the choice to import attachments, so click on the "Download and import file attachments" box.
5. 5. Click Submit.

Now you have a website just like our demo, with the pictures replaced by grey images.

This is plugin required all our themes

This plugin provides an easy to use interface to create and administer custom post types and taxonomies in WordPress. This plugin is created for WordPress 4.x.

If you need dedicated support for this plugin, please visit: Custom Post Type UI

After installation, you will be suggested to install additional plugins. To install them and activate, please navigate to Plugins, you will see a list of required and optional plugins. We recommend that you install the following to get the best of our theme:

Visual Composer is the most popular drag and drop editor for wordpress.

If you need dedicated support for this component, please visit: Visual Composer on Code Canyon

Contact Form 7 is one of the most popular form builders for wordpress.

We have created styles ready for you to use within your Gaucho theme.

For detailed inforamtion and support on this plugin, please go to: Contact Form 7

Woo Commerce is one of the most popular shopping cart plugins for wordpress.

For detailed inforamtion and support on this plugin, please go to: WooCommerce

Events Manager is a full-featured event registration plugin for WordPress based on the principles of flexibility, reliability and powerful features!

Version 5 now makes events and locations WordPress Custom Post Types, allowing for more possibilities than ever before!

For detailed inforamtion and support on this plugin, please go to: Events Manager

Flex Map is a wordpress map plugin that provides many features with different map types such as creating area mapping, polygone, polyline, circle, rectangle, single markers, street view markers.

With a simple visual map editor, It is extremely easy to make and place your map anywhere on your frontend wordpress site.

For detailed inforamtion and support on this plugin, please go to: Flex Map

FullCalendar is a free open source jQuery plugin by Adam Arshaw which generates a stunning calendar populated with your events.

This plugin combines the power of FullCalendar and WordPress to present your posts or any other custom post type in a calendar format, which can be filtered by custom taxonomies such as categories and tags.

For detailed inforamtion and support on this plugin, please go to: WP FullCalendar

1. 1. From the 'Appearance' menu on the left-hand side of the Dashboard, select the 'Menus' option to bring up the Menu Editor.



2. 2. Select create a new menu at the top of the page



3. 3. Enter a name for your new menu in the Menu Name box.
4. 4. Click the Create Menu button. 



5. 5. Click Select to select menu created.

Your new custom menu has been defined.

You can add different link types into your menu, these are split between panes left of the menu you're currently editing.

1. 1. Locate the pane entitled Pages.
2. 2. Within this pane, select the View All link to bring up a list of all the currently published Pages on your site.
3. 3. Select the Pages that you want to add by clicking the checkbox next to each Page's title.
4. 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. 5. Click the Save Menu button once you've added all the menu items you want.

Your custom menu has now been saved.

When planning the structure of your menu, it helps to think of each menu item as a heading in a formal report document. In a formal report, main section headings (Level 1 headings) are the nearest to the left of the page; sub-section headings (Level 2 headings) are indented slightly further to the right; any other subordinate headings (Level 3, 4, etc) within the same section are indented even further to the right.

The WordPress menu editor allows you to create multi-level menus using a simple 'drag and drop' interface. Drag menu items up or down to change their order of appearance in the menu. Drag menu items left or right in order to create sub-levels within your menu.

To make one menu item a subordinate of another, you need to position the 'child' underneath its 'parent' and then drag it slightly to the right.

1. 1. Position the mouse over the 'child' menu item.
2. 2. Whilst holding the left mouse button, drag it to the right.
3. 3. Release the mouse button.
4. 4. Repeat these steps for each sub-menu item.



5. 5. Click the  Save Menu   button in the Menu Editor to save your changes.

1. 1. Scroll to the bottom of the menu editor window.
2. 2. In the section titled Theme locations, click the check box for the location where you want your menu to appear.



3. 3. Click Save menu once you've made your selection.

Congratulations! Your menu has now been added to your site.

You can set any menu as Primary menu here.

Result:

With the Page Options specially built for our themes, you can easily customize General, Header, Page Title and Footer of every page.

General

Custom page background color and Padding Top/Bottom: By turning On/Off the switch button.

Background Color: Set background color for content.



Result:

Header

• Custom Header: Enable/Disable custom style mode.
• Header/Menu Sticky: Enable/Disable show header/menu sticky.

Result:

Page Title

Custom: Enable/Disable custom style mode.

You can give a Title, Sub Title and select layout for your Page Title here.



Result:

To set a page as Home page, go to Settings > Reading in your WordPress Dashboard panel.

1. 1. Set "Front page displays" as "A Static Page"
2. 2. In the drop down menu for "Front Page" choose a page which will be your home page.



3. 3. Save changes.

Events, Gallery, Testimonals, Our Staff, Posts and Pricing are created using Shortcodes. For more detailed instruction, please head to Shortcode > CMS Grid

To Add Widget on Sidebar, please following these steps:

1. 1. Navigate to Appearance>Widgets to access the list of widgets and widget section that they can be added. The left hand side show all widgets you can use. The right hand side shows all different section you can add widgets to.
2. 2. Simply drag and drop the widget you want into the widgets section you want to the right hand side.
3. 3. When you finished, you can visit the site to see results.

The options panel is home to all of the theme's extensive configuration options. To view the panel, click on Appearance > Theme Option in the left-hand menu. Here you have the ability to alter many core aspects that make up how your theme looks and behaves. Any of the options that have some ambiguity to them conviently have descriptions to explain their purpose.

With our built-in importer, you will be able to get your site ready in a flash. Simply select a layout and click Import now to start importing demo data.

You can set Favicon icon for your site here.

Result:

Select layout style to show

.

Result:

You can enable/disable Header Top here.

Result:

You can enable/disable Header Bottom here. If you choose Enable, you can set Margin and Padding for Header Bottom.

Result:

You can enable/disable to show menu sticky.

Result:

All options relating to Page Title and Breadcrumb can be found here.

• 

  Layouts: You can select some available layouts for page title here.

  Background:

  You can click Upload to upload an image file for your page title background.

  You can also change background color for page title here.

  Margin & Padding: You can set Margin & Padding for Page Title.

  Result:

  

You can enter sub title of Page Title here.

Result:

Here, you can change the text before the Breadcrumb home and config Typography with title text.

Result:

You enable/disable page loading here.

You enable/disable Back to top here.

After turn on this button, reload the page to see result.

You can enable/disable Shop Option here.

Result:

Background: You set bg color for footer here.

Here you can set Padding and Margin for Footer section.

Result:

Not just color, all text elements are also within your control. You can define the style of Body text and H1 to H6 Headlines for yourself.

Result:

Body font:

On this section, Gaucho theme had some available fonts for you. If you want to set a special font for a special class, you only need to insert your class into Selector section, and choose the font that you want on the Font dropdown box. Finally, you click Save changes and see your result, all completed.

Example:

1. Copy class that you want to change.

2. Select Font Family, Font Weight & Style and paste class on Selector section.

Result:

Please create/paste custom css here. Make sure css is out of any errors/mistakes. Please always remember to click "Save Changes" button. Without that you will lose all your changes.

You can enable/disable Smooth Scroll when scroll mouse.

Here is where you can turn on/off Developer Mode.

This section is especially for all those who want to move settings from theme options panel between themes or when you move your website from test server to live. Please always remember to click "Save Changes" button. Without that you will lose all your changes.

Visual Composer is a powerful Wordpress page builder that allows you to create complex page layouts without touching a single line of code. To switch to Visual Composer's Backend Editor, click on this button:

When Visual Composer's editing pane comes up, click on either of these buttons to Add Element.

A shortcode selecting panel will show up, you can see all the shortcode available in the theme. Select the one you would like to use.

You will then encounter a setting panel for the shortcode (each shortcode has it own setting options), after a bit of configuration, it will show up nicely on your page.

• Title: Add title of fancy icon box.
• Description: You can add description for your Single Fancy Box.
• Content Align: You can choose the type of display Default, Left, Right and Center.

• Icon Library: Select libraries available.
• Icon Item: Select an icon for your single fancy box.
• Image Item: Select image for item.
• Title Item: Enter title of item.
• Content Item: Enter content of item.

• Button Type: Select button type to show.
• Link: Enter link of item.

• Shortcode Template: Select your single fancy box template.

• Result:

• 

• Shortcode Template: Choose a style to show for SlideShow.

• Title : You write the title you want here .
• Background Type: Select image for item.
• Image Slide: Select Images in the library .

• Overlay Panel Transitions: You can choose the type of display Slide Top, Slide Bottom,, Slide Left ,Slide Right , Fade , Scale ,Spin ,Grayscal .
• Overlay Panel Position: You can choose the type of display Top Left,Middle Left ,Top Right ,and Top Center...

• Height: Enter height for slideshow.
• Slideshow Style: Select libraries available.

• Time switching : Enter the timespan between switching SlideShow items .
• Nav Position : Select Nav Position type to show.

• Result:

• 

• Title: Enter title of a social.
• Icon Library: Select libraries available.
• Icon Item: Select an icon for your single Socials.
• Social Link: Add link for a social.
• Style: You can choose the type of display Dark and Light.

• CSS box: Enter value margin, border and padding for socials.

• Shortcode Template: Choose a layout to show on screen.

• Result:

• 

• Shortcode Template: Choose a style to show for slider.

• Source: Click on Build Query more options will show up

• Post types: Set Post Types as our product.
• Post count: Limit the number product to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts.
• Sort order: Designates the ascending or descending order.

• Columns XS Devices: Select layout style to show.

• Result:

• 

• Block Type: You can select Number or Date.
• Number: Enter the number on this field.
• Description: You can enter description here.

• Result:

• 

Pricing

• 1. To display pricing in a page, first you need to create pricing items. Go to Pricing > Add new.
• 
• 
• 2. Enter Pricing name in Title field. Enter
• 3. Select a Category for Pricing on Categories section. Create more Category by enter name categories, then clicking New Category .
• 4. Set Pricing's picture by choosing a Set featured image.
• 5. Finally, Publish.
• Result:

• 

After creating Pricing items, it's time to display them in a page using CMS Grid shortcode.

• 1. Go to Page > Add New.
• 2. Using Visual Composer, choose Add Element.
  
  
• 3. Select CMS Grid.
• 

• 
• Shortcode Template: Choose a layout to show for the pricing.
• 
• Source: Click on Build Query more options will show up.
• 
• Post types: Set Post Types as pricing.
• Post count: Limit the number pricing to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts.
• Sort order: Designates the ascending or descending order.

• 

• Columns Devices: Select the number of columns displayed.

• 

• Result:

• 

Gallery

• 1. To display gallery in a page, first you need to create gallery items. Go to Gallery > New Gallery.
• 
• 
• 2. Enter gallery name in Title field. Enter Gallery Content in the content section.
• 3. Select a Categories for gallery on Categories section. Create more Category by enter name categories, then clicking Add New .
• 4. Set gallery's picture by choosing a Set featured image.
• 5. Finally, Publish.
• Result:

• 

After creating gallery items, it's time to display them in a page using CMS Grid shortcode.

• 1. Go to Page >Add New.
• 2. Using Visual Composer, choose Add Element.
  
  
• 3. Select CMS Grid.
• 

• 
• Shortcode Template: Choose a layout to show for the gallery.
• 
• Source: Click on Build Query more options will show up.
• 
• Post types: Set Post Types as gallery.
• Post count: Limit the number gallery to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts.
• Sort order: Designates the ascending or descending order.

• 

• Columns Devices: Select the number of columns displayed.

• 

• Result:

• 

Our Staff

• 1. To display a our staff profile, first you need to create member profile items. Go to Our Staff > New Our Staff.
• 
• 
• 2. Enter the member name in Title field. Add some Description in the content section if you want.
• 3. Set member's profile picture by choosing a Set featured image.
• 4. Finally, Publish.
• Result:

• 

After creating Our Staff items, it's time to display them in a page using CMS Grid shortcode.

• 1. Go to Page >Add New.
• 2. Using Visual Composer, choose Add Element.
  
  
• 3. Select CMS Grid.
• 

• 
• Shortcode Template: Choose a layout to show for the Our Staff.
• 
• Source: Click on Build Query more options will show up.
• 
• 
• Post types: Set Post Types as our staff.
• Post count: Limit the number member to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts.
• Sort order: Designates the ascending or descending order.

• 

• Animation: Select animation style to show.

• 

• Result:

• 

Testimonials

• 1. To display Testimonials in a page, first you need to create testimonial items. Go to Testimonial > Testimonial.
• 
• 
• 2. Enter the member's name in Title field. Enter Testimonal content in the content section.
• 3. Set member's profile picture by choosing a Featured Image.
• 4. Enter Testimonial Position for member .
• 5. Finally, Publish.
• Result:

• 

After creating Testimonials items, it's time to display them in a page using CMS Grid shortcode.

• 1. Go to Page > Add New.
• 2. Using Visual Composer, choose Add Element.
  
  
• 3. Select CMS Grid.
• 

• 
• Shortcode Template: Choose a layout to show for the Testimonial.
• 
• Source: Click on Build Query more options will show up.
• 
• Post types: Set Post Types as our testimonial.
• Post count: Limit the number testimonial to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts.
• Sort order: Select sort order Ascending .

• 

• 

• Layout Type: Select layout style to show.
• Columns Devices: Select the number of columns displayed.

• 

• Result:

• 

Post

• 1. To display Posts in a page, first you need to create post items. Go to Posts > Add new.
• 
• 
• 2. Enter Posts name in Title field. Enter post content in the content section.
• 3. Select a Category for post on Categories section. Create more Category by clicking Add New Category.
• 4. Set post's picture by choosing a Set featured image.
• 5. Finally, Publish.
• Result:

• 

After creating Post items, it's time to display them in a page using CMS Grid shortcode.

• 1. Go to Page > Add New.
• 2. Using Visual Composer, choose Add Element.
  
  
• 3. Select CMS Grid.
• 

• 
• Shortcode Template: Choose a layout to show for the Post.
• 
• Source: Click on Build Query more options will show up.

• 

• Post types: Set Post types as Post.
• Post count: Limit the number of post to display in grid by entering Post Count number.
• Order by: Select how to sort retrieved posts. .
• Sort order: Select sort order type to show .

• 

• Columns Devices: Enter time delay between items.

• 

• Result:

• 

The theme is compatible with WPML plugin, thus can be translated into multiple languages. Follow this link for guide. You can also use POEdit plugin for translation.

• 1. Located the .po and .mo files in folder /languages.
• 
• 2. Select language in admin options.
• 
• 3. Find language prefix (save option and reload front-end view html).
• 
• 4. Copy two file .po & .mo and rename to eg( en_CA.mo & en_CA.po ... ) same for other languages .
• 
• 5. Open the file .po with POEdit and translate the texts into your preferred language.
• 
• 6. When complete, you’ll want to save the file twice, as two separate files – a .po file and a .mo file. When you save the files, you must name them according to your language code. Find a list of language codes at WordPress in your Language. As an example, the language code for English is en_EN, so you would save the translated files as en_EN.po first, then en_EN.mo.
• 7. When that’s done, simply upload the files to your theme folder.

Our themes are optimized by with H1, H2, H3, H4, H5 tags, clean code, HTML5 but if you want to get higher ranking on search engines, you must need some help from SEO plugins and Google Pagespeed Service:

• Yoast SEO plugin
• Google Pagespeed Service
• Smush.it ( Optimizing Images )
• SEO Friendly Images ( SEO Images )

You can update our theme using some ways bellow

1. Update theme using Envato WordPress Toolkit
or

2. You can update manual theme

If you have any troubles while using auto update ( It is likely to be a permissions issue ) then you may want to manually update the theme via FTP or Cpanel.

Download the latest version of the theme on ThemeForest download page and simply replace with the old one via FTP or Cpanel.

The team at CMSSuperheroes are always happy to help you with any questions or recommendations you have about the Gaucho theme. If you need any help or support please contact us through the TF Messaging system or
direct at Email: support@cmssuperheroes.com
direct at Forum: here if you got any problem about purchase code when fill to our forum please How to fill purchase code here