Différences

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

--- local:shop:setup:products [2018/02/14 19:34] – 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 100: / Ligne 101: @@
-Exemple : Renouvellement de produit : nom du produit à renouveler : Augmenter la durée d’inscription à une formation.
+//Exemple : Renouvellement de produit : nom du produit à renouveler : Augmenter la durée d’inscription à une formation.//
-  *  **Activer le traitement d' achat :** Si un seul produit simple : Mise en place d’une session de formation.
+  *  **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.
-Si le produit est constitué de  plusieurs produits différents au même prix unitaire : Ajout de sièges non affectés.
+   *  **Handler parameters :** Ici on relie le produit au(x)cours Moodle concerné(s)
+===Generic handler: Enrol me to a course===
+Settings
+    'coursename=<%course shortname%>'
+the course shortname as defined by course creator. this is supposed to be unique and always present.
+//Exemple : coursename=courseshortname&customersupport=coursesupportshortname//
+    'role=<%role shortname%>'
+the role that will be assigned to customer in the course
+//Exemple  : coursename=courseshortname&supervisor=teacher2//
+    'duration=<%enrol duration in days%>'
+the real start/end dates of the enrol will be calculated from the time the handler is run.
+//Exemple  : coursename=courseshortname&duration=180//
+===Generic handler: Setup a course session===
+Settings
+    'coursename=<%course shortname%>'
+the course shortname as defined by course creator. this is supposed to be unique and always present.
+'supervisor=<%role shortname%>'
+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.
-   *  **Paramètres du gestionnaire :** Ici on relie le produit au(x)cours Moodle concerné(s)
+    'duration=<%duration in days%>'
-Exemple pour un seul produit : Nom abrégé du parcours concerné (shortname), et nom du cours support client concerné (shortname) :
+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.
-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 :
+===Generic handler: Course category creation (Pro version)===
-packsize=100&courselist= nom-abrégé-du-cours&customersupport= nom-abrégé-du-cours-support
+Settings
-courselist : nom abrégé du cours, si plusieurs les séparer par des virgules
+    'parentcategory=<%categoryid%>'
-//**Exemple :**// Pour un  produit constitué de  plusieurs produits différents (tjrs au même prix unitaire chaque), on sépare dans courselist les produits accessibles par des virgules :
+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.
-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
+===Generic handler: Assign a role in a context===
-//**Nota :**// remplacer courselist liste des items : possible par un pattern MySQL
+Settings
-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)
+    'contextlevel=<%contextlevelID%>' (10 = system, 40 = category, 50 = course, 70 = module, 80 = block)
+The context level.
-//**Exemple :**// &supervisor=teacher2 ou autre exemple &supervisor=coursecreator
+    'instance=<%instanceID%>'
+The ID of the instance attached to the context. Irrelevant for system context.
-   *  **La quantité adresse des sièges :** Choisir dans la liste déroulante :
+    'role=<%roleshortname%>'
-Non : Pour un seul produit - Oui : Pour plusieurs produits
+the shortname of the role to assign. A capability check will be performed on product owner to actually execute the product handler.
-Non : pour un lot car les sièges sont affectés plus tard
-Un siège par ordre d’achat : en cas de vente à la durée d’un produit par exemple.
-   *  **Renouvelable :** Cocher ou non la case
+   *  ** Quantity addresses user seats :** Choisir dans la liste déroulante : No, One seat per order, ye
-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).
-Ceci doit être géré par le gestionnaire d'achat lié au produit, et paramétré en interne par des paramètres du gestionnaire.
+   *  **can renew :** Check if a product is renewable
-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.
+//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.//
-   *  **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.
-{{ :local:shop:setup:5-automation.png?nolink&850 |}}
+{{ :local:shop:setup:5-automation.png?nolink |}}
 ----
 <html><!-- nomoodle --></html>
-[[local:shop:userguide:salesadmin|Back to Configuration and implementation of a commercial offer]] -[[:local:shop|L Local Shop component]] - [[:start|Back to catalogue]]
+[[local:shop:userguide:salesadmin|Back to Configuration and implementation of a commercial offer]] - [[:local:shop|Local Shop component (Core engine)]] - [[:start|Back to catalog]]
 <html><!-- /nomoodle --></html>