Ir para conteúdo principal

Adicione CSS personalizado ao widget

Estilize o widget do Olvio além dos controles nativos: onde adicionar CSS, quais seletores usar e o que o Olvio remove ao salvar.

Adicione CSS personalizado ao widget

Se os controles nativos da página Aparência não derem o visual que você quer, você pode adicionar seu próprio CSS para mudar a aparência do widget do Olvio na sua loja virtual. O CSS personalizado está disponível em todos os planos.

Para cores, fontes e raio dos cantos, comece pelos controles nativos: veja Personalize as cores do widget, Personalize a fonte e o tamanho da fonte do widget e Personalize o raio dos cantos do widget.

Seu CSS se aplica à página inteira

O widget não fica isolado do restante da página da sua loja virtual. O Olvio adiciona seu CSS à página como uma folha de estilos comum, então uma regra pode alterar qualquer elemento da página, não só o widget.

O Olvio o adiciona nas páginas de produto que exibem o bloco do Olvio e, se você usa o Olvio Advisor (planos Growth e Scale), nas outras páginas da sua loja em que a incorporação de app Olvio Advisor é carregada.

Inclua uma classe do Olvio em cada seletor, como .olvio-panel. Um seletor isolado como p ou button muda o estilo de todos os parágrafos ou botões dessas páginas.

Adicione seu CSS

  1. No admin do Olvio, abra Aparência.

  2. Clique na aba Avançado.

  3. No card CSS personalizado, cole ou digite seu CSS. O campo aceita até 5.000 caracteres e mostra um contador de caracteres.

  4. Clique em Salvar na barra de salvamento.

A mensagem Alterações salvas confirma que o CSS foi salvo. Em seguida, o campo mostra seu CSS do jeito que o Olvio o armazenou, para você ver se algo foi removido (veja O que o Olvio remove ao salvar abaixo).

A Pré-visualização ao vivo da página Aparência não mostra o CSS personalizado: O CSS personalizado só é aplicado no widget ao vivo. Para ver suas alterações, recarregue uma página de produto na sua loja virtual.

Faça suas regras prevalecerem sobre os estilos do Olvio

Os estilos do próprio widget do Olvio usam !important em muitas propriedades para que seu tema não consiga quebrar o widget. Adicione !important a cada propriedade que você sobrescrever: onde o estilo do Olvio o utiliza, uma regra sem ele perde para o padrão do Olvio.

Para ajudar suas regras a prevalecerem, o Olvio adiciona html antes de cada seletor ao aplicar seu CSS: .olvio-panel é aplicado como html .olvio-panel.

Seletores dentro de at-rules como @media não recebem esse prefixo. Comece-os você mesmo com html, por exemplo @media (max-width: 600px) { html .olvio-title { font-size: 1.2em !important; } }.

Fora das at-rules, não comece você mesmo um seletor com html ou :root: com o prefixo que o Olvio adiciona, a regra não corresponderia a nada. Evite também vírgulas dentro de :has() e dentro de valores de atributo entre aspas: o Olvio adiciona o prefixo ali também, e essa parte do seletor deixa de corresponder.

Seletores úteis

O card CSS personalizado sugere estes seletores:

  • .olvio-label: o Nome do especialista, o texto pequeno em maiúsculas acima do título na página de produto.

  • .olvio-title: a Pergunta de chamariz, o título na página de produto.

  • .olvio-suggestion-btn: os botões de perguntas sugeridas na página de produto e, nas conversas do Olvio Advisor, os botões de resposta acima do campo de pergunta e os botões Continuar e Recomeçar, que oferecem retomar uma conversa anterior. Para estilizar só um desses lugares, coloque .olvio-suggestions (página de produto) ou .olvio-panel-chips-row (Olvio Advisor) antes da classe, por exemplo .olvio-panel-chips-row .olvio-suggestion-btn.

  • .olvio-input-row: o campo de pergunta, na página de produto e no painel de chat.

  • .olvio-panel: o painel de chat.

  • .olvio-msg-user: as mensagens do comprador no painel de chat.

  • .olvio-msg-assistant: as respostas do Olvio no painel de chat.

  • .olvio-atc-btn: o botão de adicionar ao carrinho do produto que está sendo visto, acima do campo de pergunta no painel de chat. Os botões de adicionar ao carrinho nos cards de produto do chat usam .olvio-card-atc.

