When adding a new post (or editing an existing post with no attachments), this is what the File Gallery box on your editing screen should look like.

Just a notification and some buttons on the right.

When you add some attachments to the post, the box will automatically refresh itself and it will look something like this:

Some attachments might appear with background colors set to other than grey.

Here's what each color means:

• Grey - default (original with no copies)
• Blue - a copy
• (striped) - set as featured image
• Green - an original with copies

On the top right of the box, there is a set of buttons which are used for operations on multiple attachments.

• Button number one will refresh the attachment list.
• Buttons number two and three will check / uncheck all the attachments.
• Button number four will save current attachment order.
• Button number five will open a dialog for copying all attachments from some other post to the current one.
• Button number six will delete all the checked attachments
• Button number seven will detach all the checked attachments
• Button number eight will clear the file gallery cache
• Button number nine will open the media settings page in a thickbox window
• Button number ten will open this help file in a thickbox window

Beneath the buttons are two fieldsets.

First fieldset contains options for when you want to insert a gallery into a post.

The second one contains options for when you want to insert a one or more single images into a post.

They both operate on attachments you check in the attachment list below the fieldsets.

You can check attachments either by single clicking the attachment thumbnail, or by clicking the checkbox in the lower right corner of each attachment representation.

After you choose your options and select attachments, use the blue buttons on top of each filedset to insert either a gallery, or a single image.

Yes, those are clickable buttons :)

In the top right corner of each fieldset is a small button / icon . Click that button to toggle either of the fieldsets. Their state will be automatically saved and remembered for the next time you edit a post.

Each attachment representation has a few buttons / icons.

Top left button is the edit button which opens attachment editing screen. You can also double click on the attachment thumbnail to trigger the same action.

Beneath the edit button is the zoom button (a magnifying glass) opens a bigger version of the image in a lightbox, if that attachment is an image viewable in browser. This icon is not present if the attachment is not an image.

In the bottom left corner is the delete / detach button. It will open a small dialog over the thumbnail when clicked: Clicking on the button again will hide the dialog, and clicking on either "Delete" or "Detach" links will open another dialog for confirmation.

Click "Continue" to delete / detach that attachment, or "Cancel" to, well, cancel the operation :)

At the bottom, in the middle, is the set / unset featured image (post thumbnail) button (a star).

In the bottom right corner is the checkbox used to check attachments for operations involving the Main buttons or the fieldsets beneath them.

Use your mouse to click on an attachment thumbnail and then drag it to another position in the list:

Attachment order is not saved automatically so please use the third main button the save it.

When you click the "Edit attachment" button, or double click the attachment thumbnail, you will be presented with the following screen:

Use this form to edit attachment data and then click "save and return". Or just click "cancel and return" to do just that - return to the attachment list.

You can also press the enter key to save the data, or the escape key to cancel, and return to main File Gallery screen.

Clicking the image thumbnail in the top right corner will open its enlarged version in an lightbox, if the attachment is an image.

Sinve v1.6.5 of the plugin, attachment custom fields are also present in this dialog box. If you edit any of the custom fields here, they too will be updated when you press the 'save and return' button.

When you insert a gallery, a placeholder image will appear in the visual editor. When you click on that placeholder, File Gallery box options will automatically change to reflect those in that gallery.

While the placeholder is still selected / clicked on, whichever options you change in the File Gallery box, gallery options will be updated automatically (you'll see "Gallery contents updated" text in the upper right corner of the box).

At the moment, this works properly only in Firefox and Opera.

Internet Explorer has problems registering the first click on the gallery placeholder so you have to click twice. It then reflects gallery options, but when you try to change something, it loses focus and gallery options will not be updated. I hope I'll be able to figure out what's the problem soon.

Webkit browsers (Safari and Chrome) have problems with tinyMCE.activeEditor.selection.setContent() in tinyMCE versions prior to 3.3.6 so updating galleries is disabled until WordPress receives TinyMCE upgrade in v3.1.

Originals are attachments that have copies, but are not a copy themselves.

Copies are, well, copies of originals :)

There are two ways to copy attachments from other posts.

The first one is by using one of the Main buttons (third one) in the File Gallery box. When that button is clicked, it will open an dialog. The dialog looks something like this:

Currently, it's this simple: just type the post ID into the field and click continue to copy all attachments from the post with that ID. I might improve this feature in the future :)

The second way is to open the Upload/Insert window , and then click the Media library tab.

Then click on the "Exclude current post's attachments" link to show only attachments which are not already attached to current posts:

You will then see a list of attachments that are either attached to another post (red background), or are not attached at all (white background). Use the checkbox on the right side of each attachment, next to the "Show" link, to select attachments you'd like to copy to current post.

Then use the button at the bottom of the window (the one that says "Attach all checked items to current post") to copy selected attachments.

After the attachments have been successfully copied to the current post, a notification will show up above the button:

When an attachment is copied, only its data found in the database is copied into a new attachment, the actual file on the server is not duplicated.

When you try to delete an original attachment, File Gallery will warn you about it:

You have three options, of which the first one is obvious - click "Cancel" and the dialog will disappear.

Choosing "Delete attachment data only" will delete just the original's data. Its copies and the actual file on the server will not be deleted, and one of the copies will be promoted into an original.

Choosing the third option, "Delete attachment data, its copies and the files", will delete the original, all of its copies, and the actual file on the server. Be sure that this is what you want when clicking the button, as there is no undo.

Media tags are tags for your attachments.

They function the same as post tags do for your posts.

You can assign them to attachments either via Media library, or via attachment editing screen in File Gallery box.

You could then, for example, use them to build a custom gallery, containing only attachments that have a certain tag assigned to them.

While you're editing a post, click on the "Switch to tags" button in the File Gallery box (just above attachment list).

Attachment list will be replaced with clickable tag list.

When you click on a tag, it will appear in the media tag field above, inside the first fieldset. Click on it again and it will be removed from the list.

Then insert a gallery, save your post and see the results :)

All "File Gallery" related settings are integrated into WordPress' Media settings admin page, found on the main WordPress admin menu under Settings -> Media.

Options in the first two sections ("Some default values for when inserting a gallery into a post..." and "...and for when inserting (a) single image(s) into a post") only set the default values for the File Gallery options found in the File Gallery box on post editing screens - they do not override previously set options in gallery shortcode!

If you need to override default gallery shortcode options, you can do that via many filters supplied within this plugin.

If you need a filter added somewhere just ask me and I'll add it :) My e-mail address is aesqe@skyphe.org

In other words, if under the section "Some default values for when inserting a gallery into a post..." you set the value of the option "template" to "file-gallery", that will not make all your galleries use that template. It will only set "file-gallery" as the preselected value in the template dropdown within the File Gallery box on post editing screens.

It's a mouthful, I know, so here's a screenshot:

That's all those options in the first two sections do, nothing more, I'm afraid... `