Source code for pretalx.event.models.event

from datetime import datetime, time

import pytz
from dateutil.relativedelta import relativedelta
from django.conf import settings
from django.core.exceptions import ValidationError
from django.core.mail import get_connection
from django.core.mail.backends.base import BaseEmailBackend
from django.core.validators import RegexValidator
from django.db import models, transaction
from django.utils.functional import cached_property
from django.utils.timezone import make_aware, now
from django.utils.translation import ugettext_lazy as _
from i18nfield.fields import I18nCharField, I18nTextField

from pretalx.common.cache import ObjectRelatedCache
from pretalx.common.mixins import LogMixin
from pretalx.common.models.settings import hierarkey
from pretalx.common.phrases import phrases
from pretalx.common.urls import EventUrls, get_base_url
from pretalx.common.utils import daterange, path_with_hash

SLUG_CHARS = 'a-zA-Z0-9.-'

def validate_event_slug_blacklist(value):
    blacklist = [
    if value in blacklist:
        raise ValidationError(
            _('Invalid event slug – this slug is reserved: {value}.').format(
            params={'value': value},

def event_css_path(instance, filename):
    return f'{instance.slug}/css/{path_with_hash(filename)}'

def event_logo_path(instance, filename):
    return f'{instance.slug}/img/{path_with_hash(filename)}'

[docs]@hierarkey.add() class Event(LogMixin, models.Model): """The Event class has direct or indirect relations to all other models. Since most models depend on the Event model in some way, they should preferably be accessed via the reverse relation on the event model to prevent data leaks. :param is_public: Is this event public yet? Should only be set via the ``pretalx.orga.views.EventLive`` view after the warnings have been acknowledged. :param locale_array: Contains the event's active locales as a comma separated string. Please use the ``locales`` property to interact with this information. :param accept_template: Templates for emails sent when accepting a talk. :param reject_template: Templates for emails sent when rejecting a talk. :param ack_template: Templates for emails sent when acknowledging that a submission was sent in. :param update_template: Templates for emails sent when a talk scheduling was modified. :param question_template: Templates for emails sent when a speaker has not yet answered a question, and organisers send out reminders. :param primary_color: Main event color. Accepts hex values like ``#00ff00``. :param custom_css: Custom event CSS. Has to pass fairly restrictive whitelist for security considerations. :param logo: Replaces the event name in the public header. Will be displayed at up to full header height and up to full content width. :param header_image: Replaces the header pattern and/or background color. Center-aligned, so when the window shrinks, the center will continue to be displayed. :param plugins: A list of active plugins as a comma-separated string. Please use the ``plugin_list`` property for interaction. """ name = I18nCharField(max_length=200, verbose_name=_('Name')) slug = models.SlugField( max_length=50, db_index=True, unique=True, validators=[ RegexValidator( regex=f"^[{SLUG_CHARS}]+$", message=_( 'The slug may only contain letters, numbers, dots and dashes.' ), ), validate_event_slug_blacklist, ], verbose_name=_("Short form"), help_text=_('The slug may only contain letters, numbers, dots and dashes.'), ) organiser = models.ForeignKey( to='Organiser', null=True, # backwards compatibility, won't ever be empty related_name='events', on_delete=models.PROTECT, ) is_public = models.BooleanField(default=False, verbose_name=_('Event is public')) date_from = models.DateField(verbose_name=_('Event start date')) date_to = models.DateField(verbose_name=_('Event end date')) timezone = models.CharField( choices=[(tz, tz) for tz in pytz.common_timezones], max_length=30, default='UTC', help_text=_('All event dates will be localized and interpreted to be in this timezone.'), ) email = models.EmailField( verbose_name=_('Organiser email address'), help_text=_('Will be used as Reply-To in emails.'), ) primary_color = models.CharField( max_length=7, null=True, blank=True, validators=[ RegexValidator(r'#([0-9A-Fa-f]{3}){1,2}'), ], verbose_name=_('Main event colour'), help_text=_( 'Provide a hex value like #00ff00 if you want to style pretalx in your event\'s colour scheme.' ), ) custom_css = models.FileField( upload_to=event_css_path, null=True, blank=True, verbose_name=_('Custom Event CSS'), help_text=_( 'Upload a custom CSS file if changing the primary colour is not sufficient for you.' ), ) logo = models.FileField( upload_to=event_logo_path, null=True, blank=True, verbose_name=_('Logo'), help_text=_( 'If you provide a logo image, your event\'s name will not be shown in the event header. ' 'The logo will be displayed left-aligned, and be allowed to grow up to the width of the' 'event content, if it is larger than that.' ), ) header_image = models.FileField( upload_to=event_logo_path, null=True, blank=True, verbose_name=_('Header image'), help_text=_( 'If you provide a header image, it will be displayed instead of your event\'s color and/or header pattern ' 'at the top of all event pages. It will be center-aligned, so when the window shrinks, the center parts will ' 'continue to be displayed, and not stretched.' ), ) locale_array = models.TextField(default=settings.LANGUAGE_CODE) locale = models.CharField( max_length=32, default=settings.LANGUAGE_CODE, choices=settings.LANGUAGES, verbose_name=_('Default language'), ) accept_template = models.ForeignKey( to='mail.MailTemplate', on_delete=models.CASCADE, related_name='+', null=True, blank=True, ) ack_template = models.ForeignKey( to='mail.MailTemplate', on_delete=models.CASCADE, related_name='+', null=True, blank=True, ) reject_template = models.ForeignKey( to='mail.MailTemplate', on_delete=models.CASCADE, related_name='+', null=True, blank=True, ) update_template = models.ForeignKey( to='mail.MailTemplate', on_delete=models.CASCADE, related_name='+', null=True, blank=True, ) question_template = models.ForeignKey( to='mail.MailTemplate', on_delete=models.CASCADE, related_name='+', null=True, blank=True, ) landing_page_text = I18nTextField( verbose_name=_('Landing page text'), help_text=_( 'This text will be shown on the landing page, alongside with links to the CfP and schedule, if appropriate.' ) + ' ' + phrases.base.use_markdown, null=True, blank=True, ) plugins = models.TextField(null=True, blank=True, verbose_name=_('Plugins')) template_names = [ f'{t}_template' for t in ('accept', 'ack', 'reject', 'update', 'question') ] class urls(EventUrls): base = '/{self.slug}/' login = '{base}login/' logout = '{base}logout' auth = '{base}auth/' logo = '{self.logo.url}' reset = '{base}reset' submit = '{base}submit/' user = '{base}me/' user_delete = '{base}me/delete' user_submissions = '{user}submissions/' user_mails = '{user}mails/' schedule = '{base}schedule/' sneakpeek = '{base}sneak/' talks = '{base}talk/' speakers = '{base}speaker/' changelog = '{schedule}changelog/' feed = '{schedule}feed.xml' export = '{schedule}export/' frab_xml = '{export}schedule.xml' frab_json = '{export}schedule.json' frab_xcal = '{export}schedule.xcal' ical = '{export}schedule.ics' class orga_urls(EventUrls): create = '/orga/event/new' base = '/orga/event/{self.slug}/' live = '{base}live' delete = '{base}delete' cfp = '{base}cfp/' users = '{base}api/users' url_list = '{base}api/urls/' mail = '{base}mails/' compose_mails = '{mail}compose' mail_templates = '{mail}templates/' new_template = '{mail_templates}new' outbox = '{mail}outbox/' sent_mails = '{mail}sent' send_outbox = '{outbox}send' purge_outbox = '{outbox}purge' submissions = '{base}submissions/' submission_cards = '{base}submissions/cards/' stats = '{base}submissions/statistics/' submission_feed = '{base}submissions/feed/' new_submission = '{submissions}new' speakers = '{base}speakers/' settings = edit_settings = '{base}settings/' review_settings = '{settings}review/' mail_settings = edit_mail_settings = '{settings}mail' team_settings = '{settings}team/' new_team = '{settings}team/new' room_settings = '{schedule}rooms/' new_room = '{room_settings}new' schedule = '{base}schedule/' schedule_import = '{schedule}import/' schedule_export = '{schedule}export/' schedule_export_trigger = '{schedule_export}trigger' schedule_export_download = '{schedule_export}download' release_schedule = '{schedule}release' reset_schedule = '{schedule}reset' toggle_schedule = '{schedule}toggle' reviews = '{base}reviews/' schedule_api = '{base}schedule/api/' talks_api = '{schedule_api}talks/' plugins = '{settings}plugins' information = '{base}info/' new_information = '{base}info/new' class api_urls(EventUrls): base = '/api/events/{self.slug}/' submissions = '{base}submissions/' talks = '{base}talks/' schedules = '{base}schedules/' speakers = '{base}speakers/' reviews = '{base}reviews/' rooms = '{base}rooms/' class Meta: ordering = ('date_from',) def __str__(self) -> str: return str( @cached_property def locales(self) -> list: """Is a list of active event locales.""" return self.locale_array.split(",") @cached_property def is_multilingual(self) -> bool: """Is ``True`` if the event supports more than one locale.""" return len(self.locales) > 1 @cached_property def named_locales(self) -> list: """Is a list of tuples of locale codes and natural names for this event.""" enabled = set(self.locale_array.split(",")) return [a for a in settings.LANGUAGES_NATURAL_NAMES if a[0] in enabled] @cached_property def html_export_url(self) -> str: return get_base_url(self) + self.orga_urls.schedule_export_download @cached_property def cache(self): """ Returns an :py:class:`ObjectRelatedCache` object. This behaves equivalent to Django's built-in cache backends, but puts you into an isolated environment for this event, so you don't have to prefix your cache keys. """ return ObjectRelatedCache(self, field='slug') def save(self, *args, **kwargs): was_created = not bool( super().save(*args, **kwargs) if was_created: self.build_initial_data() @property def plugin_list(self) -> list: """Provides a list of active plugins as strings, and is also an attribute setter.""" if not self.plugins: return [] return self.plugins.split(',') @plugin_list.setter def plugin_list(self, modules: list) -> None: from pretalx.common.plugins import get_all_plugins plugins_active = self.plugin_list plugins_available = { p.module: p for p in get_all_plugins(self) if not'.') and getattr(p, 'visible', True) } enable = set(modules) & (set(plugins_available) - set(plugins_active)) for module in enable: if hasattr(plugins_available[module].app, 'installed'): getattr(plugins_available[module].app, 'installed')(self) self.plugins = ",".join(modules)
[docs] def enable_plugin(self, module: str) -> None: """Enables a named plugin. Caution, no validation is performed at this point. No exception is raised if the module is unknown. An already active module will not be added to the plugin list again. :param module: The module to be activated.""" plugins_active = self.plugin_list if module not in plugins_active: plugins_active.append(module) self.plugin_list = plugins_active
[docs] def disable_plugin(self, module: str) -> None: """Disbles a named plugin. Caution, no validation is performed at this point. No exception is raised if the module was not part of the active plugins. :param module: The module to be deactivated.""" plugins_active = self.plugin_list if module in plugins_active: plugins_active.remove(module) self.plugin_list = plugins_active
def _get_default_submission_type(self): from pretalx.submission.models import SubmissionType sub_type = SubmissionType.objects.filter(event=self).first() if not sub_type: sub_type = SubmissionType.objects.create(event=self, name='Talk') return sub_type @cached_property def fixed_templates(self) -> list: return [ self.accept_template, self.ack_template, self.reject_template, self.update_template, ] def build_initial_data(self): from pretalx.mail.default_templates import ( ACCEPT_TEXT, ACK_TEXT, GENERIC_SUBJECT, REJECT_TEXT, UPDATE_SUBJECT, UPDATE_TEXT, QUESTION_SUBJECT, QUESTION_TEXT, ) from pretalx.mail.models import MailTemplate if not hasattr(self, 'cfp'): from pretalx.submission.models import CfP CfP.objects.create( event=self, default_type=self._get_default_submission_type() ) if not self.schedules.filter(version__isnull=True).exists(): from pretalx.schedule.models import Schedule Schedule.objects.create(event=self) self.accept_template = self.accept_template or MailTemplate.objects.create( event=self, subject=GENERIC_SUBJECT, text=ACCEPT_TEXT ) self.ack_template = self.ack_template or MailTemplate.objects.create( event=self, subject=GENERIC_SUBJECT, text=ACK_TEXT ) self.reject_template = self.reject_template or MailTemplate.objects.create( event=self, subject=GENERIC_SUBJECT, text=REJECT_TEXT ) self.update_template = self.update_template or MailTemplate.objects.create( event=self, subject=UPDATE_SUBJECT, text=UPDATE_TEXT ) self.question_template = self.question_template or MailTemplate.objects.create( event=self, subject=QUESTION_SUBJECT, text=QUESTION_TEXT ) if not self.review_phases.all().exists(): from pretalx.submission.models import ReviewPhase cfp_deadline = self.cfp.deadline r = ReviewPhase.objects.create( event=self, name=_('Review'), start=cfp_deadline, end=self.datetime_from - relativedelta(months=-3), is_active=bool(not cfp_deadline or cfp_deadline < now()), position=0, ) ReviewPhase.objects.create( event=self, name=_('Selection'), start=r.end, is_active=False, position=1, can_review=False, can_see_other_reviews='always', can_change_submission_state=True, ) def _delete_mail_templates(self): for template in self.template_names: setattr(self, template, None) self.mail_templates.all().delete() def copy_data_from(self, other_event): protected_settings = ['custom_domain', 'display_header_data'] self._delete_mail_templates() self.submission_types.exclude(pk=self.cfp.default_type_id).delete() for template in self.template_names: new_template = getattr(other_event, template) = None new_template.event = self setattr(self, template, new_template) for submission_type in other_event.submission_types.all(): is_default = submission_type == other_event.cfp.default_type = None submission_type.event = self if is_default: old_default = self.cfp.default_type self.cfp.default_type = submission_type old_default.delete() for s in other_event.settings._objects.all(): if s.value.startswith('file://') or s.key in protected_settings: continue s.object = self = None self.build_initial_data() # make sure we get a functioning event @cached_property def pending_mails(self) -> int: """The amount of currently unsent :class:`~pretalx.mail.models.QueuedMail` objects.""" return self.queued_mails.filter(sent__isnull=True).count() @cached_property def wip_schedule(self): """Returns the latest unreleased :class:`~pretalx.schedule.models.schedule.Schedule`. :retval: :class:`~pretalx.schedule.models.schedule.Schedule`""" schedule, _ = self.schedules.get_or_create(version__isnull=True) return schedule @cached_property def current_schedule(self): """Returns the latest released :class:`~pretalx.schedule.models.schedule.Schedule`, or ``None`` before the first release.""" return ( self.schedules.order_by('-published') .filter(published__isnull=False) .first() ) @cached_property def duration(self): return (self.date_to - self.date_from).days + 1 def get_mail_backend(self, force_custom: bool = False) -> BaseEmailBackend: from pretalx.common.mail import CustomSMTPBackend if self.settings.smtp_use_custom or force_custom: return CustomSMTPBackend( host=self.settings.smtp_host, port=self.settings.smtp_port, username=self.settings.smtp_username, password=self.settings.smtp_password, use_tls=self.settings.smtp_use_tls, use_ssl=self.settings.smtp_use_ssl, fail_silently=False, ) return get_connection(fail_silently=False) @cached_property def event(self): return self @cached_property def teams(self): """Returns all :class:`~pretalx.event.models.organiser.Team` objects that concern this event.""" from .organiser import Team return Team.objects.filter( models.Q(limit_events__in=[self]) | models.Q(all_events=True), organiser=self.organiser, ) @cached_property def datetime_from(self) -> datetime: """The localised datetime of the event start date. :rtype: datetime """ return make_aware( datetime.combine(self.date_from, time(hour=0, minute=0, second=0)),, ) @cached_property def datetime_to(self) -> datetime: """The localised datetime of the event end date. :rtype: datetime """ return make_aware( datetime.combine(self.date_to, time(hour=23, minute=59, second=59)),, ) @cached_property def tz(self): return pytz.timezone(self.timezone) @cached_property def reviews(self): from pretalx.submission.models import Review return Review.objects.filter(submission__event=self) @cached_property def active_review_phase(self): phase = self.review_phases.filter(is_active=True).first() if not phase and not self.review_phases.all().exists(): from pretalx.submission.models import ReviewPhase cfp_deadline = self.cfp.deadline phase = ReviewPhase.objects.create( event=self, name=_('Review'), start=cfp_deadline, end=self.date_from - relativedelta(months=-3), is_active=bool(cfp_deadline), can_see_other_reviews='after_review', can_see_speaker_names=True, ) return phase def update_review_phase(self): """ This method activates the next review phase if the current one is over. If no review phase is active and if there is a new one to activate. """ _now = now() future_phases = self.review_phases.all() old_phase = self.active_review_phase if old_phase: future_phases = future_phases.filter(position__gt=old_phase.position) next_phase = future_phases.order_by('position').first() if old_phase: if old_phase.end: if old_phase.end > _now: return old_phase old_phase.is_active = False elif not (next_phase and next_phase.start and next_phase.start <= _now): return old_phase if next_phase and (not next_phase.start or next_phase.start <= _now): next_phase.activate() return next_phase return None @cached_property def submission_questions(self): return self.questions.filter(target='submission') @cached_property def talks(self): """Returns a queryset of all :class:`~pretalx.submission.models.submission.Submission` object in the current released schedule.""" from pretalx.submission.models.submission import Submission if self.current_schedule: return ( self.submissions.filter( slots__in=self.current_schedule.talks.filter(is_visible=True) ) .select_related('submission_type') .prefetch_related('speakers') ) return Submission.objects.none() @cached_property def speakers(self): """Returns a queryset of all speakers (of type :class:`~pretalx.person.models.user.User`) visible in the current released schedule.""" from pretalx.person.models import User return User.objects.filter(submissions__in=self.talks).order_by('id').distinct() @cached_property def submitters(self): """Returns a queryset of all :class:`~pretalx.person.models.user.User` objects who have submitted to this event. Ignores users who have deleted all of their submissions.""" from pretalx.person.models import User return ( User.objects.filter(submissions__in=self.submissions.all()) .prefetch_related('submissions') .order_by('id') .distinct() )
[docs] def get_date_range_display(self) -> str: """Returns the localised, prettily formatted date range for this event. E.g. as long as the event takes place within the same month, the month is only named once.""" return daterange(self.date_from, self.date_to)
[docs] def release_schedule(self, name: str, user=None, notify_speakers: bool=False): """Releases a new :class:`~pretalx.schedule.models.schedule.Schedule` by finalizing the current WIP schedule. :param name: The new version name :param user: The :class:`~pretalx.person.models.user.User` executing the release :param notify_speakers: Generate emails for all speakers with changed slots. :type user: :class:`~pretalx.person.models.user.User` """ self.wip_schedule.freeze(name=name, user=user, notify_speakers=notify_speakers)
def send_orga_mail(self, text, stats=False): from django.utils.translation import override from pretalx.mail.models import QueuedMail context = { 'event_dashboard': self.orga_urls.base.full(), 'event_review':, 'event_schedule': self.orga_urls.schedule.full(), 'event_submissions': self.orga_urls.submissions.full(), 'event_team': self.orga_urls.team_settings.full(), 'submission_count': self.submissions.all().count(), } if stats: context.update( { 'talk_count': self.current_schedule.talks.filter( is_visible=True ).count(), 'review_count':, 'schedule_count': self.schedules.count() - 1, 'mail_count': self.queued_mails.filter(sent__isnull=False).count(), } ) with override(self.locale): QueuedMail( subject=_('News from your content system'), text=str(text).format(**context),, ).send()
[docs] @transaction.atomic def shred(self): """Irrevocably deletes an event and all related data.""" from pretalx.common.models import ActivityLog from pretalx.person.models import SpeakerProfile from pretalx.schedule.models import TalkSlot from pretalx.submission.models import ( Answer, AnswerOption, Feedback, Question, Resource, ) deletion_order = [ self.logged_actions(), self.queued_mails.all(), self.cfp, self.mail_templates.all(), self.information.all(), TalkSlot.objects.filter(schedule__event=self), Feedback.objects.filter(talk__event=self), Resource.objects.filter(submission__event=self), Answer.objects.filter(question__event=self), AnswerOption.objects.filter(question__event=self), Question.all_objects.filter(event=self), self.submissions(manager='all_objects').all(), self.tracks.all(), self.submission_types.all(), self.schedules.all(), SpeakerProfile.objects.filter(event=self), self.rooms.all(), ActivityLog.objects.filter(event=self), self, ] self._delete_mail_templates() for entry in deletion_order: entry.delete()