TTG CE3 Publisher is a two-part publishing system. One part is the web app, which resides online with your site; the other part is the Publish Services plugin, installed to Lightroom.
The server-side component of TTG CE3 Publisher typically resides in the root of your website, presumably
http://yourdomain.com/publisher/. If using TTG CE3 Pages, this would see the
/publisher/ folder seating among your assets from Pages.
Installation is performed as follows:
Unzip the downloaded Publisher package, typically named something like TTG-CE3-Publisher-120.zip.
Set a strong password by editing the file
publisher/api/config.php and changing the API_KEY setting from 'ttg8888' to your own. For example, to change to 'apple12' (please don't use this specific password!), the top lines of config.php would look like:
// Change this to a strong password
NOTE for Mac users: TextEdit for Mac by default converts straight quotes to angled quotes, which breaks the Publisher. This can be solved by either using a different editor, or changing this behaviour in the TextEdit settings:
/publisher/ folder from within the unzipped folder to the top-level of your site. (The top-level of your site can often be found within the public_html directory when you FTP into your site, however the exact location is specific to your host and your own setup). For example, within a TTG CE3 Pages installation you may find the following files and folders:
/publisher/ the list would look like this:
Grant write access to the target folder to which your galleries will be published.
To grant write access, change permissions on the target folder to either 777 or 755, depending upon host. This is required so that Publisher will be able to manage the published albums and photos. For more information, see our guide Creating Writable Server-side Directories.
The downloaded zip file includes a Lightroom Publisher plugin called TTG-CE3-Publisher.lrplugin. This needs to be installed to Lightroom as follows.
Copy the TTG-CE3-Publisher.lrplugin to a location on your computer for safekeeping. This should be someplace that the plugin may remain longterm, 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 TTG-CE3-Publisher.lrplugin on your drive, and click Add Plug-in. TTG CE3 Publisher will appear in the list of installed plugins.
Click Done. TTG CE3 Publisher should now be installed, and can be seen in the Library's Publish Services control pane.
With TTG CE3 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. To review from above, a target location may be any of the following:
A single instance of TTG CE3 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 CE3 Publisher item. This will launch the Lightroom Publishing Manager:
The follow items all need to be set:
yourdomain.com, then the API URL would look like
http://yourdomain.com/publisher/api/. Please note that this must begin with
https://if your site runs on SSL) and end with
Checking Show albums in browser after publishing will launch an album in your web browser after each publish completes.
Specify the target folder by name. 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:
Advanced users may specify a nested directory as the top-level galleries directory. For example, in a site setup such as the following:
The top-level galleries directory can be configured as 'portfolio/galleries'.
Preserve capitalization in album slugs allows slugs with capital letters.
The Push metadata without updating existing albums option 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.
The Metadata section controls 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.
Watermarks controls image watermarking for all photos published through this instance of TTG CE3 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.