Este documento resume as principais melhorias e novidades da versão 2.4 da plataforma CORE. Entre elas estão:
1) Integração com o serviço de envio de SMS Zenvia;
2) Permitir configurar exibição de variações de produtos disponíveis ou não nas facetas;
3) Adicionar opção de financiamento como forma de pagamento na loja virtual.
2. 1CORE–Documentaçãode versão 2.4
Sumário
Melhorias e novidades da versão................................................................................................2
Integração com Zenvia ................................................................................................................3
Permitir que facetas apresentem apenas variações disponíveis................................................8
Financiamento pela loja virtual.................................................................................................12
Debug de promoções no carrinho ............................................................................................17
Contador global de boleto por gateway de pagamento ...........................................................20
Gravar perfil de filtros por usuário *.........................................................................................21
Integração de preço de brindes no ERP Ábacos .......................................................................25
Melhorias nas promoções de desconto progressivo................................................................26
Histórico de navegação por cookie ...........................................................................................29
Ajuste para Bing seguir links de paginação de forma correta ..................................................30
Melhorias na funcionalidade de invalidação de cache no admin.............................................31
Disponibilizar informações de condições de pagamento nas promoções *.............................32
Melhorias para produtos KIT.....................................................................................................33
Melhorias no processo de invalidação automatizada de cache ...............................................35
3. 2CORE–Documentaçãode versão 2.4
Melhoriase novidades
daversão
Novidades
Integração com Zenvia
Permitir que facetas apresentem apenas variações disponíveis
Financiamento pela loja virtual
Debug de promoções no carrinho
Contador global de boleto por gateway de pagamento
Gravar perfil de filtros por usuário *
Integração de preço de brindes no ERP Ábacos
Melhorias
Melhorias nas promoções de desconto progressivo
Histórico de navegação por cookie
Ajuste para Bing seguir links de paginação de forma correta
Melhorias na funcionalidade de invalidação de cache no admin
Disponibilizar informações de condições de pagamento nas promoções *
Melhorias para produtos KIT
Melhorias no processo de invalidação automatizada de cache
4. 3CORE–Documentaçãode versão 2.4
IntegraçãocomZenvia
A integração possibilitará incluir a um fluxo de trabalho do Core (workflow) a tarefa de envio
de SMS utilizando os serviços da Zenvia. As mensagens poderão ser configuradas através de
um template de email utilizando os mesmos contextos já disponíveis. Também poderá ser
definido uma faixa de horários em que os disparos serão permitidos evitando assimque o
cliente receba mensagens em horários indevidos.
5. 4CORE–Documentaçãode versão 2.4
Instalação / Ativação
1. SistemaAdministrativo
Por se tratar de um plugin, é necessário solicitar a ativação do mesmo para o suporte.
1.1. Configurandoos dados
Após o plugin estar habilitado, estará disponível no menu “Integrações” a opção “Configurar
Zenvia (Plugin)”.
No painel do sistema administrativo: Integrações -> Configurar Zenvia (Plugin)
Na mesma telatemos abaixo os campos de configuração da mensagemonde é possíveldefinir
o nome do remetente que aparecerá no SMS e também as faixas em que será permitido o
envio. Caso o fluxo execute em um horário não permitido a mensagem será automaticamente
agendada para ser entregue no primeiro horário disponível.
6. 5CORE–Documentaçãode versão 2.4
As configurações podem ser feitas por grupo de configurações e deverão conter
obrigatoriamente a Conta e a Senha fornecidos pela Zenvia.
1.2. Configurandoo template damensagem
A mensagem do SMS será configurada através de um template de email que posteriormente
será vinculado ao fluxo desejado.
No painel do sistema administrativo: Aparência -> Templates de email
O campo assunto apesar de obrigatório ao criar um novo template de email não será usado
no SMS.
Tendo em vista que não será possível reproduzir tags HTML nas mensagens do SMS e que
cada mensagem tem limite de 160 caracteres (conforme documentação), sugerimos no
momento da configuração do template de email o uso do modelo
“Emails/email.empty.template” no campo “Modelo”, pois o mesmo renderizará somente os
dados configurados no campo “Conteúdo”.
O campo “Contexto” deverá estar configurado como “Pedidos de Compra”.
7. 6CORE–Documentaçãode versão 2.4
1.3. Configurando um fluxo
Ao criar ou editar as tarefas de um fluxo, estará disponível a opção “(Zenvia) Enviar SMS”.
Ao editar a tarefa, é possível definir um template de email previamente configurado, que será
o conteúdo da mensagem do SMS.
8. 7CORE–Documentaçãode versão 2.4
Utilização
O únicomeiode utilizaçãoé dentrode umfluxo,comomostradoanteriormente.Dependendodo
fluxoescolhido,estepoderáserexecutadomanualmenteouatravésde umatarefaagendada.
É importante salientarque osenviossãobaseadosnometadadode cliente “Celular”,casoo mesmo
não possuaestainformaçãoa tarefado fluxonãoenviaráamensagemde SMS para este cliente.
9. 8CORE–Documentaçãode versão 2.4
Permitirque facetas
apresentemapenas
variaçõesdisponíveis
A inserção de uma nova configuração na administração do sistema permitirá que o cliente
possa configurar a exibição ou não de variações de produtos que não estejammais
disponíveis na loja, da mesma forma que atualmente é possível fazer a mesma configuração
para produtos indisponíveis.
10. 9CORE–Documentaçãode versão 2.4
Configuração
Dentrodas opçõesde Produtos > Listagens,foi adicionadaa configuração “Exibirvariaçõessem
estoque aofacetar”,para que o cliente possavisualizarvariaçõesindisponíveisnaslistagensdosite
no momentoque ousuáriorealizar umfacetamento.A mesmaconfiguraçãopode serrealizadapara
as pesquisas,em Produtos> Pesquisa.
No painel do sistema administrativo: Configs -> Configurações gerais
11. 10CORE–Documentaçãode versão 2.4
Utilização
No site,entrandoemalgumacategoriadisponível,podemosvisualizarque,parao exemploabaixo,o
produtoemquestãocontémvariaçõesdisponíveis(azul) e indisponíveis(verde),masmesmoassim
ele é retornadona listagem,umavezque foi configuradoparaexibirvariaçõessemestoque ao
facetar.
12. 11CORE–Documentaçãode versão 2.4
Ao configurarparaque as variaçõesindisponíveisnão sejammaisexibidasaorealizarofacetamento,
o produtodesaparece dalistagemcasoa facetaselecionada(nocasoa verde) estejaindisponível no
site.
No painel do sistema administrativo: Configs -> Configurações gerais
13. 12CORE–Documentaçãode versão 2.4
Financiamentopela
lojavirtual
O cliente teráagorauma nova formade pagamentochamadaFinanciamento.Esse métodode
pagamentohabilitaráumformuláriocustomizadoparasolicitarinformaçõesaoclientefinal,
mediante algumasconfiguraçõesnosistemaadministrativo.
14. 13CORE–Documentaçãode versão 2.4
Configuração
2. SistemaAdministrativo
2.1. Configurandoos Metadados
Foi adicionada uma nova entidade para criação de metadados, chamada Forma de
Pagamento. Entrando em Configs > Metadados, insira todos os metadados que sejam
necessários o cliente preencher no site (essas informações serão utilizadas para gerar o
formulário de financiamento no site).
Para cada metadado criado, diversas opções poderão ser configuradas, dependendo da
necessidade de cada cliente, como:
- Obrigatoriedade da informação
- Tamanho do campo
- Tipo de dado
- Entre outros.
15. 14CORE–Documentaçãode versão 2.4
2.2. Configurandoa Forma de Pagamento Financiamento
Entre em Configs > Meios de Pagamento e, caso ainda não exista na listagem, insira
uma nova forma de pagamento clicando em <Adicionar Meio de Pagamento> e escolha o
Fornecedor do Serviço como Financiamento.
Após inserir as informações gerais sobre a forma de pagamento, na aba Personalizados será
possível selecionar os metadados do tipo Forma de Pagamento criados anteriormente e
vinculá-los ao Financiamento que está sendo criado, arrastando-os para o quadro
Selecionados conforme necessidade.
16. 15CORE–Documentaçãode versão 2.4
Utilização
No momento de finalizar um pedido no site, caso esteja ativo na administração, o cliente
poderá selecionar o meio de pagamento Financiamento, e preencher as informações
cadastradas para esse meio de pagamento. As validações e obrigatoriedades de campos
respeitarão as configurações realizadas no sistema administrativo, nos metadados.
17. 16CORE–Documentaçãode versão 2.4
Fechamento do pedido
De voltaao sistemaadministrativo,entrandoemBackoffice >Pedidose selecionandoopedidoque
acabou de ser finalizado,asinformaçõesde financiamentopoderãoservisualizadasnaaba
Pagamento.
18. 17CORE–Documentaçãode versão 2.4
Debugde promoções
nocarrinho
Criamosuma ferramentaque auxiliaránoentendimentode que promoçõesestãosendoaplicadas
emum determinadocarrinho.A partirde uma rota determinadanopadrão
http://www.sualoja.com.br/carrinho/debug,você poderáacessare verificarquaispromoçõesforam
ou não aplicadas,sobrescritasouanuladas.A ferramentaapresentarátambémaspromoçõesna
ordememque foram executadase separadasporgrupode promoção.
19. 18CORE–Documentaçãode versão 2.4
Configuração
Essa rota terá restrição de IPS para controle de acesso, caso não consiga acessá-la, favor
entrar em contato com a equipe de suporte para que possamos cadastrar o seu IP.
20. 19CORE–Documentaçãode versão 2.4
Utilização
As promoções serão separadas por grupo, e listadas na ordem em que foram aplicadas. Está
disponível uma legenda (Aplicada, Anulada, Não aplicada), para melhor entendimento da
execução das promoções.
Aplicada significaque a promoção passou por todas as condições e foi executada.
Anulada significaque a promoção foi sobrescrita por outra por regra de exclusividade.
Não aplicada significaque a promoção não atendeu a todas as condições.
Acesse a seguinte url: http://www.sualoja.com.br/carrinho/debug
21. 20CORE–Documentaçãode versão 2.4
Contadorglobalde
boletoporgatewayde
pagamento
Foi realizada a possiblidade de configuração para que as somas dos identificadores de boleto
genéricos possam ser contadas de forma global. Por exemplo, se você possui boleto genérico
Itaú e Bradesco, ambos os identificadores (Nosso Número), irão seguir a contagem global.
* Se você deseja essa funcionalidade, entre em contato com o suporte técnico para solicitar
a configuração.
22. 21CORE–Documentaçãode versão 2.4
Gravarperfilde filtros
porusuário*
Widget criado especialmente para o auxílio na compra de peças de vestuário, onde
armazena as medidas para que possa ser utilizado para indicar o tamanho ideal ao cliente.
* Widget disponível apenas para clientes que contrataram previamente o serviço. Para
solicitar a instalação é preciso fazer requisição através do canal do suporte.
23. 22CORE–Documentaçãode versão 2.4
Instalação
A instalação pode ser feita de duas maneiras, pelo gerenciador de Widgets, no editor de
layout:
Ou pelo editor de arquivo:
{% profile_body_measure() %}
24. 23CORE–Documentaçãode versão 2.4
Parâmetros
Title: Título do botão
ModalTitle: Título da modal
ModalSubmit: Botão, salvar dados
SubmitSuccess: Menssagem, salvo comsucesso
SubmitError: Menssagem, erro ao salvar
SaveProfile: Label: opção para salvar informações no perfil
Fields: Campos do metadados mostrados no form (Busto, Cintura, Quadril, Bojo)
Metadados:
Os campos utilizados pelo Widget são configurados pelo painel de metadados no admin
(Configs > Metadados).
A entidade para os campos devem ser Cliente – Pessoa Física.
Não é necessário que o campo seja configurado como visível no site, ele se torna visível com
o parâmetro Fields do próprio Widget. Note que o “Nome” do campo deve ser igual ao
configurado no Widget.
Não é recomendado que o campo seja definido como obrigatório.
25. 24CORE–Documentaçãode versão 2.4
A dica de cadastramento é utilizada como sufixo para o input, utilize definições de medidas
como “cm”.
Customizações:
O Widget possui uma nova forma de customização que tem o objetivo de melhor organizar
os arquivos do tema.
As templates podem ser automaticamente sobrescritas quando o arquivo com mesmo nome
for colocado na passa TEMA/Widgets/profile_body_measures, veja quais templates estão
disponíveis para serem customizadas.
wd.profile.body.measures.template
Templates/button.template
Templates/input.template
Templates/mannequin.template
O CSS para o Widget não é incluído automaticamente e neste caso é necessário que seja
incluído através do gerenciador de recursos.
Salve o arquivo em: TEMA/Widgets/profile_body_measures
/Styles/wd.profile.body.measures.css
Este Widget tem parte do seu layout definido pelo tema, sendo assimé obrigatório a
customização do tema para a loja, utilize o CSS que se encontra dentro do tema Default
(Default/Widgets/profile_body_measures/Styles/wd.profile.body.measures.css) como
base.
27. 26CORE–Documentaçãode versão 2.4
Melhoriasnas
promoçõesde
descontoprogressivo
Adicionamos novas propriedades nas seguintes promoções de desconto progressivo:
Promoções em pedidos » Desconto progressivo
Promoções em pagamento » Desconto progressivo em meios de pagamento
Foram adicionados filtros de produtos inclusivos e negados e uma nova opção de tipo de
desconto “Por faixa de quantidade do mesmo produto”. Esses novos critérios permitem que
o lojista faça uma regra para um grande número de produtos semgrande esforço.
28. 27CORE–Documentaçãode versão 2.4
Configuração
1. SistemaAdministrativo
1.1. Configurandopromoções (Condições e Benefícios)
Para cada tipo de promoção com desconto progressivo diversas opções poderão ser
configuradas dependendo da necessidade de cada cliente, como:
Tipo de desconto
o Faixa de quantidade / valor para aplicar o desconto
Lista de produtos que deverão receber a promoção
Lista de produtos que não deverão receber a promoção
No painel do sistema administrativo: Marketing -> Promoções
29. 28CORE–Documentaçãode versão 2.4
2. Listade produtos
É possível definir uma lista que deverá receber as promoções, assimcomo a lista de
produtos que não deverão receber as promoções.
No painel do sistema administrativo: Marketing -> Promoções
30. 29CORE–Documentaçãode versão 2.4
Históricode navegação
porcookie
Alteramos a forma de armazenamento da funcionalidade de histórico de navegação. A partir
de agora as informações serão gravadas através de cookies, o que possibilita a exibição dos
itens visitados (produtos, categorias e buscas) por mais tempo e com menos uso de recursos
do servidor.
31. 30CORE–Documentaçãode versão 2.4
AjusteparaBingseguir
linksdepaginaçãode
formacorreta
Foi efetuada uma melhoria na marcação do html gerado para os resultados de busca de
produtos de modo que o buscador bing consiga reconhecer corretamente os paginadores
dessas páginas. Esta alteração foi necessária devido ao bing utilizar uma forma diferente do
google e outros buscadores.
32. 31CORE–Documentaçãode versão 2.4
Melhoriasna
funcionalidadede
invalidaçãodecache
noadmin
Foram realizadas melhorias de interface e usabilidade na tela de Invalidação de Cache no
Admin. As melhorias consistem em:
Quantidade de proxys e clusters visíveis
Respostas mais amigáveis para as ações de acordo com cada proxy ou cluster
Unificação de ações
Redução no número de botões
No painel do sistema administrativo: Configs -> Invalidação de Cache
33. 32CORE–Documentaçãode versão 2.4
Disponibilizar
informaçõesde
condições de
pagamentonas
promoções*
Adicionamos ao contexto do site algumas informações como as condições de meios de
pagamentos configurados nas promoções, de forma a esta poder ser utilizada através do
sistema de templates nas páginas de checkout do Core. Com esta implementação podemos
apresentar a forma que está dando o desconto (boleto/carrinho, etc.) no checkout.
Esta informação estará disponível através dos componentes de checkout no seguinte
método:
* Widget disponível apenas para clientes que contrataram previamente o serviço. Para
solicitar a instalação é preciso fazer requisição através do canal do suporte.
{% Basket.BasketPayment %}
35. 34CORE–Documentaçãode versão 2.4
Instalação / Ativação
3. Configuraçãodo KIT
É necessário o cadastro adequado dos produtos do tipo KIT e a associação das medias dos
produtos KIT e seus produtos associados.
Importante: Caso a loja nunca utilizou este tipo de produto ou possui uma customização, é
necessária a realização dos ajustes pertinentes para apresentação da funcionalidade em
concordância com o layout da loja.
36. 35CORE–Documentaçãode versão 2.4
Melhoriasnoprocesso
de invalidação
automatizadade cache
Foram realizadas melhorias na invalidação de caches de output automatizado da plataforma,
mais especificamente, nas invalidações relacionadas a alterações em banners, alterações em
templates e alterações em assets (css, js).
37. 36CORE–Documentaçãode versão 2.4
Funcionamento
1. Processode invalidaçãode cache
O processo realizado para invalidação de cache não é imediato, podendo levar até 2
minutos, pois são necessários processamentos para determinar as páginas (urls) que devem
receber a invalidação.
Cada página acessada recebe uma “tag” (ex.: X-Proxy-Cache-Dep:3841133719@1008) que
fica vinculado com cada recurso (template, asset, ...) que foi utilizado para entregar o
conteúdo. Quando é identificada alguma alteração em um recurso vinculado, são
determinadas as tags que devem ser invalidadas.
2. Processode invalidaçãode cache para banners
O processo de invalidação de cache para banners são vinculados pelas posições de banner
utilizadas na página. Este vinculo só acontece quando é utilizado o widget de banners
“marketing_banner”, sendo imprescindível a sua utilização.
Além disso, as imagens dos banners são enviadas para o CDN e são entregues no domínio
com formato http://xxxxxxxxxxxxx.cloudfront.net/. Estas imagens enviadas ao CDN nunca
são invalidadas.
Ao alterar a imagem de um banner pela administração da plataforma, a imagem recebe um
novo “timestamp”, o que permite que o CDN entregue a nova imagem semcache.
Importante: Caso seja referenciada uma imagem do cdn diretamente no template, a única
forma de invalidação da imagem é adicionando um parâmetro “querystring” na imagem
para que seja considerado como uma nova imagem.
3. Processode invalidaçãode cache para templates
O processo de invalidação de cache para templates é realizado pelo vinculo dos caminhos
dos arquivos utilizados na página. Este vinculo acontece automaticamente durante a entrega
do conteúdo pelo servidor.
Ao alterar um template pelo gerenciador de arquivos ou configuração de design na
administração da plataforma o processo de invalidação é iniciado.
4. Processode invalidaçãode cache para assets (css, js)
O processo de invalidação de cache para assets (css, js) é realizado por vínculos
automaticamente gerados durante a entrega do conteúdo pelo servidor.
38. 37CORE–Documentaçãode versão 2.4
Ao alterar um arquivo de estilos ou de script pelo gerenciador de arquivos ou pelo
gerenciador de recursos na administração da plataforma o processo de invalidação é
iniciado.
Importante perceber que estes recursos são combinados e minificados em um único
“arquivo” e entregues pelo CDN. Estes recursos entregues pelo CDN nunca são invalidados.
Ao realizar a alteração em um arquivo, é gerada uma nova “hash” para o arquivo
combinado. Isto permite que o CDN automaticamente entregue o conteúdo mais atual e o
cache no navegador do cliente também é automaticamente atualizado.