RPOWER.Gift Server Configuration

From RPOWERWiki

Jump to: navigation, search

RPOWER.Gift is an IIS Web Server module allowing gift cards to be ordered from a website.

Contents

Required Components

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.

Configuring IIS

Navigate to 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.)

Double-click 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 Read and 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 Allow link. 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 Extensions list. 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 Name to Default Application. Set Execute Permissions to Scripts Only, and ensure that the Application Pool is set to DefaultAppPool.
  • Documents tab. Add SenderPage.aspx to the Default Content Page list. 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

 onlineorderserver=

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:

onlineorderserver=localhost:32112

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
 fromemail=rpower.site@rpower.com
 fromsmtp=smtp.rpower.com
 ;to specify multiple recipients separate the recipient's email addresses
 ;with | ex: blah@blah.com|blah2.blah.com
 toemail=ted.fischer@rpower.com

If you want the email sent to someone other than the default email address, look for toemail=ted.fischer@rpower.com. 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:

 toemail=moe@moe.com|larry@larry.com|curly@curly.com

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.

Views
Personal tools