Date de publication: le dimanche 5 août 2007 à 11h33
Dernière modification: par Pascal BOYER le jeudi 2 septembre 2010 à 12h27
« Article précédent: eZ Publish : mise à jour de 3.10.x vers 3.10.y

24/09/2008 2:57  

This section describes how to upgrade your existing eZ Publish 3.9.x installation to version 3.10.y (but not 3.10.0, since direct upgrade to this version is not recommended). If you are upgrading from a version prior to eZ Publish 3.9, you need to first upgrade to 3.9 before you can upgrade to 3.10. 
Cet article décrit la mise à jour d'une version courante 3.9.x de eZ Publish vers une version 3.10.y (et non 3.10.0 puisque la mise à jour vers celle-ci n'est pas recommandée). Si vous souhaitez faire une mise à jour à partir d'une version antérieure à une version 3.9 vous devez alors préalablement faire une mise à jour vers la version 3.9  avant de vous lancer dans la mise à jour vers une version 3.10.

The upgrade procedure described below is generic and does not cover any specific cases. If you are running eZ Publish in a clustered environment, refer to the developer documentation for upgrade instructions. In case the eZ Publish Extension for Oracle® Database is used, refer to the documentation of the database extension. 
La procédure générique de mise à jour décrite ci-dessous ne couvre aucun cas spécifique. Si votre installation eZ Publish s'exécute dans un environnement clusterisé, référez-vous alors aux instructions de la documentation pour les développeurs . Par ailleurs, si vous utilisez l' extension eZ Publish pour les bases de données Oracle ® , reportez-vous à la documentation de cette extension .

Important note / Note importante

Before continuing, note that it is strongly recommended to upgrade directly to the latest stable release in the 3.10 branch (3.10.1 at the time of writing), which contains all important bug fixes. Refer to the changelogs and security advisories for more information about the issues that were fixed in the latest releases or view the short list of changes below.  
Avant de poursuivre, sachez qu'il est fortement recommandé de faire une mise à jour directement vers la dernière version stable de la branche 3.10 (3.10.1 à l'heure d'écrire ces lignes) contenant toutes les corrections importantes de bugs. Référez-vous aux documents changelogs  et Avis de sécurité  pour de plus amples informations sur les problèmes résolus par la dernière version stable ou jetez un oeil ci-dessous à la liste des modifications.

• In eZ Publish 3.10.1, the multi-language support for URL aliases was substantially improved, along with some important bug fixes related to this functionality. In addition, the support for wildcard based URL forwarding was re-added and the default type of URL transformation was changed to "urlalias". Refer to http://issues.ez.no/12785, http://issues.ez.no/11650 and http://issues.ez.no/12093 for more information. 
  La version 3.10.1 apporte de substantielles améliorations au support multi-langues des alias d'URI  ainsi que la résolution d'importants bugs liés à cette fonctionnalité. Par ailleurs, la redirection des URI basée sur les caractères génériques est à nouveau supportée et le type par défaut de la transformation d'URI se nomme à présent « urlalias». Référez-vous aux liens http://issues.ez.no/12785 , http://issues.ez.no/11650  et http://issues.ez.no/12093  pour de plus amples informations.

• The "updatetipafriendpolicy.php" upgrade script in eZ Publish 3.10.0 contains a bug. The same bug exists in eZ Publish 3.9.4 and 3.9.3. It prevents the script from granting access to the "Tip a friend" feature to users. The problem occurs when the script is run on Windows. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Refer to http://issues.ez.no/11663 for more information. 
  Le script de mise à jour   updatetipafriendpolicy.php de la version 3.10.0 contient le même bug que celui des versions 3.9.3 et 3.9.4 de eZ Publish. Ce bug empêche le script d'octroyer aux utilisateurs l'accès à la fonction « Tip a friend» (« Envoyer à un ami»). Ce problème, qui survient lorsque le script est exécuté sur une plate-forme windows, est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0. Référez-vous au lien http://issues.ez.no/11663  pour de plus amples informations.

• The "updatevatcountries.php" upgrade script in eZ Publish 3.10.0 contains a bug. The same bug exists in eZ Publish 3.9.3 and 3.9.4. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.1. Refer to http://issues.ez.no/11955 for more information. 
  Le script de mise à jour   update vatcountries .php de la version 3.10.0 contient le même bug que celui des versions 3.9.3 et 3.9.4 de eZ Publish. Une correction a été apportée aux versions 3.9.5, 3.10.1 et 4.0.1 de eZ Publish. Référez-vous au lien http://issues.ez.no/11955  pour de plus amples informations.

• In eZ Publish 3.10.0, there is a bug in the "File" datatype which may cause problems with binary file uploading via WebDAV. The same bug exists in eZ Publish 3.9.0 - 3.9.4. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. Refer to http://issues.ez.no/9450 for more information. 
  La version 3.10.0 présente un bug dans le datatype File  pouvant entraîner des problèmes lors du téléchargement de fichiers binaires via WebDAV. Ce bug est présent dans toutes les versions 3.9.0 à 3.9.4 mais est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0. Référez-vous au lien http://issues.ez.no/9450  pour de plus amples informations.

• In eZ Publish 3.10.0, the "register" view of the "user" module contains a bug. It prevents the system from registering new users when the "VerifyUserEmail" setting is enabled (it is enabled by default). The same bug exists in eZ Publish 3.8.10 and 3.9.4. This issue was fixed in eZ Publish 3.9.5 and 3.10.1. Refer to http://issues.ez.no/11598 for more information. 
  La version 3.10.0 présente un bug au niveau de la vue « register» ( register.tpl) du module « user» empêchant le système d'enregistrer les nouveaux utilisateurs lorsque le paramètre VerifyUserEmail  est activé (il l'est par défaut). Ce bug, affectant les versions 3.8.10 et 3.9.4, est corrigé dans les versions 3.9.5 et 3.10.1. Référez-vous au lien http://issues.ez.no/11598  pour de plus amples informations.

Make sure that you have a working backup of the site before you do the actual upgrade. The upgrade procedure consists of the following steps: 
Assurez-vous d'être en possession d'une sauvegarde  correcte/fonctionnelle de votre site avant de vous lancer dans sa mise à jour dont la procédure suit les étapes suivantes:

