Before summer 2016, Phabricator didn’t provide a quick way to change the logo. In the software past, the possibility was also offered, but between July 2012 and 2016, the logo was a resource embedded into new sprites, with other header graphics.
You can track the issue on Phabricator’s Phabricator.
Meanwhile a solution is provided by the product, here the procedure to update the UI and change the logo.
History
In August 2016, it’s now possible to edit the logo at directly in the configuration at the following Phabricator URL: /config/edit/ui.logo/
This November 6th commit has broken the logo into two parts, so you can keep the Phabricator eye and replace the product name. As such, the exact dimensions noted on this blog post should be discarded if you use the latest version (after 2014-11-06) of Phabricator. The methodology is still the same.
Overview
The logo is embedded in the webroot/rsrc/image/sprite-menu-X2.png file. A 50% version is located at webroot/rsrc/image/sprite-menu.png.
So, all the items used in the most top bar are embedded in one image:
A CSS rule allows to select the portion needed of the file.
The easiest procedure is so to prepare a suitable version of your logo respecting the size constraint, edit both files, to replace the genuine Phabricator logo by yours and then to regenerate cached resources.
Prepare a version of your logo
The X2 file uses a 298×52 version of your logo, the main file a 149×26 version.
Your logo will be printed against a #1E2224 background. If you want to provide a good and consistent look, a light gray white gradient is fine.
Edit the sprites picture
Remove the Phabricator logo, and paste yours. Respect the size and position constraints:
- sprite-menu.png starts the logo at (0px , 63 px)
- sprite-menu-X2.png starts the logo at (0px , 126 px)
Deploy the logo
Put your files in your phabricator/webroot/rsrc/image folder.
Then, regenerate Celerity files running the homonym command:
1 2 |
$ cd /opt/phabricator/ $ ./bin/celerity map |
Write a tool
You’re welcome to provide a tool to resize an image both in 298×52 and 149×26 sizes, then add it in blank files at the right coordinates.
ImageMagick is probably a good solution for that.
.