Event Settings

Description

Event settings for an event or event defaults.

Properties

Property Description
allowAddAllToCart

Whether to show "Buy All" buttons, allowing clients to add all photos in the event to their cart. If this is set to true, priceSheetShowPackagesOnly MUST be false.

allowBlackWhiteFiltering

Allow clients to see and order a black and white version of an image.

allowCropping

Allow clients to crop photos on orders.

allowFreeDigitals

Whether to allow clients to download free digitals from the event.

allowFreeDigitalsDownloadAll

If allowFreeDigitals is true, whether to allow clients to download the entire event.

allowPayLater

Whether to allow clients to pay later.

autoArchiveDays nullable

If provided, the number of days after event expiration to automatically archive the event.

autoSetAlbumCovers

Whether to autogenerate album cover images from the first image in the album.

brandTheme

A brand theme.

brandThemeId

The identifier for the brand theme the event uses.

checkoutText nullable

If provided, a message shown to the client at checkout.

emailAutomationGroupId nullable

The identifier for the email automation group associated with the event.

eventAccessLevel

The event access level.

eventCategory nullable read-only

The human-readable name of the category of the event.

eventCategoryId nullable

The category identifier associated with the event.

eventStatus

The event status.

exifSearchFieldLabel nullable

The label for the EXIF data search field for the event.

This is only available if the studio has been flagged in the admin with this permission.

headline nullable

Headline to display to event visitors.

hideAlbums

Whether to hide all the albums in an event.

This is only available if the studio has been flagged in the admin with this permission.

hideAllPhotosAlbum

Whether to hide the "All Photos" default photo album.

hidePhotoCountAlbums

Whether to hide the photo count for all albums in the client facing gallery.

homepageLinkTo nullable

The URL to which the homepage link should send users. This is required if showHomepageLink is true.

Valid values are:

  • studio_homepage: The homepage link points to the ShootProof homepage for the brand.
  • studio_website: The homepage link points to the website URL set for the brand.
information nullable

Information to display to event visitors.

isPreRegistration

Whether pre-registration mode is turned on for the event.

landingLayoutType

The layout type for the event landing page. The possible landing layout types are:

  • basic: Accent
  • full-bottom: Limelight
  • full-bottom-alt: Foundation
  • full-center: Marquee
  • hexagon: Symmetry
  • split: Detail
  • no-cover: Headline
languageCode

The Unicode CLDR language tag for the language used in the event.

minimumOrderAmount nullable

The minimum amount required for any order placed for the event.

musicAutoPlay

If there is a playlist defined, whether to auto-play the music when the even loads in the browser.

pickupOptions

An array of order pickup options supported by the event.

playlist nullable read-only

The playlist for the event, if applicable. (TODO: playlists not supported in the API at this time.)

playlistId nullable

The identifier for the playlist the event uses.

preRegistrationMessage nullable

Text to display to visitors when the event is in pre-registration mode.

priceSheet nullable read-only

The price sheet for the event, if applicable. (TODO: price sheets not supported in the API at this time.)

priceSheetId nullable

The identifier for the price sheet the event uses. If null, then the shopping cart for the event is turned off.

priceSheetShowPackagesOnly

Whether to limit the display of price sheet items to only those that are packages. If this is set to true, allowAddAllToCart MUST be false.

printRelease nullable

Print release text that is sent to the client when ShootProof-fulfilled digitals are downloaded. Some HTML is allowed.

requireEmail

Whether an email address is required to view the event.

showFilenames

Whether to show the filenames of photos in the event.

showHomepageLink

Whether to show a link to the studio homepage.

showSocialSharingLinks

Whether to display social media sharing links for the event.

socialSharingMessage nullable

The default message to include when a social sharing link is clicked.

thumbnailGutterWidth

Relative size of thumbnail gutter width for display.

thumbnailSize nullable

Relative size of thumbnails for display.

videoUrl nullable

The URL of a video to display to event visitors.

viewType

The layout type for the event photo pages. The possible view types are:

  • vmason: Cascade layout
  • hmason: Subway layout

OpenAPI Schema

The following schema is based on OpenAPI 3.0 and is provided in our downloadable OpenAPI document.

