=== Media Tagz Gallery ===
Contributors: danielpunchupproductionscom
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=HXXSUW6CLWCK6
Tags: gallery, tag, tagz, photography, photos, image
Requires at least: 3.0.1
Tested up to: 4.5.2
Stable tag: 4.5.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
Media Tagz Gallery extends the Media Tags plugin to provide a simple, lightweight image gallery
== Description ==
*[Media Tags](https://wordpress.org/plugins/media-tags/ "Media Tags")* is a great plugin that allows you to add
tags to your media - something that should come out of the box. However, the **Media Tagz Gallery** takes it to
another level by adding the ability to pull in your photos by tag names to create a simple, yet flexible way to
create a gallery. No need for bloated image gallery plugins that just become outdated over time.
= Features =
- gallery display by using media tags
- display a tag-based album using media tags - opens to a gallery page
- generate random image (url)
- "load more" button to load more images via ajax
- modal popup: loads large image via ajax
- modal displays camera meta (iso, f-stop, exposure)
- add hyperlink to media (displays in modal)
- Bootrap 3 html syntax ready
- no css style - a blank canvas (with the exception of the modal style)
- shortcodes enabled
== Installation ==
1. Download and install the Media Tags plugin here: *[Media Tags](https://wordpress.org/plugins/media-tags/ "Media Tags")*
2. Upload the Media Tagz Gallery plugin files to the `/wp-content/plugins/plugin-name` directory, or install the
plugin through the WordPress plugins screen directly.
3. Activate the plugin through the 'Plugins' screen in WordPress
= Template Setup =
1. Inject the modal popup via ajax: After you have installed both Media Tags and Media Tagz Gallery plugins, add the following code below
the body tag but within your template's header.php file:
`
`
2. Within the root of your template, add a file named `taxomonomy-media-tags.php`.
3. Copy the code within the `category.php` file and paste the code in the `taxonomy-media-tags.php` file (this is required to display albums using the Media Tags taxonomy)
4. Within the body of the `taxonomy-media-tags.php` file, insert the code below:
``
5. Upload media
6. Add Media Tags to media: Within the Media Manager, click on an image. Click the "Edit more details" link. To the
right you will see a "Media Tags" section where you can add tags. You can assign more than one media tag if you would like the image to show in multiple "Galleries".
= Shortcodes =
TAG ALBUM
`[tagz-album tag=landscape]`
Attributes:
- tag: (string) tag of album to be displayed - shows the most recent image in the tag set as cover image
TAG GALLERY
`[tagz-gallery tags=landscape,wildlife limit=18 show-more=true show-title=true]`
Attributes:
- tags: (array|string) media tags
- limit: (int) limit of images to be displayed in the gallery
- show-more: (string) set to "true" if you want to display the show more button. Set to "no-more" if you wish to remove this button
- show-title: (string) set to "true" if you want to display the image title. Set to "no-title" if you wish to not show the image title
GENERATE MEDIATAG RANDOM IMAGE URL
`[tagz-rand-img tags=landscape,wildlife size=thumbnail]`
Attributes:
- tags: (array|string) media tags
== Frequently Asked Questions ==
= How can I contribute? =
Contribute to this plugin on Github.com here:
*[https://github.com/dmurphy779/wordpress-media-tag-gallery](https://github.com/dmurphy779/wordpress-media-tag-gallery "Contribute")*
== Screenshots ==
1. Showing albums (top) and a gallery (below)
2. Showing an album page (taxonomy page for Media Tags)
3. An example of the modal popup
== Changelog ==
= 1.1 =
* Added shortcode functionality
* Security fixes - filtered post variables
= 1.0 =
* Hello world! * Hello world! - The first appearance of the Media Tag Gallery!
== Upgrade Notice ==
= 1.0 =
no upgrade notices