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..0610a0ef0e --- /dev/null +++ b/docs/administration/back_office/customize_integrated_help.md @@ -0,0 +1,90 @@ +--- +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. +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 modifying a link to user documentation in a yaml file +- by subscribing to the `ibexa_integrated_help.menu_configure.help_menu` event + +## 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 in, 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..ced15182df --- /dev/null +++ b/docs/administration/back_office/integrated_help.md @@ -0,0 +1,28 @@ +--- +description: Integrated help provides quick access to documentation, training, and support resources. +month_change: true +--- + +# Integrated help + +Integrated help is an LTS Update 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 +``` + +## 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 f4aec03e4a..d34eb85fbc 100644 --- a/docs/ibexa_products/editions.md +++ b/docs/ibexa_products/editions.md @@ -57,4 +57,13 @@ Compare all features available in [[= product_name_headless =]], [[= product_nam | [Storefront](storefront.md) | | | ✔ | | [Transactional emails](transactional_emails.md) | | | ✔ | | [Discounts](discounts.md) | | | ✔ | -| [Symbol attribute type](symbol_attribute_type.md) | ✔ | ✔ | ✔ | \ No newline at end of file +| [Symbol attribute type](symbol_attribute_type.md) | ✔ | ✔ | ✔ | + +## LTS Updates + +LTS Updates are opt-in packages that bring additional features to the [LTS releases](release_process_and_roadmap.md#long-term-support-releases) that they enhance. +The features brought by LTS Updates become standard parts of the next LTS release. + +| Feature | [[= product_name_headless =]] | [[= product_name_exp =]] | [[= product_name_com =]] | +|-----------------|-----------------|-----------------|-----------------| +| [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 f574e52dae..72cc560d13 100644 --- a/docs/release_notes/ibexa_dxp_v5.0.md +++ b/docs/release_notes/ibexa_dxp_v5.0.md @@ -12,6 +12,19 @@ month_change: false [[% set version = 'v5.0.2' %]] +[[= release_note_entry_begin("Integrated help", '2024-10-20', ['Headless', 'Experience', 'Commerce', 'LTS Update', 'New feature']) =]] + +The Integrated help [LTS update](editions.md#lts-updates) brings contextual documentation, guidance, and partner-specific resources right into the [[= product_name =]]'s user interface. +It helps editors, store managers and developers alike quickly access relevant content, training and resources without leaving the UI, which bridges the gap between product and documentation. + +The default help menu can be modified th include links to internal editorial guidelines, custom tutorials, or support pages. + +![Integrated help menu](../administration/back_office/img/5_0_integrated_help_menu.png) + +For more information, see [Integrated help](integrated_help.md). + +[[= release_note_entry_end() =]] + [[= 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 1c968c1ce4..a33918ceb9 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -160,6 +160,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