Modifier le fichier

Pretix

Configuration préalable pour une intégration de l'extension Inscription.

Configuration de l'application

Configuration système de l'aplication Pretix. Certaines opérations peuvent être réalisées dans l'interface, mais il est plus facile de positionner les paramétrages par fichier.

Configuration de l'application dans le fichier pretix.cfg utilisé.

Le paramétrage ci-dessous est à adapter en fonction de l'instance associée (base de données,...) Il faut au préalable créer un schéma de base pretix. Par défaut, l'utilisation de la même base de données relationnelle MySQL / MariaDB est préconisée.

Seule la langue fr est activée dans la configuration ci-dessous, cela évite de le réaliser dans le cadre de l'initialisation de l'organisateur.

[pretix]
instance_name=Inscription
url=https://inscription.universite.fr
currency=EUR
datadir=/var/pretix/data
password_reset=off
csp_additional_header=frame-ancestors https://*.universite.fr; style-src 'self' https://*.universite.fr
trust_x_forwarded_for=on
trust_x_forwarded_proto=on
[locale]
default=fr
timezone=Europe/Paris
[languages]
enabled=fr
; Très intéressant : on peut positionner des traductions dans un répertoire spécifique (pour du custom, sans obligation de référencer un fork)
; Ex : /path/to/my/translations/pt_BR/LC_MESSAGES/django.po
;path=/path/to/my/translations
[database]
; For MySQL, replace with "mysql"
backend=mysql
name=pretix
user=pretix
; For MySQL, enter the user password. For PostgreSQL on the same host,
; we don't need one because we can use peer authentification if our
; PostgreSQL user matches our unix user.
password=pretixdatabasepassword
; For MySQL, use local socket, e.g. /var/run/mysqld/mysqld.sock
; For a remote host, supply an IP address
; For local postgres authentication, you can leave it empty
host=127.0.0.1
[mail]
; See config file documentation for more options
from=inscription@univ-nantes.fr
host=mailhog.univ-nantes.prive
port=1025
[redis]
location=redis://127.0.0.1/0
sessions=true
[celery]
backend=redis://127.0.0.1/1
broker=redis://127.0.0.1/2

L'ensemble des paramètres et les différentes façons de les charger sont disponibles sur la documentation

Après démarrage de Pretix, on veillera à changer le mot de passe par défaut de l'instance (admin@localhost / admin), dans les paramètres du compte.

Dans l'écran de configuration du compte, choisir le fuseau horaire "Europe/Paris" par défaut.

Mise en conformité avec la licence AGPLv3

Cette étape est obligatoire si l'application Pretix utilisée est modifiée pour des besoins spécifiques. S'il s'agit de la version standard, cette validation est seulement recommandée.

Conformité avec une instance de Pretix non modifiée

Sélectionner les éléments suivants

  • I only use pretix to organize events which are executed by my own company or its affiliated companies, or to sell products sold by my own company.
  • This installation of pretix is running without any custom modifications or extensions (except for installed plugins).
  • I want to use pretix under the terms of the AGPLv3 license without restriction on the scope of usage and therefore without making use of any additional permission.
  • This installation of pretix has installed plugins which are available freely under a non-copyleft license (Apache License, MIT License, BSD license, …).
  • This installation of pretix has installed plugins which are available freely under a license with strong copyleft (GPL, AGPL, …).

Conformité pour une instance de Pretix dont le code a été modifié

Sélectionner les éléments suivants

  • I only use pretix to organize events which are executed by my own company or its affiliated companies, or to sell products sold by my own company.
  • This installation of pretix includes changes or extensions made to the source code.
  • I want to use pretix under the terms of the AGPLv3 license without restriction on the scope of usage and therefore without making use of any additional permission.
  • This installation of pretix has installed plugins which are available freely under a non-copyleft license (Apache License, MIT License, BSD license, …).
  • This installation of pretix has installed plugins which are available freely under a license with strong copyleft (GPL, AGPL, …).

Footer : Kosmos Education

Link : https://www.kosmos-education.com

Source code instructions

pretix (AGPLv3 with additional terms): https://github.com/pretix/pretix
Kosmos Education https://git.kosmos.fr/projects/KFO/repos/pretix

Configuration de l'organisateur

Par défaut, aucun organisateur n'est créé dans l'application Pretix. Il faut en créer un et générer un token pour utiliser l'extension.

Précisions sur l'organisateur

  • L'application inscription n'utilise qu'un seul organisateur pour gérer l'ensemble des évènements. La gestion des droits est entièrement portée par l'extension Inscription.
  • L'organisateur initialisé apparaît dans l'URL d'un évènement (URL de gestion de la commande). Il est donc important de configurer l'organisateur (et surtout le slug associé) en tenant compte des URL générées.

Création de l'organisateur

  • Aller dans l'écran Organisateurs > Créer un nouvel organisateur
  • Choisir un nom d'organisateur, par exemple, le nom de l'université (Exemple : Universite de Nantes)
  • Choisir une forme courte, qui permette d'éviter de faire doublon avec le nom de domaine (Exemple : events).
  • Sauvegarder

Configurer le token de gestion des évènements

  • Aller dans l'écran Equipes > Administrateurs (une équipe existe déjà par défaut, on peut la réutiliser)
  • Dans la partie Token API, saisir le nom du token (Exemple : K-Sup), et cliquer sur ajouter.

Reporter la configuration du token dans le fichier d'environnement env_inscription.properties

Par exemple :

api.pretix.server.base-url=https://inscription.universite.fr
api.pretix.token=5adaz2defsdqs4ddfzer4
api.pretix.organizer=events

Une fois cette configuration réalisée, il est possible de démarrer l'application utilisant cette extension, et de procéder à la gestion des évènements.

Notes

L'extension inscription n'est pas compatible avec les métadonnées obligatoires sur les évènements. Il faudra donc veiller à ne pas configurer de métadonnées de ce type dans la configuration de l'application Pretix.