Salesforce

Dollars for Doers Program Configuration Guide

« Go Back
Information
Dollars for Doers Program Configuration Guide
8278567018007-Dollars-for-Doers-Program-Configuration-Guide
Details

 

Configuration must be published to the Production environment to make changes visible to end-users. 

Read the Dollars for Doers Overview to learn more!

 

Table of Contents


 

Part One: Configure a Log Hours Proposal Type  

Dollars for Doers allows you to use multiple existing or new Log Hours proposal types. Each log hours proposal type related to the Dollars for Doers program will have its volunteer hours count towards an employee's eligibility for a volunteer match. 

Learn more about how to Create an Employee Giving Proposal.

Instructions

Step One: Configure a Log Hours Proposal Type 

View Create an Employee Giving Proposal  or Update an Existing Proposal Type for step-by-step instructions to configure a Log Hours proposal type for your Dollars for Doers program. If you are creating a new proposal type, be sure to choose an existing Log Hours proposal type. 

Note: You will need to ensure that the following settings are configured correctly. 

When following the step-by-step instructions, configure the following options for your Log Hours proposal type: 

  • In the Proposal Types column, click the hyperlink for an existing log hours proposal type
    .

Note: Naming may vary between clients.

Step Two: Configure Program Options

View Configure Program Options for step-by-step instructions to configure your program options. 

Note: You will need to ensure that the following settings are configured accordingly.  

When following the step-by-step instructions, configure the following options for your Dollars for Doers program: 

  • In the Nature of Program dropdown menu, select Individual Dollar/Hour Contributions, Journaling, Event Sign-Up. 
  • In the Transaction Unit dropdown menu, select Hour. 
  • In the Match Configuration dropdown menu, select No Match.

    Note: Other selections will not affect functionality.  

Step Three: Configure Gift Eligibility Ranges 

View Configure Gift Eligibility Ranges for step-by-step instructions to configure Gift Eligibility Ranges for your program. 

Note: You will need to ensure that the following settings are configured accordingly.  

When following the step-by-step instructions, configure the following options for the Gift Eligibility Ranges for the Log Hours proposal type: 

  • Verify the Gift Eligibility Date Ranges are correct for your program. This is used to calculate the current year.  
  • In the Creation Date Range column, enter a start date to determine the date eligible employees can begin logging hours. 
  • In the Creation Date Range column, enter an end date to determine the date the program closes and employees can no longer log hours. 
  • In the Gift Date Range column, enter a start and end date. The Gift Date Range indicates the valid volunteer date ranges for the log hours proposal type. 
  • In the Applications Accepted? column, select the appropriate option from the dropdown menu. 

To see examples of what Gift Eligibility Ranges can look like for Log Hour proposal types, view Log Hours Gift Eligibility Date Configuration ExamplesLearn more about the Gift Eligibility Date Ranges.

Step Four: Configure Donor Rules
Donor rules control the eligibility for an employee to be able to redeem a volunteer match through the Dollars for Doers program. 

View Create or Edit a Donor Rule for step-by-step instructions to configure Donor Rules for your program. 

Note: Donor Rules will likely already be configured, however, you must verify that they are correct. Learn more about Donor Rules.

To see examples of what Donor Rules can look like for Log Hour proposal types, view Dollars for Doers Donor Rule Examples.

Step Five: Configure Gift Rules

For Log Hours proposal types, gift rules control what log hours transactions can be submitted in the donor portal by an employee when logging their volunteer hours. 

Note: You will need to ensure that you select the Log Hours proposal type before navigating to the proposal’s Gift Rules. 

View Create or Edit a Gift Rule for step-by-step instructions to configure Gift Rules for your program. 

To see examples of what Gift Rules can look like for Log Hour proposal types, view Log Hours Gift Rule Examples. Learn more about Gift Rules.

Back to Top

Part Two: Configure a Dollars for Doers Proposal Type

