PHPackages                             froala/craft-froala-wysiwyg - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. froala/craft-froala-wysiwyg

ActiveCraft-plugin

froala/craft-froala-wysiwyg
===========================

Craft 3 CMS plugin for Froala WYSIWYG HTML Rich Text Editor.

5.0.1(2mo ago)1719.0k↓100%12[11 issues](https://github.com/froala/Craft-3-Froala-WYSIWYG/issues)[1 PRs](https://github.com/froala/Craft-3-Froala-WYSIWYG/pulls)MITPHPCI failing

Since Jun 27Pushed 2mo ago4 watchersCompare

[ Source](https://github.com/froala/Craft-3-Froala-WYSIWYG)[ Packagist](https://packagist.org/packages/froala/craft-froala-wysiwyg)[ Docs](https://github.com/froala/Craft-3-Froala-WYSIWYG)[ RSS](/packages/froala-craft-froala-wysiwyg/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (77)Used By (0)

Froala WYSIWYG editor for Craft CMS (v3)
========================================

[](#froala-wysiwyg-editor-for-craft-cms-v3)

The implementation of the Froala Editor (license not included) for Craft CMS (v3)

**[Check the Craft CMS v2 version here](https://github.com/froala/Craft-Froala-WYSIWYG/)**

[![Entry Field Example](screenshots/editor-on-entry.jpg "Entry Field Example")](screenshots/editor-on-entry.jpg)

Installation
------------

[](#installation)

You can install this plugin from the Plugin Store or with Composer.

#### From the Plugin Store

[](#from-the-plugin-store)

Go to the Plugin Store in your project's Control Panel and search for "Froala". Then click on the "Install" button in its modal window.

#### With Composer

[](#with-composer)

Open your terminal and run the following commands:

```
# go to the project directory
cd /path/to/my-project

# tell Composer to load the plugin
composer require froala/craft-froala-wysiwyg

# tell Craft to install the plugin
./craft install/plugin froala-editor
```

Known issue (help wanted!)
--------------------------

[](#known-issue-help-wanted)

Adding links to Craft Entries causing issues when you double click on the entry to link to. Just click once and use the "Select" button.

Sorry for the inconvience. We're working on these annoying issues. But we decided to release a new version because of some missing important other features (like saving links the Craft way).

Configuration
-------------

[](#configuration)

### Froala Configs

[](#froala-configs)

You can create custom configs that will be available to your Froala fields. They should be created as JSON files in your `config/froalaeditor/` folder.

For example, if you created a `config/froalaeditor/Simple.json` file with the following content:

```
{
  "toolbarButtons": [
    "bold", "italic", "underline", "strikeThrough", "formatOL", "formatUL", "insertHR", "|",
    "undo", "redo", "|", "paragraphFormat", "paragraphStyle", "|", "html"
  ],
  "paragraphFormat": {
    "N": "Normal",
    "H1": "Heading 1",
    "H2": "Heading 2",
    "H3": "Heading 3",
    "H4": "Heading 4"
  }
}
```

…then a "Simple" option would become available within the config section on your Froala field’s settings.

See the [Froala documentation](https://www.froala.com/wysiwyg-editor/docs/options) for a list of available config options and buttons.

Third party plugins
-------------------

[](#third-party-plugins)

```

```

### HTML Purifier Configs

[](#html-purifier-configs)

Froala fields use [HTML Purifier](http://htmlpurifier.org) to ensure that no malicious code makes it into its field values, to prevent XSS attacks and other vulnerabilities.

You can create custom HTML Purifier configs that will be available to your Froala fields. They should be created as JSON files in your `config/htmlpurifier/` folder.

Use this as a starting point, which is the default config that Froala fields use if no custom HTML Purifier config is selected:

```
{
    "Attr.AllowedFrameTargets": ["_blank"],
    "Attr.EnableID": true,
    "HTML.AllowedComments": ["pagebreak"]
}
```

(The [HTML.AllowedComments](http://htmlpurifier.org/live/configdoc/plain.html#HTML.AllowedComments) option is required for the `pagebreak` plugin.)

See the [HTML Purifier documentation](http://htmlpurifier.org/live/configdoc/plain.html) for a list of available config options.

Contributing
------------

[](#contributing)

If you have any issue regarding the editor itself, please report your issue on the [main repository](https://github.com/froala/wysiwyg-editor) itself.

You can raise an issue here if you have found a problem in the integration with Craft CMS v3.

If you already have fixed the bug yourself, please create a Pull Request (PR) and send us the fixes with a detailed description of the problem and the fix. Please PR your changes on our **develop branch**.

Any help will be appreciated. Many thanks.

License
-------

[](#license)

To enable the editor correctly, you should have a purchased a license on [www.froala.com](https://www.froala.com/wysiwyg-editor/pricing).

Once you have a license, for your domain, you can enter the license key in the plugin settings.

###  Health Score

55

—

FairBetter than 98% of packages

Maintenance71

Regular maintenance activity

Popularity35

Limited adoption so far

Community20

Small or concentrated contributor base

Maturity78

Established project with proven stability

 Bus Factor1

Top contributor holds 55.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Total

72

Last Release

83d ago

Major Versions

2.9.2.3 → v3.x-dev2019-03-01

2.9.5 → 3.1.02020-01-28

2.9.8 → 3.2.02020-07-22

3.2.7 → 4.0.02021-06-01

4.7.1 → 5.0.02026-01-15

### Community

Maintainers

![](https://www.gravatar.com/avatar/06cd51627b7bd31a9a904858d2e659f10667d6d4fc5988788dafc96ce3cde211?d=identicon)[stefanneculai](/maintainers/stefanneculai)

---

Top Contributors

[![harasunu-narayan](https://avatars.githubusercontent.com/u/60644555?v=4)](https://github.com/harasunu-narayan "harasunu-narayan (40 commits)")[![kapil2704](https://avatars.githubusercontent.com/u/47421622?v=4)](https://github.com/kapil2704 "kapil2704 (19 commits)")[![reganlawton](https://avatars.githubusercontent.com/u/2705875?v=4)](https://github.com/reganlawton "reganlawton (5 commits)")[![singhmonaaccolite](https://avatars.githubusercontent.com/u/46958934?v=4)](https://github.com/singhmonaaccolite "singhmonaaccolite (3 commits)")[![jiteshgupta1995](https://avatars.githubusercontent.com/u/17355509?v=4)](https://github.com/jiteshgupta1995 "jiteshgupta1995 (2 commits)")[![Zae](https://avatars.githubusercontent.com/u/96126?v=4)](https://github.com/Zae "Zae (1 commits)")[![froala-travis-bot](https://avatars.githubusercontent.com/u/96036514?v=4)](https://github.com/froala-travis-bot "froala-travis-bot (1 commits)")[![brandonkelly](https://avatars.githubusercontent.com/u/47792?v=4)](https://github.com/brandonkelly "brandonkelly (1 commits)")

---

Tags

craft-plugincraftcmsfroala-editorpluginwysiwyg-editorpluginwysiwygCraftcraftcmsfroalacraftcms-plugin

### Embed Badge

![Health badge](/badges/froala-craft-froala-wysiwyg/health.svg)

```
[![Health](https://phpackages.com/badges/froala-craft-froala-wysiwyg/health.svg)](https://phpackages.com/packages/froala-craft-froala-wysiwyg)
```

###  Alternatives

[am-impact/amcommand

Command palette in Craft.

8674.1k3](/packages/am-impact-amcommand)[putyourlightson/craft-log-to-file

Logs messages to a specific log file for Craft CMS.

29368.0k5](/packages/putyourlightson-craft-log-to-file)[marionnewlevant/twig-perversion

Making twig do things it really shouldn't

5465.6k1](/packages/marionnewlevant-twig-perversion)[topshelfcraft/walk

A Craft-aware array\_walk() method, plus some super-convenient console commands, to easily call Craft service methods on a collection of elements or values.

221.5k](/packages/topshelfcraft-walk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)