Skip to content

Commit

Permalink
Add missing deprecation notices to the insert-tags page (#1396)
Browse files Browse the repository at this point in the history
  • Loading branch information
@lukasbableck
lukasbableck authored Sep 23, 2024
1 parent fc2f7f6 commit 0383969
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 13 deletions.
12 changes: 6 additions & 6 deletions docs/manual/article-management/insert-tags.de.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ oder den Alias der Zielseite.
| `{{link::login}}` | Dieses Tag wird mit einem Link zur Anmeldeseite des aktuellen Frontend-Benutzers (falls vorhanden) ersetzt. |
| `{{link_open::*}}` | Wird mit dem öffnenden Tag eines Links ersetzt. Der Parameter kann entweder die ID oder der Alias einer Seite sein, auch eine absolute URL ist möglich: `{{link_open::12}}Hier klicken{{link_close}}`. |
| `{{link_url::*}}` | Dieses Tag wird mit der URL einer internen Seite ersetzt: `<a href="{{link_url::12}}">Hier klicken</a>`. |
| `{{link_target::*}}` | Dieses Tag wird mit ` target="_blank" rel="noreferrer noopener"` ersetzt, wenn es sich bei der angegebenen Seite um eine externe Weiterleitungsseite handelt, und dort eingestellt ist, dass sich der Link in einem neuen Fenster öffnen soll. |
| `{{link_target::*}}` | Dieses Tag wird mit ` target="_blank" rel="noreferrer noopener"` ersetzt, wenn es sich bei der angegebenen Seite um eine externe Weiterleitungsseite handelt, und dort eingestellt ist, dass sich der Link in einem neuen Fenster öffnen soll. (veraltet seit **Contao 4.4**, nicht mehr verfügbar in **Contao 5.0**) |
| `{{link_title::*}}` | Dieses Tag wird mit dem Titel einer internen Seite ersetzt: `<a title="{{link_title::12}}">Hier klicken</a>`. |
| `{{link_name::*}}` | Dieses Tag wird mit dem Namen einer internen Seite ersetzt: `<a>{{link_name::12}}</a>`. |
| `{{link_close}}` | Wird mit dem schließenden Tag eines Links zu einer internen Seite ersetzt: `{{link_open::12}}Hier klicken{{link_close}}`. |
Expand Down Expand Up @@ -60,7 +60,7 @@ oder den Alias der Zielseite.

`{{link::*`**`::absolute`**`}}`: Der Parameter erlaubt es, ein Insert-Tag-Link als absolute URL auszugeben.

**HTML-Ausgabe**
**HTML-Ausgabe**
Der Insert-Tag-Link mit Parameter generiert folgenden HTML-Code:

```html
Expand All @@ -72,7 +72,7 @@ Der Insert-Tag-Link mit Parameter generiert folgenden HTML-Code:

`{{link::*`**`::blank`**`}}`: Der Parameter erlaubt es, ein Insert-Tag-Link in einem neuen Fenster zu öffnen.

**HTML-Ausgabe**
**HTML-Ausgabe**
Der Insert-Tag-Link mit Parameter generiert folgenden HTML-Code:

```html
Expand Down Expand Up @@ -234,11 +234,11 @@ Verfügbare Flags:
| `urlattr` | Wandelt Sonderzeichen in Entities um, gleich wie `attr`. Zusätzlich werden Doppelpunkte URL-enkodiert, um unerlaubte Protokolle wie `javascript:` zu verhindern. | siehe&nbsp;`StringUtil::specialcharsUrl()` |
| `addslashes` | Stellt bestimmten Zeichen eines Strings ein (<code>\\</code>) voran. | [PHP-Funktion](https://php.net/addslashes) |
| `standardize` | Standardisiert die Ausgabe (z. B. das Alias bei der Seitenstruktur). | |
| `absolute` | Generiert einen absoluten Pfad inkl. Hostnamen und Protokoll | Ab Contao **4.5** verfügbar |
| `absolute` | Generiert einen absoluten Pfad inkl. Hostnamen und Protokoll | Ab Contao **4.5** verfügbar (veraltet seit **Contao 4.12**, nicht mehr verfügbar in **Contao 5.0**) |
| `ampersand` | Wandelt `&`-Zeichen in Entities um. | |
| `specialchars` | Wandelt Sonderzeichen in Entities um. | |
| `nl2br` | Fügt vor allen Zeilenumbrüchen eines Strings HTML-Zeilenumbrüche ein. | [PHP-Funktion](https://php.net/nl2br) |
| `nl2br_pre` | Erhält die Zeilenumbrüche innerhalb von `<pre>`-Tags. | |
| `nl2br_pre` | Erhält die Zeilenumbrüche innerhalb von `<pre>`-Tags. | (veraltet seit **Contao 4.0**, nicht mehr verfügbar in **Contao 5.0**) |
| `strtolower` | Wandelt die Ausgabe in Kleinbuchstaben um. | [PHP-Funktion](https://php.net/strtolower) |
| `utf8_strtolower` | Unicode-bewusste Umwandlung in Kleinbuchstaben. | |
| `strtoupper` | Wandelt die Ausgabe in Großbuchstaben um. | [PHP-Funktion](https://php.net/strtoupper) |
Expand Down Expand Up @@ -274,7 +274,7 @@ Folgende »Basic Enities« werden von Contao in die jeweiligen HTML Entities zur

{{% notice "info" %}}
Seit Contao **5** passiert dies nicht mehr automatisch für einzelne Felder des DCAs. In deinen eigenen DCA Feldern muss
diese Funktion über `'basicEntities' => true` im [`eval`](https://docs.contao.org/dev/reference/dca/fields#evaluation)
diese Funktion über `'basicEntities' => true` im [`eval`](https://docs.contao.org/dev/reference/dca/fields#evaluation)
der Feld-Definition aktiviert werden.
{{% /notice %}}

Expand Down
14 changes: 7 additions & 7 deletions docs/manual/article-management/insert-tags.en.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ With these insert tags you can create links to other pages or articles. You only
| `{{link::login}}` | This tag is replaced with a link to the logon page of the current front end user (if available). |
| `{{link_open::*}}` | Is replaced with the opening tag of a link. The parameter can be the ID or alias of an internal page or an absolute URL: `{{link_open::12}}Click here{{link_close}}`. |
| `{{link_url::*}}` | This tag is replaced with the URL of an internal page: `<a href="{{link_url::12}}">Click here</a>`. |
| `{{link_target::*}}` | This tag will be replaced with `target="_blank" rel="noreferrer noopener"` if the specified page is an external redirection page and it is set there that the link should open in a new window. |
| `{{link_target::*}}` | This tag will be replaced with `target="_blank" rel="noreferrer noopener"` if the specified page is an external redirection page and it is set there that the link should open in a new window. (deprecated since **Contao 4.4**, not available anymore in **Contao 5.0**) |
| `{{link_title::*}}` | This tag is replaced with the title of an internal page: `<a title="{{link_title::12}}">Click here</a>`. |
| `{{link_name::*}}` | This tag will be replaced with the name of an internal page: `<a>{{link_name::12}}</a>`. |
| `{{link_close}}` | Will be replaced with the closing tag of a link to an internal page: `{{link_open::12}}Click here{{link_close}}`. |
Expand Down Expand Up @@ -54,7 +54,7 @@ With these insert tags you can create links to other pages or articles. You only

`{{link::*`**`::absolute`**`}}`: The parameter allows to output an insert tag link as an absolute URL.

**The HTML Output**
**The HTML Output**
The insert tag link with parameter generates the following HTML code:

```html
Expand All @@ -66,7 +66,7 @@ The insert tag link with parameter generates the following HTML code:

`{{link::*`**`::blank`**`}}`: The parameter allows to open an insert tag link in a new window.

**The HTML Output**
**The HTML Output**
The insert tag link with parameter generates the following HTML code:

```html
Expand Down Expand Up @@ -223,11 +223,11 @@ Available flags:
| `urlattr` | Converts special characters into entities, same as `attr`. Additionally, colons get URL encoded to disable disallowed protocols like `javascript:`. | see&nbsp;`StringUtil::specialcharsUrl()` |
| `addslashes` | Prepends certain characters in a string (`\`). | [PHP function](https://php.net/addslashes) |
| `standardize` | Standardizes the output (for example, the alias in the page structure). | |
| `absolute` | Generates an absolute path including host name and protocol | Available in Contao **4.5** and later |
| `absolute` | Generates an absolute path including host name and protocol | Available in Contao **4.5** and later (deprecated since **Contao 4.12**, not available anymore in **Contao 5.0**) |
| `ampersand` | Converts `&` characters into entities. | |
| `specialchars` | Converts special characters into entities. | |
| `nl2br` | Inserts HTML line breaks before all line breaks in a string. | [PHP function](https://php.net/nl2br) |
| `nl2br_pre` | Keeps the line breaks within `<pre>` tags. | |
| `nl2br_pre` | Keeps the line breaks within `<pre>` tags. | (deprecated since **Contao 4.0**, not available anymore in **Contao 5.0**) |
| `strtolower` | Converts the output to lower case. | [PHP function](https://php.net/strtolower) |
| `utf8_strtolower` | Unicode-conscious conversion to lower case. | |
| `strtoupper` | Converts the output to capital letters. | [PHP function](https://php.net/strtoupper) |
Expand Down Expand Up @@ -262,8 +262,8 @@ The following "basic entities" are converted back into the respective HTML entit
| `[{]`, `[}]` | Replaced in the front end with `{{` or `}}`, respectively. This enables you to display insert tags in the front end. For example, to explain them. |

{{% notice "info" %}}
Since Contao **5** this is no longer automatically the case for individual DCA fields. In your own DCA fields you will
need to enable the conversion via `'basicEntities' => true` in the [`eval`](https://docs.contao.org/dev/reference/dca/fields#evaluation)
Since Contao **5** this is no longer automatically the case for individual DCA fields. In your own DCA fields you will
need to enable the conversion via `'basicEntities' => true` in the [`eval`](https://docs.contao.org/dev/reference/dca/fields#evaluation)
definitions.
{{% /notice %}}

Expand Down

0 comments on commit 0383969

Please sign in to comment.