1. Start
  2. Installation
  3. Getting Started (basic)
  4. Demo Content
  5. Homepage Demos
  6. REQUIRED Plugins
  7. Recommended Plugins
  8. Localization
  9. Add A Logo
  10. Create Navigation Menu(s)
  11. Mega Menus
  12. Sliders
  13. Creating a Gallery Post
  14. Creating a Video Post
  15. Creating an Audio Post
  16. Widgets
  17. Unlimited Sidebars
  18. Customize Your Website
  19. WooCommerce
  20. Updating Your Theme
  21. Need Support?

Matador

Responsive Blog & Magazine WordPress Theme


Thank you for your interest in our themes! For those of you that have purchased one of our themes, you are entitled to free customer support via our online Support Forums. On the other hand, if you have questions about our themes prior to purchase, just leave a comment over at Themeforest and we'll respond as soon as we can.

Still here? Ok, use the options in the sidebar to navigate this page. If at any point you become confused and need further assistance, head over to the Support Forum and explain your issue.

Ok, let's get started...

Installation


Before you can install the theme, you'll need to have WordPress (version 3.9+) running on your server. Many webhosting providers offer relatively easy ways to install WordPress (call or email your webhosting provider for specific instructions), or you can follow the WordPress Famous 5-Minute Install instructions. Need some help? Select a Microlancer developer to install and set-up your theme quickly and affordably. If you're still looking for a webhosting provider, we recommend one of these options.

If you're okay to move along - meaning you installed WordPress - you're probably ready to install our theme. To do so, follow these instructions:

  1. Log in to your WordPress installation using the username and password you created when first installing WordPress.
  2. Once logged in, go to Appearance  >  Themes.
  3. Click on the Install Themes tab at the top of the page
  4. Under that tab, click on Upload
  5. Next, you'll need to click the file input field and find the appropriate file to upload. The easiest way to do this is to use the Installable WordPress file only option when downloading the theme from the Themeforest downloads page.
    Example:


    Alternatively, if you do not have access to Themeforest at the moment and have already downloaded the All files & documentation option, you'll need to find the zipped (compressed) folder named Matador.zip - which will be inside of the file/folder that you downloaded from Themeforest when you purchased the theme.   Note: if using this option, DO NOT upload the entire file that you downloaded from Themeforest. Within that file, you will find the file/folder that we're looking for. Reminder: the file is named Matador (.zip extension)

Getting Started Without Demo Content


This section is for those of you who need a brief refresher on getting start with a new WordPress theme (and do not want/need to use our demo content)...

Menus:  First, you'll want to create a few menus. Menus are the sets of navigation links that your website visitors will use to move around your website. The Matador theme supports three (3) menu locations: Top Bar: Small Navigation, Main Navigation, and Footer Navigation. To get started creating the appropriate menus, do the following:

  1. While logged into the admin section of WordPress, go to Appearance → Menus
  2. Near the top of the page, there should be a link to create a new menu. You'll want to click that link and follow the prompts to name and save a menu. Complete this process three (3) times for each of the menu locations supported by this theme.
  3. Next, click on the “Manage Locations” tab
  4. On this page, assign menus to their appropriate locations. Example:
  5. Click the “Save Changes” button

Note: If you are simply changing themes, you may have already created one or more menus that were in use with your previous theme. In many cases, one or more of those menus can be used in the locations that our theme supports.

 

Homepage:  At this point, if you haven't done so already, you will probably want to make sure that your homepage is set to display a “static” page. (If you want your homepage to look like any of the “home” pages from our demo, these steps are essential — in fact, even if you simply want your homepage to display recent posts, we still recommend the following steps.) To complete this task, follow these instructions:

  1. If you haven’t done so already, create two pages:
    • A page that will serve as your “home” page (you may even want to title it “Home”)
    • A page that will serve as your “blog” page (you may want to title it “Blog” or “News”)
  2. Next, from the Admin section of WordPress, go to Settings > Reading
  3. For the “Front page displays” setting, select “A static page”
  4. Underneath that, select the following:
    • For “Front page”, select the “home” page that you created from step 1
    • For “Posts page”, select the “blog” page that you created from step 1

  5. Be sure to save those changes

Getting Started With Demo Content


Although not required, many of you may choose to initially set up your site in a way that mimics our demo in its entirety. Again, this isn't a requirement, but it can help users understand how our theme works by exposing how we created each page, post, and menu within our demo. We do not recommend following these instructions if your site is live.

