Child pages
  • Comprender los Parámetros avanzados
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 15 Next »

Table contents

Comprender los Parámetros avanzados

Información sobre su configuración

Esta página sirve como un recordatorio útil de la configuración PrestaShop: versión, información del servidor, versión de PHP, versión de MySQL. Todos esta información resulta muy útil cuando necesita informar de un problema a los desarrolladores de PrestaShop, a su webmaster o a su proveedor de hosting.

Hay una última sección, titulada "Lista de archivos modificados". Justo después de haber instalado PrestaShop, la única cosa que esta sección muestra es el mensaje "Ningún cambio se ha detectado en sus archivos."
Pero después de instalar algunos módulos y un par de temas, realizar cambios avanzados en algunas clases  o eliminar algunos archivos, esta lista mostrará las diferencias entre la instalación actual de PrestaShop y su estado prístino. Esto le ayuda a ver los cambios que ha realizado después de su instalación... y por lo tanto saber lo que tiene que tener en cuenta si desea actualizar su tienda de forma manual, o si va a mover los archivos a un nuevo servidor.

Incluso en una instalación nueva, esta sección podría indicar que los archivos ".gitattributes", ".gitignore", "CONTRIBUTING.md", "CONTRIBUTORS.md" or "README.md" no se encuentran. Estos son archivos específicos de Git, y PrestaShop no los utiliza, por lo que no debe preocuparse si recibe este mensaje.

Rendimiento

Esta página combina muchas herramientas y consejos que pueden ayudarle a mejorar el rendimiento de su tienda en el servidor – sin fines comerciales, aunque un servidor que tenga un mayor rendimiento  será capaz de atender a las consultas y peticiones de un mayor número de usuarios, y por lo tanto podría obtener más ventas.

Smarty

Smarty es el nombre del motor de plantillas utilizado por los temas de PrestaShop. Puede aprender más sobre él desde el siguiente enlace: http://www.smarty.net/.

Hay cuatro opciones:

  • Cache de plantillas. Para mejorar el rendimiento front-end, PrestaShop almacena en caché las páginas HTML.
    • Nunca recompilar los archivos de las plantillas. Sólo debe activar esta opción si está editando el tema de su tienda, y no ve   los cambios que está realizando al recargar la página.
    • Recompilar las plantillas cuando los archivos sean modificados. PrestaShop es capaz de saber si un tema ha sido modificado, pero no siempre funciona correctamente.
    • Forzar compilación. El comportamiento normal: las páginas HTML se compilan y son almacenadas en la caché, incluso si el tema ha cambiado.
  • ¿Usar Cache?. Esta opción hace posible que pueda desactivar la caché de todos los archivos, y no tan sólo los que pertenecen a los archivos de la plantilla. Desactive esta opción tan sólo para la depuración de módulos y/o plantillas. En cualquier otro caso, debe dejar esta opción activa.
    La opción "Borrar caché Smarty" apareció en PrestaShop 1.5.5.0, y hace posible borrar la memoria caché con un solo clic de ratón, en lugar de tener que ir borrar los archivos en el servidor FTP.
  • ¿Mostrar consola de depuración?. Novedad en 1.5. PrestaShop le permite mostrar la consola de depuración Smarty, que le proporciona información valiosa sobre una página de plantilla. Lea más sobre esto en el siguiente enlace: http://www.smarty.net/docsv2/en/chapter.debugging.console.tpl. Tenga en cuenta que la consola se abre en una ventana pop-up: asegúrese de que su navegador acepta y permite que se abran este tipo de ventanas que provengan desde el nombre de dominio de su tienda.
    • No abrir la consola. La configuración por defecto. Nadie ve la consola, ni siquiera usted.
    • Abrir la consola con el parámetro URL: SMARTY_DEBUG. La consola sólo es mostrada si añade ?SMARTY_DEBUG al final de la URL (o la clave de su elección, veáse más abajo). Esto es de utilidad, pero una vez que realice las pruebas pertinentes, debe de establecer esta opción a la configuración por defecto, ya que este "truco" es conocido y algunos hackers podrían hacer uso de él. 
    • Siempre abrir la consola. El ajuste "completo". Toda persona que tenga acceso a su tienda puede ver la consola. Por lo tanto, utilice esta opción para sesiones de mantenimiento.
  • Clave de la consola de depuración. Puede cambiar la clave con el fin de ser el único que sabe la clave para mostrar la consola de depuración.

