Tutón tykač njeje so z najnowšimi 3 hłownymi wersijemi WordPress testował. Snano so hižo njewothladuje abo njepodpěruje a ma problemy z kompatibelnosću, hdyž so z nowšimi wersijemi WordPress wužiwa.

File Gallery


„File Gallery“ extends WordPress‘ media (attachments) capabilities
by adding a new gallery shortcode handler with templating support,
a new interface for attachment handling when editing posts, and much
more… Here’s the full list of features:


  1. multiple galleries per post with custom attachment order
  2. a flexible templating system (PHP, CSS, JS) – choose a different
    template for each gallery, even within the same post (4 templates
    included with plugin)
  3. simple, easy to use UI with drag and drop sorting shows attachment
    thumbnails beneath text editor: everything attachments-related is on
    the same screen you’re editing your post on
  4. fully integrated with the visual editor (tinyMCE) – click on the
    [gallery] placeholder image and change any option in the File
    Gallery metabox – changes will be applied instantly
  5. settings page extends the default media settings page
  6. attach copies of items from media library to current post (copies
    data only, not the file)
  7. copy all attachments from another post
  8. unattach (detach) items from current post
  9. media tags = tag your attachments and then use those tags to choose
    which attachments you want to display in your gallery or to filter
    your media library items.
  10. custom fields for attachments
  11. gallery pagination
  12. different background colors for items in media library depending
    on their status = completely unattached (white), attached to other
    posts (red), or attached to current post (yellow)
  13. compatible with „WordPress Mobile Edition“, „Media Tags“ and
    „WPML Multilingual CMS“ plugins
  14. basic caching of gallery output and frequent queries (transients)
  15. please see the help file for complete list of features

More info

This plugin uses icons from the awesome famfamfam Silk icon set by
Mark James.
„Silk“ can be found at: http://famfamfam.com/lab/icons/silk/

Plugin settings are integrated into media settings page.

Help file is included, you’ll find it in the „help“ subfolder.

Translation Credits

* Maor Barazany – http://www.maorb.info/

* Jean-Michel Meyer – http://www.li-an.fr/wpplugins/

* Pietro Palli – http://ppal.li/
* Francesco Canovi – http://www.blackstudio.it/

* Wassem Mansour – http://www.sanapix.com

* Vincent G – http://www.Host1Free.com

* Michał Budzik – http://www.mindborn.pl/en/


