Gallery Press is a gallery plugin that utilizes WordPress’s [gallery] shortcode and integrates itself into WordPress’s attachment architecture. Galleries are constructed from any attachment type either by selecting and ordering attachments from the Media Library or by selecting a combination of Categories and Tags to display. When displayed, through Gallery Press, each attachment can also include custom metadata values.
Using Gallery Press, you can upload new media files via a ZIP file. Each recognized file is added to the blog as a new attachment. If a tab delimited TXT file named metavalues.txt is included, it will populate each attachment’s metadata values.
Using Gallery Press
Uploading Media Files
Gallery Press uploads media file that are part of a zip file. This ZIP file may contain any media file whose mime type is recongnized by your installation of WordPress.
To upload a zip file
- Click on the ‘Upload’ sub-menu within the Gallery Press section of your admin menu, or
- Click on the Gallery Press icon with Tiny MCE when you are editing a page or a post.
Use the first form that appears. All files that are in the zip file will be added as attachments to your blog.
If the ZIP File includes a tab delimited TXT file named metavalues.txt, it will be parsed to populate the blogs database with information regarding the new attachment. See below for more details on how to do this.
Gallery Press allows you to use a text file to include additional metadata for the media files contained by your ZIP file. This is done through a tab delimited TXT file named metavalues.txt, which needs to be included in your ZIP file.
*First Row: The first row of this file MUST define the file’s column names.
*Columns to Include: Your columns can have any name you want, as long as they are defined in Gallery Press’s Settings. A handful of column names are have specific functions.
**filename: The value of this column is used to match metadata to a specific file within the ZIP archive. If this column does not exist, no metadata will be matched to your new attachments.
**title: The value of this column will become the title of an attachment.
**caption: The value of this column will become the caption of an attachment.
**description: The value of this column will become the description of an attachment.
**unique id: This field serves as Gallery Press’s unique id for each attachment. If it is set, Gallery Press will compare it to the gallery press ids of attachments within the WordPress Database. If a match is found that attachment will be updated with the new information instead of creating a new attachment. This field also allows updates of metadata by uploading just a text file on its own.
**Categories: The value of this column should be a comma delimited list of category names used by your blog. These will be assigned to the attachment.
**Tags: The value of this column should be a comma delimited list of tags. These will be assigned to the attachment.
**External URL: Gallery Press allows you to create attachments that point to an external URL as opposed to a local file. This field specifies which URL will be pointed to. Note: This field will be ignored if a local file exists.
**External Poster URL: This columns specifies a URL to use as a Poster Frame for media files. This frame is used to generate a thumbnail within Gallery Press’s gallery view.
*Additional Metadata: Gallery Press also allows you to store additional metadata which is displayed when an attachment is displayed as part of a gallery.
Gallery Press allows you to include meta data with your attachments. This is done by using a tab delimited text file. If you include this file in your ZIP file, it must be named metavalues.txt. You may also upload a TXT file directly into WordPress’s Database by using the second form within Gallery Press’s upload interface.
This will only add data to the database in two instances.
- If a Unique Identifier (gp_unique_field) is included, it will update the attachment that has this id in the data created by Gallery Press.
- If an External URL is included and the Unique ID does not already exist, a new attachment to an external resource will be created
Creating a Gallery
Within a post, once you have uploaded either a ZIP file or a TXT file, you will be taken to a screen that will allow you to edit the gallery. You can also reach this screen by clicking on the ‘Gallery’ after clicking on the Gallery Press icon in TinyMCE.
At the top will be a horizontal display of all the media assets within your blog. Below is an entry box for the number of columns you would like your gallery to be displayed in. Finally is a box with the media assets currently in your gallery. To add new assets to your gallery simply drag them from the top to the gallery box. You can also reorder assets by dragging them within the gallery box. Once you are done, submit the form and the appropriate gallery shortcode will be inserted into the post.
You may instead choose to use the new ‘Categories / Tags’ tab to create a procedural gallery based on a combination of categories and tags. Press the GalleryPress icon in TinyMCE and then select the ‘Gallery’ tab in the media selection box that pops up. Finally select the ‘Categories / Tags’ tab.
You can edit attachments just as you normally would within WordPress. In the edit form you will find additional Gallery Press fields in addition to the standard WordPress fields.
Gallery Press Administrative Settings
If you are the administer of the blog, you can edit Gallery Press’s Settings.
** Gallery Width: An integer which specifies how many pixels wide your gallery will use to display within a post or a page. This is also used to calculate thumbnail sizes in a gallery based on the number of columns being displayed.
** Slide Size: This sets which version of an image of an attachment stored by Word Press will be displayed. Note: Gallery Press’s CSS is set up to scale images to fit within a page even if they are wider than the available display space. So feel free to use full size.
Standard Fields: These are field that have specific meaning within Gallery Press. They are described in detail in the section on metavalues.txt
** Filename: Column that maps to your attachment’s filename. This defaults to filename
** Title: Column that maps to the attachment’s title within the blog’s database.
** Caption: Column that maps to the attachment’s caption within the blog’s database
** Description: Column that maps to the attachments description within the blog’s database.
** Unique Identifier: Column used by Gallery Press to identify attachments so that updates of metavalues can be performed.
**Categories: Column used by Gallery Press to assign categories to each attachment.
**Tags: Column used by Gallery Press to assign tags to each attachment.
** External URL: Column used by Gallery Press to set the URL for external attachments. Note: this will be ignored if the ZIP file contains a file with the same filename.
** External Poster Frame URL: Column used by Gallery Press to set URL for poster frames of external media files that are not images.
*Additional Metadata Fields: Gallery Press can be configured to store addtional metadata using this section. To add a new metadata value click on the plus sign. The first field corresponds to the column name in your TXT document. The second field corresponds to the metadata variable name that will be stored in the blog’s database and to what will be displayed when the metavalues are listed. Note: the checkbox does not currently do anything.
This section describes how to install the plugin and get it working.
- Upload the gallerypress director the
- Activate the plugin through the ‘Plugins’ menu in WordPress
Contributors & Developers
“GalleryPress” is open source software. The following people have contributed to this plugin.Contributors
- added PrettyPhoto modal window to view attachments in a lightbox type pop-up.
- added custom galleries based on categories and tags.
- minor css fixes