This repository has been archived by the owner on Apr 20, 2019. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 1
/
readme.txt
101 lines (63 loc) · 4.15 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
# Simple Photo Albums
Contributors: audiotheme, bradyvercher
Tags: photos, albums, gallery
Requires at least: 4.3
Tested up to: 4.6
Stable tag: trunk
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Create photo albums from a group of native galleries.
## Description
Simple Photo Albums turns a group of native gallery shortcodes into photo albums with cover images and allows for advanced integration with scripts like Jetpack's Carousel or Swipebox.
### Usage
Wrap a group of `[gallery]` shortcodes with the `[simple_photo_album]` shortcode:
`[simple_photo_album]
[gallery ids="1,2,3"]
[gallery ids="4,5,6"]
[gallery ids="7,8,9"]
[/simple_photo_album]`
Each gallery becomes an album and requires clicking through to see the actual gallery itself. This example will render the same as `[gallery ids="1,4,7"]`, which admittedly isn't very useful.
However, there are a few attributes that may be beneficial and things really shine when paired with third-party scripts like [Jetpack's Carousel](http://jetpack.me/support/carousel/), [Magnific Popup](http://dimsemenov.com/plugins/magnific-popup/), or [Swipebox](http://brutaldesign.github.io/swipebox/) -- native support is included for all (select one on the **Settings → Media** screen).
Galleries within the album shortcode may include a `gallery_link` attribute to link the cover image to an arbitrary permalink when a third-party script isn't being used:
`[gallery ids="1,2,3" gallery_link="http://example.com/gallery-one/"]`
### Cover Images
By default the first image in each gallery shortcode is used as its cover image and will be included when the gallery is viewed. A manually defined cover can be passed as an additional attribute:
`[gallery ids="1,2,3" cover="25"]`
Covers can be removed from the galleries entirely using the `exclude_covers` attribute on the album shortcode:
`[simple_photo_album exclude_covers="1"]`
### Album Display
Any display-related attributes that can be used on native gallery shortcodes can also be used on the album shortcode to modify its appearance (itemtag, icontag, captiontag, columns, size).
`[simple_photo_album columns="4"]`
### Support Policy
We'll do our best to keep this plugin up to date, fix bugs and implement features when possible, but technical support will only be provided for active AudioTheme customers. If you enjoy this plugin and would like to support its development, you can:
* [Visit AudioTheme](https://audiotheme.com/?utm_source=wordpress.org&utm_medium=link&utm_content=simple-photo-albums-readme&utm_campaign=plugins) and tell your friends!
* [Leave a review](https://wordpress.org/support/view/plugin-reviews/simple-photo-albums#postform) and let everyone know how much you love it.
* [Follow @AudioTheme](https://twitter.com/AudioTheme) on Twitter.
* Help out on the [support forums](https://wordpress.org/support/plugin/simple-photo-albums).
* [Contribute on GitHub](https://github.com/audiotheme/simple-photo-albums).
## Installation
Installing Simple Photo Albums is just like installing most other plugins. [Check out the codex](http://codex.wordpress.org/Managing_Plugins#Installing_Plugins) if you have any questions.
## Frequently Asked Questions
#### Can support be added for additional third-party scripts?
Yes. Find the Jetpack Carousel, Magnific Popup and Swipebox files in the plugin folder as an example. They're all written as plugins to demonstrate how support can be added for just about any script.
## Changelog
### 1.2.0
* Updated Magnific Popup to .
* Updated Swipebox to .
* Fixed Jetpack Carousel support. This may be removed in a future version.
* Removed bundled language files in favor of WordPress.org language packs.
### 1.1.1
* Added French translation.
### 1.1.0
* Added support for Magnific Popup.
### 1.0.3
* Load the plugin text domain on 'plugins_loaded' in preparation for language packs.
### 1.0.2
* Try to remove existing lightbox scripts attached to Swipebox albums.
* Load the Jetpack gallery script later so it's properly initialized.
* Sort the gallery scripts alphabetically in the settings dropdown.
### 1.0.1
* Fix captions in the Swipebox extension.
* Fix strict PHP notices.
### 1.0
* Initial release.