PluginProbe
Photonic Gallery & Lightbox for Flickr, SmugMug & Others / 2.41
Photonic Gallery & Lightbox for Flickr, SmugMug & Others v2.41
3.36 3.35 3.34 3.33 2.19 2.20 2.21 2.22 2.23 2.24 2.25 2.26 2.27 2.28 2.29 2.30 2.31 2.32 2.33 2.34 2.40 2.41 2.42 2.43 2.44 All 141 releases
photonic / Admin / Getting_Started.php

Getting_Started.php in Photonic Gallery & Lightbox for Flickr, SmugMug & Others 2.41, at Admin/Getting_Started.php

572 lines 25.5 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 <?php
2 namespace Photonic_Plugin\Admin;
3
4 if (!defined('ABSPATH')) {
5 echo '<h1>WordPress not loaded!</h1>';
6 exit;
7 }
8
9 require_once('Admin_Page.php');
10
11 class Getting_Started extends Admin_Page {
12 private static $instance;
13
14 private function __construct() {
15 // Empty
16 }
17
18 static function get_instance() {
19 if (self::$instance == null) {
20 self::$instance = new Getting_Started();
21 }
22 return self::$instance;
23 }
24
25 function render_content() {
26 $this->capabilities();
27 $this->build_gallery();
28 $this->layouts();
29 $this->lightbox();
30 $this->secret_menu();
31 $this->helper_shortcode();
32 $this->really_technical();
33 }
34
35 function capabilities() {
36 ?>
37 <h2 class="photonic-section">Capabilities and Documentation</h2>
38 <p>
39 Photonic can show you photos and galleries not just from standard WordPress, but also from several third-party photo-hosting providers
40 such as Flickr, SmugMug, Google Photos etc. The following table tells you what you need for each provider, and provides you with
41 documentation links for how to show something using Photonic.
42 </p>
43
44 <table class="form-table photonic-form-table">
45 <tr>
46 <th rowspan="2" class="theader">Provider</th>
47 <th colspan="4" class="theader">What Can You Show?</th>
48 <th rowspan="2" class="theader">Authentication</th>
49 <th rowspan="2" class="theader">Lightbox Support</th>
50 </tr>
51
52 <tr>
53 <th class="theader">Single Photo<br/>(Level 0)</th>
54 <th class="theader">Photos / Videos<br/>(Level 1)</th>
55 <th class="theader">Albums / Sets / Galleries<br/>(Level 2)</th>
56 <th class="theader">Collections / Groups<br/>(Level 3)</th>
57 </tr>
58
59 <tr>
60 <th>Native WP</th>
61 <td>Not supported</td>
62 <td><a href="https://aquoid.com/plugins/photonic/wp-galleries/">Standard gallery photos</a>, no videos in WP galleries</td>
63 <td><a href="https://aquoid.com/plugins/photonic/wp-galleries/">Standard galleries</a></td>
64 <td>No such feature in WP</td>
65 <td>No such feature in WP</td>
66 <td>All</td>
67 </tr>
68
69 <tr>
70 <th>
71 Flickr<br/>
72 <em><a href="http://www.flickr.com/services/api/misc.api_keys.html">API Key Required</a></em><br/>
73 <em>See <a href="https://aquoid.com/plugins/photonic/flickr/#api-key">Instructions</a></em>
74 </th>
75 <td><a href="https://aquoid.com/plugins/photonic/flickr/flickr-photo/">Supported</a></td>
76 <td><a href="https://aquoid.com/plugins/photonic/flickr/flickr-photos/">User Photos, Videos and Group Pools</a></td>
77 <td><a href="https://aquoid.com/plugins/photonic/flickr/flickr-photosets/">Albums / Photosets</a> and <a href="https://aquoid.com/plugins/photonic/flickr/flickr-galleries/">Galleries</a></td>
78 <td><a href="https://aquoid.com/plugins/photonic/flickr/flickr-collections/">Collections, with lazy loading</a></td>
79 <td><a href="https://aquoid.com/plugins/photonic/flickr/flickr-authentication/">Required to share private photos</a></td>
80 <td>All; Image Lightbox, PrettyPhoto and StripJS cannot handle videos; Lightcase shows Flash videos for Flickr</td>
81 </tr>
82
83 <tr>
84 <th>
85 SmugMug<br/>
86 <em><a href="https://api.smugmug.com/api/developer/apply">API Key required for private photos</a></em><br/>
87 <em>See <a href="https://aquoid.com/plugins/photonic/smugmug/#api-key">instructions</a></em>
88 </th>
89 <td>Not supported</td>
90 <td><a href="https://aquoid.com/plugins/photonic/smugmug/smugmug-photos/">User photos and videos</a></td>
91 <td><a href="https://aquoid.com/plugins/photonic/smugmug/smugmug-albums/">Albums</a></td>
92 <td><a href="https://aquoid.com/plugins/photonic/smugmug/smugmug-tree/">User tree</a> and <a href="https://aquoid.com/plugins/photonic/smugmug/folders/">Folders</a></td>
93 <td><a href="https://aquoid.com/plugins/photonic/smugmug/smugmug-albums/#protected">Password-protection</a>, <a href="https://aquoid.com/plugins/photonic/authentication/#back-end">Authentication to share your private photos</a> </td>
94 <td>All; Image Lightbox, PrettyPhoto and StripJS cannot handle videos</td>
95 </tr>
96
97 <tr>
98 <th>
99 Google Photos<br/>
100 <a href="https://console.developers.google.com/apis/">Client ID required</a><br/>
101 <a href="https://aquoid.com/plugins/photonic/google-photos/#auth">Authentication required</a>
102 </th>
103 <td>Not supported</td>
104 <td><a href="https://aquoid.com/plugins/photonic/google-photos/photos/">Photos and Videos</a></td>
105 <td><a href="https://aquoid.com/plugins/photonic/google-photos/albums/">Albums</a></td>
106 <td>No such feature in Google Photos</td>
107 <td><a href="https://aquoid.com/plugins/photonic/google-photos/#auth">Back-end authentication</a></td>
108 <td>All; Fancybox, Featherlight, Image Lightbox, PrettyPhoto and StripJS cannot handle videos</td>
109 </tr>
110
111 <tr>
112 <th>Zenfolio</th>
113 <td><a href="https://aquoid.com/plugins/photonic/zenfolio/photos/#individual">Supported</a></td>
114 <td><a href="https://aquoid.com/plugins/photonic/zenfolio/photosets/">User</a> and <a href="https://aquoid.com/plugins/photonic/zenfolio/photos/">Generic</a> photos and videos</td>
115 <td><a href="https://aquoid.com/plugins/photonic/zenfolio/photosets/">Photosets (Galleries and Collections)</a></td>
116 <td><a href="https://aquoid.com/plugins/photonic/zenfolio/groups/">Groups</a> and <a href="https://aquoid.com/plugins/photonic/zenfolio/group-hierarchy/">Group hierarchies</a></td>
117 <td><a href="https://aquoid.com/plugins/photonic/zenfolio/groups/">Password-protection supported</a>, authentication not supported</td>
118 <td>All; Image Lightbox, PrettyPhoto and StripJS cannot handle videos</td>
119 </tr>
120
121 <tr>
122 <th>
123 Instagram<br/>
124 <a href="https://aquoid.com/plugins/photonic/instagram/#auth-setup">Authentication required</a>
125 </th>
126 <td><a href="https://aquoid.com/plugins/photonic/instagram/#photo-of-the-day">Supported</a></td>
127 <td><a href="https://aquoid.com/plugins/photonic/instagram/#own-photos">User photos and videos</a></td>
128 <td>No such feature in Instagram</td>
129 <td>No such feature in Instagram</td>
130 <td><a href="https://aquoid.com/plugins/photonic/instagram/#auth-setup">Back-end / server-side</a></td>
131 <td>All; Image Lightbox, PrettyPhoto and StripJS cannot handle videos</td>
132 </tr>
133 </table>
134
135 <?php
136 }
137
138 function build_gallery() {
139 ?>
140 <h2 class="photonic-section">Showing a Gallery</h2>
141 <p>
142 While using the Classic Editor a gallery is displayed using the <code>[gallery]</code> shortcode. If the Gutenberg Block Editor is
143 used a gallery is displayed using a Gutenberg Block instead. Given the plethora of options and configurations offered in Photonic,
144 things have been made easier by virtue of a shortcode insertion UI. To use it:
145 </p>
146
147 <ol>
148 <li>
149 <h4>Getting Started</h4>
150 If you are using the "Classic Editor" click on the "Add Media" button or the "Add / Edit Photonic Gallery" button:<br/>
151 <img src="<?php echo PHOTONIC_URL.'screenshot-2.jpg'; ?>" /><br/><br/>
152
153 Correspondingly if you are using "Gutenberg" use the Photonic Gallery block:<br/>
154 <img src="<?php echo PHOTONIC_URL.'screenshot-1.png'; ?>" />
155 </li>
156
157 <li>
158 <h4>Building a Gallery</h4>
159 <ol>
160 <li>
161 <strong>Via "Add Media"</strong>
162 <ol>
163 <li>
164 Click on the "Photonic" tab:<br/>
165 <img src="<?php echo PHOTONIC_URL.'screenshot-5.jpg'; ?>" /><br/>
166 </li>
167 <li>
168 Pick your source:<br/>
169 <img src="<?php echo PHOTONIC_URL.'screenshot-6.jpg'; ?>" /><br/>
170 </li>
171 <li>
172 Fill out the attributes for the gallery:<br/>
173 <img src="<?php echo PHOTONIC_URL.'screenshot-8.png'; ?>" /><br/>
174 </li>
175 </ol>
176 </li>
177 <li>
178 <strong>Via "Add / Edit Photonic Gallery", or the "Photonic Gallery" block</strong>
179 <ol>
180 <li>
181 You are presented with a screen to pick the source for your gallery:<br/>
182 <img src="<?php echo PHOTONIC_URL.'screenshot-3.png'; ?>" /><br/>
183 </li>
184 <li>
185 You will be shown a contextual set of options based on your choices:<br/>
186 <img src="<?php echo PHOTONIC_URL.'screenshot-4.png'; ?>" /><br/>
187 </li>
188 </ol>
189 </li>
190 </ol>
191 </li>
192 <li>
193 Depending on which gallery you inserted you will be shown a placeholder of this sort:<br/>
194 <img src="<?php echo PHOTONIC_URL.'screenshot-7.png'; ?>" />
195 </li>
196 <li>
197 Clicking on the placeholder will let you edit the gallery you inserted.<br/>
198 Note that if you are using the Visual Editor, you <em>may</em> encounter TinyMCE conflicts with other plugins. In case of such a conflict
199 please <a href="https://wordpress.org/support/plugin/photonic/">report a bug</a>, and disable the Visual Editor integration from
200 <em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Generic Settings &rarr; Disable shortcode editing in Visual Editor</em>. The plugin will
201 continue working normally &ndash; the only difference is that you will have to do shortcode edits by hand via the Text Editor rather than via a UI
202 in the Visual Editor.
203 </li>
204 </ol>
205 <?php
206 }
207
208 function layouts() {
209 ?>
210 <h2 class="photonic-section">Gallery Layouts</h2>
211 <p>
212 Photonic supports the following types of layouts:
213 </p>
214 <ol>
215 <li><a href="https://aquoid.com/plugins/photonic/layouts/#square">Square thumbnails</a></li>
216 <li><a href="https://aquoid.com/plugins/photonic/layouts/#circle">Circular thumbnails</a></li>
217 <li><a href="https://aquoid.com/plugins/photonic/layouts/#slideshow">Slideshow</a></li>
218 <li><a href="https://aquoid.com/plugins/photonic/layouts/#justified">Random Justified Grid</a></li>
219 <li><a href="https://aquoid.com/plugins/photonic/layouts/#masonry">Masonry</a></li>
220 <li><a href="https://aquoid.com/plugins/photonic/layouts/#mosaic">Mosaic</a></li>
221 </ol>
222 <?php
223 }
224
225 function lightbox() {
226 ?>
227 <h2 class="photonic-section">Which Lightbox?</h2>
228 <p>
229 Photonic includes several lightboxes and supports some others that it cannot include due to licensing reasons. Each lightbox has
230 its own strengths &mdash; some are lightweight, some are full-featured and some are very elegant looking. You can pick one based on the
231 features that you feel are most important to you. Note that out-of-the-box, several of these don't support features such as touch gestures, or deep-linking,
232 but for Photonic those capabilities have been integrated into the scripts via other approaches.
233 </p>
234 <table class="form-table photonic-form-table">
235 <tr>
236 <th class="theader">Lightbox</th>
237 <th class="theader">Included in Photonic?</th>
238 <th class="theader">Size</th>
239 <th class="theader"><abbr title="When you open a gallery in a lightbox, this lets the lightbox run in a slideshow mode automatically without the user driving the navigation.">Auto-slideshow</abbr></th>
240 <th class="theader"><abbr title="Deep-linking assigns a URL to every image in a gallery. If you enter that URL directly in a browser's address bar, it automatically opens the image in a lightbox.">Deep-linking</abbr></th>
241 <th class="theader"><abbr title="If deep-linking is enabled, you have the option to display social sharing links. Photonic can help you share links on Facebook, Twitter and Google+.">Social Sharing</abbr></th>
242 <th class="theader">Touch</th>
243 <th class="theader">YouTube, Vimeo etc.</th>
244 <th class="theader">HTML5 Videos from Flickr etc.</th>
245 <th class="theader">External / Self-hosted MP4 videos</th>
246 <th class="theader"><abbr title="This capability helps display thumbnails for all your images within the lightbox.">Thumbnails</abbr></th>
247 </tr>
248
249 <tr>
250 <th><a href="http://colorpowered.com/colorbox/">Colorbox</a></th>
251 <td class="check"><span class="yes">&#x2713;</span></td>
252 <td>
253 <ul>
254 <li>JS: 10KB</li>
255 <li>CSS: 5KB</li>
256 </ul>
257 </td>
258 <td class="check"><span class="yes">&#x2713;</span></td>
259 <td class="check"><span class="yes">&#x2713;</span></td>
260 <td class="check"><span class="yes">&#x2713;</span></td>
261 <td class="check"><span class="yes">&#x2713;</span></td>
262 <td class="check"><span class="yes">&#x2713;</span></td>
263 <td class="check"><span class="yes">&#x2713;</span></td>
264 <td class="check"><span class="yes">&#x2713;</span></td>
265 <td class="check"><span class="no">&times;</span></td>
266 </tr>
267
268 <tr>
269 <th><a href="http://fancybox.net/">Fancybox</a></th>
270 <td class="check"><span class="yes">&#x2713;</span></td>
271 <td>
272 <ul>
273 <li>JS: 16KB</li>
274 <li>CSS: 9KB</li>
275 </ul>
276 </td>
277 <td class="check"><span class="yes">&#x2713;</span></td>
278 <td class="check"><span class="no">&times;</span></td>
279 <td class="check"><span class="no">&times;</span></td>
280 <td class="check"><span class="yes">&#x2713;</span></td>
281 <td class="check"><span class="yes">&#x2713;</span></td>
282 <td class="check"><span class="yes">&#x2713;</span></td>
283 <td class="check"><span class="yes">&#x2713;</span></td>
284 <td class="check"><span class="no">&times;</span></td>
285 </tr>
286
287 <tr>
288 <th><a href="http://fancyapps.com/fancybox/">Fancybox2</a></th>
289 <td class="check"><span class="no">&times;</span></td>
290 <td>
291 <ul>
292 <li>JS: 23KB</li>
293 <li>CSS: 5KB</li>
294 </ul>
295 </td>
296 <td class="check"><span class="yes">&#x2713;</span></td>
297 <td class="check"><span class="yes">&#x2713;</span></td>
298 <td class="check"><span class="yes">&#x2713;</span></td>
299 <td class="check"><span class="yes">&#x2713;</span></td>
300 <td class="check"><span class="yes">&#x2713;</span></td>
301 <td class="check"><span class="yes">&#x2713;</span></td>
302 <td class="check"><span class="yes">&#x2713;</span></td>
303 <td class="check"><span class="yes">&#x2713;</span></td>
304 </tr>
305
306 <tr>
307 <th><a href="http://fancyapps.com/fancybox/3/">Fancybox3</a></th>
308 <td class="check"><span class="yes">&#x2713;</span></td>
309 <td>
310 <ul>
311 <li>JS: 61KB</li>
312 <li>CSS: 14KB</li>
313 </ul>
314 </td>
315 <td class="check"><span class="yes">&#x2713;</span></td>
316 <td class="check"><span class="yes">&#x2713;</span></td>
317 <td class="check"><span class="yes">&#x2713;</span></td>
318 <td class="check"><span class="yes">&#x2713;</span></td>
319 <td class="check"><span class="yes">&#x2713;</span></td>
320 <td class="check"><span class="yes">&#x2713;</span></td>
321 <td class="check"><span class="yes">&#x2713;</span></td>
322 <td class="check"><span class="yes">&#x2713;</span></td>
323 </tr>
324
325 <tr>
326 <th><a href="http://noelboss.github.io/featherlight/">Featherlight</a></th>
327 <td class="check"><span class="yes">&#x2713;</span></td>
328 <td>
329 <ul>
330 <li>JS: 13KB</li>
331 <li>CSS: 5KB</li>
332 </ul>
333 </td>
334 <td class="check"><span class="no">&times;</span></td>
335 <td class="check"><span class="yes">&#x2713;</span></td>
336 <td class="check"><span class="yes">&#x2713;</span></td>
337 <td class="check"><span class="yes">&#x2713;</span></td>
338 <td class="check"><span class="yes">&#x2713;</span></td>
339 <td class="check"><span class="yes">&#x2713;</span></td>
340 <td class="check"><span class="yes">&#x2713;</span></td>
341 <td class="check"><span class="no">&times;</span></td>
342 </tr>
343
344 <tr>
345 <th><a href="https://osvaldas.info/image-lightbox-responsive-touch-friendly">Image Lightbox</a></th>
346 <td class="check"><span class="yes">&#x2713;</span></td>
347 <td>
348 <ul>
349 <li>JS: 6KB</li>
350 <li>CSS: 5KB</li>
351 </ul>
352 </td>
353 <td class="check"><span class="no">&times;</span></td>
354 <td class="check"><span class="yes">&#x2713;</span></td>
355 <td class="check"><span class="yes">&#x2713;</span></td>
356 <td class="check"><span class="yes">&#x2713;</span></td>
357 <td class="check"><span class="no">&times;</span></td>
358 <td class="check"><span class="no">&times;</span></td>
359 <td class="check"><span class="no">&times;</span></td>
360 <td class="check"><span class="no">&times;</span></td>
361 </tr>
362
363 <tr>
364 <th><a href="http://cornel.bopp-art.com/lightcase/">LightCase</a></th>
365 <td class="check"><span class="yes">&#x2713;</span></td>
366 <td>
367 <ul>
368 <li>JS: 25KB</li>
369 <li>CSS: 16KB</li>
370 </ul>
371 </td>
372 <td class="check"><span class="yes">&#x2713;</span></td>
373 <td class="check"><span class="yes">&#x2713;</span></td>
374 <td class="check"><span class="yes">&#x2713;</span></td>
375 <td class="check"><span class="yes">&#x2713;</span></td>
376 <td class="check"><span class="yes">&#x2713;</span></td>
377 <td class="check"><span class="yes">&#x2713;</span></td>
378 <td class="check"><span class="yes">&#x2713;</span></td>
379 <td class="check"><span class="no">&times;</span></td>
380 </tr>
381
382 <tr>
383 <th><a href="https://sachinchoolur.github.io/lightGallery/">Lightgallery</a></th>
384 <td class="check"><span class="yes">&#x2713;</span></td>
385 <td>
386 <ul>
387 <li>JS: 18KB</li>
388 <li>CSS: 20KB</li>
389 <li>Fonts: 20KB</li>
390 <li>+ Additional Plugins</li>
391 </ul>
392 </td>
393 <td class="check"><span class="yes">&#x2713;</span></td>
394 <td class="check"><span class="yes">&#x2713;</span></td>
395 <td class="check"><span class="yes">&#x2713;</span></td>
396 <td class="check"><span class="yes">&#x2713;</span></td>
397 <td class="check"><span class="yes">&#x2713;</span></td>
398 <td class="check"><span class="yes">&#x2713;</span></td>
399 <td class="check"><span class="yes">&#x2713;</span></td>
400 <td class="check"><span class="yes">&#x2713;</span></td>
401 </tr>
402
403 <tr>
404 <th><a href="http://dimsemenov.com/plugins/magnific-popup/">Magnific Popup</a></th>
405 <td class="check"><span class="yes">&#x2713;</span></td>
406 <td>
407 <ul>
408 <li>JS: 20KB</li>
409 <li>CSS: 7KB</li>
410 </ul>
411 </td>
412 <td class="check"><span class="no">&times;</span></td>
413 <td class="check"><span class="yes">&#x2713;</span></td>
414 <td class="check"><span class="yes">&#x2713;</span></td>
415 <td class="check"><span class="yes">&#x2713;</span></td>
416 <td class="check"><span class="yes">&#x2713;</span></td>
417 <td class="check"><span class="yes">&#x2713;</span></td>
418 <td class="check"><span class="yes">&#x2713;</span></td>
419 <td class="check"><span class="no">&times;</span></td>
420 </tr>
421
422 <tr>
423 <th><a href="http://photoswipe.com/">PhotoSwipe</a></th>
424 <td class="check"><span class="yes">&#x2713;</span></td>
425 <td>
426 <ul>
427 <li>JS: 41KB</li>
428 <li>CSS: 16KB</li>
429 </ul>
430 </td>
431 <td class="check"><span class="no">&times;</span></td>
432 <td class="check"><span class="yes">&#x2713;</span></td>
433 <td class="check"><span class="yes">&#x2713;</span></td>
434 <td class="check"><span class="yes">&#x2713;</span></td>
435 <td class="check"><span class="yes">&#x2713;</span></td>
436 <td class="check"><span class="yes">&#x2713;</span></td>
437 <td class="check"><span class="yes">&#x2713;</span></td>
438 <td class="check"><span class="no">&times;</span></td>
439 </tr>
440
441 <tr>
442 <th><a href="http://www.no-margin-for-errors.com/projects/prettyphoto-jquery-lightbox-clone/">PrettyPhoto</a></th>
443 <td class="check"><span class="yes">&#x2713;</span></td>
444 <td>
445 <ul>
446 <li>JS: 23KB</li>
447 <li>CSS: 27KB</li>
448 </ul>
449 </td>
450 <td class="check"><span class="yes">&#x2713;</span></td>
451 <td class="check"><span class="yes">&#x2713;</span></td>
452 <td class="check"><span class="yes">&#x2713;</span></td>
453 <td class="check"><span class="yes">&#x2713;</span></td>
454 <td class="check"><span class="yes">&#x2713;</span></td>
455 <td class="check"><span class="no">&times;</span></td>
456 <td class="check"><span class="yes">&#x2713;</span></td>
457 <td class="check"><span class="yes">&#x2713;</span></td>
458 </tr>
459
460 <tr>
461 <th><a href='http://stripjs.com'>Strip</a></th>
462 <td class="check"><span class="no">&times;</span></td>
463 <td>
464 <ul>
465 <li>JS: 39KB</li>
466 <li>CSS: 13KB</li>
467 </ul>
468 </td>
469 <td class="check"><span class="no">&times;</span></td>
470 <td class="check"><span class="yes">&#x2713;</span></td>
471 <td class="check"><span class="no">&times;</span></td>
472 <td class="check"><span class="yes">&#x2713;</span></td>
473 <td class="check"><span class="yes">&#x2713;</span></td>
474 <td class="check"><span class="no">&times;</span></td>
475 <td class="check"><span class="no">&times;</span></td>
476 <td class="check"><span class="no">&times;</span></td>
477 </tr>
478
479 <tr>
480 <th><a href="http://brutaldesign.github.io/swipebox/">Swipebox</a></th>
481 <td class="check"><span class="yes">&#x2713;</span></td>
482 <td>
483 <ul>
484 <li>JS: 12KB</li>
485 <li>CSS: 5KB</li>
486 </ul>
487 </td>
488 <td class="check"><span class="no">&times;</span></td>
489 <td class="check"><span class="yes">&#x2713;</span></td>
490 <td class="check"><span class="yes">&#x2713;</span></td>
491 <td class="check"><span class="yes">&#x2713;</span></td>
492 <td class="check"><span class="yes">&#x2713;</span></td>
493 <td class="check"><span class="yes">&#x2713;</span></td>
494 <td class="check"><span class="yes">&#x2713;</span></td>
495 <td class="check"><span class="no">&times;</span></td>
496 </tr>
497
498 </table>
499 <?php
500 }
501
502 function secret_menu() {
503 ?>
504 <h2 class="photonic-section">The Secret Menu</h2>
505 <p>
506 While the shortcode generator for Photonic is fairly comprehensive, there are some additional hidden shortcode parameters that you can use. These are baked into the
507 interactive shortcode builder / Photonic block for Gutenberg, but will not show up in the traditional shortcode interface:
508 </p>
509 <ol>
510 <li><code>title_position</code> &ndash; Takes values <code>none</code>, <code>regular</code>, <code>tooltip</code>, <code>below</code>, <code>hover-slideup-show</code> and <code>slideup-stick</code>. It overrides the title positioning that you have set for that particular provider through your options.</li>
511 <li><code>headers</code> &ndash; Takes a comma-separated list containing none or more of <code>thumbnail</code>, <code>title</code>, and <code>counter</code>.
512 If a value is specified, that particular component will be shown in the level 2 entity's (i.e. album / gallery / set) header, regardless of the back-end options.
513 So, setting <code>headers='title,counter'</code> for a particular call to display a Zenfolio set, will show the title and photo-count for that set in the header, and not its thumbnail.</li>
514 <li><code>fx</code> &ndash; Applicable to slideshow layouts. Takes values <code>fade</code> and <code>slide</code> to provide the transitioning effect between slides.</li>
515 <li><code>speed</code> &ndash; Applicable to slideshow layouts. Takes numeric values in milliseconds, determines the speed of transitioning of slides.</li>
516 <li><code>timeout</code> &ndash; Applicable to slideshow layouts. Takes numeric values in milliseconds, determines the pause between two slides.</li>
517 <li><code>pause</code> &ndash; Applicable to slideshow layouts. Takes values <code>0</code> (no pause) and <code>1</code> (pause), determines if the slideshow should pause upon hovering on it.</li>
518 <li><code>controls</code> &ndash; Applicable to slideshow layouts. Takes values <code>show</code> and <code>hide</code>, and shows "Previous" and "Next" buttons on the slideshow.</li>
519 <li><code>strip-style</code> &ndash; Applicable to slideshow layouts. Takes values <code>thumbs</code> and <code>button</code>. If set, and if the <code>layout</code> / <code>style</code> parameter is set to <code>strip-below</code>, <code>strip-above</code>, <code>strip-right</code>, it shows buttons <strong>below</strong> the slideshow.</li>
520 <li><code>popup</code> &ndash; Takes values <code>show</code> and <code>hide</code>. If set, and if a level 2 thumbnail (i.e. an Album, Photoset or Gallery thumbnail) is being displayed, this setting overrides <em>Photonic &rarr; Settings &rarr; Generic Options &rarr; Overlaid Popup Panel &rarr; Enable Interim Popup for Album Thumbnails</em>.</li>
521 </ol>
522 <?php
523 }
524
525 function helper_shortcode() {
526 ?>
527 <h2 class="photonic-section">The Helper Shortcode</h2>
528 <p>
529 There is a second utility shortcode present in the plugin, which displays the output of the helpers but <em>in the front-end</em>.
530 </p>
531 <ol>
532 <li><strong>Short-code: </strong><code>photonic_helper</code></li>
533 <li>
534 <strong>Attributes: </strong> This primary attribute is <code>type</code>. Depending on the value of <code>type</code> other attributes can be passed:
535 <ol>
536 <li>
537 <code>type='flickr'</code> - Additional attributes:
538 <ol>
539 <li><code>user='xxx'</code> - Passing the user name (i.e. from https://flickr.com/photos/xxx) will get the user_id for use in the Flickr shortcode</li>
540 <li><code>group='yyy'</code> - Passing the group name will get the group_id for use in the Flickr shortcode</li>
541 </ol>
542 </li>
543 <li>
544 <code>type='google'</code> - This takes no additional parameters, and prints out the user's Google Photos albums in tabular form
545 </li>
546 </ol>
547 </li>
548 </ol>
549
550 <?php
551 }
552
553 function really_technical() {
554 ?>
555 <h2 class="photonic-section">The Really Technical Stuff</h2>
556 <p>
557 You are running PHP with the following details:
558 </p>
559 <table class="form-table photonic-form-table">
560 <tr>
561 <th>PHP Version</th>
562 <td><?php echo phpversion(); ?></td>
563 </tr>
564 <tr>
565 <th>Loaded Extensions</th>
566 <td><?php echo implode(', ', get_loaded_extensions()); ?></td>
567 </tr>
568 </table>
569 <?php
570 }
571 }
572