LogoLogo
Homepage
  • Documentations for PrestaShop 1.4
  • English documentation 1.4
    • Getting Started
    • Updating PrestaShop
    • User Guide
      • Training
      • Customizing your shop
      • Browsing the front-office
      • Connecting to the PrestaShop back-office
      • Adding Products and Product Categories
      • A Look inside the Catalog
      • Managing Customers
      • Managing Orders
      • Managing Payment Methods
      • Managing Shipping
      • Understanding Statistics
      • Managing Modules
      • Managing Employees
      • Understanding the Preferences
      • Exploring PrestaShop's Tools
      • PrestaShop Support
    • System Administrator Guide
    • Developer Guide
      • Developer tutorials
        • Using the REST webservice
          • Chapter 1 - Creating Access to Back Office
          • Chapter 2 - Discovery - Testing access to the web service with the browser
          • Chapter 3 - First steps - Access the Web service and list client
            • 3.1 - Access the web service
            • 3.2 - Handling errors
            • 3.3 - List clients
          • Chapter 4 - Retrieve Data - Retrieving a Client
          • Chapter 5 - Modification - Update client
          • Chapter 6 - Creation - Remote Online Form
          • Chapter 7 - Removal - Remove customer accounts from the database
          • Chapter 8 - Advanced Use
          • Cheat-sheet - Concepts outlined in this tutorial
        • Understanding and using hooks
        • Synchronization via Hooks
        • Modules, Classes and Controller Override
        • Modules, Override, Web Service
        • Db class good practices for Prestashop 1.4
        • Carrier modules - functions, creation and configuration
        • Creating your own payment module
        • Accelerated Security Course - Episode 1 - Never Trust Foreign Data
        • Accelerated Security Course - Episode 2 - SQL Injections
        • Accelerated Security Course - Episode 3 - XSS
        • Accelerated Security Course - Episode 4 - CSRF
      • Fundamentals
      • Creating a PrestaShop module
      • Development standard
      • Public and overloadable methods
      • Web-service reference
      • How to use the forge to contribute to PrestaShop
      • Rocky's guides
        • PrestaShop 1.4.3 Development Guide
          • Architecture
          • Overriding Files
          • Creating Modules
          • Cookie Structure
          • Database Structure
        • PrestaShop 1.4.3 Performance Guide
    • Designer Guide
      • Coding a theme
      • Design tips
      • Implementing layered navigation in a theme
    • Troubleshooting
    • FAQ
    • User contributions
    • Documentation PDFs
  • Documentation française 1.4
    • Guide de démarrage
    • Mettre à jour PrestaShop
    • Guide de l'utilisateur
      • Formation
      • Personnaliser votre boutique
      • Se connecter au back-office de Prestashop
      • Ajouter des produits et des catégories de produits
      • Un aperçu du catalogue
      • Gérer les clients
      • Gérer les commandes
      • Gérer les méthodes de paiement
      • Gérer le transport
      • Comprendre les statistiques
      • Gérer les modules
      • Gérer les employés
      • Comprendre les préférences
      • Explorer les outils de PrestaShop
      • Obtenir de l'aide
    • Guide de l'administrateur système
    • Guide du développeur
      • Fondamentaux
      • Créer un module PrestaShop
      • Tutoriels pour développeurs
        • Tutoriel Webservice REST
          • Chapitre 1 - Mise en place - Création des accès dans le Back Office
          • Chapitre 2 - Découverte - Tester l'accès au service web avec le navigateur
          • Chapitre 3 - Premiers pas - Accéder au service web et lister les clients
            • 3.1 Accéder au service web
            • 3.2 Gestion des erreurs
            • 3.3 Lister les clients
          • Chapitre 4 - Récuperer des données : Récupérer un client
          • Chapitre 5 - Modification : Mettre à jour un client
          • Chapitre 6 - Création : Formulaire d'ajout à distance
          • Chapitre 7 - Suppression : Retirer des comptes client de la base
          • Chapitre 8 – Utilisation avancée
          • Chapitre 9 - Gestion des images
          • Chapitre 10 - Gestion des prix
          • Mémento : Notions énoncées dans ce tutoriel
        • Mieux comprendre et utiliser les hooks
        • La synchronisation via les Hooks
        • Surcharge et override
        • Modules, surcharge, web service
        • Les bonnes pratiques de la classe Db sur Prestashop 1.4
        • Les modules transporteurs - fonctionnement, création, configuration
        • Cours de sécurité accéléré no. 1 - Never trust foreign data
        • Cours de sécurité accéléré no. 2 - Injections SQL
        • Cours de sécurité accéléré no. 3 - XSS
        • Cours de Sécurité accéléré no. 4 - CSRF
    • Guide du designer
      • Conseils en design
      • Créer un thème
    • Guide du Vendeur
    • Import Wiki FR
      • Dépannage
        • Changer la taille maximum de téléchargement de fichiers
        • Comment ajouter une page à PrestaShop
        • Générer le fichier .htaccess par Prestashop pour avoir des URLs simplifiées
        • Générer un nouveau mot de passe manuellement
        • Import CSV
        • Personnalisation des mails clients
        • Problème d'allocation mémoire chez 1&1
        • Problème pour se connecter après avoir effacé une langue
        • Votre site ne répond plus, une page blanche s’affiche
      • Fidéliser les Clients
      • Gestion des Taxes
      • Installer Un Module
      • Sauvegarder votre Base de Données
    • PDF de la documentation
    • Contributions des utilisateurs
    • Questions fréquentes
  • Documentación española 1.4
    • Introducción
    • Actualización de PrestaShop
    • Guía de Usuario
      • Entrenamiento
      • Personalización de su tienda
      • Exploración del front-office
      • Conexión al back-office PrestaShop
      • Añadir Productos y Categorías de Productos
      • Una Mirada Dentro del Catálogo
      • Gestión de Clientes
      • Gestión de Pedidos
      • Gestión de Métodos de Pago
      • Gestión de Envío
      • Comprensión de las Estadísticas
      • Gestión de Módulos
      • Gestión de Empleados
      • Comprensión de Preferencias
      • Exploración de las herramientas de PrestaShop
      • Soporte PrestaShop
    • Guía del Administrador del Sistema
    • Guía del Desarrollador
      • Aspectos Fundamentales
      • Creación de un módulo de PrestaShop
      • Estándares de desarrollo
      • Manuales de desarrollador
        • Utilización del servicio web REST
          • Capítulo 1 - Creación de Acceso al Back Office
          • Capítulo 2 - Descubrimiento - Pruebas de acceso al servicio web con el navegador
          • Capítulo 3 - Primeros pasos - Acceso al servicio Web y lista de clientes
            • 3.1 - Acceso al servicio web
            • 3.2 - Manejo de errores
            • 3.3 - Enumeración de clientes
          • Capítulo 4 - Recuperación de datos - Recuperación de un cliente
          • Capítulo 5 - Modificación - Actualización de cliente
          • Capítulo 6 - Creación - Formulario En Línea Remoto
          • Capítulo 7 - Eliminación - Eliminar cuentas de clientes de la base de datos
          • Capítulo 8 - Uso avanzado
        • Comprensión y uso de hooks
        • Sincronización a través de Hooks
        • Módulos, Reemplazo, Servicio Web
        • Módulos, Clases y Reemplazo del Controlador
        • Buenas prácticas de Clase DB para Prestashop 1.4
        • Módulos de transportistas - funciones, creación y configuración
        • Curso Acelerado de Seguridad - Episodio 1 - Nunca Confíe en Datos Exteriores
        • Curso Acelerado de Seguridad - Episodio 2 - Inyecciones SQL
        • Curso Acelerado de Seguridad - Episodio 3 - XSS
        • Curso Acelerado de Seguridad - Episodio 4 - CSRF
      • Referencia del servicio web
    • Guía de Diseñador
      • Codificación de un tema
      • Consejos de Diseño
    • Solución de problemas
    • Preguntas Frecuentes
