Converting a Publisher-based CE4 site to Backlight

There have been several questions in the forum about the best way to go about converting a CE4 site to Backlight. So instead of answering that multiple times, I give you this:

Scenario: you’ve got an existing TTG CE4 site and your albums are Publisher managed. (For a TTG site not using Publisher, see this post.)
Question: How best to replace your existing site with a Backlight site.
Assumptions: You’re currently using CE4 Pages as the basis of your site. At the minimum, you’ve purchased Backlight+Pages and you plan on migrating your existing albums and album sets to Backlight control.

Design your Backlight site

In my opinion, the best practice is to develop your new Backlight-based site in a sub-folder or sub-domain first. Do all your designing in this site. Creating a simple sub-folder is the easiest route. Using your FTP program, log in to the site and create a sub-folder in the root (usually the public_html folder). Name it what you wish, just don’t name it “backlight.” And don’t use spaces or special characters in the name. Letters, numbers, dashes, and underscores only.
If you wish to use a sub-domain, create that in the C-panel of your host (again, don’t name it “backlight”).

Install Backlight in your sub-folder or sub-domain per the Backlight documentation.
In Lightroom, install the version of Publisher that came with your Backlight download. It will take over for the CE4 version. Nothing will change as far as your CE4 site is concerned. You’ll still be able to publish as normal. TTG CE4 Publisher will be inactivated, replace by TTG Publisher.

Set up an instance of Publisher for your development site. Set the API URL to your development site. You can either use a unique API key or use the same one you’re currently using for your CE4 albums.

Start designing your new site. You’ll need to start from scratch as there is no mechanism to move your CE4 design to Backlight. Create all your stand-alone pages including Home, About, Contact, Services, etc. Create your album and album set templates.
Publish an album or two in the development site just so you can see how things are styled.
Implement any customization such as custom css or phplugins if you wish. If any of these contain URLs referring to your sub-folder, you’ll need to remember to change those once you’ve moved the site.

Once you’re satisfied and ready to replace your CE4 site, you can delete any albums and album sets you’ve published in the development site. Do this from Publisher and then check in Backlight > Publisher > Top-level Galleries to confirm that all albums and sets have indeed been removed.

Remove your old CE4 site files

Via FTP delete all your old CE4 files except for the ttg-be/ and galleries/ folder. If you also have a blog, leave that folder too, as well as any special purpose folders you may have created. As a safety measure, it’s a good idea to first download everything to your computer as a backup, just in case. If your site has an existing .htaccess file, be sure to include that in the download just in case there’s something in there you may need for your new site.

I suggest leaving your development site intact for now too. This way you have a test site ready to go in case you want to experiment without risking your main site.

Upload your shiny new Backlight site

Download to your computer everything in your development site folder except the galleries/ folder; you’ll be using your main site’s existing galleries/ folder.

Now upload those same files to the location where your old CE4 files were (typically the root of your site). It’s important that the backlight/ folder be on the same server level as your existing ttg-be/ folder.

Your file structure will look something like this, not including any other folders or files you may have needed to keep:

backlight/
galleries/
ttg-be/
your-development-site/
index.php
.htaccess

Log into the Backlight dashboard in your main site and go to Settings. Change the Site URL and Company URL.

In Lightroom, go to the Publisher instance that controls your existing albums and update the API URL to the new Backlight location (yoursite.com/backlight/publisher). If you set the API key for your development site the same as your original site, then you’re all set. If not, make sure the API keys in Backlight and Lightroom match.

In Backlight, run the migration tool for Publisher. If you were also using CE4 Cart  or CRG and have Backlight equivalents installed, run the Cart migration tool and the Client Response migration tool as well.

Now you can assign the album and album set templates you created in your development site. The quickest way to do this is from the Backlight dashboard. From the menu go to Backlight > Publisher > Top Level Galleries. Click on “Galleries” and on the next page scroll down to Actions. Click on Assign Templates. You can also do this in Lightroom by editing each album and set individually. If you’re a masochist.

Notes and gotchas

DO NOT replace anything in the ttg-be/ folder or alter it in any way. It will no longer be used in your Backlight site, but leave it as is for now since the Backlight  migration tools needs it to be in place if you plan on migrating current albums and sets as well as Cart and CRG settings over to Backlight control. Once you’ve done any migrations, you can delete the ttg-be/ folder.

If you’ve uploaded any images such as a masthead graphic, favicon, images for single pages, etc. via the Backlight upload utility, you may find that these images are missing. It’s unlikely, but I’ve had it happen a couple of times during the development and early days of Backlight. This may have been addressed already. At any rate, if you have any missing images, just upload them again and reinsert where needed.

 

That’s it. If you run into any problems, be sure to post those to the TTG Community Forum, where Matt and Ben will be sure to see.

Leave a Reply

Your email address will not be published. Required fields are marked *

About this site

This site is: a repository of time-savers and best practices from a user's perspective, picked up from several years of using TTG plugins.
This site is not: a support site.
Read more here.

Tip Jar

If this site has saved you some time, kept your hair attached, or otherwise prevented you from tossing the mouse through the monitor, feel free to donate.

Categories


Highly recommended. This is my go-to Lightroom book. Click on the book image. (affiliate link)

Affiliate link!

Current TTG versions

Backlight Versions

Backlight 1.2.3
Pages module 1.2.3
Cart Add-on 4.1.5
Client Response Add-on 7.1.2
Theater Add-on 1.2.4
WordPress Add-on 1.2.3
Publisher 3.2.2

CE4 Versions

TTG-BE: 2.0.5a
Autoindex: 7.0.8
Cart: 3.1.4a
CRG: 6.1.3a
Gallery: 6.1.9
Pages: 7.0.15
Publisher: 2.3.3
Stage: 6.1.6
Theme for WordPress: 3.1.2

Subscribe to new posts