Change Logo and Branding

[Surgical71]

Hi All

I just want to know if we are allowed to change the images in the container (Logo and Branding) and what would be the best way to have this done?

Idea is to give it a better look and feel not to pass the software off as my own.

[pglombardo]

I just want to know if we are allowed to change the images in the container (Logo and Branding) and what would be the best way to have this done?

Definitely - I have no objections or requirements beyond what the open source licensing would enforce. It's a Rails application so it would entail modifying ERB templates and changing the assets (images & CSS) in ./app/frontend.

I've thought about making the branding configurable but it hasn't been implemented yet mostly because of scope. Changing logo requires also attention to the CSS media queries which flip themes based on user preferences.

For example, you could replace the images in this header file to change the logo:
https://github.com/pglombardo/PasswordPusher/blob/master/app/views/shared/_header.html.erb#L6-L8

Then the application name and tag line are internationalized strings so you could substitute with just raw strings:
https://github.com/pglombardo/PasswordPusher/blob/master/app/views/shared/_header.html.erb#L12-L14

There is a feature request for this filed at #248

[speakdigital]

Thanks for this - it's a really great piece of software. I also saw that you have more branding options in the pipeline which will be really handy.

In the meantime I was able to login to the docker image and edit the erb files mentioned and put a logo in. I had to restart the docker container for it to show the change but I assume that's normal procedure?

However I'm struggling to see where to change the CSS. I updated app/frontend/css/bootstrap-.css but to no avail. I can see by inspecting that the css file loaded is public/packs/css/application-9b0c6cdd.css but that appears to be a compiled file?

Thanks very much again

[pglombardo]

Hi @speakdigital - thanks for the kind words. Those CSS files are compiled during the docker image compilation process with bundle exec rails webpacker:compile.

After modifying those CSS files and testing with the raw source, I believe you would have to rebuild the container entirely to make sure all bases are covered.

Unfortunately I don't have a good solution for custom or modified CSS yet as Rails compiles/compacts the CSS and then fingerprints them.

A better way may be to late load a completely new CSS file in the application layouts (app/views/layouts) that would selectively override the originals although I haven't tested this yet.

Also note that basic branding has been added recently.

Hopefully this helps - let me know how it goes.

[speakdigital]

@pglombardo thank you very much - this was really useful.

What I ended up doing was creating a speakdigital.css file in app/frontend/packs and then adding
<%= stylesheet_pack_tag 'speakdigital', media: 'all', 'data-turbolinks-track': 'reload' %>
to app/views/layouts/application.html.erb

So we now have https://password.speakdigital.co.uk all purpled up and slightly tweaked.

Thanks again for this great tool.

[pglombardo]

Nice! 😎

[pglombardo]

For others coming to this discussion, branding is now supported. Documentation is here: https://github.com/pglombardo/PasswordPusher/blob/master/Configuration.md#rebranding

[pglombardo]

Hi all - beyond the branding support that was added last year, I put together some instructions on how to download and apply any theme to Password Pusher. It's a short term work around but works well.

I hope this helps!

[pglombardo]

Hi all - I'm updating the answer here with the latest information.

As of v1.26.10 Password Pusher now

• comes with 26 themes bundled in selectable by environment variable
• also supports custom CSS
• supports entirely custom themes
• has the ability to be re-branded with logos, tag lines and more

With this framework and foundation, we'll be able to make sure that future changes don't break any existing user customisations.

If there are any questions or issues, please let me know!