1. Upgrading the distribution files to 3.10 
   Mettre à jour les fichiers de la version 3.9 avec ceux de la version 3.10,
2. Upgrading the database to 3.10 
    Mettre à jour la base de données pour la rendre compatible avec la version 3.10 de eZ Publish, 
3. Running the 3.10 upgrade scripts 
   Exécuter les scripts de mise à jour de la version 3.10,
4. Updating the system configuration 
   Mettre à jour la configuration du système,
5. Clearing the caches 
   Vider les caches.

Étape 1: Upgrading the distribution files / Mettre à jour les fichiers de la distribution

The easiest way to upgrade the distribution files is to unpack eZ Publish 3.10.1 to a directory and then copy the directories that contain site-specific files from the existing installation. Make sure that you copy the following directories: 
Le moyen le plus simple de mettre à jour les fichiers du site existant consiste à extraire les fichiers de l'archive eZ Publish 3.10.1 dans un répertoire dans lequel on copiera également les répertoires contenant les fichiers spécifiques au site à mettre à jour. Assurez-vous donc de copier, dans le répertoire de la version 3.10.1, les répertoires suivants du site existant:

• design/example
• design/example_admin
• var
• settings/siteaccess
• settings/override

Replace "example" and "example_admin" with actual names used by your siteaccesses. 
Remplacez example et example_admin par les vrais noms de vos siteaccess.

Custom extensions / Extensions particulières

If you are using custom extensions, the subdirectories inside the "extension" directory will also have to be copied. However, make sure that you do not overwrite any extensions that come with eZ Publish (currently "ezdhtml", "ezodf", "ezpaypal" and "ezurlaliasmigration").  
Si vous utilisez des extensions particulières, alors les sous-répertoires du répertoire extension/ doivent également être copiés. Assurez-vous cependant de ne pas écraser d'extensions fournies avec eZ Publish (à savoir les extensions ezdhtml, ezodf, ezpaypal et ezurlaliasmigration).

If you are using the Website Interface front-end, make sure you copied the "extension/ezwebin/" directory. It is also possible to upgrade the Website interface extension to a newer version (you can find more information and instructions in the "Upgrading the Website Interface" chapter of the Website interface installation guide). 
Si vous utilisez l' Interface Website  assurez-vous d'avoir une copie du répertoire extension/ezwebin/. Il est également possible de mettre à jour cette extension vers une nouvelle version (vous pouvez trouver plus d'information et d'instructions au chapitre Upgrading the Website Interface du guide d'installation de l'interface Website ).

Translations / Traductions

eZ Publish 3.10 has less translations than 3.9 releases because not all of the translation contributors have submitted a CLA yet. If you are using a multilingual site the possible workarounds in that case can be either to use the 3.9.x translations or to download translations from http://ez.no/developer/translations. It would also be highly appreciated if translators for existing translations send us the CLA so that we can include the translations in future 3.10 releases. 
Les versions 3.10 contiennent moins de traductions que les versions 3.9 car tous les traducteurs n'ont pas encore fait parvenir leur CLA  . Si vous utilisez un site multilingue, vous pouvez télécharger soit les traductions des versions 3.9.x soit celles disponibles depuis la page http://ez.no/developer/translations  . Nous apprécirions vraiment que les personnes travaillant sur les traductions existantes envoient leur CLA afin que nous puissions inclure les traductions dans les prochaines versions 3.10.

Important bug fix for remote IDs / Correction importante du bug lié aux ID distants

Due to some bugs in previous versions of eZ Publish (3.9.0 and others), it might happen that not all content objects in your database have unique remote IDs. This basically means that the "remote_id" column of the "ezcontentobject" table in the database might contain duplicate values. In eZ Publish 3.10.1, a database schema change was introduced in order to ensure that only unique remote IDs can be stored in this table. Because of this, you need to make sure that there are no content objects with identical remote IDs before upgrading the database. This can be done by running the "fixobjectremoteid.php" upgrade script. (Note that both the database schema change and the upgrade script were added to eZ Publish 3.9.5 and 4.0.1 as well.) 
En raison de bugs présents dans les précédentes versions de eZ Publish (3.9.0 et autres), il pouvait arriver que tous les objets de contenu de votre base de données n'aient pas un ID distant  unique. Cela signifie que la colonne remote_id de la table ezcontentobject de la base de données pouvait contenir plusieurs fois la même valeur. La version 3.10.1 apporte une modification du schema de la base de données afin de s'assurer que cette table ne puisse enregistrer que des ID distants uniques. De ce fait, vous devez vous assurer que votre base de données ne contient pas d'objets ayant le même ID distant. Pour cela, vous pouvez exécuter le script de mise à jour fixobjectremoteid.php. Notez que la modification du schéma de la base de données et les scripts de mise à jour ont été ajoutés comme il se doit aux versions 3.9.5 et 4.0.1.

This script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database (which is the most typical/usual case), you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used. 
Ce script doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et d'administration partageant la même base de données (ce qui reste le cas le plus fréquent), vous ne devez exécuter le script que pour l'un des deux siteaccess. Et si ce dernier n'est pas mentionné, c'est le siteacces par défaut  sera utilisé.

The following example shows how to run the script: 
L'exemple suivant explique comment exécuter le script:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire d'installation de eZ Publish 3.10.1
2. Run the script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script (remplacez example par le vrai nom de votre siteaccess):

php update/common/scripts/3.10/fixobjectremoteid.php -s example

The script will search for objects with non-unique remote IDs. Every time such an object is found, the script will suggest to either display more detailed information or fix the problem automatically. If you choose the first option, the script will display the list of objects that have the same remote ID and let you decide which one should remain unchanged; all other objects in the list will get new remote IDs. Otherwise, the script will fix the problem automatically based on the objects' creation dates. This means that the script will generate new remote IDs for all objects in the list except the one that was created first. 
Le script recherche tous les objets n'ayant pas un ID distant unique. Chaque fois qu'un tel objet est trouvé, le script suggère soit d'afficher une information plus détaillée soit de résoudre le problème automatiquement. Si vous choisissez la première option, le script affichera la liste des objets ayant le même ID distant et vous laissera choisir celui devant rester inchangé. Tous les autres objets de la liste se verront affecter un nouvel ID distant. Dans le cas de la deuxième option, le script corrigera automatiquement tous les problèmes en se basant sur la date de création des objets, ce qui signifie que le script génèrera un nouvel ID distant pour tous les objets excepté pour celui ayant la date de création la plus ancienne.

