Summary

Usage

 
TransformationGroup=urlalias_iri|urlalias|urlalias_compat

Description

This directive sets which method of transformation that should be used when generating virtual URLs. The default value is "urlalias_iri" (it will be changed to "urlalias" in eZ Publish 3.10.1 and later versions). Refer to the "Character transformation" part of the "Multi-language support for URL aliases" documentation page for information about the available transformation methods. Make sure you specify the same value for all siteaccesses that share the same database.

Every time this setting is changed, the "bin/php/updateniceurls.php" script must be run in order to update the URL aliases stored in the database. This script should be run once for each database, specifying one siteaccess per database (replace "example" with the actual name of your siteaccess):

php bin/php/updateniceurls.php -s example

The script will create new virtual URLs for all content object nodes in accordance with the selected method of transformation. The time it takes to update all URL aliases is proportional to the number of nodes on your site.

Note that after running the "updateniceurls.php" script, 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" directives, this functionality might stop working if the specified URL aliases have changed. 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.