Tabla de contenidos

Actualización automática

La herramienta de actualización automática de Prestashop permite a los propietarios de tiendas hacer copias de seguridad y actualizar su sitio en pocos clics sin la necesidad de tener conocimientos técnicos.

El módulo 1-Click Upgrade debería de estar disponible de forma predeterminada en la página "Módulos" de su tienda (dentro de la categoría "Administración"): simplemente realizando un clic en el botón Instalar perteneciente a éste módulo, podrá utilizarlo para actualizar a la última versión de PrestaShop.

Nunca actualice su tienda online directamente. La herramienta de actualización automática puede fallar en algunas situaciones, y probablemente no podría volver a la versión anterior que tenía instalada.

La forma más segura de realizar este proceso es tener disponible una copia exacta de su tienda, ya sea en el equipo local o en otra carpeta de su servidor web. Ésta deberá contener todos sus productos, categorías, temas, módulos, traducciones, ajustes personalizados, etc.

Realice una actualización de prueba sobre esa copia de su tienda. Una vez que la actualización se haya completado, navegue a través de las páginas del front office y back office de la tienda para asegurarse de que todo está tal y como esperaba. Si no es así, entonces la herramienta de actualización automática tiene un problema con su configuración, y debería utilizar el método manual de actualización, que ahora está obsoleto y requiere de más tiempo, pero que podría serle de ayuda en su situación.

Descarga e instalación del módulo 1-Click Upgrade

Si el módulo 1-Click Upgrade no está disponible en su instalación de PrestaShop 1.4 o 1.5, puede descargarlo gratuitamente desde el sitio web de Complementos de PrestaShop (PrestaShop Addons).

Incluso si ya tiene instalado el módulo "1-Click upgrade", asegúrese de que está utilizando la última versión disponible:

PrestaShop 1.4: Compruebe el número de versión en la pestaña "Módulos", a continuación comparelo con el número de versión que aparece en el sitio web de Complementos de PrestaShop (véase más abajo). Si los números son diferentes y la versión que tiene instalada es menor de la que está disponible en el sitio web de Complementos, descarguela y actualice el módulo.
- Para actualizar el módulo: desinstálelo y elimínelo desde el Panel de Administración de PrestaShop, a continuación, copie la carpeta "/autoupgrade" desde el archivo del módulo (que ha descargado desde el sitio web de Complementos) a la carpeta "/modules" de su instalación de PrestaShop. Por último, instale el módulo desde el Panel de Administración.
PrestaShop 1.5 y versiones posteriores: PrestaShop se conectará automáticamente al sitio web de Complementos para comprobar si existen nuevas versiones de sus módulos. Si una nueva versión está disponible, se presentará un nuevo botón "¡Actualícelo! (Actualizar)" justo al lado del botón "Instalar / Desinstalar". Haga clic en él para que PrestaShop se encargue de descargar y actualizar el módulo por usted.

Tan sólo tiene que seguir los pasos que realiza habitualmente para instalar un módulo en PrestaShop:

Descargue el módulo 1-Click Upgrade desde PrestaShop Addons: http://addons.prestashop.com/es/administracion-prestashop-modulo/5496-1-click-upgrade-autoupgrade.html. Guarde el archivo Zip en su escritorio.
En su Panel de Administración de PrestaShop, diríjase a la página "Módulos" del menú "Módulos".
Haga clic en el botón "Añadir nuevo módulo", situado en la parte superior derecha de la lista de módulos disponibles.
Si está actualizando desde la version 1.4, haga clic en el enlace "Añadir un nuevo módulo a partir de mi ordenador", situado en la parte superior izquierda.
En el formulario que se abre, haga clic en el botón "Seleccionar (Elegir un fichero)...", a continuación, busque y seleccione el archivo Zip del módulo que acaba de descargar.
Haga clic en el botón "Subir este módulo". PrestaShop pondrá el módulo en su servidor, lo descomprimirá, y colocará los archivos en la carpeta /modules.

El módulo estará ahora disponible en el listado de módulos, pero todavía tendrá que instalarlo:

