Search by

masilia / editorial-toolbox

masilia

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

Homepage

Issues

Type:symfony-bundle

pkg:composer/masilia/editorial-toolbox

Statistics

Installs: 5

Dependents: 0

Suggesters: 2

Stars: 0

0.3.3 2026-11-18 00:35 UTC

This package is auto-updated.

Last update: 2026-11-18 00:35:34 UTC


README

CI Latest version PHP License: MIT

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):

Installation

composer require masilia/editorial-toolbox
  1. Enable the bundle in config/bundles.php:

    Masilia\Bundle\EditorialToolbox\MasiliaEditorialToolboxBundle::class => ['all' => true],
  2. Import the API routes (config/routes/masilia_editorial_toolbox.yaml):

    masilia_editorial_toolbox:
        resource: '@MasiliaEditorialToolboxBundle/Resources/config/routing.yaml'
        prefix: /admin/api
  3. 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.

  4. 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
  5. Render the toolbox in the layout of your theme, and load the admin-toolbar.js entry in its scripts (with masilia/ibexa-blocks, list it under assets.extra in the theme.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-sites requires ibexa-admin-kit
  • ibexa-ai requires ibexa-admin-kit
  • ibexa-ai-editor requires ibexa-ai
  • ibexa-ai-craft requires ibexa-ai, ibexa-blocks and ibexa-sites
  • ibexa-blocks and editorial-toolbox require none of the others; they are happy to find ibexa-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

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.