nswdpc/silverstripe-trumbowyg

Decorate textarea fields with the Trumbowyg editor, support content sanitising and a restricted feature set by default

v1.0.0-rc1 2023-06-21 03:57 UTC

Requires

• ezyang/htmlpurifier: ^4.13
• silverstripe/framework: ^5

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3
• phpunit/phpunit: ^9.5
• silverstripe/sqlite3: ^2

BSD-3-Clause

• James Ellis

• editor
• silverstripe
• htmleditor
• trumbowyg

README

Decorate textarea fields with the Trumbowyg editor.

This module supports:

• content sanitising of submitted content on the client side using Trumbowyg configuration rules and server side using HTMLPurifier)
• restricted feature set by default (see documentation)

Use cases

This editor field is useful for gathering content where some form of formatting in HTML is required. It is not intended for use in the administration area (although PRs are welcome for that, for example a restricted content editing field)

As the goal is only a restricted feature set for simple content submissions, the module will not support:

• file uploads
• image uploads
• image insertion

Please use dedicated upload fields for handling file uploads.

Requirements

Per composer.json:

• silverstripe/framework ^4.10.0
• jQuery 3.6.0

The field pulls in required Trumbowyg JS and CSS assets from cdnjs.com along with their respective Sub Resource Integrity (SRI) hashes.

If you wish to use your own jQuery, set the TrumboywgEditorField.use_own_jquery configuration value to false in your project configuration. When false, the module will not include its own jQuery.

Installation

composer require nswdpc/silverstripe-trumbowyg

Usage

See the basic example

License

BSD-3-Clause

Documentation

• Documentation

Configuration

See config.yml for module configuration values

Maintainers

• dpcdigital@NSWDPC:~$

Bugtracker

We welcome bug reports, pull requests and feature requests on the Github Issue tracker for this project.

Please review the code of conduct prior to opening a new issue.

Development and contribution

If you would like to make contributions to the module please ensure you raise a pull request and discuss with the module maintainers.

Please review the code of conduct prior to completing a pull request.