Ektron CMS400.Net Reference

>>Managing User Communities > PhotoGallery Server Control

PhotoGallery Server Control

The PhotoGallery server control helps users and community groups track and manage images. They can organize the images in any number of taxonomy categories. For example, a user might have the following organization.

Science

- Biology

- Animals

- Mammals

- Lions

- Bears

Once a user uploads an image to the his Photo Gallery, site visitors can navigate through its taxonomy and view the image.

This section also contains the following topics.

Adding Categories

Editing a Category’s Name

Deleting a Category

Adding Photos to a Photo Gallery

Changing a Photo’s Title or Description

Changing a Photo’s Title or Description

Moving and Copying Photos

Deleting a Photo

Sharing Photos

Saving a Photo to User’s Local System

Allowing Community Group Members to Work with Folders

PhotoGallery Server Control Properties

Adding Categories

Users can add categories to their photo gallery to help them sort their photos. They can also 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.

To add categories, follow these steps.

1. On the Web site, navigate to a User’s Profile Page > Photo Gallery.

2. Click Manage Folder ().

3. The Add box appears.

4. Enter a Name for the folder.

5. In the Share area, select with whom you want to share your photos.

Share option

Photos can be viewed by..

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

6. Click Add.

7. When the page refreshes, it opens to the newly added folder.

Editing a Category’s Name

Sometimes, it is necessary to change the name of category. To accomplish this, follow these steps.

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.

3. The Edit box appears.

4. Change the name of the category.

5. Click Save.

 

Deleting a Category

A user can delete obsolete categories in his photo gallery. To delete a category, follow these steps.

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

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

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.

3. The Edit box appears.

4. Click Delete.

5. A dialog box appears asking you to confirm.

6. Click OK.

Adding Photos to a Photo Gallery

To add a photo to a photo gallery, follow these steps.

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 Categories

3. Click Add Photo ().

Note: If you see the following error at this point, make sure your server’s clock is set to the correct time.
Error: Object Expected

4. The Add Photo box appears

5. In the Photo Data area, enter a Description and Maximum Width.

6. Click Next.

7. The Add Photo dialog appears. Its appearance varies according to your browser, as explained in Adding Documents Using the Add Assets Button.

See Screen Sample

8. 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.

9. A status box shows the files being uploaded.

10. The page refreshes, and the photo appears in the gallery.

Changing a Photo’s Title or Description

To change a photo’s title or description, follow these steps.

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.

4. From the drop down list, select Edit Properties.

5. Edit the photo’s Title, Description, or both.

6. Click Save.

Moving and Copying Photos

A user can move a photo from one category to another. In addition, you can copy photos to another category. To accomplish either of these actions, follow these steps.

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.

4. From the drop down list, select Copy.

5. Select the category to which the photo will be moved.

6. Click Manage.

7. Click Move () or Copy ().

8. A dialog box asks you to confirm the action.

9. Click OK.

Deleting a Photo

As photos become obsolete or are no longer wanted, users can delete them. This permanently removes the photo from the user’s photo gallery. To delete a photo, follow these steps.

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.

4. From the drop down list, select Delete.

5. A dialog box asks you to confirm.

6. Click OK.

Sharing Photos

The Photo Gallery lets users share photos with their colleagues. Users can share photos with the Public, Colleagues, Selected Colleagues or keep them private. Users apply sharing options to categories, not individual photos. See Also: Share options

To share a category, follow these steps.

1. On the Web site, navigate to a user’s Profile Page > Photo Gallery.

2. Click Manage Folder ().

3. The Add box appears.

4. Click Share Folder ().

5. The Share Workspace box appears.

6. Select with whom to share your photos. Share option describes each choice.

7. Click Share.

8. Click close window ().

Saving a Photo to User’s Local System

Users can save a photo to their computer. This enables the gallery owner to give the photo to other members of the community.

For example, I add a photo of my child to my photo gallery. My parents can then save the photo to their computer and either change it, print it, or upload it to their own photo gallery.

To save a photo to a computer, follow these steps.

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.

4. Select Save As... from the drop down list.

5. A dialog asks you to open or save the file.

6. Click Save.

Allowing Community Group Members to Work with Folders

When you associate this control with a community group, you can allow group members to add, remove and control the sharing of folders in a workspace. Because this feature is implemented on a group by group basis, it is controlled in the Workarea's Edit Community Group screen. See Also: Allowing Community Group Members to Work with Folders

PhotoGallery Server Control Properties

The PhotoGallery server control properties are described in this table.

Note: The following table only lists Ektron-specific properties. It does not describe native .NET properties such as font, height, width and border style. For documentation of these properties, see Visual Studio help.

Property

Description

Data Type

Authenticated

Indicates if you are logged in to the CMS Explorer and can use it to browse to Content, Collections, etc.See Also: Working with Ektron CMS400.NET Server Controls 

String

CacheInterval

Sets the amount of time the server control’s data is cached. The default is 0 (zero). This is the amount of time, in seconds, a control’s data is cached. For example, if you want to cache the data for five minutes, set this property to 300 (three hundred). See Also: Caching with Server Controls.

Double

DefaultObjectID

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

Long

DisplayXslt

Determines how information is displayed on the page. Enter the path to the XSL file. It can be relative or absolute.

Warning! If you specify an external file, it is strongly recommended that you do not store this file in your site's Workarea folder. If you store this file in the Workarea folder, the file will be lost when you upgrade.

String

 

DoInitFill

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 codebehind and have it render with your changes shown.

Boolean

DynamicContentBoxHeight

The height of the dynamic content box in pixels.

Integer

DynamicContentBoxWidth

The Width of the dynamic content box in pixels.

Integer

DynamicContentTemplate

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

String

Dynamic

Parameter

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

String

EnablePaging

This property, in conjunction with the MaxResults property, lets site visitors view an unlimited number of document items while controlling the amount of screen space. To accomplish this, the display is limited to the number set in the MaxResults property.

If you set this property to true, and the number of items exceeds the MaxResults number, navigation aids appear below the last item.

Boolean

Hide

Used to hide output of the control in design time and run time.

True = Hide control

False = Display control

Boolean

IncludeIcon

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

True = Show icons

False = Hide icons

Boolean

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 Change 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

Set a language for viewing the server control. This property shows results in design-time (in Visual Studio) and at run-time (in a browser).

Integer

LinkTarget

Determines the type of window that appears on this Web form when a user clicks an item in the dynamic content box. The default is _self.

_Self - opens in same window

_Top - opens in parent window

_Blank - opens in new window

_Parent - opens in the parent frame

String

MarkupLanguage

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 Language

String

MaxResults

The Maximum number of items to fetch. 0 (zero) = unlimited.

Integer

ObjectType

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.

String

ShowCount

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.

Boolean

SortDirection

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

String

Stylesheet

Specify the path to a style sheet for use with the 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.

String

TaxonomyCols

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

Integer

TaxonomyItemCols

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

Integer

WrapTag

Allows a developer to specify a server control’s tag. The default is Span.

Span - The <span> tag is used to designate an inline portion of an HTML document as a span element.

Div - The <div> tag is used when you want to apply attributes to a block of code.

Custom - Allows you to use a custom tag.

String


Visit the Ektron Dev Center at http://dev.ektron.com 1-866 - 4 - EKTRON

Ektron CMS400.NET Reference Version 8.02 SP1 Rev 1

Ektron Documentation,© 2011 Ektron, Inc.