The optional "--mode" parameter makes it possible to run the script in either "auto-fix" or "manual-fix" mode as shown below. 
Le paramètre optionnel --mode permet d'exécuter le script en mode auto-fix (correction automatique) ou manual-fix (correction manuelle) comme indiqué ci-dessous:

php update/common/scripts/3.10/fixobjectremoteid.php -s example --mode=value

If you replace "value" with "a" in the command above, the script will automatically fix all non-unique remote IDs that are found in the database based on the objects' creation dates. In this case, no further input is required from the user. If you specify "--mode=d", the script will display the list of objects for each non-unique remote ID so that you can manually choose which objects should keep their remote IDs. 
Si vous remplacez, dans la commande ci-dessus, value par a, le script corrigera alors automatiquement tous les IDs distants identiques trouvés dans la base de données en se basant sur la date de création des objets. Dans ce cas, aucune autre saisie n'est requise de votre part. A l'inverse, si vous précisez --mode=d alors le script affichera la liste des objets ayant un même ID distant afin que vous puissez manuellement choisir celui dont il faudra conserver le ID.

Étape 2: Upgrading the database / Mettre à jour la base de données

To upgrade a 3.9.x database to 3.10.1, navigate into the eZ Publish 3.10.1 directory and run the following database upgrade scripts one after another: 
Afin de mettre à jour une base de données 3.9.x vers une base de données 3.10.1, placez-vous dans le répertoire de la version 3.10.1 puis exécutez les uns après les autres les scripts suivants de mise à jour de la base de données:

1. dbupdate-3.9.0-to-3.10.0.sql
2. dbupdate-3.10.0-to-3.10.1.sql

Note that some of the database changes from eZ Publish 3.9.0 to 3.10.0 have been included in other 3.9 releases. If you are upgrading from a version later than 3.9.0, it is recommended to skip some parts of the database upgrade scripts. These are marked with "from 3.9.z" comments in the ".sql" file; make sure you skip all sections with "z" less than or equal to the last digit in your current version number. For example, if you are upgrading from 3.9.3, skip sections marked with "from 3.9.1", "from 3.9.2" and "from 3.9.3" comments (if any). 
Retenez que certaines modifications apportées lors du passage d'une base de données versions 3.9.0 à une version 3.10.0 ont été incluses dans les autres versions 3.9. Si vous effectuez une mise à jour depuis une version plus récente que la version 3.9.0, il est alors recommandé de ne pas appliquer certaines parties du script de mise à jour de la base de données. Ces parties sont repérées par un commentaire from 3.9.z dans le fichier .sql. Assurez-vous de ne pas appliquer toutes les sections mentionnant un z inférieures ou égales au dernier chiffre du numéro de version de votre version existante. Si vous effectuez, par exemple, une mise à jour d'une version 3.9.3, n'appliquez pas les sections marquées d'un commentaire from 3.9.1, from 3.9.2 et from 3.9.3 (le cas échéant).

MySQL

The database upgrade scripts are located in the "update/database/mysql/3.10/" directory of your eZ Publish installation. Each of these scripts can be launched using the following shell command (replace "script_name" with the actual name of the script): 
Les scripts de mise à jour de la base de données sont situés dans le répertoire update/database/mysql/3.10/ du répertoire d'installation de eZ Publish. Chacun de ces scripts peut être exécuté via la ligne de commande suivante (remplacez script_name par le vrai nom du script):

mysql -u <username> -p<password> <database> < update/database/mysql/3.10/script_name.sql

Note that the CREATE TABLE statements in the database upgrade scripts do not specify which storage engine to use (no ENGINE or TYPE option), and thus the default storage engine will be used. Normally, it is MyISAM (starting from MySQL v.3.23). If you are using InnoDB, make sure the default storage engine is set to InnoDB before you run the database upgrade scripts (refer to the MySQL documentation for information about how to set the default engine). If you were not able to change the MySQL configuration on your server, and the upgrade left you with a mix of table types, you can use the "bin/php/ezconvertmysqltabletype.php" script for database conversion. You can also convert the newly created tables individually by using the following SQL query for each table: 
Retenez que les déclarations CREATE TABLE des scripts de mise à jour de la base de données ne spécifient pas le moteur de stockage à utiliser (pas d'option ENGINE ou TYPE), en conséquence de quoi le moteur de stockage par défaut sera utilisé, normalement le moteur MyISAM (utilisé depuis MySQL v 3.23). Si vous utilisez InnoDB, asurez-vous que le moteur de stockage par défaut soit positionné à InnoDB avant d'exécuter les scripts de mise à jour de la base de données (référez-vous à la documentation de MySQL  pour savoir comment paramétrer le moteur par défaut). Si vous ne pouvez ou n'arrivez pas à modifier la configuration de votre serveur MySQL et que la mise à jour engendre un mélange des types de tables, utilisez le script bin/php/ ezconvertmysqltabletype.php pour la conversion de ces dernières. Vous pouvez également convertir individuellement les nouvelles tables créées avec la requête SQL suivante:

ALTER TABLE <name_of_table> TYPE = innodb;

PostgreSQL

The database upgrade scripts are located in the "update/database/postgresql/3.10/" directory of your eZ Publish installation. Each of these scripts can be launched using the following shell command (replace "script_name" with the actual name of the script): 
Les scripts de mise à jour de la base de données sont situés dans le répertoire update/database/postgresql/3.10/ du répertoire d'installation de eZ Publish. Chacun de ces scripts peut être exécuté via la ligne de commande suivante (remplacez script_name par le vrai nom du script):

psql -d <database> -U <dbowner> < update/database/mysql/3.10/script_name.sql

Étape 3: Running the system upgrade scripts / Exécuter les scripts de mise à jour du système

The 3.10 version of eZ Publish introduces a couple of new features. In order to make sure that your site is compatible with these features, you'll have to run a few upgrade scripts. 
La version 3.10 de eZ Publish introduit un certain nombre de nouvelles fonctionnalités. Afin de vous assurer que votre site sera compatible avec celles-ci, vous devez exécuter quelques scripts de mise à jour.

Multi-language support for URL aliases / Support multilingue pour les alias d'URL

In eZ Publish 3.10.0, a new feature has been added that makes it possible to use multi-lingual virtual URLs. In eZ Publish 3.10.1, the multi-language support for URL aliases was substantially improved, along with some important bug fixes related to this functionality. In addition, the support for wildcard based URL forwarding was re-added and the default type of URL transformation was changed to "urlalias" in 3.10.1. 
Dans la version 3.10.0, une nouvelle fonctionnalité a été ajoutée permettant d'utiliser les URI virtuels  multilingues (également connus sous le noms de bons URL ou alias d'URL). La version 3.10.1 apporte de substantielles améliorations au support multi-langues des alias d'URI  ainsi que la résolution d'importants bugs liés à cette fonctionnalité. Par ailleurs, la redirection des URI basée sur les caractères génériques est à nouveau supportée et le type par défaut de la transformation d'URI se nomme à présent « urlalias».

