easyrec recommendations module for django-oscar
Project description
This package provides integration with the recommendation system, easyrec. It is designed to integrate seamlessly with the e-commerce framework django-oscar.
Continuous integration status:
Getting started
Installation
From PyPI:
pip install django-oscar-easyrec
or from Github:
pip install git+git://github.com/tangentlabs/django-oscar-easyrec.git#egg=django-oscar-easyrec
Add 'easyrec' to INSTALLED_APPS.
You will also need to install
Instructions for installing Easyrec can be found on easyrec’s sourceforge wiki
Configuration
Edit your settings.py to set the following settings:
EASYREC_ENDPOINT = 'http://127.0.0.1:8080/easyrec-web/' EASYREC_TENANT_ID = '...' EASYREC_API_KEY = '...'
In easyrec all items have an ‘itemtype’. django-oscar-easyrec passes the product class name for this value. If the item type is not registered in easyrec it will send the default value of ‘ITEM’.
So each of your product classes needs to manually added as an itemtype via easyrec’s dashboard if you want them to be recorded separately.
Note - if you add itemtypes to easyrec you will need to restart your django project to ensure they are picked up correctly.
And that’s it! All purchases, product views and reviews will automatically be pushed to easyrec.
You can also disable this app by setting EASYREC_HOST to ‘DUMMY’. Useful for testing.
Getting Recommendations
django-oscar-easyrec comes with a templatetag allowing you to easily fetch recommendations and display them in your templates. There are currently 5 supported template tags which do pretty much what they say:
{% load recommendations %}
{% user_recommendations request.user as recommendations %}
{% for recommended_product in recommendations %}
<!-- Do your thing! -->
{% endfor %}
{% users_also_bought a_product request.user as recommendations %}
{% for recommended_product in recommendations %}
<!-- Do your thing! -->
{% endfor %}
{% users_also_viewed a_product request.user as recommendations %}
{% for recommended_product in recommendations %}
<!-- Do your thing! -->
{% endfor %}
{% products_rated_good product as recommendations %}
{% for recommended_product in recommendations %}
<!-- Do your thing! -->
{% endfor %}
{% related_products product as recommendations %}
{% for recommended_product in recommendations %}
<!-- Do your thing! -->
{% endfor %}
Each template tag provides a list of recommended products. If no recommendations are found then an empty QuerySet is returned. Each of these tags also supports a number of other optional parameters.
You can also call the recommendation functions directly:
from easyrec.utils import get_gateway easyrec = get_gateway() recommendations = easyrec.get_user_recommendations(user.user_id) recommendations = easyrec.get_other_users_also_bought(product.upc, user_id) recommendations = easyrec.get_other_users_also_viewed(product.upc, user_id)
user_recommendations
Returns a list of recommended items for a user
parameters:
- user
The user to get recommendations for
- max_results
[optional] The maximum recommendation you wish to receive
- requested_item_type
[optional] The ProductClass of the items you want in the response
- action_type
[optional] The action type you want to get results based on. Valid values are: VIEW, RATE, BUY or any other custom action type you created. Default: VIEW
users_also_bought
Returns a list of recommended items based on users who bought this also bought X
parameters:
- product
The produce you want to find recommendation based on
- user
The request user
- max_results
[optional] The maximum recommendation you wish to receive
- requested_item_type
[optional] The ProductClass of the items you want in the response
users_also_viewed
Returns a list of recommended items based on users who viewed this also viewed X
parameters:
- product
The produce you want to find recommendation based on
- user
The request user
- max_results
[optional] The maximum recommendation you wish to receive
- requested_item_type
[optional] The ProductClass of the items you want in the response
products_rated_good
Returns a list of recommended items based on users who rated this as good also rated X as good.
parameters:
- product
The produce you want to find recommendation based on
- user
The request user
- max_results
[optional] The maximum recommendation you wish to receive
- requested_item_type
[optional] The ProductClass of the items you want in the response
Getting Rankings
Also provided are a collection of template tags for getting community rankings of products. Thing like most bought or best rated products:
{% load rankings %}
{% most_viewed as products %}
{% for product in products %}
<!-- Do your thing! -->
{% endfor %}
{% most_bought as products %}
{% for product in products %}
<!-- Do your thing! -->
{% endfor %}
{% most_rated as products %}
{% for product in products %}
<!-- Do your thing! -->
{% endfor %}
{% best_rated as products %}
{% for product in products %}
<!-- Do your thing! -->
{% endfor %}
{% worst_rated as products %}
{% for product in products %}
<!-- Do your thing! -->
{% endfor %}
Parameters
All the community rankings share the same options parameters:
- time_range
[optional] The range over which you want the ranking. Options include: day, week, month, all
- max_results
[optional] The maximum number of products you want
- requested_item_type
[optional] A filter on the type of products you want returned
Contributing
Clone the repo, create a virtualenv and run:
make install
You can run the tests with:
./run_tests.py
There is a sample Oscar project that uses this package in the ‘sandbox’ folder. You can set it up using:
make sandbox
Vagrant
To make testing and development easier I have created a vagrant box with easyrec already installed and configured. If you have vagrant installed, you can simply perform the following:
vagrant up
The box itself is hosted on Dropbox and so the initial download and install will take a long time. So kick back and get yourself a tasty hot beverage…
Once the box is up you can access easyrec using:
http://127.0.0.1:9090/easyrec-web
The username and password to log in are both easyrec. The box also runs MySQL (root:root) and Tomcat-admin (tomcat:tomcat)
The Sandbox
The sandbox provided with django-oscar-easyrec allows you provides some examples on how you can integrate easyrec with your own sites. To get the sandbox up and running use from the projects root directory:
make sandbox
This will install django-oscar-easyrec in development modes, installed the development requirements.txt and build the initial database. You can then run the sandbox using:
cd sandbox ./manage.py runserver
You will need to create your own super user with:
cd sandbox ./manage createsuperuser
The easyrec rules builder is scheduled to run daily (2 am by default). So once you have performed some actions (browse, buy etc.) you need to manually run the rules builders to get any recommendations. To do this in easyrec you will need to log in:
http://127/0/0/1:9090/easyrec-web
Then click on ‘administration’. In the row representing your tenant, in the ‘Management’ section click on the icon that looks like a puzzle piece with an arrow on it. Wait a few secs and your done.
Examples of using the recommendations template tags can be found in:
sandbox/templates/promotions/home.html
sandbox/templates/catalogue/detail.html
An example of the rankings template tags can be found in:
sandbox/templates/promotions/home.html
TODO
Dashboard stats
Optional Celery delayed inserts
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for django-oscar-easyrec-0.0.6.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 145291739294e5516939f104249b9c054383b58a60674de7fad40f8fdc8239ae |
|
| MD5 | 186322de066bc00458681a43bcaa63b2 |
|
| BLAKE2b-256 | ab6ec0c5c2a4110ae19a01351a99e19535d70bd1fc1b53911fd2b527fa41eb6d |
