Mustang WordPress Theme User Manual

Thank you and congratulations for using a theme by WebMan Design!

This user manual will teach you how to set up and use the theme. In case you have any questions that are beyond the scope of this documentation, please join WebMan Design support forum. Enjoy your Mustang WordPress theme!

WordPress

WordPress is free open source CMS software for creating websites. It can scale with your needs when you're ready to grow and is easy to learn with many free and low-cost tutorials. You can learn more about WordPress at wordpress.org.

What is a theme?

A WordPress theme changes the way your site looks and affects the style of the content displayed on it. WordPress themes are built so you can change your site's design without losing content. As you are reading a user manual for a WordPress theme and it requires WordPress to run, let's install it first.

Installing WordPress

You can run WordPress locally on your computer, or install and use it on your web hosting account (what kind of web hosting should you use?).

Securing WordPress

You can improve your WordPress installation security taking these steps:

  • Set the security keys in wp-config.php file.
  • Do not use admin as user name and set strong passwords!
  • After installation is done, remove wp-admin/install.php file.
  • Keep backups of the database and WordPress files.
  • Keep your WordPress installation, plugins and themes up to date!
  • Strengthen security further with additional specialized plugins.

Tutorials

Beginner tutorials, resources for first steps with WordPress:

Websites & Articles:

Videos:

Theme Installation

Warning: Theme requirements

Mustang requires at least WordPress 4.8 and PHP 5.6 to work properly. Please make sure to meet the requirements.

  1. (Re)download the theme package ZIP folder from the marketplace where you've purchased the theme from.
  2. Log into your WordPress admin.
  3. In WordPress admin navigate to Appearance → Themes and click the Add New button next to "Themes" page title.
  4. On "Add Themes" screen click the Upload Theme button next to page title.
  5. On the next screen choose the theme ZIP package file you've downloaded in step 1 above and click the Install Now button.
  6. After the theme is installed, activate it by clicking the "Activate" link.
  7. Now you can go to Appearance → Welcome page for information on how to set up your website (and the theme). Also, please pay special attention to your website image sizes setup.

Tip: Welcome page

Don't forget to check the theme welcome page at Appearance → Welcome. It contains everything you need to start.

Tip: Get info about updates

Get fast information about new theme updates by subscribing to WebMan Design on Facebook and Twitter.

Theme Updates

You will be notified in the WordPress admin each time a new updated theme version is available. Install the update following instructions below.

Tip: Info on social networks

If there is a specific procedure required during update, this will be shared on the Facebook and Twitter pages.

Important: Back up your website

To keep things safe please consider backing up your website and database before doing any updates to your website.

Manual Theme Update

Download the theme ZIP package from where you've obtained it originally. Then follow the steps below:

Updating via WordPress dashboard

A simple way of doing a manual theme update is deleting and reinstalling the theme directly via WordPress dashboard. You can read an article or watch a video on how to do this.

Updating via FTP

This is more advanced manual update procedure and you will need an FTP client (such as FileZilla) to connect to your server:

  1. (Re)download the theme ZIP file from where you've obtained it and unpack the ZIP file on your computer.
  2. Now you will need an FTP client to connect to your server.
  3. On your server navigate to WORDPRESS_FOLDER/wp-content/themes/ folder.
  4. Delete the existing mustang folder (or create a backup just in case - you can do this simply by renaming the folder name by appending .backup to its name so it becomes mustang.backup, for example).
  5. Copy the unpacked theme mustang folder from your computer (from step 1 above) into WORDPRESS_FOLDER/wp-content/themes/ folder on your server.
  6. Log into your WordPress admin area and check the version of the theme in Appearance → Themes. Your theme should be updated now. (And you can delete the mustang.backup folder from step 4 above.)

Content: Demo

The theme allows you to import a demo content, which matches theme demo website. Then you can simply change the imported demo content to your needs and build your website faster that way.

Before you import the theme demo content, please check these important notes:

Tip: Delete leftovers

Theme demo contains a lot of pages. You will certainly end up not using most of them. In that case it is strongly recommended to delete the leftover demo content you no longer need from your website. It improves your website performance and relevance.

Important: Install on fresh WordPress