Para descobrir a classe de outro elemento, clique com o botão direito nele na sua loja virtual e use a ferramenta Inspecionar do seu navegador.

Exemplos

  • Sombra no painel de chat: .olvio-panel { box-shadow: -12px 0 40px rgba(0,0,0,0.15) !important; }

  • Título menor na página de produto: .olvio-title { font-size: 1.25em !important; }

  • Cor ao passar o mouse nas perguntas sugeridas e nos botões de resposta do Advisor: .olvio-suggestion-btn:hover { background: #faf5ff !important; }

  • Ocultar o nome do especialista: .olvio-label { display: none !important; }

O que o Olvio remove ao salvar

O Olvio verifica seu CSS ao salvar e remove, entre outras coisas:

  • Regras @import.

  • Comentários CSS (/* … */).

  • Fragmentos de HTML como <script, </style, <!-- e -->.

  • Endereços completos dentro de url(), image-set(), image(), src() e cross-fade(): um valor que começa com http://, https://, //, javascript: ou vbscript: é substituído por um url() vazio, mesmo quando aponta para a sua própria loja. Não é possível carregar imagens ou fontes de um endereço web completo dessa forma. URIs data: e caminhos relativos, como um caminho que começa com uma única /, são mantidos.

  • A propriedade behavior e expression(), que só versões antigas do Internet Explorer usavam. Evite scroll-behavior e overscroll-behavior no CSS personalizado: ao salvar, o Olvio remove parte dessas declarações, e o CSS que vem depois delas pode parar de funcionar.

  • Qualquer regra cujo seletor mire a linha de rodapé do painel de chat (.olvio-panel-footer, .olvio-brand-mention) ou a área na parte inferior do painel que a contém (.olvio-panel-input), inclusive dentro de @media e de regras aninhadas. A regra inteira é removida, mesmo que ela liste outros seletores também. Uma at-rule como @scope que cite uma dessas classes é removida com tudo o que está dentro dela. Para estilizar o campo de pergunta, use .olvio-input-row.

  • Tudo o que passar de 5.000 caracteres.

Dentro de uma string entre aspas, evite sequências de escape com barra invertida como \", \\ e \A: elas quebram a string quando você salva. Sempre que possível, digite o próprio caractere, e coloque uma string que contenha " entre aspas simples.

A linha "Com tecnologia Olvio" continua em todos os planos

Na parte inferior do painel de chat aparece uma linha que diz, em português, Você está conversando com uma IA • Com tecnologia Olvio, com um link para o Olvio na Shopify App Store. O Olvio não oferece nenhuma forma de ocultar essa linha, em nenhum plano.

O Olvio remove regras que citam as classes dessa linha. Na sua loja virtual, o widget também força os estilos de exibição e visibilidade próprios da linha e a coloca de volta se algo a remover.

Teste e desfaça suas alterações

Depois de salvar, recarregue uma página de produto na sua loja virtual e clique em uma pergunta sugerida (ou digite uma pergunta) para abrir o painel de chat. Verifique se as mensagens estão legíveis e se nada fica sobreposto. Verifique a página também em uma janela estreita, do tamanho de um celular.

Para cancelar edições que você ainda não salvou, clique em Descartar na barra de salvamento. Para remover um CSS personalizado que você já salvou, apague o conteúdo do campo e clique em Salvar: o widget volta à aparência padrão na próxima vez que uma página da loja virtual for carregada.

Se suas alterações ainda não aparecerem, veja Minhas alterações de Aparência não aparecem na loja virtual.

Isto respondeu à sua pergunta?