Configuration: Blackout Windows

Owned by Sarah Holst
Last updated: Aug 06, 2022
4 min read

 

Setup Checklist

1. POS Tasks

 

1. POS Tasks

 

Set up date-based product in POS. Required

Prerequisite

2. Aspenware Commerce Tasks

 

Ensure that Product Cutoff Days [Cutoff Days][Hidden] and/or Product Cutoff Time [Cutoff Time][Hidden] have been set up as a specification attribute under Catalog > Attributes > Specification attributes.

Prerequisite

Language String, Setting, HTML widget, etc. Task 4 - optional

Ensure that seasonsettings.productcutofftime is configured.

Prerequisite

Configuration Tasks - Required

Set Up Number of Days Requirement for Blackout Window required

Overwrite Store Cut-off Time for Blackout Window optional

Detailed Setup

Prerequisite Tasks

1. POS Tasks

  • Ensure that the product set up in the POS.

2. Commerce Tasks

  • Create specification attributes for Product Cutoff Days [Cutoff Days] and Product Cutoff Time [Cutoff Time] under Catalog > Attributes > Specification attributes.

3. Settings, Language Strings and/or HTML Widgets for this Feature

Settings

  • Configure the seasonsettings.productcutofftime (store cutoff time) setting. The attribute, Product Cutoff Days [Cutoff Days], works in conjunction with store cutoff time. For example, if your store-wide cutoff time is 13:00, and your cutoff days is set to 1, the product will not be available to buy after 1 pm the day before the booking in the resort’s timezone. However, if your storewide cutoff time is 23:00 and you have cutoff days set to 1, it will be available until 11:00 pm the day before in the store’s timezone. 

Detailed Setup Guide

  1. Set-Up Number of Days Requirement for Blackout Window

  2. (Optional) Overwrite Store Cut-off Time for Blackout Window

NOTE: Product Cutoff Days and Times is currently only supported for date-picker calendars and is not supported for radio button date selection.

1. Set-Up Number of Days Requirement for Blackout Window

Follow these instructions to set up a blackout window that restricts a product booking to a set number of days in advance.

  • Go to Catalog > Products to find the core product to which you would like to add a blackout window. Select the product and click Edit.

  • Scroll to the Specification attributes section on the Edit product details page. (If collapsed, click + to expand.) Click Add attribute.

  • From the Add a new product specification attribute page, enter the following into the designated fields:

    1. Attribute type: select Custom Text.

    2. Attribute: Select the Product Cutoff Days [Cutoff Days]

    3. Value: enter the number of days in advance that a customer must book (e.g. 2.)

    4. Show on product page: leave checked.

    5. Display order: Leave blank

 

NOTE: The attribute, Product Cutoff Days [Cutoff Days], must be first set up as a specification attribute under Catalog > Attributes > Specification attributes if it does not show up in the Attribute type menu.

2. (Optional) Overwrite Store Cut-off Time for Blackout Window

The attribute, Product Cutoff Days [Cutoff Days], works in conjunction with store cutoff time (configured in settings as seasonsettings.productcutofftime.) For example, if your store-wide cutoff time is 13:00, and your cutoff days is set to 1, the product will not be available to buy after 1 pm the day before the booking in the resort’s timezone. However, if your storewide cutoff time is 23:00 and you have cutoff days set to 1, it will be available until 11:00 pm the day before in the store’s timezone. 

If you would like the cutoff time to be different from the store cutoff time, follow the instructions below.

  • Go to Catalog > Products to find the core product that has a blackout window with a time that needs to be configured. Select the product and click Edit.

  • Scroll to the Specification attributes section on the Edit product details page. (If collapsed, click + to expand.) You should see that Product Cutoff Days [Cutoff Days][Hidden] has already been added. Click Add attribute.

  • From the Add a new product specification attribute page, enter the following into the designated fields:

    1. Attribute type: select Option.

    2. Attribute: Select the Product Cutoff Time [Cutoff Time]

    3. Value: Set it to set to the time of day (in military time) in advance the customer must book (e.g. 14:00.)

    4. Show on product page: leave checked.

    5. Display order: Leave blank

NOTE: The attribute, Product Cutoff Time [Cutoff Time] must be first set up as a specification attribute with all available options under Catalog > Attributes > Specification attributes if it does not show up in the Attribute type menu.