Summary

Usage

TransformationGroup=<group>

Description

This directive sets which method of transformation that should be used when generating virtual URLs. The default value is "urlalias".
For more details on the available transformation groups, please check the transform.ini/[Transformation]/Groups documentation page.
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:

php bin/php/updateniceurls.php --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 update all the URLs, based on the number specified. Note that the "fetch-limit" parameter is optional.

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.