Introduction

Thank you for purchasing our product! We are very glad that you have decided on our Saab WordPress Theme.

This documentation will help you to set up and use the Saab WordPress Theme. The theme is very easy to use and we are here to guide and help you, so please read and follow the documentation, if there are some other issues you want to discuss then do not hesitate to contact us on support@teslathemes.com. This documentation is more of a reference work if you do not know what to do, or if you are not familiar to WordPress.

Please read the following very carefully as it will help you set the theme up, we have gone through the setup process multiple times and provided the best possible instructions.

We strongly recommend you to use a fresh install of WordPress and integrate your content into the pages according to the documentation. Of course, you can try to implement the theme into your current WordPress, but we will not provide in-depth support for it. The theme has specific settings that may conflict with your current setup of categories, plugins, javascript use, and more.

We wish you good luck in your work with Saab WordPress Theme, and of course we would love to see your website and what you come up with by using this theme.

The theme is very easy to use and we are here to guide and help you, so please read and follow the instructions and if you have further questions write us a email support@teslathemes.com. This documentation is more of a reference work if you do not know what to do and need a better understanding on how the template is built write us an email.

Note: You can click on small images to zoom in and then move the mouse to the position you need.

Browser and Devices support

Since Saab is built on Bootstrap 3 framework, it supports the same browsers as Bootstrap.

This template is responsive and should look fine on all standard mobile devices.

browsers

Installing WordPress

To start working with Saab you need to have WordPress installed on your server (local,dev or production)

Step 1: Download and Extract

Download and unzip the WordPress package from Download Wordpress.

Step 2: Upload

Copy the extracted contents of wordpress zip to the corresponding path of the server. Make sure WP has permissions to write the folder it is located in.

Now when accessing the corresponding URL you should see the following message:

Wp first

Step 3: Edit the Configuration File

Auto Mode: After clicking on "Create a configuration file" then "Let's Go" you will get the configuration page:

Establishing a connection

If the information is correct and everything works fine you will receive:

Successful

If it's successful then skip the "Manual Mode" if not, follow the instructions bellow.

