Transcargo Documentation

Introduction

Transcargo - Transportation and Logistics Business WP Theme

A short guide and general information to help you get to know your new theme.

Above all, We would like to thank you for purchasing this theme, your contribution is very much appreciated.


This document covers the installation and use of this theme and reveals answers to common problems and issues - We encourage you to read this document thoroughly if you are experiencing any difficulties. If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum.

Getting Started

Installation of the theme

Installation of the theme

To install this theme you must have a working version of WordPress already installed. For information regarding the installing of the WordPress platform, please see the WordPress Codex - http://codex.wordpress.org/Installing_WordPress

Installation

When you are ready to install a theme, you must first upload the theme files and then activate the theme itself. The theme files can be uploaded in two ways:
FTP Upload - Using your FTP client, upload the non-zipped theme folder into the /wp-content/themes/ folder on your server
WordPress Upload - Navigate to Appearance -> Add New Themes -> Upload. Go to browse, and select the zipped theme folder. Hit “Install Now” and the theme will be uploaded and installed.
Some webservers have a limitation for the maximum allowed size of files being uploaded to them and that value may be exceeded by the theme file. If that is the case you can receive an error that states: The uploaded file exceeds the upload_max_filesize directive in php.ini. or Are you sure you want to do this? Please try again. If you get any of these errors please increase the values of upload_max_filesize and post_max_size directives in your php.ini file to 20M or follow the Installation via FTP section described above.
Once the theme is uploaded, you need to activate it. Go to Appearance -> Themes and activate your chosen theme.
After that you need to activate the pre-installed plugins:
1. WPBakery Visual Composer
2. STM Post Type
3. Breadcrumb NavX
4. Revolution Slider
5. Contact Form 7
6. MailChimp for WordPress Lite
7. Recent Tweets Widget
8. STM Custom Icons
9. STM Importer
All the plugins which are not free come under our EXTENDED License, so you don’t need to pay for their license to use them. Some of them might have messages requiring activation, but they are already activated on our side. No purchase code needed. When using them under our license you will need to wait for the plugin updates in our regular theme updates. If you want to be able to auto update them from wp-admin, you will need to buy your own personal license for that.
Also you can update included plugins via upgrading the theme. We include latest versions of plugins in every update of the theme.
Here you can see video tutorial of Installation the theme:

Activate the theme and Import the demo content

Activate the theme and Import the demo content

After completing installation of the theme, you need to activate your product under Transcargo -> Product registration following these instructions:

1. Click on this Generate A Personal Token link. IMPORTANT: You must be logged into the same Themeforest account that purchased Motors. If you are logged in already, look in the top menu bar to ensure it is the right account. If you are not logged in, you will be directed to login then directed back to the Create A Token Page.

2. Enter a name for your token, then check the boxes for View Your Envato Account Username, Download Your Purchased Items, Verify Purchases You've Made and List Purchases You've Made from the permissions needed section. Check the box to agree to the terms and conditions, then click the Create Token button.

3. A new page will load with a token number in a box. Copy the token number then come back to this registration page and paste it into the field below and click the Submit button.

4. You will see a green check mark for success, or a failure message if something went wrong. If it failed, please make sure you followed the steps above correctly.
Then you can install included plugins under Transcargo -> Plugins (if you have not installed them).
After this you install the demo content under Transcargo -> Demo Import:
Please note: Most of images replaced with a placeholder image because of licensing. Also demo content doesn’t include WP options and widgets, so you need to create them manually via Appearance -> Widgets.

What if the Import fails or stalls?

If the import stalls and fails to respond after a few minutes You are suffering from PHP configuration limits that are set too low to complete the process. You should contact your hosting provider and ask them to increase those limits to a minimum as follows:
  • max_execution_time 600
  • memory_limit 128M
  • post_max_size 32M
  • upload_max_filesize 32M
You can verify your PHP configuration limits by installing a simple plugin found here: http://wordpress.org/extend/plugins/wordpress-php-info. And you can also check your PHP error logs to see the exact error being returned.