Debido a que la consola de depuración puede mostrar información privada, asegúrese de activarla tan sólo cuando esté en modo mantenimiento. No mantenga esta activa en una tienda en modo producción.

Características opcionales

Novedad en Prestahop 1.5.

Algunas de las características de PrestaShop pueden ser desactivadas si no las utiliza, ya que estas pueden ralentizar su tienda.

Si su catálogo tiene actualmente productos que hacen uso de estas características, no podrá desactivarlas. Tendrá que eliminar esos productos para poder desactivar estas opciones.

Puede desactivar las siguientes funcionalidades de catálogo:

  • Combinaciones. Las combinaciones de productos le pemiten tener una completa línea de productos en un sólo producto: diferentes tamaños, colores, capacidades, etc
  • Características. Las características del producto permiten indicar la información del producto específico: el peso, el material, el país de origen, etc

Combinación, Compresión y Caché (CCC)

CCC es un conjunto de herramientas destinadas a minimizar la carga del servidor y el tiempo de carga del tema de la tienda.

Esto hace lo que dice: combina archivos textuales del mismo tipo en un archivo más grande, lo que lo que reducen el número de archivos para descargar; comprime el archivo utilizando el algoritmo Zip, lo que hace que se descargue más rápidamente; finalmente, se almacena en caché el archivo comprimido, por lo que el servidor no tiene que hacer este proceso cada vez que se carga una página, lo que alivia la carga sobre el procesador del servidor.

Su tema debe ser completamente compatible con al menos PrestaShop 1.4, de lo contrario CCC no funcionará correctamente. Esta es la razón por la mayoría de las opciones están desactivadas de forma predeterminada.

  • "Smart cache" para las hojas de estilo (CSS). Los archivos CSS son archivos de texto, que pueden ser combinados y comprimidos de forma segura.
  • "Smart cache" para el código de JavaScript. Los archivos JavaScript son archivos de textopero su combinación a veces puede resultar problemática. Asegúrese de probar todo antes de dejar activada esta opción.
  • Reducción del código HTML. El código HTML generado por Smarty puede ser reducido, lo que significa que PrestaShop eliminará todos los espacios en blanco con el fin de ahorrar unos cuantos bytes. Este es un proceso seguro.
  • Compresión del JavaScript dentro del código HTML. Algunos temas tienen el código JavaScript directamente dentro del código HTML. Puede dejarlo tal como está, o comprimirlo. Asegúrese de probar todo antes de dejar activada esta opción.
  • Compresión máxima del código HTML (alto riesgo)Esta opción está marcada como de "alto riesgo", porque al comprimir el código HTML,   este dejará de cumplir los estándares de la web. Utilice esta opción bajo su propio riesgo: algunos motores de búsqueda no analizar correctamente los sitios web que no respetan los estándares HTML, lo que puede afectar a su posicionamiento en los resultados de búsqueda. Utilice esta opción con precaución.
  • ¿Optimizar Apache?. Este ajuste modificará el archivo de configuración del servidor web con el fin de hacerlo más eficiente para CCC.

Servidores multimedia (válido únicamente cuando CCC está activado)

