1. Start
  2. Upgrading From 1.1 to 1.2
  3. Installation
  4. Getting Started (basic)
  5. Demo Content
  6. Homepage Demos
  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?

Maddux

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...

Upgrading From 1.1 to 1.2


This section is only for individuals who are using FTP to upgrade from version 1.1

For those of you who are upgrading from version 1.1 to version 1.2 AND you plan on using WooCommerce AND you're upgrading via FTP, please do the following:

  1. Using FTP, navigate to the maddux/woocommerce directory on your server
  2. Once there, delete the maddux/woocommerce/cart sub-directory and all of its contents
  3. Next, delete the maddux/woocommerce/checkout sub-directory and all of its contents
  4. That's it!

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 Maddux.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 Maddux (.zip extension)

Getting Started Without Demo Content


This section is for those of you who are new to WordPress themes and need a little help getting started, but don't want 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 Maddux theme supports three (3) menu locations: Small Top 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

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.) 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. 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. To install our demo content, follow the instructions below…

Basic Setup:  When you download all of the Maddux files from Themeforest, within the “zipped” file, 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 Maddux 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).

Homepages in our demo are created using shortcodes for maximum flexibility. We have created detailed instructions for how to create each homepage from our demo. Choose an option below:

Localization


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.

Note: If you're using a page caching plugin, you may need to flush the cache before your translations appear.

Create Navigation Menu(s)


"Menus" are how your website visitors navigate your website. The Maddux theme supports three menu locations: two in the Header (the main menu and - if using the Top Bar option - a menu in that area as well) 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 Maddux theme now comes with Mega Menus! If you require a Mega Menu, be sure to do the following:

  1. While logged in to your website, go to Mega Menus > Add New
  2. 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!)
  3. Next, go to Appearance > Menus
  4. 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).
  5. Note 1: 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)
  6. Note 2: 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 Maddux theme comes with the ability to add a slider to any page. There are multiple ways to make sliders, which we'll cover below:

Carousel & Flexsliders:

  1. Create a new page or edit an existing one
  2. Scroll down to beneath the text editor and look for Slider Settings within the General Settings container.
    Example:
  3. Modify the settings to your preference. Don't be afraid to try several different options!
  4. 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. Go to Posts  >  Add new (or edit an existing post).
  2. In the right column, look for a sub-section labeled Formats. Within that section, select Gallery from the available options.
  3. Scroll down to beneath the text editor and look for Gallery Settings within the General Settings container.
  4. You have the option of adding up to 10 gallery images to a post. Add them here.
  5. 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. Go to Posts  >  Add new (or edit an existing post).
  2. In the right column, look for a sub-section labeled Formats. Within that section, select Video from the available options.
  3. Scroll down to beneath the text editor and look for Video Settings within the General Settings container.
  4. Paste a URL/ID from either Vimeo or Youtube in the appropriate field. Alternatively, you can upload a video to your server.
  5. 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. Go to Posts  >  Add new (or edit an existing post).
  2. In the right column, look for a sub-section labeled Formats. Within that section, select Audio from the available options.
  3. Scroll down to beneath the text editor and look for Audio Settings within the General Settings container.
  4. Paste a URL/ID from either Soundcloud or Spotify in the appropriate field. Alternatively, you can upload an audio file to your server.
  5. 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 Maddux 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.

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 Maddux theme comes with a Sidebar Manager, providing the flexibility you need.

To get started with Unlimited Sidebars, do the following:

  1. Go to Appearance › Sidebar Manager and create as many additional sidebars as necessary.
  2. 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.
  3. 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.
  4. 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 Maddux 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)

  1. Typography - The Maddux 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 Maddux 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 Maddux 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 Maddux 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.