Merge branch 'master' into feature/http-api

# Conflicts:
#	content/getting-started/satellite/_index.en.md

Author: clemzarch

.github/workflows/gh-pages.yml

@@ -4,14 +4,15 @@ on:
   push:
     branches:
       - master
+  pull_request:
 
 jobs:
   deploy:
     runs-on: ubuntu-20.04
     concurrency:
       group: ${{ github.workflow }}-${{ github.ref }}
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v3
         with:
           submodules: true
           fetch-depth: 0

config.toml

@@ -5,7 +5,7 @@ theme = "middleware"
 # site title
 title = "Gyroscops"
 # disable language
-disableLanguages = []
+disableLanguages = ['fr']
 # google analytics
 googleAnalytics = "" # paste your analytics ID here. (Ex: UA-123-45)
 publishDir = "docs"
@@ -17,36 +17,59 @@ hasChildren = true
 
   [[menu.main]]
   parent = "Getting Started"
-  name = "Setup"
-  url = "getting-started/setup"
+  name = "Environment Setup"
+  url = "getting-started/environment-setup"
   weight = 1
 
   [[menu.main]]
   parent = "Getting Started"
-  name = "Creating Satellites"
-  url = "getting-started/satellite"
+  name = "Installation"
+  url = "getting-started/installation"
   weight = 2
 
   [[menu.main]]
   parent = "Getting Started"
-  name = "Pipelines"
-  url = "getting-started/pipeline"
+  name = "Writing Configuration"
+  url = "getting-started/writing-configuration"
   weight = 3
 
   [[menu.main]]
   parent = "Getting Started"
-  name = "Workflows"
-  url = "getting-started/workflow"
+  name = "Compilation"
+  url = "getting-started/compilation"
   weight = 4
 
-#   [[menu.main]]
-#   parent = "Getting Started"
-#   name = "Hooks and APIs"
-#   url = "installation/manual"
-#   weight = 5
+  [[menu.main]]
+  parent = "Getting Started"
+  name = "Execution"
+  url = "getting-started/execution"
+  weight = 5
 
 [[menu.main]]
+name = "Core concepts"
 weight = 2
+hasChildren = true
+
+  [[menu.main]]
+  parent = "Core concepts"
+  name = "Satellite"
+  url = "core-concept/satellite"
+  weight = 1
+
+  [[menu.main]]
+  parent = "Core concepts"
+  name = "Pipeline"
+  url = "core-concept/pipeline"
+  weight = 2
+
+  [[menu.main]]
+  parent = "Core concepts"
+  name = "Workflow"
+  url = "core-concept/workflow"
+  weight = 3
+
+[[menu.main]]
+weight = 3
 name = "Features"
 hasChildren = true
 
@@ -81,7 +104,7 @@ hasChildren = true
   weight = 5
 
 [[menu.main]]
-weight = 4
+weight = 3
 name = "Connectivity"
 hasChildren = true
 
@@ -123,8 +146,8 @@ hasChildren = true
 
   [[menu.main]]
   parent = "Connectivity"
-  name = "NL-JSON"
-  url = "connectivity/nl-json"
+  name = "JSON"
+  url = "connectivity/json"
   weight = 7
 
   [[menu.main]]
@@ -145,6 +168,18 @@ hasChildren = true
    url = "connectivity/sylius"
    weight = 10
 
+  [[menu.main]]
+   parent = "Connectivity"
+   name = "Prestashop"
+   url = "connectivity/prestashop"
+   weight = 11
+
+  [[menu.main]]
+   parent = "Connectivity"
+   name = "Filtering, drop or reject"
+   url = "connectivity/filtering"
+   weight = 12
+
 [params]
 logo = "logo-web.svg"
 logo_white = "logo-web.svg"
@@ -156,7 +191,8 @@ body_color = "#ddd"
 text_color = "#666"
 text_color_dark = "#333"
 text_color_light = "#eee"
-white_color = "#eee"
+white_color = "#fff"
+light_color = "#eee"
 font_family = "lato"
 
 ################################ English Language ######################
@@ -165,7 +201,7 @@ languageName = "English"
 languageCode = "en-us"
 weight = 1
 home = "Home"
-copyright = "The Gyroscops Documents are copyright © [Kiboko](https://kiboko.fr/) 2020, 2021."
+copyright = "The Gyroscops Documentation is copyright © [Gyroscops](https://gyroscops.com/) 2020-2023."
 
 # banner
 [Languages.en.params.banner]
@@ -183,7 +219,7 @@ content = "You can reach our sales team we will find together the best way to pr
 [Languages.en.params.cta.button]
 enable = true
 label = "contact us"
-link = "contact"
+link = "mailto:sales@gyroscops.com"
 
 # Heading in the home page
 [Languages.en.params.heading]
@@ -204,7 +240,7 @@ languageName = "Français"
 languageCode = "fr-fr"
 weight = 2
 home = "Accueil"
