[FEATURE] Allow replacing strings in slug
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 9.5.x / Feature-86740-AllowRemovalOfSlashInSlug.rst
1 .. include:: ../../Includes.txt
2
3 ============================================
4 Feature: #86740 - Replace characters in slug
5 ============================================
6
7 See :issue:`86740`
8
9 Description
10 ===========
11
12 The configuration of the TCA type `slug` has been extended by the setting `replace`.
13 It allows to replace strings of a slug part.
14
15
16 Impact
17 ======
18
19 Especially for enhancing the site configuration it might be useful to set the configuration.
20
21 Full example
22 ------------
23 By using the following configuration, slashes are removed from the slug.
24
25 .. code-block:: php
26
27     'type' => 'slug',
28     'config' => [
29         'generatorOptions' => [
30             'fields' => ['title'],
31             'replacements' => [
32                 '/' => ''
33             ],
34         ]
35         'fallbackCharacter' => '-',
36         'prependSlash' => true,
37         'eval' => 'uniqueInPid'
38     ]
39
40 Advanced examples
41 -----------------
42 The following configuration uses more replacements:
43
44 .. code-block:: php
45
46     'type' => 'slug',
47     'config' => [
48         'generatorOptions' => [
49             'fields' => ['title'],
50             'replacements' => [
51                 '(f/m)' => '',
52                 '/' => '-'
53             ],
54         ]
55         'fallbackCharacter' => '-',
56         'prependSlash' => true,
57         'eval' => 'uniqueInPid'
58     ]
59
60 This will change the provided slug `Some Job in city1/city2 (f/m)` to `some-job-in-city1-city2`.
61
62 .. index:: Frontend, ext:core, NotScanned