Table of Contents
MailUp Integration: Installation
Installing the MailUp integration files is very easy. The following assumes that you have installed and activated ProductCart on your Web server. If you haven't done so, you will first need to perform the ProductCart installation as described in the ProductCart section, and then continue with the instructions below.
MailUp is built into ProductCart v4.5 and above.
- There are no separate files to install
- You can turn the integration with MailUp on and off under ”Customers > MailUp Integration”.
Previous versions of ProductCart
Download the Integration Files
Obtain the latest copy of the ProductCart - MailUp Integration Files from NetSource Commerce or NWEB (publisher of MailUp).
Unzip the files
All files are contained in a compressed (*.zip) file. Download and “unzip” the file on your local computer using your favorite unzip utility. If you don’t have an unzip utility, you can download a popular one at the following address: http://www.winzip.com/
Once you have unzipped the file you will notice that it contains two folders: one called Parent Paths Enabled and one named Parent Paths Disabled. Each folder contains all the files that you need to upload to your Web server to add MailUp support to your ProductCart-powered store.
You will use one folder or the other depending on whether you are using the Parent Paths Enabled (more likely) or Disabled (less likely) version of ProductCart. If you are using the Parent Paths Disabled version of ProductCart, the version number shown on the Control Panel's Start page should show the letters “PPD”.
Each of the two folders contains 3 sub-folders:
- pcadmin – This is the folder that contains the Control Panel files, and that you have likely renamed when you installed ProductCart.
- pc – A few files are replaced in the storefront to allow customers to subscribe to multiple lists, which are then managed in MailUp.
Upload the files
Now that you are ready to transfer the files, take the following steps:
- Back up your store
Make a backup copy of your existing store database and store files. 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 performing the installation. Of course, this is not needed if you have just installed ProductCart. Some hosting companies allow you to ZIP a folder directly on your Web server. That is a great and quick way to create a back-up of your store files.
- Turn off your store
Log into your Control Panel. Select General Settings > Store Settings. Enter a descriptive message in the field “Message displayed when store is off”. Select “Turn store off”, then click on the Update button. This ensures that customers do not browse the store while you are updating it. When you are done, log out of the Control Panel.
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 received together with this ReadMe file. DO NOT delete any of the files that are currently on your Web server.
IMPORTANT: If you use the Apparel, Conflict Management Add-on, or both, open the folder named Additional Files and transfer to the “includes” folder on your Web server the applicable file.
Update the database
Once all files have been uploaded to your store, log into the Control Panel to update the store database. You MUST update the database immediately after uploading the files, or errors will occur both in the storefront and in the Control Panel.
When you log in, select Customers > MailUp Settings in the Control Panel navigation. You will be automatically redirected to the update database page. If not, then look at your browser's address field. It will show the name of the file that you are currently viewing, which is likely “menu.asp”. Replace this file name with: upddb_MailUp.asp. Press the “Enter” key on your keyboard to load this page. ProductCart will automatically detect the database type and update the database for you.
The installation is complete. When the database has been updated, you will receive a confirmation page. Click on “Continue to Setup” to view the MailUp setup page. The next step is to make sure that ProductCart can communicate with MailUp.
If there is an installation or communication problem
If there is an installation or communication problem that prevents you from successfully getting the MailUp integration files running properly on your e-commerce store, don't worry. Follow these instructions:
- Restore the files “pc/login.asp” and “pc/custPref.asp” from your store backup by uploading them to the “pc” folder.
- These are the only files that change in the storefront.
- You can turn the store back on as the storefront is not affected in any other way.