Envira Gallery Documentation

Documentation, Reference Materials and Tutorials for Envira Gallery

Printing Addon

Would you like to allow your users to print your gallery images? You can with the Envira Gallery Printing Addon. This doc shows you how to display a print icon over each gallery and lightbox image, allowing visitors to easily print your images.


Requirements

Installation

Please follow our instructions on how to install and activate addons.

In this instance, you’ll be activating the Envira Printing Addon.

Setup

To begin, choose a gallery to edit or create a new gallery. For the purpose of this tutorial, we are going to edit a gallery already created.

Next, navigate to the Printing tab where you’ll be able to configure the following options:

  • GALLERY OPTIONS:
    • Display Print Button? – Enables or disables displaying a print button on each image in the gallery view.
    • Print Button Position – Where to display the print button over the image. Available options are Top Left, Top Right, Bottom Left, Bottom Right.
  • LIGHTBOX OPTIONS:
    • Display Print Button? – Enables or disables displaying a print button on each image in the Lightbox view.
    • Print Button Position – Where to display the print button over the image. Available options are Top Left, Top Right, Bottom Left, Bottom Right.

You can configure the Printing options for your gallery in the Printing tab.

If you’ve configured the Print button to appear in the gallery view, hover over a gallery image to see it appear:

Once enabled, the print button will appear in the gallery view when hovering over an image.

If you’ve enabled the Print button to appear in the Lightbox view you’ll see it show in the position configured when opening the image in Lightbox view:

Enabling the print button for lightbox will show the print button on your lightbox image.

Selecting the Print Button will open a print dialog where you can select the printer to use and any other print settings before confirming.


Album Options

In addition to using the Printing Addon with galleries, you can also use this for Envira Albums as well. When the Albums Addon is activated, you can also configure the following options in the album edit screen’s Printing tab:

  • LIGHTBOX OPTIONS:
    • Display Print Button? – Enables or disables displaying a print button on each image in the Lightbox view.
    • Print Button Position – Where to display the print button over the image. Available options are Top Left, Top Right, Bottom Left, Bottom Right.

You can enable printing options for your Albums within the Printing tab when editing your album.


That’s it! You’ve just made it possible for your visitors to print directly from your Envira Galleries or Albums using the Printing Addon. Want to allow visitors to download images as well? Check out our Downloads Addon.

FAQs

Q: I don’t have the option of changing my Lightbox icon position, why?

A: The Lightbox themes Base (Dark) or Base (Light) will always place the printing icon in the top right corner of the Lightbox. If you wish to change the position, navigate to the Lightbox tab and you can select a different Lightbox Theme.


Configuration Options

This table describes the available configuration options for your Envira Galleries and Albums when using this Addon.

The Programmatic Name and Programmatic Values columns are used when configuring the Dynamic Addon’s shortcode or template tag, or when overriding the default settings for creating a new Gallery or Album.

Printing Tab

You will see the following new options in the Printing tab for your Galleries.

Config Item Description Options Programmatic Name Programmatic Values
GALLERY OPTIONS
Display Print Button? Enables or disables displaying a print button on each image in the gallery view Enabled/Disabled print 0,1
Print Button Position Where to display the print button over the image. Top Left, Top Right, Bottom Left, Bottom Right print_position top-left,top-right,bottom-left,bottom-right
LIGHTBOX OPTIONS
Display Print Button? Enables or disables displaying aprint button on each image in the lightbox view Enabled/Disabled print_lightbox 0,1
Print Button Position Where to display theprint button over the image. Top Left, Top Right, Bottom Left, Bottom Right print_lightbox_position top-left,top-right,bottom-left,bottom-right

You will see the following new options in the Printing tab for Albums (available for the Albums Addon, and specify the lightbox printing options for each Gallery loaded in the Lightbox view from an Album).

Config Item Description Options Programmatic Name Programmatic Values
LIGHTBOX OPTIONS
Display Print Button? Enables or disables displaying aprint button on each image in the lightbox view Enabled/Disabled print_lightbox 0,1
Print Button Position Where to display theprint button over the image. Top Left, Top Right, Bottom Left, Bottom Right print_lightbox_position top-left,top-right,bottom-left,bottom-right

Changelog

1.3.0 (04-10-2018)

  • Added: Fancybox3 support.
  • Fix: Minor bug fixes.

1.1.0 (10-18-2017)

  • Fix: Various minor bugs

1.0.4 (02-15-2017)

  • Fix: Various minor bugs

1.0.3 (02-01-2017)

  • Fix: Various minor bugs

1.0.2.1 (2016-11-03)

  • Fix: Various minor bugs

1.0.2 (2016-09-16)

  • Updated: Added esc_url to increase security for printing popup.

1.0.1 (2016-09-01)

  • Initial release of the addon.