Templates

This references the template files, their role and the variables available in their contexts. The intended audience for this reference is designers wishing to build their custom Canaille theme.

Base

Those templates are shared by all the pages rendered by Canaille.

Template files

TEMPLATE base.html

The main template inherited by almost every other templates.

Parameters:

• user (User) – The current user, if logged in.

• features (Features) – The features enabled and available in Canaille.

• locale (str) – The user locale.

• website_name (str) – The Canaille instance defined in NAME.

• logo_url (str) – The URL of the instance logo defined in LOGO.

• favicon_url (str) – The URL of the instance favicon defined in FAVICON.

• request_is_boosted (bool) – Whether the page is boosted by HTMX.

• menu (bool) – Whether to display the menu or not.

• debug (bool) – Whether the app has been launched in debug mode.

• no_secret_key (bool) – Whether a SECRET_KEY has been defined.

TEMPLATE error.html

The error page. Displayed for all kinds of errors (not found, internal server error etc.).

Parameters:

• error_code (int) – The code of the HTTP error (404, 500, etc.)

• description (str) – The error code description.

• icon (str) – An optional Font Awesome icon reference.

TEMPLATE macro/flask.html

Macros for Flask flash message rendering

TEMPLATE macro/form.html

Macros for form and form field rendering.

Connects WTForms, Fomantic-UI and HTMX.

TEMPLATE macro/table.html

Macros for rendering table paginated with HTMX.

Forms

class canaille.app.forms.TableForm(*args, **kwargs)

Bases: I18NFormMixin, FlaskForm

A form for table rendering of object collections.

page = <UnboundField(IntegerField, (), {'default': 1})>

query = <UnboundField(StringField, (), {'default': ''})>

validate_page(field)

Core

The core templates are displayed in the authentication and profile edition pages.

Template files

TEMPLATE core/about.html

The ‘About’ page.

The ‘About’ page.

This is an informational page, displaying the project links.

Parameters:

• version (str) – The current Canaille version.

TEMPLATE core/firstlogin.html

The first login page.

The first login page.

This page is displayed to users who do not have set a password yet.

TEMPLATE core/forgotten-password-code.html

The password reinitialization code page.

Password forgotten code page.

This page displays a form asking for the code sent to the email address of users who cannot remember their password.

TEMPLATE core/forgotten-password.html

The password reinitialization page.

Password forgotten page.

This page displays a form asking for the email address of users who cannot remember their password.

TEMPLATE core/group.html

The group edition page.

Group edition page.

Displays the group edition or creation form.

Parameters:

• edited_group (Group) – None in a creation context. In edition context this is the edited group.

• form (CreateGroupForm or EditGroupForm) – The group edition/creation form.

TEMPLATE core/groups.html

The group list page.

The group list page.

Parameters:

• table (TableForm) – A Group pagination form.

TEMPLATE core/invite.html

The invitation form page.

The invitation form page.

Displays the invitation form to users with the invitation permission.

Parameters:

• form (InvitationForm) – The invitation form.

TEMPLATE core/join.html

The invitation acceptation page.

This page is displayed to users who have clicked on invitation links sent by mail (or by other media). It displays a basic account creation form.

Parameters:

• form (JoinForm) – The account creation form.

TEMPLATE core/login.html

The login page.

The login page.

This page displays a form to get the user identifier.

Parameters:

• form (LoginForm) – The login form.

TEMPLATE core/profile_add.html

User account creation page.

This template displays an account creation form. It is used in the registration page, and in the manual account creation page available for users with user management permission.

Parameters:

• form (FlaskForm) – The user creation form. Dynamically built according to the user READ and WRITE permissions. The available fields are those appearing in READ and WRITE, those only appearing in READ are read-only.

TEMPLATE core/profile_edit.html

The user profile edition page.

The profile edition template.

Displays a user profile edition form.

Parameters:

• edited_user (User) – The user that the form will edit.

• profile_form (FlaskForm) – The user profile edition form. Dynamically built according to the user READ and WRITE permissions. The available fields are those appearing in READ and WRITE, those only appearing in READ are read-only.

• emails_form (EmailConfirmationForm) – An email edition form. Used when the has_email_confirmation feature is enabled.

TEMPLATE core/profile_settings.html

The user profile settings edition page.

The profile settings template.

Displays the user settings edition form.

Parameters:

• edited_user (User) – The user that the form will edit.

• form (FlaskForm) – The user profile edition form. Dynamically built according to the user READ and WRITE permissions. The available fields are those appearing in READ and WRITE, those only appearing in READ are read-only.

• self_deletion (bool) – Whether the editor is allowed to delete the account of the edited user.

TEMPLATE core/reset-password.html

The password reset page.

The password reset template.

Displays a password reset form.

Parameters:

• form (PasswordResetForm) – The password reset form.

• user (User) – The user associated with the URL.

• token (str) – The secret link token.

