editions

git.splent.io/splent-io/splent_feature_editions

v0.3.0 full Refines events

About

Editions of a recurring event (archive, current edition, programme by day), refining events

Refinement

Refines
Extends models
Event with EventEditionMixin

It changes events in place, without a fork, so the product installs both.

Provides

Models
EditionEditionPhotoEditionSponsor
Services
EditionsService
Routes
/admin/editions/admin/editions/<int:edition_id>/adopt/admin/editions/<int:edition_id>/current/admin/editions/<int:edition_id>/delete/admin/editions/<int:edition_id>/edit/admin/editions/<int:edition_id>/photos/admin/editions/<int:edition_id>/photos/<int:media_id>/detach/admin/editions/<int:edition_id>/photos/attach/admin/editions/<int:edition_id>/photos/reorder/admin/editions/<int:edition_id>/sponsors/admin/editions/<int:edition_id>/sponsors/<int:partner_id>/detach/admin/editions/<int:edition_id>/sponsors/attach/admin/editions/new/editions/editions/<slug>
Hooks filled
events.admin.form.fieldsevents.admin.list.actionsevents.admin.list.event_metaevents.detail.before_metaevents.list.contentevents.list.heroevents.list.titlehome.herohome.sectionlayout.authenticated_sidebar
Signals
event-edition-choices
Translations
enes

Commands

  • $ splent feature:editions hello

    Example command — replace with your own.

Run them in your workspace once the feature is installed in the selected product.

Configuration

Setting Default What it does
EDITIONS_NAV_LABEL empty Main-nav label for the archive page. Empty keeps the default "Editions".

These are the defaults. A product changes them in its own pyproject.toml, under [tool.splent.config], or in .env.deploy in production.

Dependencies

Works better with
Used by

In product lines

  • cms_spl Optional in this line Needs media partners events

Extension points

Templates
editions/admin/form.htmleditions/admin/list.htmleditions/admin/photos.htmleditions/admin/sponsors.htmleditions/detail.htmleditions/hooks/event_detail_edition.htmleditions/hooks/events_admin_actions.htmleditions/hooks/events_admin_form_fields.htmleditions/hooks/events_list_content.htmleditions/hooks/events_list_hero.htmleditions/hooks/home_hero.htmleditions/hooks/home_section.htmleditions/index.html
Services
EditionsService
Models
EditionEditionPhotoEditionSponsor
Routes
A refinement can add routes to its blueprint

Other features fill its hook slots. A refinement can override its templates and services or extend its models without forking it.

Compatibility

Python
>=3.13
SPLENT framework
>=1.30.0