Table of Contents |
---|
...
Configuration Step | Setting Name | Value |
Print/View Vouchers in My Account | customersettings.hideprintvoucherstab | False = Enable Print/View Vouchers True = Disable Print/View Vouchers |
Install Banner Plugin HTML Widget | vouchersettings.showbanner | True = show the banner False= do not show banner |
Language Strings
...
Description
...
String resource (do not change)
...
Default Value
(can be customized)
...
Placement
...
My Vouchers
...
account.printvouchers
The Voucher feature with Aspenware Commerce is highly configurable with Language Strings. The following table contains all of the strings that are available for the various components of the voucher functionality. For more detail on these strings and screenshot examples, visit the Language Strings Library.
Description | String resource (do not change) | Default Value (can be customized) | |
---|---|---|---|
My Vouchers | account.printvouchers | Print Vouchers | |
My Vouchers | account.printvouchers.description | Vouchers assigned to members of your can be viewed and printed below. | |
My Vouchers | account.printvouchers.terms | Vouchers are non-refundable and non-transferable. | |
My Vouchers | account.novouchers | There are no vouchers on your account. | |
Page Banner | voucher.plugin.cta.text | GOT A BUDDY PASS? OR OTHER VOUCHER TO REDEEM? DO IT IN ONE CLICK HERE:Across the top of page beneath menu | |
Page Banner Input Box | voucher.plugin.input.text | YOUR VOUCHER NUMBERInside text entry box in banner | |
Voucher Popup | voucher.plugin.modalheader.text | Voucher ValidationTitle of voucher popup | |
Voucher Popup | voucher.plugin.validationwait.text | Please wait while we validate your voucher ID. | Appears within popup if validation is not immediate. |
Voucher Popup | voucher.plugin.validationsuccess.text | Voucher ID successfully verified. Click redeem to continue.Appears within popup once voucher ID successfully verified. | |
Voucher Popup | voucher.plugin.invalidcode.text | Voucher ID is invalid. | Appears within popup if ID is invalid or other error occurs. |
Voucher Popup | voucher.plugin.continuebutton.text | RedeemAppears within popup - button | |
Voucher Popup | voucher.plugin.button.label | confirm voucherAppears within banner- button | |
Voucher banner title text | voucher.plugin.cta.title | Have a voucher to redeem?Left side of voucher banner.? | |
Voucher banner content text | voucher.plugin.cta.text | Check your voucher ID and redeem here. | Second sentence in voucher banner. |
Product vouchers tab | account.myvouchers.productvoucherstab | My Product Vouchers1 | |
Other vouchers tab | account.myvouchers.othervoucherstab | My Other vouchers | 2 |
My vouchers subheader message | account.myvouchers.productvouchers.description | Find your vouchers and take action below. | 3 |
My vouchers description | account.printvouchers.description | 3- Same positioning on product and other vouchers tab | |
Print/view | account.myvoucher.title | %Guest%'s Vouchers | 4 |
My account column title | account.printvouchers | My Vouchers | 6 |
Email voucher popup message | account.myvouchers.emailpopup.sendvoucher | Enter an email address to send this voucher.7 | |
Email voucher popup text entry box | account.myvouchers.emailpopup.textentry | Email address | 8 |
Email voucher popup send button | account.myvouchers.emailpopup.send | Send9 | |
Print/View vouchers method | account.printvouchers.terms | Non-transferable. No cash value.19 | |
Voucher effective date (forthcoming) | account.myvouchers.effectivedate | Effective Date | 17 |
Voucher expiration date | account.myvouchers.expirationdate | Expiration Date18 | |
Email voucher popup success confirmation | account.myvouchers.emailpopup.success | Voucher successfully sent!12 | |
Email voucher popup success message | account.myvouchers.emailpopup.success.message | %recipient% will receive your voucher momentarily.13 | |
Email voucher popup fail message | account.myvouchers.emailpopup.fail | Unfortunately, we were unable to send your voucher. | 15 |
email voucher popup success continue/exit button | account.myvouchers.emailpopup.success.button | Ok14 | |
email voucher popup fail continue/exit button | account.myvouchers.emailpopup.fail.button | Ok16 |
HTML Widgets
Voucher Banner Plugin HTML Widget
...
Info |
---|
NOTE: Once installed and made visible, administrators can enable and disable the banner via the voucher banner settings in “All Settings,” |
Go to Nop-Templates > Plugins > Html Widgets > Manage HTML Widgets
Click Add new Html Widget
Enter the following:
Name: Voucher (this name is customizable)
Visible: checked
HTML Content: Select Tools dropdown and select “<> Source Code”
Enter: <validate-code></validate-code>
Click Save.
Select Edit (on newly added plugin)
Select Widget Zones Tab
Click Add new record.
From Widget Zone drop-down select content_before.
Click Update.
Click Save.
2. Add Voucher Banner Styling HTML Widget
Although the voucher banner includes default styling from the site’s overall CSS, the following properties (all or any) can be optionally customized via the widget including banner background color, label weight, label size, button text color, button text size, button background color, and text weight.
Go to Nop-Templates > Plugins > Html Widgets > Manage
Select Add new Html widget and enter the following:
Name: Vouchers Styling (this name is customizable)
Visible: Checked
Html Content: Select Tools < Source Code
Within the text box popup you can add any of the above properties using the following formatting (bold text is configurable)
...
Info |
---|
NOTE: In order for vouchers from RTP|One to show in My Account, they must have a Report defined on the voucher type. |
Go to Configuration > Settings > All Settings (advanced) and search for the setting customersettings.hideprintvoucherstab in the name field.
Edit the setting, and change the Value to 'False; to enable Print/View Vouchers in My Account.
Change the Value to ‘True’ to disable Print/View Vouchers in My Account.
Language strings are available to customize the text on the My Vouchers page. See above in Settings, Language Strings, and HTML Widgets for details and specific strings.
...
Installing the voucher plugin is required for the use of voucher redemption. This will both allow the voucher banner to be displayed and show/enable the voucher widget on the product setup.
Go to Configuration > Local Plugins >
Select Aspenware Commerce from the Group drop-down list. Scroll down to Plugin info for Vouchers.
Ensure that both Installed and Is Enabled are checked.
Info |
---|
NOTE: If the voucher toolbar is missing, you can add this plugin-HTML widget by following the instructions found in the 2.12.5 Release Guide. |
...
Info |
---|
NOTE: Make sure you have retrieved the appropriate product voucher template ID from RTP|One (this should not be included on any other product). |
Go to Catalog > Products and click Add new. Enter the product details and click Save and Continue Edit. (If you have successfully installed the voucher plugin, there will be a new widget at the bottom of your product setup page named “Vouchers” as well as a new (automatically injected) voucher attribute. )
...
In the Vouchers section of the product page, enter the Voucher Template ID (from RTP|One) and click Add Voucher Template ID.
Aspenware Commerce will validate that the voucher template is not being used on any other Commerce product.
If you would like the voucher to be visible in My Account, make sure that visible is selected AND the appropriate instructions for displaying vouchers via RTP|One have been followed (i.e. a report has been added to the voucher type.)
Check and uncheck the My Account button options (to hide/display the presented buttons view/print, redeem, email.)
Click Save.
Check and uncheck the My Account button options to hide/display the presented buttons
After the Voucher Template ID has been saved, you should find a new attribute called “Voucher ID” on your product. You should not have to alter this. However, if you would like it to appear in a different area or order you may adjust this (e.g. adding [Dynamic] in the text prompt would place the voucher attribute into the dynamic component area on the PDP.) Verify that the voucher attribute has been added.
...