TEMPLATE core/setup-mfa.html

The multi-factor authentication initialization template.

Display a QR-code and the OTP secret.

Parameters:

• user (User) – The user initializing the OTP.

• secret (str) – The OTP secret.

• qr_image (A base64 encoded str) – A QR-code image representing the OTP secret.

TEMPLATE core/users.html

The users list.

Displays a paginated list of User.

Parameters:

• table_form (TableForm of User.) – The paginated list form.

TEMPLATE core/verify-mfa.html

The multi-factor authentication code verification template.

Displays a form that asks for the multi-factor authentication code.

Parameters:

• form (TwoFactorForm) – The code verification form.

• username (str) – The username of the user attempting to log-in.

• method (str (TOTP, HOTP, EMAIL_OTP, SMS_OTP)) – The authentication factor method.

Forms

class canaille.core.endpoints.forms.CreateGroupForm(*args, **kwargs)

Bases: Form

The group creation form.

class canaille.core.endpoints.forms.DeleteGroupMemberForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.EditGroupForm(*args, **kwargs)

Bases: Form

The group edition form.

class canaille.core.endpoints.forms.EmailConfirmationForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.FirstLoginForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.ForgottenPasswordCodeForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.ForgottenPasswordForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.InvitationForm(*args, **kwargs)

Bases: Form

The user invitation form.

class canaille.core.endpoints.forms.JoinForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.LoginForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.PasswordForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.PasswordResetForm(*args, **kwargs)

Bases: Form

class canaille.core.endpoints.forms.TwoFactorForm(*args, **kwargs)

Bases: Form

OIDC

The OIDC templates are displayed in the OIDC consent pages.

Template files

TEMPLATE oidc/authorization_list.html

The list of authorizations.

The list of authorizations.

Displays a paginated list of AuthorizationCode.

Parameters:

• table_form (TableForm of AuthorizationCode.) – The paginated list form.

TEMPLATE oidc/authorization_view.html

Authorization details template.

Displays details about an AuthorizationCode.

Parameters:

• authorization (AuthorizationCode.) – The detailed authorization.

TEMPLATE oidc/authorize.html

The consent request dialog.

Consent request template.

This templates is displayed to users accessing a new application that requests to access to personal information. It lists the personal information requested by the application, and offers the user to accept or decline.

Parameters:

• user (User) – The user whose consent is asked.

• grant (An Authlib Grant) – The OIDC grant.

TEMPLATE oidc/client_add.html

The client addition page.

The client addition template.

Displays a form to create a new Client.

Parameters:

• form (ClientAddForm.) – The client creation form.

TEMPLATE oidc/client_edit.html

The client addition page.

The client edition template.

Displays a form to edit a Client.

Parameters:

• form (ClientAddForm.) – The client creation form.

• client (Client) – The edited client.

TEMPLATE oidc/client_list.html

The list of OIDC clients.

Displays a paginated list of Client.

Parameters:

• table_form (TableForm of Client.) – The paginated list form.

TEMPLATE oidc/consent_list.html

The consented applications list.

The consented applications list.

Display a list of clients for which users have given or revoked their consent.

Parameters:

• scope_details (dict) – Description of the OIDC scopes.

• ignored_scopes (list) – The scopes to hide.

• nb_consents (int) – The number of consents.

• nb_trusted (int) – The number of trusted clients.

TEMPLATE oidc/logout.html

The OIDC logout template.

Used during OIDC RP-initiated logout, when an user confirmation is needed.

Parameters:

• form (LogoutForm.) – The logout form.

• client (Client) – The client requesting the logout.

TEMPLATE oidc/token_list.html

The list of tokens.

The list of tokens.

Displays a paginated list of Token.

Parameters:

• table_form (TableForm of Token.) – The paginated list form.

TEMPLATE oidc/token_view.html

The token view page.

The token view template.

Displays the details of a token Token.

Parameters:

• form (TokenRevokationForm.) – A token revokation form.

TEMPLATE oidc/trusted_list.html

The trusted applications list.

The trusted applications list.

Display a list of trusted clients for which it is implied that users don’t need to explicitly give their consent.

Parameters:

• scope_details (dict) – Description of the OIDC scopes.

• ignored_scopes (list) – The scopes to hide.

• trusted (list [ Client ]) – The list of implicitly consented clients.

• nb_consents (int) – The number of consents.

• nb_trusted (int) – The number of trusted clients.

Forms

class canaille.oidc.endpoints.forms.AuthorizeForm(*args, **kwargs)

Bases: Form

class canaille.oidc.endpoints.forms.ClientAddForm(*args, **kwargs)

Bases: Form

class canaille.oidc.endpoints.forms.LogoutForm(*args, **kwargs)

Bases: Form

class canaille.oidc.endpoints.forms.TokenRevokationForm(*args, **kwargs)

Bases: Form