Shopscape - Single Product and WooCommerce Shop WordPress Theme

Contents

1. Header title is displaying site name

2. How to add new Font icons?

3. Installing Demo Content

4. Missing Google API key - Google Map

5. How to change the Excerpt text?

6. How to translate theme?

7. How to add new icon?

8. How to change the Excerpt text and Header background image?

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

10. Where is my Purchase Code?

11. How to create One page?

12. How to change the header and edit other Single Shop Product page settings?

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

14. How to ask for a refund?

15. Twitter widget / element

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

17. SVG Image format

18. How to change the header and edit other Single Post settings?

19. How to change logo?

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

21. How to hide hover image effect?

22. New YIHT 2.2.0 version broke my site - Problem is solved!

23. How to change the settings only on one page?

24. How to edit widgets?

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

26. Missing style sheet error when installing the theme

27. I have purchased your theme. Now what?

28. Instagram widget / element

29. How to leave a review?

1. Header title is displaying site name

Once you add titles with Yoast SEO plugin, header will display that title and site name, instead of the page title.

In order to show only title, without site name, you could change page title template to display only the title. In Yoast > Titles & Metas > Pages Title template, you could add title template as:

%%title%%


Other option would be to switch to  All in One SEO Pack plugin, that does not affect header title.

2. 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() );

3. Installing Demo Content

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

First, delete all sample content (posts and pages) which is automatically created when
WordPress is installed. If you have already added a new content, please make sure to do the backup in order to save the content. After the backup, delete all content and you can start with the next steps:  

1. Start with fresh WordPress installation and make sure that theme and required plugins are installed. Since some demos contain WooCommerce data, please install WooCommerce plugin. Once you finish with the installation, you can remove WooCommerce plugin if you do not need it.


 


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, just repeat the import until you get the message that import is finished. Import is incremental process and will finish eventually.

4. If you have imported demo with WooCommerce content, go to WooCommerce > Settings > Products > Display and select Shop as Shop Page; open Checkout tab and select Cart as Cart Page and Checkout as Checkout Page; open Accounts tab and select My Account as My Account Page.


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.

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

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



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

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

8. How to change the Excerpt text and Header background image?


In order to edit / remove excerpt text, navigate to the Page editor, and in Screen Options (at the top of the dashboard) enable Excerpt field.

http://documentation.bold-themes.com/celeste/wp-content/uploads/sites/30/2018/07/Screenshot_26.jpg


After that, scroll to the bottom of the page editor where you’ll find Excerpt text.

http://documentation.bold-themes.com/celeste/wp-content/uploads/sites/30/2018/07/Screenshot_7.jpg


The Header background image represents featured image added to the page. In order to replace existing image with your own, click on the image, and when redirected, select image from Media Library.

In order to entirely remove the image, click on ‘Remove featured image’ button.

http://documentation.bold-themes.com/celeste/wp-content/uploads/sites/30/2018/07/Screenshot_25.jpg


In order to remove entire Header from pages, make sure to check ‘Hide Default Headline’ field in Appearance >Customize >General Settings panel, or in Override Global Settings at the bottom of the page editor:


Should you want to edit header on Single Post, Single Product or Single Portfolio then first locate page which settings are inherited. For more info refer to the articles:

See in action this feature in the following video tutorial. And make sure to subscribe to our YouTube channel!



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

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

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

Update theme via ZIP file upload (recommended)

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

  1. From WP dashboard go to Appearance > Themes,
  2. Click Add New button,
  3. Click Upload Theme button,
  4. Click Choose File to select downloaded zip archive, then click Install Now,
  5. Wait for the upload to finish, then click Replace current with uploaded button.

Update theme via FTP

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.

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.

Keep your eyes on potential required plugin update messages at wp-admin dashboard once you replace the files. You should update all required plugins if the updated theme suggests so. 

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

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



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

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

11. 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. First of all, navigate to the Bold Page Builder and edit desired section. Insert in required Custom Tab Element ID attribute:



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

For example: #about


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

12. How to change the header and edit other Single Shop Product page settings?

All single product pages 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 products, make sure to add its slug to Settings Page Slug field in Appearance >Customize >Shop panel.


                                                          




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

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

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

15. Twitter widget / element

Please note that this widget / element is deprecated due to changes in Twitter API, and it is not possible for new users to register. This widget / element will be completely removed in future updates. We recommend switching to a third party plugin that displays Twitter feed.

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

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

18. How to change the header and edit other Single Post settings?

All single posts 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 posts, make sure to add its slug to Settings Page Slug field in Appearance >Customize >Blog panel.

                                                          





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

19. How to change logo?

The logo (and alternate logo) should be set in Appearance > Customize > General Settings panel. If, after setting your logo, it's still not visible on some pages, please do the following steps (note: example on Fast Food theme):



1. Navigate to the those pages' editor.

2. Locate Override Global Settings section at the bottom of the Page editor end remove Logo or Alternate logo:





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

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

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. New YIHT 2.2.0 version broke my site - Problem is solved!

If you've updated YITH WooCommerce Wishlist plugin to the newest 2.2.0 version, it's possible that your site is broke (especially if WP_DEBUG is enabled).

In that case, please do the following:

1. Locate 237 line in yit-debug.php  (located in \wp-content\plugins\yith-woocommerce-wishlist\plugin-fw\lib folder on your server):

$plugin_fw_version   = get_file_data( trailingslashit( YIT_CORE_PLUGIN_PATH ) . 'init.php', array( 'Version' => 'Version' ) )[ 'Version' ];

2. Replace it with:

$plugin_fw_version   = get_file_data( trailingslashit( YIT_CORE_PLUGIN_PATH ) . 'init.php', array( 'Version' => 'Version' ) );

3. Save!

23. How to change the settings only on one page?

Here is how the Setting generally works:

The settings in the Appearance > Customize panel are global, meaning that they influence every page on the site by default.


On the other hand, you have an option to override these settings on per page basis. If you take a look at the bottom of the page edit form, you will notice 'Override Global Setting' part in Settings Section - here you can override global settings for every page.


So, for example, if you need to change the logo then the value should be either absolute URL of the image or image ID from Media Library. The same is with Sidebar (left, right or no sidebar) or Boxed menu (true or false) etc.

When it comes to editing the Blog Posts, Portfolio projects or Products, than please refer to the articles:

24. How to edit widgets?

In Appearance > Widgets panel you can see the list of available widgets and widget areas. Here’s how they work - each theme has default widget areas, such as Footer widgets, Header Left widget, Header Right widgets, etc.

Some themes have custom widget areas made for each homepage in order to have different widgets on them. Custom widget areas are added in Appearance > Sidebars panel, by selecting which default area they will replace and on what page(s) they’ll display.

Once you choose homepage, go to Appearance > Widgets and check if that homepage has its own custom widget area. If it does, you have two options – first is to move widgets from this custom widget area to a corresponding default area. Other solution would be to simply assign custom widget area to display on all pages by checking them in Appearance > Sidebars panel.


*Example is from Celeste theme.


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

We use different sets of icons in Shopscape theme: Font AwesomeStroke 7 and Custom Icons: Shop1, Shop2Toys1Toys2Toys3Toys4Fashion and Shopscape.

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

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

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

28. Instagram widget / element

Please note that Instagram widget / element has been deprecated due to changes in Instagram API, and it is not possible for new users to register. This widget / element will be completely removed in future updates. We recommend switching to a third party plugin that displays Instagram feed.

29. 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! :)