mziraki / nova-tinymce
This Nova package allow you to use TinyMCE editor for text areas.You can customize the editor options and... you can upload images to your server and put them rigth there on the text without leaving the text editor!
Requires
- php: >=7.1.0
README
This Nova package allow you to use TinyMCE editor for text areas. You can customize the editor options and... you can upload images to your server and put them right there on the text without leaving the text editor!!
Installation
composer require emilianotisato/nova-tinymce
In order to work with this editor you need to create a free account to get the editor API_KEY. Once you have don this, create this key inside your config/nova.php
file
'tinymce_api_key' => env('TINYMCE_API_KEY'),
and add the TINYMCE_API_KEY
to your .env file with the key from tiny.cloud website.
Usage
In your Nova resource add the use declaration and use the NovaTinyMCE field:
use Emilianotisato\NovaTinyMCE\NovaTinyMCE; // ... /** * Get the fields displayed by the resource. * * @param \Illuminate\Http\Request $request * @return array */ public function fields(Request $request) { return [ ID::make()->sortable(), NovaTinyMCE::make('body'), ]; }
By default, the editor comes with default options and the image without the filemanager. You can use custome options like this:
NovaTinyMCE::make('body')->options([ 'plugins' => [ 'advlist autolink lists link image charmap print preview hr anchor pagebreak' ], 'toolbar' => 'insertfile undo redo | styleselect | bold italic' ]),
Using the upload images feature
Now if you need to upload images from the text editor, we need to install UniSharp Laravel Filemanager, and pass the use_lfm
key to your options array:
NovaTinyMCE::make('body')->options([ 'plugins' => [ 'advlist autolink lists link image charmap print preview hr anchor pagebreak', 'searchreplace wordcount visualblocks visualchars code fullscreen', 'insertdatetime media nonbreaking save table contextmenu directionality', 'emoticons template paste textcolor colorpicker textpattern' ], 'toolbar' => 'insertfile undo redo | styleselect | bold italic | alignleft aligncenter alignright alignjustify | bullist numlist outdent indent | link image media', 'use_lfm' => true ]),
In case you change the laravel-filemanager
URL in the package config file, you need to pass that info to this nova field with the lfm_url
key in the options array.
// ... 'use_lfm' => true, 'lfm_url' => 'laravel-filemanager' // ...
Extra configuration and plugin customization
You can virtually pass any configuration option for the javascript SDK to the array in the options()
method.
For example, you like to have increased the height of the text area:
NovaTinyMCE::make('body')->options([ 'height' => '980' ]),
You can see the full list of parameters in the docs: https://www.tiny.cloud/docs-3x/reference/Configuration3x/