Countdown timer widget configuration

Event start and end dates can begin in daylight saving time and end in standard time, or begin in standard time and end in daylight saving time.

The timer accounts for differences in time zones. For example, if the timer is set to end at midnight EST, then the timer ends at 9:00 PM for users in the PST zone.

Before you configure the widget, you must identify these items that are relevant to your configuration:
  • The name of the timer that is displayed on Set Up Home Page. For example, Compliance Training.
  • The groups that have access to the timer.
  • The image that is displayed in the widget. You can use the standard image, or you can select another image. The dimensions of images must be exactly 470 pixels in width x 100 pixels in height. Files must be in PNG or JPG format.
  • A text description of the image, for 508 Compliance.
  • Optional introductory text that is displayed below the timer and above the link list. For example, you can specify Compliance training is the process by which employees' understanding of your organizations policies is verified.
  • Optional link list header. For example, Materials for review.
  • Optional link list text that is displayed above the link list. For example, Complete each training in the list.
  • Optional documents that are mapped to the links in the link list. Links to these documents populate the link list.
  • UTC parameter for dates based on time zone and standard or daylight savings.
  • The text in single-timer widgets and double-time widgets.
  • The format for text that is displayed under the numeric value on the timer. For example, Days, Hours, Minutes, Seconds or Days, Hrs, Min, Sec or D, H, M, S.
  • A title that is displayed below the image and above the messages. This is not the same as the title. For example, Compliance Training.
  • Pinning placement to pin the widget to the Home page.
  • Optional expiration date. If an expiration date is set for the timer document, then the document is removed on the date.

Adding a widget with a single-date timer

After adding a single-date timer, you must configure the widget.

  1. Log in to HRSD Knowledgebase.
  2. On the Home page, click the ellipsis icon.
  3. Select Document Manager.
  4. Select Add new Document > Add From Organization.
  5. In the Add Method drop-down, select Reference.
  6. In the Name/Tag field, specify %cdt.
  7. In the Widget area, select Master Countdown Timer - Single Date (CDT).
  8. Click Add.

Configuring a widget with a single-date timer

You can rename the single-date timer widget and configure the data items that are associated with images, subject, text, timer, title, and placement on the Home page.

Before you begin configuring a widget with a single-date timer, ensure that you meet these requirements:
  • Image file names must not contain spaces, punctuations, or special characters. As a best practice, append WID to the file name to indicate that the image is used for a widget. For example, complianceWID.png.
  • You must upload that image to the system before you can add it to a widget.
  1. Log in to HRSD Knowledgebase.
  2. On the Home page, click the ellipsis icon.
  3. Select Document Manager.
  4. On the Document Manager page, locate the single-date timer widget.
  5. Click Edit to check the document out and open it in edit mode.
  6. Update the name and details of the widget:
    1. Select Tools > Details.
    2. In the Name field, specify a name for the widget.
    3. Click Update.
  7. Add groups to the widget:
    1. Select Tools > Access.
    2. On the Portal Access tab, select UnAssigned Groups.
    3. Select one or more groups from the list.
    4. Add the AnswerTools group rule to the timer group rules.
    5. Click Assign Group.
    6. Click the X icon to close the Access menu.
  8. Specify which elements are displayed on the widget:
    1. Select Configure > Options.
    2. Select Widget Image to enable an image to be placed across the top of the widget. A standard image is used as a default setting. You can select a different image later in the process.
    3. Select Widget Intro Text to add an introductory text to the widget.
    4. Click Apply.
    5. Click OK.
    6. Click the X icon to close the Options menu.
  9. Specify the data items for widget images, properties, and texts:
    1. Select Configure > Data Items.
    2. To configure the widget image:
      cardimgalt
      Specify a description of the image for 508 compliance.
      cardimgurl
      Specify the path of the uploaded image.
    3. To configure the subject of the widget, specify this data item:
      subject
      Specify a single, unique word that is used map content to the widget if using the widget linklist.
    4. To configure the text on the widget, specify this data item:
      introductorytext
      Specify the introductory text below the timer and above the linklist. If the widget uses introductory text, then select the associated option.
      linklistheader
      Optionally, specify the linklist title above the linklist and linklist text.
      linklisttext
      Optionally, specify the linklist text below the linklist header and above the linklist, like an introduction to the linklist.
    5. To configure the widget's timer properties, specify these data items:
      enddate
      Specify the date and time when the timer ends. Use the 24-hour format MM DD, YYYY 00:00:01 + UTC time code. For example, specify 06 26, 2023 12:00:01 -0400 spring-summer for US East Coast Daylight Savings Time, or 02 23, 2023 23:59:01-0500 fall-winter for US East Coast Standard Time.
      id
      Specify a unique identifier for the widget.
      beginheader
      Specify the message between the timer name and the countdown when the timer starts to run and before it ends.
      finalheader
      Specify the message to show when the countdown ends.
      tdays
      Specify the text below the number of days in the timer. For example, specify D or Days.
      thours
      Specify the text below the number of hours in the timer. For example, specify H, Hrs, or Hours.
      tmin
      Specify the text below the number of minutes in the timer. For example, specify M, Min, or Minutes.
      tsec
      Specify the text below the number of seconds in the timer. For example, specify S, Sec, or Seconds.
      name
      Specify the name of the timer. This name is displayed at the top of the timer, below the image and above the messages. Don't use special characters.
      column
      To pin the widget on the Home page, specify the number of the column where the widget is displayed.
      height1
      Use the default setting.
      height2
      Specify auto='true'.
      icon1
      Leave blank.
      icon2
      Leave blank.
      order1
      Specify the default setting.
      order2
      Specify the order within the column.
      pin1
      Use the default setting.
      pin2
      Use the default setting.
      title1
      Use the default setting.
      title2
      Specify the title of the widget. Don't use special characters in the name. This title is not displayed on the portal, but it's part of the pinning code.
    6. Close the Data Items page.
  10. To set an expiration date for the widget:
    1. Select Tools > Details.
    2. In the Advanced Settings section, specify an expiration data in the Expiration Date field. When the date occurs, the widget is removed from the Home page.
    3. Click Update.
  11. Select Check In > Check In.
  12. Click Save & Check In.
  13. Click Close Edit.
  14. On the Document Manager page, locate and select the single-date timer widget.
  15. Select Publish > Stage to publish the widget.

