Selling donation items
E-Commerce module can be configured to sell donation items. A single $0 donation item is used in combination with various fixed price modifiers to set the amount of the donation. An additional modifier is configured that allows direct pricing so that the donor can set any amount for his donation.
The following site config file setting is used to set the main $0 donation item and to trigger the appropriate controls to display on ItemShow.aspx when that item is selected so that the donation functionality works:
Site Admin Panel > Miscellaneous Settings > DonationDCIs value = MUSEUM DONATIONS DONATEITEM
When this item is selected and the ItemShow.aspx page loads, the following controls become active on the page: the direct pricing input section (described in the following sections), a check box to waive all benefits and designate the donation as 100% tax-deductible, a Special Notes field, a Tribute Acknowledgement Information section (which includes a dropdown for setting how the donation is being made), a Tribute field and Acknowledgement Name, Address and E-mail fields.
The site config and MiscTables.xml files can be configured as shown in the following sections to require a message and set the choices for the Message fields. This functionality can be used to allow the donation designation by the donor.
Site config file:
• Site Admin Panel > Item Settings > ItemMessageEnabled value = 1
• Site Admin Panel > Item Settings > ItemMessageUseDropDown value = 1
• Site Admin Panel > Item Settings > ItemMessageDDTable value = ItemMessageVal
• Site Admin Panel > Item Settings > ItemMessageRequired value = 1
MiscTables.xml file:
<ItemMessageVals>
<ItemMessageVal><value>1</value><text>*Where it is needed most*</text></ItemMessageVal>
<ItemMessageVal><value>2</value><text>Museum Annual Fund Drive</text></ItemMessageVal>
<ItemMessageVal><value>3</value><text>Special Programs</text></ItemMessageVal>
<ItemMessageVal><value>4</value><text>School of Art</text></ItemMessageVal>
</ItemMessageVals>
The additional modifier that allows direct pricing on the ItemShow.aspx page is specified using the following site config file setting:
Site Admin Panel > Miscellaneous Settings > DonationOtherModDCI value = MUSEUM DONATIONS OTHERAMT
When this modifier is selected, the direct pricing input section, which includes a text box and button, is activated on ItemShow.aspx − the text box is used to enter the desired donation amount and the button is used to apply that amount to the price of the donation.
The Tribute dropdown is populated using the following settings:
Site config file:
Site Admin Panel > Miscellaneous Settings > TributeDDTable value = Tribute
MiscTables.xml file:
<Tributes>
<Tribute> <value>1</value> <text>Select a tribute</text> </Tribute>
<Tribute> <value>2</value> <text>in Honor of</text> </Tribute>
<Tribute> <value>3</value> <text>in Memory of</text> </Tribute>
</Tributes>
As part of the donation functionality, E-Commerce module also includes the ability to review the information entered for the donation on the Checkout4.aspx page. This requires that the multi-page checkout process be enabled:
Site Admin Panel > Checkout Settings > CheckoutSteps value = 1