add filtering section

Author: clovis-akeneo

content/extensions/filtering.md

@@ -0,0 +1,17 @@
+# Filtering UI extensions
+
+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.
+
+### Filter UI extension by user groups
+
+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.
+
+[![ui-extension-permissions.png](../img/extensions/ui-extensions/ui-extension-permissions.png)](../img/extensions/ui-extensions/ui-extension-permissions.png)
+
+### Filter UI extension by product selection
+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.
+
+[![ui-extension-product-selection.png](../img/extensions/ui-extensions/ui-extension-product-selection.png)](../img/extensions/ui-extensions/ui-extension-product-selection.png)
+
+::: panel-link FAQ [Next](/extensions/faq.html)
+:::

content/extensions/positions.md

@@ -35,53 +35,44 @@ Extension position determines where your extension appears within the Akeneo PIM
 ### Positions list
 
 #### pim.product.header
-[![pim-product-header.png](../img/extensions/ui-extensions/positions/pim-product-header.png)](../img/extensions/ui-extensions/positions/pim-product-header.png)
-
 This position refers to the header of a simple product or a variant edit page.
+[![pim-product-header.png](../img/extensions/ui-extensions/positions/pim-product-header.png)](../img/extensions/ui-extensions/positions/pim-product-header.png)
 
 #### pim.product-model.header
-[![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)
-
 This position refers to the header of a root model edit page.
+[![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)
 
 #### pim.sub-product-model.header
-[![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)
-
 This position refers to the header of a sub product model edit page.
+[![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)
 
 #### pim.product.tab
-[![pim-product-tab.png](../img/extensions/ui-extensions/positions/pim-product-tab.png)](../img/extensions/ui-extensions/positions/pim-product-tab.png)
-
 This position refers to the tab of a simple product or a variant edit page.
+[![pim-product-tab.png](../img/extensions/ui-extensions/positions/pim-product-tab.png)](../img/extensions/ui-extensions/positions/pim-product-tab.png)
 
 #### pim.product-model.tab
-[![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)
-
 This position refers to the tab of a root model edit page.
-
-#### pim.sub-product-model.tab
 [![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)
 
+#### pim.sub-product-model.tab
 This position refers to the tab of a sub product model edit page.
+[![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)
 
 #### pim.category.tab
-[![pim-category-tab.png](../img/extensions/ui-extensions/positions/pim-category-tab.png)](../img/extensions/ui-extensions/positions/pim-category-tab.png)
-
 This position refers to the tab of a category edit page.
+[![pim-category-tab.png](../img/extensions/ui-extensions/positions/pim-category-tab.png)](../img/extensions/ui-extensions/positions/pim-category-tab.png)
 
 #### pim.product-grid.action-bar
-[![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)
-
 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.
 
 ::: warning
 For the moment, you can't use UI extensions with more than **500** selected products & product models.
 :::
+[![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)
 
 #### pim.activity.navigation.tab
-[![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)
-
 This position refers to the tab of the activity navigation. It is used to add custom tabs in the activity navigation of the PIM.
+[![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)
 
-::: panel-link FAQ [Next](/extensions/faq.html)
+::: panel-link Filtering [Next](/extensions/filtering.html)
 :::

content/img/extensions/ui-extensions/ui-extension-permissions.png

@@ -761,7 +761,8 @@ gulp.task('build-extensions', ['clean-dist','less'], function () {
       var pages = {
           'overview.md': "Overview",
           'ui-extensions.md': "UI Extensions",
-          'position.md': "Positions",
+          'positions.md': "Positions",
+          'filtering.md': "Filtering",
           'faq.md': "FAQ",
       };