All Dollars for Doers programs must use the Dollars for Doers proposal type to allow employees to apply for volunteer matches when they have logged the minimum number of hours to be eligible. To properly work with our enhanced Dollars for Doers, the proposal type must be linked to at least one log hours proposal type. 

Note: Learn more about how to Create New Employee Giving Proposal

Your program's proposal type should have the following elements configured: 

  • Proposal Type Template 
  • Program Options 
  • Gift Eligibility Date Ranges 
  • Organization Search 
  • Donor Rules 
  • Gift Rules 
  • Application Setup (Optional) 

Note: Nominations will be available for Dollars for Doers proposal types soon. This configuration guide will be updated accordingly. 

Instructions

Step One: Configure a Proposal Type

View Create an Employee Giving Proposal  or Update an Existing Proposal Type for step-by-step instructions to configure a Dollars for Doers proposal type for your Dollars for Doers program.

Note: You will need to ensure that the following settings are configured accordingly. 

When following the step-by-step instructions, configure the following options for your Dollars for Doers proposal type: 

  • In the Proposal Types list, click View Proposal Types. 
  • In the Proposal Types column, click the hyperlink for a Dollars for Doers proposal type. 
Step Two: Configure Program Options

View Configure Program Options for step-by-step instructions to configure your program options.  

Note: You will need to ensure that the following settings are configured accordingly. 

When following the step-by-step instructions, configure the following settings for your Dollars for Doers program options: 

  • In the Nature of Program dropdown menu, select Individual Dollar/Hour Contributions, Journaling, Event Sign-Up. 
  • In the Transaction Unit dropdown menu, select Hour. 
  • In the Match Configuration dropdown menu, select Match Based on Hours Volunteered. 

Note: Other selections will not affect functionality. 

  • Select the Does This Program include a Donor Module Component? checkbox.

Note: This box allows the proposal type to accept applications in the donor portal. This will be changed to a Yes or No field soon. 

  • In the Parent Program Name select menu, choose the appropriate Log Hours proposal type(s). The Log Hours proposal type selected will be used to record volunteer hours eligible for grant applications. (see Figure 1.) 

Note: If you do not see the Parent Program Name select menu, then you will need to click the Save button and refresh your browser. The Parent Program Name select menu will only appear if the Transaction Unit is set to Hours. 

idk.png

Figure 1 Selecting Log Hours Proposal Types 

  • In the Dollars for Doers Configuration Options dropdown menu, select the option that reflects how volunteer hours will be evaluated and how employees will select organizations for grants. (see Figure 2.) 

 idkidk.png

Figure 2 Dollars for Doers Configuration Options 

Note: The Dollars for Doers Configuration Options dropdown menu will only display if the proposal type's Match Configuration is set to Match Based on Hours Volunteered and a Parent Program Name is selected. View the table below for a description of each available option. 

 List Item

 Description

Hours specific to org/apply to org volunteered with 

The employee must log a minimum number of hours and can only redeem a grant to the organization they volunteered with and met the minimum with. 

Hours pooled/apply to any org volunteered with 

The employee must log the minimum number of hours combined across all the organizations they volunteered with. The employee can then redeem a match for any organizations they volunteered with. 

Hours pooled/apply to any eligible org 

The employee must log the minimum number of hours combined across all the organizations they volunteered with. The employee can then redeem a match for any of the organizations they volunteered with OR Search for an organization that is eligible for the Dollars for Doers program. 

 

Step Three: Configure Gift Eligibility Date Ranges

View Configure Gift Eligibility Date Ranges for step-by-step instructions to configure Gift Eligibility Ranges for your program. 

Note: You will need to ensure that the following settings are configured accordingly.