En la pestaña "Módulos", encuentre el módulo 1-Click Upgrade: teclee "1-click upgrade" o "autoupgrade" en el cuadro de búsqueda de módulos (no lo haga en la búsqueda global en la parte superior). Un enlace directo al módulo debería aparecer a medida que escribe. Haga clic sobre dicho enlace.
PrestaShop a continuación, mostrará el módulo en el listado principal de módulos.
Haga clic en el botón "Instalar" del módulo.

El módulo está ahora preparado para que lo configure y lo utilice.

La pantalla de configuración

La pantalla de configuración del módulo está disponible en el listado de "Módulos", haciendo clic en el botón o enlace "Configurar".

La pantalla de configuración también está disponible en:

PrestaShop 1.4: bajo la pestaña "Herramientas", en la subpestaña "1-Click Upgrade".
PrestaShop 1.5 y posterior: bajo los "Parámetros avanzados", en la página "1-Click Upgrade".

La pantalla de configuración le presenta una serie de secciones, proveyendo información, herramientas y ajustes.

Bienvenido

Esta pequeña sección sirve como recordatorio de que una actualización nunca es 100% segura, y por lo tanto usted debe asegurarse de que ha hecho una copia de seguridad completa de sus archivos y datos antes de realizar este proceso. De esta manera, si la actualización fallará, podría regresar al estado inicial de su tienda shop – aunque con un poco de trabajo volviendo a poner los archivos y datos en su lugar correspondiente.

Este proceso se explica en detalles en el capítulo "Cómo realizar y restaurar su propia copia de seguridad" de esta guía: http://doc.prestashop.com/display/PS16/Making+and+restoring+your+own+backup.

PrestaShop 1.6 > Automatic update > upd001-welcome-en.png

Tenga en cuenta que el módulo 1-Click Upgrade realiza una copia de seguridad propia, con el fin de permitir la reversión total de la actualización. Sin embargo, usted siempre debe realizar sus propias copias de seguridad.

La lista de comprobación previa a la actualización

La sección "comprobación pre-actualización" le proporciona información valiosa sobre la instalación actual de PrestaShop, y cómo ésta podría interactuar con la actualización automática.

PrestaShop 1.6 > Automatic update > upd0002-checklist-en.png

Deberá asegurarse de que todas las comprobaciones se validan antes de poder iniciar la actualización.

El módulo 1-click upgrade está actualizado (su versión actual es x.x). Indica si es necesario actualizar el propio módulo de actualización. Si acaba de instalarlo, hay pocas posibilidades de que tenga que actualizarlo.
Si no tiene la última versión del módulo, un botón aparece debajo de este campo, advirtiendo de que "Instale la última versión haciendo clic 'Añadir a partir de mi ordenador'". Al hacer clic será redirigido a la página "Módulos". Desde dicha página, haga clic sobre el enlace "Añadir módulo a partir de mi ordenador" para revelar el formulario correspondiente tras la precarga de la página. Haga clic en el botón "Descargar este módulo" para iniciar la actualización del módulo. Finalmente, regrese a la página de configuración del módulo 1-Click Upgrade para continuar la realización de comprobaciones previas a la actualización.
El directorio raíz de su tienda debe tener permisos de escritura (permisos CHMOD apropiados). Indica si los permisos de lectura / escritura están correctamente establecidos. Si no lo estuvieran, tendrá que cambiarlos, utilizando un cliente FTP, como por ejemplo FileZilla.
Consulte la sección "Compatibilidad y Configuración del Sistema" de la Guía de Introducción dentro del capítulo "Instalación de PrestaShop", para obtener una rápida explicación de cómo realizar un CHMOD.
La opción PHP "Modo seguro" debe estar deshabilitada.
La opción PHP "allow_url_fopen" debe estar habilitada o CURL debe estar instalado.
Debe poner su tienda en modo de mantenimiento. Indica si su tienda está activa o en modo de mantenimiento. Recuerde poner su tienda en modo mantenimiento mientras se está realizando el proceso (copia de seguridad de archivos, copias de seguridad de base de datos, actualización automática, verificación), con el fin de evitar que los clientes puedan perder pedidos... y prevenirle a usted la perdida de clientes. El módulo puede desactivar su tienda por usted: Simplemente haga clic en el botón "Haga clic aquí para poner su tienda en mantenimiento". También puede optar por desactivar la tienda manualmente, utilizando la página de preferencias de la tienda:
- PrestaShop 1.4: activar/desactivar la tienda, en la pestaña principal "Preferencias".
- PrestaShop 1.5 y superior: activar/desactivar la tienda, en la página "Mantenimiento", bajo el menú "Preferencias".
Debe deshabilitar las características de almacenamiento en caché de PrestaShop. Indica si la caché de su tienda está activada o desactivada. Debe desactivarla durante todo el proceso. El módulo no lo hará por usted.
- PrestaShop 1.4: activar/desactivar la caché, en la página "Rendimiento", bajo la pestaña "Preferencias".
- PrestaShop 1.5 y superior: activar/desactivar la caché, en la página "Rendimiento", bajo el menú "Parámetros avanzados".
The PHP time limit is high or disabled (Current value: xxx). The automatic upgrade can be a lengthy process, as it needs to download the archive from prestashop.com, unzip it on the server, replace the currently installed files, then trigger the update itself. Hence, the PHP settings might be too low, and break the upgrade altogether, mid-process at worse. In this field, PrestaShop gives you an indication of the current PHP settings. Ideally, it should indicate "disabled".

