Hikashop: Difference between revisions

From Joomdle
Jump to navigationJump to search
No edit summary
Line 1: Line 1:
{{Languages}}
{{Languages}}
====Integrating Joomdle with Hikashop 1.5.4 or higher====


<span class="alert">This "feature" is provided as is and no warranties, guarantees or otherwise, expressed or implied, are provided. Joomdle and individuals associated with its development and support shall not be held responsible for any loss of data, reputation, and/or money in any currency whatsoever. It is strongly advised that this "feature" be installed, configured, tested and proven working in a test environment prior to being implemented in a production site.</span>
===Features===
 
 
====Limitations====
 
* Disabling or hiding a course in Moodle does not automatically unpublish the Hikashop product in Joomla. You should unpublish the course first in Joomla, then disable / hide the course in Moodle.
 
====Features====


* Allows webmasters to publish Moodle courses inside a Hikashop storefront
* Allows webmasters to publish Moodle courses inside a Hikashop storefront
* Allows Buyers to purchase a Moodle course like any other product offered through Hikashop
* Allows Buyers to purchase a Moodle course like any other product offered through Hikashop
* Automatically enrolls the Buyer in the selected course(s).
* Automatically enrolls the Buyer in the selected course(s).
* Sends a "customised" email to the Buyer confirming their purchase / provide instructions on gaining access.
* Sends a configurable email to the Buyer confirming their purchase / provide instructions on gaining access.
 
====Hikashop Configuration====
 
''Ensure you have Hikashop installed and working properly before you begin.''
 
======Create a new Hikashop Product Category======


Under the Hikashop Menu, create a new Category to group your Moodle courses. Take note of the Category's ID, as you will it later to enter into Joomdle Component configuration.


===Required plugins===


====Joomdle Configuration====
In order to user Joomdle-Hikashop integration you will need to install and enable these plugins:
* Hikashop Selling Courses
* Hikashop 2 Orders


======Moodle======


The package enrol_joomdle.zip contains a new enrolment method for Moodle.
===Hikashop Configuration===


To install, unzip enrol_joomdle.zip into a temp folder and copy the files to the moodle/enrol folder on your web server (you should have a new folder called moodle/enrol/joomdle now).
''Ensure you have Hikashop installed and working properly wirh normal products before you begin.''


Enter Moodle as an administrator.


A new enrol method, called Joomdle, should appear in Courses/Enrolments. Enable it and set it as default.
====Create a new Hikashop Product Category====


[[Image:r023_moodle_enroll_1.jpg|800px]]
Under the Hikashop Product Menu, create a new Hikashop Product Category to group your Moodle courses. Take note of Product Category's ID, as you will it later to enter into Joomdle configuration.


Click Edit to configure its options:


* Default cost: The default cost to enroll in courses
===Joomdle Configuration===
* Currency: Your preferred default currency for courses
* Enrol message: A message to show to the user if he tries to access the course without having paid.  You can include the string BUY_COURSE_URL to show a link the the product page in Tienda.


======Joomla======
=====Joomla=====


To start using Joomdle's Hikashop integration, enable it in Joomdle Component Configuration, by selecting Hikashop in the Shop Integration option.
To start using Joomdle's Hikashop integration, select it in Joomdle Configuration, Shop section, as shown in the image below.
You can also select Hikashop as the Additional Data Source, so billing info will be used to fill user details in Moodle.


[[Image:r023_vm_int_joomdle_config_1.jpg]]
[[Image:shop_integration_hikashop.png]]


Enter the Hikashop Product Category ID for which you wish Moodle's courses to appear. This means you will not need to manually create Hikashop products.


<span class="info">Moodle courses will automatically be created in Hikashop and Published.</span>
There is also another mandatory item to configure:
* Courses category: Enter the Hikashop Product Category ID for which you wish Moodle's courses to appear.


In addition, you can configure Joomdle to send out an email to the buyer once the payment has been completed successfully.


* Either enter the Subject and Body of the email you wish to send; or
{{Shop_optional_configuration}}
* Enter '''''COURSE_NAME''''' and '''''COURSE_URL''''' for Joomdle to "grab" the values from Moodle.


=====Moodle=====


You will also need to install the Joomdlehikashop plugin, present in other-joomla-packages folder, in joomdle package.
{{Shop_Moodle_configuration}}




===Selling courses===


<span class="alert">This "feature" is provided as is and no warranties, guarantees or otherwise, expressed or implied, are provided. Joomdle and individuals associated with its development and support shall not be held responsible for any loss of data, reputation, and/or money in any currency whatsoever. It is strongly advised that this "feature" be installed, configured, tested and proven working in a test environment connected to Paypal's Sandbox development environment prior to being implemented in a production site.</span>
{{Selling_courses}}

Revision as of 17:12, 15 April 2015

Features

  • Allows webmasters to publish Moodle courses inside a Hikashop storefront
  • Allows Buyers to purchase a Moodle course like any other product offered through Hikashop
  • Automatically enrolls the Buyer in the selected course(s).
  • Sends a configurable email to the Buyer confirming their purchase / provide instructions on gaining access.


Required plugins

In order to user Joomdle-Hikashop integration you will need to install and enable these plugins:

  • Hikashop Selling Courses
  • Hikashop 2 Orders


Hikashop Configuration

Ensure you have Hikashop installed and working properly wirh normal products before you begin.


Create a new Hikashop Product Category

Under the Hikashop Product Menu, create a new Hikashop Product Category to group your Moodle courses. Take note of Product Category's ID, as you will it later to enter into Joomdle configuration.


Joomdle Configuration

Joomla

To start using Joomdle's Hikashop integration, select it in Joomdle Configuration, Shop section, as shown in the image below.

File:Shop integration hikashop.png


There is also another mandatory item to configure:

  • Courses category: Enter the Hikashop Product Category ID for which you wish Moodle's courses to appear.


These are optional:

  • Buy courses for children: enable this option if you want to use this feature. You can get more info about it here
  • Send enrol emails: enable this option if you want Joomdle to send emails on course purchases
  • Subject of email and Body of email. Enter the Subject and Body of the email you wish to send. You can use COURSE_NAME and COURSE_URL for Joomdle to "grab" the values from Moodle.
  • Send bundle emails: enable this option if you want Joomdle to send emails on bundle purchases (one email will be sent for each course in bundle)
Moodle

The package enrol_joomdle.zip contains a new enrolment method for Moodle. This plugin is not required, and it is only useful for:

  • Setting a cost for course in Moodle
  • Showing a link to course in shop when user tries to enter course without enroling first


You can install it using Moodle's plugin installer at Site administration->Plugins->Install plugins.

After completing installation, go to Site administration->Plugins->Enrolments->Manage enrol plugins.

A new enrol method, called Joomdle, should appear in the list. Enable it so you can start using it.

Click Edit to configure its options:

  • Default cost: The default cost to enroll in courses
  • Currency: Your preferred default currency for courses
  • Enrol message: A message to show to the user if he tries to access the course without having paid. You can include the string BUY_COURSE_URL to show a link the the product page in shop.


Selling courses

Please follow this link to get information on how to sell courses with Joomdle: Selling courses with an e-commerce extension