dirkpersky/typo3-rte-ckeditor-fontawesome

Adds the Fontawesome add-on to the CKEditor in TYPO3.

Installs: 80 662

Dependents: 2

Suggesters: 0

Security: 0

Stars: 15

Watchers: 3

Forks: 7

Open Issues: 5

Language:JavaScript

Type:typo3-cms-extension

11.5.6 2022-11-03 13:30 UTC

This package is auto-updated.

Last update: 2023-06-07 09:00:23 UTC


README

Donate Latest Stable Version TYPO3 License

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.

Update YAML

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 Donate the next pizza. Thanks a lot!

Contact me