Cargo - Transport and Logistics WordPress Theme

Contents

1. How to change the header and edit other Single pages of Portfolio items settings?

2. Missing style sheet error when installing the theme

3. How to place more than one marker on the map?

4. How to translate theme?

5. Is there some way I can see all the icons of the theme?

6. Where is my Purchase Code?

7. How to leave a review?

8. Installing Demo Content

9. How to add new Font icons?

10. How to create One page

11. How to change the Excerpt text?

12. How to make a page load with accordion items closed by default

13. How to increase the size of the logo?

14. How to add new icon?

15. I have purchased your theme. Now what?

16. Missing Google API key - Google Map

17. "404 Page not found" error on inner pages

18. How to update installed theme? Will it change data?

19. SVG Image format

20. How to add custom icon font to the theme

21. How to hide hover image effect?

22. I want to use a child theme. How can I do that?

23. Embed code I have placed using text element is being cut off. It does not have the proper height. How can I resolve this?

24. How to ask for a refund?

25. How to edit 404 page?

1. How to change the header and edit other Single pages of Portfolio items settings?

All single portfolio items inherit the settings from their template page. In order to edit excerpt text and header background image, please locate this page on All Pages list, and proceed to follow instructions from our article.


In order for this page to work as a template page for single portfolio items, make sure to add its slug to Settings Page Slug field in Appearance >Customize >Portfolio panel.

                                                        




For more info and detailed instructions please refer to our Online Theme Documentation.

2. Missing style sheet error when installing the theme

A common issue that can occur with users new to installing WordPress themes is a "Broken theme and/or stylesheets missing” error message being displayed when trying to upload or activate the theme. This error message does not mean that the theme you have purchased is broken, it simply means it has been uploaded incorrectly.

You have 2 options for downloading your theme:


Please use Installable WordPress file only archive in the process of Theme installation:

  1. Log in to your WordPress admin area.
  2. Browse to Appearance > Themes.
  3. Click on ‘Add New’.
  4. Click ‘Upload Theme’.
  5. Browse and select the theme zip file to upload, then click 'Install Now' button.


Check our video tutorial how to install theme and import demo content.

Don't forget to subscribe to our YouTube channel!


For more info and detailed instructions please refer to our Online Theme Documentation.

3. How to place more than one marker on the map?

Currently Cargo's map element does not support multiple markers. You need to customize Cargo's plugin a bit to achieve this. Please edit bt_gmap.js in your Cargo plugin's folder (usually /wp-content/plugins/cargo/) and find the following statements:

var marker = new google.maps.Marker({
position: myLatLng,
map: map,
icon: icon
});

In order to add another marker please add the following just below the referenced statements:

var myLatLng = new google.maps.LatLng( 41.7144678, -75.015827 );
var marker = new google.maps.Marker({
position: myLatLng,
map: map,
icon: icon
});

where 41.7144678 and -75.015827 are latitude and longitude. Please adjust them according to your needs.

For additional markers just repeat the procedure above.

4. How to translate theme?

In order to translate the theme, please follow the next steps:

Theme's .pot file is located in /wp-content/themes/your-theme-name/languages folder.

Please use PoEdit - https://poedit.net/ to translate the .pot file and create respective .po and .mo files.

Please name .po and .mo files e.g. potname-nl_NL.po and potname-nl_NL.mo (nl_NL is the language code for dutch and potname is the name of the .pot file you have started from - it corresponds to text domain of the theme). For other languages' codes, please refer to the following link: Internationalization.

In order to place .po and .mo files properly and not have them deleted when you update the theme, upload  them to \wp-content\languages\themes folder. If you don’t have languages folder in your wp-content directory, please proceed and create one. Then create themes folder, and paste the files in it.

Alternatively, you can upload the .po and .mo files to your theme's /wp-content/themes/your-theme-name/languages folder. In that case name them only using the language code (for example nl_NL.mo and nl_NL.po)

Also make sure to translate the theme's plugin .pot file, located in \wp-content\plugins\your-theme-name\languages folder. 

The steps are the same as for the theme, except the files should be named bt_plugin-nl_NL.po and bt_plugin-nl_NL.mo (with appropriate language code).

For plugin’s .po and .mo files, you should place them in \wp-content\languages\plugins folder.

You can set the site language of your WordPress installation on Settings > General. WordPress will automatically use the right language files if they exist. 

5. Is there some way I can see all the icons of the theme?

We use three different sets of icons in the theme: Font AwesomeStroke 7 and Custom Icons.

Please refer to these links for preview of each icon set.

6. Where is my Purchase Code?