Manual Mode: You can either rename the file wp-config-sample.php to wp-config.php on your local machine or on you server (you'll still need to tell WordPress your database information).

Open wp-config.php with a txt editor and enter your database information under the section labeled:

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define('DB_NAME', 'wordpress');

/** MySQL database username */
define('DB_USER', 'root');

/** MySQL database password */
define('DB_PASSWORD', 'root');

/** MySQL hostname */
define('DB_HOST', 'localhost');

/** Database Charset to use in creating database tables. */
define('DB_CHARSET', 'utf8');

/** The Database Collate type. Don't change this if in doubt. */
define('DB_COLLATE', '');

After the information is edited upload the file to the server.

Step 4: Site name and login data

If it's all sparky then you click Run the Install and fill all the lines shown bellow:

Login Information

This being the last step you will see a success message.

Success

Click Log in and now you can proceed to you site. Now you can go to installing your Saab WordPress Theme.

Installing Theme

To install the Saab WordPress Theme you will need WordPress v3.6 or newer.

Option A

Follow the steps and upload the Theme's installation zip file through the WordPress admin backend:

  1. Download the theme archive, Saab.zip
  2. Unzip the theme archive
  3. Find the installation file, Saab.installation.zip
  4. Go to your WP admin – Appearance – Themes – Add New – Upload Theme – Choose file
  5. Upload the Saab.installation.zip file.

upload

Then, when prompted activate the theme.

Note: If you can't get passed the file upload limit and/or if you get an error message mentioning exhausted memory size or something in those lines, you could try to increase that limit by adding to the "wp-config.php" the following line of code:

define('WP_MEMORY_LIMIT', '64M');

Option B

Uploading directly to the Server:

  1. Download the theme archive, Saab.zip
  2. Unzip the theme archive
  3. Find the installation folder, Saab
  4. Connect to your server via FTP or any other way that will allow you to explore and upload files directly.
  5. Navigate to your WP Installation Folder/wp-content/themes/
  6. Upload the Saab folder here.

If everything went well in Option A or B, the theme should appear under Appearance → Themes like shown below:

cover

Then, when prompted activate the theme. Or go to Appearance->Themes and press the Activate button next to the theme.

Now you are ready to customize your theme.

Blog & Front Pages

Create a page that will serve as homepage - In wordpress admin panel under Pages → Add New, name it for example "Front Page Default". Also, select "Home" as the template used by the page.

Create a page that will serve as the archive page of blog posts - In wordpress admin panel under Pages → Add New, name it for example "Blog". Make sure that the permalink slug is "blog" only. Also, select "Default Template" as the template used by the page.

Set the front page to display as a static page: - Go to Settings → Reading → A static page (select below) → Front page: → Choose your page from the drop-down menu.

Choose your posts page from the drop-down menu. It should be the "Blog" page we have just created.

Your page should look something like:

home page

Tesla Framework

FW tour

All our themes are powered by Tesla Framework ( Tesla Framework Tour ), a powerful administration tool that comprises all our great features and allows you to easily customize the look and functionality of your theme, without advanced knowledge of programming. It gives you the possibility to customize and manage your theme settings from a dedicated area within your Wordpress Admin. Tesla Framework works smoothly, is intuitive and easy to use, once you install one of our themes you will be able to personalize its logo, site background and color, SEO options, social media networks and more; all from one place.

Our Framework is in continuous development and improvement process, we are working hard to provide you an easy administration tool, and we're guided by the latest UX trends and new technologies.

To personalize your theme you need to follow the instructions below.

Note: Options will vary from theme to theme depending on their features.

General Settings

Use these settings to customize the logo,favicon and insert custom css.

General Options

Site Colors

Use these settings to change available theme colors and background image.

Site colors

SEO & Socials

Choose what social share platforms to be used on single post pages and in footer/header. Also you can insert a tracking code that will be appended in the body of your website.

SEO Social

Additional Options

This section of the framework differs the most from theme to theme. Most of the settings have descriptions or are pretty self explanatory, so please try to play with them before asking for support :) .

Additional Options

Here is an example on the Saab's 404 error page with the colors corresponding to the image above.

Note: You can enhace your "Page Title" and "404 Message" using HTML tags.

Error 404 Saab

Here is an example of Related Posts from the Blog Page with the colors corresponding to the image above.

Related Posts Saab

Here is an example of Header Banner from the Blog with the colors corresponding to the image above.

Header Banner Saab

Here is an example of informative text for the Blog section with the colors corresponding to the image above.

Layout

Here is an example of DropDown Menu from the Blog with the colors corresponding to the image above.

Dropdown Menu Saab

Note: You can specify another page to be parrent for "dropdown-menu" by inserting "dropbox" into it's "Title Attribute"

Dropdown Menu Saab

Here is an example of Recent Posts from the Footer with colors coresponding to the image above.

Footer Recent Posts

Here is an example of Copyright Message from the Footer.

Copyright Message Saab

Typography

On this tab you can pick a color,font and size for text from different sections of the theme.

Typography Info

Subscription

If you use the subscribe for on your project, all incoming data will be showed in thie section.

On this tab you can view / export / clear the list of subscribers. This will work only if you use our subscription widget / shortcode / template.

Subscribers Info

Contact Info