-copyright = "La documentation Gyroscops est copyright © [Kiboko](https://kiboko.fr/) 2020, 2021."
+copyright = "La documentation Gyroscops est copyright © [Gyroscops](https://gyroscops.com/) 2020-2023."
 
 # banner
 [Languages.fr.params.banner]
@@ -222,7 +258,7 @@ content = "Vous pouvez contacter nos équipes commerciales pour trouver le meill
 [Languages.fr.params.cta.button]
 enable = true
 label = "contactez-nous"
-link = "contact"
+link = "mailto:sales@gyroscops.com"
 
 # Heading in the home page
 [Languages.fr.params.heading]

content/connectivity/akeneo/_index.en.md

@@ -8,22 +8,15 @@ description: "Connect your Akeneo PIM through pipelines"
 weight: 1
 ---
 
-- [Goal](#goal)
-- [The Akeneo plugin for ETL Pipeline](#the-akeneo-plugin-for-etl-pipeline)
-- [The Akeneo expression functions](#the-akeneo-expression-functions)
----
-
-### Goal
-
-The packages listed below aims at the integration of [Akeneo PIM](https://www.akeneo.com) into the [ETL Pipeline](../../components/pipeline) 
-and [Satellite](../../components/satellite) stacks.
+The packages listed below aims at the integration of [Akeneo PIM](https://www.akeneo.com) into the [ETL Pipeline](../../core-concept/pipeline) 
+and [Satellite](../../core-concept/satellite) stacks.
 
 The tools built for Akeneo is composed of ETL capacities and data processing functions to be used in
-[Fast Map](../../components/fast-map).
+[Fast Map](../fast-map).
 
 ### The Akeneo plugin for ETL Pipeline
 
-This plugin will enable Akeneo connectivity to the [ETL Pipeline](../../components/pipeline), in order to
+This plugin will enable Akeneo connectivity to the [ETL Pipeline](../../core-concept/pipeline), in order to
 read and write from and to Akeneo PIM. This integration is compatible with both
 [Akeneo Enterprise Edition client](https://github.com/akeneo/api-php-client-ee)
 and the [Akeneo Community Edition client](https://github.com/akeneo/api-php-client).

content/connectivity/akeneo/expression-language.en.md

@@ -3,29 +3,34 @@ title: "Akeneo expression language functions"
 date: 2021-01-24T09:23:54+01:00
 draft: false
 description: "Functions for manipulating Akeneo API data"
+weight: 2
 ---
 
 {{< feature-state for_mw_version="0.1" state="alpha" >}}
 
 - [What is it ?](#what-is-it-)
 - [Installation](#installation)
-- [Usage](#usage)
-- [Functions reference](#functions-reference)
-    - [Attribute data manipulation](#attribute-data-manipulation)
-        - [Filter by locale](#filter-by-locale)
-        - [Filter by scope](#filter-by-scope)
-        - [Take the first available value by scopes](#take-the-first-available-value-by-scopes)
-        - [Combining results filter](#combining-results-filter)
-        - [Excluding results filter](#excluding-results-filter)
-        - [Extracting a slice of the values list](#extracting-a-slice-of-the-values-list)
-        - [Extracting the beginning of the values list](#extracting-the-beginning-of-the-values-list)
-        - [Extracting the end of the values list](#extracting-the-end-of-the-values-list)
-        - [Extracting the values list, after an offset](#extracting-the-values-list-after-an-offset)
-        - [Extracting the first value from the list](#extracting-the-first-value-from-the-list)
-        - [Extracting the last value from the list](#extracting-the-last-value-from-the-list)
-    - [Dates management with dateTime and dateTimeZone](#dates-management-with-datetime-and-datetimezone)
-    - [Manage metrics with metricAmount, metricUnit and formatMetric](#manage-metrics-with-metricamount-metricunit-and-formatmetric)
-    
+- [Filter Provider](#filter-provider)
+  - [Usage](#usage)
+  - [Functions reference](#functions-reference)
+      - [Attribute data manipulation](#attribute-data-manipulation)
+          - [Filter by locale](#filter-by-locale)
+          - [Filter by scope](#filter-by-scope)
+          - [Take the first available value by scopes](#take-the-first-available-value-by-scopes)
+          - [Combining results filter](#combining-results-filter)
+          - [Excluding results filter](#excluding-results-filter)
+          - [Extracting a slice of the values list](#extracting-a-slice-of-the-values-list)
+          - [Extracting the beginning of the values list](#extracting-the-beginning-of-the-values-list)
+          - [Extracting the end of the values list](#extracting-the-end-of-the-values-list)
+          - [Extracting the values list, after an offset](#extracting-the-values-list-after-an-offset)
+          - [Extracting the first value from the list](#extracting-the-first-value-from-the-list)
+          - [Extracting the last value from the list](#extracting-the-last-value-from-the-list)
+      - [Dates management with dateTime and dateTimeZone](#dates-management-with-datetime-and-datetimezone)
+      - [Manage metrics with metricAmount, metricUnit and formatMetric](#manage-metrics-with-metricamount-metricunit-and-formatmetric)
+- [Builder Provider](#builder-provider)
+  - [Usage](#builder-provider)
+  - [Functions reference](#builder-provider)
+      
 ## What is it ?
 
 This library implements functions for manipulating Akeneo API data through the
@@ -37,7 +42,9 @@ This library implements functions for manipulating Akeneo API data through the
 composer require php-etl/akeneo-expression-language
 ```
 
-## Usage
+## Filter Provider
+
+### Usage
 
 To use Akeneo's expression language functions, you must first add the `expression_language` key and put in 
 the provider `Kiboko\Component\ExpressionLanguage\Akeneo\AkeneoFilterProvider`.
@@ -97,9 +104,9 @@ $interpreter->evaluate($expression, ['input' => $input]);
 
 {{< /tabs >}}
 
-## Functions reference
+### Functions reference
 
-### Attribute data manipulation
+#### Attribute data manipulation
 
 Akeneo has a specific data format that would make cumbersome the data mapping
 if there were no dedicated tools. In this matter the Expression Language functions
@@ -714,3 +721,40 @@ This function will extract the unit part of a metric attribute's value
 `formatMetric(array $attribut, string $locale)` 
 
 This function will format the metric according to the specified locale
+
+## Builder Provider
+
+The Akeneo API expects you to have certain types of format for your attributes. 
+The functions provided by the AkeneoBuilderProvider allow you to create the expected formats easily.
+
+### Usage
+
+To use the Akeneo's Builder expression language, you must first add the `expression_language` key and put in 
+the provider `Kiboko\Component\ExpressionLanguage\Akeneo\AkeneoBuilderProvider`.
+
+Then, in the fields that can use expression languages, you can use any [functions](#builder-functions-reference) provided by 
+the Akeneo Builder provider.
+
+{{< tabs name="basic_definition" >}}
+
+{{< tab name="YAML" codelang="yaml"  >}}
+- fastmap:
+    expression_language:
+    - 'Kiboko\Component\ExpressionLanguage\Akeneo\AkeneoBuilderProvider'
+    map:
+    - field: '[title]'
+      expression: 'withValue(input["title"])'
+{{< /tab >}}
+
+{{< /tabs >}}
+
+### Functions reference
+
+|Name|Description|Example|
+|---|---|---|
+|build(`string` ...values)|Enables several values to be grouped together in a single ordered array corresponding to the format that the API expects.|build(input["values"])|
+|withValue(`string` value, `string` locale, `string` scope)|Creates the expected format for attributes of type single-line text, multi-line text, boolean, date, number, measurement.|withValue(input["variant_name"], "fr_FR", "ecommerce")|
+|withSimpleOption(`string` code, `string` attribute, `string` labels, `string` locale = 'null', `string` scope = 'null')|Creates the expected format for single-option attributes.|build(withSimpleOption("PHY","kind", {"fr_FR": "PHY"}))|
+|withMultipleOption(`string` codes, `string` attribute, `string` labels, `string` locale, `string` scope)|Creates the expected format for multiple-option attributes.|withMultipleOption(input["collection"], "collection", {"fr_FR": "My collection"}, "fr_FR", "ecommerce")|
+|withReferenceEntityValue(`string` value, `string` locale = 'null', `string` channel = 'null')|Creates the expected format for reference entity record attributes of type single-line text, multi-line text, boolean, date, number, measurement.|withReferenceEntityValue(input["label"], "fr_FR")|
+|withReferenceEntitySimpleOption(`string` value, `string` locale = 'null', `string` channel = 'null')|Creates the expected format for simple-select reference entity record attributes.|withReferenceEntitySimpleOption(input["associated_crops_code"], "fr_FR")|

content/connectivity/akeneo/plugin.en.md

@@ -3,6 +3,7 @@ title: "Akeneo plugin"
 date: 2021-01-24T09:23:54+01:00
 draft: false
 description: "Akeneo API integration in satellites pipelines"
+weight: 1
 ---
 
 {{< feature-state for_mw_version="0.1" state="alpha" >}}
@@ -114,7 +115,7 @@ The options available are the same as for the [loader](#building-a-loader).
 
 The `merge` option allows you to add data to your dataset, in a sense merging your actual dataset with your new data.
 
-The `map` option comes from the [FastMap](../../../connectivity/fast-map) plugin, you may need to read its documentation
+The `map` option comes from the [FastMap](../fast-map) plugin, you may need to read its documentation
 to understand how to use it properly.
 
 ```yaml
@@ -239,7 +240,7 @@ You may need to read the [filtering documentation of Akeneo API](https://api.ake
 The plugin takes into account the [ExpressionLanguage](https://symfony.com/doc/current/components/expression_language.html)
 component provided by Symfony.
 
-We have also provided [custom expression](../../akeneo/expression-language) to use when mapping your data.
+We have also provided [custom expression](expression-language) to use when mapping your data.
 
 ```yaml
 akeneo: