Skip to content

Commit 428ad1b

Browse files
Merge pull request #1052 from akeneo/DXIM-11_ui_ext_product_selection
DXIM-11 - Add productSelection ui-ext doc + reorganize position & faq
2 parents 229af8b + 729b9b5 commit 428ad1b

23 files changed

+121
-97
lines changed

.gitleaks.toml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,5 +17,5 @@ paths = [
1717
# Rest API old authentication
1818
'''content/rest-api/authentication_old.md''',
1919
# UI Extension documentation
20-
'''content/extensions/ui-extensions.md''',
20+
'''content/extensions/getting-started.md''',
2121
]

content/extensions/faq.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
## FAQ
2+
### Who is responsible for UI extensions?
3+
Akeneo is responsible for the UI extensions framework itself, including the APIs and administrative interface. We provide support for these components. Your organization or your integrator is responsible for any custom code, iframes, or other custom development built within the UI extensions. Support for this custom code falls to your organization or integrator, not Akeneo.
4+
5+
### How can I add a new UI extension to my PIM?
6+
Adding a new extension to your organization is easy! Just follow the steps in [this guide](https://api.akeneo.com/extensions/getting-started.html#getting-started).
7+
8+
### The UI extensions entry isn't showing up in my PIM. Could you help me understand why?
9+
If you don't see the UI extensions entry in your PIM, it's likely due to permission settings. [This guide](https://api.akeneo.com/extensions/getting-started.html#authorization) will help you check and activate the necessary permissions.
10+
11+
### I'd like to see my extension in a position that isn't currently available. What can I do?
12+
Currently, UI extension placements are limited to those defined by Akeneo. However, we highly value your feedback! Please contact your Customer Success Manager or our Support team to share your specific placement needs. This will help us understand your use case and consider it for future development.

content/extensions/filtering.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# Filtering UI extensions
2+
3+
You may want to create UI extensions that are only available to certain user groups or for specific products. This can be achieved by filtering UI extensions based on user groups and product selection.
4+
5+
### Filter UI extension by user groups
6+
7+
You can filter the user groups allowed to see and execute an UI extension by using the permissions tab on the UI extensions creation/edition form.
8+
9+
[![ui-extension-permissions.png](../img/extensions/ui-extensions/ui-extension-permissions.png)](../img/extensions/ui-extensions/ui-extension-permissions.png)
10+
11+
### Filter UI extension by product selection
12+
You can filter the products that can be selected by an UI extension by using the product selection tab on the UI extensions creation/edition form.
13+
14+
[![ui-extension-product-selection.png](../img/extensions/ui-extensions/ui-extension-product-selection.png)](../img/extensions/ui-extensions/ui-extension-product-selection.png)
15+
16+
::: panel-link FAQ [Next](/extensions/faq.html)
17+
:::

content/extensions/ui-extensions.md renamed to content/extensions/getting-started.md

Lines changed: 4 additions & 88 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,9 @@
1-
# UI extensions
1+
# Getting Started
22
The UI extension feature enables you to extend your PIM by integrating custom views and actions from external systems. This framework provides the flexibility to modify and adapt your PIM experience to meet specific business requirements.
33
By leveraging this functionality, you can integrate custom solutions while maintaining the reliability and ease the use of our SaaS platform, offering a balance between flexibility and stability.
44

55
The extension framework is designed to help you customize the standard behavior of your PIM system by integrating with externally hosted solutions. This documentation provides an overview of the framework's capabilities and the various customization options available, enabling you to extend and tailor your PIM to meet your specific business needs.
66

7-
## Getting Started
87
This guide provides a step-by-step walkthrough for setting up and managing UI extensions.
98

109
### Prerequisites
@@ -494,75 +493,6 @@ Examples :
494493
}
495494
```
496495

497-
## Positions
498-
499-
**Extension Positions**
500-
501-
Extension position determines where your extension appears within the Akeneo PIM interface. You can select from a variety of available positions, which vary depending on the specific extension type.
502-
503-
**Key Concepts:**
504-
505-
* **Position Options:** Each extension type offers a set of predefined positions. These positions control the location of your extension's interface elements.
506-
* **Contextual Relevance:** Position options are designed to align with the functionality of each extension type, ensuring a seamless user experience.
507-
508-
**Best Practices:**
509-
510-
* Choose a position that aligns with the extension's intended functionality and user workflow.
511-
* Review the available position options for each extension type to ensure optimal integration.
512-
* Consider the impact of the position on the overall user experience within the PIM.
513-
514-
515-
### Positions list
516-
517-
![PIM Header.png](../img/extensions/ui-extensions/pim-header-with-extension.png)
518-
#### pim.product.header
519-
This position refers to the header of a simple product or a variant edit page.
520-
521-
#### pim.product-model.header
522-
This position refers to the header of a root model edit page.
523-
524-
#### pim.sub-product-model.header
525-
This position refers to the header of a sub model edit page.
526-
527-
![PIM Tab.png](../img/extensions/ui-extensions/pim-product-with-tab-extension.png)
528-
#### pim.product.tab
529-
This position refers to the left panel of a simple product or a variant edit page.
530-
531-
#### pim.product-model.tab
532-
This position refers to the left panel of a root model edit page.
533-
534-
#### pim.sub-product-model.tab
535-
This position refers to the left panel of a sub model edit page.
536-
537-
#### pim.category.tab
538-
This position refers to the horizontal list of tabs on a category edit page.
539-
540-
![PIM Product Grid.png](../img/extensions/ui-extensions/pim-product-grid-with-bulk-trigger-action.png)
541-
#### pim.product-grid.action-bar
542-
This position refers to the list of commands availables after selecting some products on the product grid.
543-
544-
::: warning
545-
For the moment, you can't use UI extensions with more than **500** selected products & product models.
546-
:::
547-
548-
#### pim.activity.navigation.tab
549-
This position refers to the activity PIM menu, adding UI extensions in this position will create a new section in the activity sub-navigation.
550-
551-
### Available types by position
552-
Each position supports a specific subset of available types. The table below outlines the compatible types for all positions.
553-
554-
| Positions | Action | Iframe | Link |
555-
|------------------------------|--------|--------|-------|
556-
| pim.product.header | ✔️ || ✔️ |
557-
| pim.product-model.header | ✔️ || ✔️ |
558-
| pim.sub-product-model.header | ✔️ || ✔️ |
559-
| pim.product.tab || ✔️ ||
560-
| pim.product-model.tab || ✔️ ||
561-
| pim.sub-product-model.tab || ✔️ ||
562-
| pim.category.tab || ✔️ ||
563-
| pim.product-grid.action-bar | ✔️ | ✔️ ||
564-
| pim.activity.navigation.tab || ✔️ ||
565-
566496
## Administration of UI extensions
567497
For a functional overview of the administration panel and permissions, see our [Help Center](https://help.akeneo.com/extensions/ui-extentions).
568498

@@ -582,25 +512,11 @@ On the new page, you can see all extensions registered in your PIM.
582512

583513
To manage one or more UI extensions from the list, you just have to select them thanks to the checkboxes present on the left of each line, and then use one of the two commands available at the bottom of the screen.
584514

585-
### Filter UI extension by user groups
586-
587-
You can filter the user groups allowed to see and execute an UI extension by using the permissions tab on the UI extensions creation/edition form.
588-
589515
## API reference
590516
Several choices are offered to deep dive into our API, to discover all the endpoints, and their request/response schema:
591517

592518
- You can <a href="https://api.akeneo.com/api-reference-index.html#UIExtensions" target="_blank">consult this static documentation</a>
593-
- Discover it thanks to <a href="https://api.akeneo.com/files/Akeneo%20PIM%20API.postman_collection.json" target="_blank">the postman collection</a> (see the [Postman section](https://api.akeneo.com/extensions/ui-extensions.html#using-postman))
594-
595-
## FAQ
596-
### Who is responsible for UI extensions?
597-
Akeneo is responsible for the UI extensions framework itself, including the APIs and administrative interface. We provide support for these components. Your organization or your integrator is responsible for any custom code, iframes, or other custom development built within the UI extensions. Support for this custom code falls to your organization or integrator, not Akeneo.
519+
- Discover it thanks to <a href="https://api.akeneo.com/files/Akeneo%20PIM%20API.postman_collection.json" target="_blank">the postman collection</a> (see the [Postman section](https://api.akeneo.com/extensions/getting-started.html#using-postman))
598520

599-
### How can I add a new UI extension to my PIM?
600-
Adding a new extension to your organization is easy! Just follow the steps in [this guide](https://api.akeneo.com/extensions/ui-extensions.html#getting-started).
601-
602-
### The UI extensions entry isn't showing up in my PIM. Could you help me understand why?
603-
If you don't see the UI extensions entry in your PIM, it's likely due to permission settings. [This guide](https://api.akeneo.com/extensions/ui-extensions.html#authorization) will help you check and activate the necessary permissions.
604-
605-
### I'd like to see my extension in a position that isn't currently available. What can I do?
606-
Currently, UI extension placements are limited to those defined by Akeneo. However, we highly value your feedback! Please contact your Customer Success Manager or our Support team to share your specific placement needs. This will help us understand your use case and consider it for future development.
521+
::: panel-link UI extensions available positions [Next](/extensions/positions.html)
522+
:::

content/extensions/positions.md

Lines changed: 76 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,76 @@
1+
# Positions
2+
3+
Extension position determines where your extension appears within the Akeneo PIM interface. You can select from a variety of available positions, which vary depending on the specific extension type.
4+
5+
**Key Concepts:**
6+
7+
* **Position Options:** Each extension type offers a set of predefined positions. These positions control the location of your extension's interface elements.
8+
* **Contextual Relevance:** Position options are designed to align with the functionality of each extension type, ensuring a seamless user experience.
9+
10+
**Best Practices:**
11+
12+
* Choose a position that aligns with the extension's intended functionality and user workflow.
13+
* Review the available position options for each extension type to ensure optimal integration.
14+
* Consider the impact of the position on the overall user experience within the PIM.
15+
16+
17+
## Available positions for UI extensions
18+
19+
20+
| Positions | Action | Iframe | Link |
21+
|------------------------------|--------|--------|-------|
22+
| pim.product.header | ✔️ || ✔️ |
23+
| pim.product-model.header | ✔️ || ✔️ |
24+
| pim.sub-product-model.header | ✔️ || ✔️ |
25+
| pim.product.tab || ✔️ ||
26+
| pim.product-model.tab || ✔️ ||
27+
| pim.sub-product-model.tab || ✔️ ||
28+
| pim.category.tab || ✔️ ||
29+
| pim.product-grid.action-bar | ✔️ | ✔️ ||
30+
| pim.activity.navigation.tab || ✔️ ||
31+
32+
33+
### Positions list
34+
35+
#### pim.product.header
36+
This position refers to the header of a simple product or a variant edit page.
37+
[![pim-product-header.png](../img/extensions/ui-extensions/positions/pim-product-header.png)](../img/extensions/ui-extensions/positions/pim-product-header.png)
38+
39+
#### pim.product-model.header
40+
This position refers to the header of a root model edit page.
41+
[![pim-product-model-header.png](../img/extensions/ui-extensions/positions/pim-product-model-header.png)](../img/extensions/ui-extensions/positions/pim-product-model-header.png)
42+
43+
#### pim.sub-product-model.header
44+
This position refers to the header of a sub product model edit page.
45+
[![pim-sub-product-model-header.png](../img/extensions/ui-extensions/positions/pim-sub-product-model-header.png)](../img/extensions/ui-extensions/positions/pim-sub-product-model-header.png)
46+
47+
#### pim.product.tab
48+
This position refers to the tab of a simple product or a variant edit page.
49+
[![pim-product-tab.png](../img/extensions/ui-extensions/positions/pim-product-tab.png)](../img/extensions/ui-extensions/positions/pim-product-tab.png)
50+
51+
#### pim.product-model.tab
52+
This position refers to the tab of a root model edit page.
53+
[![pim-product-model-tab.png](../img/extensions/ui-extensions/positions/pim-product-model-tab.png)](../img/extensions/ui-extensions/positions/pim-product-model-tab.png)
54+
55+
#### pim.sub-product-model.tab
56+
This position refers to the tab of a sub product model edit page.
57+
[![pim-product-model-tab.png](../img/extensions/ui-extensions/positions/pim-product-model-tab.png)](../img/extensions/ui-extensions/positions/pim-product-model-tab.png)
58+
59+
#### pim.category.tab
60+
This position refers to the tab of a category edit page.
61+
[![pim-category-tab.png](../img/extensions/ui-extensions/positions/pim-category-tab.png)](../img/extensions/ui-extensions/positions/pim-category-tab.png)
62+
63+
#### pim.product-grid.action-bar
64+
This position refers to the action bar of the product grid. It is used to add actions that can be applied to multiple products at once.
65+
66+
::: warning
67+
For the moment, you can't use UI extensions with more than **500** selected products & product models.
68+
:::
69+
[![pim-product-grid-action-bar.png](../img/extensions/ui-extensions/positions/pim-product-grid-action-bar.png)](../img/extensions/ui-extensions/positions/pim-product-grid-action-bar.png)
70+
71+
#### pim.activity.navigation.tab
72+
This position refers to the tab of the activity navigation. It is used to add custom tabs in the activity navigation of the PIM.
73+
[![pim-activity-navigation-tab.png](../img/extensions/ui-extensions/positions/pim-activity-navigation-tab.png)](../img/extensions/ui-extensions/positions/pim-activity-navigation-tab.png)
74+
75+
::: panel-link Filtering [Next](/extensions/filtering.html)
76+
:::
147 KB
Loading
215 KB
Loading
363 KB
Loading
366 KB
Loading
247 KB
Loading

0 commit comments

Comments
 (0)