---
title: "Administrator Manual"
version: "2.0"
source: "Administrator/Index.rst"
rendered: "2026-09-25T09:03:21+00:00"
---

# Administrator Manual {#administrator}

> [!TIP]
> **Hint**
>
> Please read the [documentation of the TYPO3 PersistedPatternMapper](https://docs.typo3.org/m/typo3/reference-coreapi/master/en-us/ApiOverview/Routing/AdvancedRoutingConfiguration.html#persistedpatternmapper) for details.

## Properties {#administrator-properties}

### type {#conftype}

-   **Property**

    type

-   **Data type**

    string

-   **Description**

    The aspect type is *CcPersistedPatternMapper*.

-   **Default**

    N/A

### tableName {#conftablename}

-   **Property**

    tableName

-   **Data type**

    string

-   **Description**

    The database table.

-   **Default**

    N/A

### routeFieldResult {#confroutefieldresult}

-   **Property**

    routeFieldResult

-   **Data type**

    string

-   **Description**

    Table field(s) to use for path segment alias.

-   **Default**

    N/A

### routeFieldHandles {#confroutefieldhandles}

-   **Property**

    routeFieldHandles

-   **Data type**

    string

-   **Description**

    Comma separated list to convert the field data.
    Possible values are: asciiTranslit, toLowerCase, specialCharsRemove, trim, filter, md5

-   **Default**

    N/A

### filter {#conffilter}

-   **Property**

    filter

-   **Data type**

    string

-   **Description**

    Regular expression to filter the path segment.
    This can be used to limit the length, see the example below.

-   **Default**

    /(.\*)/

### specialCharsRemoveSearch {#confspecialcharsremovesearch}

-   **Property**

    specialCharsRemoveSearch

-   **Data type**

    string

-   **Description**

    Regular expression to search the path segment.

-   **Default**

    /\[^a-zA-Z0-9\_\]+/

### specialCharsRemoveReplace {#confspecialcharsremovereplace}

-   **Property**

    specialCharsRemoveReplace

-   **Data type**

    string

-   **Description**

    Replacement string of search.

-   **Default**

    -

## Example {#administrator-example}

```yaml
routeEnhancers:
  CcExamplePlugin:
    type: Extbase
    extension: CcExample
    plugin: Fe
    routes:
      - { routePath: '{title}',_controller: 'View::show',_arguments: {'title': 'item'} }
    defaultController: 'View::show'
    aspects:
      title:
        type: CcPersistedPatternMapper
        tableName: 'tx_ccexample_item'
        routeFieldResult: '{title}-{location}'
        routeFieldHandles: 'asciiTranslit,toLowerCase,specialCharsRemove,trim,filter,md5'
        filter: '/^(.{0,40})/'
#        specialCharsRemoveSearch: '/[^a-zA-Z0-9_]+/'
#        specialCharsRemoveReplace: '-'
```

## Extension configuration {#administrator-extconf}

### expire {#confexpire}

-   **Property**

    expire

-   **Data type**

    int

-   **Description**

    Days until pathsegments will expire.

-   **Default**

    N/A

### refresh {#confrefresh}

-   **Property**

    refresh

-   **Data type**

    int

-   **Description**

    Refresh pathsegments after these days. This value should be lower than the expire days.

-   **Default**

    N/A