Différences

Ci-dessous, les différences entre deux révisions de la page.

--- local:shop:setup:products [2018/02/14 19:43] – florence
+++ local:shop:setup:products [2026/01/13 07:58] (Version actuelle) – modification externe 127.0.0.1
@@ Ligne 1: / Ligne 1: @@
+<html><!-- nomoodle --></html>{{ :logo-apl.png?nolink |}}<html><!-- /nomoodle --></html>
 =====Back Office : Configuration and implementation of a commercial offer=====
 =====Configurer des produits simples=====
@@ Ligne 105: / Ligne 106: @@
   *  **Enable product handler :** Si un seul produit simple : Mise en place d’une session de formation. Si le produit est constitué de  plusieurs produits différents au même prix unitaire : Ajout de sièges non affectés.
-   *  **Paramètres du gestionnaire :** Ici on relie le produit au(x)cours Moodle concerné(s)
+   *  **Handler parameters :** Ici on relie le produit au(x)cours Moodle concerné(s)
-//Exemple pour un seul produit : Nom abrégé du parcours concerné (shortname), et nom du cours support client concerné (shortname) : coursename=nom-abrégé-du-cours&customersupport= nom-abrégé-du-cours-support//
-//Exemple pour un produit vendu par 10 dont les sièges sont assignés aux apprenants après la vente du produit de formation : packsize=100&courselist= nom-abrégé-du-cours&customersupport= nom-abrégé-du-cours-support//
+===Generic handler: Enrol me to a course===
-    * **courselist :** Nom abrégé du cours, si plusieurs les séparer par des virgules.
+Settings
-//Exemple  pour un  produit constitué de  plusieurs produits différents : (tjrs au même prix unitaire chacun), on sépare dans courselist les produits accessibles par des virgules : packsize=10&courselist=nom-abrégé-du-cours1,nom-abrégé-du-cours2,nom-abrégé-du-cours3&customersupport=nom-abrégé-du-cours-support//
+    'coursename=<%course shortname%>'
-//Nota :// remplacer courselist liste des items : possible par un pattern MySQL
+the course shortname as defined by course creator. this is supposed to be unique and always present.
-//select a% tous les produits qui commence par a
-Exemple  : courselist=a%//
-   *  **Paramètres supplémentaires :** Affectation d’un rôle qui n’est pas celui par défaut dans le parcours : teacher (enseignant)
+//Exemple : coursename=courseshortname&customersupport=coursesupportshortname//
-//Exemple : &supervisor=teacher2 ou autre exemple &supervisor=coursecreator//
+    'role=<%role shortname%>'
+the role that will be assigned to customer in the course
-   *  **La quantité adresse des sièges :** Choisir dans la liste déroulante :
+//Exemple  : coursename=courseshortname&supervisor=teacher2//
- Non : Pour un seul produit
- Oui : Pour plusieurs produits
+    'duration=<%enrol duration in days%>'
- Non : pour un lot car les sièges sont affectés plus tard
+the real start/end dates of the enrol will be calculated from the time the handler is run.
- Un siège par ordre d’achat : en cas de vente à la durée d’un produit par exemple.
+//Exemple  : coursename=courseshortname&duration=180//
-   *  **Renouvelable :** Cocher ou non la case
+===Generic handler: Setup a course session===
-//Lorsqu'un produit est marqué comme renouvelable, cela suppose qu'une durée de vie du produit a pu être définie, comptée à partir de la date d'achat (en général).
+Settings
-Ceci doit être géré par le gestionnaire d'achat lié au produit, et paramétré en interne par des paramètres du gestionnaire.
+    'coursename=<%course shortname%>'
-Tous les gestionnaires standard ne supportent pas nécessairement la notion de durée. Lorsque cette option est utilisée, les interfaces clientes activeront les notifications du cycle de vie du produit, et permettront de renouveler l'achat du même produit pour en étendre la durée. Le client devra alors fournir son code produit disponible dans son interface de support client.//
+the course shortname as defined by course creator. this is supposed to be unique and always present.
-   *  **Conditions de vente et d’utilisation :** Si  spécifique au produit sinon ce sont les conditions générales définie dans les réglages du plugin qui s'appliquent.
+'supervisor=<%role shortname%>'
-{{ :local:shop:setup:5-automation.png?nolink&850 |}}
+This allows designating the exact role that will be assigned for supervisors.
+    'duration=<%enrol duration in days%>'
+the real start/end dates of the enrol will be calculated from the time the handler is run.
+===Generic handler: Course creation (Pro version)===
+Settings
+    'template=<%course template shortname%>'
+The shortname of an existing course considered as template for course. The shortname is unique and is always present in Moodle. Check there is a prepared backup of the course in the ocurse backup area.
+ 'coursecategory=<%course category id%>'
+This will tune where the new course will be created. Note that the product owner MUST have course creation capability in the designated category for the operation to succeed.
+    'duration=<%duration in days%>'
+Duration is calculated from the purchase date and affects the teacher account enrol and is stored in the product metadata stub to calculate product obsolescence and trigger end of life action.
+===Generic handler: Course category creation (Pro version)===
+Settings
+    'parentcategory=<%categoryid%>'
+The parent category to which the created category will be attached to. The product owner needs to be manager of the category or have the relevant permissions.
+===Generic handler: Assign a role in a context===
+Settings
+    'contextlevel=<%contextlevelID%>' (10 = system, 40 = category, 50 = course, 70 = module, 80 = block)
+The context level.
+    'instance=<%instanceID%>'
+The ID of the instance attached to the context. Irrelevant for system context.
+    'role=<%roleshortname%>'
+the shortname of the role to assign. A capability check will be performed on product owner to actually execute the product handler.
+   *  ** Quantity addresses user seats :** Choisir dans la liste déroulante : No, One seat per order, ye
+   *  **can renew :** Check if a product is renewable
+//When a product is set as renewable, it may be defined with a product duration from the purchase date. This should be handled by the product purchase handler and setup through an internal handler parameter. All handlers do not support duration. When enabled, the customer account interfaces will support product end of period notification, and purchasing agin the product with a reference code will extend the period on the same product instance.//
+{{ :local:shop:setup:5-automation.png?nolink |}}
 ----