User Tools

Site Tools


ce4_publisher_installation

CE4 Publisher Installation & Setup

CE4 Publisher is comprised of two parts, an online component and a Lightroom plugin. In the downloaded zip file, these are /publisher/ and CE4-Publisher.lrplugin, respectively.

CE4 Publisher also requires installation of TTG-BE, also included in your download. From a high-altitude view, setup is a three-part process:

  1. Install TTG-BE.
  2. Install the CE4 Publisher online component.
  3. Install the CE4 Publisher plugin in Lightroom.

There are some additional, options steps in between, such as Search setup. We'll cover these as we come to them.


Install TTG-BE

To begin, setup TTG BE.

Afterward, return to this page to continue CE4 Publisher setup.


Install the CE4 Publisher Online Component

Copy the /publisher/ folder from the downloaded CE4 zip file (e.g. CE4-Publisher-213.zip or newer) into the /ttg-be/ folder online:

/ttg-be/publisher

Next, you should create a template using CE4 Gallery (or CE4 Client Response Gallery). Select a handful of images in your filmstrip to help with design visualization, configure the gallery to your liking, then export. The exported template will not need the selected images, however, so feel free to de-select all images from your filmstrip before export to minimize the template's footprint; the template will upload faster, and take up less space on your server.

If you plan to use CE4 Publisher's Search features (below), then add a “Search” item to your menu when configuring your template.

Upload the exported template into:

/ttg-be/templates/gallery

For example, you might have this, where “my-template” below represents whatever name you've used when saving your template:

/ttg-be/templates/gallery/my-template

The templates found in ttg-be/templates/gallery can function for various purposes: as Publisher album templates, as the Cart template, and as the template for the Search page. You should always have at least one template installed.

Note: a template used for Search requires The Block to be displayed. Make sure that the 'Display on page' option is checked within the Content/Description section of the Gallery web module.

Login to the TTG-BE admin, then navigate to the Publisher admin via the Dashboard menu.

Under the Settings menu, select Publisher Settings. Here you may configure various aspects of CE4 Publisher, detailed below.


Search Setup

Search is optional. If you don't want to use it, then you may skip this step.

Within Publisher Settings, choose to Edit Settings.

For “Search Template”, choose the gallery template you uploaded previously. The template will be used to display search results.

Using your FTP client, you will need to move the /search folder into place. Locate the folder at /ttg-be/publisher/search, and move it to the top level of your site (i.e. public_html/search), such that it becomes accessible at http://yourdomain.com/search/.

When configuring CE4 Pages, CE4 Gallery, etc., be sure to add a “Search” item to your site menu.

Install the CE4 Publisher Lightroom Plugin

Copy the CE4-Publisher.lrplugin from the downloaded zip file to a location on your computer for safekeeping. This should be someplace that the plugin may remain long-term, as LR will read from this location after installation.

Launch Lightroom. From the File menu, choose Plug-in Manager.

The left-hand side of the Plug-in Manager will display a list of installed plugins. Click Add, navigate to the location of the CE4-Publisher.lrplugin on your drive, and click Add Plug-in. TTG CE4 Publisher will appear in the list of installed plugins.

Click Done. TTG CE4 Publisher should now be installed, and can be seen in the Library's Publish Services control pane:


Setup a Publisher Instance

With CE4 Publisher installed, you now need to setup an “instance” of the publisher for each location to which you wish to publish galleries, i.e. for each target location. A target location may be any of the following:

  • If using CE4 Pages, the target folder will typically be the /galleries folder.
  • If using CE4 Auto Index, you may use any auto index folder as your target.
  • If using neither CE4 Pages nor CE4 Auto Index, you may create an empty folder to use as target.

A single instance of CE4 Publisher can publish only to a single target. You may create additional instances to publish to additional targets. More on this later.

In Publish Services (pictured above), double-click the TTG CE4 Publisher item. This will launch the Lightroom Publishing Manager:

The follow items all need to be set:

API URL
This is the URL to your publisher as uploaded on your server. For example, if you uploaded the publisher to the top level of yourdomain.com, then the API URL would look like http://yourdomain.com/ttg-be/publisher/. Please note that this must begin with http:// (or https:// if your site runs on SSL) and end with /ttg-be/publisher/.

API Key
This is the key set in the Publisher Settings online. The default is ttg9999; you should change this if you haven't already done so.

After setting the above, click Check Authentication to check that Lightroom can locate your server and authenticate. The publisher provides error messages as needed that should help you resolve any issues.

You may set any other options (see below), or click Save when finished.


Optional Publisher Settings

Under the Publish Service heading:

Description
You may name your publisher instance. This description will appear in the Publish Services list, helping you to differentiate between multiple instances.


Under the Other Publisher Options heading:

Show a in browser after publishing
If enabled, after publishing an album, the album will be opened in your default web-browser.

Top-level galleries directory
Specify the target folder by path, relative to the top-level on which /ttg-be/ is located.

The corresponding directory must exist on the server and be granted write access. If this setting is changed after photos have been published then the original galleries folder will need to be renamed on the server to prevent the Lightroom albums from becoming out-of-synch with the server.

Once again, for review, the target folder may be any of the following:

  • If using CE4 Pages, the target folder will typically be the /galleries folder.
  • If using CE4 Auto Index, you may use any auto index folder as your target.
  • If using neither CE4 Pages nor CE4 Auto Index, you may create an empty folder to use as target.

Advanced users may specify a nested directory as the top-level galleries directory. For example, in a site setup such as the following:

/portfolio/galleries 
/ttg-be 

… the top-level galleries directory can be configured as portfolio/galleries.

Preserve capitalization in album slugs
Allows slugs with capital letters. The “slug” appears in the galleries URL. For example, for a gallery appearing at http://yourdomain.com/galleries/my-gallery/, the slug is “my-gallery”.

Push metadata without updating existing photos
When re-publishing an album or selected images in an album, pre-existing images online will not be re-uploaded; only metadata will be updated. New images will be generated and uploaded as usual.

This allows for much faster updates to galleries for photos that have already been published. The only time that you should need to disable this option is after altering the appearance of a photo (rather than updating metadata) or setting an album to use a new template with rendition sizes different from those of the originally published photos.


Under the File Naming heading:

You may setup parameters for renaming image files during publishing. This operates as elsewhere in Lightroom, though you should not use sequential numbering when publishing from CE4 Publisher; doing so may cause problems in the published album.


Under the Metadata heading:

You may control the metadata that is embedded within photos. Thumbnail images are only ever published with the copyright information and stripped of all other embedded metadata, regardless of how this is set.


Under the Watermarking heading:

You may setup image watermarking for all photos published through this instance of TTG CE4 Publisher. For this to take effect on already-published photos, make sure that Push metadata without updating existing albums is unselected before re-publishing photos that require the new watermark.

Watermarking configured here may be overridden by individual albums during Album Setup.


ce4_publisher_installation.txt · Last modified: 2015/03/03 10:26 by matthew

The Turning Gate
Creating webbly, wobbly, Lightroomy things since 2007.