User Tools

Site Tools


publish_albums_in_backlight_2

Publish Albums in Backlight 2

There are two methods of creating albums in Backlight 2. You may create albums and upload images from within Backlight's admin, or you can use the optional Publish Services plugin for Lightroom CC Classic.

This differs from previous versions of Backlight, so it bears repeating:


In Backlight 2, the Publish Services plugin for Lightroom is OPTIONAL.


For photographers using Lightroom, Publish Services is the easiest way to manage your albums in Backlight, from within your existing workflow.

For photographers NOT using Lightroom, you may create albums and album sets, and upload images within Backlight's admin.


Basic Concepts and Terminology

In getting started, let's first understand the terms Album, Album Set and Top-level Gallery as we'll be using them in Backlight.

Albums contain images. Album Sets contain albums. Albums and album sets are created as children, within a Top-level Gallery parent. The Top-level Gallery maps to a folder on disk, within which published albums and album sets are contained, and is the shallowest level at which albums and album sets may be created.

Hierarchically, these appear as:

  • Top-level Gallery
    • Album
    • Album Set
      • Album
      • Album Set
        • Album

Albums may appear as direct children within a Top-level Gallery, or as children to an Album Set.

Album Sets may appear as direct children within a Top-level Gallery, or as children to higher order Album Sets.

The Top-level Gallery is always the highest order parent.

By default, Backlight prepares one Top-level Gallery, named “Galleries”. At least one top-level gallery is required, but you may create additional top-level galleries if needed.

With our new understanding of albums, album sets, and top-level galleries, let's get into publishing!



Publishing via Backlight

Let's first explore how to create images directly within Backlight 2.

If using Lightroom, you might prefer to use the Publish Services plugin; then skip to the next section.

By default, Backlight is ready to create the “Galleries” top-level gallery. However, it does not exist yet, and that's why visiting the Galleries page of our website yields an error.

Following a fresh install of Backlight, we need to kickstart the creation of our first top-level gallery. Click the large “BACKLIGHT 2” title to access the main dashboard; under Special Links, click “Update Album Files” to create the necessary files on disk, and your Galleries page can now be visited. It's empty.

In Backlight's admin menu, click Publisher to see a list of existing top-level galleries.

For Galleries, click “Edit” to update or remove text appearing on the page, or to change other options.

To create albums, click the title, “Galleries”. This will provide you a high altitude view of the gallery's content, and will see the buttons Create Album Set and Create Album.

Click Create Album, then open the Base Settings to set an album title. You may explore the other options on your own; for now, click “Save” at the bottom.

You will be given a high altitude view of the album, similar to our previous view of the top-level gallery. Click the Add Photos button to upload your first images, and an album is born!

Creating album sets is a similar process, and having created an album, you should be able to intuit the necessary steps.

Installing the Publisher in Lightroom CC Classic

To install the Publish Services plugin for Lightroom CC Classic, we first have to download it. In Backlight's admin menu, go to AdminBacklight Modules. At the top of the page, click the link “Download Lightroom Publisher Plugin”.

  1. Unzip the downloaded file, then locate TTG-Publisher.lrplugin within its contents.
  2. Place TTG-Publisher.lrplugin anywhere on your system. It's location should be:
    1. … easily accessible, to better facilitate plugin installation and updating.
    2. … someplace the plugin can reside long-term.
  3. Launch Lightroom.
  4. In the File menu, select “Plug-in Manager…”
  5. Within the Lightroom Plug-in Manager window, click “Add” in the lefthand column.
  6. Navigate to the TTG-Publisher.lrplugin file, click “Add Plug-in”.
  7. Click “Done”.

From this point, you should be in Lightroom's Library module. In the lefthand panel, location the Publish Services section. If absent, right-click the lefthand panel and ensure that “Publish Services” is checked.

Within the Publish Services panel, you should see an entry for TTG Publisher. Double-click the entry, or right-click and select “Edit Settings…”

  1. The API URL will be http://yourdomain.com/backlight/publisher.
  2. The API Key, you will have set on the Quick Settings page when installing Backlight.
  3. Click “Save”.

Publishing via Lightroom

It's time to publish your first album of images!

In Lightroom's Publish Services panel, right-click the TTG Publisher and select “Create Album…”

  1. Name your album. This name is how the album will be listed in the Publish Services panel.
  2. Provide an Album Title, Album Description and Slug.
    1. If blank, the Name will be used for both Album Title and Slug.
    2. The Slug will be used in the album URL, i.e. yourdomain.com/galleries/slug.
    3. Album Description is optional.
  3. For now, keep the defaults for all other settings. You can return here later to make any desired changes.
  4. Click “Create”.

You now have an empty album. From your Library's folders or collections, drag any images you want to put online onto the new album in Publish Services. When ready, select the album and click the “Publish” button. Lightroom will export the images and send them to Backlight.

You may create as many albums as you like.

To view your newly published album, right-click the album under Publish Services; select “Go to Published Album”.

Next Step

At this point, you know everything you need to know about adding or editing content in Backlight 2, and you're probably eager to start designing. Next step, dig into the Templates menu.

publish_albums_in_backlight_2.txt · Last modified: 2018/09/07 22:32 by matthew