Ultra Media Gallery 6 User Guide

Transcription

Ultra Media Gallery 6
User Guide
Expand the “Bookmark” menu in left side to see the table of contents.
Copyright by bizmodules.net 2005 – 2010
Page 1 of 68
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 10+ customizable Flash and Html views. You
can subscribe to Flickr, Google Picasa, or other image sources by RSS so you can use UMG's high
quality interface to warp these images. UMG also allows you to sell digital media products or prints online
so you can benefit from it. 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 for 4 year, 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 use license if you intend to use UMG in a single DotNetNuke installation, then add
additional licenses as needed for other installations. Or for enterprise users, an unlimited use 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 image viewer, a
Lightbox viewer, an image rotator, a headline rotator, and more. With Ultra Media Gallery, you save
money because you get multiple Flash and html viewer 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.
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)
Page 2 of 68
Sample Galleries
Check www.bizmodules.net for sample galleries built by Ultra Media Gallery 6.
About this document
Ultra Media Gallery may be used to host photos or other kinds of images, the words photo and image
are used interchangeably in this user guide depending on context, when we say “Upload a photo” it
doesn’t mean you must upload a photo, any kind of image is ok.
Page 3 of 68
What’s new
An important difference between version 5 and version 6 is, in UMG 5, we sell 9 additional presentations
in a bundled offer called “Generic Presentation Pack”, which is an add-on that requires you to install
separately, in UMG 6, we no longer offer Generic Presentation Pack, instead there are 2 editions of UMG:
Standard Edition and Professional Edition, the professional edition includes all extra presentations
while the standard edition includes UMG Classic, Headline and SmoothGallery.
UMG 5 offers 11 presentations, all of them are flash based, which makes it impossible to work on portable
devices such as iPhone because the Safari browser in iPhone doesn’t support flash plugin, UMG 6 comes
with 4 new presentations: TiltViewer,
Highslide, MooFlow and SmoothGallery, the last 3 are fully
implemented by html+javascript, UMG will automatically switch to SmoothGallery when working on
iPhone.
Now UMG have 12 flash presentations and 3 html presentations in total. Visit our sample galleries on
bizmodules.net to see them in action. When working in Personal Gallery mode UMG allows each user to
choose his own preferred presentation.
Below are major enhancements in UMG 6：
1.
Fresh new design UI
in UMG 6 the UI is almost fully rewrote in a more modern style and offers greater user experience.
2.
Easy upload, easy manage
UMG 6 offers a brand new flash uploader, you can easily select dozens of files on your hard disk and
then upload them one by one automatically. UMG also allows you to quickly manage your photos in
Ajax manner.
3.
4 new presentations
UMG 6 offers 4 new presentations as mentioned above: TiltViewer,
Highslide, MooFlow and
SmoothGallery, please note only SmoothGallery is available in UMG 6 standard edition.
4.
Geotag support
Taking photos by iPhone or other cameras which includes a GPS device? UMG 6 is able to read the
GPS coordinates of your photos and show this point to site visitors.
5.
Google maps integration
UMG is deeply integrated with Google maps, you can see the shooting place on Google maps when
view a photo, you can build a full list of shooting places on the world map. You even can manually
mark the shooting place for your photos if your camera doesn’t have a GPS chip.
6.
iPhone support
iPhone doesn’t support flash. When UMG run on iPhone, UMG will automatically switch to an html
presentation – SmoothGallery - if a flash presentation was choosed.
7.
Integration of 3rd party javascript libraries
The UMG-FreeContentList module is used to replace the UMG-TopPhotos module in prior versions,
this module integrated numerous 3rd party javascript libraries like jQuery Cycle, Highslide, jQuery
scrollable, Space gallery, actually you can use them as extra html presentations for your galleries.
8.
Tag support
Page 4 of 68
Similar to Ultra Video Gallery and Ultra News Article, you can use tags to describe your photos, the
tags are displayed in UMG-Rate module when view a photo, your visitors can click it to see other
photos with this tag.
9.
Edit, Adjust, Crop images online
UMG 6 is integrated with Snipshot and Picnik, both are free web services that allows you to resize,
crop, enhance and adjust photos online.
10. Community mode
The new community mode allows specific user roles to create their own albums and photos, users can
access their own work only while all albums and photo are displayed together.
11. Users can choose their own presentation
when work in Personal Gallery mode, users can choose their own preferred presentation.
12. Sell image prints
This feature in available in Professional Edition only. The new UMG-OrderPrints module allows
you to sell image prints, users can select the size of the print, the frames, the colors and the shipping
method when place the order.
13. Widely RSS feed support
UMG 5 only support RSS feed published by Flickr and Google Picasa, in version 6 we support almost
all media rss feeds, as long as you can find http://search.yahoo.com/mrss/ in the header of your
RSS source, it will likely be accepted by UMG.
14. Enhanced support for Dynamic Gallery
UMG 5 have a Dynamic Gallery mode, which is able to build a gallery from a server folder, but there
are a lot of restrictions, you can’t rate it, comment it, you can’t sell it, you can’t search it….. in version
6 there is no restrictions at all.
15. Easily resort
When manage albums or photos you can use mouse drag and drop to adjust the sort order easily.
16. Get user avatars from profile modules.
Similar to Ultra Video Gallery and Ultra News Article, UMG can retrieve user avatars from 4 common
profile modules and display it in UMG-Response module.
17. AddThis support
You will find a Share link in the bottom of UMG-Rate module, which allows you to easily share a
UMG gallery by email or more than 200 popular websites such as facebook, digg, twitter, myspace…
For more information on the latest enhancements to UMG, please see the Release Notes, or try the
Trial Gallery to experience it.
Page 5 of 68
System requirements
Ultra Media Gallery (UMG) is designed to work in ALL DNN 4.5.x and higher websites, including but
not restricted to 4.5.x, 4.6.x, 4.7.x, 4.8.x, 4.9.x, 5.0.x, 5.1.x and 5.2.x.
Ultra Media Gallery even works on websites run in "medium trust" on shared servers.
As long as your DotNetNuke website is configured and working correctly, Ultra Media Gallery will work,
too.
Page 6 of 68
Installation guide
When upgrade from prior versions of UMG, you need to refer to Upgrade guide chapter at first.
The Ultra Media Gallery (UMG) installation will install both the UMG modules PA (Private Assembly)
and all 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:
When you use DNN 5.x the installation process will be different, there are some extra steps asking you to
accept the license and read the release notes, just follow it’s instruction to complete it is ok.
Now return to module definitions, scroll through the list of installed modules to see the UMG modules
like below screenshot. The first UMG module listed - Ultra Media Gallery - is the main module that
Page 7 of 68
must be configured to use UMG.
Then add the Ultra Media Gallery main module to a DNN page, finish the New Gallery Wizard which
will be discussed later, then you can see available presentation in settings(
) page like this:
Please note only 3 presentations are available for selection in UMG 6 standard edition, if you purchased
UMG 6 professional edition you should have a serial number, all presentations will be available after
activating it with your serial number.
Page 8 of 68
Un-installation 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. So it’s recommended to make a
reliable backup if you aren’t absolutely sure you do not need UMG data.
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, photos) 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 main 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 68
Upgrade guide
When upgrade from prior versions of UMG, you shouldn’t uninstall UMG before upgrading to version
6, this will cause to permanent lost of all of your photos as discussed in Un-installation guide chapter.
There are a lot of changes in this version, so we strongly suggest you to make a backup before
upgrade, both your database and website files.
To perform the upgrade, please follow these steps:
1.
If you enabled Ajax.net, please disable it in Settings(
) page.
2.
Login to your website by FTP
3.
Find /DesktopModules/BizModules – UltraPhotoGallery folder, rename it to anything else, if
you can’t rename it, you should at least delete Uninstall.SqlDataProvider in this folder.
4.
Uninstall all modules with UMG- prefix in Module Definitions, please be aware this doesn’t include
the main modules - Ultra Media Gallery, it will not cause to UMG un-installation since the
un-installation script no longer exists.
5.
Install UMG 6 as mentioned in Installation guide chapter.
6.
Delete the renamed folder.
After installing UMG 6 to overwrite your prior version, please visit one of your gallery for further
operation, in the About(
) page you can find a link like this:
Click this link to enter upgrade guide:
Page 10 of 68
Just follow this guide to make necessary changes to the file system, if the prior version is activated, UMG
6 will automatically activate it again.
If you can’t find the About(
) link in UMG menu bar, please ensure the Include "About" link in
module menu option is turned on in Settings(
) page.
Ajax.net is a 3rd party component in prior versions of UMG, this component is removed from your website
after finishing above steps. However, you should manually recover this file if you use another DNN
module which relies on this component, for example: Ultra Video Gallery 2.x and Swirlchat.
To manually recover it, you can unpack this file from the PA of UVG 2.x or Swirlchat and copy to your
/bin folder.
After the upgrade, you need to check the Settings page of every gallery instance and ensure all options
are properly configured, especially the presentation, you need to choose the preferred presentation
again for every gallery. Another side effect of the upgrade is, all satelitte modules are deleted, but this
should not be a big problem, you can use the new satelitte modules in UMG 6 to re-create them.
Page 11 of 68
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:
service@bizmodules.net
Page 12 of 68
Getting started
New gallery wizard
To create an Ultra Media Gallery (UMG) 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: Choose a UMG presentation for this gallery. If you are using the standard edition you may not
be able to choose all items. Choose your preferred presentation and click Next.
In the 2nd step you can set the gallery size. You may modify this setting later, if needed. Change these
dimensions or accept the default values, then click Next:
Page 13 of 68
Step 3: Select the source of the images that will display in this gallery. In most case you will choose
Web Upload in this step, then you will be instructed to create the 1st album to host your photos, then
you can go ahead to upload.
If you choose RSS Subscription in this step, you will be required to provide the URL of your RSS feed,
UMG will validate it and automatically pull these photos to your website.
If you choose Server Directory, UMG will scan your portal root folder and show you a list of folders
which contain images, you can select one and UMG will automatically build a gallery to display these
images.
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 chapters of this user guide.
Page 14 of 68
Gallery mode and presentations
Gallery mode
In Settings(
) page UMG 6 allows you to choose the run mode, you can choose one of 4:
1.
Normal
2.
Personal Gallery
3.
Profile Integration
4.
Community
In most case you will select Normal, in this mode, authorized users can create albums and/or upload
photos, everyone who have View Module permission in this module will be able to see all photos in this
gallery. Beside that, you can optionally turn on the view permission control feature, when enable it,
UMG check the view permission settings on each album and decide whether the end user can see it.
Personal Gallery is another useful mode, authorized users can create their own albums and photos, and
only the author himself can see his works, the author can get a unique URL which can be used to share his
personal gallery with anyone else.
Profile Integration is a display-only mode, you must use it together with other profile modules which
pass the user’s unique identifier (user id) in query string, UMG will read the user id from query string and
display this user’s photos.
Community is a new gallery mode in version 6, this mode allows authorized users to create their own
albums and photos but works among all users are displayed together.
You can find more detailed information about each gallery mode in later chapters.
Presentations
UMG 6 comes with 12 flash presentations and 3 html presentations, but only 3 of them are available for
selection if you use UMG 6 standard edition. After activate UMG 6 with a serial number of
Professional Edition all presentations will be available for selection.
There are 3 types of presentations:
Items under Full featured flash viewer are the most powerful presentations which support multiple
albums, beside that, UMG Classic and ShadowViewer support nested albums.
Items under simple flash viewer don’t support multiple albums, if you have more than 1 album and you
choose a simple flash viewer, photos in all albums will be combined.
There are 3 items under Html category, they use traditional html + javascript interface instead of flash.
Page 15 of 68
When a end user use iPhone to browse a gallery, UMG will automatically choose SmoothGallery if you
choose a flash presentation, because iPhone doesn’t support flash plugin.
Some presentations require some manual installation because some files are not distributed together with
UMG, for example: TiltViewer and SmoothGallery, please choose them and follow its instruction to
install these files.
Page 16 of 68
Upload photos
It’s very easy and fast to upload photos in UMG 6, assume you selected Web Upload as image source,
you will be navigated to the Upload(
) page when finish the wizard. Please note all photos in UMG
must be hosted in an album, you should see this page to create a simple album before upload the 1st
photo:
Simply click Quickly Create button to create your 1st album, if you are an experienced user you also can
use the Albums(
) page to create your album with full options.
Then you will be redirected back to the Upload(
) page:
What you see above is a flash application, you can use Add Files… button to select bulk files, the selected
files are displayed in the right pane, click Upload button to upload all of them, once finished you will see
Page 17 of 68
a confirmation like this:
If you are not able to use the flash upload application, you can find a link in the bottom of this page to see
a traditional html upload page:
This upload page even allows you to upload zip files, which may contain multiple photos but no folders.
Page 18 of 68
Manage photos
Every user who has permission to upload will have the My Work(
) link available from the UMG
menu. If you have added photos to an album, this is where you can find all photos that you have added:
If you have more than 1 album there will be another drop down list for album selection in this page.
Hover your mouse over any item, you will see three buttons, the lightning (
quickly edit a photo in lightbox window:
) button allows you to
In this window you can change its title, description and tags, click Update button to save changes, or click
Page 19 of 68
the big right arrow to save it and move to next item. The title of the modified items will have a red
appearance so you know which photos are changed.
To edit a photo with all options, click the pencil(
) button, you will be navigated to the edit photo page:
The above screenshot is taken from an early version of UMG 6, if you use UMG 6.5+, you will see 2 radio
buttons, Basic and Html, above the Description field, click the Html button if you would like to enter
photo description in html format.
The approval option is only visible when you have manage permission in this album.
You can see a Link to option in the bottom of this page, you can either link it to a DNN page, to a file on
current website or to an external URL, many presentations allow you to reach this URL when click on the
photo, but there are some exceptions, for example, in Widescreenshowroom presentation, if you turn
off the “play link as video” option the link you specified is useless, if you turn it on, the link is considered
as an flv or mp4 video URL and UMG will try to play it when reach this photo, if the URL you entered is
not a valid video URL UMG may not work correctly.
In the right pane of this page you can find buttons to rotate this photo or send it as the logo of belonging
album.
If you have Manage 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. For more information about permissions, please refer to the Permission
Set chapter of this user guide.
Page 20 of 68
The drop down list in the top left corner allows you to select an album to manage, if you have permission
in many albums.
Hover your mouse on any item, you will see buttons to manage this photo:
As you see in above screenshot, your mouse cursor is changed to
one to resort it.
, you can drag this photo over another
Page 21 of 68
Edit, Adjust, Crop images online
Sometimes you intend to upload a photo to UMG but you need to edit it in some way, such as to crop it or
adjust the brightness. You may need to use a photo editing software such as Photoshop to do this job
before upload, but this is time consuming and not every body is able to do it.
In UMG 6, we integrated 2 online photo editing service, Snipshot & Picnik, you can use one of them to
edit your photos online. It doesn’t require photoshop to be installed on your PC; it doesn’t require any
computer skill, you can get your photos edited and saved with a few mouse clicks.
Now try to upload a photo to UMG and edit it, you should see the Snipshot(
) link in the right pane,
clicking it will bring you to Snipshot:
you will see Resize, Crop, Enhance, Adjust and Rotate buttons to process this photo, when finished,
click the Continue button in top right corner, Snipshot will send this image back to UMG to replace the
old one.
Some uses prefer to use Picnik, but to use it you need to register on picnik.com to get an API key, then
you can enter this key in Settings(
) page -> Advanced Options:
Once you enter the API key, the Picnik(
) button will be visible when you edit a photo in UMG,
clicking it will bring you to Picnik:
Click Export button to finish it and send it back to UMG.
Page 22 of 68
Manage albums
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(
) page. Click the Albums(
) button from the UMG
gallery menu to see all albums that exist for the current gallery:
The delete( ) button allows you to delete an entire album but it will delete all photos in this album
together, so be careful when use it.
In default, latest created albums are placed in the front of other albums, simply drag and drop an album
to resort it.
If the presentation you choose support multiple albums, an Add New link will be displayed in the top
right corner of this page, click it to create a new album:
Page 23 of 68
Select your album type before click Continue, you also can set a parent for this new album.
Now let’s select standard album:
You must enter a title for this album, the server folder dictates the folder to store photos and other files,
in most case you don't need to change it.
Thumbnail Size specifies the size of thumbnails. When you upload a photo, UMG automatically
generates a thumbnail. With this setting, the thumbnail size may be changed to suit your preference.
Some UMG presentations may look better with larger thumbnails, for example, MooFlow.
By default, the Auto Resize feature is enabled. UMG automatically resizes uploaded files if the photo
resolution exceeds the Max Size specified here. If you wish to allow for uploading larger, higher
resolution photos, you may disable Auto Resize or set it to a larger value.
Enable the default album option 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.
UMG allows you to attach an mp3 file as background music for each album, some presentations can play
it together with your photos. However, if the DNN Administrator has not specified MP3 as a valid upload
extension, 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.
Page 24 of 68
Permission Set
Ultra Media Gallery allows for the management of permissions at two levels: Module-Level and
Album-Level. Module-Level permissions are set in the Settings page of a DotNetNuke module, and
Album-Level permissions are managed by UMG. To demonstrate how to configure module permissions,
in this example we have created two additional security 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 and possibly upload or manage if album-level permission
is granted, but users who have Edit Module permission have full control over this UMG module and all
menu items will be visible:
Page 25 of 68
Now we look more closely at the Album-Level permissions found in Albums > Rights section:
Add Photo Roles: users who can upload in this album;
Manage Roles: users who can manage existing items and Approve pending items;
Approval Roles: users who can approve pending items 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 in this album, but these photos must be approved by Managers or Approvers.
Managers can manage all existing items in this album, and so can Administrators, because Administrators
have Edit Module module-level permissions.
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:
Page 26 of 68
The user may upload and manage his own photos 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 upload too. If this
user were removed from the Registered User role, My Work and Upload 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:
For more information about manage, see the Manage Photos chapter 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 photos 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 27 of 68
Subscribe to RSS
UMG allows you to create albums from a media RSS feed, media RSS is an RSS extension designed by
Yahoo!, for further information about media RSS, check wikipedia, a lot of websites are offering media
RSS feed today, such as Flickr and Google Picasa.
In Step 3 of the New Gallery Wizard, you can choose to create a gallery from a valid media RSS feed, you
also can create it by clicking Add New link in Albums(
) page.
Simply enter the RSS feed URL in this page and click Update, UMG will validate this RSS and create this
album if its format is acceptable.
Generally, a media RSS feed that UMG accepts must meet at least 2 requirements:
1, xmlns:media=http://search.yahoo.com/mrss/ can be seen in the RSS header.
2, The URL of the larger photo and thumbnail are published in the RSS by media:content and
media:thumbnail node.
Simply search the xml source of the RSS to see if you can find these keywords, if you can find then it will
likely be accepted by UMG.
Page 28 of 68
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. Below is a screenshot of the Appearance settings for UMG Classic:
The UMG Classic presentation has the most options (60+ total) of all UMG presentations. Click the
triangle button to expand a section. 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 29 of 68
With some presentations, such as RandomPosition, you can specify a background image, which will
enhance the look of your Gallery. Click here to download some sample background images.
Page 30 of 68
Rate and comment
With the UMG Classic presentation selected, UMG allows users to rate and comment on photos inside the
flash player, you can see a series of star icons in the lower left corner of an photo:
When you click the star icons, a rating and comment window opens up:
A user can rate and comment on the image currently being displayed in a window. Existing 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:
The rate and comment feature can be enabled or disabled with the Allow Rating setting found under the
UMG Appearance settings.
When working with other presentations, you can use UMG-Rate and UMG-Response module to rate and
comment a photo. In the following example, we are using the SmoothGallery presentation, which itself
does not allow for rate and comment inside the player. But we can use it together with UMG-Rate and
UMG-Response like this:
Page 31 of 68
In default, UMG-Rate module requires a user to login before rating, if you would like to allow anonymous
users to rate, you should set the LoginToRate node to False in /DesktopModules/BizModules –
UltraPhotoGallery/UMGDefaults.xml and restart your website.
Beside the rating form, UMG-Rate module also displays the basic information of current photo, including
tags(keywords) and taken date, you can click a keyword to see other photos with this keyword.
The About this photo section in UMG-Rate module is template-driven, in DesktopModules/BizModules
– UltraPhotoGallery/Texts folder you can find 3 text files: AboutPhoto.txt, AboutPhoto_Exif.txt, and
AboutPhoto_Geotag.txt, the 1st one is for photos that do not have EXIF header, the 2nd one is for files
that do have EXIF header, and the last one is for photos that have EXIF header and Geotag information.
You can use below tokens in these 3 files:
[TITLE] - photo title,
[DESCRIPTION] – photo description
[CREATEDDATE]
[THUMBNAIL] – the thumbnail url
[PHOTOID] – the id of this photo
[AUTHOR] – the display name of author
[SUBSCRIBETOAUTHOR] – a link to subscribe to the author
[AUTHORID] – author’s user id
[TAKENDATE]
[ALBUMTITLE]
[ALBUMID]
[ALBUMDESCRIPTION]
[AVERAGERATING]
Page 32 of 68
[GPSCOORDINATES]
[TAGS] – tags, with links to see other photos with common tags
[ADDTOCART] – use this token to create a add to cart button when the sell option is enabled
[EXIF:xxx] – this token can be used to represent any exif field, for example, [EXIF:Model] will be
replaced to the camera model.
Note that the UMG-Rate and UMG-Response module does not work with some presentations such as
VirtualTour and Highslide.
Page 33 of 68
Image slideshows
A new presentation named Html Slideshow is introduced to UMG since version 6.5, which can be used
to create image slideshows and even slideshows of any html content, unlike other flash presentations, this
presentation is fully implemented by JavaScript and CSS with 20+ completely different display templates,
each template have its unique look and feel and can be used in different business circumstances.
At first let’s see a sample image slideshow built by Html Slideshow with “Tube-800x566” template:
Please visit our website to see more sample image slideshows and html content slideshows.
To benefit from this feature please at first ensure your UMG is 6.5+, then you can see this presentation in
the presentation list in Settings page:
Html Slideshow contains 15 slideshow templates for image slideshows and 6 templates for html content
slideshows, the Gallery Size option above applies to most of them, but please aware some templates such
as Tube-583x412 and Tube-800x566 have fixed size as the name suggests.
Then you can go to Appearance page to further configure it:
Page 34 of 68
In the top you can choose whether to use image slideshow or free text slideshow, when choose
image slideshow, it will play images you uploaded in this gallery, on the other side, if you choose free text
slideshow it will play the photo description instead of the image. Remember you can enter any html text
content in photo description in UMG 6.5. Click here to see an example.
In the 2nd place you can see a list of all available templates, templates are just sub-folders located in
/DesktopModules/BizModules - UltraPhotoGallery/HtmlSlide/templates folder, if you want to modify a
core template to better meet your needs, just clone a core template and make necessary changes to the .css
file to alter the layout and appearance, and optionally modify the .js file to alter the functionality, that’ all.
The Image Transition field dictates how to transfer from one image to another, similarly, the Caption
Transition field dictates how to transfer a caption from one to another, the switch-top and switch
transition means to slide up or slide down, if the caption control in chosen template is on bottom area,
you should not choose switch-top transition because it looks pretty weird, vice versa.
The Easing Effect field dictates the easing function to use for the transition, choose each of them to
experience it if you are not familiar with it.
All templates support unlimited amount of slides, but you can use the Max Slides option to limit the max
number of slides to be displayed, the “choose slides in” option can be set to Predefined or Random, when
set to random, you can setup a rotator gallery which randomly display part of all images.
The Auto Play field can be used to set whether to play slides automatically and the play speed.
Page 35 of 68
Html Slideshow contains many
“controls”, a “control” is a specific UI part, for example, the
“Countdown” control is the area which displays the remaining seconds before transfer to next slide, and
“Entire Caption” is the area which displays the photo title and descriptions. Some controls are available in
all templates link the caption, yet some other controls only work in specific templates, if a control is
available in chosen template and you dislike it, you can hide it by Control Visibility option.
Html Slideshow supports left and right arrow key in keyboard, you can optionally disable this feature.
The next field is used to set the behavior when mouse over a slide, one of the options is “move to this
slide”, this option should only be used when all thumbnails and titles can be displayed in single screen
without scrolls.
In the last section you can configure the colors for slide background and texts, but please note the text
color doesn’t apply to texts which the chosen template clearly defined its color, for example, in the
Title-Bottom template, the titles bar in the bottom always have a white appearance because it have a black
background. If you want to change this color you need to manually alter the .css file in chosen template
folder.
Page 36 of 68
Publish RSS feed
In the UMG Settings(
) screen, scroll to the page bottom:
You can find a piece of html code which can be used anywhere to show an RSS subscription link, the RSS
feed published by UMG contains media RSS extension, so it’s possible to subscribe it from another
instance of UMG.
Note that UMG can publish RSS in any gallery mode, but you may need to disable it in Personal Gallery
mode because your users may not want their photos to become public.
The previous chapter mentioned [SUBSCRIBETOAUTHOR] token in UMG-Rate module, this token
can be used to subscribe to a photo author, for example, you can include this piece of html code in
AboutPhoto.txt:
<a href=” [SUBSCRIBETOAUTHOR]”>Subscribe to this user!</a>
This will be quite useful if you build a community website.
Page 37 of 68
Advanced topics
Sorting criteria
By default, UMG sorts your photos by Created Date | Descending Order. This is a popular sequence,
however, if you would rather use another order, you may choose an alternate sorting order.
Click the UMG Settings(
) option, and locate the Default Sorting section:
UMG allows you to sort photos by 2 criterias. it 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.
The available sorting fields are:
1.
File name
2.
Numeric parts in file name
3.
Created date
4.
Taken date
5.
Title
6.
Description
Created Date is the default sorting field. Images are sorted by the date added to UMG. 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 change made to the Sorting Method does not immediately change the order of existing photos in the
album. UMG will re-sort photos into the new Default Sorting order when a new photo is added.
Page 38 of 68
View permission control
In Normal gallery mode, view permission control allows you to set 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:
Then edit one of your albums, under the 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.
With nested parent/child albums, if a user has view permission for a child album but not for a parent
album, the user will not see the child album.
When you first enable view permission control, existing albums are not viewable by anyone because
View Roles for all albums are blank. You must edit each of them to configure it.
Page 39 of 68
High-res version
You can attach a file as High resolution version to any photo so that your website visitors can download it
when viewing a photo. In most case the high-res version is the original file imported from your camera,
but we don’t limit the file type so actually you can upload anything 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 enable the sell option in Settings page you can sell the high-res version, users will only be able to get
it after buying it.
At first please enable this option in Settings page:
Then when you edit a photo, you will see this option:
Browse the file you would like to link and click the attach button.
You may upload a large, high-res photo to a gallery, but you want UMG to automatically resize it to proper
resolution so the photo can be viewed more quickly. 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 steps:
1.
From UMG Settings, choose presentation: UMG Classic.
UMG Classic, SmoothGallery and SideNav are able to use the high-res version.
2.
In the Settings screen, ensure “Keep track of the original file when resize a photo” is enabled.
3.
On the album level, be sure Auto Resize is enabled.
4.
Upload a large photo to an album, UMG will resize it to the Max Size specified in Auto Resize section,
and save original file as high-res version of this photo.
5.
Click Appearance(
) and be sure to choose this setting accordingly:
View your gallery and locate the photo you just uploaded. Click the image, and a dialog window should
appear allowing you to download the larger high-res version.
Page 40 of 68
Sell digital products
UMG has a built-in PayPal payment gateway so you can sell your photos and digital media products using
PayPal.
Choose the UMG Settings menu option, and locate this section:
Enable the sell option, and enter your PayPal account ID which should be an email address. Then you
need to set the price of each item in this gallery, please note this is a great difference comparing to prior
versions, in UMG 5 you should set the price individually.
The selling of digital products using UMG is made complete with the teamwork of two additional UMG
modules: UMG-ShoppingCart and UMG-PurchasedItems. The ShoppingCart module should be added to
the same page as the UMG gallery containing digital products for sale. The UMG-PurchasedItems
module can be placed anywhere.
Below you will see both a UMG gallery with UMG Classsic presentation (top) and the UMG-ShoppingCart
module (bottom), and notice in the UMG gallery the highlighted Add to Cart button:
Select a good image for gallery display and provide a Description of the photo, to improve the shopping
experience for the buyer. The Add to Cart button is enabled only if (1) there is a high-res version
associated with this photo, and (2) the price is not 0.00 (free). If either of these selling conditions are not
met, the Add to Cart button will be disabled.
Page 41 of 68
Any photos 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, if you are not logged it you are required to login
before confirm it, after confirmation, 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, the buyer
can now download purchased items from the UMG-PurchasedItems module:
Only UMG Classic presentation have the integrated Add to cart button, if you have other presentations
you can use the [ADDTOCART] token in UMG-Rate module to have such a button, for more
information please refer to Rate and comment chapter.
For more information on selling digital products with UMG, see the High-res version chapter of this
user guide for details on preparing images for license or sale.
Page 42 of 68
Sell prints
The above chapter discussed how to sell digital products in UMG, UMG 6 Professional Edition also
allows you to sell prints. To archive this you need an additional module UMG-OrderPrints. You should
be able to get it together with UMG after order the Professional Edition.
To order a digital product UMG requires the user to login before putting the order, but this is not required
when order a print.
The UMG-OrintPrints module use the same paypal account ID mentioned in previous chapter, you
must enter your account ID to accept payment.
At first please install the UMG-OrderPrints module after installing UMG 6, then you can add it to a page
where you already have a Ultra Media Gallery main module.
Follow its instruction to configure it in Module Settings page, you should define at least 1 color, 1 size, 1
border and 1 shipping method:
The price set on Size or print is the base price, you can set an additional price when the user selects
specific border, color, or shipping method. The additional price could either be a fixed amount or a
percentage.
This module also allows you to collect tax for every order.
Having all options defined. You are ready to sell prints now, try to login as a normal visitor and use the
order form to add some items to your cart, it’s pretty simple. At the last step of the order, you will be
Page 43 of 68
redirected to Paypal to finish the payment, then you will get a secret query key which can be used at any
time to check the progress of your order.
Users who have edit permission can use the View Orders link in module menu to search orders:
You can find all paid orders in this form, click the View link to see the details of this order, in the detail
page you can find a Being printed button for paid orders, this button will change the status of this order
to being printed and the client will get an notification email, similarly, a Issued button is available for
orders being printed.
Page 44 of 68
Work with disk quota
UMG 5 allows you to set disk usage quota, e.g. the maximum disk space a user can use, in version 6 it’s
changed to a limitation of maximum number of photos.
Choose the UMG Settings option, locate the Disk Quota option:
Select the maximum number of photos a user can upload, or select unlimited to disable it.
Page 45 of 68
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 taken date, 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
UMG Classic presentation, then check this in Appearance settings:
Return to the gallery and click a photo, you should see a new browser window that looks similar to this:
When using UMG Professional presentation, you can see EXIF information inside the flash player like
this:
Page 46 of 68
Page 47 of 68
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 inside the flash player that you may customize,
too. For example, with the UMG Classic presentation enabled, mouse over the Play button, and you
should see a tool tip message:
To language localize the flash player, 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 48 of 68
Lightbox View
You can launch lightbox view in many ways, for example, with UMG Classic set as the preferred
presentation, choose Appearance from the UMG menu, you can set when click on a photo to Lanuch
lightbox view. Then when you click on a photo in your gallery, a Lightbox View pops up from the center
of your browser:
You also can enable the Lightbox button in Appearance settings page, then
button will be visible in
the control bar, when click on it you can browse all photos of this album in lightbox window, notice there
is a Prev and Next button:
The UMG-FreeContentList module offers a lot of templates to display photos, most templates for photos
open lightbox window when click on a photo. This module also can be used to display albums, if you
toggle the in Lightbox option you can see view entire album in lightbox window.
Page 49 of 68
Dynamic Gallery
UMG 5 offers dynamic gallery mode, which is used to scan a server directory and build a gallery
dynamically in run time, there isn’t corresponding data records in database so there are a lot of
restrictions, for example, you can’t rate it, can’t sell it …
UMG 6 no longer offers a dedicated dynamic gallery mode, instead, you can set the root folder of your
gallery:
You can set it to any folder which exists under your portal root. In most case you don’t need to touch it,
but if you want to change the default storage location or you want to build a gallery from a existing folder
you can set it to a valid path. Then you need to enable this option:
Then UMG will monitor the root folder periodically, if UMG find an unknown folder, it will be created as
an album, if UMG find an unknown image file, it will be added as a photo. With this option you don't need
to login to UMG at all while keep your gallery fresh. You just need to use FTP to create new folders under
the root to create new albums, and upload images to the corresponding folder to add photos.
You even can create nested folders, for example, if you create a “2010” folder under the root, UMG will
create a “2010” album, then you create a new “January” folder under “2010” folder, UMG will create a
“January” album and “2010” album will be its parent.
Page 50 of 68
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 their own
work. 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:
Choose Gallery Mode: Personal Gallery. Then choose which roles are allowed to create personal galleries,
for example, you wish to allow all registered members the option to create and manage a personal gallery,
select Registered Users.
In default the user id in query string is encrypted, you can optionally turn if off.
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 photos to their personal gallery:
Most UMG menu options are available to a Personal Gallery user, except for Setting(
Gallery users are able to create albums and upload photos. The Appearance(
). Personal
) 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 51 of 68
UMG allows a personal gallery user to choose his own presentation, please note some presentations
such as SmoothGallery and TiltViewer requires some manual operations after installation, so be sure to
finish them if your gallery work in personal gallery mode.
Page 52 of 68
Profile Integration Mode
Gallery Mode: Profile Integration allows you to configure UMG to display specific photos 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 query string, to index and display only one user's images
from a gallery that contains photos created by many users.
A UMG instance set to Profile Integration is used as a display-only gallery, for this reason, nobody can
create albums or upload photos. Another UMG instance, set to Personal Gallery mode, for example, is the
UMG gallery where the user may upload, edit and manage photos.
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 photos. This
gallery can be a Normal Gallery where public users can upload to a public album, or the gallery can be a
Personal Gallery where users only manage their own albums and photos.
The User Key value is the critical indexing value that UMG extracts from a query string 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 photos created by this user. You must
know the user's unique identifier before you can put that value in a query string and display specific
photos for that user only.
The User Key may simply be UserID, 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 photos.
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 53 of 68
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 the unique user identification value, so obviously ID is
the key of the user identifier in query string. The rest is simple, I create a new gallery in the user profile
page, configure it to run in profile integration mode, set user key to "ID" rather than default "UserId",
then browse one's profile again, all photos added by this user in current portal is displayed beside his
profile, in this sample I use RightHeader presentation:
Page 54 of 68
Not only can you use UMG Profile Integration with Smart-Thinker profile, but you can also integrate with
other modules such as Active Forums, Private Messages, etc. just find out correct user key is ok, for
example, the user key for Active Forums is uid, and Private Messages use SendTo.
Page 55 of 68
Community mode
UMG 5 offers private child albums feature, which can be used in following situation:
1.
users in selected role can create their own albums in a gallery;
2.
users only have fully access to their own albums;
3.
albums created by all users must be displayed together;
The private child album option is removed in version 6, instead we have a new Community mode. Under
the UMG Settings option, locate these options:
When work in community mode, you must assign which roles are allowed to create albums, you also can
set the maximum number of albums each user can create, to demonstrate this feature I allow all
registered users to create albums, then I login as a normal user, these menu items are visible:
I can use Albums option to create my own albums, or just go ahead to Upload and follow its suggestion to
quickly create the 1st album, I have full access to the album created by my self, yet nobody else can access
my work except users who have manage permission in this gallery, my albums are be displayed together
with albums created by all other users.
Page 56 of 68
Geotag & Google maps
Some modern digital cameras and smart photos have embedded GPS chips, the GPS coordinates of the
shooting place is recorded in the Jpeg file header while you shoot a photo, which is called Geotag, UMG
is able to read and use the Geotag data.
Click here to download some sample photos taken by iPhone 3G which supports Geotag.
When upload a photo, UMG will automatically detect its file header to see if the GPS coordinate is
presented, if exists, the coordinate will be saved to database together with your photo.
You can see the GPS coordinate in UMG-Rate module when you view a photo:
Clicking the coordinate will show you this point on Google maps.
Beside that, the UMG-Map module can directly show you the shooting place on Google maps when you
see a photo, to use this feature you need to register on Google to obtain an API key, then you can enter it
in Settings page of Ultra Media Gallery main module:
This is a global option, once you enter the key it works for all UMG instances within your portal.
Then you can place UMG-Map module on the same page as the main module, UMG will show you the
shooting place like this:
Page 57 of 68
If your camera doesn’t have a GPS device it’s impossible to record the shooting place information while
shoot it, but UMG allows you to manually mark it, just search of manually locate the shooting point on
Google maps and click it, you will see an information box like this:
If this is not the accurate point you can drag the red marker to further adjust it, then click “It was taken
here”, UMG will mark this point as the shooting place and save it to database, then the next time your
visitors reach this photo they can see this place as the previous screenshot.
UMG-FreeContentList module allows you to build a list of photos from an existing UMG gallery, one of
the display template is “Shooting place on Google maps”, when use this template you can get a full list of
shooting places on Google maps:
Page 58 of 68
Larger markers means photos taken in recent time, click any marker to see details:
Then you can click the thumbnail to see the larger photo in lightbox window. If you have multiple photos
taken in same place, you will see previous and next buttons in the lightbox window which allows you to
see other photos taken in this place.
In default, the map of entire world is centered in the stage, if your photos only comes from specific area of
the world, you may not want to see the entire world map, this can be done by using a custom template in
UMG-FreeContentList module,
for further information about custom template please refer to
UMG-FreeContentList chapter.
Page 59 of 68
In the settings page of UMG-FreeContentList module, select “Shooting place on Google maps” in core
templates list, then click Custom templates:
The header template is something like this:
<div id="map_canvas[MODULEID]" style="width: 520px; height: 320px"></div>
<script type="text/javascript">
//configuration
var default_latitude = 0;
var default_longitude = 0;
var default_zoom = 1;
var accuracy = .001 //about 111 meters;
var center_to_last_item = true;
//end of configuration, generally you don't need to change below codes
</script>
In the 1st line you can change the size of the map canvas, the default value is 520 * 320.
The default_latitude and default_longitude is the center of the map. you can change it to a valid
GPS coordinate if necessary. The default_zoom parameter is the zoom index, the default value allows
you to see the entire world, you can set it to a larger value to zoom in.
The accuracy value means the maximum difference allowed when UMG search for photos shooted in
same place, the default value is 0.001, so photos shooted in (36.0000 N, 106.0000 E) and (36.0008 N,
106.0010 E) will be considered as in same place.
If you live in the US and all of your photos are shooted in US only, you can set default_latitude to 40, set
default_longitude to -90, set default_zoom to 3, then you will see north America centered in the map.
UMG-FreeConentList module is not specially designed for “Shooting place on Google maps” template, it
returns photos that doesn’t have a GPS coordinates so these data is useless, it’s possible that you set
UMG-FreeContentList to list latest 10 photos, but only 2 of them have GPS coordinates so you will see
only 2 markers on Google maps. However, there is a hack for this, just connect to your website by FTP,
you can find FreeContentListSettings.ascx in /DesktopModules/BizModules – UltraPhotoGallery folder,
open this file in a text editor, you can find a instruction in the 33rd line.
Page 60 of 68
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/file_path. 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.
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 high-res version to an image. These files are transferred to Amazon S3, too.
For the purposes of the Batch Quantity setting, an item could be an image, an album including a logo or
Page 61 of 68
background music, or a high-res version photo.
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 photos,
album logos, MP3 background music and high-res version photos 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, 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 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
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 68
Satellite Modules
Free content list
The UMG-TopPhotos, UMG-TopAlbums and UMG-TopComments module in prior version are used to
display photos/comment/albums within an existing gallery, in UMG 6 these modules are obsolete but you
can use UMG-FreeContentList to replace all of them.
At first let’s take a look at the settings page of this module:
The Retrieve data from list is the data source of this module, you should select a gallery which do
contain some photos.
The 3 drop down list in the 2nd row allows you to choose what type of data to be displayed, for example:
latest photos, random comments, latest albums …
When you choose to display photos, you can choose which core template to use, a core template is a set of
layouts, appearance, script libraries that is delivered together with UMG, please try it one by one.
You can modify the core template to better suit your needs, just select the template you want to customize
in Core Templates list, then click Custom Templates, then you can modify it.
This module is fully template driven, when you use core templates you don’t need to care about it, but
when you use custom template you may need to know available tokens in this module, below is a full list:
When use it to display photos:
1.
[TITLE]
2.
[DESCRIPTION]
3.
[CREATEDDATE]
4.
[LINK] – the link to see this photo in UMG flash viewer, the html presentations doesn’t support it.
Page 63 of 68
5.
[THUMBNAIL] – image thumbnail URL
6.
[PHOTO] – image URL
7.
[PHOTOID]
8.
[AUTHOR]
9.
[AUTHORID]
10. [ALBUMTITLE]
11. [ALBUMID]
12. [ALBUMDESCRIPTION]
13. [AVERAGERATING]
14. [TOTALRATINGS]
15. [CREATEDDATE:date format] – the created date formatted by specified format string, for
example:[CREATEDDATE:yyyy-MM-dd] is replaced to something like 2010-2-11.
16. [TAKENDATE]
17. [LATITUDE] – GPS latitude of shooting place
18. [LONGITUDE] – GPS longitude of shooting place
19. [TAKENDAYSAGO] – how many days ago this photo is taken
20. [DESCRIPTION:length] – the left x characters of photo description
21. [CUSTOMTHUMB:XxY] – custom thumbnail, at any size
When use it to display comments, it supports all tokens above, and some extra tokens:
1.
[IP]
2.
[COMMENT]
3.
[POSTEDDATE]
4.
[AUTHOR]
5.
[AUTHORID]
When use it to display albums, it supports below tokens:
1.
[TITLE]
2.
[DESCRIPTION]
3.
[CREATEDDATE]
4.
[ALBUMID]
5.
[LINK]
6.
[LOGOPATH]
Page 64 of 68
7.
[LOGO]
8.
[AUTHOR]
9.
[OWNER]
10. [AUTHORID]
11. [DESCRIPTION:length]
Page 65 of 68
Photo calendar
The UMG-PhotoCalendar module can be used to create a calendar view of all of your gallery photos.
When you add the UMG-PhotoCalendar module to a page, you should see a screen similar to this:
Photo Calendar arranges your photos by date, which gives you an easy way to access photos for a specific
date. By default, photos are grouped by the date you uploaed them to UMG. If you are adding photo
images from a digital camera that assigns a taken date property to each photo, you can set Photo
Calendar to group photos by the date the photo was taken, not the date uploaded. To do this, simply
enable Group photos by taken date instead of created date in the settings page.
You can optionally turn on lightbox feature in UMG-PhotoCalendar module, then a lightbox view is
launched when you click on a specific date that has one or more photos assigned. If Lightbox is not
enabled, you will be navigated to the search page of chosen gallery.
Page 66 of 68
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 photos 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 search for part of a word. For example, if the Title of an
image is "My Family", and the Description is "This photo 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:
Type anything to search a photo, you can see the number of results before clicking the search button.
When click the search button you will be redirected to the search page of chosen gallery, and view the
results in Highslide presentation:
Page 67 of 68
The search page is template driven, it use same template as Highslide presentation, so if you want to
change its appearance, switch to Highslide presentation, customize the display template then switch to
your original presentation.
Page 68 of 68

Ultra Media Gallery 6 User Guide

Transcription

Similar documents

31-2301 Taluswood Place_eBrochure

the press release here.

Mileece_General Info 2011_tree

Kulturzentrum "Treffpunkt Stadtmitte" Wendlingen

The Entire Article

invitation - American Scandinavian Society

Zarouhie Abdalian

Los Angeles Adds to Growing Art Scene

GEORGE BILLIS GALLERY JOSEPH PICCILLO

press release - George Billis Gallery