If you are having some troubles finding your Purchase Code, please have a look at the following article: Envato Market Help - Where Is My Purchase Code?

7. How to leave a review?

If you are satisfied with our support or you like our product, please consider supporting us by giving us a rating at the downloads section of your ThemeForest profile (just below the download button) - http://themeforest.net/downloads

When leaving a review, we encourage you to:

You can find more information on reviews in official Envato article.

Thanks a lot in advance! :)

8. Installing Demo Content

The best way to start is to install demo content. If you want to install demo content please do the following:

1. Start with fresh WordPress installation and make sure that theme and required plugins are installed.

2. Go to ‘Tools > BT Import’ and select demo which you want to install.

3. Wait until you get message that import is finished. If you see red colored error message, go to Media Library and delete any unfinished downloads (images) and repeat the import.

9. How to add new Font icons?

In order to add new Font icons, you should customize the theme. Please do the following steps:

1. First of all you need to import your font file. You will need to import .eot, .svg, .ttf, and .woff files of your font, and name them the same. For example 'myFont'. Files need to be added to \wp-content\themes\your-theme-name\fonts folder.

2. Please take a look at the top of style.crush.css (or style.css) file and you will find @font-face declaration. You need to import your own font files in the same manner as FontAwesome for example, and declare the font-family as 'myFont' or any name you used for your font (*note that it has to be the same name you used for files).


3. Then you need to search for 'data-ico-fa' in the style.crush.css (or style.css) file and create respective statements for your font. 


For example when you locate:

*[data-ico-fa]:before {
    font-family: FontAwesome;
    content: attr(data-ico-fa);
    }

you need to create:

*[data-ico-mf]:before {
    font-family: myFont;
    content: attr(data-ico-mf);
    }

etc.

*Please note that mf stands for the name of the font (in our example myFont), so if you named your font differently, you need to use acronym that matches your font's name. This refers to all the code that is added for new icons, as well as file names.

4. Then, you need to create new file in theme plugin's folder called bt_mf_icons.php. The file should be added to \wp-content\plugins\your-theme-name folder.


As an example of how the PHP file should look, you can use one of the existing fonts (bt_fa_icons.php) and copy their files' content, and replace it with your glyph codes.

Or, you can use the following example, and just replace the glyph codes (numbers: f100, f101, f102 etc.) with the ones from your icon set. 

function bt_mf_icons(){
 $arr = array(
     '  ' => 'no_icon', 
     'icon-01' => 'mf_' . '_f100',
     'icon-02' => 'mf_' . '_f101',
     'icon-03' => 'mf_' . '_f102',
     'icon-04' => 'mf_' . '_f103',
     'icon-05' => 'mf_' . '_f104',
);

The glyph codes are defined in style.css file of your font. Here is the example:

<?php
$set = strtolower( basename(__FILE__, '.php') );
$$set = array(
    'icon-01:before {
  content: "\f100";
}
    'icon-02:before {
  content: "\f101";
}
    'icon-03:before {
  content: "\f102";
}
    'icon-04:before {
  content: "\f103";
}
    'icon-05:before {
  content: "\f104";
}------>


5. Finally, you need to edit php file in your plugin's folder, search for bt_fa_icons() and add respective statements for bt_mf_icons() as well. The file is in \wp-content\plugins\your-theme-name folder (it is the file named as the theme).

*The example is from our Industrial theme but the process is the same for all themes.

For example to change all occurrences of:

$icon_arr = array_merge( bt_fa_icons(), bt_s7_icons(), bt_custom_icons() );

to:

$icon_arr = array_merge( bt_fa_icons(), bt_mf_icons(), bt_s7_icons(), bt_custom_icons() );

10. How to create One page

The best way to start is to install demo content. If you want to install one page demo please refer to the article: Installing Demo Content. You will be able to see how all elements on the single page are set.

Please have a look at the following steps, how to achieve one page:

1. Insert in required shortcode section Custom ID Attribute. 

2. Then in Appearance > Menus add a new custom link and as a URL insert custom ID atribute with #.

11. How to change the Excerpt text?

All Blog Posts, and even Pages can have Excerpt text.

In order to change the ’Excerpt text’ please take a look at the bottom of edit post page. Since this field is not visible by default, just click Screen options button at top right corner of the form and check Excerpt checkbox. 

                        


This will make excerpt field visible. You will be able to edit Excerpt text.




For more info and detailed instructions please refer to our Online Theme Documentation.



12. How to make a page load with accordion items closed by default

In order to make a page load with accordions collapse by default, please edit cargo/bt_elements.js file in your wp-content/plugins folder and locate the following statements:

