[](https://github.com/mutantsan/ckanext-tour/actions)
# ckanext-tour
ckanext-tour is a CKAN extension that provides a guided tour feature for CKAN instances. It allows users to create interactive tours to showcase different features and functionalities of a CKAN instance.
## Features
- Create interactive tours with step-by-step instructions
- Highlight specific elements on CKAN pages
- Customize tour appearance and behavior
- Easily manage and edit tours through the CKAN admin interface
Once the extension is installed and enabled, you can start creating tours through the CKAN admin interface. Tours can be associated with specific pages or sections of your CKAN portal, and you can define multiple steps for each tour.
To start a tour, users can click on a tour trigger button or it can be started automatically, when user visits the specified page. The tour will guide them through the specified steps, highlighting the relevant elements on each page.
Each step contains next information:
- Title: A brief, engaging headline that summarizes the step.
- Query: Query to specify which element we're highlighting
- Intro: Text, that will be displayed on a step card
- Position: Specifies the placement of step card (top, right, bottom, left).
- Image: Visuals to complement the text, illustrate points, or add visual interest. GIF animation could be used here.
### Create Tour
To create a tour for ckanext-tour via the admin panel UI, follow these steps:
- Log in to your CKAN instance as a sysadmin.
- Navigate to the `Configuration` section in the admin panel toolbar.
- Find and click the `Add tour` link under the `Tour` section to open the tour creation form.
- Fill in the required information for the tour.
- You can add 1 or more steps for each tour.
- Once you have added all the information, press `Create tour` button to submit the form and save the tour.
- Now you can go to the `List of tours` page and see all the tours that were created.
## Requirements
Compatibility with core CKAN versions:
| CKAN version | Compatible? |
| --------------- | ------------- |
| 2.9 | not tested |
| 2.10+ | yes |
## Installation
To install ckanext-tour:
1. Activate your CKAN virtual environment, for example:
. /usr/lib/ckan/default/bin/activate
2. Clone the source and install it on the virtualenv
git clone https://github.com/mutantsan/ckanext-tour.git
cd ckanext-tour
pip install -e .
pip install -r requirements.txt
3. Add `tour` to the `ckan.plugins` setting in your CKAN
config file (by default the config file is located at
`/etc/ckan/default/ckan.ini`).
4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:
sudo service apache2 reload
## Config settings
To modify the configuration of the extension, please make the changes through the site's user interface.
## Developer installation
To install `ckanext-tour` for development, activate your CKAN virtualenv and
do:
git clone https://github.com/mutantsan/ckanext-tour.git
cd ckanext-tour
python setup.py develop
pip install -r dev-requirements.txt
## Tests
To run the tests, do:
pytest --ckan-ini=test.ini
## License
[AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html)
Raw data
{
"_id": null,
"home_page": "https://github.com/mutantsan/ckanext-tour",
"name": "ckanext-tour",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "CKAN",
"author": "Oleksandr Cherniavskyi",
"author_email": "mutantsan@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/f1/62/e662a03cb8fcbb989cda4b0749920399970fbb3ee00c0a3d727fc9a12d09/ckanext_tour-0.1.0.tar.gz",
"platform": null,
"description": "[](https://github.com/mutantsan/ckanext-tour/actions)\n\n# ckanext-tour\n\nckanext-tour is a CKAN extension that provides a guided tour feature for CKAN instances. It allows users to create interactive tours to showcase different features and functionalities of a CKAN instance.\n\n## Features\n- Create interactive tours with step-by-step instructions\n- Highlight specific elements on CKAN pages\n- Customize tour appearance and behavior\n- Easily manage and edit tours through the CKAN admin interface\n\nOnce the extension is installed and enabled, you can start creating tours through the CKAN admin interface. Tours can be associated with specific pages or sections of your CKAN portal, and you can define multiple steps for each tour.\n\nTo start a tour, users can click on a tour trigger button or it can be started automatically, when user visits the specified page. The tour will guide them through the specified steps, highlighting the relevant elements on each page.\n\nEach step contains next information:\n\n- Title: A brief, engaging headline that summarizes the step.\n- Query: Query to specify which element we're highlighting\n- Intro: Text, that will be displayed on a step card\n- Position: Specifies the placement of step card (top, right, bottom, left).\n- Image: Visuals to complement the text, illustrate points, or add visual interest. GIF animation could be used here.\n\n### Create Tour\n\nTo create a tour for ckanext-tour via the admin panel UI, follow these steps:\n\n- Log in to your CKAN instance as a sysadmin.\n- Navigate to the `Configuration` section in the admin panel toolbar.\n- Find and click the `Add tour` link under the `Tour` section to open the tour creation form.\n- Fill in the required information for the tour.\n - You can add 1 or more steps for each tour.\n- Once you have added all the information, press `Create tour` button to submit the form and save the tour.\n- Now you can go to the `List of tours` page and see all the tours that were created.\n\n\n## Requirements\n\nCompatibility with core CKAN versions:\n\n| CKAN version | Compatible? |\n| --------------- | ------------- |\n| 2.9 | not tested |\n| 2.10+ | yes |\n\n\n## Installation\n\nTo install ckanext-tour:\n\n1. Activate your CKAN virtual environment, for example:\n\n . /usr/lib/ckan/default/bin/activate\n\n2. Clone the source and install it on the virtualenv\n\n git clone https://github.com/mutantsan/ckanext-tour.git\n cd ckanext-tour\n pip install -e .\n\tpip install -r requirements.txt\n\n3. Add `tour` to the `ckan.plugins` setting in your CKAN\n config file (by default the config file is located at\n `/etc/ckan/default/ckan.ini`).\n\n4. Restart CKAN. For example if you've deployed CKAN with Apache on Ubuntu:\n\n sudo service apache2 reload\n\n\n## Config settings\n\nTo modify the configuration of the extension, please make the changes through the site's user interface.\n\n## Developer installation\n\nTo install `ckanext-tour` for development, activate your CKAN virtualenv and\ndo:\n\n git clone https://github.com/mutantsan/ckanext-tour.git\n cd ckanext-tour\n python setup.py develop\n pip install -r dev-requirements.txt\n\n\n## Tests\n\nTo run the tests, do:\n\n pytest --ckan-ini=test.ini\n\n\n## License\n\n[AGPL](https://www.gnu.org/licenses/agpl-3.0.en.html)\n",
"bugtrack_url": null,
"license": "AGPL",
"summary": "Create an interactive tour that will help users familiarize themselves with the important features of your portal",
"version": "0.1.0",
"project_urls": {
"Homepage": "https://github.com/mutantsan/ckanext-tour"
},
"split_keywords": [
"ckan"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b9e3bb98d93a912a48329867d02581ac2b981f1fc74f70fdf92bec4ae26f9564",
"md5": "2f90c456c07b458e8522aac8c62f4f74",
"sha256": "5cf665c8dbc7457ac6dd44ae4b0edd6d30c209442948099bc464bcde99b875cd"
},
"downloads": -1,
"filename": "ckanext_tour-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2f90c456c07b458e8522aac8c62f4f74",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 103288,
"upload_time": "2024-04-29T11:11:09",
"upload_time_iso_8601": "2024-04-29T11:11:09.070926Z",
"url": "https://files.pythonhosted.org/packages/b9/e3/bb98d93a912a48329867d02581ac2b981f1fc74f70fdf92bec4ae26f9564/ckanext_tour-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "f162e662a03cb8fcbb989cda4b0749920399970fbb3ee00c0a3d727fc9a12d09",
"md5": "a0def384b12012687e8b4fd30f19a914",
"sha256": "0202cc383d607463fbf63fcf9b66eb056ecd0889106217f81b1f5834ed180d5e"
},
"downloads": -1,
"filename": "ckanext_tour-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "a0def384b12012687e8b4fd30f19a914",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 93191,
"upload_time": "2024-04-29T11:11:11",
"upload_time_iso_8601": "2024-04-29T11:11:11.349582Z",
"url": "https://files.pythonhosted.org/packages/f1/62/e662a03cb8fcbb989cda4b0749920399970fbb3ee00c0a3d727fc9a12d09/ckanext_tour-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-29 11:11:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mutantsan",
"github_project": "ckanext-tour",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"lcname": "ckanext-tour"
}
JSON