Powered by GitBook
On this page
  • Troubleshooting
  • How to modify a page's display?
  • How to create your own page/template?
  • How to generate the .htaccess file with PrestaShop's back office, in order to get Friendly URL?
  • In case of unexpected and persistent blank page, how to turn error message display on?
  • How to correctly import accentuated content using a CSV file?
  • Hosted at 1&1: How to solve the memory allocation issue?
  • How to regenerate a password and update the database manually?
  • How to change the maximum size of uploaded files to your server?
  • How to add a link or an image to customize the mails sent to your customers?
  • how to log in after deleting the English language pack?
  • How to create a new translation

Was this helpful?

  1. English documentation 1.4

Troubleshooting

PreviousImplementing layered navigation in a themeNextFAQ

Last updated 4 years ago

Was this helpful?

Table of contents

/*<![CDATA[*/ div.rbtoc1597330886204 {padding: 0px;} div.rbtoc1597330886204 ul {list-style: disc;margin-left: 0px;} div.rbtoc1597330886204 li {margin-left: 0px;padding-left: 0px;} /*]]>*/

Troubleshooting

How to modify a page's display?

You have to add your own selectors in your theme's CSS file. This file is usually found in /themes/YOUR_THEME/css/global.css.

Once created, you can use your selectors in the .tpl page you want to modify.

How to create your own page/template?

You can also create your own .tpl file (located in your theme directory), where you can insert your own HTML tags, and create a .php page (at the root of your shop) which will call the .tpl file.