When following the step-by-step instructions, configure the following fields accordingly: 

  • Verify the Gift Eligibility Date Ranges are correct for your program. This is used to calculate the current year.  
  • In the Creation Date Range column, enter a start date to determine the date eligible employees can begin redeeming a volunteer match. 
  • In the Creation Date Range column, enter an end date to determine the program's closing date and employees can no longer redeem a volunteer match. 
  • In the Gift Date Range, enter a start and end date. The Gift Date Range column should be configured with the same values as the Creation Date Range column. 

idkidkidk.png 

Figure 3 Dollars for Doers Gift Eligibility Date Ranges 

Note: Gift Eligibility Date Ranges are required for proposal types to function properly and should include both Creation date and Gift date ranges. 

To see examples of what Gift Eligibility Date Ranges can look like for Dollars for Doers proposal types, view the Dollars for Doers Proposal Type Gift Eligibility Date Examples.    

Step Four: Configure an Organization Search 

When configuring Organization Search results, you will need to ensure that you also configure its search result visibility. 

View Configure an Organization Search and Configure Organization Search Result Visibility for step-by-step instructions to configure your program options.  

Note: For Dollars for Doers programs, the organization search configuration affects which organizations will appear in the Organization Search panel when redeeming a volunteer match (see Figure 4.) 

idkidkidkkdikdi.png 

Figure 4 Search results showing eligible and ineligible organizations 

Configuring Search Result Visibility Settings 

For Dollars for Doers programs, the visibility settings affect the display of organizations available for selection on the Dollars for Doers when redeeming a volunteer match and the experience when using the Organization Search functionality. View the table below for examples of visibility settings. 

 

Search Result Display Settings

When the organization is Pending the Proposal Type
What the employee will see in the Dollars for Doers modal
What the employee will see in Organization Search

Not Visible

 

Employee will not be able to select this organization to direct their volunteer match to

hfuidhgvjnks.png

hbuijkdfnagaejkr1.2.png

Only approved organizations will display

Visible; Nomination Allowed Only

Employee can nominate the organization and if approved be able to direct a volunteer match to

bvfdjsunkJAHEnrdf2.png

jiegrdhnser2.2.png

Approved organizations can be selected; others require nomination

Visible; May be selected for applicationEmployee can proceed forward with redeeming a volunteer match, nomination not required

nhgvhihaerdfiu_sk3.png

jgdhfgberdnfjk3.3.png

All organizations can be selected

 

Step Five: Configure Donor Rules

View Create or Edit Donor Rules for step-by-step instructions to configure Donor Rules for your program. 

When following the step-by-step instructions, configure the following settings for your Dollars for Doers Donor Rules: 

  1. In the Proposal Types section, click View Proposal Types.
  2. Click on the Dollars for Doers proposal type (naming is specific to each client but may be named Volunteer Grant.)
  3. Complete Donor Rule Name, Active, Eligible, Non-Rejected Match Amount, Non-Rejected Transactions, Transactions, Scope, Total Match Limit, Total Transaction Limit.

Ensure:

  • Rules have an eligible rule and a corresponding ineligible rule. 
  • Organization Unmatched Hours directly relate to the gift rules for the lower and upper gift limits.
  • Total Match Limits are configured for Donor or Gift rules need to be on both.

Note: Donor Rules may already be configured; however, you must verify that they are correct. 

Learn more about Donor Rules.

To see examples of what Donor Rules can look like for Dollars for Doers, view Dollars for Doers Donor Rule Examples.

Step Six: Configure Gift Rules

For Dollars for Doers, gift rules control what can be submitted in the donor portal by an employee when submitting a volunteer match. 

View Create or Edit Gift Rules for step-by-step instructions to configure Gift Rules for your program. 

Note: You will need to ensure that you select the Dollars for Doers proposal type before navigating to the proposal’s Gift Rules. 

Learn more about Gift Rules.

To see examples of what common gift rule scenarios can look like for Dollars for Doers, view Dollars for Doers Gift Rule Examples.

Step Seven: Configure an Application 

If applicable, View Configure an Application Form for step-by-step instructions to configure an Application Form for your program. 