All these indicators must be green for the upgrade to work. Otherwise, the upgrade button will not appear.

When your store is hosted on your local server (http://localhost or http://127.0.0.1), the auto-upgrade module understands that the maintenance mode is not required, since no one else than you can access the site. Therefore, even if you are not in maintenance mode, the module marks that check as valid.

Start your Upgrade

This section compares your version of PrestaShop with the latest stable one. You can quickly see whether you need to update or not. If you know that there is a newer version available than the one presented, you can trigger a version check by clicking the "Check if new version available" button.

PrestaShop 1.6 > Automatic update > upd003-versions-en.png

By default, the update tool is set to update your store to the next minor version. This means that if you use a version from the 1.4.x branch, it will not suggest the latest 1.6.x version, but rather the latest 1.4.x version. Therefore, if you want to update from a 1.4.x version to the latest 1.6.x version, you must click on the "More options (Expert mode)" button. This will open a new section, named "More options (expert mode)", where you can choose the distribution channel to which you want to update.
This is also very useful if you want to check for a version other than a stable one (for instance, beta, RC or any other unstable version).

Before launching the upgrade, you must make sure that you understand its settings. The "Backup options" and "Upgrade options" sections are available at the bottom of the page (and are described later in this chapter). Make sure you understand them all.

Expert mode

This section enables you to pinpoint exactly to which version you want to upgrade your current PrestaShop installation.

PrestaShop 1.6 > Automatic update > upd004-advanced-en.png

The options are:

Channel. Choose the distribution channel that you want to use. The recommended selection is "Minor releases", which means "any stable release above the current one". The other options are:
- Major releases. The next stable releases from the latest branch: since the current branch is 1.6.x, the update tool would use the latest 1.6 version (as of this writing, v1.6.0).
- Minor releases. This is the default setting. Uses only the next stable release within the current branch: if you have PrestaShop 1.4.2, it will update your shop to v1.4.9, even if v1.6.2 is available.
- Release candidates. RC versions are deemed stable enough to be tested by the majority, but not stable enough to be the real release. Use at your own risks.
- Beta releases, alpha releases. These are development versions. Use at your own risks.
- Private release. Sometimes, the PrestaShop developers upload a private test version. If you have the right URL and hash key, you can update to this version easily using this channel. If you check the "Allow major upgrade" box, you indicate that are only interested in major releases.
- Local archive. To be used if you have downloaded the version you want to upgrade to in the correct local folder, /admin/autoupgrade/download. Once you have selected archive in the drop-down selector, indicate the version number in the text field (be very exact!).
- Local directory. To be used if you have downloaded and uncompressed the version you want to upgrade to in the /admin/autoupgrade/latest/prestashop folder. That /prestashop folder must come directly from the archive that you downloaded.
branch. Indicates if anything is available in the chosen channel.
name. The name of the latest version in the chosen channel.
url. The URL to the latest version in the chosen channel.
md5. The hash check for the latest version in the chosen channel.

Version comparison

For the curious, the numbered differences between your current version and the latest version in the chosen channel.

PrestaShop 1.6 > Automatic update > upd005-versionComparison.png

In case you have make changes directly to the core files instead of using the overriding possibilities of PrestaShop, these lists can help you know if your changes are safe or not.
Nevertheless, you can improve the lifespan of your custom code by turning it into overriding files. See the developer documentation for more information.

Rollback

This section only appears when at least one upgrade has been performed.

See below for more information.

Backup options

These options enable you to have some control on the backup process:

Backup my files and database. You must have your files backed-up, and the module will take care of this for you. You should never disable this setting, unless told to.
Backup my images. You should let the module take care of your images too, in order to be able to do a clean re-install again by re-uploading your files.

PrestaShop 1.6 > Automatic update > upd006-options-en.png

Upgrade Options

These options enable you to have some control on the upgrade process:

Server performance. Some shared hosted offer poor performance, which might hinder the performance of the upgrade process, or even make it fail. "Low" is thus selected by default, but if you know you have a powerful server, you can choose "Medium" or even "High".
Disable non-native modules. It is recommended to choose "Yes" for this option, as some module might prove a hindrance when upgrading PrestaShop.
Upgrade the "default" theme. The upgrade process overwrites the default theme with its latest incarnation. If you have made changes to the theme directly, you can protect these changes by choosing "No". As a reminder, it is NOT recommended to edit the default theme! You should make a copy of the theme, and make changes to that copy.
Upgrade the default e-mails. An update might bring new default e-mail templates. By default, the upgrade will replace the existing ones with the ones from the newer archive, and add the new templates. If you have customized your templates, it is recommended you keep them. You would then have to customize the new templates in order to fit the general style of your shop.
Step-by-step mode. Dev mode only. If enabled, the module will stop at each step to ask you for confirmation.
Display PHP errors. Dev mode only. If enabled, the module will displays PHP errors, which could help you discover server issues that would otherwise stay hidden from view.

PrestaShop 1.6 > Automatic update > upd007-upgOptions-en.png

The Upgrade process

Once all the indicators in the "pre-Upgrade checklist" section are green, the update button appears in the "Start your Upgrade" section, along with the URL from which the new version will be downloaded.

Clicking the "Upgrade PrestaShop now !" button triggers the whole process.

Once the upgrade process is launched, the whole configuration page is replaced by two sections: "Activity Log" and "Rollback".

The activity log gives you a detailed journal of what the updater is doing, in a screen you can scroll through:

Removed files: only the sample files are removed, such as empty override classes and controllers.
Name of the backup archive: the name follows the auto-backupfiles_V1.6.0.2_20140127-120310-798d3a69.zip form.
Files added to the backup archive: all the remaining files of your current installation are put into the Zip archive.
Database tables added to the backup archive: your files are important, but your whole catalog is stored in your database, and is therefore saved in the same archive.
Removed files: mostly modules, controllers, classes, CSS and JavaScript files. Now that all the files have been saved in the backup archive, they can be safely removed.
Files copied from the new archive: all the existing files are replaced by their new version.
Merged translation files.
Created, deleted, altered and updated database tables.
Emptied temporary folders: if possible, the upgrader will try and delete the content of the cache folders.

A lot of files are mentioned during the whole process. You do not need to read all the notifications, it's only there for you to peruse in case of error.

You'll know the upgrade is over when the following message "upgrade complete. Please check your front office theme is functional (try to make an order, check theme)" appears in green, along with the following final log entry: "End of process".
The upgrader also indicates that you should re-enable your shop, but before you do that, you should first check that everything is working in your back office: no errors, all products and categories are in place with their images and attached files, etc. Until you have checked that everything is okay in your shop, it is better to keep it from the public eye.

On first load, pages might look wonky: because your web browser caches files, it is probably using the old CSS files instead of the new ones. Do not hesitate to reload the page several times, or even empty your browser's cache, in order to get the correct interface.

When you upgrade from version 1.4 to version 1.6, your menus will not be arranged the way they would be if you made a fresh installation of version 1.6.

That is because PrestaShop 1.4 tabs got reorganized into 1.6 menus, and a lot of pages were moved around in order to create consistent menus. Additionally, the upgrader assumes that your 1.4 tabs may have been customized or moved around, either by a module or by your own action. Therefore, rather than breaking the existing settings, the upgrader takes the tabs as-is, and does not re-arrange them into the default 1.6 menu order.

If you want to change the position of pages within a menu once you have updated to version 1.6, go the to "Menus" page under the "Administration" menu, and start fiddling with positions.

Once you have made sure your PrestaShop installation is up and running, you can re-enable your shop using the option in the "Maintenance" page of the "Preferences" menu, then make tests on your front office: browse products, sort them, try to order one, etc. In short, go through the entire buying process in order to make sure that you won't miss a sale.

Is everything working fine? Congratulations, you know have successfully upgraded your PrestaShop installation!

In some server configurations, an error message might be displayed, saying "Javascript error (parseJSON) detected for action "upgradeNow". Starting restoration...".

Follow these steps to solve the error, :

Open your php.ini file and enable (uncomment) the MySQLi and MySQL PDO extensions. If you cannot access the php.ini file, contact your web host about this.

Open the /modules/autoupgrade/db/Db.php and find these lines (around line 210):

public static function getClass()
{
    $class = 'MySQL';
    /*if (PHP_VERSION_ID >= 50200 && extension_loaded('pdo_mysql'))
        $class = 'DbPDO';
    else if (extension_loaded('mysqli'))
        $class = 'DbMySQLi';*/
    return $class;
}

Simply uncomment these lines (remove /* and */). They should now look like this:

public static function getClass()
{
    $class = 'MySQL';
    if (PHP_VERSION_ID >= 50200 && extension_loaded('pdo_mysql'))
        $class = 'DbPDO';
    else if (extension_loaded('mysqli'))
        $class = 'DbMySQLi';
    return $class;
}

After you have done all this, start the autoupgrade process again.

Going back to the previous version: rollbacks

Sadly, not all upgrades are successful – which is the very reason why you should always back-up all your files and data, and why PrestaShop performs an additional backup of said files and data by itself, which you should not always count on. Make your own backup first. See the "Making and restoring your own backup" chapter of this guide for more information.

PrestaShop's own backup files are saved on your server, and if it turns out your update has gone badly, you can find them in the "Rollback" section of the configuration page for the 1-Click Upgrade module.
Backup files are created as soon as the upgrade process is started, and are available immediately in the "Choose your backup" drop-down list.
Choose the most recent one. The date and hour of the creation of the backup file are right within the name: Vversion-date-hour-random, for instance "V1.4.9.0_20120907-114024-f85f41a" for a backup of a previous PrestaShop 1.4.9 installation, made September 7th 2012, at 11:40:24 AM.

The "Rollback" button triggers two actions:

Takes the files from the latest backup, and re-installs them in place of those from the current installed version.
Takes the data from the latest backup, and re-installs it in place of that from the current database.

Select the backup archive to which you want to roll back to, and click the "Rollback" button. As with the upgrade process, the whole interface disappears to only leave the "Activity Log" section and the "Rollback" section. You can follow the rollback process in the scrolling journal, and once it is finished, reload the page in order to check that everything is indeed back in place.

Going back to the previous version: restoring your own backup

This is explained in details in the "Making and restoring your own backup" of this guide: http://doc.prestashop.com/display/PS16/Making+and+restoring+your+own+backup.