Photobooth-MICROSITE-Plugin for WordPress

Documentation by Photobooth-Deluxe
Created 06/2019

What exactly does the Photobooth-Microsite-plugin for WordPress do?

Short and sweet:

It enables a GDPR-compliant microsite, in which each guest can only access the images/gifs/videos, for which he knows the so-called PhotoPIN and the operator and client can viel all images via an EventPIN.

The PhotoPIN is usually a combination of 3 letters and 5 numbers (e.g. ABC12345 or WZQ22521).

Every jpg, gif, png or mp4 file gets this PhotoPIN as part of the filename.

In Breeze Booth for Windows (fka DSLR Remote Pro), this is done automatically via the {uid} = uniqueID token.

Example:

The file name is date + time + uid: 20181105_113500_WZQ22521.jpg.

If the guest enters the search window of the microsite WZQ22521 then he will find exactly this image.

If the file name is extended by an EventPIN, all pictures/gifs/videos of an event can be viewed, shared and downloaded at the same time.

Filenames:

Date_Time_EventPIN_PhotoPIN.jpg

20181105_113500_MUT05112_WZQ22521.jpg
20181105_121131_MUT05112_UZP65482.jpg
20181105_131116_MUT05112_BVM62214.jpg

MUT05112 is the EventPIN for all three pictures.
WZQ22521, UZP65482 and BVM62214 are the PhotoPINs for these three separate photos.

This is what it looks like in REAL Life:

https://photobooth-deluxe.de/bilder-ausgabe/
The EventPIN for the overall microsite access is: ABC54321

PIN input field

Results page

Documentation FOR the plugin

Contents

1. Installation of the plugins in WordPress
1.1. Download, Upload and activate the plugin
1.2. Enter the serial number / verify plugin

2. Configuration of the Photobooth plugin
2.1. General settings
2.1.1. Media folder
2.1.2. Regular expressions
2.1.3. Wildcard in search mask
2.1.4.Heading for social links
2.1.5. Subject on social links
2.1.6. What should be shared?
2.1.7. Pictures per page
2.1.8. Introtext form
2.1.9. Note text if the PIN is entered incorrectly
2.1.10. IP-Blocker
2.1.11. Note text if IP was temporarily blocked
2.2. Configuration for different events
2.3. EventPIN
2.4. Editorial key

3. Integrate the search mask in the website
3.1. Use of the shortode
3.2. Customize the layout

4. Statistical evaluation of events

5. Settings in th DSLR RemotePro/NK Remote

6. Logfile

7. Automatic upload with FTP client

1. Installation of the plugin in WordPress

1.1. Download, Upload and activate the plugin

Download the Plugin on top of the page
In WordPress-Backend, go to „Plugins“ -> „Add new“
Click on the „Add new“ button and then „Upload Plugin“
Click on „Select file“, choose the „photobooth-gallery.latest.zip“ file in your computer’s download folder and click on „Install now“
The plugin will now be uploaded and installed automatically
To activate the plugin, click on “Activate this Plugin”

1.2. Trial mode vs. serial number

After the first installation on your domain, the plugin will run for 15 days without any restriction.

If you decide to buy a subscribtion you will receive:

a licenseID
a purchaseID

from Digistore24.

In WordPress, navigate to Photobooth Gallery -> Global Settings
Enter the licenseID and the purchase-ID from your order email in the corresponding fields „License Key“ and „Payment Id“. Click on „Update“ to save and validate.

2. Configuration of the Photobooth plugin

2.1 Global settings

The following settings can be found under „Photobooth Gallery“ –> „Global Settings“. To save the entries, click „Update“ on the right.

2.1.1. Send error messages to Dev Team

If this option is activated, we will receive an email from your WordPress in case of an error. In addition to the error message, this email contains the system information from above and the current log file. It will help us to improve the entire system.

2.1.2. License-ID

By subscribing to the plugin you will receive a licenseID and a purchaseID for the selected duration. Enter the licenseID and the order-ID from your order email in the corresponding fields „License Key“ and „Payment ID“.

2.1.3. Logfile Prefix

The plugin logs the usage of the microsite. In the Logfile Prefix field, a prefix for the physical logfilename must be specified. This prevents unauthorized access to the log file.

2.1.4. Logfile location

This area displays the current size and status of the log file. You can call or save the current log file via the link next to it.

2.1.5. Schedule Upload Folder Scan