When upgrading from 3.9.x to 3.10.1, you need to specify the desired type of URL transformation using the "TransformationGroup" setting located in the [URLTranslator] section of an override for "site.ini" and run the "updateniceurls.php" script as described below. It is also possible to choose which word separator should be used in the URLs. This can be done by setting the "WordSeparator" configuration directive also located in the [URLTranslator] section to either "dash", "underscore" or "space". Note that this setting will be ignored when the "urlalias_compat" transformation is used (it only supports underscores as separators). 
Au cours de la mise à jour de 3.9.x vers 3.10.1 vous devez spécifier le type de transformation d'URI souhaité par le biais du paramètre TransformationGroup  de la section [URLTranslator] d'une surcharge du fichier site.ini puis exécuter, comme indiqué ci-dessous, le script updateniceurls.php. Il est également possible de choisir le « mot» séparateur à employer dans les URIs grâce au paramètre WordSeparator  de la même section [URLTranslator] en lui donnant une des valeurs suivantes: dash (tiret « - »), underscore (tiret bas « _ ») ou space (espace). Retenez que ce paramètre est ignoré lorsque la transformation d'URI urlalias_compat est utilisée (qui ne supporte que les underscore comme séparateurs).

Before running the script, make sure that you have specified the same transformation settings for all siteaccesses that are using the same database. If all your siteaccesses are using the same database (which is the most typical/usual case), you can set the "TransformationGroup" and "WordSeparator" directives in "settings/override/site.ini.append.php". Otherwise, you will have to configure URL transformation from within "settings/siteaccess/example/site.ini.append.php" (where "example" should be replaced by the actual name of your siteaccess) for each siteaccess. 
Avant d'exécuter le script, assurez-vous de spécifier les mêmes paramètres de transformation pour tous les siteaccess partageant la même base de données. Si tous vos siteaccess utilisent la même base de données (ce qui est le cas le plus fréquent) alors vous pouvez définir les paramètres TransformationGroup et WordSeparator du fichier settings/override/ site.ini.append.php. Dans le cas contraire vous devez configurer la transformation des URI dans le fichier settings/siteaccess/example/ site.ini.append.php (où example doit être remplacé par le vrai nom de votre siteaccess) de chaque siteaccess.

In addition, you must clear the INI cache before running the script, so that the system will re-read the changed configuration files. 
D'autre part, vous devez supprimer le cache INI préalablement à l'exécution du script de sorte que le système relise les fichiers de configuration que vous venez de modifier.

The "updateniceurls.php" script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess is not specified, the default siteaccess will be used. 
Le script updateniceurls.php doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et d'administration partageant la même base de données, vous ne devez exécuter le script que pour l'un des deux siteaccess. Et si ce dernier n'est pas mentionné, c'est le siteacces par défaut  sera utilisé.

The following example shows how to run the script. 
L'exemple qui suit montre comment exécuter ce script:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script en remplaçant example par le nom de votre siteaccess:

php bin/php/updateniceurls.php --import --fetch-limit=number -s example

Replace "example" with the actual name of the siteaccess and specify the desired number of items to handle per one iteration instead of "number". (The script will automatically do as many iterations as necessary to convert all the URLs, based on the number specified. If the optional "--fetch-limit" parameter is omitted, the script will handle 200 items per one iteration.) 
Remplacez example par le vrai nom de votre siteaccess et précisez, à la place de number, le nombre souhaité d'items à traiter à chaque itération. Le script effectuera automatiquement , en se basant sur ce nombre, autant d'itérations que nécessaire pour convertir tous les URI. Si le paramètre optionnel --fetch-limit est omis, le script traitera alors 200 items par itération.

The script will go through all content objects stored in the database and create new virtual URLs for them in accordance with the specified transformation settings. Old virtual URLs will be transferred to the new system and stored as history entries. (The "--import" parameter makes the script go through all entries in the "ezurlalias" database table, which was used for storing URL aliases in eZ Publish 3.9. As a result, old URL aliases will be imported to the "ezurlalias_ml" table, which is used for storing multilingual URL aliases in eZ Publish 3.10.) 
Le script parcourt tous les objets de contenu stockés dans la base de données et crée, pour chacun d'eux, de nouveaux alias d'URI en tenant compte de la valeur des paramètres de transformation. Les anciens alias d'URI seront transférés dans le nouveau système et enregistrés dans l' historique des entrées . Le paramètre --import permet au script de parcourir toutes les entrées de la table ezurlalias, table utilisée pour stocker les alias d'URI des versions 3.9 de eZ Publish, de sorte que tous les anciens alias soient importés dans la table ezurlalias_ml, table utilisée pour le stockage des alias multilingues des versions 3.10.

Note that new URL aliases will be generated for all the languages of your site regardless if they are available or not for the specified siteaccess. The time it takes to update all URL aliases is proportional to the number of nodes on your site. 
Retenez que les nouveaux alias d'URI sont générés pour toutes les langues de votre site indépendamment de leur disponibilité pour le siteaccess précisé. La durée de mise à jour de tous les alias d'URI est proportionnelle au nombre de noeuds de votre site.

Refer to the developer documentation for more information about this feature. 
Référez-vous à la documentation des développeurs  pour de plus amples informations sur cette fonctionnalité.

ISBN datatype enhancements / Améliorations du datatype ISBN

In eZ Publish 3.10, the handling of ISBN-13 numbers has been significantly improved ( refer to the  ISBN datatype  documentation for details ). The different ranges are now stored in the database, allowing the system to fix up incorrectly entered ISBN-13 codes (codes with misplaced or missing dashes). When a new version of eZ Publish is released, the latest information about the different ranges is downloaded from http://www.isbn-international.org/converter/ranges.js and stored in a ".dba" file. During the installation process, the setup wizard imports this information to the database. When upgrading, you need to import ranges to the database manually. This must be done even though your site does not use ISBN-13 numbers. You can either import ranges from the ".dba" file using the "ezimportdbafile.php" script or download the latest "range.js" file and run the "updateisbn13.php" script. 
Dans eZ Publish 3.10, la gestion des nombres ISBN-13 a été améliorée de manière significative (référez-vous à la documentation sur le datatype ISBN  pour plus de détails). Les différentes gammes (???) sont à présents stockées dans la base de données, permettant ainsi au système de corriger les erreurs commises lors de la frappe des codes ISBN-13 (des erreurs de tiret mal placé ou manquant). Lorsqu'une nouvelle version de eZ Publish est publiée, les dernières informations des différentes gammes sont téléchargées depuis ce lien http://www.isbn-international.org/converter/ranges.js  puis stockées dans un fichier .dba. Durant le processus d'installation, l'interface graphique d'installation importe ces informations dans la base de données. Par contre, lors d'une mise à jour, vous devez importer manuellement les gammes dans la base de données, quand bien même votre site n'utilise pas les nombres ISBN-13. Vous pouvez importer ces gammes soit à partir du fichier .dba en utilisant le script ezimportdbafile.php soit en téléchargeant le fichier range.js puis en exécutant le script updateisbn13.php.

The following example shows how to import ranges from the ".dba" file: 
L'exemple suivant explique comment importer les gammes depuis le fichier .dba:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire d'installation de eZ Publish 3.10.1
2. Run the script (replace "example" with the actual name of your siteaccess): 
   Exécutez ce script (remplacez example par le nom de votre siteaccess):

php bin/php/ezimportdbafile.php --datatype=ezisbn -s example

The "datatype" parameter tells the script which datatype the data should be imported for. 
Le paramètre datatype indique au script pour quel datatype les données doivent être importées.

The next example shows how to get the latest ranges from the ISBN International website: 
L'exemple suivant montre comment récupérer les dernières gammes depuis le site international de ISBN:

1. Download a ".js" file containing the list of ranges using the following link: http://www.isbn-international.org/converter/ranges.js 
   Téléchargez un fichier .js contenant la liste des gammes (???) qui utilisent le lien suivant: http://www.isbn-international.org/converter/ranges.js ,
2. Navigate into the eZ Publish 3.10.1 directory and copy the downloaded file there. 
   Placez-vous dans le répertoire contenant la version 3.10 de eZ Publish et copiez y le fichier .js,
3. Run the "updateisbn13.php" script using the following shell command: 
   Exécutez le script updateisbn13.php avec la commande suivante:

php bin/php/updateisbn13.php --file=ranges.js

The script will import information from the "range.js" file to the database. 
Le script importera dans la base de données les informations du fichiers range.js.

In order to use ISBN-13 numbers on your site after upgrading, you need to do the following: 
Afin d'utiliser les numéros ISBN-13 une fois la mise à jour terminée, vous devez suivre les étapes suivantes:

1. Make sure that the "ISBN-13 format" checkbox in the class attribute edit interface for the corresponding attribute is enabled (it is off by default). 
   Assurez-vous que, dans l'interface d'édition des attributs de classe, la case à cocher Format ISBN-13 est cochée pour l'attribut correspondant (par défaut elle ne l'est pas).
2. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
3. Run the "ezconvert2isbn13.php" script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script ezconvert2isbn13.php en remplaçant example par le nom de votre siteaccess:

php bin/php/ezconvert2isbn13.php -s example

The script will go through all content object attributes using the "ISBN" datatype in the database and convert their values into valid ISBN-13 numbers. The following table reveals the available options for this script. 
Le script parcourt, dans la base de données, tous les attributs des objets de contenus basés sur le datatype ISBN et converti leurs valeurs en nombres ISBN-13 valides. Le tableau ci-dessous présente les options possibles de ce script:

These scripts should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the scripts for one of the siteaccesses. If the siteaccess is not specified, the default siteaccess will be used.  
Ces scripts doivent être exécutés une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et un siteaccess d'administration partageant la même base de données, alors vous ne devez exécuter ces scripts que pour un seul de ces deux siteaccess. Si aucun siteaccess n'est spécifié, c'est le siteaccess par default  qui sera utilisé.

Enhanced Multi-option datatype / Datatype Option multiple amélioré

In eZ Publish 3.10, a new datatype called "Multi-option2" has been added in order to replace the old "Multi-option" datatype. The new datatype allows option selections and makes it possible to create multiple and distinctive groups of multi-options for each content object. In addition, it supports rules and provides a handful of new and interesting features. Note that the old "Multi-option" datatype is deprecated and should no longer be used (it will be removed in the future). 
La version 3.10 de eZ Publish intègre un nouveau datatype Multi-option2  qui remplace l'ancienne version Option multiple . La nouvelle version autorise les sélections d'options (???) et permet de créer, pour chaque objet de contenu, plusieurs groupes d'options multiples distincts. De plus, ce datatype supporte des règles et fournit une poignée de nouvelles fonctionnalités intéressantes. Retenez que l'ancienne version est dépréciée et ne doit plus être utilisée (elle sera même supprimée dans le futur).

In order to be compatible with the new datatype, you will have to run the "updatemultioption.php" script. This script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess is not specified, the default siteaccess will be used. 
Afin d'être compatible avec ce nouveau datatype, vous devez exécuter le script updatemultioption.php une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et d'administration partageant la même base de données, alors vous ne devez l'exécuter que pour l'un de ces deux siteaccess. Si le siteaccess n'est pas spécifié, c'est le siteaccess par défaut  est utilisé.

The following example shows how this can be done: 
L'exemple qui suit explique comment réaliser cela:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script en remplaçant example par le nom de votre siteaccess:

php update/common/scripts/3.10/updatemultioption.php -s example

The script will go through all content object attributes that are using the old "Multi-option" datatype in the database. The content object attributes will be modified (converted) so that they use the new "Multi-option2" datatype. 
Le script parcourt, dans la base de données, tous les attributs des objets de contenu basés sur le datatype Option multiple et les modifie/converti afin qu'ils utilisent le nouveau datatype Option multiple2.