Here is an example:

First, your_page.php:

<?php
include(dirname(FILE).'/config/config.inc.php');
include(dirname(FILE).'/header.php');

$smarty->display(PS_THEME_DIR.'your_page.tpl');

include(dirname(FILE).'/footer.php');
?>

With that, your_page.tpl contains your HTML code.

How to generate the .htaccess file with PrestaShop's back office, in order to get Friendly URL?

The .htaccess file, located at your shop root, enables you to set some environment variables (like the PHP version). You can also use to customize the URL-rewriting rules, and control the access to some directories and some other actions.

VERY IMPORTANT:

First thing to do: make a backup of your existing .htaccess file if any, locally or online.

  • Online. If you want to use the URL-rewriting facility, make sure that your host allows it first. Contact them

  • Locally. Here is an example with WAMP on Windows:

    • In the "Apache" menu, select "Apache modules".

    • Check rewrite modules.

    • Restart the Apache server (it might be automatic).

Once Apache is configured, if there is no .htaccess file in your shop's root directory yet, create an empty one:

  1. Create an empty file on your desktop with a simple text-editor, such as Windows's Notepad (not Word!) or OS X's TextEdit.

  2. Save the file as htaccess.txt, in a folder where you can easily find it. If possible, save it as an purely ASCII or ANSI file.

  3. Change its permissions to read and write everyone (CHMOD 666 in Unix), with your FTP client for instance).

  4. Go to the PrestaShop back-office, and under the Preferences tab and "SEO & URLs" sub-tab, enable "Friendly URL" (bottom of the page).

  5. Go to the "Tools" tab, then the "Generators" sub-tab, and click the "Generate the .htaccess file" button.

Warning: it will overwrite the existing one. If it was an empty file, that's okay, but if you have specific instructions in this existing, you should first move them over to the text-field in the "Generators" sub-tab, so that they are still found in the .htaccess file. If you forget to move your existing .htaccess instructions over, you risk putting your shop offline.

Now that it is enabled, the URL-rewriting should be working fine, which means that URL like this:

...will be replaced by...

In case of unexpected and persistent blank page, how to turn error message display on?

If your back-office and/or front-office start displaying a bank or incomplete page regularly without any error message, it is necessary to activate the display of the PHP errors in order to understand the problem.

This is done in your PrestaShop install's /config/config.inc.php file. You should edit it in order to add the following lines:

@ini_set('display_errors', 'on');
define('PS_DEBUG_SQL', true);

Then refresh the web page.

If it displays an error, contact PrestaShop support at support@prestashop.com.

Note that it could also be a .htaccess issue. Read the previous entry, "how to generate the .htaccess file".

How to correctly import accentuated content using a CSV file?

If you make a CSV Import with accentuated texts, beware to select UTF-8 or iso-8859-1 in the "Import" sub-tab of the "Tools" tab, and be sure that the .csv file has been saved with the same encoding.

If needed, save the CSV file from you text-editor (such as Notepad), specifying the right encoding.

Hosted at 1&1: How to solve the memory allocation issue?

There are only two solutions, and they are both drastic:

  • Decrease the size of your pictures in pixels, and thus their size on the disk. This will also most probably improve the overall performance.

  • Change host for one that support memory increase.

How to regenerate a password and update the database manually?

There are cases when PrestaShop will not recognize your e-mail or password when connecting, and nothing happens when you ask for a new password. There can be a number of reasons for this, but the important thing is to be able to log in again. This is will require you to access your database, using phpMyAdmin for instance.

You will have to follow the following procedure:

  1. Open the /config/settings.inc.php file, from your shop's root directory. Find the line containing "COOKIE_KEY". Copy the cookie content (without the quotes): it is the MD5 for your original password.

  2. You now need to generate a new MD5 hash for your password:

    1. Paste the cookie content in the text-field, and right after it, add your desired password. For instance, xykxB41JrEacRIoZxDioPNRmKeuO3ixCLygNxBAkeOkAHf2YUVESuT9jMYPASSWORD, where the cookie ends with T9j, and the desired password is MYPASSWORD (it can be anything you want).

    2. Click on "Convertir en MD5": this will produce a MD5 hash of the text-field's content. Copy it.

  3. You now need to put this hash into your database:

    1. Open you shop's database using phpMyAdmin. If you don't know how to use phpMyAdmin, ask your webmaster, or your host.

    2. Open the "pw_employee" table, find the row corresponding to your account (it should feature your firstname, lastname, and e-mail address), click its "Edit" button.

    3. Find the "passwd" field, and paste in the MD5 that you just generated.

  4. Log in in your back-office with the email listed in the same table, and the desired password that you used above (MYPASSWORD). This will generate a new cookie key.

