Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tbmatuka/EditorjsBundle
Symfony bundle for Editor.js
https://github.com/tbmatuka/EditorjsBundle
Last synced: 3 months ago
JSON representation
Symfony bundle for Editor.js
- Host: GitHub
- URL: https://github.com/tbmatuka/EditorjsBundle
- Owner: tbmatuka
- License: mit
- Created: 2019-08-12T09:08:24.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-02-02T12:01:51.000Z (almost 2 years ago)
- Last Synced: 2024-07-12T05:47:43.658Z (4 months ago)
- Language: PHP
- Size: 71.3 KB
- Stars: 15
- Watchers: 2
- Forks: 11
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-editorjs - EditorjsBundle
README
# EditorjsBundle
Symfony bundle that integrates Editor.js primarily with Symfony Forms.## Installation
### Symfony
1. Download the package with composer: `$ composer require tbmatuka/editorjs-bundle`
1. Add the bundle to `bundles.php` if it wasn't added automatically: `Tbmatuka\EditorjsBundle\TbmatukaEditorjsBundle::class => ['all' => true],`
1. Copy the example package config file (`examples/ediotrjs.yaml`) or use it as an example to create your own configuration.
1. Add the form theme to your twig configuration:
```php
twig:
form_themes:
- '@TbmatukaEditorjs/Form/editorjs_widget.html.twig'
```### JavaScript
There is an example of the JS implementation in `examples/editorjs-init.js`.
#### Encore/webpack
If you're using Encore, you will need to install the npm package for Editor.js (`@editorjs/editorjs`) and any plugins that you want to use. Copy the example to your assets dir, add the plugin classes to the array and import the file from your main JS file.
#### Inline
Configuration options and examples will have to be added for other loading methods (like loading JS from the CDN or a local path inline in the widget), but they're not there for now.## Usage
### Symfony Forms
You can use the `EditorjsType` in your forms to get Editor.js on the frontend. Data (decoded json) is returned as an array.
### Twig
You can get an Editor.js config directly from the Twig extension. Check the form widget in `src/Resources/views/Form/editorjs_widget.html.twig` to see how to use it. The `editorjs()` Twig function accepts either a configuration object or just the name of a configuration that you want to use.
## Contributing
Any kind of help is welcome, but especially information about the included JS not working in specific browsers. Please open an issue to discuss whatever you want to work on before you submit a pull request and avoid any kind of BC breaking changes unless they are agreed to in the issue discussion.