---
title: "Reference"
manual: "dpn_glossary"
version: "7.0"
permalink: "https://docs.typo3.org/permalink/featdd/dpn-glossary:configuration-reference@7.0"
source: "Configuration/Reference.rst"
rendered: "2026-09-21T17:52:00+00:00"
---

# Reference {#configuration-reference}

## Extension settings {#extension-settings}

These settings are configured globally for the extension.

| Key | Data type | Default | Description |
| --- | --- | --- | --- |
| `termSlugEvaluation` | string | `unique` | Evaluation type for the term slug field. |

## Site settings {#site-settings}

When the site set `featdd/dpn-glossary` is included, configure these
values as TYPO3 site settings. In YAML files the keys are stored flat:

**config/sites/\<your-site>/settings.yaml**

```yaml
dpn-glossary.storagePidList: '123'
dpn-glossary.glossaryPage: 456
dpn-glossary.parsingPids: '0'
```

| Key | Data type | Default | Description |
| --- | --- | --- | --- |
| `dpn-glossary.view.layoutRootPath` | string | `EXT:dpn_glossary/Resources/Private/Layouts/` | Fluid layout root path. |
| `dpn-glossary.view.templateRootPath` | string | `EXT:dpn_glossary/Resources/Private/Templates/` | Fluid template root path. |
| `dpn-glossary.view.partialRootPath` | string | `EXT:dpn_glossary/Resources/Private/Partials/` | Fluid partial root path. |
| `dpn-glossary.storagePidList` | string | empty | Comma-separated list of storage page IDs that contain glossary terms. |
| `dpn-glossary.glossaryPage` | page | `0` | Page ID of the glossary plugin. The parser links terms to this page. |
| `dpn-glossary.parsingPids` | string | empty | Comma-separated list of pages that should be parsed. Use `0` to parse all pages. |
| `dpn-glossary.parsingExcludePidList` | string | empty | Comma-separated list of pages that should not be parsed. |
| `dpn-glossary.disableParser` | bool | `false` | Disable automatic parsing. |
| `dpn-glossary.parsingSpecialWrapCharacters` | string | empty | Comma-separated list of additional special characters that may wrap a term. |
| `dpn-glossary.parserRepositoryClass` | string | `\Featdd\DpnGlossary\Domain\Repository\ParserTermRepository` | Repository class used by the parser. Use `\Featdd\DpnGlossary\Domain\Repository\TermRepository` if the term wrapping TypoScript needs all term fields. |
| `dpn-glossary.maxReplacementPerPage` | int | `-1` | Maximum replacements for each term on a page. `-1` means unlimited. |
| `dpn-glossary.maxReplacementPerPageRespectSynonyms` | bool | `false` | Count synonym replacements against the term replacement limit. |
| `dpn-glossary.parsingTags` | string | `p` | Comma-separated list of HTML tags whose content should be parsed. |
| `dpn-glossary.forbiddenParentTags` | string | `a,script` | Comma-separated list of parent tags inside which parsing is not allowed. |
| `dpn-glossary.forbiddenParsingTagClasses` | string | empty | Comma-separated list of classes that exclude the parsing tag itself. |
| `dpn-glossary.forbiddenParentClasses` | string | `tx_dpn_glossary_exclude` | Comma-separated list of classes that exclude a parsing tag through any parent element. |
| `dpn-glossary.parseSynonyms` | bool | `true` | Enable parsing of term synonyms. |
| `dpn-glossary.priorisedSynonymParsing` | bool | `true` | Parse synonyms before the original term. |
| `dpn-glossary.limitParsingId` | string | empty | Limit parsing to one node with this HTML ID. |
| `dpn-glossary.useTermForSynonymParsingDataWrap` | bool | `false` | Use the original term as content object data when rendering synonym links. |
| `dpn-glossary.excludeTermLinksTargetPages` | bool | `false` | Do not parse a term when the current page is the target page of that term. |
| `dpn-glossary.listmode` | string | `normal` | List mode of the glossary plugin. Supported values: `normal`, `character`, `pagination`. |
| `dpn-glossary.previewmode` | string | `newest` | Preview plugin mode. Supported values: `newest`, `random`. |
| `dpn-glossary.previewlimit` | int | `5` | Number of terms rendered by preview plugins. |
| `dpn-glossary.addStylesheet` | bool | `true` | Include the extension CSS file. |
| `dpn-glossary.overrideFluidStyledContentLayout` | bool | `false` | Override the Fluid Styled Content layout so editors can exclude content elements from parsing. |

## Legacy TypoScript constants {#legacy-typoscript-constants}

If you use the legacy static TypoScript include instead of the site set, use the
old TypoScript constants:

| Site setting | Legacy TypoScript constant |
| --- | --- |
| `dpn-glossary.storagePidList` | `plugin.tx_dpnglossary.persistence.storagePid` |
| `dpn-glossary.glossaryPage` | `plugin.tx_dpnglossary.settings.detailPage` |
| `dpn-glossary.view.layoutRootPath` | `plugin.tx_dpnglossary.view.layoutRootPath` |
| `dpn-glossary.view.templateRootPath` | `plugin.tx_dpnglossary.view.templateRootPath` |
| `dpn-glossary.view.partialRootPath` | `plugin.tx_dpnglossary.view.partialRootPath` |
| All other `dpn-glossary.*` settings | `plugin.tx_dpnglossary.settings.*` |