KBA-01657: Changing the Branding Bar Logo

Question:

How do we change the Branding Bar Logo?

Answer:

There are several choices.  With any luck your logo is stored right inside the sfPMS File Catalog.   Once you verify that, you can just update the file: see “Image File in Spitfire Catalog” below.

So, you probably want to start by finding out where the logo is stored right now.

Where is my Logo?

You can either use Chrome Inspector (or equivalent) or go to the IIS server and check the Branding tab in ICTool.

Chrome Inspector (or equivalent)

Open your site in Chrome.   No need to log in at this point.  Right click on your logo and choose inspect.  You should see something like

<img title="Company Logo" alt="Logo" src="/sfPMS/sfimg.ashx/ck/c30fd1da-2581-41a1-a85f-c1721d406849/logo.gif">

Look for the SRC= section and compare to the information in Interpreting the Logo Source below.

ICTool Branding

To find the Branding information:

  1. Open ICTool
  2. Go to the sfPMS tab
  3. Go to the Branding tab
  4. Observe the Branding Bar Logo field. (See example in image above).

Interpreting the Logo Source

Option (A) is the oldest.  Option (C) is the current best practice.

    1. A Site logo image file typically begins ~/images/
    2. An external logo typically begins //: or https://
    3. The catalog logo is sfimg.ashx/ck/c30fd1da-2581-41a1-a85f-c1721d406849/logo.gif.   Set this by clicking the Use Catalog Logo button

Updating the Logo File

Image File in Images Folder

If you are willing to keep the same image file name (images\acmelogo.gif in our sample picture above), you can just replace the file on the IIS server at a quiet time.  (Touching the logo does a soft reset of the application pool.)

Alternatives if you are willing to republish:

Change the name in ICTool and republish.  All users should be out of the system.

You can specify a fully qualified URL, for example if https://my.cdn.com/images/Logo.jpg points to your logo that is used elsewhere, you can use it for sfPMS sites by putting that URL into ICTool and republishing. The benefit here is that you can reference a logo on another server entirely. If your site uses SSL, then this logo URL must be via HTTPS too.

If you are going to update the branding settings, we recommend that you click “Use Catalog Logo” and republish so that you can just update the image file in the Spitfire Catalog

Image File in Spitfire Catalog

If you are configured to use the image from the Spitfire Catalog, updating the image can be done from the web UI at any time.  Our sales team uses this so they can quickly change logos between demos.

  • Use the catalog tab files only preset search.
  • Type SiteLogo.gif in the file name filter.
  • Uncheck the date range–your logo could be many years old
  • Prepare a file on your desktop (or wherever named SiteLogo.gif).  This can be a PNG or JPG that you have renamed with a GIF extension.
  • Drag and drop the SiteLogo.gif file onto the catalog row.
  • The file should upload and you should see “seconds ago” when the screen refreshes.
  • Version history applies; prior logos are still stored.  Use the File Properties Versions tab to revert to a prior version.
  • After updating the logo, users will see the new version after their browser cache expires.  (Hint: CTRL+F5)

Additional Comments:

The tilde (~) is an ASP.NET placeholder for “weboot”, so a path that begins ~\images\ means the images folder is right off the website’s root.

You can get to the website root using ICTool:

ICTool Site Application Root

Windows File Explorer will open:

Images Folder in Web Application Root

Notes

  • logo files are best if less than 130 pixels high and 300 pixels wide.
  • logo file must be a .JPG, .PNG or .GIF file.

 


KBA-01657; Last updated: May 20, 2019 at 9:01 am 
Keywords: none