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.