FAQs

Where do I put the Tracking code I got from Google to my prestashop site?

  1. Turn off the "Use HTMLPurifier Library" setting on the Preferences > General page.
  2. Put the code to the "Tracking code" in the Theme editor module.

Why my site shows nothing, why my site is down? How to debug?

There are variety reasons, may be due to server settings or the hosting environment, maybe there are bugs. When this happens, the first thing you need to do is enabling the Prestashop debug to see if there are any error messages, you will either be able to troubleshoot further or send the error messages to us to fix the problem.

Debug Mode can be enabled from the back office CONFIGURE menu under Advanced Parameters > Performance

Why I can not put a video to the product description?

Turn off the "Allow iframes on HTML fields" setting on the Preferences > General page.

How to make Youtube or Vimeo videos be responsive on Prestashop?

For Transformer v4 and Panda template v2

Please refer to here.

Videos will be full width disregarding the width and height you set. If that's not what you want, you can use the Bootstrap's grid system to set a proper width to videos.

<div class="row">
  <div class="col-12 col-md-8 col-lg-6">
    <div class="embed-responsive embed-responsive-16by9">
      <iframe class="embed-responsive-item" src="//www.youtube.com/embed/zpOULjyy-n8?rel=0" allowfullscreen>
      </iframe>
    </div>
  </div>
  <div class="col-12 col-md-4 col-lg-6">
    Put any thing here.
  </div>
</div>

Responsive videos

For Transformer v3 and Panda template v1

<div class="row">
  <div class="col-xs-12 col-sm-8 col-md-6">
    <div class="media">
      <iframe src="//www.youtube.com/embed/zpOULjyy-n8?rel=0" allowfullscreen>
      </iframe>
    </div>
  </div>
  <div class="col-xs-12 col-sm-4 col-md-6">
    Put any thing here.
  </div>
</div>

Where can I find a list of all available icons

/assets/fontello.zip in the main .zip file you have downloaded from Themeforest.

Do not have quick view feature on the product page

Currently can not have quick view feature on the product page, due to a problem of PrestaShop.

How to find out what version of the theme you are using?

Two ways:

  1. The version of Theme editor module.
  2. Go to BO > Design > Theme & Logo page.

How to find out what version of Prestashop you are running?

Go to BO > Advanced Parameters > Information page.

Why got "This connection is not secure. Logins entered here could be compromised"?

Solution is enabling SSL. More info here: https://support.mozilla.org/en-US/kb/insecure-password-warning-firefox?as=u&utm_source=inproduct

How to adjust the gap between header and content.

Please refer to the "Modules" > "Breadcrumbs" section.

Why I keep losing my page layout settings after clear the Smarty cache.

Back up the \app\cache\prod\themes\transformer\shop1.json file or the \app\cache\dev\themes\transformer\shop1.json file after you choosing "Full width" or "Two columns, small left column" or "Two columns, small right column" for your pages, because of you may loose your settings after clearing the Smarty cache.

"BO > module and service" does not work after installing the theme.

Please check if your hosting meets PrestaShop System requirements. https://www.prestashop.com/en/system-requirements Try increasing memory_limit to "128M" or "256M", if that does not work, increasing max_execution_time to "60". If you don't know how to do that, contact your hosting company for help. If you hosting company is not helpful, then contact us.

Why I got an error when installing a 3rd party module.

In most case, the problem is a problem of network, try re-installing it for one or two more times. Another solution is to manually upload the module via FTP of cPanel to avoid having network problems.
An error when installing 3rd party modules

Be careful when you edit prestashop files and theme files.

If you find the file, which you are going to editing, having empty lines after every line of code, then don't edit it or upload it back to your site.Extra linesThe problem is probably due to your FTP clients or your server settings, please Google for solutions. An alternative way is using cPanel to zip files before downloading or uploading them to avoid having problems during file transfers.

How to increase max allowed character of product names in prestashop from 128 to 255?

1. Change database, go to ps_product_lang table and change length of "name" and "link_rewrite" fields.
2. Open \classes\Product.php, change the size attribute of "name" and "link_rewrite" fields.
3. Open \src\PrestaShopBundle\Form\Admin\Product\ProductInformation.php, seach for 128, change it to 255.

How to add media servers to prestashop?

Refer to the "How to speed your site up" section on here.

Icons disappeared after using CDN or media servers.

Go to BO > Modules > Theme editor module > “Custom codes” tab > Put this code in the “Custom CSS code” field.

