Photography

Import the Photography design and it brings blocks and content types of its own, on top of the main Canvas library. Read this page when you are working on a site built from Photography and meet a block you cannot find in the main reference.

These items stay registered on every site so that content you have already imported keeps rendering, and they appear in the block inserter only where the design is in use.

Blocks this design adds

Photo Shots

canvas-core/photo-shots

Display photographs from the Shots post type as an expanding preview grid, or render a single shot page (frame, capture details, enquiry CTA, related shots). In the block inserter it is named Canvas Photo Shots.

Select the block on a page and its own settings open in the sidebar, in the panels below:

Layout

• LayoutDefaultPreview Grid

  Which part of the shots design this block draws: the preview grid, or one of the four single shot pieces.

  ChoicesPreview GridSingle Shot - FrameSingle Shot - DetailsSingle Shot - Enquiry CTASingle Shot - Back + Related

Display

• ColumnsDefault4 Columns

  How many frames sit side by side on a wide screen.

  Choices2 Columns3 Columns4 Columns5 Columns

• Grid Wrapper ClassesDefaultrow grid grid-container gutter-20

  Classes on the grid wrapper. grid-container lets the theme isotope engine pack it.

• Grid IDDefaultEmpty

  Grid wrapper id (the filter bar targets it). Empty = no id.

• Item AnimationDefaultfadeInUp

  Animation applied to each frame as it enters the viewport. Empty = none.

• Show Preview StageDefaultOn

  Render the full-screen preview a clicked frame expands into.

• Preview Close LabelDefaultClose

  Wording on the control that closes an opened preview.

  Shown when Show Preview Stage is on

• Preview Details LinkDefaultView shot details

  Label of the link to the shot page shown inside an opened preview. Empty = no link.

• Show Album FilterDefaultOff

  Show a bar of album buttons above the grid that narrows it down.

• Album Filter ClassesDefaultOn

  Add a pf-{album-slug} class to every frame so a filter bar can target it. Turn off on a grid that is never filtered.

• Filter Bar ClassesDefaultgrid-filter style-4

  Classes on the album filter bar.

  Shown when Show Album Filter is on

• FiltersDefaultShow All=* Wedding=.pf-wedding Nature=.pf-nature

  One "Label=filter" per line. Use * for the all filter; album filters are .pf-{album-slug}.

  Shown when Show Album Filter is on

• Deep-Link FiltersDefaultOn

  Reflect the chosen album in the URL hash, and apply a #filter=… hash on load.

  Shown when Show Album Filter is on

• Collection Page SlugDefaultexplore

  Slug of the page listing every shot. The single layouts resolve it to a portable permalink for the album eyebrow and the "Back" button. Empty = no link.

• Enquiry Page SlugDefaultpricing

  Slug of the page the single-cta button links to. Resolved to a portable permalink so the link is correct on any install / import. Empty = no button.

• CTA Button TextDefaultEnquire About This Frame

  Wording on the main button on a single shot page. Empty renders no button.

• Back Button TextDefaultBack to the Archive

  Wording on the button back to the shot collection. Empty renders no button.

• Related HeadingDefaultMore From This Album

  Heading above the row of other shots.

• Related ShotsDefault4

  How many other shots to show under a single one.

Query

• ShotsDefault0

  0 shows all shots.

• Order ByDefaultMenu Order

  What to sort the shots by.

  ChoicesMenu OrderDateTitle

• OrderDefaultAscending

  Read the sort order forwards or backwards.

  ChoicesAscendingDescending

• Album SlugDefaultEmpty

  Limit the grid to one album (term slug). Empty = every album.