# Donation Levels
To edit donation levels, click the Edit link under the Actions Column for Donation Form. Locate the necessary element in the left column that ends with Donation Level. Then select the option and then click on Save Order and Edit Selected.
# Dynamic Gift Array
This is the feature that allows the admins to configure the set of donation amounts the users will see based on the selected frequency.
This feature is controlled by the Label field in the 2. Level Setup: of the donation levels configuration screen.
Dynamic gift array relies on and accepts only the following keywords:
one-timerecurring- default value for all recurring gifts, use for monthly gifts on forms with multiple frequenciesquarterly- if more than one recurring option is presentyearly- if more than one recurring option is present
# One-Time Gifts
To allow the donation level to be visible when the one-time gift frequency is selected a keyword one-time must be set as a Label field.
# Recurring Gifts
To allow the donation level to be visible when the monthly, quarterly, or annual donation frequency is selected add the keyword recurring in the Label field.
# Multiple Frequencies
When more than one recurrence level is set on flexible donation levels, use quarterly & yearly for quarterly and annual options, but leave recurring for the monthly option. If the donation form has only one recurring frequency, use recurring value only.
For forms with flexible donation levels, the Luminate configuration will be used to set the default donation frequency. To set the donation frequency to go 3. Design Donor Screens > Edit the donation form > edit Flexible Sustainer Donation Level > set values in field 9.Pre-Selected Gift Type and corresponding amount in field 3. Pre-Selected level.
Because Luminate only allows the setting of Recurring or One-time, code will try to select the recurring frequency based on the pre-selected amount. For example, if the form supports monthly, quarterly, yearly, and one-time gifts and you want to select quarterly by default then:
- Set Recurring in the field 9.Pre-Selected Gift Type, note this is required, otherwise Luminate will not render the donation amount as selected
- And in 3. Pre-Selected level select the donation level that has quarterly label set in 2. Level Setup
- The code will see that the selected level is for the quarterly donation type and will select Quarterly donation frequency on the form
Example form with multiple frequencies (opens new window)
# Selected Amounts
The code will always give preference to the donation form configuration. When the donation amount is selected in Luminate, it should appear selected on the form. If the amount is not set correctly, verfiy that the default donation frequency was correctly configured.
See Multiple Frequencies section for now the selected amount can also select a donation frequency on some forms.
# Hiding Donation Levels
At times, the donation levels may need to be hidden at a specific resolution. There may also be a need to hide donation level for all users, for example when the amount for qualifying premium is lower than the provided amounts.
This feature is also controlled by the Label field in the 2. Level Setup: of the donation levels configuration screen.
Hiding of donation levels relies on and accepts only the following keywords:
hiddenhidden--desktophidden--mobilehidden--mobile-smallhidden--tablethidden--tablet-middlehidden--tablet-smallhidden--tablet-widehidden--under-desktophidden--under-tablet-wide
To hide the donation level at all resolutions add the keyword hidden in the Label field, and remove all other keywords.
To hide the donation level at a specific resolution, one or more of the classes below can be used. The following table provides exact details on which resolutions each class hides the content:
| CSS Classe | Hidden Resolution Sizes |
|---|---|
hidden--desktop | min-width: 960px |
hidden--mobile | max-width: 599px |
hidden--mobile-small | max-width: 479px |
hidden--tablet | min-width: 600px and max-width: 959px |
hidden--tablet-middle | min-width: 768px and max-width: 959px |
hidden--tablet-small | min-width: 600px and max-width: 799px |
hidden--tablet-wide | min-width: 800px and max-width: 959px |
hidden--under-desktop | max-width: 959px |
hidden--under-tablet-wide | max-width: 799px |
# Recurring Label & Submit Button Text
The default HTML for the gift buttons specified in reus_donation__gift_type_buttons contains a generic label Recurring. This has been done because a donation form can have various recurring frequencies. The value is changed dynamically with scripts based on the donation form configuration.
The values that populate this label are set in reus_content_catalog under the variable names donationFrequencyLabels. These values are also used to add the frequency suffix to the submit button.