File Management

File Management lets you upload files from your PC to your installation.

Typically, you use this option to load image files you want to use as buttons and background images on the payment pages.

Note: Some files are automatically added to your installation when you make changes to your payment pages using options from the Payment Page Editor. For example, when you add a language version of the payment page, the relevant property files are automatically copied into your installation.

File Management page

../resources/images/file_management_thumb_350_0.png

Feature descriptions

Label/FieldDescription
Upload File
BrowseUse to explore your PC and choose the file that you want to upload.
Worldpay Name for FileEnter a name for the uploaded file - this becomes the new name of the uploaded file.
Example:
If the file is called "MyResultPage.html" on your computer, but you name it "resultC.html" in Worldpay Name for File, then it will be added here as resultC.html ("MyResultPage.html" is ignored).
For more details, seeFilenames when uploading files.
UploadUse to upload files from your PC. For example, to upload images that you want to use for buttons or as backgrounds on your payment pages.
To replace an existing file, just upload the file using the same name as the file that is to be replaced. The uploaded file then overwrites the current file.
Note: About Files File names must be in alphanumeric format, less than 255 characters and should not contain special characters (e.g. %, !). File names are case-sensitive: so resulty.html is not the same as resultY.html. There is a limit to the size of files and the number of files you can upload. You should avoid using large files, as these increase the time taken for your payment page to load into a shopper's browser. The maximum recommended size of file that you can upload is 500 KB. The total space per installation is 1.5 MB.
View and Delete files
Open a fileTo open a file, click its name in the list - the file will open in your browser. You can now save it to your PC and make your desired changes. You can then use the Payment Page Editor to upload the changed file back to your Test installation.
DeleteUse to delete a file.

Warning: When you delete a file, it is permanently deleted from your Test installation.


Best practice: Before deleting any file from your installation, we recommend that you make a backup copy of the file, to enable recovery. To make a backup, you can useBackup and Restore.

Image filesThese are files with file extension: .gif, .jpg, .png. If you upload new files with these extensions, they'll automatically be added here.
HTML filesThese are files with file extension: .html.

Warning: Avoid using the extension .htm, as this extension can cause server issues.

Property filesThese are parameter files with file extension .properties, used by our systems. Some property files are automatically added to your installation.
Example:
If you use theLanguagespage to add a version of the payment pages in Spanish, a file called "messages_es.properties" is added to your installation.

Warning: Properties files contain complex code which is used to control your payment pages. Before you delete a properties file from your installation, we recommend that you:

  • Fully understand how properties files work with your payment pages.
  • Make a backup copy of the file before deletion, to enable recovery. To make a backup, you can use theBackup and Restoreoption.

Other filesThese are any files of a type not included in the Image, HTML and *Property sections. Although you can upload any file type you want, certain files, such as executables (.exe) or setup files, will not work from here.

Filenames

When you upload a file, you can enter the filename using the Worldpay Name for file field. When you enter a filename the uploaded file is renamed, if required, by our systems.

If you upload:

  • An image file, such as fileName.gif or fileName.jpeg, then the file is saved as an image in the Image Files list.

  • An html file, such as fileName.html, then the file is saved as an html file in the HTML Files list.

  • A properties file, either display.properties or messages_.properties, (where is a two-character code representing a language, for example 'es' for Spanish), then the file is saved as a property file in the Property Files list.

  • A file with an unrecognised extension, then the file is saved in the Other Files list.