PhotoGallery Server Control

PhotoGallery Server Control Properties

The following are Ektron-specific server control properties. You can find information about native .NET properties such as font, height, width and border style in Visual Studio^® help.

• Authenticated (String)

  Indicates if you are logged into the CMS Explorer and can use it to browse to content, collections, and so on. See Also: Browsing Your Ektron Site Using CMS Explorer.

• CacheInterval (Double)

  The number of seconds that the server control’s data is cached. The default is 0 (zero). For example, if you want to cache the data for 5 minutes, set to 300. See Also: Caching with Server Controls.

• DefaultObjectID (Long)

  The default object ID for this control to use when there is no matching dynamic parameter value passed.

• DisplayXslt (String)

  If desired, enter a relative or absolute path to an Xslt that determines the display of the page.

  WARNING! If you specify an external file, do not store this file in the Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.

• DoInitFill (Boolean)

  By default, Fill occurs during the Page_Init event. Set to false if you want to postpone the fill-action until later. In this case, Fill is automatically called during the Page Render event. You might do this if you need to set or change a property on the control in code-behind and have it render with your changes shown.

• DynamicContentBoxHeight (Integer)

  The height of the dynamic content box in pixels.

• DynamicContentBoxWidth (Integer)

  The Width of the dynamic content box in pixels.

• DynamicContentTemplate (String)

  The template to use when displaying dynamic content. Leave blank to use the dynamic box.

• DynamicParameter (String)

  Gets or sets the QueryString parameter to read a object ID dynamically. To use the default object ID, leave blank.

• EnablePaging (Boolean)

  This property, in conjunction with the MaxNumber property, lets site visitors view an unlimited number of items while controlling the amount of screen space. The MaxNumber property limits the number of items displayed. If you set this property to True, and the number of items exceeds MaxNumber, navigation aids appear below the last item, allowing the visitor to go to the next screen.

• Hide (Boolean)

  Hides or displays the output of the control in design time and run time.

  • True—Hide the control output.
  • False—Display the control output.
• IncludeIcon (Boolean)

  Choose whether to display icons next to the navigation list’s links.

  

  

  • True—Show icons
  • False—Hide icons
• ItemSortOrder

  Specify the sort order of results. Choices are:

  • taxonomy_item_display_order—the order of taxonomy items as set in the Workarea. For additional information, see Changing the Order of Content Assigned to a Taxonomy/Category.
  • content_title—photos listed in alphabetical order by title
  • date_created—photos listed in chronological order by date created
  • last_edit_date—photos listed in chronological order by date created

  To specify the direction of the items, use the SortDirection property.

• Language (Integer)
  

  Set a language for viewing content; shows results in design-time (in Visual Studio) and at run-time (in a browser).

• LinkTarget (String)

  Determines the type of window that appears when you click a link in the server control.

  • _Self (default)—opens in same window.
  • _Top—opens in parent window.
  • _Blank—opens in new window.
  • _Parent—opens in the parent frame.
• MarkupLanguage (String)

  Identify the template markup file that controls the display of the server control. For example, mymarkup.ekml. If the EkML file is located in the same folder as the Web form containing the server control, just enter its name. Otherwise, the path to the file can be relative or absolute. See also: Controlling Output with Ektron Markup LanguageControlling Output with Ektron Markup Language

• MaxResults (Integer)

  Enter the maximum number of items to appear in the initial display of this server control. To set no maximum, enter zero (0). To let site visitors view more than the maximum but limit the amount of space, enter the maximum number of results per page here. Then, set the EnablePaging property to True. If you do and more than the number of MaxResults are available, navigation aids help the site visitor view additional items.

• ObjectType (String)

  The type of object to which this control is assigned. Choices are:

  • User—this control is assigned to an individual.
  • Group—this control is assigned to a community group.
• ShowCount (Boolean)

  Indicates if an integer representing the number of taxonomy items in the category appears next to each category when displayed on the Web site. The default is False.

  • True—Show taxonomy items number next to category.
  • False—Do not show taxonomy items number next to category.
• SortDirection (String)

  Select the direction of the itemSortOrder property. Choose Ascending or Descending.

