Documentation Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Album Attributes =====

Album attribute configuration options control which features are available in the album and also how the album will be displayed.

==== Album Theme ====
Each album can use its own set of templates to create a unique look.  Media Gallery comes with the following themes:

^Theme  ^Description  ^
|default  |The standard Media Gallery look and feel.  |
|clean  |This theme uses a very clean interface that only shows a few of Media Gallery's options.  Only the media title and views display below the thumbnail.  The media view screen is very basic with the administrative menus at the bottom of the screen.  |
|simpleviewer  |This theme uses a Flash control to provide an interactive method to display the album media.  |
|lightbox  |This is the standard Media Gallery theme that uses a Light Box to display the full media view.  |
|podcast  |This theme is designed to showcase and display MP3 media or other audio / video media.  It is a single column theme that shows the thumbnail to the left with the item description to the right.  |

You can easily create your own custom themes.  See the [[glfusion:mediagallery:creating_a_theme]] section for more details.


==== Allow Comments ====

If this is enabled, users will be able to post comments on the media items contained in this album.


====Enable EXIF====
If this is enabled, users will be able to view the embedded EXIF/IPTC data of the JPG images.  You can disable EXIF processing, or you can have it display below the media item or in a pop-up window.  Also, you can control what EXIF/IPTC meta data is displayed by configuring the EXIF options located in the Media Gallery Administration screen.



====Enable Rating====
{{  mediagallery:starrating.png|}}
You can select whether you want to enable ratings on your media items.  Valid options are:

  * Disabled - No rating features.
  * Members Only - Only logged in users can rate a media item.
  * Always - Anyone can rate media items.

<note important>
You will not be able to rate media items that you uploaded.  Also, once you have rated a media item, you will not be allowed to rate it again.
</note>


====Enable Album RSS Feed====
If this is enabled, a RSS feed for the album will be created / updated each time you add or remove media to this album.  The RSS icon will appear to the right of the album name.  This allows your site users to subscribe to the RSS feed and keep up with any changes to the album.

<note important>
Permissions are not checked when a user views the RSS feed.  If you have a protected album and enable the RSS feed, anyone who knows the feed name can view the feed.
</note>


====Podcast RSS Feed====
If you have enabled the RSS feed for an album, you can select this option to add the necessary information to the RSS feed so it can be read as a Podcast feed in readers such as iTunes.

<note warning>
This option no longer controls the look and feel of the album as it did in previous Media Gallery releases.
</note>

====Include Sub-Albums in RSS Feed====
Selecting this option will include all sub-albums in the parent albums RSS feed. If this option is not selected, the RSS Feed will only contain the items in this album.


====MP3 Ribbon Player====
{{  mediagallery:mp3ribbon.png|}}
If this option is enabled, any MP3 media in the album will have a small Flash Media Player (Ribbon Player) embedded below the thumbnail.

====Enable Client Side Sorting====
If this is enabled, a sort drop down menu will appear in the lower right hand corner.  This will allow your site users to sort the media items to meet their preferences.  Note, this only sorts the display of thumbnails for the user, it does not alter the sort options you specified in the album configuration.


====Default Album Sort on Upload====
By default, all media items in an album are sorted by upload time, with the newest always displaying first.  By selecting a new sort order, each time a media item is uploaded, the contents of the album will be resorted using the order you specify here.  This will become the default sort order that the album will use.



====Enable Postcards====
Postcards allow your site users to send a media item to family or friends with a short note.  This can be a great tool to help your users advertise your site.   Postcards can be completely disabled, enabled only for logged-in users or enabled for all users.


<note important>
Please use caution when you make your choice, postcards could also be abused and used for spamming if you allow anyone to send them.  As a protection against misuse, Media Gallery supports enabling a CAPTCHA string on postcard creation.  
</note>