Yes means that the import job automatically searches for new images in the upload folder every 5/15/30 minutes (depending on the selected interval) and imports them into WordPress Media library.

2.1.6. Enable Webhook Scan Initiation

If this function is activated, a URL will appear which can be used to upload the scan manually (regardless of the selected scan interval).

2.1.7. Removal Timeout for Social Media shares

Minimum age of the most recent access to a shared file before it can be deleted from the library.

Default: 30 days

This feature prevents share links that are still actively being used from becoming invalid. In the „default setting“, a shared image from the library can only be deleted if no one clicked on the shared link for 30 days.

2.1.8. Enable Auto Cleanup

The Auto Clean Up feature allows you to automatically delete images from the media library after a certain period of time, and thus also from the online microsite. This way you do not have to worry about the online storage use and manual cleanup anymore.

2.1.9. Track Extended GEO-Data

If this function is activated, an API key must be entered by www.ipstack.com. This can be used for up to 10,000 requests per month free of charge.

The information is required for the GDPR-compliant usage statistics of the microsite. Instead of the IP address, the geographical region of this IP address is stored. From this information, no conclusions can be drawn to individual users. Nevertheless, a geographical distribution display of microsite interactions is possible.

2.1.10. Allowed multimedia file types

This determines which file types are allowed for import.
Available are JPG, GIF, PNG, MP4 and XML.
XML means the XML files from Breeze Booth for Windows and Breeze Booth for IPAD that are created with each sequence. This information is used to fill some parts in the event statistic page.

2.1.11. Delete media files after import

If enabled, the uploaded images and video data will be deleted from the import folder after successful import into the WordPress media library.

This is a useful option to save space on your webspace and speed up imports.

2.1.12. ATTENTION!! „Cleanup media library“

This is the opposite of data import. All, even the shared pictures, will be deleted from the WordPress media library. The original images are copied back to the import folder. This feature removes ALL imported images / gif / videos from the library. This feature allows a re-import with same filenames.

This function should be used with the utmost care.

2.1.13. Media File Transfer

Click on „Scan Now“ to activate the import process. This is the same action that is performed on the regular Upload Folder Scan and the Web hook URL.

2.2. Multi-event configuration

Note: In general, only a single configuration needs to be created for all events. It is NOT necessary to create a new configuration for each event (but it is possible).

Do you need another configuration for an event that has nothing to do with your normal setup? No problem.

Click Photobooth Gallery -> Configurations.

A new page will open where a default configuration has been created after the plugin installation.

Click on Settings -> Add New to add another configuration.

2.2.1. Photobooth Media folder

The plugin automatically detects the server path of your WordPress installation.

In the text line, enter only the desired sub folder in which your images you import are to be stored.

If the option „Create missing Photobooth Media Folder“ is set to „Yes“, then this folder is automatically created.

Ideally, an FTP user is now created for this folder. This is needed to transfer the data from the Photobooth to the microsite.

2.2.2. Regular expression

Each image must be loaded into the microsite with a unique code (=PhotoPIN).

Regular expressions allow you to set your personal code order. You have the choice between letters [A-Z] and numbers [0-9].

The Breeze Token {uid} = unique ID consists of 3 letters followed by 5 numbers. The regular expression looks like this: [A-Z] [A-Z] [A-Z] [0-9] [0-9] [0-9] [0-9] [0-9].

The Breeze Token {uid2} with 5 letters and 3 numbers looks like this [A-Z] [A-Z] [A-Z] [A-Z] [A-Z] [0-9] [0-9] [0-9].
The number of digits specified in the regular expression determines the autosubmit of the input field.
Note: Only uppercase letters may be used. The input field automatically converts lowercase letters to uppercase letters.

2.2.3. Admin code

You can directly moderate the microsite by deleting media files (pictures/gifs/videos) directly on the front end of the website.
To do this, a personal code must be entered in the back end under the Admin Code section.

Call the microsite of the event via the EventPIN or a PhotoPIN and add the following addition to the URL: ?PBGADMIN=AdminCode

Again, of course, the personal „AdminCode“ must be used.

If the URL is opened, you will get an overview of all files that fit the PhotoPIN.

In addition, there is a small checkbox below each image. If you activate it, the selection will be permanently deleted by confirming the new option in the front end „Delete Selected Images“ at the bottom of the page.

Of course, it is possible to select and delete multiple media files at the same time.

If you set Display real file names for admin to yes, you are able to see the original filenames in the front end.

