Permitir que usuários selecionem novas paletas de cores

[Discourse]

Este é um guia para disponibilizar novas paletas de cores para todos os usuários escolherem em suas preferências de perfil.

Nível de usuário necessário: Administrador

Incluir uma nova paleta de cores

1. Vá em Admin → Aparência → Paletas de Cores
2. Crie uma nova paleta de cores clicando no botão + Nova
3. Selecione a paleta de cores base preferida na lista
4. Marque a opção Paleta de cores pode ser selecionada pelos usuários
5. Faça os ajustes de paleta apropriados, se necessário
6. Salve a paleta de cores

Selecionando a paleta de cores

Agora os usuários podem selecionar a nova paleta de cores em sua respectiva página de https://seu-site.com/my/preferences/interface:

1. Acessando as Preferências do Usuário: Os usuários podem navegar até suas preferências clicando no ícone do perfil no canto superior direito do fórum e selecionando “Preferências” no menu suspenso.
2. Guia Interface: Dentro das preferências, a guia “Interface” contém a configuração para escolher uma paleta de cores para os modos Claro e Escuro.
3. Seleção da Paleta de Cores: Os usuários podem escolher sua paleta de cores preferida no menu suspenso fornecido.
4. Modo de Cor da Interface: Os usuários também podem selecionar seu modo de cor de interface preferido — Automático (segue a preferência do sistema), Claro ou Escuro.
5. Salvando Alterações: Após selecionar a paleta de cores desejada, os usuários precisam clicar no botão “Salvar Alterações” na parte inferior da página para aplicar as mudanças.

Modo Escuro

Por padrão, Escuro, WCAG Claro, WCAG Escuro, Dracula, Solarized Claro e Solarized Escuro já são paletas de cores definidas no Discourse.

Recursos adicionais

• Automatic Dark Mode color scheme switching
• Create and share a color scheme
• Update themes and plugins to support automatic dark mode

[featheredtoast (Jeff Wong)]

Great work! Simple to understand how to compose themes together quite nicely – I’m going to play around with themes soon, for sure!

Bit o’ feedback on this:

I’m seeing that there’s an option to import themes directly - What’s the structure that import-able themes should take? A repository with the .dcstyle.json file(s) at the root? It’s not clear, and the placeholder value – https://github.com/discourse/discourse/sample_theme - doesn’t lend any clues.

It also seems that exporting themes got a little more difficult as you can’t just export a theme with a single click if that theme is dependent on child themes. I understand why this might need to be this way, but I’m concerned about portability of themes with the added inheritance - will there be a way to export the theme as a bundle with all child themes attached as well?

[Falco]

@awole20

What’s the structure that import-able themes should take?

You can read about that here:

Structure of themes and theme components

Discourse supports native themes that can be sourced from a .tar.gz archive or from a remote git repository including private repositories. [56] An example theme is at: GitHub - discourse/discourse-simple-theme: Sam's simple discourse theme [32] The git repository will be checked for updates (once a day), or by using the Check for Updates button. When changes are detected the Check for Updates button will change to the Update to Latest. [image] To create a theme you need to follow a spe…

[codinghorror (Jeff Atwood)]

We are going to ship both dark and light themes by default out of the box, yes? That’s my goal here. We also need:

• small font
• large font

themes to ship natively as well.

[tobiaseigen]

This is fabulous. Thanks for adding this feature and for writing up this howto. Can you add instructions for specifying a different logo for the dark theme? That will be a common request I am sure.

[Vocino (Travis)]

@tobiaseigen

Can you add instructions for specifying a different logo for the dark theme? That will be a common request I am sure.

Yup, this is the primary (only?) blocker for this. I see that Meta is switching logos, or applying some kind of shadow.

[sam (Sam Saffron)]

@Updated December 2018

This method no longer works. Instead, use this theme component: https://meta.discourse.org/t/alternative-logo-for-dark-themes/88502

This is actually pretty simple:

old method

.logo-big {
    display: block;
    -moz-box-sizing: border-box;
     box-sizing: border-box;
     background: url(awesome-dark-logo.png) no-repeat;
     width: 150px; 
     height: 40px; 
     padding-left: 150px; 
     background-size: 150px 40px;
}

You basically evict the existing image out of the IMG tag

[tophee (Christoph)]

Setting up a dark theme made me inquire into where this grey background colour comes from:

I do not have any black in my colour scheme so I suppose that the grey is calculated as a lighter version of the complementary colour of the primary colour (white, in my case).

While I can see the reasoning behind it, it doesn’t really work if your black theme is using anything outside the black/grey spectrum as secondary colour. Perhaps it’s a matter of taste, but I’d probably prefer that navigation button background colour (or whatever it’s called) to be based on the secondary colour.

I am not saying that every colour should be chosen manually (discourse is generally doing a great job in calculating colours - mainly shades and tints, I believe - based on the few customizable ones) but this particular formula seems a bit too constraining.

Perhaps it can be solved with a single switch that allows the user to switch the color base between primary and secondary colour?

Use secondary colour as base for button backgrounds

[Vocino (Travis)]

@tophee, I think the derivative colors make it really easy to use. For advanced color schemes you have to use advanced features—specifically custom CSS in this case. That seems like a logical ask to me.

[Jo0Lz]

Awesome. This makes browsing the discourse at night so much easier on the eyes, even with the new Windows 10 “night mode” the light theme is pretty bright.

Now the ability to switch the theme easily through a keyboard shortcut, menu item or other button, and we’re set!

[tophee (Christoph)]

@Vocino

I think the derivative colors make it really easy to use.

I am not calling derivative colours into question, merely pointing out that the way one of them is derived could be improved.

@Vocino

For advanced color schemes you have to use advanced features

So using a colour outside the black-white continuum is advanced? I wouldn’t think so.

[rewphus]

In my testing I am noticing some peculiarities, and I even had another user on my site test this because this seemed to simple that I thought I was missing something, but here are my steps to reproduce:

1. Have no user selectable themes enabled.
2. Change your default theme.

Observed Result: The theme doesn’t change for the user until they go in to their Preferences > Interface and click Save Changes, even though that is the only theme available to them in the dropdown. Is anybody else seeing this?

[sam (Sam Saffron)]

I think this is an admin thing, also make sure you are on latest.

If you ever set the theme via the selector in prefs we set a cookie (this cookie is validated server side with an admin bypass)

So, I would re-test this theory of yours on Chrome incognito … what happens? Then as a non admin … what happens?

[rewphus]

Yeah, must just be a cookie refresh issue. I was doing a hard refresh clearing the cache, but I had two logged in tabs open so I think that may have played a part. I can reproduce in incognito, but not after a hard refresh, so this appears to be a non-issue. I will be more careful about testing in incognito mode before reporting again. Thanks for the quick reply.

[djcyry (Cosmin)]

Hello
I have try it but i am not able to change theme from menu (like on meta) i use discourse app and safari and still not show . I run the latest version of discourse .

[dax (Daniela)]

You need the Hamburger Theme Selector to display themes inside the hamburger menu.

[djcyry (Cosmin)]

Oh y understand now …Thanks .

[foodaginnovators (Mike)]

What would be the right code for .logo-small? Seems to be a large gap on right when using:

.logo-small { display: block; -moz-box-sizing: border-box; box-sizing: border-box; background: url(awesome-dark-icon.png) no-repeat; width: 40px; height: 40px; padding-left: 150px; background-size: 40px 40px; }

[sam (Sam Saffron)]

Not totally sure, can you add a screenshot of what you have now? Perhaps @awesomerobot can help.

[awesomerobot (Kris)]

My guess from looking at your CSS is that the padding-left: 150px; is the cause; your .logo-small is 40px wide, so you’d have 110px of space to the right of it because of that padding-left.