@font-face {
  font-family: 'fontello';
  src: url('//your-domain/themes/transformer/font-fontello/font/fontello.eot?81926201');
  src: url('//your-domain/themes/transformer/font-fontello/font/fontello.eot?81926201#iefix') format('embedded-opentype'),
       url('//your-domain/themes/transformer/font-fontello/font/fontello.woff2?81926201') format('woff2'),
       url('//your-domain/themes/transformer/font-fontello/font/fontello.woff?81926201') format('woff'),
       url('//your-domain/themes/transformer/font-fontello/font/fontello.ttf?81926201') format('truetype'),
       url('//your-domain/themes/transformer/font-fontello/font/fontello.svg?81926201#fontello') format('svg');
  font-weight: normal;
  font-style: normal;
}

Got a white page when you upload images in the Revolustion sldier module.

1. Check if mbstring is installed in PHP.
2. If the above step did not work, then enable error reporting to see if there are any error messages.

How to get the latest version of the theme.

Re-download the theme from the download page to get the latest version.

Why my site went down, I got a white page with logo only.

Go to Advanced Parameters > Performance page, check if these settings "Disable non PrestaShop modules" and "Disable all overrides" are disabled, if they are not, disable them and save.
An important step

Revolution slider' "Margin bottom" setting does not work for fullscreen sliders

If you set a top margin to the block which is right below the fullscreen revolution slider to set them apart. Every module of the theme has options to set margins.

After theme installation or theme updating, the menu and some other modules disappeared.

  1. Turn off the "Disable all overrides" option on the "BO > Advanced parameters > Performance" page.
  2. Please check if the "Overriding default behaviors" module is properly installed. We can help you manually install it if it's not properly installed, please send us your FTP and back office login information via contact us page.
  3. If you are running your site on PrestaShop1.6, you may need to trigger the regeneration of the /cache/class_index.php file. This can be done simply by deleting the file.

How to have a transparent background png format logo in prestashop

Go to the "BO > Image setting" page to Set the “Image format” option to “Use PNG only if the base image is in PNG format”, and then upload a .png logo.

Product thumbnails can't show on search suggestion in Prestashop 1.7.2.4 and 1.7.2.5

It is a bug in Prestashop, please modify the /classes/controller/ProductListingFrontController.php file, add .'cover' in it, see attached screenshot.

Left and right columns disappear after clearing the Smarty cache

When you clear the Smarty cache manually, the sidebar on homepage will lost. the reason is that Prestashop saves page layout settings in cache folder, if you clear the cache, the settings will be moved. Two solutions:
1. Back up the \app\cache\prod\themes\transformer\shop1.json file or the \app\cache\dev\themes\transformer\shop1.json file after you choosing "Full width" or "Two columns, small left column" or "Two columns, small right column" for your pages, because of you may loose your settings afeter clearing the Smarty cache.

2. If you are using sidebar for homepage, please add this code index: layout-left-column to /themes/theme_name/config/theme.yml file via FTP, theme_name is panda or transformer, see attached screenshot.

All product images are same on prestashop order confirmation page

There is a bug in Prestashop 1.7.1.24, all product images will be same on order confirmation page, it requires to modify the /src/Adapter/Order/OrderPresenter.php file, add the 

1
$cartProduct['id_product'] === $orderProduct['id_product'] &&

code before the code 

1
$cartProduct['id_product_attribute'] === $orderProduct['id_product_attribute']

on line 134 to fix it.

Why my prestashop cross selling module doesn't show any products.

The prestashop cross selling module shows products from validated orders. Generally a order marked as SHIPPED is a validated order. So if you don't have any validated orders, the prestashop cross selling module would not show any products out.

In PrestaShop 1.7, if you want to show products on the shopping cart page, then you need to transplant the module to the displayShoppingCartFooter hook, and the replace this code in the \modules\ps_crossselling\ps_crossselling.php file

