FTP Server Access - Catalog
Overview
FTP is a very convenient way to access a lot of files on a remote server. UltraCart provides FTP server access to allow users access to:
catalog file system
catalog group multimedia
catalog log files
digital delivery files
item multimedia
screen branding graphics
Using the FTP server with the catalog allows a merchant to upload static content like HTML, CSS, graphics, and JavaScript.
Configuring User FTP Password
Navigation
The first step in accessing the FTP server is to configure an FTP password on the user.
First click on the Configuration link on the left hand navigation and then click on the "Users" link under General as shown below.
Alternatively you can set your own FTP password from the Your Preferences screen by clicking Your Preferences in the upper right corner of the page as shown below.
Click "Edit" on the user to set the FTP password on. If a user does not have administrator permissions they will have to request an FTP password be set by the administrator. On the user editor screen there is a section labeled "FTP Password" with fields to enter and confirm the new password.
FTP Host/User Credentials
After an FTP password is configured the FTP server is accessed with the following credentials:
Server | merchantftp.ultracart.com |
Username | <MerchantID>/<LOGIN> |
Password | <FTP Password> |
SFTP Port Number | 21 |
Notice that the values in angle brackets are replaced with the actual values for the account.
Please make sure to study the format for the credentials carefully.
FTP Blocking Due To Failed Attempts
NOTE: The FTP server is very sensitive to failed login attempts and will quickly block an IP address for three failed attempts.
FTP Client Configuration
One of the most popular FTP clients available for free is CuteFTP. This quality open source FTP client is downloadable from https://installer.globalscape.com/pub/cuteftp/cuteftp.exe
The screen shot below shows the proper configuration in the CuteFTP site manager for accessing the UltraCart FTP server.
(Please Note: A previously recommended FTP client, Filezilla, is no longer recommend due to issues with malware that is inserted from some file download repositories.)
Notice the use of credentials as explained earlier in this chapter. The other field highlighted on the configuration screen is the server type. The UltraCart FTP server supports FTPES (FTP over explicit TLS/SSL). If this option is available, UltraCart recommends using it because the FTP control port used to transmit the username and password will be encrypted making the communication very secure.
While a complete tutorial on how to use FTP is out of the scope of this guide, below is a brief explanation of the windows. Notice the client is divided into two sides "Local site" and "Remote site". The remote site represents the UltraCart FTP server.
FTP Folder Hierarchy
Off the root folder there are four child folders:
catalogs
digital-delivery
item-multimedia
screen-branding
By clicking on the catalogs folder the FTP client will drill down into the folder and show the subfolders. There is one folder for each catalog host configured on the UltraCart account.
After clicking on the hostname folder, in this case ucdoc.ultracart.com, the FTP client will show three child folders as shown below:
The three child folders each represent different file level functionality within a catalog.
file-system | The file system folder provides a generic file system for the catalog. Users can upload entire static sites to the file system folder including directories, subdirectories. Static content such as CSS and graphics is often used by the catalog templates for the look & feel of site. Note: If you are using tools like Dreamweaver to upload/download content then you will want to set the "root" folder in Dreamweaver to the "file-system" folder. which has a complete path of /catalogs/<host name>/file-system/ |
group-multimedia | Group multimedia folder allows the navigation of the group hierarchy of the site and storage of multimedia associated with each group. Usage of group multimedia is covered in a later chapter, but FTPing files in is an efficient method of uploading the content to UltraCart |
logs | The log directory provides access to the last six weeks of traffic on a catalog. Log files are formatted in Apache common log format and can be processed by a variety of 3rd party log analysis tools. |
Note: When uploading files for use in a catalog...
The file-system directory is the root directory of your catalog web site. Do not include it in your urls.
*Example (for a fictitious site www.mystore.com) *
If I FTP a file to this remote directory:
Here is my url
/catalogs/www.mystore.com/file-system/fonts/myfont.ttf
http://www.mystore.com/fonts/myfont.ttf
/catalogs/www.mystore.com/file-system/js/common.js
http://www.mystore.com/js/common.js