Looking for the v10 manual? Visit our new user's guide!
 
Search Descriptions Version
 
 
This article applies to:

ML8 SingleFeed Integration Installation Instructions & User Guide


Introduction

Thank you for purchasing the SingleFeed integration.

SingleFeed works by taking a single product feed from your AspDotNetStorefront store then rebuilding it into dozens of individual feeds, each one optimized for an individual comparison shopping engine.

SingleFeed requires the following product fields to be filled out for each product in the feed:
  • Unique SKU
  • Name
  • Description
  • Price
  • Image
  • Category
  • Manufacturer
SingleFeed might have problems with some of the data in your product feed. If so, SingleFeed’s error reporting will alert you to the problem. Please see the appendix at the end of this document for resources.

Installation

Follow these instructions to install and your SingleFeed:

1. You will receive an email with a download link to obtain your files.
2. Download the file feed.singlefeed.xml.config to your desktop.
3. Locate the feed.singlefeed.xml.config file on your desktop.
4. Use an FTP program and copy feed.singlefeed.xml.config to “YOURSITE/xmlpackages/.”
There are many free FTP clients available, we recommend Filezilla which can be found at: http://filezilla-project.org/
5. Using FTP, navigate to “YOURSITE/App_Code/” and locate and download “ASPDNSFHandlers.cs.”
6. Open ASPDNSFHandlers.cs in a text editor.
7. Make a backup copy of ASPDNSFHandlers.cs and save it somewhere safe.
8. Replace the following line in ASPDNSFHandlers.cs :

“context.Response.AddHeader("Content-Length", output.Length.ToString());”

With

“//context.Response.AddHeader("Content-Length", output.Length.ToString());”

The code should be located between line 100 and line 120 depending on AspDotNetStorefront version.

9. Save ASPNDSFHandlers.cs and upload it via FTP to “YOURSITE/App_Code /”.
10. Activate your installed SingleFeed feed by navigating to the following location with your browser:
http://YOURSITE/x-feed.singlefeed.aspx?.csv
If successful, this will load and display your product feed on the screen. 11. Login to the admin console of the site and click “Reset Cache.” This button is in the upper right corner of any admin screen.

To test if your feed was installed correctly:

1. Visit: http://YOURSITE/x-feed.singlefeed.aspx?.csv

a. It should list all of your products and all the product info in a long text file

2. Log in to your site’s admin console and navigate to: Configuration > Advanced > AppConfig Parameters

a. Use the AppConfig Search and search for the term “SingleFeed”
b. You should see six AppConfigs titles:

i. SingleFeed.AcceptedPayments
ii. SingleFeed.ProductsCondition
iii. SingleFeed.ShippingCost
iv. SingleFeed.ShippingService
v. SingleFeed.UseSizes
vi. SingleFeed.UseColors

If you see both the text list of your products, and the six SingleFeed AppConfigs, SingleFeed is properly installed.

Configuration

  • To customize your SingleFeed, you will need to modify some AppConfig settings. The appendix of this document lists all of the AspDotNetStorefront SingleFeed AppConfigs and describes how to use them.

    You can edit AppConfig settings by logging into the admin console of your store front and clicking Configuration > Advanced > AppConfig Parameters

    To edit the SingleFeed AppConfig files, search for ‘SingleFeed’, select edit, follow the instructions in the appendix below and then select ‘Update’ when you are done.

  • Review the default settings for the AppConfigs listed in the “AppConfig Description” section. Configure as needed via your AspDotNetStorefront admin console.


  • Ensure all the products you want included in the feed have “Exclude From Product Feeds” set to “No” and ensure that all products you don’t want included in the feed are set to “Yes”. This setting can be found on a products “Main” tab when editing a product.

Setting up your SingleFeed account

Set up a SingleFeed account to download the feed from your site.

1. Create an account at SingleFeed.com. https://www.singlefeed.com/
2. When you log into your singlefeed account, go to the “Manage your Products” screen and click the “Upload Product Feed” button.
3. Click on “http” and in the “HTTP URL(incl. filename):” field type in the url to the feed file (www.YOURSITE/x-feed.singlefeed.aspx?.csv ) and click “Start Upload”.

SingleFeed will download and process the data file, and will present a report on any errors that are found in the data feed.

Congratulations! You have successfully installed, configured, and set up your SingleFeed.

Appendix: AppConfig Parameters

Below is a list of the AppConfig Parameters that are installed with your SingleFeed. You can access them through the admin console of your website by clicking on Configuration > Advanced > AppConfig Parameters.

SingleFeed.ProductsCondition If this value is not empty it will be shown as the condition of all the products in the SingleFeed.
SingleFeed.AcceptedPayments A comma separated list of payments your store will accept. E.g. "Cash, Discover, Visa".
SingleFeed.ShippingCost ONLY USE FOR STORES WITH FLAT SHIPPING RATES. If this field is filled in the store will pass its value as a shipping estimate for every item on SingleFeed.
SingleFeed.ShippingService This AppConfig will only be used if SingleFeed.ShippingCost is enabled. It is the corresponding service for the quoted price. e.g. "Ground".
SingleFeed.UseSizes Use this AppConfig to control the use of the sizes field for the SingleFeed data file. "true" writes the AspDotNetStorefront Size options out in a comma delimited string.
SingleFeed.UseColors Use this AppConfig to control the use of the colors field for the SingleFeed data file. "true" writes the AspDotNetStorefront Color options out in a comma delimited string.

Common problems with data

Please note that SingleFeed might not properly render feeds that contain special characters, HTML formatting, or otherwise exceed SingleFeed limitations.

Special characters include symbols like the Copyright symbol and the Trade Mark TM, among others. HTML formatting includes all formatting entered in the product description fields.

Additional feed data issues are covered in SingleFeed’s online help:

http://support.singlefeed.com/forums/172716-getting-started

Support

If you have further questions or comments, please feel free to contact our help desk.