Creating grouped page attachments

If you want files to be associated with a particular page, there are two types of page attachments:

• unsorted attachments that you can set on a page, on the Properties -> Attachments tab, and
• grouped attachments by defining fields for a page type and then uploading files to the fields.

Grouped page attachments are a more complex way of attaching files to pages in situations when you want more groups of attachments. First, create attachment fields in the page type of the required page; then second, add a web part that will display the files on the page.

Creating basic attachment fields

1. Open the Page types application.
2. Create a new page type, or Edit () an existing one.
3. If you are creating a new page type, stop at step 3 – Fields. If you are editing an existing page type, switch to the Fields tab.
4. Click New field.
5. Type a Field name.
6. In Data type, select Attachments.
   • The system then automatically selects Attachments control in Form control.
7. Type a Field caption. This is the label of the field.
8. Click Save.
9. (Optional) Repeat steps 4–8 to add more attachment fields.
10. If you are creating a new page type, finish the creating process.

The system saves the fields. The attachment fields are on pages using the specified page type. See all options to learn all settings of attachment fields. Don’t forget that you need to add a web part to display the files.

Displaying attached files with a web part

1. Open the Pages application.
2. If the page where the attachment will be displayed uses its own template, navigate to the page. Otherwise, navigate to the closest parent page with its own template.
3. Switch to the Design tab.
4. Place a new Page attachments web part to a web part zone.

   1. Unwrap the Visibility category and in the Show for page types field select the page types of the pages on which you want the web part to be visible.

   2. In the Content category, specify the path to the page holding the attachments in the Path field.

   3. In Attachment group, select the page type you created in the previous steps. In the second field of Attachment group, select the name of the field with files you created in the previous steps.

   4. (Optional) In Content before or Content after, you can type an HTML code that is before or after the displayed attachments, for example:

      Copy

      
      
      
       <h2>Attached documents</h2>
      
      
       

   5. Click Save & Close.

The system saves the web part on the page. If a user uploads a file in the Form tab now, the page will display the file.

Example

The example shows how to create a grouped page attachment on a page. The example uses the sample Corporate site.

First, we want to create two separate attachment fields on a page, and then second, we want to display attachments on the page.

Creating attachment fields

We want to add documents and images separately to the Open Day page that uses the CMS.BookingEvent page type.

1. Open the Page types application.

2. Edit () the CMS.BookingEvent page type.

3. Switch to the Fields tab.

4. Create two new fields:

   1. Click New field.
   2. Type AttachedDocuments to Field name.
   3. Select Attachments in Data type.
   4. Type Attached documents to Field caption.
   5. Click Save.
   6. Click New field.
   7. Type AttachedImages to Field name.
   8. Select Attachments in Data type.
   9. Type Attached images to Field caption.
   10. Click Save.
       

The system saves the fields. Then, you can check the Open Day page to see the fields you just added.

1. Open the Pages application.
2. Navigate to Community -> Events -> Open Day.
3. Switch to the Form tab.
   

Now, you see the two fields that you just added to the page type.

Displaying attachments on the page

We want the files to be displayed on the Open Day page.

1. In Pages application, navigate to the Events page, since Events is the closest parent page with its own template.

2. Switch to the Design tab.

3. Display Attached Documents.

   1. Right-click the orange web part zone header, and click Add new web part.

   2. Select Page attachments, and click Select to add the web part and to open the Web part properties dialog.

   3. Unwrap the Visibility category and in the Show for page types field select Event (booking system) (CMS.BookingEvent).

   4. In the Content category, specify the path to the page holding the attachments in the Path field.

   5. In Attachment group, select again Event (booking system) (CMS.BookingEvent). In the second field of Attachment group, select Attached Documents.

   6. In Content before, type:

      Copy

      
      
      
       <h2>Attached documents</h2>
      
      
       

   7. Click Save & Close.

4. Display Attached Images.

   1. Right-click the orange web part zone header, and click Add new web part.

   2. Select Page attachments, and click Select to add the web part and to open the Web part properties dialog.

   3. Unwrap the Visibility category and in the Show for page types field select Event (booking system) (CMS.BookingEvent).

   4. In the Content category, specify the path to the page holding the attachments in the Path field.

   5. In Attachment group, select again Event (booking system) (CMS.BookingEvent). In the second field of Attachment group, select Attached Images.

   6. In Content before, type:

      Copy

      
      
      
       <h2>Attached images</h2>
      
      
       

   7. Click Save & Close.

The system saves the web part on the page. If someone uploads a file on the Form tab of the Open Daypage, the page will display the files – attached documents and attached images.

Reference – Editing control settings category in editing a Page type field

When you edit a specific page type in the Page type application, select a specific field on the Fields tab. If you select Attachments in Field name, the system automatically selects Attachments control in Form control, and the Editing control settings category appears. All options from the category is in the following reference.