Settings

Help-tokens reads these Django settings to create URLs:

• HELP_TOKENS_INI_FILE: Path to a .ini file containing help token definitions. The format of the ini file is described below.

• HELP_TOKENS_BOOKS: a dictionary mapping book slugs to URLs. For example:

  HELP_TOKENS_BOOKS = {
      'learner': 'https://docs.openedx.org/en/latest/learners',
      'course_author': 'https://docs.openedx.org/en/latest/educators',
  }

• HELP_TOKENS_VERSION: a string used as part of the final URL, to choose the correct version of the book. For example, “latest”.

• HELP_TOKENS_LANGUAGE_CODE: the language code to use as part of the book URL, mapped through the [locales] section of the ini file.

INI file format

The .ini file pointed to by HELP_TOKENS_INI_FILE contains the definitions of the help tokens themselves.

The [pages] section defines the help tokens. Each help token definition consists of a book slug (defined in HELP_TOKENS_BOOKS), a colon, and a URL path. The default token is used for missing tokens. For example:

[pages]
default = learner:index.html
instructor = learner:SFD_instructor_dash_help.html
course = learner:index.html

cohortmanual = course_author:course_features/cohorts/cohort_config.html#assign-learners-to-cohorts-manually
cohortautomatic = course_author:course_features/cohorts/cohorts_overview.html#all-automated-assignment

The [locales] section defines language codes, used with HELP_TOKENS_LANGUAGE_CODE to determine the language portion of the URL:

[locales]
default = en
en = en
en_us = en

Context processor

The context processor is “help_tokens.context_processor”. It adds a function get_online_help_info. Call it with a help token, and it will return a dict with a doc_url entry, the help URL. You can use it like this in a template:

<a href="${get_online_help_info('visibility')['doc_url']}">...</a>

This interface is a bit verbose, but is to maintain backward compatibility with a previous implementation of this context processor.

Redirection view

The help_tokens.urls URLs define a view that redirects to a help URL. You can include it in your app:

# For redirecting to help pages.
url(r'^help_token/', include('help_tokens.urls')),

Then visiting help_token/foobar will redirect to the URL defined by the “foobar” help token.

[4.0.0] - 2026-03-26

• Dropped support for Python 3.11.

[3.2.0] - 2025-04-21

• Added support for Python 3.12

[3.1.0] - 2025-04-09

• Dropped support for Python 3.8 and 3.9

• Added support fort Django 5.2

[3.0.0] - 2025-03-14

• Dropped support for edx.readthedocs.io URLs in favor of docs.openedx.org URLs.

  See https://github.com/openedx/edx-documentation/issues/2319

[2.4.0] - 2024-03-29

• Added support for Python 3.11

• Dropped support for Django 3.2, Django 4.0 and Django 4.1

[2.3.0] - 2023-08-02

• Added support for Django 4.2

[2.2.0] - 2022-01-20

• Dropped support for django2.2, 3.0, 3.1 and 3.2

• Added Django40 support in CI

[2.1.0] - 2020-07-07

• Added support for django3.0, 3.1 and 3.2

[2.0.0] - 2020-01-19

• Removed support of python3.5

[1.1.0] - 2020-05-05

• Removed support of Django < 2.2 version

• Added support for python 3.8

[1.0.3] - 2017-07-17

• Updated tests to support Django 1.11

• Updated dependency versions

[1.0.2] - 2017-05-16

• Fixed the README.

[1.0.1] - 2017-05-15

• First version on PyPI.

[1.0.0] - 2017-05-03

• First release.