$( '.tabsVertical' ).each(function(){
 $( this ).find( '.tabAccordionTitle' ).first().click();
 });

Remove these statements from file or comment them out and your accordions will remain closed on page load.

13. How to increase the size of the logo?

In order to increase size of the logo you need to add the following CSS statements to Custom CSS field of Appearance > Customize > General panel:

.menuHolder .logo img {
    height: 70px;    
}

Please adjust the numbers according to your needs.

14. How to add new icon?

In order to add new icon, you will need to upload some other files in addition to .svg.

Here is the process:

  1. Go to IcoMoon.

  2. Click IcoMoon App in upper right corner:


3. Click on hamburger Menu in upper left corner and choose Manage Projects:


  4. Click New Project. Rename the project if you want. Click Load:

  5. Click Import Icons:

  6. Choose your .svg file.

  7. If asked do you want to use font's metrics click "Yes".

 8. Click on hamburger Menu in upper right corner and click Select all.

 9. Click Generate font in lower left corner:

 

 10. Click Preferences and set fontawesome-webfont for Font Name:

  11. Click Download in lower right corner:


  12. Extract files from the downloaded archive's fonts folder:

  13. Locate the font folder in theme's folder on your server and delete everything that has fontawesome in the name including woff2 and oet file.

  14. At the end, upload newly created files from IcoMoon.

15. I have purchased your theme. Now what?


The best starting point is to go through the provided documentation. 

It will guide your through the common tasks of theme installation and import of demo content.  

You have 2 options for downloading your theme:


Documentation pdf is in the All files and documentation package. Please download it and the document should be in the root of the downloaded archive.



For more info and detailed instructions please refer to our Online Theme Documentation.

16. Missing Google API key - Google Map

*Google has, starting July 16, 2018, made certain API and billing changes. In order to enable billing, you will need to provide credit card or billing account to Google Maps platform. Please note that we are in no way associated with Google Maps and their payment system and for any questions and issues regarding payments and billing you will need to contact them. Please refer to their FAQ and their documentation to learn more about these changes.

  1. First step is to get location’s longitude and latitude. This article explains how – Find or enter latitude & longitude.
  2. When the theme is updated, please Get your API key.
  3. Then locate the Google Map element in Bold Builder/Rapid Composer and enter your API key.

Bold Builder preview:

Rapid Composer preview:



For more info and detailed instructions please refer to our Online Theme Documentation.

17. "404 Page not found" error on inner pages

If after installing demo content inner pages are returning "404 Page not found" error, please try to recreate permalink structure by going to Settings > Permalinks, changing it to Post name, for example, saving the settings, then changing it back to the one you originally had, and saving it again.

18. How to update installed theme? Will it change data?

Once the new theme version is available, user who purchased the theme should get email note from the Envato (ThemeForest).



There are three ways to update the theme:

1) FTP Update

Download newest theme version from ThemeForest Download section. Since you already have the theme installed, you can download just 'Installable WordPress file only'.

In case you want to use this method, we suggest that you use Filezilla to access your server. Here is the article that explains how Filezilla works.

You need to extract theme file from the zipped folder you downloaded, and upload it to /wp-content/themes folder on your server. You will be prompted to overwrite the existing files. Select 'Yes', and the theme will update.

*The example is the zip file from Medicare theme but the process is the same for all themes.

2) Update theme via ZIP file upload

This method is available since WP version 5.5. Please follow these steps: 

3) Envato Market plugin

Enable automatic theme update with the Envato Market Plugin. Once you install and activate this plugin, every time a new theme version becomes available, you will be able to update it with just one click.

 You will need to go to the WordPress Updates page and navigate to the Themes section. The new version will be included in the section just like the themes from the WordPress repository.

* Whichever of these three methods you use for theme update, you will have to update theme plugin (and possibly some other required plugins) as well.

For plugin updates, you will get notification on your dashboard when new version is available.

Please note...

If you made any changes in the source code you'll need to reapply them to the new version of the theme or they will be lost.

To prevent this, you can use child theme.

All settings in Customize panel and your content will be preserved.



For more info and detailed instructions please refer to our Online Theme Documentation.

19. SVG Image format

Our themes currently do not support SVG image format. We also don't recommend using any of the plugins for SVG, such as SVG SupportSafe SVG, and others. 

These plugins have not been tested with the themes, are not fully supported, and can cause themes' functionalities, such as Customize panel, to break.

20. How to add custom icon font to the theme

Hi,

This requires customization of several theme files. 

First of all you need to import your font file. Please take a look at the top of style.cargo.css file and you will find @font-face declaration. You need to import your own font files in the same manner as FontAwesome and the rest and declare the font-family as, for example 'myFont'.

