kitzberger/rte-ckeditor-automails

TYPO3 CKEditor Rich Text Editor: Auto-link mail addresses

1.0.8 2022-05-03 07:51 UTC

Requires

• typo3/cms-core: ^8.7 || ^9.5 || ^10.4 || ^11.5

GPL-2.0-or-later

• TYPO3 CMS

README

Brings the feature of automatically linking mail addresses to TYPO3's default editor ckeditor.

Installation

• composer require kitzberger/rte-ckeditor-automails
• Install extension via extension manager in the backend

Load PageTS

Simply load the RTE configuration default+automails provided by this extension via PageTS to the root page of your page tree. This'll set the default RTE configuration enhanced by this plugin as a default for all RTEs in that page tree.

Custom RTE config

Alternatively to enabling the default+automails configuration you can create your own RTE configuration and simply import the yaml file as described below.

EXT:custom/ext_localconf.php

$GLOBALS['TYPO3_CONF_VARS']['RTE']['Presets']['custom'] = 'EXT:custom/Configuration/RTE/Default.yaml';

EXT:custom/Configuration/RTE/Default.yaml

# Load default processing options + the automails plugin
imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Processing.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Base.yaml" }
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Editor/Plugins.yaml" }
  - { resource: "EXT:rte_ckeditor_automails/Configuration/RTE/Plugin.yaml" }

Default link class

The class that is being used by default for the created <a> tag is: mail.

You can change that by adding this to your RTE configuration:

editor:
  externalPlugins:
    automails:
      defaultClass: 'autolinked-mail-address'