2.2.4. Placeholder for the code input field

Here you can enter a text that will be displayed on your website in the image search screen. We recommend using something like „Please enter the PhotoPIN“.

2.2.5. Enable preview Gallery

This function allows you to monitor multiple events at the same time, as all images read in via this gallery configuration will be displayed independently of the PhotoPIN.

2.2.6. Autoscroll on click

The browser scrolls back to the large image after clicking on a thumbnail image. Very Useful when using an EventPIN in the mobile view.

2.2.7. Allow direct code entry

This allows you to enter the EventPin or PhotoPin as a URL parameter. The code must be entered as follows: www.domain.com/my-micrositepage/pg-code/{Event/PhotoPin}

This function is necessary when the image is to be called directly via a dynamic QR code.

2.2.8. Enable Social Media Sharing

If the function is activated, five new input blocks appear in the configuration.

2.2.8.1. Headline for Social Media Buttons

Headline over the social media links

2.2.8.2. Subject for Sharing with Social Media

Subject / Title when sharing an image

2.2.8.3. Description for Sharing with Social Media

Body / text when sharing an image/gif/video

2.2.8.4. What should be shared

Current Image/Video wll create a sharing link that opens the image/gif/video directly in the browser.

Complete Gallery of the code will open your website and submit the shared photoPIN.

In order to share the content, create a new page, and insert the shortcode you get with the Copy shortcode button.
Once you have inserted the shortcode, select the appropriate page with the drop down menu at Choose Social Media View Page.

2.2.8.5. Social media buttons

The following interactions are can be made available to guests:

download
Download Gallery (Download all images as ZIP file.) This feature is not available on all systems and therefore not a guaranteed feature.
e-mail
Facebook
Facebook Messenger (mobile only)
Linked-In
Pinterest
Twitter
Whatsapp

The order within the Social Media Buttons is the order they are presented on the website.

2.2.9. iOS Video Share Sender E-Mail Address

Due to the limitations of downloading MP4 videos on iOS devices (Iphone, iPad), these video files are sent to the user via email.

Please enter the e-mail address from which you would like to send the e-mails.

To prevent the email from being processed as junk mail, make sure to use an e-mail address with the domain of the current website.

2.2.10.Introtext for the form

This box can be used to place a headline, text or pictures directly above the form by entering the PhotoPIN.

2.2.11. Images per page / Pagination limits / Show first / last page Buttons

With images per page you can define how many images/gifs/videos are presented on one page.
Pagination Limits is for the number of directly acessible pages. If you set it to 6 and you are on page 10, you will see direct links to page 7,8,9 and 11,12,13.
When set to yes, Show first / last page Buttons will always display a link to the very first and the last page.

2.2.12. Introduction text for the form

This is a welcome or explain text that will be displayed above the search input field.

2.2.13. Error message for wrong code entry

The plugin automatically checks if the entered PIN is valid and the library has a file with this information (pin = part of the filename).

If the PIN is entered incorrectly or there is no picture with this PIN, the following text will appear: „Attention! The code you entered does not seem to be correct or the image is not online yet.“

2.2.14. Enable IP blocking

With the IP-Blocker the plugin offers the possibility to block an IP address after too many failed attempts. Here you can specify how many failed attempts are allowed within a certain period of time.

A setting of the period in seconds as well as number of unsuccessful attempts within this time can be entered here.

In the field „Error message if an User (IP-Block) was temporarily blocked“, a message can be issued to the user.

3. Include the search mask in a WordPress page

During the setup of the microsite plugin, it will also create a couple of pages for you.

photobooth-galerie-test-seite
the-photobooth-gallery-statistics-page

You can directly access these pages to check if installation was successful. On the Photobooth-galerie-test-seite, you can use the PhotoPIN ABC12345.

3.1. Using shortcodes to create your own landingpages

3.1.1. Shortcode for microsite search field

Click on Photobooth Gallery -> Configurations. On the right side, below Actions, you have a green Copy Shortcode button. Once you click it, the correct shortcode for the microsite search page is copied. You can paste this shortcode on your prefered wordpress page.

3.1.2. Shortcode for microsite Share page

To share the microsite with the sharing features, you need a landing page. To copy the corresponding shortcode, click on Photobooth Gallery -> Configurations -> Edit (below your setting). On top of the page at Nr. 4, you will find a green Copy Shortcode button. Once you click it, the correct shortcode for the microsite share page is copied. You can paste this shortcode on your preferred wordpress page that should be used for shared images/gifs/videos.

