Pet Shelter

Import the Pet Shelter 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 Pet Shelter 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.

Content types this design adds

Pets

canvas_ps_pet

One item is called a Pet. You will find them in their own admin menu once the design is installed.

  • Editor features: editor, excerpt, page-attributes, thumbnail, title
  • Grouped by: Pet Groups (canvas_ps_pet_group)

Each item carries these extra settings on its edit screen:

  • Pet Age

  • Pet Breed

  • Pet Species

Blocks this design adds

Shelter Events

canvas-core/ps-events

Display the shelter's events as cards, or one part of an event page (its label, its date, time and place, the other events). In the block inserter it is named Canvas Shelter Events.

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

The Shelter Events settings in the block editor sidebar

Layout

  • LayoutDefaultEvent Cards

    Which part of the events design this block draws. Event Cards lists them; each "Single Event" choice renders one part of the event page you place it on.

    ChoicesEvent CardsSingle Event - LabelSingle Event - DateTime and PlaceSingle Event - Other Events

Query

  • ItemsDefault0

    0 shows every event. The other-events row shows 3 when this is 0.

  • Event CategoryDefaultEmpty

    Slug of one event category to show only those events. Leave empty for every event.

  • Order ByDefaultMenu Order

    What decides the sequence of the cards. Menu Order lets you arrange them by hand.

    ChoicesMenu OrderDateTitle

  • OrderDefaultAscending

    Which end of that sequence comes first.

    ChoicesAscendingDescending

Display

  • Grid ClassesDefaultrow g-4 justify-content-center

    Class names on the row holding the cards.

  • Column ClassesDefaultcol-lg-4 col-md-6

    Class names on the column around each card, which sets how many cards share a row.

  • Schedule Inline StyleDefaultcolor:var(--cnvs-themecolor);

    Styling on the schedule line of each card.

  • Button TextDefaultEvent details →

    Wording of the link on each card to its event page. Leave empty to hide the link.

  • Button ClassesDefaultph-view-all mt-3 d-inline-block

    Class names on the card link.

  • Label TextDefaultShelter Event

    Shown above the event heading when the event has no category.

    Shown when Layout is "Single Event - Label"

  • Label ClassesDefaultph-label white

    Class names on the label.

    Shown when Layout is "Single Event - Label"

  • When LabelDefaultWhen

    Shown when Layout is "Single Event - Date, Time and Place"

  • Time LabelDefaultTime

    Shown when Layout is "Single Event - Date, Time and Place"

  • Place LabelDefaultWhere

    Shown when Layout is "Single Event - Date, Time and Place"

  • Cost LabelDefaultCost

    Shown when Layout is "Single Event - Date, Time and Place"

Shelter Pets

canvas-core/ps-pets

Display the shelter's adoptable pets as cards, their filter bar, or one part of a pet page (its card, its type and age, the other pets). In the block inserter it is named Canvas Shelter Pets.

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

The Shelter Pets settings in the block editor sidebar

Layout

  • LayoutDefaultPet Cards

    Which part of the pets design this block draws. Pet Cards lists them; each "Single Pet" choice renders one part of the pet page you place it on.

    ChoicesPet CardsPet Type Filter BarSingle Pet - Its CardSingle Pet - TypeAge and BreedSingle Pet - Other Pets

Query

  • ItemsDefault0

    0 shows every pet. The other-pets row shows 4 when this is 0.

  • Pet GroupDefaultEmpty

    Slug of one pet group (for example dogs) to show only those pets. Leave empty for every pet; on a pet group archive the cards follow that group.

  • Order ByDefaultMenu Order

    What decides the sequence of the cards. Menu Order lets you arrange them by hand on the pets list screen.

    ChoicesMenu OrderDateTitle

  • OrderDefaultAscending

    Which end of that sequence comes first.

    ChoicesAscendingDescending

Display

  • Grid ClassesDefaultrow g-4

    Class names on the row holding the cards.

  • Column ClassesDefaultcol-lg-3 col-md-6

    Class names on the column around each card, which sets how many cards share a row.

  • Button TextDefaultMeet %s

    Wording of the button on each card. %s is replaced by the pet's name. Leave empty to hide the button.

  • Button ClassesDefaultph-btn ph-btn-primary

    Class names on the card button.

  • Button Inline StyleDefaultwidth:100%; justify-content:center; padding:11px 20px;

    Styling on the card button.

  • Group OrderDefaultEmpty

    Pet group slugs, comma separated, in the order their buttons appear. Groups left out follow in name order.

    Shown when Layout is "Pet Type Filter Bar"

  • All Pets LabelDefaultAll Pets

    First button of the filter bar, which shows every pet. One button per pet group follows it.

    Shown when Layout is "Pet Type Filter Bar"

Was this page helpful?