README

Sometimes you need to store values that are not directly related to a specific page or content type, but rather to the entire webspace. This Sulu bundle provides a way to manage such settings in a structured manner.

Requirements

PHP 8.2
Symfony >=7.2

Install the bundle

Execute the following composer command

composer require alengo/alengo-webspace-settings-bundle

Enable the bundle

Enable the bundle by adding it to the list of registered bundles in the config/bundles.php file of your project:

return [
    /* ... */
    Alengo\Bundle\AlengoWebspaceSettingsBundle\AlengoWebspaceSettingsBundle::class => ['all' => true],
];

bin/console do:sch:up --force

Configure the Bundle

Set the following config in your routes_admin.yaml

alengo_webspace_settings_api:
   type: attribute
   resource: Alengo\Bundle\AlengoWebspaceSettingsBundle\Controller\Admin\WebspaceSettingsController
   prefix: /admin/api
   name_prefix: alengo_webspace_settings.

Type Selection

Set the property types you want to provide.

config/packages/alengo_webspace_settings.yaml

alengo_webspace_settings:
    type_select:
        - 'blocks'
        - 'contact'
        - 'contacts'
        - 'event'
        - 'media'
        - 'medias'
        - 'organization'
        - 'organizations'
        - 'page'
        - 'pages'
        - 'string' # default type
        - 'textArea'
        - 'textEditor'

Twig Extension

The bundle provides a Twig extension to render the webspace settings in your templates. You can use the webspaceSettings function to retrieve the settings for a specific webspace and typeKey.

{{ webspaceSettings('metaPublisher') }}

with localization

{{ webspaceSettings('metaTitleFallBack', app.request.locale) }}

Events

The bundle dispatches the following events:

WebspaceSettingsCreatedEvent
WebspaceSettingsUpdatedEvent

Create an event listener in your project to listen to these events and perform any necessary actions when webspace settings are created or updated. It is recommended to use the settings type Event.

alengo / alengo-webspace-settings-bundle

Maintainers

Details