WordPress not loaded!';
exit;
}
require_once('Admin_Page.php');
class Getting_Started extends Admin_Page {
private static $instance;
private function __construct() {
// Empty
}
static function get_instance() {
if (self::$instance == null) {
self::$instance = new Getting_Started();
}
return self::$instance;
}
function render_content() {
$this->capabilities();
$this->build_gallery();
$this->layouts();
$this->lightbox();
$this->secret_menu();
$this->helper_shortcode();
$this->really_technical();
}
function capabilities() {
?>
Capabilities and Documentation
Photonic can show you photos and galleries not just from standard WordPress, but also from several third-party photo-hosting providers
such as Flickr, SmugMug, Google Photos etc. The following table tells you what you need for each provider, and provides you with
documentation links for how to show something using Photonic.
Showing a Gallery
While using the Classic Editor a gallery is displayed using the [gallery] shortcode. If the Gutenberg Block Editor is
used a gallery is displayed using a Gutenberg Block instead. Given the plethora of options and configurations offered in Photonic,
things have been made easier by virtue of a shortcode insertion UI. To use it:
-
Getting Started
If you are using the "Classic Editor" click on the "Add Media" button or the "Add / Edit Photonic Gallery" button:
Correspondingly if you are using "Gutenberg" use the Photonic Gallery block:
-
Building a Gallery
-
Via "Add Media"
-
Click on the "Photonic" tab:
-
Pick your source:
-
Fill out the attributes for the gallery:
-
Via "Add / Edit Photonic Gallery", or the "Photonic Gallery" block
-
You are presented with a screen to pick the source for your gallery:
-
You will be shown a contextual set of options based on your choices:
-
Depending on which gallery you inserted you will be shown a placeholder of this sort:
-
Clicking on the placeholder will let you edit the gallery you inserted.
Note that if you are using the Visual Editor, you may encounter TinyMCE conflicts with other plugins. In case of such a conflict
please report a bug, and disable the Visual Editor integration from
Photonic → Settings → Generic Options → Generic Settings → Disable shortcode editing in Visual Editor. The plugin will
continue working normally – the only difference is that you will have to do shortcode edits by hand via the Text Editor rather than via a UI
in the Visual Editor.
Gallery Layouts
Photonic supports the following types of layouts:
- Square thumbnails
- Circular thumbnails
- Slideshow
- Random Justified Grid
- Masonry
- Mosaic
Which Lightbox?
Photonic includes several lightboxes and supports some others that it cannot include due to licensing reasons. Each lightbox has
its own strengths — some are lightweight, some are full-featured and some are very elegant looking. You can pick one based on the
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,
but for Photonic those capabilities have been integrated into the scripts via other approaches.
The Secret Menu
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
interactive shortcode builder / Photonic block for Gutenberg, but will not show up in the traditional shortcode interface:
title_position – Takes values none, regular, tooltip, below, hover-slideup-show and slideup-stick. It overrides the title positioning that you have set for that particular provider through your options.headers – Takes a comma-separated list containing none or more of thumbnail, title, and counter.
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.
So, setting headers='title,counter' 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.fx – Applicable to slideshow layouts. Takes values fade and slide to provide the transitioning effect between slides.speed – Applicable to slideshow layouts. Takes numeric values in milliseconds, determines the speed of transitioning of slides.timeout – Applicable to slideshow layouts. Takes numeric values in milliseconds, determines the pause between two slides.pause – Applicable to slideshow layouts. Takes values 0 (no pause) and 1 (pause), determines if the slideshow should pause upon hovering on it.controls – Applicable to slideshow layouts. Takes values show and hide, and shows "Previous" and "Next" buttons on the slideshow.strip-style – Applicable to slideshow layouts. Takes values thumbs and button. If set, and if the layout / style parameter is set to strip-below, strip-above, strip-right, it shows buttons below the slideshow.popup – Takes values show and hide. If set, and if a level 2 thumbnail (i.e. an Album, Photoset or Gallery thumbnail) is being displayed, this setting overrides Photonic → Settings → Generic Options → Overlaid Popup Panel → Enable Interim Popup for Album Thumbnails.
The Helper Shortcode
There is a second utility shortcode present in the plugin, which displays the output of the helpers but in the front-end.
- Short-code:
photonic_helper
-
Attributes: This primary attribute is
type. Depending on the value of type other attributes can be passed:
-
type='flickr' - Additional attributes:
user='xxx' - Passing the user name (i.e. from https://flickr.com/photos/xxx) will get the user_id for use in the Flickr shortcodegroup='yyy' - Passing the group name will get the group_id for use in the Flickr shortcode
-
type='google' - This takes no additional parameters, and prints out the user's Google Photos albums in tabular form
The Really Technical Stuff
You are running PHP with the following details: