Migration Guide

This guide helps you migrate between major versions of the extension.

Version 2.0

Migration from version 1.x to version 2.x.

Breaking Changes

Area	Change
Configuration	TypoScript → Site Settings (see Site Settings)
TYPO3	v14 added, v12 removed
PHP	Minimum 8.2, added 8.5 support
Menu Structure	`defaultMenuStructure` options removed

Configuration Mapping

TypoScript (1.x)	Site Settings (2.x)
`config.tx_ximatypo3frontendedit_enable`	`frontendEdit.enabled`
`plugin.tx_ximatypo3frontendedit.settings.ignorePids`	`frontendEdit.filter.ignorePids`
`plugin.tx_ximatypo3frontendedit.settings.ignoreCTypes`	`frontendEdit.filter.ignoreCTypes`
`plugin.tx_ximatypo3frontendedit.settings.ignoreListTypes`	`frontendEdit.filter.ignoreListTypes`
`plugin.tx_ximatypo3frontendedit.settings.ignoreUids`	`frontendEdit.filter.ignoreUids`

Quick Migration

Update the extension to version 2.x
Remove TypoScript configuration for this extension

Add Site Settings in config/sites/<identifier>/settings.yaml:

frontendEdit:
  enabled: true
  filter:
    ignorePids: '1,2,3'
    ignoreCTypes: 'html,div'

Clear all TYPO3 caches

Menu Customization

The defaultMenuStructure configuration has been removed.

Simple edit button only:

frontendEdit:
  showContextMenu: false

Custom menu items: Use PSR-14 events (see PSR-14 Events)

use TYPO3\CMS\Core\Attribute\AsEventListener;
use Xima\XimaTypo3FrontendEdit\Event\FrontendEditDropdownModifyEvent;

#[AsEventListener]
final class ModifyMenu
{
    public function __invoke(FrontendEditDropdownModifyEvent $event): void
    {
        $event->getMenuButton()->removeChild('history');
    }
}

Need Help?

Check the FAQ for common issues
Open an issue on GitHub