Example: Unsorted attachments

  Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic! Mail us feedback on this topic!  

In the following example, you will learn how to add attachments to a document via the Properties -> Attachments tab and display them on the live site. We will use the Events section of the sample Corporate Site. First, we will upload the attachments to some of the events in the section. Then we will add the Attachments image gallery web part to the Events page, which will display the attachments for each displayed event.


1. Adding attachments to a document this way is quite simple. First, you need to select a document from the content tree and switch to its Properties -> Attachments tab.


2. On the tab, click the New attachment (UploadNew) link. The familiar Choose file dialog will be displayed. Choose any file from your local drive and click the Open button.


Please note: The mouse pointer doesn't change when you hover the New attachment (UploadNew) link. This is by design and you needn't be worried about it.




3. Repeat the same procedure so that you have a few files attached to at least one document. Preferably, include some images among them. The document's attachments tab should look similarly to the screenshot below after the attachments' upload. Note that if you hover an image in the list, its thumbnail is displayed as in the screenshot.


In the list of attachments, you can do several things with each attachment:


Using the Delete (Delete) icon, you can remove the attachment from the document.
Using the Move up (Up) and Move down (Down) icons, you can re-order the attachments. The order is stored in the AttachmentOrder property of each attachment. You can enter AttachmentOrder into the ORDER BY expression property of a displaying web part to have the attachments ordered accordingly.




Please note


The order of attachments is not versioned with documents' workflow. This means that if you change the order of attachments in one version of a document, the order is changed in all other versions too.



Images have also the Edit (Edit) icon available. This icon opens the image in the built-in image editor.
Using the Update (Update) icon, you can replace the original attachment with a new one.
After clicking an attachment's name, the attachment will be opened.




4. Now that we have the attachments uploaded, we can display them on the live site. The events are displayed by a repeater on the Events page, so we will have to add the Document attachments web part to this page.


Select the Events page from the content tree and switch to the Design tab. Click the Add web part (AddWebPart) icon of zoneLeft web part zone and choose the Attachments -> Attachments image gallery web part. You do not need to set any web part properties in order for the web part to display the attachments. However, you can add some heading via the Content before property:


Content before: <h1>Attached documents</h1>


Click OK. If you switch to the live site now, you should see its attachments' thumbnails as in the screenshot below.




Page url: http://devnet.kentico.com/docs/5_5r2/devguide/index.html?attachments_example_1.htm