Prestashop - Chamilo

Instructions to install

Prerequisites

PrestaShop 1.6.1.4 at least (make sure e-mail sending works)
Chamilo 1.10.x (with courses created) 

1. Install the PrestaShop - Chamilo module

   • Download the PrestaShop - Chamilo module
   • Make sure that the zip filename is prestashopchamilo.zip
   • Follow the standard steps to install a module in PrestaShop.
   • The module will appear in the "Others" tab.
   • Click on "Install".

2. Configure the module

   After installation, you'll see a form with the following params to fill:

   • Chamilo URL: Public URL of the Chamilo portal (with a slash at the end). Example http://stable.chamilo.com/
   • Chamilo Security key: Alphanumerical value. You'll find it in Chamilo's main/inc/conf/configuration.php file
   • Chamilo encrypted method: sha1 or md5. Get the value in Chamilo's main/inc/conf/configuration.php file
   • Your public IP : Public IP of the server on which PrestaShop is installed (it is part of the authentication key, so Chamilo requires it)

   After saving the params, you'll find the list of courses extracted from the Chamilo portal on the same page. This means the module has been configured correctly. Make sure your Chamilo has courses created.

   If you want to edit those values again go to the Module page, click on "Other" tab then -> "Chamilo" -> "Configure"

3. Set a product up for sale

   a. In PrestaShop, login as admin and go to "Catalog" -> "Product" -> "Add a new product". b. Complete the form and click the "Save" button. c. On the same form, click on "Features". Make sure these are the product parameters and not the system's. d. A list of params appears: Height, Width, ... and CHAMILO_CODE e. Add the Chamilo course code there. This way, the product will be linked to the corresponding Chamilo course.

4. Test

   Test as a customer user in PrestaShop and try to buy a product that you have configured with the CHAMILO_CODE setting. The Chamilo module will send e-mails when the order has been confirmed.

5. Accept the payment

   As admin, go to "Orders" and select the order you just created. Select "Accept payments" and click on the "Change" button. At this point, the module will send the order to Chamilo to create an user account and the corresponding subscription to the ordered course.

6. The End Congrats! You can now sell your Chamilo courses using Chamilo.

Important to know:

• Chamilo login

  The access login for Chamilo is taken from the user's e-mail in PrestaShop, adding the customer ID For example: for julio.montoya@beeznest.com, the generated login in Chamilo would be julio.montoya777, if your customer ID is 777 in PrestaShop.

• Chamilo password The password is an alphanumerical value autogenerated and sent by e-mail

• Don't remove the CHAMILO_CODE "parameter" in PrestaShop If you remove this setting from PrestaShop, the plugin will not be able to link the Chamilo courses with the PrestaShop products

• e-mail with Chamilo access credentials It is possible to update the e-mail sent to your customers, just edit the files in /modules/chamilo/mail/en for English, for example

• Purchase of multiple courses in the same order If a PrestaShop customer buys 5 courses in one order, the module will react well and only create 1 user account in Chamilo, and give him access to the 5 courses. As such, the system will only send one e-mail with the credentials

• Purchase of multiple courses in distinct orders (repeated sale) If a customer buys a course in PrestaShop then buys another course later as another order, the system will use the same Chamilo login as for the first order, so the credentials will not be sent a second time by e-mail, as we suppose the customer still has access from when he first ordered. Would the customer loose his password, he can always ask for a new password through the Chamilo's "I lost my password" feature, if enabled (which is the default)

=== SPANISH ===

Instrucciones para instalar el plugin PrestaShop-Chamilo

Requisitos

• PrestaShop 1.6.1.4 (Asegurarse que el envio de correo funcione).
• Chamilo 1.10.x (Portal con cursos creados).

1. Instalar el módulo PrestaShop - Chamilo

   • Siga los pasos standard para instalar un módulo en PS
   • Asegurarse que el archivo tenga el nombre prestashopchamilo.zip
   • Subir el archivo zip y hacer click en instalar.

2. Configurar el módulo

   Haga click en "Otros módulos" -> "Chamilo" -> "Configurar". Vera un formulario con los siguientes parámetros a rellenar:

   • Chamilo URL : URL pública del portal Chamilo (con un slash final)
   • Chamilo Security key : Valor alfa numérico. Se encuentra en el archivo main/inc/conf/configuration.php
   • Chamilo encrypted method : sha1 o md5, Revisar este valor en el archivo main/inc/conf/configuration.php de chamilo
   • Your public IP : Ip pública del servidor donde se encuentra instalado PrestaShop

   Luego de grabar los parámetros, encontrará en la misma página la lista de cursos extraidos desde el portal Chamilo. Esto quiere decir que el módulo ha sido bien configurado. Asegúrese de que Chamilo tenga cursos creados.

3. Configurar un producto

   a. En PS logearse como admin e ir a "Catálogo" -> "Añadir un nuevo producto". b. Complete el formulario y haga click en "Salvar y guardar". c. En el mismo formulario haga click en "Carácterísticas" Asegúrese que son las "Carácterísticas" del producto y NO del sistema. d. Aparecerá entonces una lista de carácteristicas: Alto, Ancho .. y CHAMILO_CODE e. Colocar el código del curso de Chamilo en este lugar. De esta manera se relaciona un producto de PrestaShop con un curso de Chamilo.

4. Prueba Haga un prueba con un usuario cliente en PrestaShop e intente comprar un producto que tenga configurada una característica CHAMILO_CODE. El Módulo Chamilo enviará los emails cuando el Pedido haya sido confirmado.

5. Aceptar el pago

   Como admin dirígase a "Pedidos" y seleccione el pedido recientemente creado. Seleccionar "Pago aceptamos" y haga click en el botón "cambiar". Es en este momento el módulo envía la orden a Chamilo para crear una cuenta de usuario y la subscripción del mismo al curso comprado.

6. Fin

   Felicitaciones ahora puede vender sus cursos de Chamilo usando PrestaShop

Importante de saber:

• Login de Chamilo

  El login de acceso a Chamilo es generado tomando el email del usuario en PrestaShop y agregando el customer id.
  Por ejemplo para: julio.montoya@beeznest.com el login de Chamilo será "julio.montoya666" siendo 666 el customer id en PS

• Password de Chamilo El password es un valor alfanumérico autogenerado y enviado por email.

• No eliminar la "Característica" CHAMILO_CODE en PS Si se elimina esta característica del sistema PS, el plugin no podrá relacionar los cursos de Chamilo con los productos en PS.

• Email con credenciales de acceso a Chamilo Es posible modificar el email enviado a sus clientes, simplemente edite los archivos en /modules/chamilo/mail/es para el castellano por ejemplo.

• Compra de múltiples cursos en un mismo "Pedido" Si un usuario cliente de PS compra por ejemplo 5 cursos de Chamilo en un Pedido, el módulo solo crea una cuenta de usuario en Chamilo y le asocia los 5 cursos. Por lo tanto el sistema envia 1 email con las credenciales.

• Compra de múltiples cursos en diferentes "Pedidos"
  Si un cliente compra en PS un curso y luego en otro pedido compra otro curso, entonces el sistema utiliza el mismo login de Chamilo creado por el primer Pedido, por lo que no se enviará las credenciales para el segundo pedido. Se supone que el usuario ya tiene acceso cuando compró el primer pedido.