Setting up the Homepage

Setting up the Homepage

To set up the homepage you must create a new page, you can do so by navigating to Pages > Add New. The title for this page can be up to your liking. Under Settings -> Reading or Appearance -> Customize -> Site Settings -> Static Front Page please setup the new Homepage.
Actually you can set any page to be your homepage. Once it’s created you can compose your homepage layout. The design layout is created under Bootstrap framework which is split into 12 columns grid. Each widget has its own maximum and minimum widths, so depending on that you can work out the layout for each page.
As you can see the homepage just like any the page is now 100% constructible out of the modules we have in Visual Composer. The homepage can be created by any element in Visual Composer. To view the short manual on how to use the Visual Composer, please follow this link:
http://codecanyon.net/item/visual-composer-page-builder-for-wordpress/full_screen_preview/242431
The detailed documentation of Visual Composer can be found here also - http://vc.wpbakery.com/video-tutorials/

Theme Features

Theme Customization

Theme Customization

WordPress Customize allows you to setup the general styling of the website visually. In WordPress menu go to Appearance > Customize. Here you can setup most important options of your theme.
Site Settings:
  • Static Front Page: You can select default Front and Blog pages here.
  • Logo & Title: You can setup basic site options like: Site title, Tagline, Logo & its dimensions and Favicon.
  • Style & Settings: set your custom colors, enable/disable Boxed version and show/hide .
Header:
  • Top Bar: Here you can enable/disable Top Bar & WPML Switcher and add your company office addresses, contact information and working hours.
  • Header Appearance: You can enable/disable Header Search form & Sticky menu and select one of the basic header styles.
Archive Pages: Choose archive pages layout, sidebar and its position.
Footer:
  • Layout: Here you can change the footer logo & its dimensions, the copyright text and split the footer into widgets. Also specify the number of widget areas.
  • Footer Socials: Here you can select displayable social icons.
Post Types: You can setup/change Title, Plural Title, Rewrite URL and Icon for custom post types
Typography: Set up the fonts out of free google fonts. Besides this you can setup font weight, font size and line height also.
Socials: You can add your company social URLs here.
Custom CSS: Here you can add your custom styles.
Menus: You can add/edit menus here
Widgets: You can set up the widgets into the precreated areas. You can do the same later Appearance > Widgets.

Footer area setup

Footer area setup

The footer is the same on all pages. You can see whole options via Appearance -> Customize -> Footer.
Here you can set up:
  • Footer logo and its dimensions;
  • Count of additional Widget Areas;
  • Footer Text;
  • Copyright;
Also you can set other areas up on the Widgets page (Appearance > Widgets) and choose from the suggested widgets. Please see the attached screenshot.
PS: Please note the Demo Content doesn’t contain these widgets. So they need to be added manually.

How to set up the sidebar

How to set up the sidebar

In this theme we paid special attention to Sidebars for your biggest convenience and on multiple previous requests.
We have two types of sidebar: right sidebar and left sidebar, which can be selected for both of archive and single posts/pages.
In addition to that, you can add/create a new sidebar with VC Widgets/Elements, in this case you will need to go here:
Edit or create a new sidebar, and add any sections you need by means of Visual Composer
For archive pages you can set sidebar options up via Appearance -> Customize -> Archive pages
For single pages/posts you can add sidebar via Widgetised Sidebar or STM Sidebar VC element

Adding Images to Revolution slider

Adding Images to Revolution slider

You will need to upload various images to the Layer slider. You can add items from Revolution Slider plugin in the WordPress backend. When you go there first you need to create the new Slider, and add new slides.
More detailed manual you can find here - http://www.themepunch.com/revslider-doc/slider-revolution-documentation/.

Menus

Menus

There are two navigations on the site – Header menu and Footer menu, so you can adjust them under Appearance -> Menus
This is standard Wordpress functionality, you can choose from the pages, post categories, or custom links.