3.1.3 Shortcode for Unprotected Preview gallery

If Enable Preview Gallery is set to Yes, there is a green Copy Shortcode button available. Once you click it, the correct shortcode for the unprotected microsite preview page is copied. You can paste this shortcode on your prefered wordpress page where all images for this configuration (this importfolder) are displayed.

3.2. Customize the layout

Basically, it is possible to edit all the elements that you get displayed in the frontend. All you have to do is enter customized lines of code in the appropriate CSS area.

Usually you can find this either under:
Appearance -> Customize -> Custom CSS

It may also happen, that the theme you use has its own area for this.

In addition, there are also free plugins that allow a so-called custom css area.

You can also have design adjustments made by the certified agency: www.codevisio.io

Please be aware, that there is no support for custom design changes.

4. Statistical evaluation of events

With the installation of the microsite plugin a page with the name photobooth-gallery-statistic-page is automatically created.

When calling, you can pass a parameter /pg-code/CODE/

Instead of CODE, you enter the EventPIN, e.g. ABC12345.
The statistics then only consider data that belongs to this event.

The following URL shows statistics with sample values:

https://demo.photobooth-deluxe.de/photobooth-galerie-statistik-seite/

ATTENTION: This page is automatically overwritten with each update to insert new values.
Own modifications are lost.

Solution: Copy the page and manually retrain changes in new versions

Data Source

1. The Breeze Booth for Windows and iPad XML files ([XML]) written with each sequence

2. Social Media interactions ([Social Media]) via the microsite

3. The interactions on the Gallery (User Logfile) ([Gallery])

The design of the statistic pages is done via Elementor widgets

1. Number widget

2. Progress bar widget

3. Image widget

Combinations in the widgets

View Type (Always works in conjunction with a data source)

Shared, Viewed: Used for Social Media interactions (origin 2) to differentiate Views (who viewed my shared image) and Shares (who shared an image)

Unique: Here all unique views are recorded, i.e. multiple views from origin 2 are counted only once

(Unique Downloads: how many different pictures have been downloaded)

Average: Uses the event runtime (See photobooth-statistics-event-duration) to modify data from origin 3.
Works only with XML data.

Image widget

With {size} the calculated number can be displayed (most frequent photo) (in the caption)

Shortcodes

Date shortcodes

1. photobooth-statistics-sharing-from „date on which a picture / video was shared / viewed for the first time“

2. photobooth-statistics-sharing-to „Date the last time a picture / video was shared / watched“

3. photobooth-statistics-event-from „Start date of the event based on the date of the first XML file of the event“

4. photobooth-statistics-event-to „End date of the event based on the date of the last XML file of the event“

The following parameters can be used:

– date-format: Formats the date according to
http://php.net/manual/de/function.date.php

– the-code: If a fixed code is desired, otherwise the / pg-code / parameter is used, or no code at all

Event shortcodes

1. photobooth-statistics-event-duration „Calculates the time between start and end date of the event in seconds and returns a formatted text, or the time in seconds (see parameters)“

The following parameters can be used:

– the-code: If a fixed code is desired, otherwise the / pg-code / parameter is used, or no code at all

– format : If you want the output to be reformatted in days, hours, and minutes (default: true). Otherwise, seconds will be returned

2. photobooth-statistics-event-profiles

„Displays the profiles used and their frequency for the event in a small table“

The following parameters can be used:

– class: The CSS class of the table

– the-code: If a fixed code is desired, otherwise the / pg-code / parameter is used, or no code at all

5. Settings in Breeze Booth for Windows / Ipad

Step 1: Define the filename of the single images in Breeze

In menu File -> Preferences you can define the Filename Prefix with the value %d_%t_{eventName}_{uid}_

% d = Is converted by the Photobooth software to the current date in the form YYMMDD.

% t = Is converted by the Photobooth software into the current time HHMMSS.

{eventName} is the value of the event name field from the menu File => Photobooth event info …

(The three UPPERCASE capital letters and five numbers are the so-called EventPIN, with which all pictures of the event can be viewed).
As a rule, I define the EventPIN from the name and date of the event.

So if Martina and Tom get married May 16th, then my EvnetPIN is: MUT for Martina And Tom and 16052 are the first 5 digits of the date (16052019).