The following table reveals the available options for this script. 
Le tableau ci-dessous présente les options possibles de ce script:

Note: overridden templates of the public siteaccess for the "Multi-option" datatype will also need to be updated (manually). 
Note: les templates surchargés du datatype Option multiple du siteaccess public devront également être mis à jour (manuellement).

Changes to roles and policies / Modifications des rôles et permissions

From 3.10, users (typically those to which the anonymous role applies) need to have access to the "tipafriend" function of the "content" module in order to use the "Tip a friend" feature. Because of compatibility reasons, you need to run the "updatetipafriendpolicy.php" script. 
Depuis la version 3.10, les utilisateurs (généralement les utilisateurs appartenant au rôle anonymous) doivent accéder à la fonction Envoyer à un ami ( Tip a friend) du module content. Pour des raisons de compatibilité vous devez exécuter le script updatetipafriendpolicy.php.

Note: there is no need to run the script if you are upgrading from 3.9.3 or later versions (3.9.5 or later if you are running eZ Publish on Windows). 
Retenez qu'il n'y a nul besoin d'exécuter ce script si vous effectuez une mise à jour depuis une version 3.9.3 ou plus récente (3.9.5 si vous êtes sous windows).

The following example shows how this can be done. 
L'exemple qui suit explique comment réaliser cela:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the script using the following shell command: 
   Exécutez le script avec la commande suivante:

php update/common/scripts/3.10/updatetipafriendpolicy.php -s example_admin -l login -p password

Replace "example_admin" with the actual name of your admin siteaccess, use the administrator's login and password instead of "login" and "password". 
Remplacez example_admin par le vrai nom de votre siteaccess d'administration puis login et password par l'identifiant et le mot de passe de l'administrateur de eZ Publish.

The script will add a new role that grants access to the "Tip a friend" feature and ask for confirmation about assigning this role to each user or user group located one level beneath the "Users" top level node. 
Le script ajoutera un nouveau rôle accordant les droits d'accès à la fonction Envoyer à un ami et demandera confirmation avant d'assigner ce rôle à chaque utilisateur ou groupe d'utilisateurs situé sous le noeud de plus haut niveau Users ( Utilisateurs).

Improved handling of country dependent VATs / Gestion améliorée de la TVA en fonction des pays

In eZ Publish version 3.10.0 - 3.10.1, the handling of country dependent VATs has been improved. Because of compatibility reasons, you need to run the "updatevatcountries.php" script. 
Dans les versions 3.10.0 - 3.10.1, la gestion de la TVA en fonction des pays a été améliorée. Pour des raisons de compatibilité, vous devez exécuter le script updatevatcountries.php.

Note: there is no need to run the script if you are upgrading from 3.9.5 or a later version. 
Retenez qu'il n'y a nul besoin de lancer ce script si vous effectuez une mise à jour depuis une version 3.9.5 ou plus récente.

The "updatevatcountries.php" script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used. 
Ce script doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et un siteaccess d'administration partageant la même base de données, alors vous ne devez exécuter ce script que pour un seul de ces deux siteaccess. Si aucun siteaccess n'est spécifié, c'est le siteaccess par default  qui sera utilisé.

The following example shows how to run the script: 
L'exemple qui suit explique comment exécuter ce script:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the "updatevatcountries.php" script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script updatevatcountries.php en remplaçant example par le nom de votre siteaccess:

php update/common/scripts/3.10/updatevatcountries.php -s example

The script will go through all the VAT rules in the database and make them compatible with the newly introduced changes. 
Le script va parcourir toutes les règles de TVA présentes dans la base de données et les rendre compatibles avec les changements nouvellement apportés.

Binary files uploaded via WebDAV (optional) / Fichiers binaires uploadés via WebDAV (optionnel)

