Smart-Thinker Referrals Module Configuration Guide
Version 04.03.01
Thank you
for trying the Smart-Thinker Referrals module. We hope you find it useful!
Overview
Please
ensure you have read and adhered to these instructions before contacting
support.
If you wish
to request a new feature, please you Feature
Requests.
If you have
found a bug, please raise a support issue by following these steps.
This module
guide was written for the configuration on PokerDIY
– a poker-related social networking site. Feel free to browse the site to see a
live, working example of a Referrals implementation (after Registration and on
the “Tell a Friend” page).
Key Information
- Tested on DotNetNuke 4.3.5+.
This version will not work on DotNetNuke 3.x – you can read more about it here.
- You can try a free trial on a
test DNN installation, but please adhere to our Licensing
Agreement.
- For a quick
breakdown of the controls and settings for this module please see our Forums.
Background
This module
is used as a typical “Tell a Friend” module. It can be customized via the module
settings to change the UI. You may want a single email address on the
“Registration Successful” page, and have 5 or more email addresses with a
customizable subject and message on a dedicated “Tell a Friend” page.
Licensing
As of
version 04.03.01, this module now has a Parent/Child portal limit check
depending on the License you have. Please see our Licensing
Agreement for more information if unsure.
Set up
This module
is very simple and only has one Module Definition. It has no database objects.
Add the
Smart-Thinker Referrals module to your website, and set up the Role rights on
who can see this module and hence send Referrals. This module can be used by
unauthenticated users to send mails (this may be abused by certain users).
You can
tweak the settings to change the display of this module to the user. You can
also allow Administrators to receive an email each time a referral is sent.
The Default
Subject and Message settings are used to suggest some text to the user. These
can be overridden by the user.
The Subject
and Body Templates are the actual messages sent to the referred user. The
parameters are replaced at runtime so dynamic messages can be constructed. For
example, if you wanted the user’s personal message to be included with some
text for your site, you might use:
Subject Template: “[FRIENDSNAME] [USERSUBJECT]”
Body Template:
“
Hi
[FRIENDSNAME]
Your friend [FIRSTNAME] [LASTNAME] thought you might like PokerDIY and wanted
to tell you:
"[USERMESSAGE]"
PokerDIY.com connects poker players and
provides free tools to manage online and live poker games or leagues.
“
This would
result in the following email:
“
Hi Rodney
Your friend Rodney Joyce thought you might like PokerDIY and wanted to tell
you:
"Have a look at this great website!"
PokerDIY.com connects poker players and
provides free tools to manage online and live poker games or leagues.
“
Customizations
Feel free
to customize the .ascx file to suit your requirements. You may want to change
the text on the button or add some blurb around it to explain to the user what
to expect. You could always add another HTML module next to it or modify the
footer or header for an easier result. The language strings can be edited in
the normal fashion using the core localization tools (Language Editor).
Check the Tips
and Tricks section for more integration and customization ideas.
Upgrading
This module
should upgrade from the 3.x version with no issues.
Uninstallation
This module
can be uninstalled in the normal manner.
Source
The source
for this module is in C# and was created in Visual Studio 2005 using the WAP
project model. Please see our licensing options for information on how to
obtain it.
If you have
any queries then please see the Overview
section of this document for more information.