• Stylesheet (String)

  Specify the path to a style sheet for use with this server control. The location can be relative or absolute. Leave blank to use the default style sheet.

  WARNING! If you enter a valid EkML file at the MarkupLanguage property, the Stylesheet property is ignored.

• TaxonomyCols (Integer)

  Enter the number of columns in which this taxonomy/category appear on the page.

• TaxonomyItemCols (Integer)

  Enter the number of columns in which the taxonomy item appear on the page.

• WrapTag (String)

  Lets a developer specify a server control’s tag.

  • Span (default)—designate an inline portion of an HTML document as a span element.
  • Div—apply attributes to a block of code.
  • Custom—Lets you use a custom tag.

Adding a Category

You can add categories to your photo gallery to sort your photos. You also can use categories to identify the types of users who can view the photos. For example, one category of photos may be private, while another may be shared with all of your colleagues.

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Click Manage Folder (). The Add box appears.
   

   

3. Enter a Name for the folder.
4. In the Share area, select with whom you want to share your photos.
   • Public—Anyone who can access your profile
   • Colleagues—Only colleagues (either you accepted their invitation, or they accepted yours)
   • Selected Colleagues—Colleagues that you designated as selected. See Also: Designating a Selected Colleague
   • Private—Only you
5. Click Add. When the page refreshes, it opens to the newly added folder.
   

   

Renaming a Category

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Click Edit (), located to the left of the category’s title. The Edit box appears.
3. Change the name of the category.
4. Click Save.

Deleting a Category

WARNING! Deleting a category permanently deletes all photos, as well as its subcategories.

NOTE: You can not delete the top-level folder, Albums.

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Click Edit (), located to the left of the category’s title. The Edit box appears.
3. Click Delete. A dialog box appears asking you to confirm.
4. Click OK.

Adding Photos to a Photo Gallery

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Select a category where the photo will be added. If you want to create a new category, see Adding a Category
3. Click Add Photo. The Add Photo box appears
4. In the Photo Data area, enter a Description and Maximum Width.
   

   

5. Click Next. The Add Photo dialog appears. Its appearance varies according to your browser, as explained in Managing Microsoft Office Assets.
   

   

6. User the Browse or Choose File button to navigate to the photo in your file system. Or, you may be able to click the Drag Drop tab and drop a photo in the Add box. A status box shows the files being uploaded. The page refreshes, and the photo appears in the gallery.
   

   

Changing a Photo Title or Description

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Select the category which contains the photo you want to change.
3. Click the triangle to the right of the photo’s title and choose Edit Properties.
4. Edit the photo’s Title, Description, or both.
5. Click Save.

Moving and Copying Photos

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Select the category from which to move or copy the photo.
3. Click the triangle to the right of the photo’s title and choose Copy.
4. Select the category to which the photo will be moved and click Manage.
5. Click Move or Copy. A dialog box asks you to confirm the action.
6. Click OK.

Deleting a Photo

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Select the category which contains the photo you want to delete.
3. Click the triangle to the right of the photo’s title and choose Delete. A dialog box asks you to confirm.
4. Click OK.

Sharing Photos

The Photo Gallery lets you share photos with your colleagues. You can share photos with the Public, Colleagues, Selected Colleagues, or keep them private. You apply sharing options to categories, not individual photos. See Also: Public—Anyone who can access your profile

1. On the Web site, navigate to a user’s Profile Page > Photo Gallery.
2. Click Manage Folder (). The Add box appears.
   

   

3. Click Share Folder (). The Share Workspace box appears.
   

   

4. Select with whom to share your photos.
   • Public—Anyone who can access your profile
   • Colleagues—Only colleagues (either you accepted their invitation, or they accepted yours)
   • Selected Colleagues—Colleagues that you designated as selected. See Also: Designating a Selected Colleague
   • Private—Only you
5. Click Share.

Saving a Photo to Your Local System

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.
2. Select the category that contains the photo you want to save.
3. Click the triangle to the right of the photo’s title and choose Save As... A dialog box asks you to open or save the file.
4. Click Save.