{uid} is replaced by the photobooth software at each sequence by a new random code which also consists of three letters and five numbers.

For a 4-collage, the names of the individual shots are as follows:

190516_201500_MUT16052_ABC12345_01.jpg
190516_201500_MUT16052_ABC12345_02.jpg
190516_201500_MUT16052_ABC12345_03.jpg
190516_201500_MUT16052_ABC12345_04.jpg

In Advanced Settings load the desired profile and then under Output Settings enter the file name %d_% t_ {eventName} _ {uid} in the Filename for JPEG copy of output field.

In the above example, the name of the final file in the prints folder is 190516_201500_MUT16052_ABC12345.jpg.

Note: If the time of the file in the print folder differs from the time of the individual pictures, then the time of the camera does not match the computer time.
The file in the print folder uses the camera time.
In the Breeze Booth for Windows menu Camera => Set date / time and owner string, the camera can be synchronized with the computer.

6. Logfile

For each action, an entry is written to logfiles. You can find them under Photobooth Gallery -> Global Settings and Phobooth Gallery -> Log Files

7. Automatiic Upload WITH UploaderPro

With version 3.1.1.6 the microsite was extended by an HTTP uploader to automaticaly upload all files to the microsite without the hassles and limitations of external ftp programs.

UploaderPro can be added to autostart and recognizes the folder where DSLRRemotePro saves the images and XML files. For all other photobooth-software, you can define watchfolders in Settings.ini file. Once a new file appears in the hotfolder, it will be moved to an upload queue and gets uploaded after a predefined delay. This way a lousy internetconnection or powerfailure will not result in lost uploads.

You can define what type of image should be uploaded:
Prints=true
Originals=true
XML=true
MP4=true
GIF=true
Processed=true

Download UploaderPro

In your wordpress backend within Photobooth-Gallery => Settings there is a section for the webhook uploader.
In this section you can set a random password for the uploader. Please use lowercase chars and numbers for the password.

On the right side you can selet the target configuration (if you have more than one). Once you updated the page, you can download the UploaderPro.zip file. Please be aware that this zip file is setp for the selected configuration only. Since each configuration has its own unique path in the filesystem, the uploader know where to save the uploaded files.

Click on Download UploaderPro to download a ZIP file. Extract this somewhere on your photobooth and run UploaderPro.exe.
Within the GUI or the Settings.ini you can set some parameters. The initial settings are setup to run well with Breeze DSLRRemotePro.

Configure UploaderPro Settings

Within the extracted folder there is a file called settings.ini.
You can edit the settings.ini file with a text editor like notepad and change the following values:

Silent=True UploaderPro starts as traybar icon
Silent=False UploaderPro starts with visible GUI

Prints=true/false              ; Uploads collage files from prints subfolder
Originals=true/false         ; Uploads original files from camera
XML=true/false                ; XML files that come with each sequence. Important for statistics.
MP4=true/false                ; MP4 Videos from prints or gif subfolder
GIF=true/false                  ; GIFs from prints or gif subfolder
Processed=true/false     ; Jpg-fiels from processed subfolder

For each upload type you can set up a delay in seconds. This is important if you modify your files with some external programms like Breeze2GSW.

Prints_Delay=3
Originals_Delay=30
XML_Delay=3
MP4_Delay=3
GIF_Delay=3
Processed_Delay=3

If you want to upload files from other sources (e.g. DSLRBooth, Breeze HotfolderPrint..) you can define an unlimited amount of watchfolders.
Each watchfolder requires the following block in the settings.ini.

[WatchFolder_name1]
Active=true/false
Localpath=WatchFolder1
Filter= *.*
Subdirs=true/false
Delay=3
Excludepath=optional
Includepath=optional

[WatchFolder_name1] ; Some unique name without spaces or special chars.

Active=true/false                   ; Only when true, the folder is watched.
Localpath=c:\yourpath         ; Local path of the watched folder.
Filter= *.*                                 ; Definition of filetype that should be watched. *.* is for all files. *.jpg is for jpg files only.
Subdirs=true                           ; If true, subfolders are watched as well.
Delay=3                                    ; delay in seconds before file is added to upload queue
Excludepath=prints|proc       ; Folder that contain prints or proc will be ignored. Seperate multiple foldernames with |.
Includepath=prints|proc        ; Folders that contain prints or proc will be uploaded, the rest is ignored. Seperate multiple foldernames with |.

Please make sure that you use either includepath OR excludepath.