README

This repository provides the add-on "Fontawesome" as a extension for TYPO3 CKEditor. It extends the default, full and minimal layout of the CKEditor. If you write your own CKE-Preset pls have attention that you not remove the Italic Button

TSConfig

Switch back to Fontawesome 4

For the default template ot the CKE-Editor

RTE.default.preset = defaultFA4

For the full template of CKE-Editor

RTE.default.preset = fullFA4

Typo3 Constants:

Disable CDN Integration in Frontend

plugin.tx_ckeditor_fontawesome.loadCSS =

Set alternativ CDN reference File

plugin.tx_ckeditor_fontawesome.css = {$path}

Switch back Fontawesome 4

# Include Fontawesome 4 from CDN
plugin.tx_ckeditor_fontawesome.css = https://maxcdn.bootstrapcdn.com/font-awesome/4.7.0/css/font-awesome.min.css

Add Fotawesome in your own RTE Preset

To add this Plug-In in your own RTE Config. Import the Config in your preset.

imports:
    - { resource: "EXT:rte_ckeditor_fontawesome/Configuration/RTE/PluginFA5.yaml" }

At the next step you need to extend your individual Toolbar-Config to add the Clickable Icon.

  ...
  toolbar:
        - [ 'Bold', 'Italic', .....]
        ...
        - [ 'ckeditor_fa5' ]
        ...

Use Fontawesome Pro, or Custom Config:

first create the file /fileadmin/rte_ckeditor_fontawesome/FA5Pro.yaml. Copy the content from below and replace your fontawesome pro link.

imports:
  - { resource: "EXT:rte_ckeditor/Configuration/RTE/Full.yaml" }
  - { resource: "EXT:rte_ckeditor_fontawesome/Configuration/RTE/PluginFA5Pro.yaml" }
# Add configuration for the editor
editor:
  config:
    fontAwesome:
      - "LINK TO FONTAWESOME PRO"

Add to your TSConfig:

// Zuweisen der Konfiguration im PageTSconfig
RTE.default.preset = fa5pro

Add to your constant or clear this:

# Include Fontawesome 5-Pro CSS
plugin.tx_ckeditor_fontawesome.css = "LINK TO FONTAWESOME PRO"

Fontawesome 6 Pro

Usually you have a RTE config in your sitepackage, if not create a new file.

add PluginFA6Pro.yaml to imports
add fontAwesome URL or path to CSS
if icons are still missing: check webfonts path in the css and change if necessary

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_fontawesome/Configuration/RTE/PluginFA6Pro.yaml" }

editor:
  config:
    fontAwesome:
      - "EXT:sitepackage/Resources/Public/Fonts/Css/fa6pro-all.css"

TCA Selector for Fontawesome Icons

You can use the Fontawesome SVG folder as source for a TCA Select field. Change "fileFolder" to the path where your SVGs are located:

'icon'  => [
    'exclude' => 1,
    'label'   => 'Icon',
    'config'  => [
        'type'                  => 'select',
        'renderType'            => 'selectMultipleSideBySide',
        'fileFolder'            => 'EXT:sitepackage/Resources/Public/Icons/Fontawesome/',
        'fileFolder_extList'    => 'svg',
        'fileFolder_recursions' => 0,
        'size'                  => 5,
        'minitems'              => 0,
        'maxitems'              => 1,
    ],
],

With npm installation, the SVGs are located in node_modules/@fortawesome/fontawesome-pro/svgs/light

ToDo:

Add FA-Icon in Content Headline Definition.

Please give us feedback

We would appreciate any kind of feedback or ideas for further developments to keep improving the extension for your needs.

Say thanks! and support me

You like this extension? Get something for me (surprise!) from my wishlist on Amazon or the next pizza. Thanks a lot!

dirkpersky / typo3-rte-ckeditor-fontawesome

Maintainers

Details

Add Maintainer

Remove Maintainer