Announcement:Materials and articles for ProductCart 5 can be found at our brand new support center.

Create an account to edit articles | See Formatting Syntax for Wiki syntax | We look forward to your contribution!

ProductCart v4.7 Update Guide

The ProductCart v4.7 Update was made available on April 24, 2013. To download the v4.7 update (and to support the development of future updates!), please subscribe to the ProductCart Support & Updates Plan. Once your license is eligible for updates, you can download the updated files by logging into your Control Panel and selecting Help > Check for Updates.

A "Must Read"

Please READ THIS DOCUMENT CAREFULLY before updating your ProductCart-powered store.

  • A list of “To Do Items” is enclosed below. Make sure to review it and make the necessary changes.
  • Downloading the 4.7 Update files using the Check for Updates feature is not enough to successfully update your store.
  • That's because:
    • Your ProductCart-powered store may be running add-on's and special files that require additional steps
    • Some files that you have very likely customized will be overwritten (e.g. includes/languages.asp and pc/pcStorefront.css)
      Synchronize them with your version before uploading them to your store.

At the bottom of this page you can find a list of the main changes/fixed. Over 200 items (new features, improvements, bug fixes) were logged in our tracking system with regard to v4.7 of our shopping cart software. Some of the changes will not be visible to you in terms of new features, but you'll notice them as you use your updated ProductCart-powered store.

We hope you will enjoy version 4.7!

Applicability

You should be running v4.6 (any version) to update to version v4.7. Specifically, the v4.7 update contains files that were created or updated after 04.25.2012.

Backing Up Your Store

Make sure that you back-up your store before proceeding. This is a crucial step of the store update process: if something goes wrong, for any reason, you will be able to restore your previous installation.

To Do Items

Please see the list below to locate all the items that you need to download and install. A Legend below includes descriptions for the abbreviations used in the following table.

You are using… What you need to download and FTP to your server… How to get the files…
Main ProductCart file set
STD 4.7 Update from UMS Check for updates in the CP
BTO 4.7 Update from UMS Check for updates in the CP
STD + APP 4.7 Update from UMS Check for updates in the CP
BTO + APP 4.7 Update from UMS Check for updates in the CP
STD + M 4.7 Update from UMS Check for updates in the CP
BTO + M 4.7 Update from UMS Check for updates in the CP
STD + APP + M 4.7 Update from UMS Check for updates in the CP
BTO + APP + M 4.7 Update from UMS Check for updates in the CP
BTO + CM 4.7 Update from UMS Check for updates in the CP
BTO + APP + CM 4.7 Update from UMS Check for updates in the CP
BTO + CM + M 4.7 Update from UMS Check for updates in the CP
BTO + APP + CM + M 4.7 Update from UMS Check for updates in the CP
Other Add-on's and files
Google Analytics Now built into ProductCart (see updated docs) Update store settings after updating to v4.7
MailUp Now built into ProductCart Can be turned On/Off
eBay Add-on No specific update needed for version 4.7.
QuickBooks Add-on No specific update needed for version 4.7



Check For Updates is available in the Control Panel under Help.

Legend

  • STD = ProductCart standard version
  • BTO = ProductCart Build To Order version
  • APP = Apparel Add-on for ProductCart
  • CM = Conflict Management Add-on for ProductCart
  • M = Mobile Commerce Add-on for ProductCart
  • eBay = eBay Add-on for ProductCart
  • QBK = QuickBooks Add-on for ProductCart
  • UMS = Update Management System
    This is the system that you access via the Check for Updates feature in your Control Panel. The system detects which version you are running and delivers the correct file.

Downloading the Update File

Depending on the version of ProductCart that you are using (Standard vs. Build To Order) and on the add-on's installed on your store, the Update Management System will prompt you to download the correct file. NOTE: if you receive a message indicating that your license is not eligible for updates, that's because your subscription to the Support & Updates Plan might have expired.

Double-checking the Downloaded File Name

You can double-check that you are indeed downloading the correct file by checking the file name against the following information.

  • If you are running the STANDARD version of ProductCart, the file that you downloaded should be named: ProductCart_v4.7_Update_date
  • If you are running the BUILD TO ORDER version of ProductCart, the file that you downloaded should be named: ProductCart_v4.7_Update_BTO_date
  • If you are running the BUILD TO ORDER version of ProductCart, with the Conflict Management Add-on, the file that you downloaded should be named: ProductCart_v4.7_Update_BTO_CM_date
  • If you are running ProductCart (STANDARD or BUILD TO ORDER) with the Apparel Add-on, the file that you downloaded should be named: ProductCart_v4.7_Update_APP_date
  • If you are running the BUILD TO ORDER version of ProductCart, with both the Apparel Add-on and the Conflict Management system, the file that you downloaded should be named: ProductCart_v4.7_Update_APP_CM_date

