nswdpc / silverstripe-trumbowyg
Decorate textarea fields with the Trumbowyg editor, support content sanitising and a restricted feature set by default
Installs: 1 997
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 3
Forks: 0
Open Issues: 0
Type:silverstripe-vendormodule
Requires
- ezyang/htmlpurifier: ^4.17
- silverstripe/framework: ^5
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3
- phpunit/phpunit: ^9.5
This package is auto-updated.
Last update: 2024-11-02 05:08:33 UTC
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
License
Documentation
Configuration
See config.yml for module configuration values
Maintainers
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.