Then you need to search for all 'data-ico-fa' in the style.cargo.css file and create respective statements for your font. For example when you locate

.btIco .btIcoHolder[data-ico-fa]:before{font-family:FontAwesome;content:attr(data-ico-fa)}

you need to create 

.btIco .btIcoHolder[data-ico-mf]:before{font-family:myFont;content:attr(data-ico-mf)}

Please make sure to find all occurrences of data-ico-fa and create respective data-ico-mf statements.

Then, you need to create new file in cargo plugin folder called bt_mf_icons.php by copying the file bt_fa_icons.php and changing it by mapping your glyph codes:

function bt_mf_icons() {
 $arr = array(
 '  ' => 'no_icon', 
 'myname1 (mf)' => 'mf_' . 'xxxx',
 'myname2 (mf)' => 'mf_' . 'xxxx',
etc...

Finally, you need to edit cargo.php in your plugin's folder: 

search for bt_fa_icons.php and add equivalent statements for bt_mf_icons.php:

if ( ! function_exists( 'bt_mf_icons' ) ) {
 require_once( 'bt_mf_icons.php' );
 }

then search for bt_fa_icons() and add respective statements for bt_mf_icons() as well - change all occurrences of 

$icon_arr = array_merge( bt_fa_icons(), bt_s7_icons(), bt_custom_icons() );

to

$icon_arr = array_merge( bt_fa_icons(), bt_mf_icons(), bt_s7_icons(), bt_custom_icons() );

21. How to hide hover image effect?

In order to hide the hover effect on images, please add the Extra Class Name(s)  "btSimpleHover" to the required element (Row, Grid gallery or Image etc.):

and then add the following css statements to the Custom CSS field in Customize > General Settings:

.btSimpleHover .captionPane {
    display: none;
}


22. I want to use a child theme. How can I do that?

If you want to use a child theme, please follow these steps:

  1. First of all, make sure that you haven’t changed the parent theme’s folder name. It needs to remain the same.
  2. You should be able to find the folder your_theme_name-child in the package you've downloaded from ThemeForest.
  3. Please copy this folder to /wp-content/themes folder on your server.
  4. Go to Appearance > Themes in your wp-admin console and activate child theme. Please have in mind that all required plugins need to be activated.

To replace a function, copy it from the parent theme to the functions.php file in your child theme and make your modifications.

For example, if you want to change default pagination HTML output, you need to copy entire function to the child theme:

/**
 * Pagination output for post archive
 */
if ( ! function_exists( 'boldthemes_pagination' ) ) {
    function boldthemes_pagination() {
        ...
    }
}

And then replace the output according to your needs. For example

if ( ! function_exists( 'boldthemes_pagination' ) ) {
    function boldthemes_pagination() {
        echo '<div class="new-archive-pagination"></div>;
    }
}

Please note that this is an example for one function, and it might differ for other functions and changes.

You can find additional info in this article from EnvatoTuts+.

23. Embed code I have placed using text element is being cut off. It does not have the proper height. How can I resolve this?

It may happen that iframe created by your embed code gets cut off.

Please do the following to resolve this:
1. Define Custom Id for the section containing embed code (for example: section_1)


2. Add the following statements to Custom CSS field of Appearance > Customize > General panel 

#section_1 iframe {
    height: 150px !important;
}

Adjust the height according to your needs.

24. How to ask for a refund?

If you've decided that our theme / plugin doesn't work for you, we do offer a full refund.

In order to ask for a refund, please submit a request for a refund on the following link: http://themeforest.net/refund_requests/new.

Here's how the refund process works:

1. The refund request is sent to us via email, and we decide if we are going to approve it or not.

2. Once the refund is approved, it can take between 3 to 5 days for Envato to transfer money back to your account.

3. If the refund is not approved, you can always raise a dispute

You can find additional guidelines on the refund in the official Envato article.

25. How to edit 404 page?

The 404 error page can be customized by editing 404.php file in /wp-content/themes/your-theme/ folder.

There you can edit text, button (on some themes), or images.

In order to replace the background image on error page, please follow these steps:

1. First upload your image to /wp-content/themes/your-theme/gfx folder.

2. Edit the following part of the code:

<section class="bt-error-page gutter" style="background-image: url(<?php echo esc_url_raw( get_parent_theme_file_uri( 'gfx/plug.png' ) ) ;?>)"></section>

by changing the existing name of the image to that of your image.


Please note that the code might look a bit different than the example above, depending on which theme you are using.


Additionally, making larger changes to the structure of the page (code) falls under 'customization per request', so we can't assist with that type of edits.