Unzipping the Downloaded Files

  • Unzip the files to a new directory on your desktop (e.g. “4.7 Update Files”).
  • Do not copy the unzipped files onto an existing set of ProductCart files.
  • If you want to have a copy of the entire ProductCart folder on your desktop, including the latest files, download the store to your desktop after you have finished the update process.

Updating Overwritten Files

List of Files

Some of the files contained in the ProductCart v4.7 update overwrite files that you have likely customized. These include:

  • pc/inc_footer.asp
    This is the file that might contain things such as your Google Analytics code. Please note that Google Analytics is now built into ProductCart. You can just enter your Google Analytics site profile ID into the Control Panel (Settings > Store Settings > Miscellaneous).
  • pc/include-metatags.asp
    This file used to contain your default meta tags. They have now been moved to the Control Panel (Settings > Store Settings > Company Details).
  • pc/orderComplete.asp
    This file is overwritten as part of the 4.7 update. However, if you moved any tracking code (e.g. Google AdWords) to the file orderCompleteTracking.asp that was introduced with the 3.5 update, you do not need to take any further steps as that file has not been overwritten and therefore your tracking code was untouched.
  • CSS files:
    • pc/pcStorefront.css
      This is the file that contains most of the styles used by the ProductCart storefront. A few style were added. You can locate them by searching for the string “4.7” in the file.
  • includes/languages.asp
    This file contains text strings that are often edited by ProductCart users.
  • includes/languagesCP.asp
    This file contains additional text strings.

Synchronizing Overwritten Files

As noted above, this update contains files that you may have modified. The list mentioned above is just a small subset of the files that have been updated and that may overwrite customizations that exist in your store.

See Synchronizing Files for tips on how to compare and synchronize your edited files.

Synchronize the new files with the corresponding, edited files in your ProductCart file set before you begin the update process. This article contains some instructions on how to do so.

Installing the Update

Parent Paths Enabled vs. Parent Paths Disabled

Please select the correct update files depending on the version of ProductCart that you are running. Specifically, if you are running ProductCart on a server that has Parent Paths Disabled, please use the files contained in the “Parent Paths Disabled” folder. Otherwise, use the files contained in the “Parent Path Enabled” folder, which is the most common scenario.

If you are unsure of which version you are running, look at the version number in the Control Panel start page (“menu.asp”). If it includes the letters “PPD”, then you are using the “Parent Path Disabled” version of ProductCart.

Step 1 - Back up your store

If you haven't already done so, back-up your store.

Step 2 - Turn off your store

  1. Log into your Control Panel and select General Settings > Store Settings
  2. Enter a descriptive message in the field Message displayed when store is off.
  3. Select Turn store off, then click on the Update button. This ensures that customers do not browse the store while you are updating it.

Step 3 - FTP new files to your server

Upload the files to their respective folders, overwriting the existing files. For instance, you will update the contents of the pc subfolder on your Web server with the files contained in the pc subfolder that you have downloaded from the ProductCart Update Management System.

Please note that the pcadmin folder has likely been renamed on your store. We recommend that you rename the same folder in the update files locally on your computer so that when you FTP the files there is no chance that a new pcadmin folder is created, which would mean that some of your store files are not being updated.

DO NOT delete any of the files that are currently on your Web server.