Adding Custom Icons

Adding Custom Icons

Apart from Theme and Visual Composer Icons you can include your own Icons in your site. Firstly it needs to generate fonts of your custom icons. You can do it via uploading your ready .SVG and generating fonts here - https://icomoon.io/app/
Then you can upload your fonts .zip archive file (which you have downloaded from IcoMoon) via Appearance -> STM Icon Manager -> Upload New Icons.

Localization

Localization

You can change your site main language via Settings -> General -> Site Language
Before adding translations for static strings it needs to rename language files correctly according your site languages. Theme language files are located in a ../transcargo/languages/ folder. You can find a list of language codes at WordPress in your Language. As an example, the language code for English is en_EN, so you would save the translated files as en_EN.po first, then en_EN.mo.
There are several ways to fill up translations. One of them if using PoEdit platform. You can add translation via editing your .po file and at the end PoEdit generates .mo file for you. Then you needs to upload ready translation files to primordial folder (../transcargo/languages/).
Another way is to use a localization plugin like: Loco Translate

Content

Setting up Content Pages and Posts

Setting up Content Pages and Posts

All pages can be created as simple content pages or built by means of Visual Composer page builder. You will need to first set up the page and then add and set up content blocks. Just add a row and add the modules to row from the Visual Composer dashboard.
Now you can choose how to compose your template. Add Content modules, Testimonials, etc. You have everything to realize your imagination.
We have also included extension packages for Visual Composer. You can use them free.
Just pick the module you like and add it to the row. Then you can edit it.
You can also edit the row background, add video or parallax images to the background. Just click on Row edit icon and you will see the options & features, which are available for this row.
Custom added shortcodes in our theme are on a separate tab:
Besides this, each page contains these options which include header color or background image, title fonts and colors, breadcrumbs and button settings:

Blog page

Blog page

TThe Blog page is a usual blog, formed from the posts which belong to categories created by you, which have tags and featured images that show in the post listings on the blog page. You can set a page as a Blog posts archive page via Appearance -> Customize -> Site Settings -> Static Front Page:
The blog page can have the sidebar on the left, right or no sidebar, and the contents of the sidebar, as described above, are set under the Appearance -> Widgets. Other settings of this archive page you can setup via Appearance -> Customize -> Archive pages:
Blogs can be posted by someone who has the access to the backend of the site with admin or author role. Anyway that person will be able to log into the WordPress panel and have a user profile.
Default blog layout is grid layout and once you set up an empty page in the theme setting where it is said blog, it will show posts in grid layout.
If you want to have List layout, you will need to create a page and set a template for it named Blog-list.

Services

Services

There is a custom post type to describe a service your company offer via any element visual composer offers you:
Also you can add Services as a Grid or Carousel for any page using custom STM VC elements:

Testimonials

Testimonials

In order that you could create testimonials in one place and then use all over the site, just inserting a VC element, we have created custom posts.
Each testimonial is a simple post:

Gallery page

Gallery page

Galleries are created as another custom post type called Testimonials. It has Categories that can be ordered as needed. Here you create just single gallery photo.
You can add an Image, Title and Category(es) for each Gallery post.
So basically, you create an individual post describing for each photo in your gallery. After that you go to the Pages > Add new.
On the new page you should insert Gallery shortcode from Visual Composer.
After that you can have options go make your gallery view Masonry or Standard grid (by default) and select Columns:

Vacancies

Vacancies

Again we have used a custom post type to describe vacancies of your company. There are extra fields for a vacancy (Information) apart from any element visual composer offers you:
In order to display all vacancies in any page you need to add Vacancies STM VC shortcode:

Staff and Team page

Staff and Team page

You can add your company staff and their additional information via Staff menu:
There are two view types how to display your company Team: List and Grid. You can add Staff List VC element in a page and set its options up:
Again, thank you for purchasing this theme!
If you have any questions that are beyond the scope of this document, feel free to pose them in the dedicated support forum at www.stylemixthemes.com