Hikashop: Difference between revisions

From Joomdle
Jump to navigationJump to search
← Older edit
No edit summary
No edit summary
 
(13 intermediate revisions by the same user not shown)
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===


* 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.


====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.
===Required plugins===


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


* 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 "customised" email to the Buyer confirming their purchase / provide instructions on gaining access.


====Hikashop Configuration====
===Optional plugins===
 
There are other Joomdle-Hikashop plugins you can use:
* Hikashop profile: lets you use Hikashop as an additional data source for profile information to sync to Moodle
** {{See_Field_Data_Mappings}}
* Hikashop Joomdle Plugin: this plugin reacts to Hikashop events (like address updated, etc), calling Joomdle user sync functions
* [[Hikashop Groups]]
* [[Hikashop Start date]]


''Ensure you have Hikashop installed and working properly before you begin.''
'''Important''': you should only enable one of Hikashop system plugins: Hikashop Orders, Hikashop Groups or Hikashop Start date.


======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.
===Hikashop Configuration===


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


====Joomdle Configuration====


======Moodle======
====Create a new Hikashop Product Category====


The package enrol_joomdle.zip contains a new enrolment method for Moodle.
Under the Hikashop Product Menu, create a new Hikashop Product Category to group your Moodle courses.


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).
===Joomdle Configuration===


Enter Moodle as an administrator.
=====Joomla=====


A new enrol method, called Joomdle, should appear in Courses/Enrolments. Enable it and set it as default.
To start using Joomdle's Hikashop integration, select it in Joomdle Configuration, Shop section, as shown in the image below.


[[Image:r023_moodle_enroll_1.jpg|800px]]
[[Image:shop_integration_hikashop.png]]


Click Edit to configure its options:


* Default cost: The default cost to enroll in courses
There is also another mandatory item to configure:
* Currency: Your preferred default currency for courses
* Courses category: Select the Hikashop Product Category for which you wish Moodle's courses to appear.
* 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======


To start using Joomdle's Hikashop integration, enable it in Joomdle Component Configuration, by selecting Hikashop in the Shop Integration option.
{{Shop_optional_configuration}}
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]]
=====Moodle=====


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.
{{Shop_Moodle_configuration}}


<span class="info">Moodle courses will automatically be created in Hikashop and Published.</span>


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


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


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


===Tips & Tricks===


If you are selling only courses, and not using "buy for children" features, you can configure Hikashop so that it does not ask for a quantity when buying products, as it does not make sense to buy more than one instance of each course.


<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>
To get this, you need to go to Hikashop configuration, Display, Product Options, and set Quantity input method to None.

Latest revision as of 08:38, 15 July 2019

Languages

[[::Hikashop|English]]

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 Orders


Optional plugins

There are other Joomdle-Hikashop plugins you can use:

  • Hikashop profile: lets you use Hikashop as an additional data source for profile information to sync to Moodle
    • Please check Field Data Mapping to get more info on how create mappings to sync profile fields.
  • Hikashop Joomdle Plugin: this plugin reacts to Hikashop events (like address updated, etc), calling Joomdle user sync functions
  • Hikashop Groups
  • Hikashop Start date

Important: you should only enable one of Hikashop system plugins: Hikashop Orders, Hikashop Groups or Hikashop Start date.


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.

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: Select the Hikashop Product Category 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


Tips & Tricks

If you are selling only courses, and not using "buy for children" features, you can configure Hikashop so that it does not ask for a quantity when buying products, as it does not make sense to buy more than one instance of each course.

To get this, you need to go to Hikashop configuration, Display, Product Options, and set Quantity input method to None.

Retrieved from "http://www.joomdle.com/w1k1/index.php?title=Hikashop&oldid=2196"