Ultra Media Gallery 5 User Guide

Transcription

Ultra Media Gallery 5
User Guide
Expand the “Bookmark” menu in left side to see the table of contents.
Copyright by bizmodules.net 2005 – 2008
Page 1 of 69
Overview
What is Ultra Media Gallery?
Ultra Media Gallery (UMG) is a DotNetNuke (DNN) application designed to work in DotNetNuke
websites ONLY. DotNetNuke is a free, open source framework ideal for building powerful web sites for
business and personal use. This documentation assumes that you have prior experience with the
DotNetNuke environment. For further information about DotNetNuke, please refer to DNN information
found at www.dotnetnuke.com.
Ultra Media Gallery is a complete, full-featured web photo/image and media gallery management solution.
With UMG, you can create photo and image galleries with customizable Flash and Lightbox Views.
When you subscribe to Flickr and Google Picasa, you can use UMG to display Flickr and Picasa photos
and images on your DotNetNuke website wrapped in UMG's high quality interface. With UMG, you can,
for example, create a Headline View for news headlines, or display real estate photos in a Virtual Tour
presentation. If you choose, use can UMG to sell digital media products online, or use UMG to allow your
website members to share their images with others using UMG's Personal Gallery mode. UMG is a
comprehensive image media management module with many configuration settings and options that offer
you a wide range of presentation choices to suit your needs.
Since the release of Ultra Media Gallery version 2.0 on January 3, 2006, UMG has been a
Snowcovered.com top seller, with thousands of DotNetNuke websites deploying UMG in every major
country around the world. Powerful features and flexible module functionality, backed by timely and
professional customer support are why many DotNetNuke users select Ultra Media Gallery as their web
image and media gallery solution.
Based on your needs, Biz Modules provides flexible and extensible module licensing options. You can
purchase a single installation license if you intend to use UMG in a single DotNetNuke installation only,
then add additional licenses as needed for other installations. Or for enterprise users, an unlimited
installation license is available for using UMG in a multi-installation environment.
Why choose Ultra Media Gallery?
The most powerful choice: UMG is an "all-in-one" gallery solution, offering many display options for
various business and personal uses. For example, you can configure UMG as a normal picture viewer, a
Lightbox viewer, an image rotator, a headline rotator, and more. With Ultra Media Gallery, you save
money because you get multiple Flash player interfaces built into one product, when other vendors
distribute modules with only one player per module. The power built into UMG is much greater than
similar products, because "...they [Biz Modules] don't take short cuts for their convenience, they do the
difficult programming for you." (from Dwight B.)
The most stable choice: With a large installed user base, UMG has such a large number of users that
potential bugs and problems are reported more quickly than as for products with fewer active users. In
many cases, bug fixes are available in a few days or less. With a wide range of UMG installations, you can
expect UMG works correctly for all your site visitors, across various browser and computer platforms.
Page 2 of 69
The most carefree choice: While you may encounter various questions and concerns when deploying a
DotNetNuke module, UMG's detailed user guide can help you to quickly solve most issues that arise. Biz
Modules support forum is also a good knowledgebase of tips and tricks. "The other major reason I choose
this product [UMG] is that the developer is very active and responsive in supporting this product. This
gives me confidence that any issues that arise in the future will be addressed quickly." (from Sean Lee)
Sample Galleries
Check www.bizmodules.net for sample galleries built by Ultra Media Gallery 5.
Page 3 of 69
What’s new
Ultra Media Gallery 5 (UMG) is a significant upgrade containing a powerful presentation provider
architecture, with a number of presentations built-in. As an option, you may license and purchase
separately the UMG Generic Presentation Pack which contains a variety of amazing presentations
that allow you to display UMG albums and images in various styles and formats.
UMG's new presentation architecture is built in a manner similar to DotNetNuke's DataProvider design
pattern. For example, most DotNetNuke installations are configured to use the Microsoft SQLServer as
the database system underneath the portals and sites created by DNN. But actually, DotNetNuke is
designed to be compatible with other database systems such as Oracle. Before you can use DotNetNuke
with Oracle, you would license or develop a custom DataProvider. The DataProvider is a custom
implementation of DotNetNuke's data access layer, with a unique set of methods and functions that allow
DotNetNuke to interact with a database system, to store and retrieve data.
The UMG Presentation provider is a custom implementation of a Flash player and .Net component for
UMG. UMG 5 calls the .Net component to generate data configuration XML files, then the Flash
presentation utilizes the XML files to access UMG albums and images.
Rather than only UMG Classic and Headline, which were the only two gallery displays available in UMG 4
and earlier, UMG 5 introduces the new presentation provider pattern, so the interaction interface between
UMG and a presentation is abstract, making it easier to add a variety of new presentation providers.
Biz Modules has developed powerful and useful presentation providers for UMG 5, with each
presentation having its own unique layout and behavior. You can use these presentations in various
business and personal use web sites. These presentations are not part of the core UMG package, but they
are included in the UMG Generic Presentation Pack, which can be licensed separately for a low price.
1.
3D Carousel
Display thumbnails in a circular or ellipse formation, with a mirror effect; move your mouse to
scroll and stop the carousel; click an image for a zoomed Lightbox effect.
2. 3D Stack (Generic Presentation Pack 3.1+)
Displays images in a top to bottom stack formation, with a mirror effect.
3. Side Nav
Similar to the Classic display, but image thumbnails are shown vertically to the left or right side of
the gallery.
4. Random Position
Displays image thumbnails in a random position, with thumbnails appear as Polaroid pictures;
set the "Seed" option to decide just how "random" the images are displayed.
5. Right Header
Displays a series of text buttons that link to images, with text buttons set on the left or right side
of the gallery stage; ideal for quick access to images, a featured content list, etc.
6. Virtual Tour
Browse photos and images with a virtual tour effect; ideal for a real estate showcase, landscape
pictures, etc.
Page 4 of 69
7.
Widescreen Showroom (Generic Presentation Pack 2.0+)
This presentation supports multiple albums or video, with Photo Link ability.
8. Shadow Viewer (Generic Presentation Pack 3.0+)
Shadow Viewer supports multiple albums, nested albums, FLV video and SWF movie playback.
UMG 5 is also built with these power features and enhancements:
1.
Amazon S3 Integration (Ultra Media Gallery 5.4+)
UMG can be seamlessly integrated with Amazon Simple Storage Service (Amazon S3), so you can
securely and efficiently store your UMG images and files in Amazon's datacenters, offering your
powerful bandwidth performance and saving you data storage costs.
2. Personal Gallery Mode
You can configure UMG 5 to offer personal user gallery services, so authorized users can upload
images to a centralized gallery, but users only see their own images. A unique URL is provided to
each user, so they may share their personal gallery with non-users.
3. Personal Profile Integration
Similar to Personal Gallery, UMG can be configured to work with User Profile modules. When a
profile is displayed, a UMG gallery managed only by that user can be displayed.
4. New Gallery Wizard
A simple wizard guides you through the process of creating a new UMG gallery quickly.
5. RSS Subscription
A UMG album may also be not images uploaded on your local site, but public RSS feeds such as
Flickr and Google Picasa. Users may subscribe to these galleries, and get automatic notification of
image updates to the gallery through the RSS feed.
6. Search Engine Optimization
When you add image Title and Description data to your UMG images, UMG exposes this
information to search engines like Google, increasing your site search ranking.
7.
Embed Gallery
For each gallery, UMG automatically creates a block of HTML and JavaScript code that can be
inserted on a website anywhere on the Internet, to view your UMG gallery!
8. Custom Search Module
A powerful search engine is included with UMG, optimized to work exclusively with UMG to
search through albums, images, photos.
9. Caption Token
[AUTHOR] & [AUTHOR_USERNAME] tokens placed in the gallery Caption Header template
allows users browsing a gallery to know who added the image to the gallery.
10. Dynamic Gallery
With UMG set to dynamically generate a gallery from a file system folder of images, UMG looks
for a custom album.xml file, and if it exists, reads Title, Description, Audio, and Logo settings
from the XML file.
11. UMG-PhotoCalendar Module
Quickly and easily organize photos by Taken Date, read from the EXIF header.
For more information on the latest enhancements to UMG, please see the Release Notes.
Page 5 of 69
System requirements
Ultra Media Gallery (UMG) is designed to work in ALL DNN 3.3.x/4.3.x and higher websites,
including but not restricted to 3.3.x, 4.3.x, 4.4.x, 4.5.x, 4.6.x, 4.7.x, 4.8.x, 4.9.x. and 5.0.x.
Ultra Media Gallery even works on websites run in "medium trust" on shared servers.
As long as your DotNetNuke portal is configured and working correctly, Ultra Media Gallery will work,
too.
Ultra Media Gallery presentations require that AJAX.net is enabled. UMG automatically configures
AJAX.net for you when you run the UMG New Gallery Wizard for the first time
Page 6 of 69
Installation guide
The Ultra Media Gallery (UMG) installation will install both the UMG modules PA (Private Assembly)
and all standard presentation providers that are included with UMG.
You install UMG as you would any normal DNN PA module. Login to your website portal with Host
permissions, and from the Host menu, choose Module Definitions. From the Module Definitions
dropdown menu, choose Install New Module. The following screen appears:
Click Browse and locate the UMG PA, then click Install New Module. When the installation is complete,
scroll down to confirm that the installation was successful:
Click Return, then scroll through the list of installed modules to see the UMG modules now listed as
installed in the Module Definitions list. The first UMG module listed - Ultra Media Gallery - is the
main module that must be configured to use UMG.
Page 7 of 69
With UMG installed, if you also purchased the optional Generic Presentation Pack, you can install the
Generic Presentation Pack now. The Generic Presentation Pack is installed using the same steps as the
installation for UMG.
Once you have placed a UMG instance on a page, to check the availability of all installed presentation
providers, select Settings(
) from the Ultra Media Gallery menu. At the bottom of the Settings screen,
all installed presentations are listed in and can be selected from the Presentation dropdown list:
Page 8 of 69
Uninstallation guide
WARNING: Once you uninstall Ultra Media Gallery (UMG), all data entered into UMG is lost forever.
There is no way to recover data deleted during the uninstall process. To be absolutely sure you do not
need UMG data, you should make a reliable backup before you uninstall UMG.
Ultra Media Gallery requires AJAX.net support to provide powerful visual effects. Ultra Video Gallery
also uses AJAX.net support. If you also have Ultra Video Gallery installed in this portal and you only wish
to uninstall only Ultra Media Gallery, skip to Step 2 below.
Step1: You must disable AJAX.net support in Ultra Media Gallery Settings(
) before you uninstall
the UMG module. WARNING: If you do not disable AJAX.net support in UMG before you uninstall UMG,
your web site portal will crash!
To disable AJAX.net support, select Settings(
) from the UMG menu, locate the AJAX.net setting
below, disable/uncheck it, then click Update:
Confirm that the AJAX.net setting is disabled/unchecked before you proceed.
Step2: To safely uninstall Ultra Media Gallery from your website, logged in as a user with Host level
permissions, from the Host menu, select Module Definitions. Scroll down the list to locate modules
with the prefix UMG-. Click the pencil button to the left of each UMG- module to bring the module into
focus, then to delete the module, click the
link button.
If you want to uninstall all the existing UMG data (galleries, albums, images) but you intend to reinstall
this product to use it "fresh", you do not need to uninstall all the UMG- sub modules. Simply uninstall the
Ultra Media Gallery module, and leave the UMG- sub modules installed. You may now safely reinstall
the Ultra Media Gallery PA package, and during installation, all database objects and files are created
new.
Typical for all DotNetNuke (DNN) un-installations, there is no option for deleting folders and files created
by a module in the file system. After un-installing UMG, you may leave these folders/files installed, or
delete them manually, if you choose. To delete these folders/files, simply delete the UMG root folder in
each portal where UMG was used. This folder will be:
$Portal Root/UltraPhotoGallery
... which you can delete by using an FTP client, or by using the DNN File Manager, found under the
DNN Admin menu.
Page 9 of 69
Obtaining technical support
As a licensed user of a Biz Modules product, we offer you long-term technical support, for the life of the
product, should you require technical support at any time.
Priority support is provided in the Biz Modules technical support forum. In the forum you can browse
topics submitted by other users, or post a new topic if you find that your issue has not yet been discussed
in the forum.
You can reach the support forum at: http://www.bizmodules.net/Forums/tabid/55/Default.aspx
For brief questions about Ultra Media Gallery and for all other matters regarding Biz Modules, email:
[email protected]
www.bizmodules.net
Page 10 of 69
Getting started
New gallery wizard
Note: The words photo, picture and image are used interchangeably in this user guide and in the Ultra
Media Gallery module.
To create an Ultra Media Gallery (UMG) image gallery, add the Ultra Media Gallery main module to a
DNN page. The New Gallery Wizard appears to help you quickly configure a gallery:
Step 1: Confirm that UMG should enable AJAX.net support. If you should later choose to
uninstall UMG from this portal, carefully note what you should do before un-installation: you should
disable AJAX.net support from the UMG Settings screen before uninstalling UMG if after
uninstalling UMG you will have no other modules installed that use AJAX.net support.
Enable AJAX.net, then click the box to confirm that you understand how to disable AJAX.net
support in UMG Settings before uninstalling UMG if no other installed modules are using AJAX.net
support, then click Next to proceed with the Wizard:
Page 11 of 69
Step 2: Choose a UMG presentation for this gallery. You may change the default presentation setting
later, if you choose. This screen below contains some presentations that are included in the optional
Generic Presentation Pack, licensed separately from Biz Modules. Select a presentation, then click
Next:
Page 12 of 69
Step 3: Specify the size of this gallery. You may modify this setting later, if needed. Depending on
the size of the images displayed in a gallery and the presentation selected, Width and Height may be
adjusted later for optimal results. Change these dimensions or accept the default values, then click
Next:
Step 4: Select the source of the images that will display in this gallery. The default is Web Upload
which allows users to upload images to this gallery. Select RSS Subscription if you want to display
images through an RSS feed subscription to either Flickr or Google Picasa. Choose Server Directory to
display images using the UMG Dynamic Gallery feature. UMG will automatically display images from
any directory containing images located under the portal website root.
Here, we select the most common application, Web Upload, then click Next:
Page 13 of 69
Step 5: The UMG New Gallery Wizard prepares to make a default album for you. There must be at least
one album in a gallery to display images in that gallery. Select these default album values, which you can
modify later, then click Next to continue:
Page 14 of 69
Depending on the options you choose, some Wizard steps may be skipped because they are unnecessary.
Do not be alarmed if you notice Wizard Step 5 moves next to Wizard Step 8, for example.
If you choose RSS Subscription as your image/picture source, you should see Wizard Step 6 and the
following screen:
Enter a valid Flickr or Google Picasa RSS feed. UMG validates your input and sets up the gallery for
you.
If you choose Server Directory as your image/picture source, you should see Wizard Step 7 and the
following screen:
Page 15 of 69
All folders under your website portal root that currently contain images are listed in the Source Folder
dropdown list. Select a folder, then click Next.
If you choose either RSS Subscription or Server Directory, your gallery is immediately activated and
visible:
Page 16 of 69
Please note that the New Gallery Wizard can only be run once. You may click Previous up until the
last Finish is clicked. You cannot re-run the wizard once you click Finish.
However, all the setting choices you make while running the New Gallery Wizard can be found in
various UMG menu sections. These features are described in detail in other sections of this user guide. For
example, to subscribe to a Flickr RSS feed, just add a new album under Albums(
) and configure the
settings to your selected RSS feed. Or, to change the look of your gallery, simply choose another
Presentation from the bottom of the Settings(
) screen. In most cases, the choices you make during
the New Gallery Wizard may be modified later to suit your needs.
Page 17 of 69
Add picture
Click the Add New(
) button at the top of a gallery to add new images, and you will see this screen:
Choose an Album, then click Browse... to locate an image to add to the gallery.
Title, Description and Link are optional fields. However, entering information in the Title and
Description fields can be useful later for searching purposes.
Enter a Link web address if you would like UMG to open a specific URL when this image is clicked in a
gallery display.
Click Save & Exit to save this image and return to the gallery presentation, or click Save & Continue if
you wish to add more images to the album now.
If you wish to immediately approve images for display, be sure the Approved checkbox is enabled. If you
wish to upload an image to the Album but not immediately display the image in a presentation, disable
Approved. Later, you can individually approve images for display by editing the images.
All popular image formats are supported, including bmp/gif/jpg/jpeg/png/tiff. To quickly add
multiple images to an album, compress multiple images into a single ZIP file and add the ZIP file to the
album. UMG will automatically unpack the ZIP and add all images to the album.
Page 18 of 69
Manage pictures
Every user who has permission to add images to an album will have the My Work(
) option available
from the UMG menu. If you have added images to an album, this is where you can find all images that you
have added to UMG:
To edit properties about an image, click the Edit pencil to the left of each image. The edit image form is
identical to the Add New input form.
If you have Manage Role permission in an album, you can manage all images in the album, even images
that have been added by other users. When you click Manage(
), you can see only the albums for
which you have Manage permission. The Manage button is not visible if you do not have Manage Role
permission. For more information about permissions, please refer to the Permission Set section of this
user guide.
Click the Album Title link, to the right of the green arrow, to manage an album:
Page 19 of 69
You can manually adjust the order of images by either (1) clicking the Up/Down arrows to the far
right, or (2) click a thumbnail, then with your mouse button down, drag the thumbnail to a new
position over another thumbnail. When the destination thumbnail becomes semi-transparent, release
your mouse button and the image is moved to new position right after the image you dropped over. When
you click and drag a thumbnail over the very first thumbnail of an album, the image is inserted as the first
image.
Additional manage album features are displayed as link buttons at the bottom of this screen. Bulk Edit
allows you to edit certain properties for selected images in single operation. Rotate Left and Rotate
Right allow you to rotate selected images 90 degrees, left or right. Quick Sort lets you quickly sort all
images based on the predefined Default Sorting setting found in Settings. Reverse Order allows you to
quickly reverse the order of all images in an album. If you manually add or delete images from the folder
where this album is stored on your hard disk, click Synchronize to update UMG to mirror the changes
you have made manually.
Page 20 of 69
Manage albums
At least one Album is required for every gallery, and the New Gallery Wizard helps you create a default
album automatically when you choose Web Upload as your image source. Only a few settings are
required for the Wizard, but there are many more settings available to you.
Users who can manage albums must have Edit Module permission or belong to a DNN role enabled in
the gallery Manage Roles found in Settings(
) > Rights. Click the Albums(
) button from the
UMG gallery menu to see all albums that exist for the current gallery:
Click the pencil button to edit an album:
Page 21 of 69
Album Id is a unique numeric id assigned to each album. This number is used internally by UMG and
cannot be changed.
Album Type is usually Standard Album, which is an album that is set for web upload as image source. If
an album is set to Subscribe to a Flickr or Picasa RSS feed, the Album Type setting will display as RSS
Subscription.
Parent Album defaults to Not Specified unless an Album is a child of another Parent Album.
You may change the album at any time. Description is an optional field useful for describing the
contents of an album.
Page 22 of 69
Caption Header is a token field that allows you to customize the Header that is displayed at the top of a
gallery. In this field, you may add static text or remove or reposition tokens to suit your needs.
Thumbnail Width & Height specify the size of image thumbnails. When you upload an image, UMG
automatically generates a thumbnail for every image. With this setting, the thumbnail size may be
changed to suit your preference. Some UMG presentations may look better with larger thumbnails, for
example, the RandomPosition presentation.
Album Logo is a small logo displayed in Album List but only for presentations that support multiple
albums. Below is a screenshot of an Album Logo (a car) displayed in the Album List found in the UMG
Classic presentation:
By default, the Auto Resizing feature is enabled. UMG automatically resizes uploaded images if an
image exceeds the Max Size specified here. If you wish to allow for uploading larger, higher resolution
images, you may disable Auto Resizing.
Enable Default Album if you want to make this album the default. This setting is useful in some
presentations. For example, in the UMG Classic presentation, the Album List is ignored if Default Album
is enabled.
Need Approval and Auto Sync are discussed in other sections of this documentation.
Expand Background Music and Banner sections to see the following settings:
Page 23 of 69
To add background music for an album, upload an MP3 file. However, if the DNN Administrator has not
specified MP3 as a valid upload extension, a message will display indicating the ability to upload MP3 is
disabled. To enable MP3 uploading, add the MP3 file extension to Host > Host Settings > Advanced
Settings > Other Settings > File Upload Extensions.
You can upload a Banner for certain presentations, such as the UMG Classic presentation, where a
banner can be displayed on the top or bottom of the gallery.
If your currently selected presentation supports multiple albums, you will see an Add New link button at
the bottom of the Albums screen. Most presentations allow for a single album only. In this case, you may
only add a new album if you delete the existing default album.
If you have created multiple albums, you may click the Up and Down arrow buttons to adjust the album
sort order:
Page 24 of 69
Add bulk pictures
In the Add Picture chapter, you learned that you can upload a zipped file containing pictures and images,
and UMG automatically unpacks the zip file, adding each image to the gallery individually. Add Bulk
Pictures also allows you to add groups of images together into an album in one bulk process.
At the top of the gallery, click the Manage(
) button, then select an album to manage, and you should
see the following screen:
Above the list of images, you should see a message like this:
The folder of this album is /Portals/0/UltraPhotoGallery/380/2/large; upload images to this folder and synchronize the folder with the
album.
Copy or Upload images into this folder, then click Synchronize below the image list, and you should see
a message like this:
x photos synchronized
Synchronized images appear in the image list instantly. The Synchronize feature is very useful when you
have many images to add to an album. Simply upload or copy the images into the folder path listed above
your album images, then click Synchronize and your album is updated with new images immediately.
The album option Auto-Sync works in a similar manner, except not manually but
automatically at predefined intervals. If Auto-Sync is enabled, UMG monitors the album
folder, and at predefined intervals, if there are new images in the album folder, UMG
automatically synchronizes the folder and the album. Enable Auto-Sync if you add new
Page 25 of 69
images frequently to an album folder, and you want UMG to manage synchronization
for you.
Page 26 of 69
Permission Set
Ultra Media Gallery allows for the management of permissions at two levels: Module-Level and
Album-Level. Module-Level permissions are handled by DotNetNuke, and Album-Level permissions are
managed by UMG. To demonstrate how to configure module permissions, in this example we have
created two additional portal Roles - Managers and Approvers:
Now we may assign portal users to either of these DNN Roles for UMG purposes.
Login with Admin level permissions, navigate to a UMG module, and mouse-over the triangle icon, the
Module Menu. Choose Settings to see the DNN module permission grid:
Note the two primary permissions on this screen: View Module and Edit Module. Users who have
View Module permission are able to view this gallery only, but users who have Edit Module permission
have full control over this UMG module. Users with Edit Module permission have access to all the
UMG menu options found at the top of the gallery, including the options usually reserved for
Administrators only, the menu options on the far right:
Page 27 of 69
Now we look more closely at the Album-Level permissions found in Albums > Rights section:
1.
Composing Roles: users who can Add images in this album;
2. Manage Roles: users who can Manage existing images and Approve pending items;
3. Approval Roles: users who can Approve pending images in this album.
Approval permission is a subset of Manage permission, a user with less permission than a Manage
Role user. The album Owner automatically gets Manage level permission.
Let's examine this example permission set:
Registered Users can upload new images to this album, but these images must be approved by
Managers or Approvers. Managers can manage all existing images in this album, and so can
Administrators, because Administrators have Edit Module module-level permissions.
Page 28 of 69
In this example, if a user in the Registered Users role were to login and navigate to this gallery, the user
would see only these UMG menu options at the top of gallery:
The user may Add New images and Manage their own images only.
When we login as a user with Approvers Role permissions, we see these options:
The UMG Approve menu option appears which allows the user to approve pending items. Because this
user in the Approvers Role is also in the Registered User role, this user is permitted to Add New images. If
this user were removed from the Registered User role, My Work and Add New would be unavailable,
but the user could still access the UMG Approve menu option.
When we login as a user who is in the DNN Managers role, we see the following options:
A user can click the Manage option to see the albums for which they have manage permission. For more
information about Manage, see the Manage Pictures section of this user guide.
Note that you must enable the Need Approval option in Album > Settings if you want to give users
with proper permissions the ability to approve images.
You may wish to assign one or more persons as Content Manager for a gallery, but restrict this user
from accessing the UMG Settings and Appearance menu options. This user should be able to manage all
albums and images in a gallery without limitation, but make no changes to the operation or look of the
gallery, options available in Settings and Appearance. To achieve this level of security, on the UMG
Settings screen, grant the Gallery Manager permissions to a DNN Role of your choice.
Page 29 of 69
Subscribe to flickr and picasa
In Step 4 of the New Gallery Wizard, you can choose to create a gallery from a valid Flickr or Picasa
RSS feed.
If your selected presentation supports multiple albums, you can create more than one new album that
subscribes to Flickr or Google Picasa. From the UMG Album menu option, when you click Add New,
select RSS Subscription as Album Type, and you should see the following options:
In the RSS Feed field, enter the address of a feed from Flickr or Google Picasa. Enter a numeric refresh
interval if you want UMG to refresh the feed automatically.
An RSS Subscription album can be displayed together with standard albums. However, in some UMG
presentations, for example, Headline and VirtualTour, RSS Subscription is not supported
Page 30 of 69
Change colors and appearance
To better suit your web site design, various options are available for each unique presentation, including
options for setting colors, behaviors and text. Click Appearance(
) at the top of the gallery to
customize a presentation. The Appearance settings of the UMG Classic presentation are shown below:
The UMG Classic presentation has the most options (60+ total) of all UMG presentations. Click section
Titles to expand and view all settings under each section. Click the Help/Tooltip( ) icon before each
item for useful tips on settings. For all color fields, click the color block to the right of the hex color code
textbox to select a color from the pop-up color palette. The pop-up color selection feature was designed to
work with the IE browser and may not work in all browsers.
Below is the Appearance screen from the RightHeader presentation:
Page 31 of 69
With some presentations, such as RandomPosition, you can specify a background
image, which will enhance the look of your Gallery. A few sample background pictures
are included with UMG, located in the /DesktopModules/BizModules UltraPhotoGallery/RandomPosition folder.
Page 32 of 69
Rate and comment
With the UMG Classic presentation selected, UMG allows users to Rate and Comment on images in a
gallery. When Rate and Comment is enabled, you will see a series of star icons in the lower left corner of
an image:
When you click the star icons, a ratings and comments window opens up:
A user can Rate and Comment on the image currently being displayed in a window. Existing ratings and
comments are displayed in the History box. If, for example, you were to rate 4 stars for an image, then
Post and close the window, the rating star icons are refreshed, and the new rating score is displayed:
Page 33 of 69
The Rate and Comment feature can be enabled or disabled with the Enable Rating setting found under
the UMG Appearance menu option.
It is possible to allow users to Rate and Comment on images displayed using presentations other UMG
Classic presentation when you use the UMG-QuickRate module. In the following example, we are using
the SideNav presentation, which does not allow for Rate and Comment inside the Flash presentation. But
with the UMG-QuickRate module placed beside your gallery, users can Rate and Comment on any image
displayed using most presentations:
With the UMG-QuickRate module, the image rating and comment history is shown for each image
in-focus in the gallery. For images that have not yet been rated, a user can click the star icons to rate the
image, and comment on the image, too.
Note that the UMG-QuickRate module does not work with either the VirtualTour or
Widescreenshowroom presentations.
Page 34 of 69
Publish RSS feed
In the UMG Settings(
) screen, locate the Allow RSS option:
Enable this setting, and set Max Items, which limits the number of images that will be included in the
RSS Feed. Note that in an RSS Feed, UMG will always sort and display images by Created Date |
Descending Order, no matter what is configured in Settings > Default Sorting. This setting effectively
shows the latest added images at the top of the feed.
After enabling Allow RSS, when browsing this gallery, the RSS icon will display in the lower right corner
of the container surrounding your gallery:
The RSS Feed icon allows site visitors to click the icon to subscribe to a gallery. Users who subscribe to a
UMG gallery RSS Feed do not need to visit your site to see updated images. Images added to the gallery
can be viewed directly through the RSS Feed channel.
Note that UMG's Publish RSS Feed will only work on a gallery set to Gallery Mode:
Normal.
Page 35 of 69
Advanced topics
Sorting criteria
By default, UMG sorts your images by Created Date | Descending Order. This order displays the
most recently added images first, at the beginning of a gallery presentation. This is a popular
sequence, however, if you would rather use another order, you may choose an alternate Default
Sorting order.
Click the UMG Settings(
) option, and locate the Default Sorting section:
UMG allows you to sort images up to three levels deep. UMG attempts to sort images by the 1st
Sorting Field, and if that field is not available or if two or more images have the same value in that
field, UMG attempts to use 2nd Sorting Field, then the 3rd Sorting Field.
The available sorting fields are:
File Name
Numeric Parts in File Name
Created Date
Taken Date
Title
Description
Created Date is the default sorting field. Images are sorted by the date added to UMG, which is a
popular display sequence. Taken Date is another useful sorting option when your images are
imported from a digital camera. UMG reads the image EXIF header to determine the Taken Date
value.
Any changes made to the Default Sorting fields does not immediately change the order of existing
images in the album. Images will remain in the existing sort order until you click the Quick Sort
menu option in the album Manage screen. If you do not click Quick Sort, UMG will also re-sort
images into the new Default Sorting order when you add a new image to the album. For more
information about Quick Sort, see the Manage Pictures section of this user guide.
Page 36 of 69
View Permission Control
View Permission Control allows you to set selected album view permissions independently. By
default, this feature is disabled. To enable View Permission Control, from the UMG Settings
screen, locate this option and check/enable it:
Choose the UMG Album menu option, and under the user Rights section, a new View Roles
section now appears:
By default, only Administrators can see an album. Add View Roles by clicking the DNN Roles that
should be allowed to view this album and images.
Note the following conditions:
1.
View Permission Control works in Gallery Mode: Normal only.
With nested parent/child albums, if a user has view permission for a child sub album but not for a
parent album, the user will not see the child sub album.
2. When you first enable View Permission Control, existing albums are not viewable by anyone
because View Roles will be all disabled. You must enter edit album settings and enable View
Roles permission for DNN roles.
View Permission Control is ignored by presentations that do not support multiple albums. Currently,
only UMG Classic presentation supports View Permission Control.
Page 37 of 69
Linked download
You can attach a file as Linked Download to any image so that your website visitors can download a
file when viewing a gallery. The file to download can be in any format as long as the file extension is
supported in Host Settings > Advanced Settings > Other Settings > File Upload Extensions.
For example, if you use UMG as a product catalog, you may wish to attach a PDF product
specification sheet to an image. If you use UMG as a media gallery, you may choose to assign a
Linked Download media file (mp3/swf/video clip). If you use UMG as a photo gallery to sell your
photos and images, you may want to upload an image in medium resolution for display by UMG, and
upload a high resolution image as the Link Download, only available for download after the buyer
purchases the image. In UMG Settings, be sure this option is enabled:
When you Add/Edit an image, you will see this option:
With Quick Add default setting, browse to select a file, or if you select All Downloads, choose from
an existing file in this album. The Manage Downloads option allows you to manage existing
downloads from another screen.
You may upload a large, high resolution image to a gallery, but you want UMG to automatically
resize the image to medium resolution so the image can be viewed more quickly in a presentation.
However, you also want to keep the original file on the site so it can be downloaded if necessary. This
can be done with UMG by following these steps:
1.
From UMG Settings, choose Presentation: UMG Classic.
UMG Classic and SideNav allow you to enable the Linked Download feature.
is enabled.
2. In the Settings screen, ensure
3. In the Album options screen, be sure Auto Resizing is enabled.
Add a large image to an album, and UMG will resize the image to the Max Size specified in Auto
Resizing. Save the original high resolution image as a Linked Download.
4. Click Appearance(
) and be sure to choose this setting accordingly:
View your gallery and locate the the image you just added. Click the image, and a dialog window
should appear allowing you to download the larger hi-res image.
Page 38 of 69
Sell Digital Products
UMG has a built-in PayPal payment gateway so you can sell your images and digital media
products using PayPal.
Choose the UMG Settings menu option, and locate this section:
Enable the Sell Downloads option, and enter your PayPal Processor ID, typically your PayPal
account email address. If you want to receive an order notification email to an address other than
your PayPal email address, enter an optional email address in the Order Notification field.
After enabling Sell Downloads, click Add New image and expand the Linked Download section:
With Sell Downloads enabled, you should see a Price field. Enter a price for each media item you
wish to sell.
The selling of digital products using UMG is made complete with the teamwork of two additional
UMG modules: UMG-ShoppingCart and UMG-PurchasedItems. The UMG-ShoppingCart
module should be added to the same page as the UMG gallery containing digital images for sale. The
UMG-PurchasedItems module can be added to any page in your web site.
Below you will see both a UMG gallery (top) and the UMG-ShoppingCart module (bottom), and
notice in the UMG gallery the highlighted Add to Cart button:
Page 39 of 69
Select a good image for gallery display and provide a Description of the image, to improve the
shopping experience for the buyer. The Add to Cart button is enabled only if (1) there is a Linked
Download file associated with this image, and (2) the Price of the image is not 0.00 (free). If either of
these selling conditions are not met, the Add to Cart button will be disabled.
Page 40 of 69
Any images added to the shopping cart are added immediately, without the need to refresh the page.
A popup message informing the buyer how to proceed to checkout is also displayed. When the buyer
clicks Proceed to Checkout, a confirmation screen appears:
When the buyer clicks Agree to Terms then Confirm Order, the buyer is directed to PayPal, to
complete the transaction using either a PayPal account or a credit card. Within seconds after
payment is confirmed by PayPal, UMG gets notification from PayPal that the transaction was
successful. The buyer can now download purchased images from the UMG-PurchasedItems module:
For more information on selling digital products with UMG, see the Linked Download section of
this user guide for details on preparing images for license or sale.
Page 41 of 69
Work with disk quota
You can limit the maximum disk space available for a UMG user - per person - or limit the disk space
available for an entire gallery.
Choose the UMG Settings option, then locate the Disk Quota Settings section:
Enter a numeric value in one or both fields to limit disk space usage, or leave one or both fields blank
to disable Disk Quota, setting no limits of the disk space available for UMG.
Once you apply a Disk Quota Setting, UMG will check to see if there is enough available disk space
before adding a new image or a linked download file. A notification message is displayed if the Disk
Quota is reached or exceeded.
If you see A Mathematical Operation Caused an Overflow exception error when you try to Add
New images, first attempt to decrease the Disk Quota settings. If you continue to experience this
exception error, you may be required to completely disable UMG Disk Quota settings.
Page 42 of 69
Work with EXIF Data
UMG is able to retrieve and interpret EXIF (EXchange Image File) data from JPEG (.jpg) image
file headers. In UMG, EXIF data is useful for sorting images by Date Taken, one of a number of data
fields that exist in EXIF data.
EXIF data is embedded with each image take by a digital camera, data which includes the current
camera settings and other scene information. Shutter speed, date and time, focal length,
exposure compensation, metering pattern and flash/no flash state are all examples of data
that may be stored in an EXIF header.
If all or most of your UMG images are imported from digital camera, you can allow site visitors to see
detailed EXIF info about each image when the image is clicked. To do this, from UMG Settings,
choose Presentation: UMG Classic or SideNav. These two presentations support EXIF detailed
information display. After selecting UMG Classic or SideNav presentation, check/enable this setting:
Return to the gallery and click an image. When you click an image, you should see a new browser
window that looks similar to this:
Page 43 of 69
Using the UMG Classic presentation, another popular use of EXIF data is to display EXIF info in an
image caption overlaying the image. Here is an example:
Notice the EXIF data displayed in the caption area at the top of the image. This feature is very useful
if you use UMG to share professional photographer photos. To enable this feature, click the UMG
Albums(
) menu option, then click the pencil/edit icon next to your chosen album. On the
album edit screen, locate this section:
Check/enable to Auto-Read EXIF option. The page refreshes and the default EXIF template is
loaded. Use the default template as-is, or edit the EXIF Template, then save changes and return.
UMG reads EXIF header from your images when you Add New items. If you enable Auto-Read EXIF
after you have added images to an album, existing images will not have EXIF data available. In this
Page 44 of 69
case, you can run the Rewrite EXIF command to refresh or re-read EXIF info for all existing images
in an album.
Page 45 of 69
Localization guide
UMG can be language localized like other DNN modules. To do so, simply add the appropriate locale
resource file to App_LocalResource folder. For more information about language localization, please
refer to the DotNetNuke manual which covers this topic in detail.
Some UMG presentations have locale specific text strings that you may customize, too. For example,
with the UMG Classic presentation enabled, mouse over the Play button, and you should see a
tooltip message:
To language localize specific presentations, you must customize an XML file associated with the
presentation. In the /DesktopModules/BizModules - UltraPhotoGallery/Swf_Resource folder,
find an XML file such as the UltraPhotoGallery.swf.xml file. Make a copy of this file, named for a
locale, for example, if your locale is fr-FR, name this XML file UltraPhotoGallery.swf.fr-FR.xml.
Open the XML with a text or XML editor, and you will see many key=value elements. Simply change
the language values to the language of your choice, then Save your changes.
Page 46 of 69
Lightbox View
With UMG Classic set as the preferred presentation, choose Appearance from the UMG menu:
With the Lightbox checkbox enabled, set When Click on a Photo to Launch Lightbox View.
When you click on a picture in your gallery, a Lightbox View pops up from the center of your
browser:
Click the Close button or any area outside the Lightbox View to close the image and return to the
gallery.
You may also choose to click the Lightbox(
) button in the control bar to browse ALL images in
this album in a Lightbox View.
Page 47 of 69
When you open Lightbox View from the menu, additional navigation is available. You can use the
Previous and Next buttons, or your Left and Right arrow keys, to browse images in this album
using your keyboard keys.
Lightbox View is also available in UMG-TopPhotos and UMG-TopAlbums modules. See more
information about these modules in the Satellite Modules section of this user guide.
Page 48 of 69
Dynamic Gallery
From the UMG Settings screen, locate Gallery Mode and select Dynamic. You should see the
following settings appear:
All folders under your web site root which contain images will be available for selection from the
Source Folder dropdown list. Choose a folder with images to establish a dynamic connection
between the folder and the gallery. To improve performance, UMG can automatically cache your
dynamic gallery at hourly intervals, which you can specify using the Refresh Interval setting.
If your Source Folder contains sub folders and your selected presentation supports multiple albums,
UMG will generate sub folders as nested albums. If your selected presentation supports a single
album only, the folder structure under the Source Folder is ignored. In this case, UMG will render a
single album containing images from the Source Folder and all sub folders. Below is an example
display of the UMG Classic presentation, which supports multiple albums:
For Dynamic Gallery Mode, the folder name is used as the Album Title. To change the default Title
or Description of an Album, create an album.xml text file in the corresponding Dynamic folder. The
basic format of this XML file is as follows:
<album title="My Album Title" audio="friends_lullaby.mp3" audioCaption="My Audio Caption"
Page 49 of 69
description="My Description" />
If you choose to add background music for this album, the named mp3 file must exist in this
Dynamic folder. If you want to set the logo for an album, add the logo="logo file name" property. The
logo property can be a valid URL or a file that exists in this folder.
Page 50 of 69
Popup & Embed Code
You can create a popup browser window to view a UMG gallery, or you can embed a UMG gallery on
another page or website. Click the Code(
) menu option at the top of the gallery:
Popup Code for this gallery is displayed in the top textbox. Copy this code and paste it in an HTML
web page anywhere you wish to display an option to view this gallery. If you want to customize the
title that displays in the browser title of the popup window, enter it in Window title textbox and
click Regenerate.
The most common use of Popup Code is in an DNN HTML/Text module on inserted on some page
other than the UMG gallery page. When adding Popup Code to an HTML/Text module, depending
on your DNN editor, you may need to switch the editor to Basic Text mode before pasting code:
Page 51 of 69
The text link Click here to see popup gallery! is text you can change to suit the design of your web
page.
To embed a gallery, on the Code (
) screen, copy the Embed Code to your clipboard, and paste it
wherever you would like this UMG gallery to appear embedded in a web page. You can Embed Code
for a UMG gallery into an HTML/Text module, or even on another non-DNN website. You can also
Embed Code to a forum post, to an email body - wherever HTML and JavaScript is enabled!
Please note that after you edit images in a gallery with an Embed Code link to it, you MUST click the
UMG Gallery menu option to display the gallery. When you click Gallery after editing images in an
album, UMG rebuilds XML files that are required to render the gallery properly with Embed Code.
Page 52 of 69
Personal gallery mode
Gallery Mode: Personal Gallery is a powerful feature that allows you to provide personal image
gallery services on your website. Users who are authorized can create their own albums and
manage the images in those albums. These users can share their personal album with others using a
custom URL address that points directly to their album only.
To enable this option, navigate to Settings screen and scroll down to find locate this section:
Choose Gallery Mode: Personal Gallery. In the Permission Set section of this user guide, the
Gallery Manager option is used to specify content managers for a gallery. But when using UMG in
Personal Gallery mode, the Gallery Manager setting is used to specify which DNN Roles have the
ability to create a personal gallery. If, for example, you wish to allow all Registered Users the option
to create and manage a personal gallery, enable the Registered Users role in Gallery Manager.
When you login as a user who belongs to a Gallery Managers role, you will see an empty gallery if the
user has not yet added any images to their personal gallery:
Page 53 of 69
Most UMG menu options are available to a Personal Gallery user, except for
users are able to create albums and add/edit images. The Appearance(
. Personal Gallery
) option allows the
Personal Gallery module user to change colors and the appearance of this gallery. Note that these
Appearance settings affect one Personal Gallery user only. UMG maintains unique Appearance
settings for each user with a Personal Gallery.
Notice the Share(
) option located at the top right of the gallery. When the Personal Gallery mode
user is logged in and clicks Share:
... UMG displays a unique share link which the user may share with friends, family and associates, so
these people can see the UMG personal gallery, too.
Page 54 of 69
Profile Integration Mode
Gallery Mode: Profile Integration allows you to configure UMG to display specific images added to
a gallery by any one UMG user. With UMG set to mode Profile Integration, you can, for example, use
DNN's unique user identifier UserID embedded in URL querystring, to index and display only one
user's images from a gallery that contains images created by many users.
A UMG instance set to Profile Integration cannot be used to Add New or Manage images, or modify
an album. For this reason, a UMG gallery set to Profile Integration mode is used as a display-only
gallery. Another UMG instance, set to Personal Gallery mode, for example, is the UMG gallery
where the user may add, edit and manage images.
Under the UMG Settings menu, here is the Gallery Mode setting you should set to Profile
Integration:
The Data Source setting specifies from what UMG gallery UMG should display albums and images.
This gallery can be a Normal Gallery where users added images to a public album, or the gallery
can be a Personal Gallery where users only manage their own albums and images.
The User Key value is the critical indexing value that UMG extracts from a querystring appended
to a URL that points to the page where the Profile Integration UMG gallery is displayed. Using this
value, UMG looks up the value and identifies the user and displays only images created by this user.
You must know the user's unique identifier before you can put that value in a querystring and display
specific images for that user only.
The User Key may be DNN's UserID property, or it may be another unique identifier used by any
module that creates a unique key for each user, and that module may be used with UMG Profile
Integration to display only one user's images.
In this first example, we use Smart-Thinker's User Profile module, which allows you to create a user
directory, and from that directory, choose one user's profile information to display in more detail:
Page 55 of 69
In the user directory, we choose a user by clicking on the user's avatar. When the page refreshes, we
see detailed profile information about this user. We notice that the URL in the address bar changes
to something like this:
http://localhost/dnn480/UserDirectory/UserProfile/tabid/64/ID/3/Default.aspx
In this URL, we deduce that the number after ID is a unique user identification value. We can use
this value in a querystring to pass the unique user ID to UMG gallery set to Profile Integration mode,
displaying images only from user ID=3, as in this example.
In this second example, you may choose to use DNN's UserID property to display select images from
one user in a UMG gallery set to Profile Integration mode.
One way to identify DNN's UserID for a user is by navigating to DNN's User page, then clicking the
edit pencil next to a user's record. At the top of the page, (ID:##) displays the user's unique DNN
UserID.
Having just identified a user with DNN ID:17, for example, on a web portal with a page named
ProfileIntegration where we have added UMG set to Profile Integration mode, with UMG User
Key: UserID, we can pass to UMG this user's UserID in a querystring using this syntax:
http://...full URL path.../ProfileIntegration.aspx?UserID=17
The UMG gallery set to Profile Integration mode on the page named ProfileIntegration displays only
images created by the user pointed to by UserID 17, if that user has created any images in this gallery.
With UGM set to use the RightHeader presentation, we see only images by user with UserID=17:
Page 56 of 69
Not only can you use UMG Profile Integration mode as described above, but you can also integrate
with other modules such as Active Forums, Private Messages, etc. For this reason, the Profile
Integration mode User Key can be configured to work not only with DNN's UserID, but with other
key identifiers used by other DNN modules.
Page 57 of 69
Private child albums
Private Child Albums is a valuable UMG feature that configures UMG with a unique set of
permissions to allow for the following situation:
users in selected Role can create their own albums in a group gallery;
users only have Album Edit access for albums they create;
Normal Mode setting allows all private albums to be visible in one gallery.
Under the UMG Settings option, locate these option:
Enable the checkbox Allow Private Child Album Creation. Turning on this option will make the
Private Child option available on the Edit Album screen, where individual albums are created.
When you create a new album under the Public User Albums parent album, the Private Child
option will display just below the Auto Resizing options.
Enable the Private Child setting, and consider this example permission set:
Under the Rights section of the Album settings screen, Registered Users are included in the
Composing Roles for this album. With this setting, when logged in, every registered user on your
site can create Private Child Albums under Public User Albums for this gallery.
Login as a user in the Registered User role, and click the UMG Albums(
) menu option:
Page 58 of 69
If this user has not yet created a Private Child Album in this gallery, Public User Albums (parent) is
displayed, but there are no child albums showing. Click Add New to create a Private Child Album:
The user can create an Album Type: Standard or RSS. Albums are created as child albums to the
album Public User Albums - which is fixed as the parent album.
After creating an album, return to the UMG Albums(
) option to see the newly created Private
Child Album located below the parent album:
Click the pencil/edit icon located to the left of the Private Child Album to edit properties associated
with the album. The user may now add images to their Private Child album using the UMG Add New
menu option.
Page 59 of 69
Integrate with Amazon S3
What is Amazon S3?
Amazon S3 (Simple Storage Service) is an online storage service offered by Amazon Web Services.
Amazon S3 provides unlimited storage through a simple web services interface. Data can be easily
stored and retrieved at any time, from anywhere on the web. For this service, Amazon charges you
based on (1) the amount of data stored, and (2) the bandwidth used sending and receiving data. For
further information about Amazon Web Services and S3, go to Amazon.com.
Amazon S3 is an ideal choice when you have several GBs of data or more on your website. Bandwidth
expenses are increasing as the popularity of the web continues to grow. Most hosting providers
require that you buy a predefined amount of disk space and bandwidth usage for data transfer, even
if you don't use all the disk space or bandwidth. When you buy 10GB disk space and 100GB data
transfer, you pay full price even if you only use only 1% of your total space/bandwidth.
But Amazon S3 is different. Amazon S3 does not require that you buy either fixed disk space or data
transfer bandwidth. With Amazon S3, you pay only for what space/bandwidth you use, nothing
more.
S3 Integration Wizard
Beginning with UMG version 5.4, S3 integration is built-in to UMG. To enable S3 integration, simply
step through the S3 Integration Wizard. Login to your DNN website with Host level permissions.
At the bottom of the UMG Settings screen, click Amazon S3 Integration to start the wizard:
Step 1: Enter your Amazon Access Key. If you do not yet have an access key, login to Amazon.com
and sign up for Simple Storage Service. You will receive a pair of keys, including an Access Key ID
and Secret Access Key.
Step 2: Name the Bucket where you are storing your files on Amazon S3. You can consider a bucket
as equivalent to an Internet domain, where your files can be accessed as
http://bucket.s3.amazonaws.com/bucket. Note that a bucket name must be unique across all of
Amazon S3, so you may not be able to use common words for an Amazon S3 bucket.
Page 60 of 69
Step 3: Adjust the Batch Quantity, if necessary. By default, UMG transfers 10 items to Amazon at a
time. An item does not equal one image. In UMG, you can attach a logo and MP3 background
music to an album. You can also attach a Linked Download to an image. These files are transferred
to Amazon S3, too. For the purposes of the Batch Quantity setting, an item could be a image, an
album including a logo or background music, or a linked download.
Step 4: UMG informs you if the Amazon S3 Scheduler is not installed. You can install it by clicking
the S3 Integration Wizard Finish button. Once the scheduler is installed, you can see it listed in
DotNetNuke Host > Schedule. The task runs every hour by default, but you can alter the frequency
in Schedule. Please note that the minimum interval this task may be run is every 15 minutes.
Having finished the S3 Integration Wizard, UMG begins to work quietly behind the scenes. Your
photo images, album logos, MP3 background music and linked downloads will be transferred
automatically to the Amazon server. Once an item is successfully transferred to Amazon S3, it is
deleted from your server hard disk. Also, when you delete an item in UMG locally, on next
connection to Amazon S3, related files are removed from Amazon S3 to conserve S3 disk space.
It may take a few hours or even a few days to transfer all your images and UMG items. For example,
if the Amazon S3 scheduler runs once each hour (24 times per day) and 10 items are transferred with
each connection, 240 items are transferred each day. If you have 2,300 photo images, 50 albums and
50 linked downloads, approximately 10 days are required to transfer all files.
To check to see how many images have been successfully transferred to Amazon S3, you can run this
query in Host > SQL:
Select count(*) from {databaseOwner}{objectQualifier}BizModules_UPG_Photo where
AWS_PhotoKey<>''
Important Notice
Some presentations, like Virtual Tour from the Generic Presentation Pack, require that your images
be hosted in the local domain only. A gallery built with Virtual Tour will not work properly if images
are transferred to Amazon S3 server. To avoid this problem, you can run this query in Host > SQL to
exclude from the Amazon S3 transfer list UMG galleries built with Virtual Tour.
This SQL must be run BEFORE using the S3 Integration Wizard:
ALTER PROCEDURE {databaseOwner}{objectQualifier}BizModules_UPG_PhotoListTransferable
@maxItems int
AS
Page 61 of 69
SET ROWCOUNT @MaxItems
SELECT P.* FROM {databaseOwner}{objectQualifier}BizModules_UPG_Photo P
INNER JOIN {databaseOwner}{objectQualifier}BizModules_UPG_Album A on P.AlbumId=A.ItemId
INNER JOIN {databaseOwner}{objectQualifier}ModuleSettings M on A.ModuleId=M.ModuleId AND
M.SettingName='PreferedPresentation'
INNER JOIN {databaseOwner}{objectQualifier}BizModules_UPG_Presentation P2 on
M.SettingValue=P2.ItemId
WHERE
(ISNULL(P.Src, '') <> '' AND lower(substring(P.Src, 1, 7)) <> 'http://' AND lower(substring(P.Src, 1, 8))
<> 'https://')
AND P2.Name <> 'VirtualTour'
ORDER BY ItemId ASC
Page 62 of 69
Satellite Modules
Top photos & Top comments
The UMG-TopPhotos module allows you to build a list of images from one or more albums in a
gallery. The UMG-TopPhotos module can be placed on the same page as the gallery from which
albums and images are displayed in UMG-TopPhotos.
Using UMG-TopPhotos, images can be sorted by (1) the most recently added image, (2) the highest
rated images, and (3) random order. These are the settings for the UMG-TopPhotos module:
The HTML Template settings can be used to customize the look of the list of images. Click the
Help/Tooltip for HTML Body to see a complete list of all available [tokens] that may be used in the
HTML Template fields.
Two useful template examples come built-in with UMG. From the Load from Library dropdown
field, select either JavascriptSlideShow or MultiColumns, then click Load to pre-configure the
Page 63 of 69
HTML Template settings. JavascriptSlideShow uses Javascript to display images one by one, and
MultiColumns display multiple image thumbnails in a row/column format. Use these templates
"as-is", or customize them to suit your needs.
The UMG-TopComments module is very similar to the UMG-TopPhotos module, except
UMG-TopComments does not contain predefined templates. UMG-TopComments can display a list
of image comments sorted by most recently added comment, or by highest rated comments.
Page 64 of 69
Top Albums
UMG-TopAlbums module allows you to quickly build a list of albums. Here are the UMG-TopAlbums
settings:
The Module setting is a dropdown list that allows you to select (1) one gallery from which to show
albums, or (2) all gallery instances in this portal.
Choose a Sort By order, and if you wish, set a limit on the number of albums to show in the list by
entering a number in the Album Count setting. Items Per Row allows you to set how many albums
to display in each row of the album list that is created by UMG-TopAlbums.
UMG-TopAlbums supports a Lightbox view which is enabled using the Use Lightbox setting.
Page 65 of 69
The figure above is a combination of two screenshots. In the upper left corner, the
UMG-TopAlbums module displays a list of two albums from a gallery. The main image is the
Lightbox view available when you Use Lightbox, allowing you to view images without any particular
presentation. If you disable Use Lightbox, clicking a gallery name or image in the UMG-TopAlbums
list will bring you to the web page where the gallery is configured.
Page 66 of 69
Photo calendar
The UMG-PhotoCalendar module can be used to create a calendar view of all of your gallery
images.
When you add the UMG-PhotoCalendar module to a page, you should see a screen similar to this:
Photo Calendar arranges your images by date, which allows you an easy way to access images for a
specific date. By default, images are grouped by the date you add the images to UMG. If you are
adding photo images from a digital camera that assigns a Date Taken property to each photo, you
can set Photo Calendar to group images by the date the photo was taken, not the date the image was
option in UMG Settings if you want to
added to UMG. Enable the
group Photo Calendar images by Date Taken, not the date added to UMG.
If Lightbox is enabled for this gallery, a Lightbox View is launched when you click on a specific date
that has one or more images assigned to it. If Lightbox is not enabled, the main gallery is displayed.
You can also click the Week number labels in the first column of Photo Calendar to see images
from the full week.
Page 67 of 69
Media Importer
The UMG-MediaImporter module is built to do the following work for you:
1. Import images from a portal directory to a UMG album;
2. Transfer or Move an album from one UMG gallery to another UMG gallery;
3. Map an album from one UMG gallery so it appears in another UMG gallery.
Choose Import from a Directory in Current Portal to easily import images in one bulk process.
Select a Source Directory and a Destination Gallery and Album. Please note that you must first
place at least one new UMG gallery on a page in your portal, allowing the UMG New Gallery Wizard
to create a default album, before you can import images using UMG-MediaImporter.
Choose Transfer an Album to Another Gallery to either Transfer (move) or Map images from
an existing UMG gallery/album to appear in another gallery.
The ability to quickly Map an album is very useful. Consider the situation where you have a page
containing a UMG gallery with multiple albums. However, you would like to show only one of these
albums in this gallery on your homepage. To re-create the album on your homepage gallery, just Map
it. Map does not create a copy of the images; Map refers to the images in the source album and
displays them in the target album.
The UMG-MediaImporter module screen is displayed below:
Choose a Source Gallery and Album, and select the Destination Gallery. Then, if you wish to
Move the album, click Transfer. If you wish to display an album from one UMG instance in another
UMG gallery, click Map. Note that Transfer will remove and delete the album from the source gallery,
but Map will leave the source album unchanged in the source gallery.
Page 68 of 69
Search Module
Ultra Media Gallery supports the use of the built-in DNN search interface, so you can use the default
DNN search engine to locate images in UMG galleries. The default DNN search engine searches
through UMG image Titles and Descriptions, and this search engine requires that your search
query match a word in Title or Description exactly.
However, with the UMG-Search module, you can an search for part of a word. For example, if the
Title of an image is "My Family", and the Description is "This picture was taken on my baby's
birthday", using the DNN search engine, you must match the whole world "birthday" to find this
image. But using UMG-Search, you could find this image even by searching for "birth" or "baby".
Add the UMG-Search module to a DNN page and you should see the search interface shown below.
UMG-Search modules uses AJAX to render search results, so the current page is not re-loaded when
the search button is clicked. Enter a keyword, choose an album (or default In All Albums) and click
the magnifying glass to search for the keyword:
Page 69 of 69

Ultra Media Gallery 5 User Guide

Transcription

Similar documents

Mileece_General Info 2011_tree

the press release here.

Kulturzentrum "Treffpunkt Stadtmitte" Wendlingen

31-2301 Taluswood Place_eBrochure

The Entire Article

invitation - American Scandinavian Society

Zarouhie Abdalian

Los Angeles Adds to Growing Art Scene

GEORGE BILLIS GALLERY JOSEPH PICCILLO

THE NEW ALBUM ON BLUE ROSE RECORDS CD