Revindex Storefront v1.1

Introduction

Revindex Storefront is one of the most flexible shopping cart software for the DotNetNuke platform. It's powerful enough for large enterprises supporting over 60,000 products and unlimited orders, yet simple to manage for small businesses - start selling in just a few steps. Revindex Storefront complies fully with industry credit card PCI rules using military grade encryption and validation to protect your customer information. We support all major payment gateways. If you don't find a suitable payment gateway, please contact us and we'll add it.

Requirements

• DotNetNuke 5.x
• .NET 3.5 with Full trust level
• DBO owner and no object qualifier
• SQL Server 2005 and above
• SSL Certificate
• SQL or session state service if running in a Web farm.

Installation

Make sure to perform a complete backup of your system before performing the following steps.

1. On your web site, login as "Host" and go to Host > Extensioms. Click on Install Extension Wizard.

2. Upload the Revindex.Dnn.RevindexStorefront.zip  package and follow the install wizard instruction. By default, ASP.NET restricts the file upload to a maximum size of 8MB. Increase the maxRequestLength and requestLengthDiskThreshold values of the httpRuntime node in your application web.config if the upload times out.

3. Create the following pages to host the Revindex Storefront modules. You may give a different page name. For illustration purposes, we'll refer to the same names given below throughout this guide.

4. Add the new module RevindexStorefront to the Storefront page. The RevindexStorefront module creates several modules at the same time on the page.

5. Move the individual modules on the Storefront page to the pages previously created. As you become familiar with the application, you can rearrange the modules to different parts of your site. To move a module, go to Settings from the Action dropdown menu on each module that you want to move. Expand the Page Settings > Advanced Settings and choose the appropriate page under the Move to Page list.

6. Go to Host > Host Settings and expand Performance Settings. Click on Clear cache to complete the installation.

Configuring the Storefront

The Storefront page you created hosts the main RevindexStorefront administration module where you can perform configuration changes, manage products and orders.

License Key

If you purchased or received a license for use, you'll need to enter it into the software. Login as Host and go to the Storefront page you created. Under Configuration > License menu, enter the license key you received.

Quick Start Settings

Your shopping cart is pre-configured with default values suitable for most businesses. In most cases, you only need to configure these few settings from the Configuration > Settings menu to start selling: General.StoreName, General.Email.Sender, General.Email.Recipient and Security.EncryptionKey

You also need to configure your payment methods. Enable or disable the appropriate PaymentMethods.* settings. For credit card and Paypal payment methods, you need to provide the appropriate values under PaymentGateways.* for your respective payment gateway provider.

Complete List of Settings

Tax Classes

Revindex Storefront supports almost every tax rule possible (e.g. charge different tax rate based on country, state, city, amount, quantity, product, etc.). You can define individual tax classes from the Configuration > Taxes menu. Click Add New... then provide a name (e.g. "Goods") and a tax formula. Once the tax class has been added, you'll be able to assign products to this tax class (e.g. Clothing products can be assigned to the "Goods" tax class, while Shipping can be assigned to the "Services" tax class and taxed at a different rate).

The tax formula uses powerful XSL transform. In the simplest case, you can copy the examples below and modify the numeric values without knowing XSL syntax. If you want to use custom logic (e.g. charge tax rate based on location and purchased price), you can employ full XSL syntax to output the tax calculation. To learn more about writing XSL formula, please read the XSL Transform section.

The system expects the following output after applying your tax formula against the sample input. Tax formula is calculated individually against each sales order detail with a product assigned to this tax class. The current sales order detail information is available in the "in/salesOrder/effectiveSalesOrderDetail" node. Up to 4 tax amounts can be returned for each formula allowing you to break down and charge different tax rates by country, state, city and municipal level if needed. The sum of the individual tax amounts is what the customer will pay in taxes.
 

The look-and-feel of public facing modules can be customized per portal from the Configuration > Templates menu. For example, you can customize the look-and-feel of the Product Detail module allowing you to change the layout, color, font, css style and even add text and images. You can also hide dynamic items by adding the "Visible="false"" attribute to the <asp:Control> tags (e.g. Adding Visible="false" to the label tag <asp:Label ID="SavingsValueLabel" runat="server" CssClass="NormalRed" Visible="false"> will hide the savings label from displaying to the user.)

Start by selecting "Create New Template" in the radio button. Then choose the module you wish to customize. You now need to choose a base Display Template as a starting point (e.g. "Standard1") and give your new custom template a meaningful name. Make the HTML changes needed to your new template and click Save Template. Your new custom template is now ready to be used. For example, if you created a new custom template for the Product Detail module, you can configure your individual product to use this new custom template instead of the default template.

Because you have full HTML control over your custom templates, please note that custom templates may become broken if you accidentally delete dynamic controls or as result of incompatibility with new software version upgrades. If such a case happens, you simply need to recreate your custom template. The base templates, on the other hand, can never be edited and are safe from user changes.

Categories

Categories allow you to group the products for sale making it easier for your users to browse your shopping cart. Revindex Storefront support unlimited number of multi-level categories. Individual product can be assigned to one or multiple categories. You can add new categories from the Catalog > Categories menu. Click Add New... to create a new category and give it a name. Select if this new category has a parent category to create a multi-level category tree. Click Save Category when done.

Distributors

If you source your products from distributors, you can keep track of them by creating a distributor entry in the system from the Catalog > Distributors menu. Click Add New... and give it a name. Click Save Distributor when done. You can now assign this new distributor to your indiviual products.

Manufacturers

You can keep track of manufacturers of your product by creating a manufacturer entry in the system from the Catalog > Manufacturers menu. Click Add New... and give it a name. Click Save Manufacturer when done. You can now assign this new manufacturer to your indiviual products.

Product Management

Add new products from the Catalog > Products menu. Click Add New... and fill the required information. Variants are variations of products. For example, if you sell the DVD movie product "Titanic", you may also it in video casette format.  In most cases, you will only have one variant per product


Orders


Recurring Orders


- Orders
- Recurring Orders
- Public Categories
- Public Product List
- Public Product Detail
- Public Cart
- Public Checkout
- Public COnfirmation
- Public Manage Address
- Public Manage Payment
- Public Manage Orders
- Public Manage Product Download
- Default control in multiple control scenario


Uninstallation

Make sure to perform a complete backup of your system before performing the following steps.

1. Go to Host > Extensions and uninstall "RevindexStorefront". It's recommended to keep files on the system by leaving the "Delete Files" checkbox unchecked.

2. Go to Host > Schedule and remove "RevindexStorefront.SalesOrderScheduler" item.

3. It's not necessary to delete module files. Leaving module files on the system will not consume memory or CPU when unused. Deleting library files may affect other modules that rely on any shared assemblies. The following files may be deleted if absolutely necessary: 

bin\Revindex.*.dll
DesktopModules\Revindex.Dnn.RevindexStorefront\*



Shopping Cart Flow

The typical checkout flow consists of the following steps. The flow determines how and when various price, discount, shipping and tax calculations are performed base on the available data collected from the user (e.g. Shipping cost can only be calculated after user supplies his shipping address during checkout. Similarly, taxes can only be calculated after user supplies his billing address).