In eZ Publish version 3.9.4 and earlier versions, there is a bug in the "File" datatype which may cause problems with binary file uploading via WebDAV. The typical symptoms are that the file extension of the uploaded file is missing and that you may not be able to download the file once it is uploaded (refer to http://issues.ez.no/9450 for more information). The same bug exists in eZ Publish 3.10.0. This issue was fixed in eZ Publish 3.9.5, 3.10.1 and 4.0.0. 
Dans les versions 3.9.4 et antérieures de eZ Publish, existe un bug dans le datatype File  pouvant entraîner des problèmes lors du téléchargement de fichiers binaires via WebDAV. L'absence de l'extension du fichier uploadé, rendant impossible son téléchargement une fois uploadé (référez-vous au lien http://issues.ez.no/9450  pour plus d'information) en est le principal symptôme. Ce bug, affectant la version 3.10.0, est corrigé dans les versions 3.9.5, 3.10.1 et 4.0.0.

If your site has objects that were created by uploading files via WebDAV and you have configured MIME-type-to-class mapping using the "MimeClassMap[]" directive in an override for "upload.ini", you need to run the "updatebinaryfile.php" script in order to fix the file extensions. (If a content class does not have any attributes that make use of the "File" datatype, instances of this class are not affected.) 
Si votre site contient des objets créés suite au upload de fichiers via WebDAV et que vous avez configuré MIME-type-to-class mapping  en utilisant le tableau MimeClassMap[] dans une surcharge du fichier upload.ini, alors vous devez exécuter le script updatebinaryfile.php afin de corriger les extensions des fichiers. Si une classe de contenu ne possède aucun attribut basé sur le datatype File, alors les instances de cette classe ne sont pas affectées.

Note: there is no need to run the script if you are upgrading from 3.9.5 or a later version. 
Retenez qu'il n'y a nul besoin de lancer ce script si vous effectuez une mise à jour depuis une version 3.9.5 ou plus récente.

The "updatebinaryfile.php" script should be run once for each database, specifying one siteaccess per database. If you only have a public and an administration siteaccess that share the same database, you only need to run the script for one of the siteaccesses. If the siteaccess isn't specified, the default siteaccess will be used. 
Ce script doit être exécuté une fois pour chaque base de données et en spécifiant un siteaccess pour chacune d'elles. Si vous n'avez qu'un siteaccess public et un siteaccess d'administration partageant la même base de données, alors vous ne devez l'exécuter que pour un seul de ces deux siteaccess. Si aucun siteaccess n'est spécifié, c'est le siteaccess par default  qui sera utilisé.

The following example shows how to run the script: 
L'exemple qui suit explique comment exécuter ce script:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the script (replace "example" with the actual name of your siteaccess): 
   Exécutez le script en remplaçant example par le vrai nom de votre siteaccess:

php update/common/scripts/3.10/updatebinaryfile.php -s example

The script will go through all the binary files and fix their extensions. The filename entries stored in the "ezbinaryfile" database table will be changed accordingly. 
Le script va parcourir tous les fichiers binaires et corriger leur extension. Les entrées des noms des fichiers stockées dans la table ezbinaryfile seront modifiées en conséquence.

Étape 4: Updating the system configuration / Mettre à jour la configuration du système

Updating INI settings that use URL aliases / Mise à jour des paramètres INI utilisant les alias d'URI

If your site makes use of the "urlalias" or "urlalias_iri" transformation method, read this part carefully. If you have specified "urlalias_compat" in the "TransformationGroup" configuration setting in step 3, skip this part. 
Si votre site utilise la méthode de transformation   urlalias ou urlalias_iri, lisez ce qui suit attentivement. En revanche, si vous avez mentionné, à l'étape 3, urlalias_compat pour le paramètre TransformationGroup , alors vous pouvez passer directement au paragraphe suivant.

After running the "updateniceurls.php" script in step 3, you need to review your configuration settings and update the URL aliases that are used in configuration files. For example, if your site makes use of the "PathPrefix" and "PathPrefixExclude" settings, this functionality might stop working if the specified URL aliases have changed (which will likely be the case because the virtual URLs are re-generated in accordance with the "TransformationGroup" and "WordSeparator" directives). Even though the old virtual URLs are stored as history entries and redirect to new ones when being accessed on the actual site, configuration settings do not work with URL history entries, i.e. you need to specify correct URL aliases there. 
Après avoir exécuté, à l'étape 3, le script updateniceurls.php, vous devez revoir vos paramètres de configuration et mettre à jour les alias d'URI utilisés dans les fichiers de configuration. Si votre site utilise, par exemple, les paramètres PathPrefix  et PathPrefixExclude  alors cette fonctionnalité peut ne plus fonctionner si les alias d'URI spécifiés sont modifiés (ce qui sera le cas puisque les URI virtuels sont régénérés en accord avec les valeurs des paramètres TransformationGroup  et WordSeparator ). Quand bien même les anciens URI virtuels sont tockés dans l'historique des entrées puis redirigés vers les nouveaux lorsqu'ils sont accédés sur le site, les paramètres de configuration ne fonctionnent pas avec l'historique des entrées d'URI, vous obligeant à spécifier des alias d'URI corrects.

Also, you need to review the configuration settings in your "override.ini.append.php" file(s), otherwise your override templates activated by the "url_alias" condition will most likely stop working. For each line in the "override.ini.append.php" file that contains something like this: 
Vous devez également revoir les paramètres de configuration de votre/vos fichier/s override.ini.append.php au risque que vos templates de surcharge activés par la condition url_alias s'arrêtent de fonctionner. Pour chacune des lignes du fichier override.ini.append.php contenant quelque chose comme ça:

Match[url_alias]=virtual_url

make sure that the correct virtual URL is specified. 
vous devez vous assurer que l'alias d'URI mentionné est correct.

Note that for multi-language sites, you need to specify URL aliases in the most prioritized language (controlled by the "SiteLanguageList" configuration array located under the "[RegionalSettings]" section of "site.ini.append.php"). 
Retenez que vous devez, pour les sites multilingues, mentionner les alias d'URI dans la langue de plus haute priorité (contrôlée par le tableau SiteLanguageList  de la section [RegionalSettings] du fichier site.ini.append.php).

Tree menu configuration / Configuration de l'arborescence du menu

In eZ Publish versions prior to 3.10, the left tree menu in the administration interface didn't scale very well (refer to the specifications for details). This has been substantially improved in 3.10.0. The newly added implementation is called "dynamic content structure menu". It makes use of the AJAX technology, which is supported by all modern browsers. The old implementation is still available and enabled after upgrading. It is however recommended to switch to the new implementation, specially for large sites with many nodes. This will make the tree menu work much faster and decrease the usage of network bandwidth. (Note that new sites created from scratch using the setup wizard will have "dynamic" tree menu in the administration interface.) 
Dans les versions antérieures à la version 3.10, le menu gauche présentant l'arborescence du site (dans l'interface d'administration) ne se redimentionne pas très bien (référez-vous aux specifications  pour plus de détails). Mais ceci a été grandement amélioré dans la version 3.10.0. La nouvelle implémentation, nommée dynamic content structure menu, utilise la technologie AJAX , supportée par tous les navigateurs modernes. La mise à jour de eZ Publish terminée, l'ancienne implémentation du menu est encore disponible et activée. Il est cependant recommandé de basculer vers la nouvelle implémentation, particulièrement dans le cas des gros sites comportant un grand nombre de noeuds. Cela permettra de rendre le menu plus rapide et d'économiser de la bande passante réseau. Notez que les nouveaux sites - ceux construits à partir de zéro et à partir de l'interface graphique d'installation - utiliseront directement, dans l'interface d'administration, le nouveau menu dynamique.

Note that eZ Publish 3.10.1 introduces some changes to the dynamic tree menu functionality. In particular, the "treemenu" view of the "content" module no longer makes use of parameters that are transferred using GET variables (this improves tree menu compatibility when running PHP in FastCGI mode; refer to http://issues.ez.no/11806 for more information). 
Retenez que la version 3.10.1 de eZ Publish apporte quelques modifications aux fonctionnalités du menu dynamique, en particulier la vue de treemenu  du module content n'utilise plus de paramètres transférés par des variables GET (ce qui accroît la compatibilité du menu lorsque vous exécutez PHP en mode FastCGI  : référez-vous au lien http://issues.ez.no/11806  pour de plus amples informations).

If you want to use the new implementation of the treemenu, do the following: 
Si vous souhaitez utiliser la nouvelle implémentation du menu, observez les points suivants:

1. Open the "contentstructuremenu.ini.append.php" configuration file located in the "settings/siteaccess/example_admin" directory (replace "example_admin" with the actual name of your admin siteaccess) and edit it. If the file does not exist, create it. 
   Editez le fichier de configuration contentstructuremenu.ini.append.php placé dans le répertoire settings/siteaccess/example_admin/ (remplacez example_admin par le nom de votre siteaccess d'administration). Si le fichier n'existe pas, créez-le.
2. Add the following lines under the "[TreeMenu]" section: 
   Ajoutez les lignes suivantes sous la section [TreeMenu]:

[TreeMenu]
Dynamic=enabled

Updating Apache configuration (optional) / Mise à jour (optionnelle) de la configuration du serveur Apache

It is possible to boost the performance of the dynamic tree menu by using the "index_treemenu.php" script. This can be done by instructing Apache to use "index_treemenu.php" instead of "index.php" when the treemenu view of the content module is requested. This is an optimized script that only takes care about a specific case and thus it works faster than the regular "index.php". 
Il est possible de booster les performances du menu dynamique par le biais du script index_treemenu.php. Il faut pour cela indiquer à Apache d'utiliser index_treemenu.php en lieu et place de index.php lorsque la vue treemenu du module content est requise. Il s'agit d'un script optimisé ne prenant en compte qu'un cas spécifique, ce qui lui permet d'être plus rapide que le script index.php.

Note that due to a bug in eZ Publish 3.10.1, you need to download the updated version of "index_treemenu.php" from http://pubsvn.ez.no and replace the corresponding file in your installation. The same bug exists in eZ Publish 4.0.1. 
Retenez qu'en raison d'un bug dans la version 3.10.1, vous devez télécharger la version à jour du fichier index_treemenu.php depuis le lien http://pubsvn.ez.no  et remplacer la version existant sur votre système. Le même bug  existe dans la version 4.0.1.

Then, update your ".htaccess" file to make the system use "index_treemenu.php" when needed. This can be done by adding the following lines above the existing rewrite rules for eZ Publish:  
Pour mettre à jour votre fichier .htaccess pour que le script index_treemenu.php soit utilisé convenablement, ajoutez les deux lignes suivantes aux règles de réécritures liées à eZ Publish:

RewriteRule content/treemenu/? index_treemenu.php
RewriteRule index_treemenu.php - [L]

If no ".htaccess" file is used, it is strongly recommended to update the Apache configuration file. You can do this by adding the following line above the existing rewrite rules for eZ Publish: 
Si le fichier .htaccess_root n'est pas utilisé, il est fortement recommandé de mettre à jour le fichier de configuration du serveur Apache, en ajoutant, par exemple, la ligne ci-après à la suite des règles de réécritures relatives à eZ Publish déjà existantes:

RewriteRule content/treemenu/? /index_treemenu.php [L]

( Ndt: la syntaxe que j'ai personnellement utilisée est: RewriteRule ^content/treemenu/? /index_treemenu.php [L] )

Anchors within headings in Online Editor / Des ancres dans les titres de l'éditeur Online Editor

eZ Publish 3.10 comes with the Online Editor extension version 4.2.4 and later. In these versions, the "AnchorAsAttribute" setting located in the [header] section of the "extension/ezdhtml/settings/content.ini.append" configuration file is disabled by default (refer to http://issues.ez.no/11312 for more information). The above mentioned setting controls whether the usage of the deprecated "anchor_name" attribute for the "header" XML tag should be allowed or not. With the new default configuration, the Online Editor will automatically convert all occurrences of this attribute into separate "anchor" tags when you edit a site page. If XML content on your site is using this attribute and you want to keep the old behavior, enable the "AnchorAsAttribute" setting from within the "settings/override/content.ini.append.php" configuration file. (Do not edit "extension/ezdhtml/settings/content.ini.append"; this file is overwritten whenever you upgrade the extension.) 
eZ Publish 3.10 est livré avec la version 4.2.4 ou suivante de l'extension Online Editor. Dans ces versions, le paramètre AnchorAsAttribute de la section [header] du fichier de configuration extension/ezdhtml/settings/ content.ini.append est désactivé par défaut (référez-vous au lien http://issues.ez.no/11312  pour plus d'information). Ce paramètre contrôle si l'usage de l'attribut déprécié anchor_name à l'intérieur des balises XML header est ou non autorisé. Avec la nouvelle configuration par défaut, Online Editor convertit automatiquement, lorsque vous éditez une page du site, toutes les occurrences de cet attribut en balises anchor  séparées. Si les contenus XML de votre site utilisent cet attribut et que vous souhaitez conserver l'ancien comportement, assurez-vous alors que le paramètre AnchorAsAttribute du fichier de configuration settings/override/ content.ini.append.php est positionné sur enabled (n'éditez pas le fichier extension/ezdhtml/settings/ content.ini.append puisqu'il est écrasé par les mises à jour des extensions).

Étape 5: Clearing the caches / Vider les caches

Whenever an eZ Publish solution is upgraded, all caches must be cleared in a proper way. This should be done from within a system shell: 
Chaque fois qu'un site eZ Publish est mis à jour, tous les caches doivent être correctement vidés avec la commande suivante:

1. Navigate into the eZ Publish 3.10.1 directory. 
   Placez-vous dans le répertoire contenant la version 3.10.1 de eZ Publish,
2. Run the script using the following shell command 
   Exécutez le script avec la ligne de commande suivante:

php bin/php/ezcache.php --clear-all --purge

Purging allows to make sure the caches are physically removed. Without the "--purge" option, the caches will be expired but not removed. 
Vider les caches permet de s'assurer qu'ils ont été physiquement supprimés. Sans l'option --purge, les caches expireront mais ne seront pas supprimés.

Sometimes the script is unable to clear caches because of restrictive file/directory permission settings. Make sure that all caches have been cleared by inspecting the contents of the various cache subdirectories within the "var" directory (typically "var/cache/" and "var/<name_of_siteaccess>/cache/" directories). If there are caches left, you need to remove them manually. 
Il arrive que le script ne puisse vider correctement les caches en raison de droits d'accès sur des fichiers et répertoires. Assurez-vous qu'ils soient vidés en contrôlant le contenu des nombreux sous-répertoires de cache du répertoire var/ (typiquement, les répertoires var/cache/ et var/<nom_du_siteaccess>/cache/). S'il reste des caches vous devez les supprimer manuellement.

Commentaires