https://github.com/indigoxela/tinymcebackport
Drupal 7 module that provides an up-to-date TinyMCE as WYSIWYG editor and integration with IMCE.
https://github.com/indigoxela/tinymcebackport
drupal drupal-7 editor rich-text-editor tinymce wysiwyg
Last synced: 5 months ago
JSON representation
Drupal 7 module that provides an up-to-date TinyMCE as WYSIWYG editor and integration with IMCE.
- Host: GitHub
- URL: https://github.com/indigoxela/tinymcebackport
- Owner: indigoxela
- License: gpl-2.0
- Created: 2024-01-10T15:32:30.000Z (about 2 years ago)
- Default Branch: 7.x-1.x
- Last Pushed: 2025-01-25T11:32:25.000Z (about 1 year ago)
- Last Synced: 2025-01-25T12:23:55.381Z (about 1 year ago)
- Topics: drupal, drupal-7, editor, rich-text-editor, tinymce, wysiwyg
- Language: JavaScript
- Homepage:
- Size: 3.41 MB
- Stars: 2
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# TinyMCE backport
Integrates the most recent and supported [TinyMCE](https://www.tiny.cloud/)
as alternative WYSIWYG editor for Drupal 7.
It's a standalone module, unrelated to the existing, for a short while revived
TinyMCE module, and also unrelated to the Wysiwyg module.
The TinyMCE JavaScript library *ships with this module*, no need for extra
downloads nor the libraries module.
Note that there's absolutely *no admin interface*. All adaptions have to be
done via API in code in a custom module.
## Solving the Drupal 7 rich text editor dilemma
Since the CKEditor 4 module has been deprecated in Drupal, the only way to get
an up to date editor with Drupal 7 would be CKEditor 4 LTS - which has a
commercial license model with obscur pricing. Hardly appropriate for any site.
Support for CKEditor 5 never landed in Drupal 7, and probably never will.
And all editors supported by the Wysiwyg module are hopelessly outdated.
This Drupal 7 module aims to close that gap. It also provides IMCE integration
for file and image picking, and some rudimentary Media module support.
## Installation
- Install this module using the
[latest tar.gz release](https://github.com/indigoxela/tinymcebackport/releases/latest)
(or download a dev snapshot for testing)
- Disable CKEditor 4 on profiles for text formats on admin/config/content/ckeditor
If *filtered_html* is the text format you need the editor for, this module
should already do its job at that point.
If [IMCE](https://www.drupal.org/project/imce) is installed, the image plugin
will use that for picking inline images, the link plugin for picking file links.
A small "browse" button will appear in the dialogs.
Note that IMCE is no dependency.
If IMCE isn't installed, but the [Media module](https://www.drupal.org/project/media)
is, there's some integration with that to pick files.
Provides a plugin for image alignment based on CSS classes.
## Updating
Unfortunately, there's no automatic way to inform you about available
updates for this module via Drupal. Neither can you update it via Drupal admin UI.
You have to download the [tar.gz](https://github.com/indigoxela/tinymcebackport/releases/latest),
unpack, and upload via FTP (unless you have SSH access to your webspace).
GitHub can notify you about updates, if you subscribe to this repository. But
that requires a GitHub account.
One possible alternative is the repository RSS feed
`https://github.com/indigoxela/tinymcebackport/tags.atom`, but that's not very
convenient, either.
## Maintenance
This module will receive updates as necessary, for example to keep the TinyMCE
library up to date, but there won't be any addtional features. Notably no
admin interface will get added.
So if you need something totally different, just fork it. ;-)
### Will maintenance continue after January 5th 2025?
Yes, it will. There's no reason to stop maintenance with official Drupal 7 EOL.
The effort's minimal and the module's still useful.
If you still use it and like it, leave a star here on GitHub to inform the maintainer,
that you still appreciate it.
## Customize via API
Very likely you'll have to implement
`hook_tinymcebackport_enabled_formats_alter()` to change the filter formats,
the editor's attached to. Unless you only need the editor for the
filtered_html format, which is the default.
If you want to change toolbar buttons or enable/disable plugins, you'll have to
implement `hook_tinymcebackport_options_alter()`.
The file tinymcebackport.api.php contains examples for both hooks.
There's also an example module in
[this issue comment](https://github.com/indigoxela/tinymcebackport/issues/3#issuecomment-2060572289).
## Credits
Bundles the versatile [TinyMCE](https://www.tiny.cloud/) JavaScript library,
maintained with <3 by Ephox Corporation DBA Tiny Technologies, Inc. Licensed
under the terms of GNU General Public License Version 2 or later beginning with
its version 7.0 (used to be MIT with version 6).
The editor has been around for two decades and is one of the most used
Open Source JavaScript based WYSIWYG editors, integrated in many projects.
Based on work done for the
[Backdrop CMS TinyMCE integration module](https://backdropcms.org/project/tinymce)
## License
This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.