diff --git a/code_samples/back_office/menu/menu_item/src/EventSubscriber/HelpMenuSubscriber.php b/code_samples/back_office/menu/menu_item/src/EventSubscriber/HelpMenuSubscriber.php new file mode 100644 index 0000000000..371ad44fce --- /dev/null +++ b/code_samples/back_office/menu/menu_item/src/EventSubscriber/HelpMenuSubscriber.php @@ -0,0 +1,53 @@ + 'onHelpMenuConfigure', + ]; + } + + public function onHelpMenuConfigure(Event $event): void + { + $menu = $event->getMenu(); + + // Remove roadmap menu item + if ($menu->getChild('help__general')) { + $generalSection = $menu->getChild('help__general'); + if ($generalSection->getChild('help__product_roadmap')) { + $generalSection->removeChild('help__product_roadmap'); + } + } + + // Add videos tab, shown only in production + if ($this->kernelDebug === false) { + $resourcesSection = $menu->addChild('help__videos', [ + 'label' => 'Product videos', + ]); + + $resourcesSection->addChild('help__webinar_v5', [ + 'label' => 'Webinar: Introducing Ibexa DXP v5', + 'uri' => 'https://www.youtube.com/watch?v=qWaBHG2LRm8', + 'extras' => [ + 'isHighlighted' => false, + 'icon' => 'https://doc.ibexa.co/en/5.0/templating/twig_function_reference/img/icons/video.svg.png', + 'description' => 'Discover new features and improvements brought by Ibexa DXP v5.', + ], + ]); + } + } +} diff --git a/docs/administration/back_office/customize_integrated_help.md b/docs/administration/back_office/customize_integrated_help.md new file mode 100644 index 0000000000..6a7a760f8e --- /dev/null +++ b/docs/administration/back_office/customize_integrated_help.md @@ -0,0 +1,101 @@ +--- +description: Customize the integrated help menu. +edition: lts-update +month_change: true +--- + +# Customize integrated help + +The integrated help menu is part of the Integrated help introduced as an [LTS Update](editions.md#lts-updates). +By default, it provides editors and developers with convenient access to documentation, training and other resources directly from the back office. + +You can extend or modify the integrated menu in two ways: + +- by disabling it for all users +- by modifying a link to user documentation +- by subscribing to the `ibexa_integrated_help.menu_configure.help_menu` event + +## Disable integrated help for all users + +After you have installed the integrated help package, you may still want to disable it globally, for example, to run UI tests in a `dev` [environment](environments.md). +To do it, in `config/packages` create the `ibexa_integrated_help.yaml` file, with the following configuration: + +``` yaml +ibexa_integrated_help: + enabled: false +``` + +## Modify user documentation link + +[[= product_name =]] provides a comfortable method for replacing a link to user documentation, when you do not want to modify the rest of the integrated help menu. +This way you can direct application users such as editors or store managers to specific guidelines in force at your organization, without having to resort to development. + +To do it, in `config/packages` create the `ibexa_integrated_help.yaml` file, with the following configuration: + +``` yaml +ibexa_integrated_help: + user_documentation: +``` + +## Intercept and modify event + +[[= product_name =]] uses [KnpMenuBundle](https://github.com/KnpLabs/KnpMenuBundle) to build its backend menus. +When it builds the integrated help menu, it dispatches the `ibexa_integrated_help.menu_configure.help_menu` event to pass information about the contents of the help menu to the front end. + +You can intercept this event, and change its contents by creating a subscriber. +With that subscriber, you can access the `menu` object, which is an instance of the `Knp\Menu\MenuItem`, and all the options passed by this object, and modify them. +This way you can adjust menu sections that are reproduced by the front end as tabs, add new items, or integrate custom links into the help system. + +### Menu object structure + +The default `menu` object is structured as follows. +Recreate this pattern when modifying an existing event with an intention to send it to the front end. + +``` +root (MenuItem) +│ +├── help__general // ("General" section) +│ ├── help__user_documentation // (User docs, highlighted menu option) +│ │ (...) +│ └── help__submit_idea // (Submit idea, regular option) +│ +└── help__developers // (conditional "Developers" section) + ├── help__developer_documentation // (Developer docs, highlighted) + │ (...) + └── help__support_portal +``` + +`help_general` and `help_developers` are menu sections, or tabs. +Sections consist of entries, and each entry carries the following information: + +- `label` - a name of the help menu item +- `uri` - an external link to the resource +- `isHighlighted` - a Boolean switch that decides whether the menu item should be placed at the top of the tab +- `icon` - a link to a graphic file to accompany the menu item +- `description` - a summary of what users can expect after clicking the menu item + +### Create a subscriber + +Build a subscriber that intercepts the event and modifies it. +In this example, it removes a product roadmap entry from the menu and adds a help menu tab with links to product videos. +The tab is displayed in a production environment only. + +``` php +[[= include_file('code_samples/back_office/menu/menu_item/src/EventSubscriber/HelpMenuSubscriber.php') =]] +``` + +!!! tip + + If `autoconfigure` is enabled, the event subscriber is registered as a service by default. + If not, register it as a service and tag with `kernel.event.subscriber`. + + ```yaml + services: + App\EventSubscriber\HelpMenuSubscriber: + arguments: + $kernelDebug: '%kernel.debug%' + tags: + - { name: kernel.event_subscriber } + ``` + +For more ideas on how you can extend the help menu, see [Back office menus](back_office_menus.md). diff --git a/docs/administration/back_office/img/5_0_integrated_help_menu.png b/docs/administration/back_office/img/5_0_integrated_help_menu.png new file mode 100644 index 0000000000..2d19d47a20 Binary files /dev/null and b/docs/administration/back_office/img/5_0_integrated_help_menu.png differ diff --git a/docs/administration/back_office/img/about-info.png b/docs/administration/back_office/img/about-info.png new file mode 100644 index 0000000000..6ae3b7dbfe Binary files /dev/null and b/docs/administration/back_office/img/about-info.png differ diff --git a/docs/administration/back_office/integrated_help.md b/docs/administration/back_office/integrated_help.md new file mode 100644 index 0000000000..b558b6fcd6 --- /dev/null +++ b/docs/administration/back_office/integrated_help.md @@ -0,0 +1,32 @@ +--- +description: Integrated help provides quick access to documentation, training, and support resources. +edition: lts-update +month_change: true +edition: lts-update +--- + +# Integrated help + +Integrated help is an [LTS Update](editions.md#lts-updates) that brings documentation, training resources and product roadmap-related information into the back office. +With this feature installed, users can click the ![Help icon](about-info.png){.inline-image} icon to access relevant content straight from the UI. + +![Integrated help menu](5_0_integrated_help_menu.png) + +Integrated help is contextual, therefore, apart from user documentation, release notes, and partner guidelines, which are available to editors and store managers, developers can access API references, the GraphQL console, or the support portal. + +## Install package + +Integrated help is optional. +To enable it, run the following command: + +```bash +composer require ibexa/integrated-help +``` + +After installation, you must [enable the help center in user settings]([[= user_doc =]]/getting_started/discover_ui#enable-help-center) to use the feature. + +## Customize help menu + +You can extend or alter the integrated help menu by quickly changing the link to user documentation, or adding or removing menu items or even entire menu sections. + +For more information, see [Customize integrated help](customize_integrated_help.md). diff --git a/docs/ibexa_products/editions.md b/docs/ibexa_products/editions.md index 00a47a5e80..bbc686efa5 100644 --- a/docs/ibexa_products/editions.md +++ b/docs/ibexa_products/editions.md @@ -67,3 +67,4 @@ The features brought by LTS Updates become standard parts of the next LTS releas | Feature | [[= product_name_headless =]] | [[= product_name_exp =]] | [[= product_name_com =]] | |-----------------|-----------------|-----------------|-----------------| | [Anthropic connector](configure_ai_actions.md#install-anthropic-connector) | ✔ | ✔ | ✔ | +| [Integrated help](integrated_help.md) | ✔ | ✔ | ✔ | diff --git a/docs/release_notes/ibexa_dxp_v5.0.md b/docs/release_notes/ibexa_dxp_v5.0.md index 6a4d1a363a..2744bed937 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -57,8 +57,6 @@ The PHP API has been expanded with the following: [[% include 'snippets/release_50.md' %]] [[= release_note_entry_end() =]] -[[% set version = 'v5.0.2' %]] - [[= release_note_entry_begin("Ibexa DXP " + version, '2025-09-09', ['Headless', 'Experience', 'Commerce', 'New feature']) =]] #### Collaboration diff --git a/mkdocs.yml b/mkdocs.yml index 37b8b6bed5..32df06a7af 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -161,6 +161,9 @@ nav: - Multi-file upload: administration/back_office/multifile_upload.md - Sub-items list: administration/back_office/subitems_list.md - Notifications: administration/back_office/notifications.md + - Integrated help: + - Integrated help: administration/back_office/integrated_help.md + - Customize integrated help: administration/back_office/customize_integrated_help.md - Customize search: - Customize search suggestion: administration/back_office/customize_search_suggestion.md - Customize search sorting: administration/back_office/customize_search_sorting.md