1
2
<br />
if ('displayShoppingCart' === $hookName) {<br />

With

1
2
<br />
if ('displayShoppingCart' == $hookName || 'displayShoppingCartFooter'== $hookName) {<br />

Why I can't get the Override default behavior module activated.

1. Check if the \override\controllers\front\CategoryController.php file exists. If it exists, make a backup of it, and then remove it.

2. Check if the \modules\stoverride\override\controllers\front\CategoryController.php file exists. Remove it if it exists.

3. Try activating the Override default behavior module again.

how to change Underscore to Dash in Blog URLs.

it requires to change two files.
1. Add the following code to /classes/Dispatcher.php:

1
2
3
4
5
6
7
8
9
10
11
12
13
<br />
'module-stblog-article' => array(<br />
'controller' => 'article',<br />
'rule' => 'blog/{id_st_blog}-{rewrite}.html',<br />
'keywords' => array(<br />
'id_st_blog' => array('regexp' => '[0-9]+', 'param' => 'id_st_blog'),<br />
'rewrite' => array('regexp' => '[_a-zA-Z0-9-\pL]*'),<br />
),<br />
'params' => array(<br />
'fc' => 'module',<br />
'module' => 'stblog',<br />
)<br />
),<br />

2. change 

1
{id_st_blog}_{rewrite}.html

 to 

1
{id_st_blog}-{rewrite}.html

 in the /modules/stblog/stblog.php

Get an error when sending a message using the contact form in Prestashop 1.6.1.x

The version of your theme is too old. Upgrading your theme can fix the problem.

If you don't want to upgrade your theme, then you need to edit the /thems/yourtheme/contact-form.tpl file to fix the problem.

  1. Find this line.
    <button type="submit" name="submitMessage" id="submitMessage" class="btn btn-default">{l s='Send'}</button>
  2. Put this code right above it.
    <input type="text" name="url" value="" class="hidden" />
    {if isset($contactKey)}<input type="hidden" name="contactKey" value="{$contactKey}" />{/if}

How to improve ajax search result.

On the ajax search result, you can't get the expected result by default via setting result weights, it requires to modify /classes/Search.php file, change the code

1
2
3
4
5
6
7
8
9
10
11
12
13
<br />
$score = '';<br />
if (is_array($score_array) && !empty($score_array)) {<br />
$score = ',(<br />
SELECT SUM(weight)<br />
FROM '
._DB_PREFIX_.'search_word sw<br />
LEFT JOIN '
._DB_PREFIX_.'search_index si ON sw.id_word = si.id_word<br />
WHERE sw.id_lang = '
.(int)$id_lang.'<br />
AND sw.id_shop = '
.$context->shop->id.'<br />
AND si.id_product = p.id_product<br />
AND ('
.implode(' OR ', $score_array).')<br />
) position'
;<br />
}<br />

To

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<br />
$score = '';<br />
$field = 'position';<br />
if (Tools::getValue('is_ajax_search')) {<br />
$field = 'pos';<br />
$order_by = 'pos';<br />
$order_way = 'desc';<br />
}<br />
if (is_array($score_array) && !empty($score_array)) {<br />
$score = ',(<br />
SELECT SUM(weight)<br />
FROM '
._DB_PREFIX_.'search_word sw<br />
LEFT JOIN '
._DB_PREFIX_.'search_index si ON sw.id_word = si.id_word<br />
WHERE sw.id_lang = '
.(int)$id_lang.'<br />
AND sw.id_shop = '
.$context->shop->id.'<br />
AND si.id_product = p.id_product<br />
AND ('
.implode(' OR ', $score_array).')<br />
) '
.$field;<br />
}<br />

See screenshot:

And change product name weight as my screenshot:

How to find the purchase code?

  1. Log into your account.
  2. Mouse over the "My account" link at the right top of the screen.
  3. Click "Downloads" from the drop down menu to go to the Download page.
  4. Download the license .text file, you can find your purchase code in it.

Important information of using the 1-Click Upgrade module.

Turn off these options "Disable non-native modules" and "Switch to the default theme" in the "1-click Upgrade" module before upgrading.

Why checkboxes added by the official GDPR not showing correctly.

After upgrading to Transformer theme 4.2.3 / Panda template 2.3.3, checkboxes on the newsletter block and contact us form still not showing correctly.

That's due to a problem of the official GDPR module, I guess, the problem will soon be fixed. The simplest solution is that copy the themes/(panda or transformer)/modules/psgdpr/views/templates/hook/displayGDPRConsent.tpl file to replace the /modules/psgdpr/views/templates/hook/displayGDPRConsent.tpl file.

Some pages on the back office are broken after upgrade to 1.7.4

That's a browser cache related problem. Clear your browser cache or press ctrl+f5 to load latest style files to fix the problem.

Some modules's configure buttons and descriptions are missing after upgrade to 1.7.5.0

If you find modules on the "BO > Modules" not showing correctly after upgrade to 1.7.5.0, some module's configure buttons and descriptions are missing. That's a cache related issue, you can fix it by removing the file in the \var\cache\dev\doctrine\cb\ folder.

Sorting by quantity doesn't work when the ps_facetedsearch module is enabled.

Edit the \modules\ps_facetedsearch\ps_facetedsearch.php file to add this code to it.

1
2
3
<br />
if($order_by=='p.quantity')<br />
$order_by = 'stock.quantity';<br />

Why my site stopped working after upgrade.

You probably need to upgrade all module with "Upgrade" buttons on the "BO>Modules" page.

How to use Google sitemap v4.1.0

Click "Check all" to don't include all pages listed there, and then click the Generate sitemap button, that's all. If you don't check checkboxes for the blog module, you will get a 500 error that's due to a problem of the sitemap module. Blog urls will always be included in your sitemap files, not matter you choose those checkboxes or not.

If it's safe to upgrade to PrestaShop 1.7.x?

For example, your productive site is running on 1.7.5.1, one day you find that 1.7.6.0 is released, you may ask if it's oaky to upgrade to 1.7.6.0?

We recommend that don't upgrade to 1.7.6.0 right after its release, wait for about half months, and then check the information board on our support forums, if we don't say "don't upgrade to 1.7.6.0", then it's safe to upgrade your site to 1.7.6.0.

Why I can't switch language properly on the blog pages?

If you changed the blog route for different langauge, please follow the topic to fix the issue: https://www.sunnytoo.com/forums/topic/blog-does-not-redirect/page/2/#post-50795

I have problem with the back office product search feature on a Prestashop 1.7.6.0 site?

It's a bug in Prestashop 1.7.6.0, upgrading to 1.7.6.1+ can fix it, or you can follow this guide to fix it manually https://www.sunnytoo.com/forums/topic/megamenu-product-block#post-52015

Why is my site logo so blurry?

PrestaShop compresses every image, that's the reason. To stop PrestaShop compressing the logo requires to edit a file, that's not we want. A quite doable way is to replace the compressed logo in the /img/ folder with the original one via FTP.
If you find your product images are also blurry, then try our Imagemagick module.

Can't download, got an error "You must be logged in to download files"

If you got redirect a page saying "You must be logged in to download files", then Try these 3 solutions: 1) Try restarting your browser. 2) Try restarting your computer. 3) Try clearing your browser cache.