To install our demo content, follow the instructions below…

Basic Setup:  You'll want to start by downloading all of the Matador files from Themeforest (not just the installable WordPress file):

After dowloading all of the files, within the “zipped” file that is downloaded to your computer, there should be a folder named “demo content”. Within that folder is an XML file that contains the content from our demo site in a format that WordPress can interpret. To upload it, do the following:

  1. Log into your site as an administrator.
  2. Make sure you activated the Matador theme before proceeding.
  3. Go to Tools → Import
  4. Choose “WordPress” from the list.
    1. If running the importer for the first time, you will be prompted to download a plugin.
    2. After the plugin has finished installing, click “Activate and Run Installer”
  5. Upload the demo content (.xml file) using the form provided on that page.
  6. 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.
  7. You will then have the choice to import attachments, so click on the “Download and import file attachments” box.
  8. Please be patient while WordPress imports all the content. Posts, Pages, Images, Menus, etc are imported. (You will need assign the menu a theme location & you'll need to configure widgets. This is a limitation of WordPress' import system.)
  9. Note: Our demo content contains items from the shopping cart section of our demo. If you do not have WooCommerce installed, you will be notified that these items have failed to import. Try not to worry — this is to be expected and will not cause any issues.

Menus:  Next, you'll want to make sure that WordPress has properly imported the navigation menus from our demo. Typically, WordPress will import the menus, but neglect to properly save menus to their appropriate locations. Make sure the demo menus are properly arranged by doing the following:

  1. While logged into the admin section of WordPress, go to Appearance → Menus
  2. Click on the “Manage Locations” tab
  3. On this page, select the following options:
  4. Click the “Save Changes” button

Homepage:  At this point, if you haven't done so already, you will need to make sure that your homepage is set to display a “static” page. To do so, follow these instructions:

  1. From the Admin section of WordPress, go to Settings > Reading
  2. For the “Front page displays” setting, select “A static page”
  3. Underneath that, select the following:
    • For “Front page”, select “Home” from the dropdown list
    • For “Posts page”, select “Blog”

  4. Be sure to save those changes

Creating our Homepage demos


For those of you who decided to import our demo content, you can probably skip this section.

Note: You should also make sure that your website is using a static page for its homepage (instructions here).

There are two ways to create each "homepage" within our demo: by using a page template, or by using shortcodes. Using a page template is easier and faster, but using shortcodes provides much greater flexibility.

Using a Page Template: (version 1.2.2+)  
To mimic one of our homepage demos using a page template, do the following:

  1. Create/edit a page
  2. While editing that page, select one of the "Home" demos from the Template select field (in the right column - within the Page Attributes module when editing a page).

Using Shortcodes: 
We have created detailed instructions for how to create each homepage from our demo. Choose an option below:

REQUIRED Plugins


The Matador theme requires our new ThemeStockyard Essentials plugin to take advantage of the full feature set of the theme.

If you have installed and activated the Matador theme, the ThemeStockyard Essentials plugin should automatically be installed. Note: navigating away from the theme selection/activation page should initialize the plugin.

If the plugin is not automatically installed, you should notice an alert message concerning the plugin near the top of the page while logged into WordPress. Follow the instructions in that message to begin installing the plugin. Note: If you accidentally dismissed the alert, go to Appearance › Helpful Plugins (this link will not appear if all recommended/required plugins are already installed and activated).


If, for some reason, the ThemeStockyard Essentials plugin was not automatically installed upon activating our theme and you're not receiving the alert message, you can find the plugin inside your Themeforest download. Here's how:

  1. Go to themeforest.net/downloads (you'll need to be logged in)
  2. Download your all of the theme files by clicking the Download Button, and then the corresponding option.
    Example:
  3. Open up the "zipped" file that is downloaded, then open the "plugins" folder, and copy/extract the ts-essentials.zip file.
  4. To upload our plugin, simply go to WordPress › Plugins › Add New › Upload. Upload the ts-essentials.zip file and activate the plugin.

Once the plugin has been activated, you'll have access to all of the supported features including: mega menus, over 20 widgets, an admin panel, and more.

Localization


Translations  |  Dates

There are two types of "localization" that we'll briefly cover in this section: translations and date formats

Translations

For customers who require their websites to be in any other language than English (American), we recommend using the Loco Translate plugin. This particular plugin allows you to easily translate all of the lines of text that are coded into the theme - and best of all, you can do it all from within the WordPress Admin section.

Here are some quick instructions on how to get started:

  1. Install and Activate the Loco Translate plugin.
  2. From the WordPress admin area, go to Loco Translate > Manage Translations (it may take a few seconds for that page to load)
  3. Click "+ New language" next to the Matador theme
  4. Select your language from the select field on the following page and click "Start translating"
  5. Make any translations you need on the following page and click the "Save" button when finished

Note: After making your translations, it's always a good idea to make a backup copy of your translation files.

 

Date Formats

Beginning with version 1.1, customers who prefer "little-endian" date formats (eg. dd/mm/yyyy) can use a very simple way to localize dates...

  1. First, be sure that the TS Essentials plugin is installed and activated (see the Required Plugins section above)
  2. Go to Appearance > Theme Options > Other Options
  3. Under "Date & Time Options", make sure that Enable "Smart Date/Time Conversion" is set to On
  4. Next, choose the appropriate date and time formats from the next two options
  5. Save changes

Note: If you're using a page caching plugin, you may need to flush the cache

Create Navigation Menu(s)


"Menus" are how your website visitors navigate your website. The Matador theme supports two menu locations: one in the Header (the main menu) and one in the Footer (at the bottom of the website). To create the appropriate menu(s), follow these instructions:

  1. After creating a few pages, go to Appearance  >  Menus
  2. Click the plus tab to create a new menu (top, middle).
  3. Under that tab, give the menu a name (eg. "Main menu")
  4. Add pages to that menu by checking/ticking the boxes next to the pages you want under the Pages sub-section. You can do the same for categories. You can also add custom links as well (for example: you may want to link to a page that is not part of your website, or a particular blog post).
  5. Click Save Changes.
  6. Next, under the Theme Locations sub-section, choose where your new menu should appear.
  7. Be sure to click Save Changes again.

Mega Menus beta


The Matador theme comes with Mega Menus! If you require a Mega Menu, be sure to do the following:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. While logged in to your website, go to Mega Menus > Add New
  3. Add a Mega Menu in the same way you'd add a new page or post. If you need your Mega Menu to contain a navigation menu, we recommend using our "Custom Menu" shortcode. (it even allows you to split your navigation menus into columns!)
  4. Next, go to Appearance > Menus
  5. Look for the Mega Menu you created within the "Mega Menu" section, and add it as a top level menu item to your main menu (the main menu is the only one that supports Mega Menus at the moment).
    • Note: If you do not see the Mega Menu section, click the "Screen Options" button in the top-right corner, then tick the box next to "Mega Menus".
  6. Tip 1: When creating/editing a mega menu, scroll down beneath the text editor to enter the URL that the main link should direct to, as well as the layout/width of the mega menu.
  7. Tip 2: Be sure to add your mega menu as a top level menu item (in other words, it shouldn't be nested under another menu item)
  8. Tip 3: Do not add any child elements under the Mega Menu. The content you created at step 2 will suffice.

That's it! Please keep in mind that Mega Menus are a new feature for us — if you find issues please let us know in our support forums.

Adding Sliders to pages


The Matador theme comes with the ability to add a slider to any page. There get started, do the following:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. Create a new page or edit an existing one
  3. Scroll down to beneath the text editor and look for Slider Settings within the General Settings container.
    Example:
  4. Modify the settings to your preference. Don't be afraid to try several different options!
  5. Click Publish or Save Changes and you're done!

 

Creating A Gallery Post


For times when an individual photo simply won't suffice, you have the option of adding a “gallery”. A gallery is simply a type of “post format” that allows you to add additional photos to represent your post. Do the following to create a gallery:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. Go to Posts  >  Add new (or edit an existing post).
  3. In the right column, look for a sub-section labeled Formats. Within that section, select Gallery from the available options.
  4. Scroll down to beneath the text editor and look for Gallery Settings within the General Settings container.
  5. You have the option of adding up to 10 gallery images to a post. Add them here.
  6. Click Publish or Save Changes and you're done!

Note: In most cases, Gallery images will be presented instead of the Featured Post Image. However, it's still a good idea to add a Featured Post Image, for the rare moments when the Gallery is not displayed (eg. some mobile devices).

Creating A Video Post


Creating a video post is very similar to creating a gallery post. To create a video post:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. Go to Posts  >  Add new (or edit an existing post).
  3. In the right column, look for a sub-section labeled Formats. Within that section, select Video from the available options.
  4. Scroll down to beneath the text editor and look for Video Settings within the General Settings container.
  5. Paste a URL/ID from either Vimeo or Youtube in the appropriate field. Alternatively, you can upload a video to your server.
  6. Click Publish or Save Changes and you're done!

Note: Self-hosted videos currently will not appear in sliders.

Creating An Audio Post


Creating an audio post is very similar to creating a gallery or video post. To create an audio post:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. Go to Posts  >  Add new (or edit an existing post).
  3. In the right column, look for a sub-section labeled Formats. Within that section, select Audio from the available options.
  4. Scroll down to beneath the text editor and look for Audio Settings within the General Settings container.
  5. Paste a URL/ID from either Soundcloud or Spotify in the appropriate field. Alternatively, you can upload an audio file to your server.
  6. Click Publish or Save Changes and you're done!

Note: Audio will only appear on single post pages.

Widgets


On some pages, you'll want to enable a sidebar to house "widgets". If you don't know what widgets are, widgets are customizable blocks that add content and features to your website's sidebar(s). For example: a "Twitter" widget may show your latest tweets. An "ad space" widget will allow you to show ads on your website. The Matador theme comes with the ability to create an unlimited number of sidebars. To start adding widgets, do the following:

  1. On the widgets page (go to Appearance  >  Widgets) toggle open the sidebars you want to fill.
  2. From the list of available widgets, drag and drop the appropriate widget to the sidebar that you intend to customize.
  3. Note: you'll want to make sure that our ThemeStockyard Essentials plugin is installed and activated as it brings over 20 widgets beyond the default WordPress ones. Our plugin should have been installed automatically upon theme activation, but if not, follow these instructions.

Note: Many widgets will require options to be filled before they can function correctly.

Unlimited Sidebars


You may find that you need more flexibility with regard to the types of widgets/sidebars you display on various pages or posts. For example, you may need to add a completely different set of widgets to the sidebar for one post, and then a different set of widgets for another post. The Matador theme comes with a Sidebar Manager, providing the flexibility you need.

To get started with Unlimited Sidebars, do the following:

  1. First, make sure that our ThemeStockyard Essentials plugin is installed and activated. It should have been automatically installed upon theme activation, but if not, follow these instructions.
  2. Go to Appearance › Sidebar Manager and create as many additional sidebars as necessary.
  3. On the Widgets page, add the necessary widgets to the appropriate sidebars – choosing from the list of available widgets, drag and drop the appropriate widget to the sidebar that you intend to customize.
  4. Finally, when editing a post or page, in the right-hand column you should see a “Sidebar” module. Select from all of the available sidebars.
  5. Click Publish or Save Changes and you're done!

Note: If no sidebar is selected from the “Sidebars” module, or if the selected sidebar no longer exists, the Matador theme will default to one of the “Primary Sidebar” that is the default for each page/post. You can also choose to hide the sidebar on pages or posts by using the “General Settings” under the editor.

Customize Your Website


At this point, you may want to make your website truly unique by changing the fonts, colors, backgrounds, layouts, etc. There are a lot of customization options available, feel free to go crazy. If you go too crazy, you can always reset the default options/style by going to Appearance  >  Theme Options  >  Backup Options, and click on the Reset button. Here are a few commonly updated options to get you started: (all of these options can be found by going to Appearance  >  Theme Options)

Note: you'll want to make sure that our ThemeStockyard Essentials plugin is installed and activated as it brings over 20 widgets beyond the default WordPress ones. Our plugin should have been installed automatically upon theme activation, but if not, follow these instructions.

  1. Typography - The Matador theme is compatible with Google Fonts, which allows you to choose from more than 500 font options! Choose from the available options by going to Appearance  >  Theme Options  >  Typography
  2. Color Scheme - The Matador theme comes with several pre-set color schemes. Choose from one of those or create your own by going to Appearance  >  Theme Options  >  Colors
  3. Background Image/Pattern - When disabling the Fullwidth layout, you have the option to show a background image for your website. Get started by going to Appearance  >  Theme Options  >  Backgrounds and choosing from the available options or uploading your own.

If you create a nice look but you still want to try other options, go to Appearance  >  Theme Options  >  Backup Options,  and save a backup of your current settings. You can restore them at a later date! Note: As of now, you can only save one backup at a time.

Have fun!

Working With WooCommerce


Need to sell products? The Matador theme comes with full support for the excellent WooCommerce plugin.

To get started with WooCommerce, we recommend heading over to the WooCommerce “Getting Started” page for detailed instructions.

Tips:

The Lightbox that is used in our online demo is different from the default. To enable our Lightbox, simply do the following:

  1. From the Admin section of your WordPress installation, go to WooCommerce > Settings
  2. Under Styles and Scripts, uncheck “Enable Lightbox”
  3. Save changes

To show the shopping cart icon (and order subtotal) in the main navigation, do the following:

  1. From the Admin section of your WordPress installation, go to Appearance > Theme Options > Header Options
  2. Find “Show Shop Icon in Main Navigation” and make sure it's set to On
  3. Save all changes

Product images and thumbnails should also be changed from the defaults. We recommend the following settings:

To achieve those settings, install WooCommerce, then do the following:

  1. From the admin area, click WooCommerce (in the left navigation area)
  2. Next, click Settings from within the same area
  3. Next, click on the Products near the top of the page
  4. Scroll down until you see the Product Image Sizes area, and change the settings as necessary.
  5. Save Changes

Note: after changing those settings, you may need to regenerate thumbnails.

Updating Your Theme


FTP  |  Envato WordPress Toolkit

Method #1: FTP

This first method of updating you theme is the easiest, but can also be intimidating for individuals who are not tech-savvy. The steps are as follows:

  1. Download the Installable WordPress file from Themeforest
    Example:
  2. Extract the theme from the "zipped" folder, onto your local hard drive.
  3. Connect to your FTP (ask your web host for instructions, if needed)
  4. Upload the extracted theme to: wp-content/themes/  –  Just replace existing files and folders.
  5. You are done.

 

Method #2: Envato WordPress Toolkit

As mentioned in the Recommended Plugins section of this documentation, We highly recommend using the Envato WordPress Toolkit plugin for easy updating. To get started, do the following:

  1. Important: if you have localized your theme installation by creating or editing any translation files, be sure to make a backup copy of those files.
  2. Also Important: please make a local backup of your Theme Options. In most cases, your Theme Options will be saved, but some users have reported that their settings have disappeared after performing an update. To make a backup of your Theme Options, do the following:
    • Go to Appearance > Theme Options > Backup Options
    • Reload the page
    • Click the Backup Options button under "Backup and Restore Options"
    • Next, Copy the text within the text field under "Transfer Theme Options Data"
    • With the text you just copied, Paste and Save it into a plain text file on your computer
  3. Download the Envato WordPress Toolkit plugin
  4. Install the plugin (While in the admin area of WordPress, go to Plugins > Add New > Upload)
  5. Activate the plugin
  6. Click Envato Toolkit in the left column
  7. Enter your Envato/Themeforest username and API key (which you can find by going to Settings > API Keys on Themeforest)

Once you do that, you should be able to see any available updates for the Matador theme — you'll also be given the option to Update automatically, which means you won't have to download any files to your computer :)


After performing the update, visit your Theme Options to insure that your settings are as they were before the update. In most cases, your settings will remain, but if they were reverted back to default, you can follow these instructions:

Requesting Support


If you run into trouble at any point, or simply have a question or suggestion, feel free to post in our forums. Our support forums are provided freely to any purchasing customers.

To post in our forums, you'll need to create an account if you haven't already.

  1. Go to our forums: http://support.themestockyard.com
  2. Click Register in the top right corner of the page
  3. On the following page, you'll need to enter your Themeforest username and purchase code. You can find your purchase code by doing the following:
    1. Go to themeforest.net/downloads (you'll need to be logged in)
    2. Download your license certificate and purchase code by clicking the Download Button, and then the corresponding option.
      Example:
    3. Open up the text file that is downloaded, and copy the code that appears after the phrase “Item Puchase Code:”.
  4. Click Verify and your account will be created.

To post a new topic, follow these directions:

  1. Go to our forums: http://support.themestockyard.com
  2. Click on Matador in the right column.
  3. Ask a question by using the form at the bottom of the page. Note: Some users have stated that Internet Explorer does not properly show the form. Try Chrome or Firefox if possible.

Note: It's always a good idea to browse/search and see if your question hasn't already been answered.