The ProductCart v4.7 update contains over 800 files and the FTP upload might take a few minutes (it's over 12 MB). Make sure that once the process has finished, your FTP client reports a success message. Most FTP programs have a way to show you whether some files were not uploaded successfully. If that happens, make sure to upload them again until all files have been uploaded successfully. In many FTP programs, you can add back to the transfer queue files that - for any reason - were not successfully uploaded during the initial transfer.

Step 4 - Update the Store Database

  1. Log into the Control Panel
  2. You will be automatically redirected to the database update page (upddb_v47.asp).
    Troubleshooting:
    1. If you are not automatically redirected, replace “menu.asp” with “upddb_v47.asp” in the browser address field and press the ENTER key on your keyboard.
    2. If you get a “Page Not Found” error, it means that the files were not uploaded to the correct folder or the FTP upload was not completed successfully.
  3. Run the database update script.
    Troubleshooting:
    1. If you receive any errors or warnings (e.g. a table could not be updated), run the database update again. In some cases these errors disappear on the second execution of the update.
    2. If the errors persist even after re-running the database update script a few times, leave the store OFF and open a Support Ticket.

Step 5 - TO DO List

A message will confirm that the store database and version number have been updated.

A “To Do” list will remind you of a actions that you need to take that are also covered in this document. See the “To Do Items” above.

Step 6 - Turn your store back on

When all To Do items have been completed, you can now turn your store back on and verify that the storefront is working properly. We recommend that you place at least one test order to go through the entire checkout process.

Troubleshooting

If you encounter a problem, please review the information in this document carefully to make sure that you have followed every step as outlined above. Specifically, make sure that:

  1. You started with the correct version number (see “Applicability” above)
  2. You correctly uploaded the files to your store (e.g. files in the “pcadmin” folder, which you likely renamed in your store)
  3. You successfully updated the database, as described above
  4. You completed the rest of the To Do items mentioned above

If this still doesn't solve your problem, leave the store OFF, log into your account on the ProductCart software store, and submit a support ticket. Please make sure to indicate which version of ProductCart you are updating from, which add-on's and other file sets you are using (e.g. Google Analytics integration, etc.), and include the error message that you are receiving.

Disclaimer

The ProductCart v4.7 Update has been tested by NetSource Commerce in a variety of environments. However, there might be environments that have not been tested and that may cause problems.

You are responsible for making a backup copy of your existing store database and store files, as described above. A backup copy of your store will allow you to revert back to your previous, working version of ProductCart in case you experience any problems after running the update.

NetSource Commerce shall not be liable for any loss of data and/or loss of income due to any downtime that your online store may experience as a direct or indirect result of installing this update.

Release Notes

New Features

  • Updated PayPal Integrations including the addition of PayPal Payments Advanced and the new Payflow Link integration.
  • Updated Google Shopping exports to include required product attributes
  • USPS 2013 Name Change: USPS Parcel Post is now Standard Post.
  • Pinterest “Pin It” button added to the Category, Product Details and Search results pages.
  • New gateway added: TransFirst.

Improvements

  • Added AVS code for the VirtualMerchant gateway.
  • Allow control panel users with full privileges to view charts on the main menu.
  • Expanded the character limitation of the “Terms & Conditions Agreement” from 50 to 255.
  • Added data entered by customers in the Custom Input Fields for the following data exports: “Export Sale Data”, “Export Order Information” and “Export Ordered Products Information”.
  • Allow adding saved products to shopping cart even if it's assigned to a hidden category.
  • Update the drop shipper interface to display the status of their specific items, not the status of the entire order. So if they shipped their items it will display as shipped, even if there are other items in the order that are not shipped.
  • Add Order Code to Invoices in both the store front as well as the control panel.
  • Added the ability for the admin to add the Gift Certificate recipient information to the order before resending the e-mail to the recipient.
  • Added Product's Meta Tag Keywords to the search query.
  • When using tax by location and the setting “Display taxes Separately” is set to “yes” taxes were not displayed.
  • Removed the charts from the main menu due to performance issues. They are now available via the “reports” menu drop-down.
  • Removed all credit card details from the “Packing Slip”
  • Fixed the ordering of the Feedback IDs in the Help Desk feature.
  • Added a variable to Disallow discount codes when products in shopping cart are 'On Sale'.
  • USPS “From Zip 4” error displays when generating a label due to an USPS update.

Notable Bug Fixes

Over 200 issues were addressed. Here are just some of them. Remember that v4.7 also includes all files that were part of previously released Service Packs. So you can refer to those updates for additional details on what issues they addressed.

  • Retired buttons bug fix: There were a couple of buttons that had been retired but were still being referenced in the store front.
  • Single quotes issue when adding a new value to the Custom Search Fields has been addressed.
  • Sales Manager Bug: A glitch would sometimes prevent a sale from being stopped correctly.
  • Long product names were being truncated when restoring a saved cart.
  • Discount code issue that allowed a normal discount code to be added along with a discount code that was flagged to not be used with other discounts.
  • Minimum Order Quantity bug that allowed customers to be able to check out with a quantity less than the minimum order quantity set for the product.
  • The “Save Cart” button was not working properly when a customer needed to register a new account.
  • In some situations the customer is not able to check out even if the shipping cart total amount is equal to the “Minimum Order Amount”.
  • Fixed bug in Repeat Order feature that was adding incorrect option pricing to products
  • Show shipping name on the Drop-shipper's order details page.
  • Change the calculations on the checkout page so that the Discount Code is applied after Category Discounts.
  • Reports missing Referrer ID and Referrer Names are not populating in the Customer Data Export file when using “Export Orders”.
  • Not able to assign images to Brands from the pop-up window.
  • Changed the way sales tax is calculated so that it's based on the Sub-Total after a promotion is applied.
  • Bugs when uploading products with “Oversized” shipping values.
  • Fixed pricing categories bug when adding additional products to an existing order.
  • Exporting sales data would return no results if a date range was entered that did not exist. We added validation to check the dates.
  • When editing an order with a Gift Certificate the amount of the Gift Certificate was being dropped.
  • Gateway fix for Beanstream in which an order would not be accepted if the customer did not enter in a different shipping address on the checkout page.
  • Fixed issues when using Google Chrome's back button.
  • Fixed display issues on the Discount Code Sales Report when more than one discount was used for an order.
  • Tax not being applied on processing fees.
  • FireFox field focus issue on category page. After checking a field value, if you display an alert window, you cannot focus back to the field. So, customer might submit wrong values.
  • Fix UPS Address issues when using the UPS Shipping Wizard where the previous address was being used on the next label.
  • When an order has excluded products or excluded categories and the rest of order amount is less than the required price range the “Free shipping” option is still applied.
  • Fixed performance issues when searching for products in the Control Panel when the store has a large number of products in the database.
  • Product Custom Search Field value had a character limitation of 250 characters. This has been changed to allow up to 4000.
  • Fixed bugs in the Highslide image viewer.
  • Fixed display of discount, gift certificate and promotion when the descriptions had commas.
  • Allow the control panel to restore a customer's saved shopping cart when they log in as the customer using the “Place Order” link.
  • Fixed an issue that was allowing customers to earn additional Reward Points when the admin is editing or updating the customers' reviews.
  • Fixed a bug that added duplicated records in Google Sitemaps and also increases the performance of this feature.
  • Product sorting issues on the search results page when search request does not have product sorting option selected.
  • Fixed single quotes issues when using CSV files to import/update products.
  • When editing an order there was some data lost in regards to the shipping service selected by the customer which resulted in the shipping wizards not being able to automatically detect which service was selected.
  • Copying options from one product to other products was generating an error.
  • When the Control Panel is using SSL the Twitter Feed was generating a security warning. Added the detection for SSL so that the Twitter Feed uses SSL as well.
  • When a store had a large number of brands there were performance issues.
  • Fixed some XML Tools bugs when they were being used to export/import of products/orders/customers.
  • When a sale is for wholesale customers only, it was displaying a link for customers not logged in under wholesale status on the ShowSpecials.asp page.
  • Bug when exporting order to FedEx when the Order number increase is also used.
  • When cloning a product that is currently “On Sale” the sale price was being cloned. Now you will be able to see the regular price as well during the cloning process.
  • FedEx WebServices fixes for Saturday Pickup and Smart Post Deliver Time.
  • ACH Gateway Bug when displaying card types.
  • Eprocessing Network Gateway added the “Restrict Key” feature.
  • Fixed issue with the Suspend Account feature.
  • No longer populating the state dropdown menu when a customer is adding a new shipping address.
  • Addressed an issue when the “Sale Icon” was not displaying on Category Pages.
  • Saving AVS and CVV code for the Virtual Merchant gateway.
  • Fixed a bug that prevented download links from being generated when the customer was ordering large amounts of downloadable products in the same order.
  • Internet Explorer 10 interface issue with the tooltip has been addressed. In some cases the background image was not being displayed.
  • When there weren't any images on a page where canonical urls were being generated is now fixed so that if no images are on the page, the urls are not generated in the source code.
  • Fixed an issue where the shipping address was changed to the billing address during checkout.

Notable BTO Bug Fixes

  • Decrease stock of purchased items in a BTO configuration even if the BTO main product is set to “disregard stock”.
  • Added additional inventory checks during the checkout process when the customer is ordering configured BTO products. There are instances when the customer is allowed to purchase BTO items in a number of units that is greater than the units in stock.
  • When a required BTO category's products are out of stock, you were still able to add the item to the cart. The main BTO product is now displayed out of stock if one of the required categories has no products currently in stock.
  • Unable to “Copy BTO Configuration to another BTO Product” has been addressed.
  • Fixed sorting issues in the store front when BTO default products did not have a price yet.

QR Code
QR Code ProductCart v4.7 Update Guide (generated for current page)