It is recommended to install demo content on empty, fresh WordPress site. (If you are testing the theme on a computer and not your live website, you can always reset WordPress to a fresh state.

Warning: Images and media quality

Please understand that demo images, audio and video files are of low quality. This is to prevent any copyright infringement. You should replace them with your own, properly licensed media that fit your website project.

And now, for detailed instructions about importing theme demo content please visit demo content repository at GitHub (where it is kept up to date).

Content: Pages

Setting Up Home and Blog Page

  1. Navigate to Appearance → Customize → Homepage Settings (or you can also do this at Settings → Reading).

  2. For "Your homepage displays" option set "A static page".

  3. Select your homepage and posts page from dropdown lists. Posts page becomes your blog page.

Tip: Take advantage of live preview

Doing this in customizer gives you live preview of your changes.

Page Settings Tab

Each page contains a setting tabs with advanced page options. Just click the "Settings" tab (and others) above the page content editor (if you enable a page builder, the page settings tab will be displayed in metabox below) and you will be able to set several different page options, depending on what page template is being used.

Setting a general page options
Setting a general page options

Page Builder

The theme is fully compatible with the best front-end page builder plugin for WordPress, the Beaver Builder, which will help you create a complex page layouts with ease! Please, don't forget to set up a "Fullwidth sections" page layout when using a page builder!

Setting Up a Page Template

  1. On page edit screen choose one of predefined page templates in Page attributes metabox on the right.
  2. Once you set the page template, notice how page options tabs changed to offer you only the options related to specific page template.
Setting a page template
Setting a page template
"Default"

In page options tabs you can set these options:

Settings tab: For fullwidth sections please set the "Fullwidth section" option from the "Page layout" dropdown.

Slider tab: You can set a custom special slider (use any custom slider plugin) or featured image.

"Blank"

This page template displays no header and footer, only the page content. The page content is centered on the screen. Blank page template is best suited for under construction pages or special landing pages. It has no options to set.

"Blog"

With this theme you can set several blogs. Just use this page template and set its options:

Setting a blog page options
Setting a blog page options
"One page"

You can set a custom menu for this page template. The special scrolling JavaScript will be used to scroll to the sections of this page.

Don't forget to set up a HTML ID attribute for the sections of the page as otherwise your anchor navigation won't work. The best is to set up the ID attribute on page builder rows.

In page options tabs you can set these options:

Setting a one page options
Setting a one page options
Setting up an anchor in website menu
Setting up an anchor in website menu

Content: Posts

Excerpt

Excerpt will be displayed in posts list. If no excerpt is set, a portion of post content will take its place.

Adding/editing excerpt field
Adding/editing excerpt field

Archive Page Title

By default WordPress displays a caption in archive page titles (such as "Category:" in front of a category name). Use an Archive Title plugin to hide these labels.

Table of Contents on Parted Post

If you are setting up a multipage post (using a "Page break" button in visual editor, or <!–nextpage–> tag in "Text" tab of visual editor), the automatic table of contents will be generated for the post/page for you.

All you need to do is to set up a post parts titles at the top of each post part (so, immediately after <!–nextpage–> tag) with H2 heading.

Setting Up a Post Format

On the post edit screen you can choose a post format supported in the theme:

Standard post

This is basic standard blog post layout. It is recommended to set a featured image for this post format as it will be displayed in posts list alongside with post excerpt.

Audio post

Displays audio player to play your audio files. Could be used for podcasting. Please place the [wm_audio] shortcode as the first thing in post content. The audio description text can follow on next line.

Gallery post

A standard post with a gallery of images in post content. Slideshow will be displayed on blog page from the first gallery found in post content. If no gallery found, featured image is displayed.

You can insert a [gallery] shortcode anywhere in the post. This shortcode will not be stripped out from the post content on the single post page.

Link post

Promotes interesting URL links. You can set the link anywhere in the post content. The link will be emphasized when post is displayed. Post title will not be displayed.

Quote post

A quotation. Please place the actual quote (blockquote) directly into post content. To set a quote source use a <cite> HTML tag. Post title will not be displayed.

Status post

A short status update, similar to a Twitter status update. Please place the actual status text directly into post content area. Post title will not be displayed.

Video post

A single video. Please place the [wm_video] shortcode as the first thing in post content. The video description text can follow on next line.

Content: Projects

This custom post type is provided via WebMan Amplifier plugin.

Projects custom post can be used to showcase your work. You can place any content into projects and create stunning complex layouts using Beaver Builder page builder plugin.

Each project can be categorized and tagged and you can use these taxonomies for animated on-page filtering in a dedicated Beaver Builder "Posts (custom posts)" module.

Tip: Display with Beaver Builder

Use "WM Posts (custom posts)" module in Beaver Builder page builder and set the "Post type" option to "Projects".

Tip: Renaming the post type

If you would like to rename this post type, use the Custom Post Type Editor plugin. To rename the custom taxonomies related to this post type, use the Rename Taxonomies plugin.

Tip: Custom posts order

For custom posts order you can use a plugin, such as Intuitive Custom Post Order.

Content: Logos

This custom post type is provided via WebMan Amplifier plugin.

Logos custom post can be used to easily manage your clients and parthers logos.

They can be grouped into categories, so you can create a separate category for clients and separate category for partners (and for others) and then display them on the website individually using dedicated Beaver Builder module.

For each logo you can set up an image, custom link URL, custom link action and assign it to a logo category.

Tip: Display with Beaver Builder

Use "WM Posts (custom posts)" module in Beaver Builder page builder and set the "Post type" option to "Logos".

Tip: Renaming the post type

If you would like to rename this post type, use the Custom Post Type Editor plugin. To rename the custom taxonomies related to this post type, use the Rename Taxonomies plugin.

Tip: Custom posts order

For custom posts order you can use a plugin, such as Intuitive Custom Post Order.

Content: Testimonials

This custom post type is provided via WebMan Amplifier plugin.

Testimonial posts can be used to display reviews you receive from your clients or customers.

Tip: Display with Beaver Builder

Use "WM Testimonials" module in Beaver Builder page builder.

Tip: Renaming the post type

If you would like to rename this post type, use the Custom Post Type Editor plugin. To rename the custom taxonomies related to this post type, use the Rename Taxonomies plugin.

Tip: Custom posts order

For custom posts order you can use a plugin, such as Intuitive Custom Post Order.

Content: Staff

This custom post type is provided via WebMan Amplifier plugin.

With staff custom post you can easily manage your company team info.

This post type provides just short basic information about your team members, however, you can link it to any page/post or external website for more details on the person.

Tip: Display with Beaver Builder

Use "WM Posts (custom posts)" module in Beaver Builder page builder and set the "Post type" option to "Staff".

Tip: Renaming the post type

If you would like to rename this post type, use the Custom Post Type Editor plugin. To rename the custom taxonomies related to this post type, use the Rename Taxonomies plugin.

Tip: Custom posts order

For custom posts order you can use a plugin, such as Intuitive Custom Post Order.

Content: Content Modules

This custom post type is provided via WebMan Amplifier plugin.

Content Modules can be used as a reusable content injection to various website areas. They can be styled as icon boxes, so they are perfect for your services, features or benefits presentation.

For each Content Module you can set up a title, description text, custom link URL, custom link action, featured image and/or font icon.

It is also possible to conveniently group Content Modules using dedicated tags.

Tip: Display with Beaver Builder

Use "WM Content Module" module in Beaver Builder page builder.

Tip: Renaming the post type

If you would like to rename this post type, use the Custom Post Type Editor plugin. To rename the custom taxonomies related to this post type, use the Rename Taxonomies plugin.

Tip: Custom posts order

For custom posts order you can use a plugin, such as Intuitive Custom Post Order.

Menus & Navigation

Navigational menus for your website can be created at Appearance → Menus. They may contain links to pages, categories, custom links or other content. You can specify a custom menu item label, as well as other attributes.

Display menus on your website by assigning them to a predefined theme menu location. The theme defines these menu locations for you:

Primary Menu

This is the main navigation area in the header of the website. The menu can be nested and hierarchically organised.

One page template menu overrides

You can set up a custom menu for "One page" template. This menu will override the main navigation menu for that specific page.

Create a Menu

Follow the instructions in WordPress documentation for how to create a menu.

Tip: Add a post type archive link

You can add any custom post type archive link into your menu:

Adding custom post type archive link to menu.
Adding custom post type archive link to menu.

Megamenu

With built in simple megamenu functionality you can display child menu (sub-menu) items in columns.

Megamenu example preview.
Megamenu example preview.
  1. Set a megamenu class on the parent menu item (1st level menu item).

    Setting up menu item class.
    Setting up menu item class.
  2. Then the 2nd level menu items (first child menu items) become captions for megamenu columns.

  3. Finally, the 3rd level menu items (second child menu items) become actual menu items within your megamenu columns.

Theme Options

Mustang seamlessly integrates its options into live preview customizer. You can set up your site's title, tagline and logo, home and blog page, manage menus and widgets, customize colors, layout, typography and others.

Customizer can be accessed at Appearance → Customize. All the changes you make in Customizer will be immediately displayed in the preview, but they will be made live only after you press the Publish button.

At Appearance → Customize → Theme Options panel you'll find theme-specific options. Check them out to get familiar with theme customization capabilities.

Localization

Every WordPress theme contains some texts that need to be translated into your language if you are building a non-English website. This theme if fully translation ready.

To enable your language in the WordPress website, please switch WordPress into the desired language localization.

Tip: Adding languages into WordPress

Check out tutorial on how to install WordPress in your language.

How to Translate a Theme

Method 1: Using Poedit software

  1. Create a copy of the original mustang/languages/mustang.pot file.

  2. Rename the copied file now: add hyphen followed with your language code locale, and change the file extension to "po".
    (So, the British English file would be named mustang-en_GB.po.)

  3. Use Poedit to translate the file and export (save) translation in "mo" file format.

  4. Upload translated mustang-en_GB.mo file into your WordPress languages directory, into themes folder (such as /wp-content/languages/themes/mustang-en_GB.mo (if the themes folder does not exist in your WordPress languages directory, create it).

Warning: Don't lose your files!

When you update the theme, all custom translation files will be deleted from /wp-content/themes/mustang/languages folder. Do not put your custom translation files into that folder! Basically, you should never modify the actual theme files and folders.

Methos 2: Translating in WordPress admin

If you would like to translate the theme directly in your WordPress dashboard you need to use a specialized plugin. Check out Loco Translate plugin and instructions on how to use it at beginner's guide and technical overview.

Translate Plugins Too!

Your website is built with WordPress system itself, a theme and some plugins.

There is a high chance that WordPress itself is already translated into your language. So, you don't have to translate it on your own. You have also learned how to translate the theme above. But what about plugins and their texts?

If you are lucky, your plugin contains your language translations already and you don't have to do anything. But if you need to translate a plugin, the best advice is to check the plugin's documentation for the best approach.

Alternatively you can also use Loco Translate plugin (again) to translate your plugins directly in your WordPress admin area.

Help With Your Translations

If you would like to help out translating the theme, please contribute your translations at WebMan Design support forum by submitting a ZIP package of your .po and .mo translation files in a new support ticket attachment. Thank you!

Plugins

Recommended plugins | Useful plugins

Why do you need to use plugins when you expected the theme to have all the functionality in it? Well, according to WordPress guidelines and generally the best practice: themes are meant for presentational purpose only, while plugins provide website functionality.

The reason is simple: when you decide to update your website looks you simply change a theme without loosing your website content and additional functionality such as eCommerce or portfolio.

This theme follows this WordPress philosophy and you can rest assured your site is as future-proof as possible. No lock-in effect with WebMan Design themes!

Info: Compatibility

The theme does not need any plugin to work properly. It is coded responsibly and flexibly enough so it should handle any decently coded 3rd party plugin you throw at it.

However, please understand there are thousands of plugins available for WordPress and it is not humanly possible to test them all. Feel free to use your plugin and in case of an issue contact support for help.

Recommended Plugins

Theme provides code and/or design integration for certain plugins. You will find these plugins in recommendations list below. They provide additional functionality for your website or improve your and your visitor's experience.

Please note that these are only recommended, suggested plugins, they are not required for the theme to work. Always read the plugin description before installing a plugin and install only those plugins you will use on your website.

Plugins recommendation page example: Recommended, not required
Plugins recommendation page example: Recommended, not required

Warning: Demo content required plugins

List of plugin the theme recommends may differ from plugins that are required when installing demo content. Check the demo content information for more details.

Here is a list of plugins that were successfully tested with the theme and the theme even provides additional integration layer for them:

Useful Plugins

With this theme you can use whatever plugins you like (check out compatibility info above). Here is a selection of additional useful plugins:

Archive Title
Removes archive page title labels.
Atomic Blocks
Easy to use content blocks library.
Breadcrumbs NavXT
Create a perfect SEO friendly and flexible breadcrumbs navigation.
CoBlocks
Easy to use content blocks library.
Custom Post Type Editor
Allows you to rename any post type.
Customizer Export/Import
Perfect plugin for backing up your theme's customizer settings.
Disable Comments
Disables comments site-wide per post type.
Editor Plus
Extends block editor with additional blocks and functionality.
Imsanity
Automatically downsizes huge images during upload.
Intuitive Custom Post Order
For easier posts (and other post types) order management.
iThemes Security
Enhances your website security.
My Eyes Are Up Here
Helps you control how WordPress crops thumbnails.
Nested Pages
Provides drag and drop interface for managing pages and posts.
Ninja Forms
For creating forms.
Page Links To
Allows you to redirect a post or a page to a custom URL.
Polylang
Easy to use plugin for creating multilingual websites.
Post Type Archive Descriptions
Manages description (displayed on archive pages) for any post type.
Rename Taxonomies
Allows to rename taxonomies, such as "Tags" to "Topics", for example.
WP Featherlight
Image lightbox (zooming) plugin that just works.
WPForms
For creating forms.

FAQ & Tips

  1. Why are uploaded images blurry or small
  2. How to modify element appearance
  3. SEO - Search Engine Optimization
  4. How to speed up a website
  5. How to add custom CSS
  1. Why are uploaded images blurry or small

    The theme requires certain minimal image dimensions for optimal display. Info about recommended image size setup can be found at Settings → Media.

    Tip: Regenerate images

    Once you set correct image sizes, all your newly uploaded images will get processed with new settings. But for the images already uploaded to your website you need to use additional plugin to refresh their sizes. Regenerate Thumbnails plugin (or similar) will do the trick.

    Tip: File size optimization

    It is recommended to use an image optimization plugin to keep the file size of images uploaded to your server under control.

    ↑ Back to questions list

  2. How to modify element appearance

    As you can apply a custom CSS classes almost on all shortcodes used by the theme, there are some special classes that will style the content for you or add a specific layout. You can use these predefined CSS classes (plus you can easily define your own ones):

    Selecting custom predefined CSS class easily in Beaver Builder page builder
    Selecting custom predefined CSS class easily in Beaver Builder page builder
    CSS3 Animation classes
    The theme applies CSS3 animation of Animate.css library. Please apply these animation with animation- class prefix (so, the full class would look like animation-ANYMATION_TYPE). This way the animation will be applied only when the element becomes visible on the screen. Example: animation-sectionFlip.
    Frame classes:
    frame, frame-items
    Applies a border and a small padding around the item or items. With multi item shortcodes please apply the frame-items class on the shortcode itself to style its items (like posts or, testimonials, for example).
    Shadow classes:
    drop-shadow, drop-shadow-items, inner-shadow, inner-shadow-items, bottom-shadow, bottom-shadow-items
    Applies different kind of shadows on item or items. With multi item shortcodes please apply the SHADOW-items class on the shortcode itself to style its items (like posts or, testimonials, for example).
    Text classes:
    uppercase
    Make the text uppercase.
    Text align classes:
    text-left, text-center, text-right, mobile-text-left, mobile-text-right
    Align the text with these classes. If you apply mobile classes, you can control the text alignment on both desktops and mobiles.
    Apply on posts lists shortcodes:
    masonry
    Enables masonry layout on Content Modules, Posts or Testimonial shortcodes.
    Apply on Content Modules:
    text-center, small-icons, no-icon-background
    These classes are useful for icon modules: text-center will apply centered layout on content module with icon above the module text. small-icons make the content module icon smaller. no-icon-background will remove the background from the content module icon.
    Apply on tabs:
    center-tabs
    Use on top tabs to center them out.
    Apply on testimonials:
    text-center
    Creates large text-centered testimonials.
    Apply on widget areas:
    widget-columns
    Puts the widgets in the widget area in a row.

    ↑ Back to questions list

  3. SEO - Search Engine Optimization

    This theme is coded semantically, with best SEO practices in mind.

    You can push your SEO performance even further with help of additional plugins such as Yoast SEO. You can also integrate support for microformats with a plugin such as Schema.

    ↑ Back to questions list

  4. How to speed up a website

    Having a performant website is a must. It makes your website more SEO friendly and most importantly pleasing for your visitors, more accessible. This theme was coded with performance in mind but we can always take things even further:

    Use a good host

    A good hosting for your website is very important choice you can make towards a speedy website. Depending on your location it is also advised to use a host that has servers in your country or at least on the same continent.

    Check out Siteground (a very good personal experience), WP Engine, Pagely or WordPress.com Business plan. You can also have a look at WordPress hosting recommendation page.

    Optimize your images, video and audio files

    You should always keep the file size of your images, video, audio and other assets on your website as low as possible. Prepare images before you upload them to your website: compress them, reduce their dimensions, maybe even crop them. Use plugins to optimize further more such as Imsanity or Smush.

    In case of video and audio files set the optimal compression and formats before uploading them to your site. Consider also using services such as Vimeo, YouTube or SoundCloud to host your files off your servers.

    Also consider using a CDN service, such as CloudFlare.

    Enable caching

    A basic browser caching and GZIP compression is a must!

    But you will get better results using a dedicated solutions such as WP Rocket or WP Super Cache or SiteGround Optimizer. Or maybe your hosting provider applies some sort of caching already? Check with them.

    Warning: Minify & combine

    Your caching solution may provide CSS and JS files minification and combination. Be cautious though: these are complex processes which may cause errors on your website. Test thoroughly!

    Tip: Measure performance

    For measuring your website performance and tips on how to improve it use services such as GTmetrix, Pingdom Tools and WebPageTest.

    ↑ Back to questions list

  5. How to add custom CSS

    Add your custom CSS code into Appearance → Customize → Additional CSS, or alternatively into your child theme's style.css file.

    ↑ Back to questions list

Modifications

Use a Child Theme

Warning: Limited support help!

Please understand that a very limited support is provided for theme modifications. Responsibility for a code lies on shoulders of the code author. If you don't feel comfortable coding consider hiring help.

If you need to make styling or functional changes to the theme, use WordPress native child theming functionality. This way you can update the parent (original) Mustang theme without worrying your code would get overwritten and lost. All your custom code is kept safe in your child theme.

Read more about child themes in WordPress documentation.

Custom CSS styles code

Put your custom CSS code into CHILD_THEME_FOLDER/style.css file. Alternatively use Appearance → Customize → Additional CSS for that.

Custom PHP code

If you want to change Mustang theme's functionality, do so in CHILD_THEME_FOLDER/functions.php file. You can freely modify any theme functionality via that file by hooking onto a specific filter or action Mustang theme provides.

Sample child theme

Download a free child theme from WebMan Design GitHub repository. Don't forget to check the information in the repository for how to configure a child theme for your needs.

Grab a sample child theme from repository now →

Tip: Theme from Envato Market?

If you've obtained the theme from Envato Market, there is a high chance that a dedicated child theme is already included in the package you've downloaded from the marketplace :)

Hooks: Actions and Filters

Warning: Limited support help!

This topic is meant for WordPress developers who would like to modify the theme and alter or expand its functionality. Please understand that we do not provide support for custom theme modifications, though.

The theme is coded following WordPress coding standards and provides action and filter hooks for you, which can alter any functionality of the theme.

Please check the theme's source code for hook references (simply search for do_action and/or apply_filters), or contact support for help.

Mustang theme uses Theme Hook Alliance hooks too. This is useful to entirely rebuild the theme structure or add your own sections anywhere.

Tip: Display available hooks

To show all theme hooks you may try using Simply Show Hooks plugin or WP Inspect plugin.