set of tools facilitating development, exporting and payment management in oTree
Project description
========================================================================
Set of tools facilitating the development of oTree projects
========================================================================
Installation:
***************
1. **Either**:
- type ``pip install otree_tools -U`` in your terminal window.
(`-U` or `--upgrade` key guarantees that if you already have `otree_tools` installed, it will update it to the most
recent version).
2. **or**:
- clone exisiting project ``git clone https://github.com/otree-tools/otree_tools`` and copy the
``otree_tools`` folder into your project folder, next to the apps of your module.
3. After that add "otree_tools" to your EXTENSION_APPS section of ``settings.py`` file like this::
EXTENSION_APPS = ['otree_tools']
If your settings contain other otree extensions, listed in EXTENSION_APSS, just add `otree_tools` into the same list.
The extensions work independently from each other and they will not be in a conflict.
4. If you would like to track time or focused/unfocused time a user spends on a specific page, you need to include
to a standard oTree template a reference to `otree_tools` and then include trackers::
{% load otree otree_tools %}
{% block content %}
{% tracking_focus %}
{% tracking_time %}
{% endblock%}
`tracking_focus` and `tracking_time` tags can be included into any block, not necessarily to `content`
Version History
***************
0.0.4: An `AdvancedSliderWidget` is added to `widgets`
0.0.5: An `AdvancedSliderWidget` is updated to work with float numbers
0.0.6: An `AdvancedSliderWidget` has a new option 'suffix' which is added to each label
0.0.7: `ListField` is added as a possible field to render multiple choice selector
0.0.8: Temporarily removing static jquery-ui files
0.0.9: ListField gets options to set initial/default values
0.0.10: ListField gets an option `max_choices`
0.0.11: New tag `{% tracking_time %}` is added that allows to measure precisely time spent per page
0.0.12: `ListField` renamed to `MultipleChoiceModelField`. `ListField` becomes a general field to store lists
0.0.13: `{% tracking_focus}` tag - to track when/if user switches to another tab while staying on the page
0.0.14: Fixing issue with `{% tracking_focus}` tag - initial visibility event is registered now
0.0.15: Minor fixes with trackers
0.1.0: Export of participant.vars is added
0.1.1: Hosting of Anton Shurashov radiogrid widget (https://github.com/Sinkler/django-radiogrid)
0.2.1: Incorporating parts of otree_custom_export: json export, and data export for specific sessions; export of focus and
enter/exit trackers as CSV
0.2.2: fixin issue with restframework
0.2.3: fixin issue with time_tracking tag
0.3.0: OtherField and MultipliChoice Field supports FOO_choices from oTree; admin menu; pagination of all lists
streaming export of time and focus trackers; issue with time tracker events is solved
0.3.1: Upgrading boto
0.3.2: Solving issue with Multiple Choice Field
0.3.3: in `utils` two extra functions are added: `get_focused_time()` and `get_unfocused_time()`
0.3.4: minor error correction in `get_focused_time` function
0.3.6: `confirm_button` tag for showing modal with confirmation before proceeding further
0.3.8: Fixing `get_XXX_time` functions
0.3.9: Converting `get_time_per_page` function making it return `.total_seconds()`, not a timedelta object
0.3.10: fixing error message in multipleselectfield
0.3.11: adding `min_choices` to multipleselectfield
0.3.12: minor fix of multipleselectfield - dynamic choices
0.3.13: adding `num_focus_events`, `num_visibility_events` functions into `utils`
0.3.14: removing botocore ref
Set of tools facilitating the development of oTree projects
========================================================================
Installation:
***************
1. **Either**:
- type ``pip install otree_tools -U`` in your terminal window.
(`-U` or `--upgrade` key guarantees that if you already have `otree_tools` installed, it will update it to the most
recent version).
2. **or**:
- clone exisiting project ``git clone https://github.com/otree-tools/otree_tools`` and copy the
``otree_tools`` folder into your project folder, next to the apps of your module.
3. After that add "otree_tools" to your EXTENSION_APPS section of ``settings.py`` file like this::
EXTENSION_APPS = ['otree_tools']
If your settings contain other otree extensions, listed in EXTENSION_APSS, just add `otree_tools` into the same list.
The extensions work independently from each other and they will not be in a conflict.
4. If you would like to track time or focused/unfocused time a user spends on a specific page, you need to include
to a standard oTree template a reference to `otree_tools` and then include trackers::
{% load otree otree_tools %}
{% block content %}
{% tracking_focus %}
{% tracking_time %}
{% endblock%}
`tracking_focus` and `tracking_time` tags can be included into any block, not necessarily to `content`
Version History
***************
0.0.4: An `AdvancedSliderWidget` is added to `widgets`
0.0.5: An `AdvancedSliderWidget` is updated to work with float numbers
0.0.6: An `AdvancedSliderWidget` has a new option 'suffix' which is added to each label
0.0.7: `ListField` is added as a possible field to render multiple choice selector
0.0.8: Temporarily removing static jquery-ui files
0.0.9: ListField gets options to set initial/default values
0.0.10: ListField gets an option `max_choices`
0.0.11: New tag `{% tracking_time %}` is added that allows to measure precisely time spent per page
0.0.12: `ListField` renamed to `MultipleChoiceModelField`. `ListField` becomes a general field to store lists
0.0.13: `{% tracking_focus}` tag - to track when/if user switches to another tab while staying on the page
0.0.14: Fixing issue with `{% tracking_focus}` tag - initial visibility event is registered now
0.0.15: Minor fixes with trackers
0.1.0: Export of participant.vars is added
0.1.1: Hosting of Anton Shurashov radiogrid widget (https://github.com/Sinkler/django-radiogrid)
0.2.1: Incorporating parts of otree_custom_export: json export, and data export for specific sessions; export of focus and
enter/exit trackers as CSV
0.2.2: fixin issue with restframework
0.2.3: fixin issue with time_tracking tag
0.3.0: OtherField and MultipliChoice Field supports FOO_choices from oTree; admin menu; pagination of all lists
streaming export of time and focus trackers; issue with time tracker events is solved
0.3.1: Upgrading boto
0.3.2: Solving issue with Multiple Choice Field
0.3.3: in `utils` two extra functions are added: `get_focused_time()` and `get_unfocused_time()`
0.3.4: minor error correction in `get_focused_time` function
0.3.6: `confirm_button` tag for showing modal with confirmation before proceeding further
0.3.8: Fixing `get_XXX_time` functions
0.3.9: Converting `get_time_per_page` function making it return `.total_seconds()`, not a timedelta object
0.3.10: fixing error message in multipleselectfield
0.3.11: adding `min_choices` to multipleselectfield
0.3.12: minor fix of multipleselectfield - dynamic choices
0.3.13: adding `num_focus_events`, `num_visibility_events` functions into `utils`
0.3.14: removing botocore ref
Project details
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
otree_tools-0.3.14.tar.gz
(63.4 kB
view hashes)