Not being able to change product attributes in 1.7.6.3

The small bug cases big trouble, to fix it you need to edit the /theme/core.js to replace this code

1
2
<br />
.quickview .product-variants .page-product:not(.modal-open) .row .product-variants<br />

with

1
2
<br />
.quickview .product-variants, .page-product:not(.modal-open) .row .product-variants<br />

Clear cache and cookies for one website in Google Chrome

Menu -> Settings -> "Privacy and security" section > Click on "Privacy and security" > Click on "Cookies and site data" > Click on "See all cookies and site data" > Search to find the site, and then click on trash icon to clear cache and cookies.

Why some category pages are so slow only for the first time?

Then it's probably caused by you didn't generated product thumbnails. Some people imported a lot of products via CSV files without generating thumbnails, then their sites' category pages would be very slow to load for the first time, because prestashop will generate thumbnails first, and then show you the page, generating thumbnails is a very time consuming process.

Compatibility with LiteSpeed

Go to the "Customization" tab in the LiteSpeed module to add these 3 modules there.

  • Shopping card mod
  • Customer "Sign in" link mod
  • 'Sidebar and mobile header bar

For PS 1.6 users, add these two modules there.

  • Cart block mod
  • User info block mod

Can't search products from backoffice modules?

See the topic: https://www.sunnytoo.com/forums/topic/product-selection-not-working#post-68110

How to switch/unregister the purchase code?

  1. Log in to the ST-Themes via the account that purchased the theme.
  2. Click the "Un-register it" button to unregister the purchase code.
  3. Use the purchase code to register your new domain. as there is cache systme on my server, maybe you need to wait for one or two hours to apply the purchase code.

How I can use the theme in a dev site for a test purpose?

If you install the theme on a test site or your localhost, don't need to register it. just enable the maintenance mode, then you can use all modules without restrictions.

Got Javascript errors after installing the Revolution slider module

Make sure the "JQuery No Conflict Mode" setting is off.

How to pay themes and modules via credit card?

Please see the following screenshots to pay themes and modules via credit card. if you have any problems, please feel free to contact us via the "Contact us" page: