Centralized constants for the Publishing module.
Provides canonical lists for statuses, modes, and types used across schemas, business logic, and templates. Import or alias this module instead of hardcoding these values inline.
For guard clauses and pattern matches, use the module attributes:
@timestamp_modes Publishing.Constants.timestamp_modes()
@slug_modes Publishing.Constants.slug_modes()
def my_func(mode) when mode in @timestamp_modes do ...Summary
Functions
Valid band styles for the Featured/Latest bands — the PAINT of a band card, orthogonal to its layout (which stays size/placement: hero band vs card in grid): "classic" (image beside/above the text — the original variants), "cover" (the featured image is the card's background, text overlaid on a gradient scrim), "cover_panel" (background image with an opaque text panel), "minimal" (text-only editorial band, image ignored), "top" (16:9 image banner stacked above the text).
Valid version and content statuses: draft, published, archived.
Default band style ("classic" — the pre-styles rendering, unchanged).
Default featured-post layout ("hero").
Default public-listing layout ("grid").
Default public-listing sort order ("newest" first).
Default group mode.
Default latest-post layout ("hero").
Default author-note display style ("footnotes" — the original layout).
Default post-date position ("below" the title).
Default post-page content width ("normal").
Default scrollbar style ("default" — the browser's native bar, untouched).
Default date-timeline granularity ("auto").
Default title for posts without a title.
Default group type.
Valid featured-post layouts: "hero" (band above the grid) or "card" (larger card in the grid).
Valid group statuses: active, trashed.
Valid public-listing layouts: "grid" (card grid), "list" (thumbnail rows), or "minimal" (date — title lines, no images).
Valid public-listing sort orders: "newest" or "oldest", by effective publish date.
Max length for group names.
Max length for group slugs.
Max length for language codes.
Max length for post/content slugs.
Max length for content titles.
Valid latest-post layouts: "hero" (band above the grid) or "card" (larger card in the grid).
Valid author-note display styles: "footnotes" (numbered refs + a collected bottom section + hover popovers) or "panel" (clicking the phrase slides a right-side panel out with the note and its comments).
Valid post-date positions relative to the title: "above", "below", or "hidden".
Valid post statuses: draft, published, archived, trashed.
Valid post-page content widths: "narrow", "normal", or "wide".
Preset group types (shown as radio buttons in UI).
True for the published status.
True when a timestamp-mode post is scheduled for later and must not be public yet.
Valid scrollbar styles: "default" (native, unstyled), "branded" (theme-colored), "thin" (theme-colored + thin).
Now, on the site's wall clock — DateTime.utc_now/0 shifted by the
configured time_zone offset, which is the clock timestamp-mode posts
are written and displayed on.
The site's time_zone setting as a whole-hour offset in seconds (0 when
unset or unparseable). The one place that reading lives, so post
stamping, schedule release and feed dates can't drift apart.
Returns true if mode is a slug mode (atom or string).
Atom and string variants for slug mode — use in guards/pattern matches.
The "archived" status.
The "draft" status.
The "published" status.
The "trashed" status.
Valid date-timeline granularities: "auto" (fit to the posts' date span), "year", "month", or "day".
Returns true if mode is a timestamp mode (atom or string).
Atom and string variants for timestamp mode — use in guards/pattern matches.
Valid mode strings for schema validation.
All valid group types including custom.
Functions
Valid band styles for the Featured/Latest bands — the PAINT of a band card, orthogonal to its layout (which stays size/placement: hero band vs card in grid): "classic" (image beside/above the text — the original variants), "cover" (the featured image is the card's background, text overlaid on a gradient scrim), "cover_panel" (background image with an opaque text panel), "minimal" (text-only editorial band, image ignored), "top" (16:9 image banner stacked above the text).
Valid version and content statuses: draft, published, archived.
Default band style ("classic" — the pre-styles rendering, unchanged).
Default featured-post layout ("hero").
Default public-listing layout ("grid").
Default public-listing sort order ("newest" first).
Default group mode.
Default latest-post layout ("hero").
Default author-note display style ("footnotes" — the original layout).
Default post-date position ("below" the title).
Default post-page content width ("normal").
Default scrollbar style ("default" — the browser's native bar, untouched).
Default date-timeline granularity ("auto").
Default title for posts without a title.
Default group type.
Valid featured-post layouts: "hero" (band above the grid) or "card" (larger card in the grid).
Valid group statuses: active, trashed.
Valid public-listing layouts: "grid" (card grid), "list" (thumbnail rows), or "minimal" (date — title lines, no images).
Valid public-listing sort orders: "newest" or "oldest", by effective publish date.
Max length for group names.
Max length for group slugs.
Max length for language codes.
Max length for post/content slugs.
Max length for content titles.
Valid latest-post layouts: "hero" (band above the grid) or "card" (larger card in the grid).
Valid author-note display styles: "footnotes" (numbered refs + a collected bottom section + hover popovers) or "panel" (clicking the phrase slides a right-side panel out with the note and its comments).
Valid post-date positions relative to the title: "above", "below", or "hidden".
Valid post statuses: draft, published, archived, trashed.
Valid post-page content widths: "narrow", "normal", or "wide".
Preset group types (shown as radio buttons in UI).
True for the published status.
Note this is the publishing vocabulary. The comments module has its own
"published" status on a different table, and the two are unrelated — a
comment being published says nothing about the post it hangs off. Don't
reach for this when checking a comment.
True when a timestamp-mode post is scheduled for later and must not be public yet.
A timestamp post is identified by a date AND a time, and the schedule was read as a date alone — so anything set for later today went public at midnight. Nine in the morning is a normal time to line up an announcement for six in the evening, and the listing carried its title, excerpt and image from the moment the day started.
Three copies of the date-only test had drifted into the listing, the post page and the fallback resolver. One predicate, so a scheduled post becomes public at one moment on every path that asks.
Both sides of the comparison are the SITE's wall clock, not UTC.
post_date/post_time are stamped and edited in the configured
time_zone offset (Posts.maybe_add_initial_timestamp/3) and shown
as-is with no display conversion, so comparing them to utc_now/0
released an embargoed post offset hours early on a site west of UTC —
and held it back that long on a site east of it.
Pass now (from site_now/0) when testing many posts in one pass: the
offset comes from a settings read, and filter_published/1 runs this
over the whole listing cache.
@spec scheduled_ahead?(map(), DateTime.t()) :: boolean()
Valid scrollbar styles: "default" (native, unstyled), "branded" (theme-colored), "thin" (theme-colored + thin).
@spec site_now() :: DateTime.t()
Now, on the site's wall clock — DateTime.utc_now/0 shifted by the
configured time_zone offset, which is the clock timestamp-mode posts
are written and displayed on.
Hoist this out of a loop; every call is a settings read.
@spec site_offset_seconds() :: integer()
The site's time_zone setting as a whole-hour offset in seconds (0 when
unset or unparseable). The one place that reading lives, so post
stamping, schedule release and feed dates can't drift apart.
Returns true if mode is a slug mode (atom or string).
Atom and string variants for slug mode — use in guards/pattern matches.
The "archived" status.
The "draft" status.
The "published" status.
The "trashed" status.
Valid date-timeline granularities: "auto" (fit to the posts' date span), "year", "month", or "day".
Returns true if mode is a timestamp mode (atom or string).
Atom and string variants for timestamp mode — use in guards/pattern matches.
Valid mode strings for schema validation.
All valid group types including custom.