Download the PHP package waynestate/nova-ckeditor4-field without Composer
On this page you can find all versions of the php package waynestate/nova-ckeditor4-field. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download waynestate/nova-ckeditor4-field
More information about waynestate/nova-ckeditor4-field
Files in waynestate/nova-ckeditor4-field
Package nova-ckeditor4-field
Short Description This nova package allows you to use CKEditor 4 for text areas.
License MIT
Informations about the package nova-ckeditor4-field
Laravel Nova CKEditor 4 Field
:warning: CKEditor4 End of Life :warning:
The time has come where CKEditor4 has reached it's semi End of Life, which you can read more about at CKEditor 4: End of Life June 2023
Unforunately to use the CKEditor4 LTS (anything greater than v4.22.1), it requires that you have a Long Term Support.
This package isn't going anywhere soon, but if you are using CKEditor4 v4.22.1 or less, you may encounter a Security Warning due to the CKEditor checking a version file on the CKEditor side.
This disables the security warning option by default within the configuration since by default it points to v4.22.1 non-LTS CKEditor4.
If you do have the LTS package for CKEditor4, please renable your version check within your configuration, before updating this package to v1.4.0
.
Overview
This nova package allows you to use CKEditor 4 for text areas using Nova v4.
Installation
Nova v1, v2, v3 compatibility instructions
You can install the package into a Laravel application that uses Nova via composer:
By default the CKEditor 4 instance used is the latest (4.22.1) Full All version (https://cdn.ckeditor.com/). If you wish to use a different CKEditor 4 you can do so by publishing and editing the configuration.
Usage
Overriding Config Values
To change any of config values, publish a config file:
Customization
Configuration options
You can change the configuration options of the CKEditor instance by either editing the published config file at nova.ckeditor-field.options
or you can pass it with the options
method using:
File Uploads
The nova-ckeditor4-field
allows the use of file uploads by extending the attachment functionality of the Trix field
The package migrations will automatically run when running php artisan migrate
.
If you are not going to use the Files and have no need for the migrations, you can disable migrations in config/nova/ckeditor-field.php
, set the enable_migrations
to false
.
If you do not wish to use the Laravel Migration, but publish the migration yourself to your project.
Within the published /config/nova/ckeditor-field.php
, set the auto_migrate
to false
.
and then publish the migration to your project.
if you wish to not use the default Attachment
and/or PendingAttachment
models. You could replace with your own within the published /config/nova/ckeditor-field.php
,
Using the File Uploads feature requires that the CKEditor uses the plugins Enhanced Image (image2) and UploadImage. If they are not included within your configuration, they will be added automatically.
Like the Trix field you'll be able to chain the method withFiles
onto the field's definition, while passing the name of the filesystem disk where the images should be stored:
Also to prune any stale attachments from the storage and table, you'll want to register a job to run periodically:
Limitations using File Uploads
Images are not removed from the filesystem when they are removed from the editor. For the time being you'll need to rectrify this on your own.
Custom CKEditor Instance
If you wish to not use the CKEditor from the CKEditor CDN, you can change the ckeditor_url
under config/nova/ckeditor-field.php
to point to the URL of the CKEditor you wish to use.
If you wish to go the route of a Custom CKEditor Instance using Composer then follow the steps at Using Composer for Custom CKEditor Instance
Nova v1, v2, or v3 compatibility
If you require the use of nova-ckeditor4-field
using Nova v1, v2 or v3, you can install using version 0.7.0
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
Credits
- Wayne State University
- All Contributors
License
The MIT License (MIT). Please see License File for more information.