masilia / editorial-toolbox
In-context editorial toolbox for Ibexa: front-end edit toolbar, block sidebar and the JSON API behind them
Package info
github.com/MasiliaLabs/ibexa-editorial-toolbox
Type:symfony-bundle
pkg:composer/masilia/editorial-toolbox
Requires
- php: ^8.1
- ibexa/admin-ui: ^4.6 || ^5.0
- ibexa/core: ^4.6 || ^5.0
- symfony/config: ^5.4 || ^6.4 || ^7.0
- symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
- symfony/event-dispatcher: ^5.4 || ^6.4 || ^7.0
- symfony/framework-bundle: ^5.4 || ^6.4 || ^7.0
- symfony/http-foundation: ^5.4 || ^6.4 || ^7.0
- symfony/http-kernel: ^5.4 || ^6.4 || ^7.0
- symfony/routing: ^5.4 || ^6.4 || ^7.0
- symfony/security-csrf: ^5.4 || ^6.4 || ^7.0
- symfony/translation-contracts: ^2.5 || ^3.0
- twig/twig: ^3.0
Requires (Dev)
- phpstan/phpstan: ^1.10 || ^2.0
- phpunit/phpunit: ^9.6 || ^10.5 || ^11.0
Suggests
- masilia/ibexa-blocks: Marks the page and its blocks for in-context editing
- masilia/ibexa-sites: Sets the admin siteaccess of each site from its registry (masilia_editorial_toolbox.admin_siteaccess)
Provides
None
Conflicts
None
Replaces
None
README
In-context editing for the front office of an Ibexa site: an edit toolbar, a block sidebar and the JSON API behind them.
masilia/editorial-toolbox is part of a family of packages for Ibexa that work together or alone. See the other packages.
What it is
A floating edit toolbar and a block sidebar that logged-in editors see on the public site of an Ibexa project, to edit what they are looking at without going to the back office first — plus the small JSON API behind them. It works with Ibexa 4.6 and 5.0.
Features
- An edit toolbar on the page: edit the content in context (in an edit modal over the page), and discard the draft.
- A block sidebar for pages made of blocks: a palette of block types to add, an existing content to link as a block, drag and drop to reorder, a trash zone to remove a block, and the draft of a block to discard.
- Translation-aware: it edits the language the content is displayed in and, when the content has no translation in the site language, asks the editor what to do instead of creating a blank one.
- Opt-in markup with the Twig function
masilia_editorial_attrs(), which marks a template root as editable. - Per-site configuration: the field that holds the blocks and the admin siteaccess used to build back-office URLs from the front office.
Requirements
- PHP 8.1 or later
- Ibexa 4.6 and 5.0 (Symfony 5.4, 6.4 or 7)
Works better with (optional):
masilia/ibexa-blocksmarks pages and blocks for in-context editingmasilia/ibexa-sitesgives the admin siteaccess of each site
Installation
composer require masilia/editorial-toolbox
-
Enable the bundle in
config/bundles.php:Masilia\Bundle\EditorialToolbox\MasiliaEditorialToolboxBundle::class => ['all' => true],
-
Import the API routes (
config/routes/masilia_editorial_toolbox.yaml):masilia_editorial_toolbox: resource: '@MasiliaEditorialToolboxBundle/Resources/config/routing.yaml' prefix: /admin/api
-
Configure it (
config/packages/masilia_editorial_toolbox.yaml):masilia_editorial_toolbox: system: default: blocks_field: blocks # the relation list that holds the ordered blocks of a page admin_siteaccess: admin # the siteaccess of the back office my_site_group: admin_siteaccess: admin_my_site
With
masilia/ibexa-sites, the admin siteaccess of each site comes from its registry. -
Add the entry to the front-office Encore build (
webpack.config.js):const masilia = require('./vendor/masilia/editorial-toolbox/src/bundle/Resources/encore/masilia.config.js'); masilia.addEntry(Encore, 'admin-toolbar.js'); // before Encore.getWebpackConfig() const config = Encore.getWebpackConfig(); masilia.patchConfig(config); // after it: lets the package resolve your node_modules
-
Render the toolbox in the layout of your theme, and load the
admin-toolbar.jsentry in its scripts (withmasilia/ibexa-blocks, list it underassets.extrain thetheme.yaml):{{ masilia_editorial_toolbox() }}Mark a template root as editable with
{{ masilia_editorial_attrs() }}.
Usage
Log in to the back office, then browse the public site: the toolbar appears for users who may edit the content. Visitors see nothing.
Tests
composer install vendor/bin/phpunit
The Masilia packages
| Package | What it does |
|---|---|
masilia/ibexa-admin-kit |
React components in the design of the Ibexa admin, for admin pages |
masilia/ibexa-sites |
A registry of sites that Ibexa serves without a deploy |
masilia/ibexa-ai |
The AI assistant for Ibexa: capabilities, providers, chat, approval flow |
masilia/ibexa-ai-craft |
The assistant builds sites and pages out of blocks |
masilia/ibexa-ai-editor |
AI suggestions and image generation in the content editing form |
masilia/ibexa-blocks |
Front-office rendering of pages made of blocks, with themes |
masilia/editorial-toolbox |
In-context editing toolbar for the front office |
What requires what (Composer installs it for you):
ibexa-sitesrequiresibexa-admin-kitibexa-airequiresibexa-admin-kitibexa-ai-editorrequiresibexa-aiibexa-ai-craftrequiresibexa-ai,ibexa-blocksandibexa-sitesibexa-blocksandeditorial-toolboxrequire none of the others; they are happy to findibexa-sites(and each other) when installed.
Compatibility
| Package version | PHP | Ibexa |
|---|---|---|
0.3.x |
8.1+ | 4.6 and 5.0 |
Download
- Composer (recommended):
composer require masilia/editorial-toolbox— editorial-toolbox on Packagist - Archive of a release: GitHub releases (each release lists what changed)
- Source:
git clone https://github.com/MasiliaLabs/editorial-toolbox.git - What changed between versions: CHANGELOG.md
Support, contributing and security
- Questions and bug reports: GitHub issues
- Pull requests are welcome, see CONTRIBUTING.md
- Security problems: please follow SECURITY.md and do not open a public issue
License
Released under the MIT license. Copyright © 2026 MasiliaLabs.
Ibexa itself is distributed under its own licenses (Ibexa OSS: GPL-2.0), which apply to the project that uses this package. This package is an independent project, not affiliated with or endorsed by Ibexa AS; "Ibexa" is a trademark of its owner.