These options tweak your Contact page ( the one using either contact template or contact shortcode.

Contact Info

The options left blank will not appear.

Export/Import Options

To clear, export, import options for the settings explained above, go to WP Admin -> Tesla Theme -> Export/Import Options.

Export/Import Options

Clear Options: Restores all the inputs to default values. You will lose all customization made in the theme options tabs.

Import Demo Options: Imports the options predefined by our developers as seen on demo page.

Note: Importing demo options will not make your website look entirely as on our demo. You still need to import demo content and use specific plugins and widgets if theme requires so.

Export Options: Saves the current options to a file. This file can be later used to import options as described below. Useful when migrating to a new server.

Import Options: Loads options from an earlier exported file.

Warning ! Importing or clearing options will erase your theme current settings from Tesla Theme page . Make sure you make a backup first by "Exporting Options".

Import Demo Content

To import the content that is used on our demo page, go to WP Admin -> Tesla Theme -> Import Demo.

Import Demo

Warning ! Importing Demo Content will add posts and media files to your wordpress. It is not recommended to do it if you already have your own content. It would be better if you back up your data before importing the demo content.

Some error may happen due to permissions or repeating media. If the final message is green and successful just ignore them. If it fails or takes longer than 15 min to load please contact our support team and send the WP + FTP credentials.

Theme Updates

Warning ! You will lose all the customizations made in the parent theme if you make this update. Make sure that you work with Child Theme to keep the customizations during updates.

Wordpress will check for updates each hour and our themes will be displayed on the WP's updates page automatically.

To check for updates manually go to WP Admin -> Tesla Theme and at the top click on the Check Updates button. If there are updates, the newest version will be displayed and the "Go to updates page" button will appear, clicking on it will lead you to the Wordpress' updates page.

Theme Updates

Note: Click on View Changelog before updating to see what has been added or changed.

Select the checkbox next to the Tesla Theme and then click on Update Themes

Theme Updates 2

If you get any errors during this process please be sure that WP has permission to write in /wp-content folder.

Contact Form Builder

This feature is not available on all themes.

Tesla Contact Form Builder is meant to give the user as much customizability over the view of the contact forms in the theme as the layout permits.

To create the form go to Forms menu and start building in the first form by default created for you.

Insert an id, email receiver and choose the location where the form should appear (or leave it blank to use the form in a shortcode or widget).

Form Builder

The form will appear automatically in a predefined Location that was choosed in the builder.

Theme Updates 2

Blog Layout

This feature is not available on all themes.

Tesla Contact Form Builder is meant to give the user as much customizability over the view of the contact forms in the theme as the layout permits.

To create the form go to Forms menu and start building in the first form by default created for you.

Insert an id, email receiver and choose the location where the form should appear (or leave it blank to use the form in a shortcode or widget).

Form Builder

The form will appear automatically in a predefined Location that was choosed in the builder.

Theme Updates 2

Custom Posts & Shortcodes

Custom Posts

To ease the process of creating a website our TeslaFramework combines Theme Options, Custom Posts, Shortcodes and Templates.

Most of the custom posts are linked with a shortcode that you can use on any page. Some will need a specific page template to be called on. Others have their own placement and will be used as content for static locations.

The best way to understand and start working with our custom posts and shortcodes is to Import Demo Content and modify it.

Next we will explain each custom post in part. It's parameters and limitations of use. But don't be afraid to experiment.

Note: In the following screens, the colors from WP Admin match the generated content on the frontend.

Home Slider

[main_slider number="3"] shortcode generates Home Slider section as show below:

Home Slider Demo

Saab Home Main Slider

Latest Posts

[latest_posts title="Newest Posts" description="Newest" number=""] shortcode generates Latest Posts section as show below:

shortcode uses the following attributes:

title="Newest Posts": add the title for Newest Posts section
description="Newest": add the description for Newest Posts section
number="4": the max number of posts per slide

Latest Posts

[featured_posts number="3" categories="Design, Travel"] shortcode generates Latest Featured Posts section as show below:

shortcode uses the following attributes:

categories="": displays posts from specific categories
number="3": the number of displayed featured posts

Featured Posts

Statistics Counter

[statistics title="Interesting info" description="Statistics"]...[counter][counter]...[/statistics] shortcode includes required shortcode: [counter] and generates Statistic Counters as show below:

shortcode uses the following attributes:

title="Interesting info": add the title for Statistics section
description="Statistics": add the description for Statistics section

[counter title="Posts here" number="259" icon="fa-file-text-o"]

shortcode uses the following attributes:

title="Posts here": add the title for certain Counter
number="229": indicates the counter value
icon="fa-file-text-o": shows counter icon, availble values for counter icons: fa-file-text-o, fa-users, fa-bookmark-o, fa-clock-o

Statistics Counter

Blockquote

[blockquote author="Joe Doe" date="03 November"]...[/blockquote] shortcode generates blockquote as show below:

shortcode uses the following attributes:

author="": displays the blockquote author
date="3":displays the date of blockquote

Blockquote

Page Slider

[page_slider]...[slide][slide]...[/page_slider]

shortcode includes required shortcode: [slide] and generates page slider as show below:

[slide title="Tour to New York" url="http://localhost/saab/wp-content/uploads/2015/01/main-page-article-3.jpg" ]

shortcode uses the following attributes:

title="Tour to New York": add the title for Slide
url="": add the image url for slide

Page Slider

Video Slider

[video_posts title="Video Posts" description="Newest"] shortcode generates video slider as show below:

shortcode uses the following attributes:

title="Video Posts": add the title for Slider Video
description="Newest": add the description for Slider Video

Video Slider

Cite

[cite]...[/cite] shortcode generates cite as show below:

shortcode has no attributes:

Cite

List

[list]...[/list] shortcode generates list as show below:

shortcode has no attributes:

List

Image

[image url="http://localhost/saab/wp-content/uploads/2015/02/main-post-3.jpg"] shortcode generates image as show below:

shortcode uses the following attributes:

url="": add the url to image

Image

About Header

[about_header title="Hello" description="Learn more about me" buy_title="Buy" buy_url="http://localhost/saab/contact" background="http://localhost/saab/wp-content/uploads/2015/01/about-page-cover.jpg"]...[/about_header] shortcode generates header for About page as show below:

shortcode uses the following attributes:

title="Hello": add the title for About page
description="Learn more about me": add the description for About page
buy_title="": add the title for Buy Button
buy_url="": add the link for Buy Button
background="": add the url to background image (sets the background for About page Header )

About Header

Hot News

[hotnews title="Hot news" description="Most popular posts" nr_posts="4"] shortcode generates hot news displayed in Dropdown menu as show below:

shortcode uses the following attributes:

description="Most popular posts": add the description for Hot News
nr_posts="": the number of displayed news in Dropdown Menu

Hot News

Page Templates

Templates

This easy to use WP feature will help you create fancy layouts with 2 clicks. When adding a page you can choose from different templates:

  • Home
  • About
  • Contacts
  • Page
Note: Some page templates may require additional configuration from custom posts and theme options pages.

Page and Post Settings

You can set the following settings for page or blog post as shown above:

  • To choose the Label for Latest News in Slider

Posts Settings

Posts Settings View

Widgets

Saab has 6 custom widgets:

  • [TeslaThemes] ABOUT AUTHOR
  • [TeslaThemes] FLICKR
  • [TeslaThemes] LATEST NEWS
  • [TeslaThemes] LATEST VIDEO
  • [TeslaThemes] MOST VIEWED POSTS
  • [TeslaThemes] CONTACT INFO
  • [TeslaThemes] SOCIAL ICONS


Widget ABOUT AUTHOR

About Author

Widget FLICKR

Widget Flickr

Widget LATEST NEWS

Latest News

Widget LATEST VIDEO

Latest Video

Widget MOST VIEWED POSTS

Most Viewed

Widget CONTACT INFO

Contact Info

Note: For properly working widget, please follow the steps below and fill in the information.

Contact Info

Widget SOCIAL ICONS

Social Icons

Note: For properly working widget, please follow the steps below and fill in the information.

Social Info

To place them , go to WP Admin -> Appearance -> Widgets and drag the widgets in the footer/sidebar area, filling the options provided.

Social Info

Note: Some Widgets may require additional configuration from custom posts and theme options pages.