-
Notifications
You must be signed in to change notification settings - Fork 7
/
Copy pathreadme.txt
283 lines (205 loc) · 13 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
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
=== Easy Photography Portfolio ===
Contributors: pyronaur
Donate link: https://pyronaur.com/
Tags: portfolio, photography, gallery, grid, masonry, themeable, album, content gallery, fullscreen gallery, gallery, gallery lightbox, gallery widget, grid gallery, image gallery, masonry gallery, media gallery, photo album, photo gallery, portfolio gallery, post gallery, responsive gallery, thumbnail gallery, video gallery, wordpress gallery, wordpress gallery plugin, youtube gallery, easy photography portfolio, easy, wordpress portfolio plugin
Requires at least: 4.7.0
Tested up to: 5.6.2
Stable tag: 1.5.1
Requires PHP: 5.4.0
License: GPLv3 or later
License URI: http://www.gnu.org/licenses/gpl-3.0.html
Easy Photography Portfolio is an elegant portfolio gallery plugin designed for Photographers. Install the plugin, add portfolio entries and galleries and you'll have a portfolio in minutes!
== Description ==
Building a photography portfolio for WordPress should be easy. Here's a plugin to help you with that!
### Quick Overview
Easy Photography Portfolio is based on the idea of albums with images that can optionally be grouped in categories!
By default, albums and images are displayed in a masonry gallery. You open up an album to see all the images. then click on an image to look at it closer.
I think it might be easier to explain with a demo.
### Plugin Demo
Easy Photography Portfolio is extremely flexible, from the most basic to completely custom designs.
**📌 Demo: Minimalist Portfolio**
[Minimalist Portfolio](https://wordpress.org/themes/minimalist-portfolio/) is a **free** WordPress theme - customized to look great with Easy Photography Portfolio plugin!
* **[Minimalist Portfolio Demo](http://befree.pyronaur.com/)**
* [Tutorial](https://colormelon.com/free-portfolio-website-tutorial/) - full theme and plugin setup
* [Source Code](https://github.com/pyronaur/minimalist-portfolio) on GitHub
## 📚 Setup Tutorials
The plugin name gave it away - it's really easy to set up a portfolio with it. And yet, here are some extra resources for you:
* [Full setup guide](https://colormelon.com/easy-photography-portfolio-full-setup-guide/) - as close to documentation as you can get
* [A-Z Photography Portfolio tutorial](https://colormelon.com/free-portfolio-website-tutorial/) with Hamilton child theme (Minimalist Portfolio)
### 🎥 Video Tutorial
If detailed documentation and guides aren't enough for you, watch the video tutorial:
[youtube https://www.youtube.com/watch?v=b5mevuD-hPI]
### Designed for Photographers
We love the WordPress community and wholeheartedly agree with the [WordPress Philosophy](https://wordpress.org/about/philosophy/).
Great software should work out of the box, without the user having to adjust oceans of buttons and knobs.
That's why Photography Portfolio is designed to be as easy to use as possible.
Photography Portfolio plugin is founded upon years of experience in building Premium Wordpress Themes for Photographers. We've seen it all, great and not-so-great websites, big names, and absolute beginners. We have crystallized the formula of a high-quality portfolio into a simple WordPress plugin that you can use with any WordPress theme or your custom WordPress site!
It all comes down to the simple structure of a real Portfolio book.
You own a Portfolio album for, let's say your Wedding Photography. If you happen to do street Photography too, you also probably have another album that has only your best street photography prints.
That's exactly what Photography Portfolio does for you online. You create albums, add images, and in case you have a huge portfolio, you can categorize albums too.
Then your visitors are able to open any album, quickly scan all of the images, or view them one by one. Simplicity is key!
### Developed for Extensibility
Out of the box, Photography Portfolio is built using Masonry Layout (think Pinterest). Quite simply - it's the layout most easily portable to any website layout while keeping the feel of the brand.
**Warning**: Developer language ahead.
For some, a masonry layout might not be enough, it sure isn't enough for our Photography WordPress themes, because of that, this plugin is packed with Actions and Filters. Not only in PHP but also the JavaScript side.
You can easily extend the plugin with your own custom archive and single-view layouts. Customization is easy as Photography Portfolio plugin templates are based on `get_template_part()` function, similar to the way WooCommerce plugin has a custom template function. That brings a lot of customization power to the table. Pick any part of the view, and append your own template bits or completely rewrite the templates.
The JavaScript side is also very opinionated and easily extensible. You can use filters and actions to either modify the existing functionality, for example modifying the core masonry layout just a bit or completely initialize a brand new layout (like Packery or Horizontal Scroll). If you decide to build a custom view, you can utilize the existing JavaScript hook structure to let the plugin handle all the little things for you.
== Frequently Asked Questions ==
= Help!!!! =
[Ask for help in the free WordPress.org forums](https://wordpress.org/support/plugin/photography-portfolio)
= How to use the plugin? =
It's quite easy to set up the plugin. Here are a few resources:
* [Full setup guide](https://colormelon.com/easy-photography-portfolio-full-setup-guide/) - as close to documentation as you can get
* [A-Z Photography Portfolio tutorial](https://colormelon.com/free-portfolio-website-tutorial/) with Hamilton child theme
There is also a 7 minute video tutorial:
[youtube https://www.youtube.com/watch?v=b5mevuD-hPI]
= Is this Developer friendly? Any examples? =
Everything code-related can be found on [GitHub](https://github.com/pyronaur/easy-photography-portfolio/) and [Github Wiki](https://github.com/pyronaur/easy-photography-portfolio/wiki/)
If you have questions, you can ask them in [Support Forums](https://wordpress.org/support/plugin/photography-portfolio) or in [GitHub issues](https://github.com/pyronaur/easy-photography-portfolio/issues) or tweet me [@pyronaur](https://twitter.com/pyronaur)
== Installation ==
This plugin requires at least **PHP 5.4**
You can read the **[full setup guide here](https://colormelon.com/easy-photography-portfolio-full-setup-guide/)** or watch the [video tutorial](https://www.youtube.com/watch?v=b5mevuD-hPI)
1. Upload "Photography Portfolio" plugin to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Add a few Portfolio entries in "Portfolio -> New Portfolio Entry"
4. Make sure your portfolio entries have a thumbnail.
5. That's it! Enjoy your Portfolio!
== Changelog ==
= 1.5.1 =
* Fixed Yoast SEO Compatibility issue
* Fixed WP Core Hooks compatibility issue
= 1.5.0 =
* This isn't a significant major release, just a small increment.
* Fixed escaping issues
* Updated CMB to version 2.6.0
= 1.4.9 =
* Various minor improvements
= 1.4.8 =
* Fix: Bug which forced archive title & description
= 1.4.7 =
* Updated CMB to version 2.3.0 that fixes a problem in PHP 7.1+
= 1.4.6 =
* Gracefully deactivate plugin if PHP Requirements are not met
= 1.4.5 =
* Add Yoast SEO Compatibility. Go ahead - optimize your portfolio archive SEO! 🎯
= 1.4.4 =
* Fix Video Support
* Fix first plugin initialization process - automatically create the Portfolio page
* When creating Portfolio page, call it "Portfolio" instead of "Easy Photography Portfolio"
= 1.4.3 =
* Automatically center Photoswipe Captions
* Code clean-ups 🚰
= 1.4.2 =
* Fix PhotoSwipe asset name collisions with WooCommerce
* Update Dashboard UI
= 1.4.1 =
* Fix Single Column spacing in themes that don't natively support Easy Photography Portfolio
= 1.4.0 =
* New Portfolio Layout: Single Column in Single Portfolio Entries 🏛
* Clean up a lot of the code 🚿
* 🔥 Major changes in template loading! From now on tempaltes are loaded through hooks, so you can tap into before AND after ANY template part has been loaded.
* 🛠 Deprecate quite a few actions because they're not needed anymore!: `phort/wrapper/start`, `phort/wrapper/end`, `phort/load_template/{$base}`
* 🛠 Add `phort_attach_template()` and `phort_detach_template()` functions to easily attach or remove template files
* Enable "show_in_rest" for Gutenberg Compatibility!
* Change PhotoSwipe.js queue handles from `phort-photoswipe-*` to `photoswipe-*`
= 1.3.1 =
* As promised, a bug was introduced in 1.3.0 🐞
* Fixed bug where portfolio would completely break down if pop-up galleries were disabled
* Fixed bug where Admin JavaScript didn't load because it didn't exist
* No additional bugs introduced in this version 😇
= 1.3.0 =
* It's finally here! You asked for it, and now it's here! Drumroll please!
* 🥁 🥁 🥁 🥁 🥁 🍗 🥁
* 🎉 Added option to set a single portfolio gallery as your home page!
* 🎉 Added option to set a portfolio category as your home page!
* 🎉 Added option to hide gallery captions in post-view while showing them in pop-up galleries!
* Also, some under-the hood moficiations for the way galleries are handled. Makes it easier to style the plugin
* Also, fixed bugs 🐛
* Most probably introduced a bug or two with the new homepage functionality!
* What do you call a lazy doctor? Dr. Do Little. 👀
* 🛠 Deprecate `phort_entry_data_attribute` in favor of `phort_entry_data_attributes` in `/templates/archive/entry.php` template
= 1.2.5 =
* Fixed bugs. 🐜
= 1.2.4 =
* Improve custom portfolio query compatiblity
* Improve default layout styling
= 1.2.2 =
* Code clean-ups 🛁
* Add new hook `phort/layout/init` - run before the view genertation has started
* Make masonry fit the PP_Wrapper from edge to edge
= 1.2.1 =
* Only create "Easy Photography Portfolio" page when "Portfolio" doesn't exist
* Add function `phort_get_meta()`
= 1.2.0 =
* Automatically open the popup gallery based on the URL 🤘
* Add an alternative pop-up gallery - PhotoSwipe 🖼
* Add full support for captions and descriptions 🎉 🎉 🎉
* Rename app[.css|.js} to photography-portfolio[.css|.js]
* Enqueue libraries separately instead of bundling everyting into libs.js
* Don't rely on underscore.js anymore
* Don't load jQuery Masonry when it's not needed
* Increase gallery z-index to fix popup gallery display poorly coded themes
= 1.1.9 =
* Fix plugin in themes that don't load jQuery
* Add password protection support
= 1.1.8 =
* Fix compatibility issue with WooCommerce. Thank you @miraaz for reporting it.
= 1.1.7 =
* Increase the /portfolio/ archive limit from default WP setting to 100
= 1.1.6 =
* Fix lightGallery social sharing issues, for real.
* Close the whole gallery on ESC key
* Add options to disable thumbnails or hide them by default
* CSS Improvements
* Reorganize settings this much -> 👌
* Make a few more strings translatable
= 1.1.5 =
* Translations are now working!
* Trigger `phort.lazy.loaded_item` after each lazy-loading item has loaded
* Fix lightGallery social sharing issues
* Improve inline documentation
* Better masonry alignment
= 1.1.4 =
* Better default setting management. Defaults are now used by....default. Even before the options object is populated. Yay.
* Set image height to auto, because as it turns out some themes don't do that out of the box.
* Introduce `phort_set_defaults`, deprecate setting defaults with hooks
* Refactor a lot of code, hopefully making it easier to read
* You're actually reading this. I like you. Here, have a cookie 🍪
= 1.1.3 =
* Show a message with a link to a setup guide when the plugin is activated
* Add a default portfolio entry if none already exist
* Add a default portfolio page and automatically set it up in the settings
* Add a settings link in plugins page
* Update Tested up to tag
= 1.1.2 =
* Add option to disable the popup gallery
* Add WPML Compitability ( thanks to @vukvukovich from WPML )
* Update CMB2
= 1.1.1 =
* Make sure images have 100% max width, some themes don't do that by default
* Add actions for to make it easier to tap into the templates: `phort/{archive|gallery}/loop/{start|end}`
= 1.1.0 =
* Make sure all top level template wrappers utilize `phort_class()`
* More elaborate plugin settings with dropdowns instead of checkboxes
* Add permalink class `.PP_Entry__permalink`
= 1.0.9 =
* Always make sure an image exists before trying to display it
= 1.0.8 =
* Add function `phort_is_front_page()`
* Add play button overlay on videos
* Validate layouts before returning `phort_slug_current()` value
= 1.0.7 =
* Correctly set-up postdata in single portfolio layouts
* Revolutionary new UI when creating a new portfolio entry ( fixed subtitle alignment )
* Hide layout setting dropdowns if there are no layouts to choose from.
* Clarify code and comments
* By default load 100 portfolio entries. If you need more, you're responsible for displaying them properly. Why would you need a portfolio with more than 100 albums ?
* Remove filter `phort/get_template`.
* Introduce filter `phort/get_template/{$base}`
* Allow themes/plugins to modify EPP Defaults
= 1.0.5 =
* Fix broken portfolio links
* Improve JavaScript hooks
* Other minor improvements
= 1.0.0 =
* First Release!