Viewers > Displaying Uploads
For most content fields you only need a single tag to display
their value. Because uploads have more information (url,
height, width, etc) they work a little differently.
The Page Viewer Generator will generate a block of code
that display uploads. It looks something like this:
| <!--
STEP3: Display Uploads --> |
| <?php
foreach (getUploads($options['tableName'], 'uploads',
$record['num']) as $upload): ?> |
| |
| ...
uploads are displayed here ... |
| |
| <?php
endforeach ?> |
| <!--
STEP3: /Display Uploads --> |
and inside that block you can display upload fields like
this:
| <?php
echo $upload['urlPath'] ?> |
Note: The default "List Viewer" code doesn't include any
upload fields. This keeps those pages shorter and easier
to work with. If you want to display uploads on the list
page, simply copy the code from the "Page Viewer".
Here's a list of upload fields.
All
uploads
All uploaded files have
the following attributes, whether they are images or documents.
| • |
filePath - the server path to the uploaded file,
e.g. C:\www\example.com\cmsadmin\uploads\foo.gif,
/vhosts/example.com/htdocs/cmsadmin/image.jpg |
| • |
urlPath - the website location of the uploaded file,
e.g. /cmsadmin/uploads/image.jpg |
Custom
Info Fields
| • |
info1, info2, info3, etc. - You can define these
extra Info Fields in the program (by default, info1
is "Title" and info2 is "Caption"). You might use
these fields to generate alt text for images, descriptions
of uploaded files, or captions for images in a photo
gallery. |
To modify the labels
for these extra fields, go to Admin > Section Editors,
and click "modify" for the upload field. In the "Advanced"
section, you'll find the Info Fields.
Image
files
| • |
hasThumbnail - Set to "1" if upload is an image
and a thumbnail exists. |
| • |
width - the width of the image |
| • |
height - the height of the image |
| • |
thumbFilePath - as per "filepath" above, but references
the thumbnail created by the program for the uploaded
image |
| • |
thumbUrlPath - as per "urlPath" above, but references
the thumbnail created by the program for the uploaded
image |
| • |
thumbWidth - the width of the thumbnail |
| • |
thumbHeight - the height of the thumbnail |
Misc.
Attributes
Note: The following attributes
are used by the program, but are included in these docs
for the sake of completeness...
num - a unique number
that identifies this upload
createdTime - the date
the upload was added
tableName - the table
name the upload is associated with
fieldName - the field
name the upload is associated with
recordNum - the record
number the upload is associated with
preSaveTempId - a temporary
id used to identify uploads when creating new records