Note: Ensure that you select an existing Dollars for Doers proposal type. 

Back to Top

Part Three: Configure Approval Workflows and Types 

All Dollars for Doers proposal types must have approval workflows and types configured. Workflow settings may vary and depend on your company's business processes. 

Instructions

Step One: Configure Workflow Approval Types 
View Configure a Workflow Approval Type for step-by-step instructions to configure approval types for your program's workflow. 
Step Two: Configure an Approval Workflows
View Configure an Approval Workflow for step-by-step instructions to configure approval workflows for your program. 

Back to Top

Part Four: Configure a Dollars for Doers Portlet

Instructions

General Configuration

View Dollars for Doers Portlet Overview to learn more about Dollars for Doers portlets. 

View Create a New Portlet or Update an Existing Portlet for step-by-step instructions to configure a portlet for your Dollars for Doers program. 

Note: Advanced configuration options for the Dollars for Doers portlet allowing you to control portlet visibility by these donor's attributes:

  • Company ID
  • Donor Country
  • Donor State
  • Employee Type
  • User Role

Configure the portlet as determined by your business process. The following section provides visual representations of the areas affected by available configuration settings. Each setting has been assigned a number that correlates with the image.  

Note: You will need to ensure that the following settings are configured accordingly.  

When following the step-by-step instructions, configure the following settings for your Dollars for Doers program: 

  • In the Donor Portal section, click View/Edit Portlets 

Note: Be sure that you select an existing Dollars for Doers portlet.

  • In the Matching Grant Proposal Type field, select the correct Dollars for Doers proposal type for your program. 
  • Optional configuration: 
  • Title field 
  • Introduction Text field 
  • Footer Text field 
  • Any buttons 
  • Learn More field 

For step-by-step instructions to configure program guidelines and the Learn More hyperlink, view Configure a Learn More Hyperlink for Dollars for Doers Portlets.

For Clients with Existing Dollars for Doers Programs

When the client transitions to the new Dollars for Doers, these steps should be taken immediately following: 

  • Suppress the Dollars for Doers title, as appropriate.  

Note: The title will be visible if it is not suppressed. 

  • Update Introduction text, as appropriate. A 300-character maximum is recommended. 

Note: If the Introduction Text field is populated, it will be visible to end-users. 

  • Update Footer text, as appropriate. 

Note: If the Footer Text field is populated, it will display to end-users. 

  • Update Titles, as appropriate. A 65-character maximum is recommended. 

Note: If no titles are provided, titles will default to CyberGrants’ standard content. 

  • Update button labels, as appropriate.  

Note: If no button labels are provided, text will default to CyberGrants’ standard content. 

  • Add a Learn More hyperlink, as appropriate.  
Note: For step-by-step configuration instructions, view Configure a Learn More Hyperlink for Dollars for Doers Portlets.

Back to Top

Part Five: Configure a Log Hours Portlet (Optional) 

Instructions

General Configuration 

View Update an Existing Portlet for step-by-step instructions to configure a Log Hours portlet for your Dollars for Doers program. Learn more about the Log Hours Portlet and Log Hours button.

When following the step-by-step instructions, configure the following settings when configuring a Log Hours Portlet program: 

Note: You will need to ensure that the following settings are configured accordingly. 
  • For the Program Selection Type setting, select Program Type Selection (see Figure 5.) 
  • In the Unused column, select the appropriate Log Hours proposal type. 

lol.png

Figure 5 Program Type and Content Selection 

Note: Each Log Hours proposal type can have its own portlet. If more than one Log Hours proposal type is configured for a portlet, a proposal type picker will be displayed.  

Back to Top

Part Six: Add Portlets to a Portal Page (If Applicable) 

Instructions

General Configuration 

If the selected portlet does not already exist on a portal page, it will need to be added to a portal page. 

View Add a Portlet to a Portal Page for step-by-step instructions for adding portlets to a portal page. 

Back to Top


Powered by