{
  "description": "Event settings for an event or event defaults.",
  "properties": {
    "allowAddAllToCart": {
      "description": "Whether to show \"Buy All\" buttons, allowing clients to add all\nphotos in the event to their cart. If this is set to true, \n`priceSheetShowPackagesOnly` MUST be false.",
      "type": "boolean"
    },
    "allowBlackWhiteFiltering": {
      "description": "Allow clients to see and order a black and white version of an\nimage.",
      "type": "boolean"
    },
    "allowCropping": {
      "description": "Allow clients to crop photos on orders.",
      "type": "boolean"
    },
    "allowFreeDigitals": {
      "description": "Whether to allow clients to download free digitals from the event.",
      "type": "boolean"
    },
    "allowFreeDigitalsDownloadAll": {
      "description": "If `allowFreeDigitals` is true, whether to allow clients to download\nthe entire event.",
      "type": "boolean"
    },
    "allowPayLater": {
      "description": "Whether to allow clients to pay later.",
      "type": "boolean"
    },
    "autoArchiveDays": {
      "description": "If provided, the number of days after event expiration to\nautomatically archive the event.",
      "nullable": true,
      "type": "integer"
    },
    "autoSetAlbumCovers": {
      "description": "Whether to autogenerate album cover images from the first image in\nthe album.",
      "type": "boolean"
    },
    "brandTheme": {
      "$ref": "#/components/schemas/BrandTheme",
      "readOnly": true
    },
    "brandThemeId": {
      "description": "The identifier for the brand theme the event uses.",
      "type": "integer"
    },
    "checkoutText": {
      "description": "If provided, a message shown to the client at checkout.",
      "maxLength": 1000,
      "nullable": true,
      "type": "string"
    },
    "emailAutomationGroupId": {
      "description": "The identifier for the email automation group associated with the\nevent.",
      "nullable": true,
      "type": "integer"
    },
    "eventAccessLevel": {
      "description": "The event access level.",
      "enum": [
        "public-password",
        "public-no-password",
        "private-password",
        "private-no-password"
      ],
      "type": "string"
    },
    "eventCategory": {
      "description": "The human-readable name of the category of the event.",
      "nullable": true,
      "readOnly": true,
      "type": "string"
    },
    "eventCategoryId": {
      "description": "The category identifier associated with the event.",
      "nullable": true,
      "type": "integer"
    },
    "eventStatus": {
      "description": "The event status.",
      "enum": [
        "active",
        "inactive",
        "archived"
      ],
      "type": "string"
    },
    "exifSearchFieldLabel": {
      "description": "The label for the EXIF data search field for the event.\n\nThis is only available if the studio has been flagged in the admin\nwith this permission.",
      "maxLength": 40,
      "nullable": true,
      "type": "string"
    },
    "headline": {
      "description": "Headline to display to event visitors.",
      "maxLength": 100,
      "nullable": true,
      "type": "string"
    },
    "hideAlbums": {
      "description": "Whether to hide all the albums in an event.\n\nThis is only available if the studio has been flagged in the admin\nwith this permission.",
      "type": "boolean"
    },
    "hideAllPhotosAlbum": {
      "description": "Whether to hide the \"All Photos\" default photo album.",
      "type": "boolean"
    },
    "hidePhotoCountAlbums": {
      "description": "Whether to hide the photo count for all albums in the client facing\ngallery.",
      "type": "boolean"
    },
    "homepageLinkTo": {
      "description": "The URL to which the homepage link should send users. This is\nrequired if `showHomepageLink` is `true`.\n\nValid values are:\n\n* `studio_homepage`: The homepage link points to the ShootProof\nhomepage for the brand.\n* `studio_website`: The homepage link points to the website URL set\nfor the brand.",
      "enum": [
        "studio_homepage",
        "studio_website"
      ],
      "nullable": true,
      "type": "string"
    },
    "information": {
      "description": "Information to display to event visitors.",
      "maxLength": 2000,
      "nullable": true,
      "type": "string"
    },
    "isPreRegistration": {
      "description": "Whether pre-registration mode is turned on for the event.",
      "type": "boolean"
    },
    "landingLayoutType": {
      "description": "The layout type for the event landing page. The possible landing\nlayout types are:\n\n* `basic`: Accent\n* `full-bottom`: Limelight\n* `full-bottom-alt`: Foundation\n* `full-center`: Marquee\n* `hexagon`: Symmetry\n* `split`: Detail\n* `no-cover`: Headline",
      "enum": [
        "full-bottom",
        "full-center",
        "split",
        "basic",
        "no-cover"
      ],
      "type": "string"
    },
    "languageCode": {
      "description": "The Unicode CLDR language tag for the language used in the event.",
      "type": "string"
    },
    "minimumOrderAmount": {
      "description": "The minimum amount required for any order placed for the event.",
      "nullable": true,
      "type": "number"
    },
    "musicAutoPlay": {
      "description": "If there is a playlist defined, whether to auto-play the music when\nthe even loads in the browser.",
      "type": "boolean"
    },
    "pickupOptions": {
      "description": "An array of order pickup options supported by the event.",
      "items": {
        "description": "A string identifying a pickup option.",
        "enum": [
          "studio",
          "dropship"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "playlist": {
      "description": "The playlist for the event, if applicable. (TODO: playlists not\nsupported in the API at this time.)",
      "nullable": true,
      "readOnly": true
    },
    "playlistId": {
      "description": "The identifier for the playlist the event uses.",
      "nullable": true,
      "type": "integer"
    },
    "preRegistrationMessage": {
      "description": "Text to display to visitors when the event is in pre-registration\nmode.",
      "maxLength": 1000,
      "nullable": true,
      "type": "string"
    },
    "priceSheet": {
      "description": "The price sheet for the event, if applicable. (TODO: price sheets\nnot supported in the API at this time.)",
      "nullable": true,
      "readOnly": true
    },
    "priceSheetId": {
      "description": "The identifier for the price sheet the event uses. If `null`, then\nthe shopping cart for the event is turned off.",
      "nullable": true,
      "oneOf": [
        {
          "type": "integer"
        },
        {
          "type": "string"
        }
      ]
    },
    "priceSheetShowPackagesOnly": {
      "description": "Whether to limit the display of price sheet items to only those that are packages.\nIf this is set to true, `allowAddAllToCart` MUST be false.",
      "type": "boolean"
    },
    "printRelease": {
      "description": "Print release text that is sent to the client when\nShootProof-fulfilled digitals are downloaded. Some HTML is allowed.",
      "maxLength": 7500,
      "nullable": true,
      "type": "string"
    },
    "requireEmail": {
      "description": "Whether an email address is required to view the event.",
      "type": "boolean"
    },
    "showFilenames": {
      "description": "Whether to show the filenames of photos in the event.",
      "type": "boolean"
    },
    "showHomepageLink": {
      "description": "Whether to show a link to the studio homepage.",
      "type": "boolean"
    },
    "showSocialSharingLinks": {
      "description": "Whether to display social media sharing links for the event.",
      "type": "boolean"
    },
    "socialSharingMessage": {
      "description": "The default message to include when a social sharing link is\nclicked.",
      "maxLength": 93,
      "nullable": true,
      "type": "string"
    },
    "thumbnailGutterWidth": {
      "description": "Relative size of thumbnail gutter width for display.",
      "enum": [
        "s",
        "m",
        "l",
        "xl"
      ],
      "type": "string",
      "x-internal": true
    },
    "thumbnailSize": {
      "description": "Relative size of thumbnails for display.",
      "enum": [
        "s",
        "m",
        "l",
        "xl"
      ],
      "nullable": true,
      "type": "string",
      "x-internal": true
    },
    "videoUrl": {
      "description": "The URL of a video to display to event visitors.",
      "maxLength": 255,
      "nullable": true,
      "type": "string"
    },
    "viewType": {
      "description": "The layout type for the event photo pages. The possible view types\nare:\n\n* `vmason`: Cascade layout\n* `hmason`: Subway layout",
      "enum": [
        "vmason",
        "hmason"
      ],
      "type": "string"
    }
  },
  "required": [
    "eventStatus",
    "eventAccessLevel",
    "brandThemeId",
    "pickupOptions",
    "viewType",
    "landingLayoutType",
    "languageCode"
  ],
  "title": "Event Settings",
  "type": "object"
}