Greg Haddow (https://github.com/shaddowgh/)
Josh Eaton (https://github.com/jjeaton/)
Andrea Baccega (https://github.com/vekexasia)

Thanks goes out to…

  • All the contributors, translators, and people leaving comments,
    bug reports and suggestions on the official page and in the
    WordPress.org forums

Plans for the next versions


  • manage media tags for all selected attachments
  • audio and video preview on editing screens


  • phpdoc all the functions
  • more detailed description for file_gallery_shortcode function
    (what can be used in ‚orderby‘, what do ‚columns‘ mean) for beginner programmers
  • yoxview lightbox http://www.yellow-llama.com/yoxview-gallery-wordpress-plugin/


  • show attachments‘ Custom Fields in the main page of Media Library (custom column)
  • media library sort by file size or picture dimensions

probably not, but who knows:

  • watermarking – probably in another plugin…
  • when detaching / deleting attachments, just remove them from DOM
    without refreshing the entire file gallery box, but take care of
    originals and copies

And thank you for reading this 🙂


Fota wobrazowki

  • File Gallery main box on editing screen
  • Edit attachment data
  • Copy all attachments from another post
  • Deleting attachments that have copies
  • Build a gallery by choosing media tags
  • Settings page
  • Post thumb and number of attachments as extras in this view
  • Copying attachments from media library
  • With "WPML Multilingual CMS" plugin istalled, you'll be able to copy all attachments from the original post to translated one in two clicks
  • Custom fields for attachments


  1. Place the whole ‚file-gallery‘ folder into your WordPress
    installation folder (usually under ‚wp-content\plugins‘).
  2. Go to WordPress administration -> plugins page and activate
    „File Gallery“ plugin.
  3. You’re done – go edit or add a new post to see how it works.


Coming soon.

For additional information, please see the File Gallery help file.
It’s included with the installation, but you can also view it online here:

Full list of filters within File Gallery



3. septembra 2016
Simply the best! No any conflict with any plugins or themes over several years. Easy to use and "must have" Wordpress media tool for any developer!
Čitajće 13 pohódnoćenjow

Sobuskutkowarjo a wuwiwarjo

„File Gallery“ je softwara wotewrjeneho žórła. Slědowacy ludźo su k tutomu tykačej přinošowali.


„File Gallery“ je so do 1 rěče přełožił. Dźakujemy so přełožowarjam za jich přinoški.

Přełožće „File Gallery“ do swojeje rěče.

Na wuwiću zajimowany?

Přehladajće kod, hladajće do SVN-repozitorija abo abonujće wuwiwanski protokol přez RSS.

Protokol změnow

  • April 20th, 2023.
  • bugfix: escape shortcode attrs (thanks to Lana Codes – https://twitter.com/LanaCodes)

  • May 13th, 2016.
  • bugfix: set default attachment data type to array instead
    of string (thanks Li-An!)

  • March 29th, 2016.
  • compatibilty fix for the WP Offload S3 plugin
    (thanks to Andrea Baccega – https://github.com/vekexasia)
  • added an admin notice if your media tag taxonomy name is
    either empty or over the character length limit (32)
  • disabled setting the tax name to an empty value via the
    permalinks settings screen

  • October 5th, 2015
  • minor: added text domain name into plugin info header for
    translate.wordpress.org compatibility


  • August 19th, 2015
  • WordPress 4.3 compatibility


  • April 24th, 2015
  • WordPress 4.2 compatibility


  • January 3rd, 2015
  • textual mode „detach / delete“ dialog made visible


  • January 3rd, 2015
  • „copy attachments to current post“ bugfix


  • January 1st, 2015
  • „copy attachments to current post“ rethink
    (moved to the left-side menu, works better on smaller screens)

  • November 1st, 2014
  • a few JS bugfixes

  • September 6th, 2014
  • bugfix: updated media templates for WP4.0!
  • jQuery UI CSS included on post edit screens
  • different color for attachment thumbnail in FG list
    (easier to distinguish)

  • August 28th, 2014
  • two small css fixes (thanks Li-An!)

  • August 25th, 2014
  • gallery with captions output fixed

  • August 23rd, 2014
  • some compatibility bug fixes for WP3.9

  • April 13th, 2014
  • minor security fix


  • March 8th, 2014
  • tinyMCE v4 compatibility; no visual editor bug fixed
  • fixed attachment custom fields inside File Gallery
  • minor code „improvements“


  • November 24th, 2013
  • from this version on, File Gallery is for WordPress 3.5 and later only!
  • there have been 12 beta versions released on Github, prior to this one
  • those beta versions fixed some compatibility issues with WordPress 3.5 and up – mostly thanks to Greg Haddow (https://github.com/shaddowgh/) and Josh Eaton (https://github.com/jjeaton/) – I can’t thank you enough, guys!
  • some legacy code was thrown out
  • javascript parts of the plugin were improved


  • December 16th, 2012
  • bugfix for WP 3.5 – link=“post“ wouldn’t link to attachment
    page but to „/post“- sorry for that :/
  • a few more smaller bugfixes because of WP 3.5 and compatibility
    with previous WP versions
  • various smaller fixes and visual adjustments
  • COMPLETELY UNTESTED support for multisite activation and deactivation
    (more on this in next version, fingers crossed for now o.O)
  • Polish translation by Michał Budzik (thank you very much!)


  • December 12th, 2012
  • support for WordPress 3.5:
    • „ids“ instead of „includes“ in gallery shortcode;
    • attachment custom fields on single media item page;
    • some minor compatibility corrections and adjustments

  • August 4th, 2012
  • bugfix: attachment ordering ignored in galleries and File Gallery metabox
  • bugfix: class names appended ad infinitum when inserting multiple single images

  • June 22nd, 2012
  • minor adjustments in gallery templates css files
  • link rel attribute added to active image in simple template


  • June 17th, 2012
  • bugfix: php error because of referenced variables (thanks kraterdesign!)
  • bugfix: php error on media settings page when a value
    contains a single quote (thanks crmart, grollaz, amandajoonline!)
  • Advanced Custom Fields compatibility fix (thanks serdominik!)
  • some new and some improved translations
  • moved debug info to Debug Bar plugin
  • minor adjustments in default and simple templates
  • bunch of minor fixes, as always


  • March 10th, 2012
  • bugfix: internet explorer – tinymce focus on insert
  • moved tinymce-related code into a tinymce plugin
  • media listings page – regenerate single image link
  • drag and drop upload to file gallery box
  • insert a tag gallery without any files attached to a post
  • post thumb on post listing screen – on click open thickbox
    with bigger image
  • add „change“ link to media tags name and slug on media
    settings page


  • February 26th, 2012
  • added „change“ links to media tags name and slug on
    media settings page
  • post thumb on post listing screen now opens a thickbox
    with the bigger image when clicked
  • ability tp insert a tag gallery without any files
    attached to a post
  • tweaked drag and drop upload to file gallery box a bit
  • bugfix: internet explorer insert content position
    (adds a bookmark on mouse up)
  • added Arabic translation by Wassem Mansour (thanks!)

  • February 16th, 2012
  • bugfix: reduce server stress and page load time by disabling
    File Gallery init and unneeded bindgings on post listing
    pages (thanks dan.stefan!)


  • January 17th, 2012
  • bugfix: check if tinymce is defined before calling it
    (thanks jrstaatsiii)
  • take care of a few php notices (thanks Hubert)


  • January 14th, 2012
  • support for multiple editors
  • drag and drop upload by dragging files onto File Gallery interface
  • proper check for attachment copies on file deletion when not
    using year/month upload structure – thanks to Per Wiklander 🙂
  • NOTICE: this version has been renamed to 1.7.5-beta-1


  • January 2nd, 2012
  • correct display of non-image icons
    (wrong variable order in apply_filters())


  • December 31st, 2011
  • bugfix: no galleries on pages if
    „Display galleries within post excerpts?“ option was unchecked
  • bugfix: attachment custom fields missing
  • late thought of the year: activation code should now run
    after plugin upgrades too, eh…
  • new filter: „file_gallery_get_file_type“
  • made a few more strings in FG metabox translatable
  • updated French and Hebrew translations
  • new screenshots


  • December 15th, 2011
  • fixed a nasty overlook concerning wp_rewrite->flush_rules()
    (called too early) – so sorry about that 😐


  • December 13th, 2011
  • public release for WordPress 3.3
  • all below RC* fixes plus:
  • reworked the settings system so it’s easier to add new options
  • improved lightbox support, more flexibility
  • improved pagination
  • new gallery option: gallery class
  • new metabox option: alternative color scheme
    (and still working on it)
  • ability to copy attachments from WPML translations which aren’t
    primary translations
  • added the pot file to languages directory
  • bugfixes, bugfixes, bugfixes


  • December 11th, 2011
  • fixed a cut/paste mistake that was preventing
    ‚file_gallery_default_template_abspath‘ filter from
    working properly – thanks bedex78!
  • updated POT file


  • December 10th, 2011
  • fixed [gallery] ‚exclude‘ parameter
  • fixed filtering of File Gallery templates locations; added
    support for storing templates within wp-content folder (in a
    subfolder named ‚file-gallery-templates‘)
  • changed the interface a bit


  • November 26th, 2011
  • fixed bug: on thickbox close, overlay would stay visible and
    file gallery would get stuck in „loading“ loop
  • fixed bug: multiple single images insert, first image’s caption
    would stick for all images
  • a few UI fixes
  • some javascript improvements
  • added a new notice on media settings screen
  • WordPress 3.3 compatible


  • November 16th, 2011
  • fixed „Simple“ template images stuck on loading animation bug in MSIE
  • rearranged the File Gallery metabox a bit, trying to reduce the
    visual footprint
  • a few minor fixes (single images insert)


  • October 2nd, 2011
  • two minor fixes


  • October 1st, 2011
  • rtl direction file gallery metabox fixes
  • full Media Tags plugin compatibility
  • ability to change media_tag taxonomy name and URL slug
    (WP Admin -> Settings -> Permalinks),
  • various media_tag taxonomy fixes
  • rel attribute is now always available
  • „upload files“ button with the file gallery metabox is always
    visible now


  • August 21st, 2011
  • when copying attachments, copy custom fields and media tags
    too [thanks joo-joo]
  • disabling attachment custom fields now also affects library display
  • fixed some attachment custom fields related javascript bugs


  • August 19th, 2011
  • ability to sort attachments within the File Gallery metabox by
    title, date, or menu_order [thanks to alexbarber]
  • custom rel attribute value for galleries [thanks to thedarkmist]
  • fixed double media tags submenus when Media Tags plugin is
    active [props alx359]


  • July 31st, 2011
  • fixed MSIE tinyMCE content insert position bug
  • fixed gallery output to produce a HTML comment instead of an empty
    string, so that the default gallery won’t be shown if no attachments
    were found for specified arguments


  • July 23rd, 2011
  • SSL Admin support
  • Better compatibility with plugin checkboxes in media library popup
  • other minor fixes


  • July 10th, 2011
  • WordPress 3.2 compatible
  • minor Media Tags plugin compatibility fix

  • August 4th, 2011
  • fixed jQuery compatibility with WP < 3.2, sorry about that 😐

  • August 1st, 2011
  • WP 3.2 (jQuery) compatibility
  • internet explorer fixes:
    • correct position in editor when inserting content
    • update of gallery shortcode (instead of deletion) when gallery
      placeholder is clicked
    • fixed File Gallery metabox items editing buttons visibility CSS bug


  • January 11th, 2011
  • added option to display just the insert buttons
    for gallery/single images
  • better handling of file gallery options
  • image thumbnails regeneration (works, but needs a non-mockupy ui 🙂
  • some css fixes for better ie6-7 compliance
  • various small fixes all over the place

  • January 6th, 2011
  • bugfix: left an alert box in javascript, eh…

  • January 6th, 2011
  • options to hide and toggle display of attachment custom fields
  • separated hiding of gallery and single image insert options
  • few minor improvements and bugfixes

  • December 16th, 2010
  • fixed a JS bug where attachment reordering would not work if
    gallery/single image insert options are hidden
  • set the option to display single image captions to true by default
  • thanks to jardokraka for noticing both issues 🙂
  • a few small bugfixes in javascript and template js dependencies

  • December 6th, 2010
  • new function file_gallery_overrides() which you can use in
    your template files before the_content() to modify [gallery]
    arguments for that post, like this:
    file_gallery_overrides( array(‚size‘ => ‚medium‘) )
    (will add it to the help file soon)
  • gallery pagination: must use with ‚limit‘ argument;
    will NOT work with paginated posts or pages;
    example: [gallery limit=“6″ paginate=“true“]
    (will add it to the help file soon)
  • a few small bugfixes: urlencoded caption for single images;
    ‚simple‘ template no link variant; if link_size is set and
    link=“none“, images are still linked


  • November 7th, 2010
  • custom fields for attachments
  • variable width/height for thumbnails in File Gallery metabox
  • fixed the „simple“ theme so it does not rely on colorbox being
    installed and checks if thickbox is available
  • some JavaScript improvements
  • new [gallery] attribute, ‚link_size‘ – choose which image size
    thumbnails should be linked to
  • bugfix: image align class

  • October 12th, 2010
  • bugfix: single image alignment class wasn’t showing
  • updated the translations


  • October 10th 2010
  • if there’s a „gallery.js“ file inside your template folder, it
    will be automatically enqueued. You can set its JavaScript
    dependencies by defining a $js_dependencies variable inside your
    template’s PHP file – it must be an array, something like this:
    $js_dependencies = array(„jquery“)
  • new template – ‚simple‘ – added to demonstrate inclusion of the
    JavaScript file (thanks to spiranovich!)
  • added captions support for single file insertion
  • fixed crystal icons url bug – sorry about that :/


  • October 3rd, 2010
  • moved constants definitions into another function to allow
    functions.php filtering of most of the constants
  • fixed disappeared attachment count
  • zero columns option, columns.css is loaded only when needed
  • new constants, see help file:
  • added gallery id to gallery wrapper element
  • „file_gallery_output“ filter
  • post ID option for shortcode
  • post thumbs width on post editing screen is now controlled via
    JavaScript to give more space to other columns on smaller screens


  • September 12th, 2010
  • added Hebrew translation and support for RTL languages
    • Maor Barazany, thank you so much for your assistance 🙂
  • some new filters (check the help file)
  • small cosmetic changes in code
  • added a proper donation link to this readme 😉
  • skipped v1.6.1 so it wouldn’t confuse people (because of

  • August 24th, 2010
  • fixed a bug in media settings where custom image size height would
    get the value of width because of a typo – sorry :/


  • August 17th, 2010
  • added French translation (thanks, Jean-Michel!)
  • reverted to default ‚load_plugin_textdomain‘
  • fixed a link ‚rel‘ attribute bug
  • modified the default templates a bit (if/else statements for image
  • minor js changes regarding (un)setting featured image translation


  • August 11th, 2010
  • fixed a small javascript bug
  • made some changes regarding textdomain loading
  • updated the help file
  • updated screenshots


  • August 1st, 2010
  • implemented ‚limit‘ option in UI
  • all the stuff below related to 1.5.8b1 and 1.5.8b2
  • new WP tinyMCE version probably in 3.1, will investigate…


  • July 25th, 2010
  • added mime type support, more info in help file when 1.5.8 leaves the
    testing phase. For now:

    • you can either use the full mime type (like application/pdf) or the
      shorthand variants (pdf, word, doc, xls, excel, cvs, zip, rar, 7zip)
    • you can extend the mime types array using the
      ‚file_gallery_mime_types‘ filter
  • added ‚limit‘ in code, but I just remembered I didn’t implement it in
    UI, so forget about that for now (will anybody use this, anyway?) 😀
  • minor tweaks and bugfixes, added a few new actions and filters,
    enhanced the support for lightbox scripts… New help files are
    coming soon 🙂


  • July 20th, 2010
  • almost complete tinyMCE integration – click on [gallery] placeholder
    image and change any option in File Gallery metabox – changes will be
    automatically applied 🙂

    • it’s not working in Webkit browsers (safari, chrome…) at the
      moment because of Webkit problems with
      tinyMCE.activeEditor.selection.setContent() in tinyMCE versions
      lower than 3.3.6. If you’re an Webkit browser user, you can either
      upgrade your tinyMCE editor to a newer version, or wait for
      WordPress 3.0.1 (should be out soon)
    • Internet Explorer loses focus and updating contents doesn’t work.
      I’ll do my best to fix it as soon as I can.
    • Opera and Firefox seem to be working just fine 🙂
  • couple minor bugfixes


  • July 3rd, 2010
  • added option to disable file gallery shortcode handler (if you want
    to use File Gallery functionality in backend only)
  • added options to link a gallery or single images to some external url
  • fixed the post thumb -1 (WPRemoveThumbnail nonce) bug


  • June 19th, 2010
  • added ‚include‘ and ‚exclude‘ parameters for compatibility with
    standard WP gallery shortcode function. ‚include‘ is identical to
    ‚attachment_ids‘ and will be used as the default parameter name
    from this version on
  • added columns parameter and „Clear File Gallery cache“ button to
    the File Gallery UI


  • June 2nd, 2010
  • fixed a bug where image caption for an image without a caption set
    would be from previous image
  • added alternate text field in editor for image attachments


  • June 1st, 2010
  • squashed some bugs, added forgotten global variables


  • May 31st, 2010
  • fixed a bug where attachment class value would be appended to
    ad infinitum, when inserting multiple single attachments


  • May 30th, 2010
  • added image align options for single image inserts
  • added option to link images to parent post
  • muchly improved file_gallery_list_tags output
  • fixed the url to ‚crystal‘ icons for non-image file types
  • added support for alt text for images
  • support for lightbox-type scripts:
    • choose which link classes trigger auto-enqueueing of
      scripts and styles (a script should be registered beforehand
      for this to work)
    • added filters to modify image class, link class, and link rel
  • a bunch of bugfixes


  • May 4th, 2010
  • added option to filter out duplicate attachments (copies) when
    browsing media library
  • post thumbnail is now removed when that attachment is deleted or
  • and finally, the help file is included 🙂


  • April 25th, 2010
  • fixed _has_copies meta handling when deleting a copy
  • copied log writing function from Decategorizer
  • some minor improvements
  • first release sent to the WordPress plugin repository


  • April 16th, 2010
  • set / unset post thumbnail with one click in the File Gallery box
  • when copying all attachments from another post, if current post has
    no attachments of its own, automatically set post thumb to be the same
    as for the post we’re copying attachments from
  • if you have „WPML Multilingual CMS“ plugin installed and you’re editing
    a post that is a translation, you’ll notice a bluish link at the bottom
    of the „Language“ metabox. It allows you to copy all attachments from
    the original post in just two clicks 🙂
  • some minor improvements


  • April 5th, 2010
  • javascript bugfixes: attachment copying, clickable media tags, insert
    single images into post… happens when one is not doing the debugging
    part right from the beginning… 😐


  • April 4th, 2010
  • bugfix: options would be reset on reactivation
  • compatibility with custom post types in WordPress 3.0 (set it up on
    media options page, right under „File Gallery“ heading)
  • added option to delete all options on deactivation (for uninstall)
  • check user capabilities before any delete or edit action


  • March 20th, 2010
  • bugfix: attachment data didn’t get saved when edited inside File
    Gallery metabox (a slight javascript oops, sorry about that)
  • caching via WordPress transients
  • states (shown/hidden) of insert options fieldsets are now saved
    and preserved in options automatically
  • new options:
    • enable/disable insert options fieldsets (displays
      attachment list only)
    • enable caching
    • cache non-html output
    • cache expiry time
    • clear cache
    • what additional columns to show on post/page edit screens
  • some minor css fixes


  • February 8th, 2010
  • added ability to copy all attachments from another post
  • added a list of media tags for each attachment (media library screen).
    this also means you can click on a tag’s name and you’ll get a list
    of all attachments using that tag
  • attachment edit screen: added default icon for non images (for now)
  • more icon types in file gallery metabox 😀


  • January 19th, 2010
  • more code optimizations, especially javascript
  • added buttons to toggle gallery / single image options
  • image zoom now opens fullsize image in a jQuery UI dialog
    (works fine in all browsers except Opera – does not get css position,
    will fix for 1.5)
  • fixed theme folder url, custom templates now work (just place them in
    a folder named „file-gallery-templates“ within your theme’s folder)


  • massive reorder / rewrite of the code, especially the javascript
    part which now performs much better, even in internet explorer
  • complete rethink of the way attachment copying works + added a dialog
    box to warn the user of consequences if an attachment that is marked
    for deletion has copies, with multiple choices on how to proceed
  • some preliminary tinymce integration (click on gallery
    placeholder image in visual editor and those attachments present in
    that gallery will get checked – currently only works for galleries
    already present in tinymce editor when opening a post for editing)
  • each attachment that has copies gets a new meta key->value pair:
    „_has_copies“->array(ids of attachment copies)


  • December 30th, 2009
  • nonced everything for security reasons
  • color differentiation for items in media library
  • converted options from variables to constants
  • improved performance when copying items from media library
  • moved attachment file url field on item edit screen to bottom of
    the form
  • added a „cancel and return“ button on item edit screen
  • each copied attachment now gets a new meta key->value pair:


  • December 12th, 2009
  • Rewritten a lot of stuff for better WordPress compliance 🙂