See the [[glfusion:mediagallery:functions#electronic_postcard|section on Postcards]] for more details on this feature.


====Display Album Description====
If this option is enabled, the album description will display just above the first line of thumbnails.  


====Display Album Views Counter====
If this option is enabled, the number of times an album has been viewed or entered will be displayed on the main Media Gallery index page and for any sub-albums in the album.  


<note important>
If you are the owner of the album or have the mediagallery.admin attribute, your browsing will not increment this counter. 
</note>

====Display Media Views Counter====
If this option is enabled, each thumbnail will show the number of times the item has been viewed.  



<note important>
If you are the owner of the media item or have the mediagallery.admin attribute, your browsing will not increment this counter.
</note>

====Enable Keywords====
Each media item can have a set of keywords associated with it.  These are primarily used to improve searching.  If this option is enabled, the keywords will be displayed below the thumbnail image.


====Image / Display / Album Skin====
The frame around each image / thumbnail in the album is specified here.  Media Gallery supports several different frames. 



  *Image Frame is displayed with the thumbnail
  *Display Frame is displayed with the Display Image (Media Item View)
  *Sub-Album frame is displayed for all sub-albums in this album.

====List Sub-Albums Before Images====
This specifies if any sub-albums should be listed before the media items or after.  If enabled, all sub-albums will be displayed before the media items are displayed.  If disabled, the sub-albums will be listed after all the media items.


====Thumbnail Size====
Determines the size of the thumbnails for the album.  There are three choices:



  *Small (100x100 pixels)
  *Medium (150x150 pixels)
  *Large (200x200 pixels)

====Audio / Video Playback Options====
When a user selects to listen to or view an audio / video file, you can specify a few options on how you will play this file.



  *Play in Pop up Window - This option will open a pop up window and play the audio / video file on the users computer using either Microsoft Media Player, QuickTime, or Flash Player.
  *Download to local computer - This option will simply place a direct link to the audio / video file so the file will attempt to download to the user's computer. Generally, the local browser will recognize the mime type and will try to launch the appropriate player on the user's system.
  *In line - This option is similar to option 1, but it will not create a pop up window, instead it will attempt to play the audio / video file using either Microsoft Media Player, QuickTime, or Flash in a window in the Media View.
  *Use mms:%%//%% links for Microsoft supported media. This option will preface the audio / video link with 'mms:%%//%%' which directly calls the Microsoft Media Player. Media Gallery will attempt to determine if the audio / video type is supported by the Microsoft Media Player, if not, it will use a direct download link instead.



====Enable Slideshow====
For media items in the album, Media Gallery can display them as a slideshow.  There are three types of slideshows in Media Gallery:



  *JavaScript - This is the standard slideshow that is full featured and works with most browsers.
  *LightBox - Although this is listed as a slideshow, the user must manually scroll through the images.  Lightbox refers to the display method, the screen will be darkened and the image will 'explode' open.  
  *Flash Based - This is an **experimental** Flash based slideshow that will allow Full Screen viewing.  This code is still in the early stages of development.  


If you do not want to have a slideshow feature for the album, choose Disabled.


====Display Rows / Columns====
This determines the number of rows / columns of thumbnails per page.



=====Album Cover=====
By default, Media Gallery will use the most recent thumbnail as the album cover.



You also have the option of uploading an image to be used as the album cover.  By selecting the **Attached Thumbnail** checkbox and specifying the image to upload in the **Thumbnail **input, you can add the album cover.  When you attach a thumbnail to the album, that image will always be used as the album cover.



Media Gallery also allows you to specify one of the images in the album to be the album cover as well, instead of using the most recently added item.  This is configured in the [[glfusion:mediagallery:media#manage_media_items|Manage Media screen]].


=====Featured Album=====
Albums can also be featured and configured to show on the front page, specific topic or all pages. To feature an album, simply check the Set as Featured box and select where it should be displayed. Media Gallery will not show a featured album to a user who does not have the privileges to see that album.\\  \\  You can have more than one featured album. For example, you could have a different featured album for each Topic on your glFusion system.


=====Media Handling Options =====
Each album can have specific options for displaying or handling media within the album.


====Use Filename as Caption====
If this is enabled, each time a media item is uploaded, if no caption has been entered, the media items filename will be used in the caption field.



====Enable Online Printing Link====
Media Gallery supports an integration with DigiBug, an online photo printing service.  By enabling this option, a new link/icon will appear in the lower right hand corner of the media view.  This link will add the photo to the DigiBug shopping cart.  



For full details on the Online Printing feature, see the [[glfusion:mediagallery:functions#on_line_printing|Online Printing Section]].


====Allow Media Download====
Enabling this option will add a **Download** link to the media item view screen.  This will allow your site users to easily download the media item to their local system.


====Display Full (original) Image====
You can restrict or disable the ability for your users to view the originally uploaded image.  The options are:



  *Always - Allow anyone to view the originally uploaded image
  *Members Only - Only allow logged-in users to view the originally uploaded image
  *Disabled - Disable the ability for anyone to view the originally uploaded image

====Include in Random Image Block====
This option specifies whether the image media from this album should be included in the site's Random Image block.  



<note tip>
Only users with the mediagallery.admin attribute may change this setting.
</note>

====Maximum Image Width / Height====
You can control the maximum resolution of images placed into the album.  If you specify values for both width and height, any image media which is of higher resolution will automatically be resized to these limits.



If you do not wish to limit the resolution, place a zero (0) in both fields.


====Maximum Allowed File Size====
You can also restrict the maximum file size allowed in this album.  By specifying the maximum size in **kilobytes (Kb)** you will limit the ability to upload any media larger than this size.  Any item which exceeds this size will be discarded and an error message stating the file is too big will be displayed after the upload.



If you do not wish to restrict the file size, place a zero (0) in this field.



====Display Image Size====
You must specify the size of the Display Image (the image that is shown when viewing the media item).  Media Gallery has several pre-defined sizes and also the ability for you to add a custom size (see Media Gallery Administration).  



When the image media is uploaded, Media Gallery will create the display image using the size specified here.


<note tip>
If you change the **Display Image Size** after you have already added images to an album, those existing image items **will not **automatically be resized.  This setting will only affect any new image items uploaded.  To resize the existing items, see the [[glfusion:mediagallery:administration#resize_images|Media Gallery Administration section]].
</note>

=====Watermarking Options=====
Each album can enable or disable watermarking.  Also, each album can have a unique watermark image and location.  To enable watermarking, select the checkbox for **Automatically Watermark on Upload.**


====Watermark Opacity====
This specifies the transparency used by the watermark image.  The lower the number, the lighter the watermark image will be on the original image.  The higher the number, the darker the watermark will appear.


====Watermark Location====
This specifies where on the image media the watermark should be placed.


====Watermark Image====
You must select an existing watermark image to apply to newly uploaded image files.



<note tip>
Changing these values do not affect media items already uploaded to the album, these settings only apply to newly uploaded image media.
</note>


For full details on Media Gallery's Watermarking features, see the Watermarking Section.



=====Allowed Media Types=====
Each album can be configured to only accept a certain type of media.  If you create an album that should only contain music (i.e. MP3 files), you can make MP3s the only allowed media type.  Any other type of media that is uploaded to this album will result in an error to the user informing them that the media type is not allowed.



The list of allowed media types are:



^  **Image**  ^  **Audio / Video**  ^  **Other**  ^
| JPEG | MP3 | ZIP |
| PNG | OGG | Any Other Type |
| TIF | WMV |  |
| GIF | SWF |  |
| BMP | MOV |  |
| TGA | MP4 |  |
| PSD | MPEG |  |
|  | FLV |  |
|  | Remove FLV |  |
|  | Embedded Video |  |



For more information on the different media types, see the Support Media Types section.


=====User Uploads=====
By default, only the album owner or a user with write permissions can upload media items.  User uploads allows you to open the album for contributions from regular site users.


====Allow Registered Users to Upload Media to this Album====
If this feature is enabled, any logged-in users to the site will have the ability to upload media items to this album.  If this is not checked (disabled), only users with write permissions to the album will be able to upload new items.


====Turn on Moderation for this Album====
Moderation allows you to store any new uploads by logged-in users into a temporary holding space where they can be reviewed and either approved for inclusion in the album or rejected and deleted.  Moderation is a great tool to ensure only appropriate media items are added to your album by your user community.



By enabling this option you will force all new media items uploaded by logged-in users to be redirected to the moderation queue.



This option is only valid if you have **Allow Registered Users to Upload Media to this Album** enabled.


====Moderator Group====
If you have enabled moderation for this album, select the group of users who will be responsible for reviewing and approving media submissions.


====Email Moderators on Submission====
If this option is enabled, all members of the moderator group will be notified via email when new media items have been uploaded.  Media Gallery tries to keep from flooding the inbox of the moderators, so if a user uploads 10 media items in a very short period of time, only one moderator email will be sent.



For more details on Media Gallery's moderation capabilities, see the Moderation Section.


=====Permissions=====
Media Gallery supports the glFusion security model, using Owner, Group, Logged-In and Anonymous permissions for each album. Media Gallery does not support permissions to the media item level, but instead the album level.\\  \\  Media Gallery supports a single global permission, whether or not to allow non-logged-in users access to your albums. If you set the Configuration Option, **Login Required** to Yes, then only registered site users can view your albums, regardless of the album's individual permissions.\\  \\  Each album has a set of permissions associated with it, these permissions determine who can view, edit or add media to the album. The permissions are: 

^**User**^  **Read Permission**  ^  **Edit Permission**  ^
|Owner|  Read  |  Edit  |
|Group|  Read  |  Edit  |
|Logged-In User|  Read  |  Edit  |
|Anonymous|  Read  |     |

**Definitions are as follows:** 

^**Attribute**^**Description / Definition**^
|Owner|Each album has an owner; it is the user who created the album.   Owners will always have READ / EDIT permissions.|
|Group|Each album has a group owner, this is the glFusion group that has ownership of the album.  Group Owner can have either READ permission or READ/EDIT permission.|
|Logged-In User  (Members)|This is any user who has a login account on your site and is logged-in.  Logged-in users can only have READ permission or no permission to view the album.|
|Anonymous User|This is any user who has not logged into your site.  Anonymous users can only have READ permission or no permission to view the album.|
|Read Permission|Allows the user to view the contents of the album.|
|Edit Permission|Allows the user to edit the album attributes (name, description, security permissions, etc.) and upload media to the album.|



====Force Child Update====
If you change the permissions of an album and it contains sub-albums, you can force Media Gallery to set the exact same permissions on all sub-albums by selecting this option. 



======Creating an Album======
To create an album in Media Gallery, select the **Create Album** option from the Options drop down menu. Each album has a set of configuration attributes that control how the album will be displayed, options for media presentation, and access rights.



=====Editing an Album=====

In the album view screen (you must be viewing the album you wish to edit), there is also an Administration Drop down menu, this is where you select to Edit an existing album. The edit screen is identical to the create screen and allows you to modify the settings of an album and also change the parent album (effectively moving the album to another parent). 

If the album you are editing contains sub-albums, you have the option of forcing all children albums to have the exact same permissions as the parent. If you choose to do this, check the check box labeled: **Force Child Update**. 


=====Deleting Albums=====
An album can be deleted by selecting the Delete button in the album edit screen. If you select to delete an album, you will be given the option to move all sub-albums and media to another album or delete them. If you choose to have all the contents deleted, it is permanent, there is no undo function and all the media and sub-albums will be removed. 

There is a **Batch Delete Albums** function available in the Media Gallery Administration screen. This will present a list of all albums and allow you to select which ones to delete. There is no option to move the contents of the albums when using the **Batch Delete Albums** function, all media items and sub-albums will be permanently deleted. Please use this feature with caution!
Documentation Wiki

Site Related Links

OnLine Magazines

Current Stocking Reports

Useful Links

River Flows

Documentation Wiki

Site Tools

Page Tools

Site Related Links

OnLine Magazines

Current Stocking Reports

Useful Links

River Flows
