Troubleshooting eCommerce issues

    This article has been ported to Troubleshooting eCommerce issues

    This article provides an overview of some issues you may encounter in your online store. Each section includes recommendations to resolve the unexpected behaviors.

     

    Issue:A blank page is presented to the customer during the checkout process after submitting a registration form.

     


    Reason: This happens when the the registration form's action URL contains an absolute path. You have to always make that link relative.

     

    Solution: Locate the HTML code that looks like the code below:

     

     

    and change it to

     

    <form method="post" action="/FormProcessv2.aspx?WebFormID=10812.....      


    Issue:The Checkout feature creates a quote instead of purchase.


    Reason: This may occur if you place the registration form into the layout of the module instead of in the HTML code.

     

    Solution: Make sure the form is located inside the layout in the form of HTML, and not in the module layout.

     

    Issue: Missing or inactive products in an online store.


    Reason: If you've recently imported products and they are not displaying because they are inactive, it is likely due to the settings for their release date and expiration date. If the release date is set to some future date, or if the expiration date is set in the past, the product will automatically be set to inactive.

     

    Solution: Access the product details and check the release date and the expiration date. Adjust if needed.

    Issue: Duplicate products appear in the search results.


    Reason: If you find yourself with duplicate products appearing in search results, the issue is most likely that you are using the                product grouping functionality.

     

    Solution: Access each group of products and choose the option to "Exclude from Search" all the products (with the exception of the default product).  You can access this option by clicking on the "Show more options" link.

     

     

    Issue: Products added to a catalog are not displaying.


    Reason: In the case that you have added products to your catalogs or directly to your web pages and they are not showing when you view them on your site, there are two main causes of this issue; the template you have applied to your catalogs is preventing the products from showing or you have grouped your products but they are not the default product in your groups.

     

    Solution: Check the template by going to admin > ecommerce > catalogs > choose the catalog. Check the setting in the Template menu, shown below:

     

     

    catalogtemplate.png

    To double-check that you are displaying the default product in your group, go to admin > ecommerce > products and then choose the product and the option to Group products Together. Verify the default product as shown below:

    grouping.png

    Issue: Images and CSS styling missing when viewing Catalog

    If the content in a  is not displaying as expected, it may be due to the path to a CSS style sheet and/or images. If the CSS style sheet isn't linked correctly, the  catalog may appear without any CSS rules, which causes it to look broken.

     

    This occurs because catalogs are stored at a different level (one folder level up) in the site's directory structure. Ifthe link to CSS files or images do not use the site root relative path (meaning that their paths do not start from root (/) level of the site) they will not be displayed.

     

    Here's some examples of links (to a CSS style sheet and an image) that are document relative, rather than site root relative:

     

    stylesheets/content_honey.css

    images/bg-menu.jpg

     

    To resolve the broken paths, you simply need to add a forward slash (/) to the beginning of the paths, as shown below:

     

    /stylesheets/content_honey.css

    /images/bg-menu.jpg

     

    After adding the forward slash before the links to CSS style sheets and images, and clicking Save and Publish, the catalog  page should display correctly.

    Issue: Getting erro "Catalog has no products" or "catalog has no subcatalogs"

     

    If you are seeing these errors presented, it is possible to eliminate these messages from appearing in an online store. To remove them, you need make some changes to {tag_cataloguelist} and {tag_productlist} in Admin > More Customization Options > Online Shopping Layouts > Overall Layout

     

    The following is the format for {tag_cataloguelist}:

     

    {tag_cataloguelist,rowLenght,targetFrame,resultsPerPage,sortType,hideEmptyMessage,useLi}

     

    • rowLength – Number of catalogues per row
    • targetFrame – e.g. _blank. Specify the frame you want the product to open in
    • resultsPerPage – The number of catalogs displayed on the page
    • sortType  
      • Alphabetical
      • Weight (Defaut)
    • hideEmptyMessage – if a catalogue does not have any sub-catalogues you will see a message “This catalogue has no sub-catalogues.”
    • useLi – will render <ul> & <li>’s instead of <table>’s.

     

    To hide the above message you need to set the last parameter to true.


    Here's an example:

     

    {tag_cataloguelist,4,,,Alphabetical,true}


    The {tag_productlist} follows the similar syntax to the catalog list tag:

     

    {tag_productlist,rowLenght,targetFrame,resultsPerPage,sortType,hideEmptyMessage,useLi}

     

    • rowLength – Number of products per row
    • targetFrame – e.g. _blank. Specify the frame you want the product to open in
    • resultsPerPage– Number of products per page (limit of 500 products per page)
    • sortType –  
      • Alphabetical
      • Price (Cheapest to most expensive)
      • Expiry Date (Newest to oldest)
      • Weight (Default)
    • hideEmptyMessage – if a catalogue does not have any products you will see a message “This catalog has no products.”
    • useLi – will render <ul> and <li>’s instead of <table>’s.

     

    So, to hide the above message you need to set the last parameter to true.

     

    Here's an example:

     

    {tag_productlist,4,,12,Alphabetical,true}