If it still doesn't work, open the /config/settings.inc.php file and check the value of the "PS_BASE_URI" variable. It should contain the shop's file path:

  • If your shop is at the root of the server, this variable should contain "/".

If all fails, contact the PrestaShop support team.

How to change the maximum size of uploaded files to your server?

To change the maximum size of the uploaded files in your server, you have to edit the php.ini file for your PHP install. This can only be done if you do have access to your server's PHP configuration files. If not, ask your host.

If you do have access to php.ini, open it and edit the following lines:

post_max_size = [anything]
upload_max_filesize = [anything]

If you want to set the maximum to 200 megabytes, change their values to

post_max_size = 200M
upload_max_filesize = 200M

Finally, restart the server to take your changes into account.

How to add a link or an image to customize the mails sent to your customers?

PrestaShop enables you to automatically send a large number of mails to your customers (order confirmations, site subscriptions, out of stock notifications, etc.). It might be useful to customize these mails: adding images, links to survey forms or information pages (blogs, news, etc.).

Let's say your company wants to customize the e-mail sent automatically to customers after a purchase, in order to redirect them to a survey form.

To add a link in the mails sent to your English-speaking customers, you have to:

  1. Go to the /mails/en directory from your shop root.

  2. Edit the HTML template relative to the mail you want to modify: for instance, order_conf.html is the e-mail sent for new orders.

  3. Insert the link to the survey right in the HTML code (static):

    <a href="http://www.myshop.com/survey.php">Click here if you want to participate to our survey !</a>

    or a dynamic link with your logo:

    <a href="{shop_url}" title="{shop_name}"><img alt="{shop_name}" src="{shop_logo}" style="border:none;"></a>
  4. (Optional) To change the default color (which is pink: #DB3484), change the hexadecimal value to your preferred color value.

  5. Save the file.

Now the link will be added in every new mail sent after a purchase.

how to log in after deleting the English language pack?

In the event that you deleted the English language pack from your shop install, you can have issues connect to your back-office again.

Here how to solve this:

  1. Go to phpMyAdmin. If you can access it, ask your host to perform these actions.

  2. Select your shop's database, and select the ps_lang table.

  3. Click "Insert", and create a new entry with these values

    • id_lang -> 1

    • name -> English

    • active -> 1

    • iso_code -> fr

  4. Execute the query. You should be able to log in again.

How to create a new translation

Follow these steps:

  1. Go to your PrestaShop back-office, in the "Tools" tab, and its "Languages" subtab.

  2. Add a new language.

  3. Go to the "Translations" tab.

  4. In the "Modify translations" section: choose "Front Office Translations" in the drop-down list, then click the flag of the new language. Begin to translate the fields. Click "Save the modifications" once it all seems correct to you.

  5. Repeat the last step for each type of translation ("Back Office", "Modules", etc.).

  6. Your version of PrestaShop is now totally translated! Test, test, test! Have your friends test it too!

  7. You have contributed to the PrestaShop project! Thank you so much!

Left click on 's taskbar icon (WampServer must be installed and running already).

Upload it to your server using an FTP client, such as . Put the file at the root of your shop's directory.

Some people may encounter memory allocation issues, particularly when the back-office tries to display images which are quite big in the disk (over 800 Kb). Know that even if you increase the memory limit to 128 Mb, some host, such as 1&1, will keep the limit at 32 Mb. .

Go to

If your shop is in a sub-directory, it should contain it. For instance, if it's at ", then the variable should contain "/shop/".

Note: You can download . Don’t forget to activate the language.

In the "Copy" section: select "English, prestashop" to ", prestashop", then click "Copy".

If you want to contribute it to the PrestaShop project, you can propose your new translation to the PrestaShop Team. In the "Export a language" section, select the new language; in the following fields select "prestashop" then click "Export". Save this file and send it to contact@prestashop.com with as subject "New translation: XX" with "XX" being code of the language.

WampServer
FileZilla
http://www.myprestashop.com/product.php?id_product=2
http://www.myprestashop.com/musique-ipods/2-ipod-shuffle.html
See this FAQ from 1&1
md5.fr
http://www.mywebsite/shop/
the flags used in PrestaShop
Your language
ISO
Troubleshooting
How to modify a page's display?
How to create your own page/template?
How to generate the .htaccess file with PrestaShop's back office, in order to get Friendly URL?
In case of unexpected and persistent blank page, how to turn error message display on?
How to correctly import accentuated content using a CSV file?
Hosted at 1&1: How to solve the memory allocation issue?
How to regenerate a password and update the database manually?
How to change the maximum size of uploaded files to your server?
How to add a link or an image to customize the mails sent to your customers?
how to log in after deleting the English language pack?
How to create a new translation