Esta sección le permite redirigir parte de su tráfico (imágenes y archivos de vídeo, por ejemploa otros servidores bajo su control, a través de otros dominios o subdominios – generalmente, los archivos están alojados en un CDN (Content Delivery Network). Por defecto, PrestaShop soporta hasta 3 servidores multimedia.

Poner el nombre de dominio de su tienda en estos campos no es la forma apropiada para conseguir un fantástico rendimiento. Dicho esto, es fácil implementar un servidor multimedia, y obtener sus beneficios reales de manera casi inmediata. He aquí cómo conseguirlo:

  1. Abra una cuenta con una empresa de hosting, preferiblemente que esté especializada en el contenido distribuido. Las más populares son Akamai (http://www.akamai.com/), Amazon (con sus servicios AWS, entre los que se incluye CloudFront: http://aws.amazon.com/) o CloudFlare (http://www.cloudflare.com/). También debe preguntar a su proveedor de hosting , sobre la posibilidad de suscribirse a una red de entrega de contenidos CDN.
  2. Copie sus archivos multimedia en el servidor de ese host. Esto significa que el servidor CDN debe contener una copia exacta de las siguientes carpetas del servidor principal de su tienda: /img, /themes y /modules.
    Advertencia: Asegúrese que estos archivos estén siempre sincronizados: incluso si añade nuevos productos o cambia de tema, el servidor CDN debe contener la última versión de estos archivos.
  3. Una vez que el servidor CDN ha sido establecido correctamente, añada la dirección web (proporcionada por su proveedor de hosting CDN) en el primer campos, "Servidor multimedia n°1". Si ese host permite más direcciones web, añadalas.

En caso de que quiera que sus archivos se carguen siempre visualmente a partir de su nombre de dominio y no de un dominio desconocido, siga el siguiente proceso:

  1. Cree un subdominio para el nombre de dominio de su tienda, por ejemplo http://cdn1.mystore.com (la forma de crearlo dependerá de su proveedor de hosting, pongase en contacto con el soporte técnico para que le expliquen como hacerlo).
  2. Añada un archivo .htaccess en la raíz del subdominio. Este archivo debe contener una sola línea:

    Redirect Permanent / http://cdn-adresse.com


    Reemplace la dirección http://cdn-adresse.com por la de su servidor CDN. De esta manera, está creando una redirección automática de su subdominio en el servidor CDN.

  3. Una vez que el subdominio ha sido establecido, añada este en el primer campo, "Servidor multimedia n°1". Si ese host permite más direcciones web, crear tantos subdominios como quiera para su dominio principal.

Cifrado

Cifrar significa codificar o encriptar una información, de manera que esta sea ilegible para las personas que no deban tener acceso a esta . Los datos de las cuentas de sus clientes, así como los suyos, están protegidos mediante cifrado.

Desde aquí puede elegir el algoritmo que prefiera utilizar:

  • Utilizar Rijndael con la librería mcrypt. La opción por defecto. Rápida y segura.
  • Utilizar la clase BlowFish de PrestaShop. Ofrece mayor seguridad, a costa de sacrificar el rendimiento ya que este toma más tiempo para validar la autenticación, cada vez que se carga una página. Sus clientes agracerán que añada mayor seguridad a su tienda, pero no les gustará que su tienda sea tan lenta al cargar las páginas – aunque la diferencia no es muy notable.

Haga pruebas, y elija una de estas opciones.

Cache

La caché de sus servidores almacenan versiones estáticas de su página web dinámica, con el fin de servir estas a sus clientes, reduciendo la carga del servidor y los tiempos de compilación.

En la mayoría de los casos, debe verificar si su proveedor de hosting permite esta opción, ya que requiere de una configuración especial en el servidor.

Esta sección le permite activar el almacenamiento en caché, y elegir el método de almacenamiento en caché:

  • MemcachedUn sistema de almacenamiento en caché distribuido. Muy eficaz, especialmente si utiliza múltiples servidores, pero necesita asegurarse que su servidor/host lo soporta – lo que es probable, si su configuración de PHP soporta o cuenta con la extensión Memcached PECL  (la cual puede descargar desde aquí: http://pecl.php.net/package/memcache). Puede añadir más servidores Memcached haciendo clic en el botón "Añadir servidor".
  • APC. La Alternative PHP Cache es gratuita, abierta y robusta, pero sólo funciona con un servidorque es el caso habitual al iniciar un negocio online. Compruebe la disponibilidad de la extensión APC PECL en su servidor: http://pecl.php.net/package/APC.
  • Xcachees un nuevo sistema de caché, que es específica para el servidor Lighttpd – por lo tanto, no funciona con el popular servidor Apache. Obtenga más información sobre esta, en el siguiente enlace: http://xcache.lighttpd.net/.
  • Sistema de archivos. Los archivos estáticos son almacenados simplemente como cualquier otro archivo, en el servidor.

Las últimas tres opciones muestran un campo configurado en "1" de forma predeterminada. Esta es la profundidad del sistema de archivos. No cambie este valor a menos que sepa lo que está haciendo.

Correo electrónico

Correo electrónico

La primera opción, "Enviar correo electrónico a" concierne al front-end. En el paso final del proceso de compra, el cliente puede dejar un mensaje al personal de su tienda. Puede especificar a quien puede enviar estos  mensajes desde la lista desplegable.

El resto de esta sección le permite configurar PrestaShop para enviar correro electrónicos a sus clientes. Le recomendamos que consulte estas opciones con su proveedor de hosting, para determinar qué configuración utilizar para esta función.

Su tienda envía muchos mensajes desde que se inicia el proceso de registro hasta la realización de un pedido. Aquí puede configurar cómo se enviarán los mensajes. Por defecto, es aconsejable utilizar la segunda opción, "Usar la función mail() de PHP".

En caso de que este no funcione, utilice la tercera opción, "Establecer mis propios parámetros SMTP". En este caso, aparece una nueva sección, con más campos. La información de estos campos debe ser proporcionada por su proveedor de hosting : nombre del servidor del dominio, servidor SMTP, usuario SMTP, etc. Asegúrese de transcribir exactamente los datos proporcionado por su proveedor.

La información de configuración debe ser proporcionada por una de estas entidades:

  • Su administrador del sistema
  • Su host
  • Su ISP
  • Su proveedor de correo electrónico.

Su proveedor le puede decir si su nombre de usuario es obligatorio o no, así como proporcionarle información sobre su contraseña y el cifrado a utilizar.

Por ejemplo, en el caso de Gmail (el servicio de correo electrónico ofrecido por Google), debe introducir una información similar a la siguiente:

  • Servidor SMTP: smtp.gmail.com
  • Usuario SMTP: [email protected] (ejemplo)
  • Contraseña SMTP: RT22UE87 (ejemplo)
  • Cifrado: SSL
  • Puerto: 465

Comprobar la configuración de correo electrónico

Una vez que-ha configurado su dirección de correo electrónico utilizando uno de los dos métodos disponibles, introduzca su propia dirección de correo electrónico en esta sección, a continuación haga clic en el botón "Enviar un email de prueba".
Ahora compruebe la bandeja de entrada de la dirección especificada, para verificar que  ha recibido el correo electrónico de prueba. Si no lo ha recibido, modifique la configuración con la información correcta.

Multitienda

Esta página está disponible si se ha activado la función multitienda.

Convertir su tienda PrestaShop en una multitienda es muy sencillo:

  1. Diríjase al menú "Preferencias" y seleccione la página "General".
  2. Encuentre la opción "Activar multitienda", seleccione "Si".
  3. Guarde el cambio realizado.

El menú "Parámetros avanzados" mostrará ahora la página "Multitienda", que se explica en detalle en el capítulo "Gestionar varias tiendas" de esta guía.

Importar archivos CSV

CSV es un acrónimo de "valores separados por comas". Es es un un archivo de texto plano que se utiliza cuanto hay una necesidad de importar, exportar o simplemente almacenar datos en un formato no propietario. Puede obtener mayor información sobre el formato CSV en el siguiente enlace de la Wikipedia: http://es.wikipedia.org/wiki/CSV.

La página de importación de archivos CSV le permite rellenar de una manera sencilla y rápida su catálogo de productos, lo que es de mucha utilidad cuando tiene una gran cantidad de productos, o quiera importar datos desde otra herramienta e-commerce.

El proceso de importación requiere de la preparación del archivo CSV, y cumplimentar el formulario que presenta la configuración principal:

  • Su archivo CSV. Puede importar más de un archivo al mismo tiempo, pero asegúrese de que todos ellos tienen el mismo tipo de datos.
    Existe un enlace denominado "Haga clic para ver nuestros ejemplos de archivos de importación csv" situado justo debajo del botón "Cargar"Haga clic en él para visualizar más enlaces: puede descargar archivos de ejemplo para cada tipo de datos, que le ayudarán a asegurarse de que los archivos que va a importar están preparados para ser importados a PrestaShop. Estos archivos se encuentran en realidad en la carpeta /docs/csv_import de su instalación de PrestaShop.
  • ¿Qué tipo de entidad desea importar?. Las entidades son los tipos de datos que se pueden importar. PrestaShop le permite importar estos tipos de datos:
    • Categorías,
    • Productos,
    • Combinaciones (que fueron llamado "versiones" en las versiones anteriores a PrestaShop 1.5),
    • Clientes,
    • Direcciones,
    • Fabricantes,
    • Proveedores,
    • Pedidos a proveedores (si la Gestión avanzada de stock está activada),
    • Detalles de pedidos a proveedores (si la Gestión avanzada de stock está activada).
  • Idioma del archivo. Los datos solamente pueden ser importados para un simple idioma al mismo tiempo. Si sus datos utilizan más de un idioma, debe dividirlos en tantos archivos como idiomas tenga.
  • ¿Codificación iso-8859-1 de archivo?De forma predeterminada, los archivos de importación deben utilizar la codificación UTF-8. Pero si sus archivos utilizan la norma ISO-8859-1 y  prefiere no convertirlos, puede marcar esta casilla.
  • Separados de campos. No todos los archivos CSV utilizan comas para separar sus valores: algunos utilizan tabulaciones, otros punto y coma, etc. Puede indicar qué separador utiliza en este campo.
  • Separador de valor múltipleCuando un atributo puede soportar más de un valor, estos valores deben ser separados con un separador específico. Después de revisar sus archivos, indique su separador aquí.
  • ¿Eliminar todo categorías antes de importar?. Esta opción eliminará todas las entradas previamente existentes del tipo de datos que está importando. Esto le ayuda a partir de cero.
  • ¿Forzar todas las ID's durante la importación?. Puede mantener los IDs importados, o dejar que el importador autoincremente estos.
  • ¿Usar la referencia del producto como clave?. Sólo para la importación de productos.  Puede optar por dejar que PrestaShop determine la clave del producto, o que la clave del producto sea el ID del producto  . En este caso, asegúrese de que el archivo contiene la ID en todos los productos que quiera importar .

Cuando cambie el ajuste Entidad, la sección de la derecha, titulada "Campos disponible", cambios para presentar los campos de datos que se espera. Aunque la herramienta de importación está diseñada para ayudar a Prestashop a encontrar los campos en el archivo  , debe esforzarse para que la importación de datos sea lo más amigable posible , siguiendo el esquema de nombres y el orden de los campos presentados. En caso de que esto no sea así, la importación de datos será más tediosa, pero no imposible.
Algunos de estos campos tienen un pequeño icono de información que muestra una ventana emergente al situar el ratón por encima de estos. La gran mayoría de ellos hacen referencia a la característica multitienda de PrestaShop. Asegúrese de leer estas informaciones  para crear / editar los archivos de datos de forma correcta.

Formato de datos

Los datos importados deben estar en un archivo de texto con extensión .csv, con los distintos valores de campos debidamente separados. Le recomendamos que utilice un punto y coma ";" como separador.

Puede crear un archivo de este tipo con cualquier editor de texto (le recomendamos Notepad++: http://notepad-plus-plus.org/), pero le aconsejamos que utilice un programa que le permita trabajar con hojas de cálculo, y posteriormente guarde su trabajo en formato .CSV. En una hoja de cálculo puede trabajar visualmente más rapido, en comparación con un archivo de texto plano. Puede utilizar un programa de pago como Microsoft Excel (http://office.microsoft.com/en-us/excel/ o bien una alternativa libre y gratuita como OpenOffice Calc http://www.openoffice.org/.

Aquí tiene un ejemplo de como sería el resultado final de un archivo preparado para importar una lista de productos:

"Enabled";"Name";"Categories";"Price";"Tax rule ID";"Buying price";"On sale";"Reference";"Weight";"Quantity";"Short desc.";"Long desc";"Images URL"
1;"Test";"1,2,3";130;1;75;0;"PROD-TEST";"0.500";10;"'Tis a short desc.";"This is a long description.";"http://www.myprestashop/images/product1.gif"
0;"Test 02";"1,5";110;1;65;0;"PROD-TEST2";"0.500";10;"'Tis also a short desc.";"This is a long description too.";"http://www.myprestashop/images/product2.gif"
1;"Test 03";"4,5";150;1;85;0;"PROD-TEST3";"0.500";10;"'Tis a short desc. again";"This is also a long description.";"http://www.myprestashop/images/product3.gif"

Tenga en cuenta que este es un ejemplo de muestra; que no ha sido optimizado para su importación en PrestaShop. Si necesita archivos de ejemplo en la que basar sus propios archivos de importación, utilice los que aparecen en el enlace denominado "Haga clic para ver nuestros ejemplos de archivos de importación csv" situado justo debajo del botón "Cargar".

La primera línea debe ser un nombre descriptivo para la columna de datos (que posiblemente no se tome en cuenta durante el proceso de importación). Debe haber el mismo número de columnas en cada línea.

Debe recordar que:

  • La columna de precios usará la moneda por defecto de su tienda.
  • Las categorías son indicadas utilizando su identificador existente (por lo que es necesario importarlos primero), y separadas por comas;
  • La dirección URL de las imagenes deben especificarse completamenteEn otras palabras, el enlace que se utilice debe ser el que se utiliza en el navegador  para mostrar la imagen. Por ejemplo: http://www.miprestashop/imagenes/productoXXX.gif.
  • La Codificación de caracteres del archivo debe ser UTF-8, o ISO-8859-1 en el peor de los casos.
  • Las fechas utilizan el formato ISO 8601sin un designador de zona horaria (la zona horaria es la que utiliza su tienda): 2013-06-21 15:07:27.

Cargar el archivo

Once you have all your data in CSV format, you can upload them to your store's database using the form in this page. Choose your file(s) from your computer by clicking on the "Upload" button, click the "Browse" button to find your file, then click the "Upload" button to mark it as chosen. Do this as many times as necessary to list all your import files.

Once your files are all listed in the "Your CSV file" section, you can proceed with the rest of the form:

  1. Select the type of data contained in your file, using the drop-down list named "What kind of Entity would you like to import?". Once you have selected the type of data, the list of the available fields appears on the right, which helps you refine your CSV file – at least for the order of the columns, which will soon prove handy.
  2. Select the language of the imported content. If the target language is not available, you must install it first, in the "Languages" page under the "Localization" menu.
  3. Select the file encoding. Simply indicate if the file uses ISO-8859-1 or not. If not, then it is assumed the files use UTF-8.
  4. Select the field separators. We suggest that you leave the default values ("field separator" with a semicolon ";", "multiple value separators" with a comma ","). But obviously, if your CSV file is built differently, you should change these values accordingly.
  5. If you want to remove all the products in your catalog before importing, select the appropriate option.
  6. Once all your choices have been made, click "Next step".

All import files are uploaded directly in the admin folder's /import sub-folder. If the CSV File drop-down menu gets too crowded, you can delete old imports directly using your FTP client.

When clicking the "Next step" button, the page reloads with the matching tool. This interface helps you match you file's data columns with the ones required by PrestaShop.

Presented in this table are the rows from your CSV file, placed under arbitrary columns matched to PrestaShop's database needs. It is up to you to make sure that all the columns from your CSV file are matched with the correct column header, using each header's drop-down menu, so as to import your content correctly.

For instance, with our sample file:

  • First column. We marked it as "Enabled", PrestaShop presents "ID" as a header. Click on the header's drop-down menu, and select "Active (0/1)".
  • Second column. Marked "Name", header indicates "Active (0/1)". Let's change the header for "Name *".
  • Third column. You get the idea...

The screen cannot contain all of your data's columns, so click the ">>" and "<<" buttons to move around the columns, and match them all correctly.

In our example, we used the first row for columns indicators. Since we do not this one imported, enter "1" in the "Skip X lines" text-field.

Once you are done matching your columns, click the "Import .CSV data" button (top right of the screen), and PrestaShop will start the importing process. When the process is done, you are sent to the main screen, which should either confirm that everything has indeed been imported, or give you a notice of all the encountered problems. In this second case, you should review your CVS file and make sure to correct everything.

Matching configurations

The matching process can be a tedious task if you cannot customize your CSV files columns order according to that used by the PrestaShop importer, and even more so if you have to do that repeatedly or frequently. That is why PrestaShop includes a small tool to save the current matching order that you have set up using all the headers drop-down menus.

The tool is a simple field at the top of the matching tool. You can do the three basic actions:

  • Saving. Enter a descriptive name in the field, and click "Save". The interface updates to feature the saved configuration in its drop-down list.
  • Loading. Select a matching configuration in the drop-down list, and click "Load".
  • Deleting. Select a matching configuration in the drop-down list, and click "Delete".

DB backup

A backup is the action of saving the content of your database into files that you store in a safe place. The point is that you can revert to them in case your database fails on you.

You must perform regular backups of your shop, so that in case of a crash, you can reboot your shop quickly and in the best conditions. The database contains all the information in your shop, many of which are indispensable for PrestaShop to work correctly – and that's not talking about your products, categories and other data you added since the installation.
The more often you perform backup, the safer you are. Once a week is a minimal frequency.

To create database backups of your shop, you have several solutions. You can use tools such as phpMyAdmin (reserved for advanced users), or use the one integrated into PrestaShop: the "DB backup" page.

The page starts with two big notices. You should read both completely in order to have a better idea of what the page does.

The "Disclaimer" section on the left gives you a series of reminders about backups, which you should read every time you make a backup. The section ends with the "I have read the disclaimer - Create a new Backup" button, which you have to click in order to create a backup. Once created, the backup appears in the list below the notices.

The "How to restore" section on the right gives you tips on how to get your data back into PrestaShop in case of failure. You should commit this to memory, or at least save this information somewhere in case a database crash makes it impossible for you to access the PrestaShop administration – and thus the DB backup page – again.

The table below the notices lists all the backups that have already been made, indicating the date of creation, age, file name and size.
At the right of each row are two icons:

  • The 'view' icon enables you to download this backup.
  • The 'trash' icon enables you to delete this backup. Be careful, there is no turning back.

After each backup process, you should download the generated backup file by clicking on its "View" icon, or simply by using the link in the notification box at the top.

Your database is saved using the standard SQL format and its .sql file extension, and compressed using the BZip2 algorithm (simply put, a variant of the popular Zip format. Read more: http://en.wikipedia.org/wiki/Bzip2) and its .bz2 file extension. That gives a file archive with the .sql.bz2 file extension.
Put your backup file in a safe place, for you might need it at any given time. Furthermore, you can find these backups directly on your server, in the /backup folder, under your custom-named /admin folder.

Backup Options

At the bottom of the screen, two options are available:

  • Ignore statistics tables. PrestaShop stores your site's statistics in a handful of database tables, and these can grow big quite quickly. While it can be sound to keep your stats in a safe place, they also make for huge files to download, while you are probably more interested in a backup of your products, categories, customers, orders, etc.
    By default, PrestaShop backups all tables, but if you are short on disk space on your web server, change this option to "Yes".
  • Drop existing tables during import. When importing a backup file, the system can either overwrite the existing live tables with the content of the ones that were backed up, or delete all existing in order to replace them with the content of the backup. The first case can result in doubles, which is why this option is enabled by default.

SQL Manager

New in 1.5.

The SQL manager is a complex feature, which should be reserved to technical people who know how to explore a database using the SQL language. In return for this complexity, it can be extremely powerful and prove immensely useful to those who master it.

This tool enables you to perform SQL queries directly on the PrestaShop database, and save them for use at any later time. Indeed, PrestaShop presents its database data in many ways, but you might need something more, or more simply, something rawer than PrestaShop's clean interface. Using the SQL manager you can perform complex queries which build upon tables of data in the way YOU need them.
For instance, using this tool and your knowledge of SQL, you could create a reusable query giving you an updated list of the clients who are subscribed to your newsletter, or get a list of products in HTML or CSV format.

For security reasons, some types of queries are not allowed: UPDATE, DELETE, CREATE TABLE, DROP, etc. In short, you can only read data (SELECT query).

Also, secure keys or passwords are hidden (***********).

Creating a new query

As usual, the "Add New" button leads to the creation form. It has two main fields:

  • Name. Make the name as long and descriptive as necessary.
  • Request. The SQL query itself. You are free to perform JOINs or other intricate selections.

Additionally, the "List of MySQL Tables" section helps you explore the database, and makes it easier for you to build your queries. It gives you a handy and clickable selector of all the currently available database tables. Select a table to make PrestaShop display its attributes and types, then click "Add attribute" to send its name into the "Request" field.

Saving the form sends you back to the main page, with its list of queries.

Starting a query

Each saved query in the table has four icons to the right of its row:

  • Export. Performs the query, and has it downloaded by you in CSV format.
  • View. Performs the query, and has it displayed in an HTML table, right within the PrestaShop interface.
  • Edit. You can edit a query as often as necessary, in order to refine it and get better results.
  • Delete. Once a query is not used anymore (or simply because it does not work), you can delete it by clicking this button and confirming your choice.

Settings

There is only one setting at this time:

  • Select your encoding file by default. You can configure the character encoding of the downloaded CSV file. The default, UTF-8, is recommended, but you can select ISO-8859-1 if need be.

Some sample queries

The possibilities are endless, but here are a few sample queries to help you build your own.

Listing all the e-mails address of all the customers

SELECT email FROM ps_customer

Listing all the e-mails address of all the customers who are subscribed to your newsletter

SELECT email
FROM ps_customer
WHERE newsletter = 1

Listing all the products which are active and have a description in French

SELECT p.id_product, pl.name, pl.link_rewrite, pl.description
FROM ps_product p
LEFT JOIN ps_product_lang pl ON (p.id_product = pl.id_product)
WHERE p.active = 1
AND pl.id_lang = 4

Listing all the orders, with details about carrier, currency, payment, total and date

SELECT o.`id_order` AS `id`,
	CONCAT(LEFT(c.`firstname`, 1), '. ', c.`lastname`) AS `Customer`,
	ca.`name` AS `Carrier`,
	cu.`name` AS `Currency`,
	o.`payment`, CONCAT(o.`total_paid_real`, ' ', cu.`sign`) AS `Total`,
	o.`date_add` AS `Date`
FROM `ps_orders` o
LEFT JOIN `ps_customer` c ON (o.`id_customer` = c.`id_customer`)
LEFT JOIN `ps_carrier` ca ON (o.id_carrier = ca.id_carrier)
LEFT JOIN `ps_currency` cu ON (o.`id_currency` = cu.`id_currency`)

Logs

Errors happen. Most of the time, you are not aware of them because PrestaShop handles them silently. But you might want to know about them, in order to be able to correct the most regular ones, and insure a better stability for your shop.

The "Logs" page is where you can have a look at the PHP errors which plague your shop. They are listed in the page's central table, and are presented in 4 levels:

  • 1: Informative only. Run-time notices. Indicate that the script encountered something that could indicate an error, but could also happen in the normal course of running a script.
  • 2: Warning. Run-time warnings (non-fatal errors). Execution of the script is not halted.
  • 3: Error.
  • 4: Major issue (crash). Fatal run-time errors. These indicate errors that cannot be recovered from, such as a memory allocation problem. The execution of the script is halted.

These explanations are the official ones from the PHP manual. Read more: http://www.php.net/manual/en/errorfunc.constants.php.

These error levels also serve as values for the "Logs by e-mail" feature.
PrestaShop adds one last value, 5, which indicates that the administrator does not want to receive any notification, either for minor or major errors.

The error logging tool enables you to receive a notification when an error occur. Notifications are sent to the shop owner's e-mail address, and you can configure the degree of importance at which you should start receiving such e-mails: use "1" if you want to know about everything, even the tiniest information; "3" if you only want to know about issues (errors and major issues); "4" if you only want to keep the major issues. The default is "5", meaning that no notification is sent.

Webservice

A Web service is a method of communication between two electronic devices over a network. It relies on a known set of methods, formats and access rights, so as be able to use the webservice's content on any other authorized tool, and build upon the original content. Read more about it on Wikipedia: http://en.wikipedia.org/wiki/Web_service.

In this page, you can enable your shop's webservice, so that third-party tools can access your data. This potentially makes it possible for interesting tools to help you or your customers make better use of your shop (such as mobile applications).

The page starts by listing the currently existing webservice keys in a table. A webservice key is a unique access that you grant to a developer, which can be used to tie a tool to your shop. Share them sparingly, as you might not always want everyone to access your data.

Not any app can access your shop through the PrestaShop webservice: you decide which can, and what they are allowed to do. Every app has a unique connection key, with specific access rights.

Adding a new key

The "Add new" button takes you to the webservice key creation form:

  • Key. A unique key. You can either create your own, or choose to use a generated one, for instance by clicking the "Generate" button or by using any online key generator. Generated keys are most of the time safer, because they are harder to guess.
  • Key description. A reminder of who that key is for, and what it gives access to.
  • Status. You can disable a key anytime. This enables you to only temporarily grant access to your data from a certain key.
  • Permissions. You do not have to share ALL your date with each key. You can choose among a wide array of permissions, either by section or by type of access. You might want some applications to only be able to view a handful of items, while some others (for instance, ones that you would use to manage the shop remotely) should be able to edit and delete just about everything. Choose wisely.

Configuration

For security reasons, make sure your shop's server supports secure SSL connection!

The configuration is pretty easy:

  • Enable PrestaShop Webservice. If you do not want anyone to access your shop through third-party tools and applications, just keep it disabled.
  • Active mode CGI for PHP. The CGI mode is a special setting for the Apache server, where you tell it to use PHP as a CGI script rather than an Apache module. While the CGI mode has a reputation of being more secure, it has been found to have a security flaw as recently as May 2012. Ask your web host for advices.

Developers can find our documentation on how to build a tool around PrestaShop's webservice at this address: http://doc.prestashop.com/display/PS15/Using+the+PrestaShop+Web+Service.

  • No labels