The Image Library tool enables you to manage images that you can link to using any WYSIWYG Editor. When building a page in the WYSIWYG Editor, you can upload new images to the Image Library that can then be used in the site page content.
Important Note: While it is possible to directly copy/paste images from other web pages into the WYSIWYG Editor, when your page is loaded, it will be pulling the image from the other website's server rather than your own. This could be considered a potential security issue as the administrator of the other website can change this image without your knowledge. It is always recommended that images are uploaded to the Terra Dotta image library when they are to be used on your site.
To access this tool, go to Settings > Image Library
. This page is accessible only to the Admin who has been given the permissions to use this tool.
Uploading a New Image
Before uploading a new image to the Image Library, it is recommended that you re-size the image to the desired size. This is because photo editing software usually provides better resizing results in terms of image clarity.
To upload a new image, click the ' New Image'
tab located at the top of the screen. The 'Image Library: Add Image' page opens.
Browse for the name of the image file by clicking the ' Browse’ button or clicking in the 'File(s)’ text box. Enter a brief description about the image in the 'Description' text box. Select a folder where you want to store the image from the 'Upload to folder' drop-down list box. The default option is for all images to be saved in the 'Uncategorized’ folder. Click the 'Resize and rotate options’ link if you would like to make changes to the image. You have several options:
- You can constrain the size of the image by choosing the maximum numbers of pixels
- Rotate the image 90 degrees clockwise or counterclockwise
- Prevent a thumbnail image from being generated by clicking 'Override server-side image reprocessing.’
Editing an Existing Image
To edit an existing image, click the ' Edit’ button located on top of the image that you want to edit. The 'Image Library: Edit Image' page opens. Enter the name of the image file in the 'Image to Upload' text box. You can also browse the image from its location by using the 'Browse' button. Enter a 'Description' of the image. Click 'Save' to save the image.
: If you upload a new image, the original image is overwritten.Managing Image Folders
To edit an image folder, click the ' Manage Folders
’ tab located at the top of the screen. A page opens with the existing folder details.
To edit the name of the folder, click the yellow pencil icon to the right of the folder name. Change the name of the folder and click 'Update.'
To delete a folder, click the red 'X’ to the right of the folder name. If a padlock icon appears, the folder cannot be deleted, because the folder has images in it. Remove the images, and then the folder can be deleted.
To change the order of the folders, edit the numbers to the left of the folder names, and click the 'Re-order’ button.
To create a new folder, click the 'New Folders’ tab at the top of the page. Enter the folder name and click 'Save.’ The new folder will be added to the list.
Organizing Images in Folders
To reorganize images into folders, select the check box adjacent to the image. Select the name of the folder from the 'Move marked image (s) to' drop-down list box at the top-right corner of the screen.The images are moved to the specified folder. If an image has been uploaded and not specifically assigned to a folder, it will be in the 'Uncategorized’ folder.
To delete any image from the image library, click ' Delete' located on top of the image that you want to delete. A dialog box appears asking you to confirm your action. Click 'OK' to proceed or 'Cancel' to ignore the action.
The section below lists common issues that can occur when using the Image Library and the means of resolution.
When attempting to upload an image to the image library, the upload fails with either the message, "There was an error reading the image. Image may be corrupted." or an error ID#.
There are a few potential causes for the image upload failure, most of which have their source in the Java image processing component used in the software:
- The image is not a supported image format (.jpg, .gif, .png are the supported formats)
- The image has characteristics that are unable to be compressed
- The image has an embedded color profile that is incompatible
- The image is a very large resolution and the image component is unable to process the submitted image into a web-safe format
The issue of the incompatible file can be resolved first by attempting to upload the image without the 'Check if you are uploading a large image and would like it resized' checkbox. Note: When you do this, you should first make sure the image is not a large image file that will result in long page loading times.
If the image file is still producing the issue when uploading, it may be necessary to open the image file in a simple graphic editor and re-save the image file in a new format (usually .jpg is the most compatible). If there are any options to remove color profiles, they should be used.
Note that the version of the Java Virtual Server (JVM) installed for ColdFusion may be responsible for the software's ability or inability to process certain images. Upgrading ColdFusion and/or the JVM is likely to improve image processing significantly.