RPOWER.Gift Server Configuration
RPOWER.Gift is an IIS Web Server module allowing gift cards to be ordered from a website.
- General Corporate Server Setup
- Remote Desktop (RDP) or Terminal Server configuration (if Microsoft Remote Desktop is used for remote control)
- Internet Information Services (IIS)
- Microsoft .NET Framework
- The RPOWER.Gift installation package (described in this article)
If you are using Remote Desktop, it is imperative that you click on the link above. Installation instructions for each of the other components can be found on their respective pages.
Installing the RPOWER Gift Module
This module can be downloaded from here. Extract the files to the C:\RPOWER.Central\RPOWER.Gift\Inetpub directory.
Control Panel\Administrative Tools\Computer Management. (If you are on Windows Server 2003, instead of navigating to Computer Management, you could navigate to
Control Panel\Administrative Tools\IIS. I will be giving instructions on setting up a Virtual Directory through Computer Management, but the directions should be the same in the IIS control panel.)
Services and Applications and then
Internet Information Service and then
Web Sites. You should now see a
Default Web Site in the list. Right-click
Default Web Site and select
New | Virtual Directory... You will be presented with the Virtual Directory Creation Wizard. Click Next.
- You will be asked for an alias for the virtual directory. Enter giftcards. Click Next.
- You will be asked to specify the directory providing content for this virtual directory. Browse to the location of the RPOWER Reports module. Click Next.
- You will now be presented with a dialog asking about access permissions. You want the permissions
Run scripts (such as ASP). Click Next.
- Click Finish.
- (Server 2003 only) Under IIS, there is another item called
Web Extension Services. Click this and navigate through the list of services until you get to
ASP.NET. Click the
Allowlink. By default, Windows Server 2003 does not enable ASP.NET services. If you don't do this step, the reports website will throw a 404 error.
Configuring the Virtual Directory
If you double-click
Default Web Site, you should see a reports directory in the list of items under
Default Web Site. Right-click
reports and select
Properties. You will see a tabbed dialog.
- Virtual Directory tab. Check the values, ensure the path is correct and the Permissions are set up for Read, Log visits, and Index this resource. In
Application Settings, click the Configuration button. Ensure that you see aspx and asp in the
Application Extensionslist. If they are not there, this typically means that IIS was installed after the .NET Framework was installed. If this is the case, uninstall and then reinstall the .NET Framework before continuing. Click Cancel. Set the
Application Nameto Default Application. Set
Execute Permissionsto Scripts Only, and ensure that the
Application Poolis set to DefaultAppPool.
- Documents tab. Add SenderPage.aspx to the
Default Content Pagelist. If you want, you can remove the other entries from the list since they will never be used.
- ASP.NET tab. If you have multiple versions of the .NET Framework installed on this computer, you will see this tab. Check that is is set to 2.0.50727. If all you have installed is .NET Framework 3.5, you do not have to select the version of the .NET Framework to use.
Testing the Installation
The easiest way to test the installation is to right-click on the virtual directory and select Browse. The website should start up. You can also test from another machine by appending '/reports' (sans quotes) to the IP address or computer name (ex: http://192.168.0.1/reports).
Setting up User Permissions
Navigate back to C:\Inetpub\wwwroot\Web_Reports and right-click. Select
Properties. On the multi-tab dialog that appears, select the Security tab. You will want to check the Group or user names listbox and look for the NETWORK SERVICE, NETWORK, and INTERACTIVE users. If they do not appear in the Group or user names listbox, then click Add.... On the Select Users or Groups dialog click Advanced... button, and then click Find Now. Double-click NETWORK SERVICE and check the
Full Control checkbox. Repeat for the NETWORK and the INTERACTIVE users.
Installing a New Card Number File
In the C:\RPOWER.Central\RPOWER.Gift\Inetpub\card number files folder, there is a file called cards.fp1. The cards.fp1 file distributed with RPOWER.Gift is a file containing test gift card numbers. A new cards.fp1 file needs to be generated after the client obtains his gift cards, and should be copied or pasted into the card number files directory.
Setting Up Credit Card Validation
In the C:\RPOWER.Central\RPOWER.Gift\Inetpub\ini directory, you will find a file called
giftcard.ini. Open that file in Notepad, and navigate down to the [sites] section. In that section you should see a line
Set onlineorderserver to the IP Address (local or public) of the local gift card server. The local gift card server is an installation of RPOWER that will validate credit card numbers. An example:
Make sure you include the port as in the example above.
Setting Up Email
RPOWER.Gift has the ability to email multiple email addresses when an order is taken.
To set up Email Alerts, navigate to C:\RPOWER.Central\RPOWER.Gift\Inetpub\ini. Open the
giftcard.ini file and look for
[orderemail] ;use email tells the web site whether to send email. If this value ;is set to 'yes', the web site will read the other settings in this section so it ;can send email. ;If set to 'no', it will not and email will not be sent. useemail=yes email@example.com fromsmtp=smtp.rpower.com ;to specify multiple recipients separate the recipient's email addresses ;with | ex: firstname.lastname@example.org|blah2.blah.com email@example.com
If you want the email sent to someone other than the default email address, look for
firstname.lastname@example.org. Change the email address there to the one you want the Email Alerts sent to. If you want to send the Email Alerts to more than one email address, you can append addresses to that line by using a |. Example:
Save the file and close it.
Setting up Shipping Options
RPOWER.Gift gives you the ability to set up per card shipping fees or flat shipping fees. To set them up, navigate to C:\RPOWER.Central\RPOWER.Gift\Inetpub\ini and find the
shipping.ini file. Open this file in notepad. If you haven't made any changes yet, you should see the default charges:
[Preferences] Standard US Mail=1.20|P 3 Day US Mail=6.03|F 2 Day US Mail=8.50|F Overnight=14.00|F
The first portion is what the user sees in the Shipping Method dropdownlist on the Recipient.aspx page. The number after the equal sign is the amount to charge. The letter appearing after the | designates a per card fee (P) or a flat fee (F). As long as each line has these three elements, you can change any line or add charges of your own.
Setting customer information
If the RPOWER.Gift website is being embedded into a web page, you can set the customer information by sending a query string along with the url.
The query string keys are:
n = name
co = company
a1 = address line 1
a2 = address line 2
ci = city
z = zip code
s = state
p = phone number
ex = extension
em = email
Setting values for the above keys will populate the Sender.aspx page with customer information.