Adding a widget with a double-date timer

After adding a double-date timer, you must configure the widget.

  1. Log in to HRSD Knowledgebase.
  2. On the Home page, click the ellipsis icon.
  3. Select Document Manager.
  4. Select Add New Document > Add From Organization.
  5. Specify this information:
    Add Method
    Specify Reference.
    Name/Tag
    Specify %cdt.
  6. In the Widget area, select Master Countdown Timer - Double Date (CDT).
  7. Click Add.

Configuring a widget with a double-date timer

You can rename the widget and configure the data items that are associated with images, subject, text, timer, title, and pinning to the Home page.

Before you begin configuring a widget with a single-date timer, ensure that you meet these requirements:
  • Image file names must not contain spaces, punctuations, or special characters. As a best practice, append WID to the file name to indicate that the image is used for a widget. For example, complianceWID.png.
  • You must upload that image to the system before you can add it to a widget.
  1. On the Document Manager page, locate the single-date timer widget.
  2. Click Edit to check the document out and open it in Edit mode.
  3. To update the name and details of the widget:
    1. Click Tools > Details.
    2. In the Name field, specify a name for the widget.
    3. Click Update.
  4. To add groups to the widget:
    1. Go toTools > Access.
    2. On the Portal Access tab, select UnAssigned Groups.
    3. Select one or more groups from the list.
    4. Add the AnswerTools group rule to the timer group rules.
    5. Click Assign Group.
    6. Close the Access menu.
  5. To specify which elements are displayed on the widget:
    1. Select Configure > Options.
    2. Select Widget Image to enable an image to be displayed across the top of the widget. A standard image is used as a default setting. You can select a different image later in the process. Deselect this option to remove any image from the widget.
    3. Select Widget Intro Text to add an introductory text to the widget. You can specify the widget texts later in the process.
    4. Click Apply.
    5. Click OK.
    6. Close the Options page.
  6. Select Configure > Data Items.
  7. To specify the data items for widget images, properties, and texts:
    1. Click Configure > Data Items.
    2. To configure the widget image:
      cardimgalt
      Specify a description of the image for 508 compliance.
      cardimgurl
      Specify the path of the uploaded image.
    3. To configure the widget's subject, specify a single, unique word that is used map content to the widget if using the widget linklist.
    4. To configure the widget's text, specify this data item:
      introductorytext
      Specify the introductory text below the timer and above the linklist. If the widget uses introductory text, then select the associated option.
      linklistheader
      Specify the linklist title above the linklist and linklist text. This field is optional.
      linklisttext
      Specify the linklist text below the linklist header and above the linklist, like an introduction to the linklist. This is optional.
    5. To configure the widget's timer properties, specify these data items:
      begindate
      Specify the date and time that the event begins. Use the 24-hour format: MM DD, YYYY 00:00:01 + UTC time code. For example, specify 06 26, 2023 12:00:01 -0400 spring-summer for US East Coast Daylight Savings Time. For example, specify 02 23, 2023 12:00:01-0500 fall-winter for US East Coast Standard Time.
      enddate
      Specify the date and time when the timer ends. Use the 24-hour format MM DD, YYYY 00:00:01 + UTC time code. For example, specify 06 26, 2023 12:00:01 -0400 spring-summer for US East Coast Daylight Savings Time, or 02 23, 2023 23:59:01-0500 fall-winter for US East Coast Standard Time.
      id
      Specify a unique identifier for the widget.
      beginheader
      Specify the message under the timer name and above the countdown when the timer starts to run and before it ends.
      finalheader
      Specify the message to show when the countdown ends.
      tdays
      Specify the text below the number of days in the timer. For example, D or Days.
      thours
      Specify the text below the number of hours in the timer. For example, H, Hrs, or Hours.
      tmin
      Specify the text below the number of minutes in the timer. For example, M, Min, or Minutes.
      tsec
      Specify the text below the number of seconds in the timer. For example, S, Sec, or Seconds.
      name
      Specify the name of the timer. This name is displayed at the top of the timer, below the image and above the messages. Don't use special characters.
      column
      To pin the widget on the Home page, specify the number of the column where the widget is displayed.
      height1
      Use the default setting.
      height2
      Specify auto='true'.
      order1
      Specify the default setting.
      order2
      Specify the order within the column.
      icon1
      Leave blank.
      icon2
      Leave blank.
      pin1
      Specify the default setting. Do not edit.
      pin2
      Specify the default setting. Do not edit this setting. Only the default setting can be used.
      title1
      Specify the default setting. Do not edit this setting. Only the default setting can be used.
      title2
      Specify the title of the widget. Do not use special characters in the name. This title is not shown on the portal, but it is part of the pinning code.
    6. Close the Data Items page.
  8. To set an expiration date for the widget:
    1. Select Tools > Details.
    2. In the Advanced Settings section, locate the Expiration Date field.
    3. Specify an expiration date for the widget. When the date occurs, the widget is removed from the Home page.
    4. Click Update.
  9. Select Check In > Check In.
  10. Click Save & Check In.
  11. Click Close Edit.
  12. In Document Manager, locate and select the single-date timer widget.
  13. Select Publish > Stage to publish the widget.