Media Gallery offers several advanced administration features in the Media Gallery Administration Section. All functions in this area are only available to site administrators and those with the mediagallery.admin feature assigned (Media Gallery Admin group). To enter the Media Gallery Administration screen, there should be a menu link in the Command & Control screen labeled Media Gallery. Below is a detailed description of each feature and function available in the Media Gallery Administration section.
The Configuration section allows you to change the behavior of Media Gallery by setting the various configuration options.
System Options are the global configuration options that apply to all functions of Media Gallery.
If this is set to Yes, only logged-in members will be allowed to view the Media Gallery albums. If set to No, anyone can view the Media Gallery Albums. Keep in mind that each Album has its own set of security features and you can custom configure each album. This setting is global for all Media Gallery features.
Allow HTML in album/media titles
If this is set to Yes, HTML will be allowed in Album and Media titles and descriptions. Media Gallery will enforce the same limits that glFusion uses for HTML as setup in the glFusion configuration. If set to No, HTML will not be allowed in Album/Media titles and descriptions, and will be stripped before saving.
Media Gallery has a built in usage tracking system that will log all visits and media views into the Media Gallery database. Turning this on will increase the size of your database, but you will be able to see who is visiting your gallery.
Enable What's New Block
If you want your updated albums and any comments entered into your gallery listed in the What's New block of glFusion, enable this setting.
What's New Title Length
Media Gallery defaults to 28 characters as the length of the album titles shown in the What's New block. If your glFusion theme or template supports smaller or larger widths, you can adjust how the number of characters shown in the What's New block.
What's New Time
The number of days to use for the What's New block. All newly uploaded media items and comments within this time frame will be displayed in the glFusion What's New block.
Preserve Original Filename
Normal operation for Media Gallery is to rename all uploaded items to a very cryptic hash name. This is done in part for security reasons as it makes it very difficult for someone to guess the filenames. But, this can cause some issues if you want your users to be able to download items and have a more descriptive name.
By enabling this option, Media Gallery will preserve the original filename, at least most of it. Media Gallery will still make a small modification to the name, it will preface the filename with a #_ (where # is 0-f). This is done because Media Gallery will use the first character of the filename to disburse the files across multiple directories. This helps Media Gallery scale to thousands of images. It also helps when you attempt to upload items with the same name. Media Gallery will also convert all spaces in the name to underscores.
Discard Original Images
The default configuration for Media Gallery is to create (keep) three separate copies of each image that is uploaded. The original uploaded image, a display image, and a thumbnail image. By enabling this option, Media Gallery will not keep the originally upload file, instead it will create the display and thumbnail images and then delete the uploaded original.
This option is available to those who have no need for the original image and do not wish to keep it. By setting this value to On, it will automatically disable the full view mode in Media Gallery.
This option is new to v1.4 of Media Gallery and to assist in the removal of the original images (if you so choose), a new Maintenance Option has been added to the Media Gallery Administrative menu to remove original images.
A great reason to keep original images is: if you wish to take advantage of the integrated On line Photo printing, having the original image in full resolution available will allow you or your users the ability to print larger pictures.
NOTE: This option only affects image files, it has no affect on QuickTime, Windows Media Player, MP3, MP4 or any other non-image media. All non-image original files are retained as they are needed by Media Gallery.
Verbose (debug logging)
If you are trying to diagnose an issue with uploading media, enabling verbose logging will turn on much more detailed logging of the upload process. These diagnostic messages will be logged to glFusion's private/logs/error.log file.
Disable What's New Comments
Determining if there are new comments in your albums is a very resource intensive operation. Since this usually shows on the main page of your site, you can disable pulling new comments to lessen the load on your server and increase you site's response time.
Display MG Info in User Profile
If this option is checked, Media Gallery will display the last 5 media items uploaded by the user and the first 20 albums that they own in the user profile display.
If the user has not uploaded any media and does not own any albums, Media Gallery will not add anything to the user profile display.
Days to retain sent Postcards
If you enable the Postcard feature in Media Gallery, all sent postcards are saved in the database to allow the recipient the ability to retrieve them at a later date. They will be retained for the number of days you specify here.
You can specify a different date format for Media Gallery. Many times the default date format on glFusion is a bit too long and does not look very good in Media Gallery listings.
Display glFusion Blocks
glFusion basically has three areas of information, gl_content (the center area), gl_navigation (the left column), and gl_extra (the right column). Media Gallery always displays in the center area. You can configure which of the side columns will be displayed when Media Gallery is being viewed.
Album Display Rows
This option sets how many rows will be displayed when viewing the Album Index. The index will display page navigation if necessary.
Album Display Columns
This option sets how many columns will be displayed when viewing the Album Index.
Index Album Skin
Selects which frame to use for the thumbnail images in the Album Index.
The quality setting to be used when creating the display images.
Thumbnail JPG Quality
The quality setting to be used when create the thumbnail images.
Gallery View Thumbnail Size
This setting determines the thumbnail size used in the Gallery View screen.
Enable Media ID display
Media Gallery requires that you use the media ID for several of the autotags that it supports. By default, the Media ID is only displayed for administrative users, not normal logged-in users. By enabling this option, all users will be able to see the Media ID in the media view screen.
Full Image Display in Popup
If you enable this option, if Full Image Display is enabled, all full (original) images will be displayed in a popup window. If this option is not enabled, full images will display inline.
Display Full Comment Bar
If you have comments enabled for an album, and no comments exist for a media item, Media Gallery will display a Post a Comment link at the bottom of the page. If you would prefer the standard glFusion comment bar be displayed enable this option.
This will be the separator used between sections in Media Gallery's birdseed.
Default MP3 Player
The default MP3 player to use for audio playback, options include Microsoft Windows Media Player, QuickTime, Flash based MP3 player, or direct download.
Custom Image Height / Custom Image Width
Media Gallery provides several preset display image sizes, but if you need a specific image size that Media Gallery does not offer by default, you can specify that size here. For each album you have the option to specify the display image size and your custom height / width will be presented in the options.
Play audio / video media directly from album view
This option is only valid if you have selected Play in Popup as your audio / video playback method.
Normally, the sequence of showing a media item is:
Display the album index with thumbnails
Select the thumbnail to view the display sized media item
But, for audio and video media, this sequence does not flow very well. For example, if you have an audio file in your album, the user will see the thumbnail for the audio in the album index view, then have to select that to simply see the thumbnail image again in the media item view.
If you set this option to enabled, clicking the thumbnail from the album index will immediately launch the audio / video file to the player, removing one step from the normal viewing process.
Use media / album title as caption for autotags
If no caption is specified on an autotag, use the items title instead.
Random Image Block Width
The Random Image block defaults to 120px wide. If this is too small or too big, adjust the size of the image here.
Batch Options affect how the Media Gallery Batch Processing system operates.
This option specifies how long Media Gallery should pause between batch cycles.
Maximum items per cycle
This option specifies the maximum number of items to be processed per cycle. Generally the batch processing system will run until it hits the maximum allowed execution time. But, if the maximum execution time is too large, using the entire time may put too large a load on your server, especially in a shared hosting environment. This option will allow you to only process a certain number of items per cycle.
Maximum execution time allowed
The maximum amount of time the batch processing system can execute per cycle. If this number is larger than the maximum time allowed by the site configuration, Media Gallery will use the lower of the two.
User Preference Overrides
Media Gallery allows your registered site users to override certain default settings. If you do not wish to have an album setting overridden you can disable the ability for the registered users to specify them.
Enable User to set Display Rows
If checked, registered users will be able to specify the number of rows to show in the album display.
Enable User to set Display Columns
If checked, registered users will be able to specify the number of columns to show in the album display.
Enable User to set MP3 Player
If checked, registered users will be able to choose a default MP3 player.
Enable User to set AV Playback Options
If checked, registered users will be able to override the album setting for how audio / video files are presented.
Enable User to set Thumbnail Size
If checked, registered users will be able to override the album setting for thumbnail size.
Media Gallery must use an external graphics package to create thumbnails and
perform other manipulations on your uploaded media. Currently, Media Gallery supports ImageMagick, NetPBM and GD Libraries. Select the one that matches your hosting environment.
Graphics Package Path
This option specifies where the binary programs for ImageMagick or NetPBM are installed.
Enable JHEAD Support
JHEAD is a command line utility that will save the EXIF/IPTC data in your images. By enabling JHEAD support, Media Gallery will be able to save all the EXIF/IPTC data even if it has to resize the original image, or remove the original image (EXIF/IPTC data will be saved in the display image).
Path to jhead binary
This is the absolute path to the jhead binary on your server. Media Gallery will actually look in some of the default locations (/usr/bin, /usr/local/bin, /usr/X11R6/bin) and if it finds it there will pre-populate this field with the directory. If you are on a Windows system or have jhead stored in a different location, enter it here.
You can download precompiled jhead executable from http://www.sentex.net/~mwandel/jhead/
Enable JPEGTRAN Support
JPEGTRANS is a lossless tool for manipulating JPG images. It will allow for images to be rotated online without losing any quality.
Path to jpegtran binary
This is the absolute path to the jpegtrans binary on your server. Media Gallery will actually look in some of the default locations (/usr/bin, /usr/local/bin, /usr/X11R6/bin) and if it finds it there will pre-populate this field with the directory. If you are on a Windows system or have jpegtrans stored in a different location, enter it here.
Enable ZIP Uploads
If enabled, you will be able to upload .zip files that contain media items. Media Gallery will automatically unzip the archive and process all the files included in the archive.
Path to unzip program
This is the absolute path on your server to where the unzip program is stored. Media Gallery will actually look in some of the default locations (/usr/bin, /usr/local/bin, /usrX11R6/bin) and if it finds it there will pre-populate this field with the proper directory. If you are on a Windows system, or have unzip stored in a different location, enter it here.
Path to temporary directory
Media Gallery requires that a temporary directory exist where it can read/write temporary files as it processes media items and zip files. Enter the absolute path on your server for this directory. Media Gallery will default to $_CONF['path'] /plugins/mediagallery/tmp.
FTP Path Directory
Media Gallery requires that the FTP directory be specified in the online configuration. This is a safety feature to keep the FTP import from looking in directories where it shouldn't. Enter the absolute path on your server for this directory. Media Gallery will default to $_CONF['path'] /plugins/mediagallery/uploads/.
Media Gallery has the ability to display the embedded EXIF/IPTC data that is stored in your images by your digital camera. If you wish to use this feature, you will need to tell Media Gallery which EXIF/IPTC data elements you want displayed. Please note, not all data elements are actually stored in your image, this depends on the digital camera or scanning process. By default, there are a few key items already enabled.
To select which EXIF/IPTC data elements are available for display, enter the Media Gallery Configuration Screen and select EXIF/IPTC Administration. This will present you with a list of all the EXIF/IPTC elements that Media Gallery recognizes. You should check the box to the right of the elements you want to be displayed with your images.
Keep in mind, you can enable / disable EXIF/IPTC support for each of your albums in the album configuration screen. You can also choose how the EXIF/IPTC data elements are displayed, below the media item, in a popup window, or both.
Media Gallery allows you to create categories to help organize your media items. Categories are only used in the Media Gallery search function. You can limit your search to a specific category, or search for all items in a specific category.
Using this option, you can add, edit and delete your categories.
Reset System Options
This function will reset all configuration options in Media Gallery back to the installation defaults. Generally this is only used when testing new releases, but can be a quick method to return to the installation defaults if you have the need.
Configuration File (config.php) Directives
All but a few of Media Gallery's configuration options are available in the online interface documented previously, but there are a couple of specific items that can be changed in the config.php file located at private/plugins/mediagallery/config.php.
By default, Media Gallery is designed to be run from the public_html/mediagallery/ directory. You may change this location by changing the following config.php variables:
|$_MG_CONF['path_mg']||This specifies the directory under public_html/ where the Media Gallery files are located.
|$_MG_CONF['path_html']||This value should not be modified.
|$_MG_CONF['site_url']||This value should not be modified.
|$_MG_CONF['admin_url']||This is the full URL for the Media Gallery administration directory.
Disclaimer: The following two options do not allow you to store your media outside the webroot, what it does is allow you to move your mediaobjects/ directory to another volume or rename the mediaobjects directory. If you move mediaobjects/ to another disk or volume, you must still have a symlink or virtual directory mapped to your web server's web root.
|$_MG_CONF['path_mediaobjects']||This is the full path to your mediaobjects directory. You can change the name of the mediaobjects/ directory if you wish. This must end with a /
|$_MG_CONF['mediaobjects_url']||This is the full URL to your mediaobjects directory.
The following settings will change some of the default behavior of Media Gallery:
|$_MG_CONF['disable_version_check']||If this is set to 1, it will disable the automatic version check that Media Gallery performs when entering the Administration screen, and will not try to contact www.glfusion.org to determine if you have the latest version installed.
|$_MG_CONF['mediamanage_items']||The Media Manage screen can be very resource intensive when you have several hundred items in an album. If you run into issues, decrease the number of items shown by lowering this number.
|$_MG_CONF['do_not_convert_original']||By default, Media Gallery will convert all uploaded images to JPG format. If you do not want Media Gallery to perform this conversion, set this to 1.
|$_MG_CONF['jpg_orig_quality']||Quality setting to use when resizing JPG original uploads - If the original image must be resized, MG will use this value as the quality setting.
|$_MG_CONF['member_use_fullname']||Set to 1 to use members fullname in member albums, 0 to use username.
|$_MG_CONF['disable_search_integration']||Disable Media Gallery's search integration with glFusion.
|$_MG_CONF['im_keep_profiles']||With ImageMagick, you can keep the JPEG profile data (EXIF) in the display and thumbnail images. Set this variable to 1 to keep this data. It will make these files a little bit larger. On Solaris, setting this option to 1 seems to break the convert command.
|$_MG_CONF['skip_file_find']||Media Gallery will attempt to automatically locate some of the external utilities. If your PHP installation has open_basedir restrictions enabled this can cause some issues. Set this variable to 1 to skip the automatic searching.
|$_MG_CONF['use_default_resolution']||If set to 1, MG will not automatically populate the video playback resolution, instead it will use the default settings.
|$_MG_CONF['use_wmp_mpeg']||By default, Media Gallery will play MPEG videos with Apple's QuickTime player. If you wish to use Microsoft's Windows Media Player instead, set this variable to 1.
|$_MG_CONF['use_upload_time']||By default, Media Gallery will attempt to extract the actual image capture date from the meta data included by many digital cameras and graphics packages. If you prefer to always use the upload date (the date you added the image to your Media Gallery album) as the displayed date, set this variable to 1.
|$_MG_CONF['template_path']||By default, Media Gallery references its templates from the plugin directory. If you want to have separate templates for each of your themes, set the path to the template directory here.
|$_MG_CONF['ffmpeg_command_args']||There are lots of versions of ffmpeg out there, some work with one set of switches and some don't. You can easily modify the commands used to create thumbnails from videos by modifying the arguments below. The first %s is the source video and the second %s is the destination thumbnail, both %s need to be in the command.
|$_MG_CONF['thumbnail_actual_size']||By default, Media Gallery sizes all thumbnails to 200×200 pixels. Media Gallery will size them down dynamically based on the album configuration by passing a smaller width / height to the <img> tag. If you would prefer to have Media Gallery size the thumbnail to the size specified in the album configuration, set this value to 1.
|$_MG_CONF['rating_speedlimit']||The number of seconds a user must wait between rating media items.
|$_MG_CONF['play_mp4_flv']||Setting this to 1 will force Media Gallery to play all MP4 media files with the Flash Media Player. Setting to 0 will use the Apple QuickTime viewer.
System Defaults Editor
Media Gallery has several configuration options for how albums will act and how your multimedia files will be presented. Setting up your defaults to your personal taste will make album creation easier and faster.
This function allows you to configure the default values for each attribute of an album. These will become the default values used when creating an album. For details on each item and their options, please refer to Creating an Album.
Audio / Video Defaults
This function allows you to configure the default values for each feature of the audio / video playback for MP3's, QuickTime Player, and Windows Media Player. For specific details on each item and their options, please refer to Audio / Video Attributes for Media Items.
Global Perm Edit
You can globally change the permissions for all of your albums using the Global Album Permission Editor.
Global Album Edit
You can globally change an attribute for all of your albums using the Global Album Attribute Editor. This screen gives you a list of all available album attributes. You will need to check the Update check box for the attributes you wish to change. On submit, all albums will be updated with the new attributes.
The Media Queue will display all items currently in the Moderation Queue awaiting approval.
To approve the media items, select the Approve radio button. These items will be placed in their destination album and the user who uploaded the items will receive email notification that their media items have been approved.
To disapprove (delete) the media items, select the Delete radio button. The items will be deleted. No notification will be sent to the user who uploaded the media item.
Member Albums are a special feature of Media Gallery v1.6 that allows the site administrator to give their site users their own album or albums to upload media into. Member Albums are special in that there are some protected options the member cannot configure, such as setting the album as a featured album or turning on/off moderation. As the site administrator, you can specify certain restrictions such as maximum allowed file size, maximum resolution of images, or overall disk usage quotas for your members.
Member Album Options
The following options can be configured for Member Albums:
Note: These are the default settings used when a member album is created. Any changes to the Album Attributes or Access Rights will not affect existing Member Albums. To change existing albums, use the Global Perm Edit and Global Album Edit tools.
|Enable Member Albums ||This will turn on / off the features of Member Albums. Basically if Member Albums are not enabled, auto-create and auto-delete functions will not be performed.||
|Default Member Quota ||The default quota new Member Albums should start with, 0 means no quota.||
|Auto Create Albums ||By enabling this option, when a new user registers with your site they will have a Member Album automatically created for them.||
|Allow Creation under Member Root ||By default, members can only have one album directly under the Member Album Root Album. If you enable this feature, members can create as many albums as they wish directly under the Member Album Root album.||
|Member Albums Root Album ||Specifies the root album that all member albums should be created under.||
|Archive Deleted Member Albums ||What action to perform with Member Albums when the member is deleted from the glFusion user database.||
|Include in Random Image Block ||Determines if new member albums should be included in the Random Image block.||
|Maximum Image Width ||Maximum resolution (width in pixels) allowed in the member album. Anything larger will automatically be resized when uploaded.||
|Maximum Image Height ||Maximum resolution (height in pixels) allowed in the member album. Anything larger will automatically be resized when uploaded.||
|Maximum allowed file size ||Specifies the maximum file size that may be uploaded into Member Albums.||
|Allow registered users to upload media to album ||Whether or not to allow logged-in site users the ability to upload to another's Member Album.||
|Turn on moderation for this album ||Enable or disable moderation for Member Albums.||
|Moderator Group ||Which glFusion Group will be the moderator group (if enabled).||
|Email Moderators on Submission||Email Moderators when new media is uploaded.||
|Owner Permission ||Default owner permission for new Member Albums.||
|Group Permission ||Default group permission for new Member Albums.||
|Member (Logged-in User) Permission ||Default permission for logged-in users.||
|Anonymous Permission ||Default permission for anonymous users.||
Be sure to click the save button to store the default settings.
Member Album User List
This will show a list of all site users with information specific to their Media Gallery / Member Album quota usage. The list will show the following items:
|User Name||Their glFusion username.
|Active||Whether or not they are an active Member Album user. If you have a user who abuses their Member Album privileges, or you need to suspend their administrative access to their Member Album, you can turn off the active flag and they will only have READ access to their Member Albums.
|Quota||The total amount of disk space the user can consume.
|Quota Used||The total amount of disk space currently used by the user.
To edit the user's quota or active flag, simply click on the user name and a small edit screen will appear. Be sure to click save to store the new values.
Batch Create Member Albums
If you are just installing Media Gallery or upgrading you may have a number of users already on your site. This utility will allow you to create Member albums for any of your existing site users. Simply check the box next to their name and save.
Another use for Batch Create Member Albums could be if you decided to not use the auto-create feature. Depending on how you administer your site, you could require that site users who want a Member Album must email you to request it. Using the Batch Create Member Albums feature will make creating these albums very easy.
Purge Member Albums
To help manage empty user albums, the Purge Member Albums function will present you with a list of empty Member Albums, who the owner is, and when they last logged into your site. This makes house keeping duties of removing non-used Member Albums much easier.
Reset Member Album Create Flag
This function should not have to be used often and is more of a development tool than a standard administration tool. This feature will check each of your site users from the glFusion database and determine if they have a Member Album. If they do, it will ensure their member_gallery flag is set to 1 and if they don't it will ensure their member_gallery flag is set to 0. The member_gallery flag is used internally by Media Gallery to determine if the user should be included in the Batch Create Member Albums list and also in a few other places.
If you where to move your Member Album Root, you may want to run this utility to ensure everything is in sync.
Media Gallery should keep the member_gallery flag properly set without having to run this utility, but it is here just in case you need it.
Media Gallery supports a full RSS feed which will include all albums and also a per-album RSS feed which can be turned on / off in the Album Attribute Editor. Media Gallery supports the following RSS types: RSS2.0, RSS1.0, RSS0.91, ATOM, ATOM0.3.
Here you can configure how RSS feeds will work for your site's Media Gallery:
|Build Full Album RSS Feed||This option allows you to create a feed for all of your albums.
|RSS Feed Type||Select which Syndication format to use.
|Exclude Empty Albums||This will exclude any albums that do not contain media items.
|Only include albums available to the public||This will allow you to only include albums that allow anonymous access.
|Base filename for feed||This is the base file name, Media Gallery will automatically place the extension .rss onto the Full Feed, and will create files named: basefilename##### .rss for your album feeds, where ##### is the album ID.
This function will rebuild the full Media Gallery RSS feed. Normally you should not have to use this function as the feeds will be maintained automatically any time you make a change (upload, move, delete) items from your albums.
If you were to make several title / description edits to your media, you may want to rebuild the full RSS feed to ensure these changes are included.
Also, when you first enable the RSS Full Feed, you may want to run this to do the initial creation of the file.
This function will rebuild all of the individual Media Gallery album feed files for those albums that have RSS enabled. Normally you should not have to use this function as the feeds will be maintained automatically any time you make a change (upload, move, delete) items from your albums.
If you were to make several title / description edits to your media, you may want to rebuild the albums RSS feed to ensure these changes are included.
As Media Gallery continues to add features and functions, more reports may become available. Currently only one report is available.
This will allow you to generate a Usage Report from the Usage Tracking database, if you have Usage Tracking enabled. This report will show what users have visited Media Gallery and the specific items they viewed.
Media Gallery's Batch Processing System allows you to perform large time and resource consuming tasks without worrying about overloading or optimizing the resources on your server.
When a batch process has started, you can interrupt it if necessary by selecting the cancel button from the Batch Processing System screen. This effectively pauses the batch session. The Paused Sessions screen will list all paused batch sessions. You can continue the session by selecting the continue link or delete them by selecting the Select checkbox and clicking the delete button.
This will rebuild all thumbnails in the system using the Media Gallery Batch Processing System.
If you have upgraded from a version of Media Gallery prior to v1.2, you may want to rebuild all your thumbnails to take advantage of the larger thumbnail size supported in v1.2 and above.
Other reasons to rebuild all your thumbnails could be if you lost the files on your server.
There is also an option to just rebuild thumbnails for a specific album available in the Album view's Option Menu.
This will rebuild all the display images in your system using Media Gallery's Batch Processing System. If you were to change the display image size for all of your albums, this is a quick and convenient method to rebuild all those images using the new size.
Discard Original Images
This option will remove the originally uploaded images from your system, leaving just the display and thumbnail image. You must have the System Option Discard Original Images turned on to use this function.
This function performs several operations to ensure EXIF/IPTC data from the original image is preserved and that the database is properly updated.
If you choose to remove your originally uploaded images, this is the only method you should use to remove any existing original images on your system.
Once you remove the original images, there is no simple method to get them back!
Rebuild User Quotas
Media Gallery maintains how much disk space each of your site users have used. The maintenance function will rebuild the quota count. Under normal operations, you should not have to run this utility.
Static Sort Albums
This function provides a very quick and simple method to sort all of your albums by one of the following attributes:
You can select a starting album and whether or not the sort should also sort each sub-album.
This function provides a quick and simple method to sort all the media items in your albums by one of the following:
Media Capture Time
Media Upload Time
You can select which album to start sorting and whether the sorting should process any sub-albums.
Batch Delete Albums
This feature will list all albums on your site and provides you with a quick and simple interface to delete multiple albums.
ALL MEDIA ITEMS IN THE ALBUMS ARE ALSO DELETED! THERE IS NO CONFIRMATION PAGE, THE ALBUMS AND MEDIA ARE SIMPLY REMOVED. USE THIS WITH CAUTION!