1. 1. Documentao de Verso Plataforma CORE Verso 2.4
2. 2. 1COREDocumentaode verso 2.4 Sumrio Melhorias e novidades da verso................................................................................................2 Integrao com Zenvia ................................................................................................................3 Permitir que facetas apresentem apenas variaes disponveis................................................8 Financiamento pela loja virtual.................................................................................................12 Debug de promoes no carrinho ............................................................................................17 Contador global de boleto por gateway de pagamento ...........................................................20 Gravar perfil de filtros por usurio *.........................................................................................21 Integrao de preo de brindes no ERP bacos .......................................................................25 Melhorias nas promoes de desconto progressivo................................................................26 Histrico de navegao por cookie ...........................................................................................29 Ajuste para Bing seguir links de paginao de forma correta ..................................................30 Melhorias na funcionalidade de invalidao de cache no admin.............................................31 Disponibilizar informaes de condies de pagamento nas promoes *.............................32 Melhorias para produtos KIT.....................................................................................................33 Melhorias no processo de invalidao automatizada de cache ...............................................35
3. 3. 2COREDocumentaode verso 2.4 Melhoriase novidades daverso Novidades Integrao com Zenvia Permitir que facetas apresentem apenas variaes disponveis Financiamento pela loja virtual Debug de promoes no carrinho Contador global de boleto por gateway de pagamento Gravar perfil de filtros por usurio * Integrao de preo de brindes no ERP bacos Melhorias Melhorias nas promoes de desconto progressivo Histrico de navegao por cookie Ajuste para Bing seguir links de paginao de forma correta Melhorias na funcionalidade de invalidao de cache no admin Disponibilizar informaes de condies de pagamento nas promoes * Melhorias para produtos KIT Melhorias no processo de invalidao automatizada de cache
4. 4. 3COREDocumentaode verso 2.4 IntegraocomZenvia A integrao possibilitar incluir a um fluxo de trabalho do Core (workflow) a tarefa de envio de SMS utilizando os servios da Zenvia. As mensagens podero ser configuradas atravs de um template de email utilizando os mesmos contextos j disponveis. Tambm poder ser definido uma faixa de horrios em que os disparos sero permitidos evitando assimque o cliente receba mensagens em horrios indevidos.
5. 5. 4COREDocumentaode verso 2.4 Instalao / Ativao 1. SistemaAdministrativo Por se tratar de um plugin, necessrio solicitar a ativao do mesmo para o suporte. 1.1. Configurandoos dados Aps o plugin estar habilitado, estar disponvel no menu Integraes a opo Configurar Zenvia (Plugin). No painel do sistema administrativo: Integraes -> Configurar Zenvia (Plugin) Na mesma telatemos abaixo os campos de configurao da mensagemonde possveldefinir o nome do remetente que aparecer no SMS e tambm as faixas em que ser permitido o envio. Caso o fluxo execute em um horrio no permitido a mensagem ser automaticamente agendada para ser entregue no primeiro horrio disponvel.
6. 6. 5COREDocumentaode verso 2.4 As configuraes podem ser feitas por grupo de configuraes e devero conter obrigatoriamente a Conta e a Senha fornecidos pela Zenvia. 1.2. Configurandoo template damensagem A mensagem do SMS ser configurada atravs de um template de email que posteriormente ser vinculado ao fluxo desejado. No painel do sistema administrativo: Aparncia -> Templates de email O campo assunto apesar de obrigatrio ao criar um novo template de email no ser usado no SMS. Tendo em vista que no ser possvel reproduzir tags HTML nas mensagens do SMS e que cada mensagem tem limite de 160 caracteres (conforme documentao), sugerimos no momento da configurao 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 Contedo. O campo Contexto dever estar configurado como Pedidos de Compra.
7. 7. 6COREDocumentaode verso 2.4 1.3. Configurando um fluxo Ao criar ou editar as tarefas de um fluxo, estar disponvel a opo (Zenvia) Enviar SMS. Ao editar a tarefa, possvel definir um template de email previamente configurado, que ser o contedo da mensagem do SMS.
8. 8. 7COREDocumentaode verso 2.4 Utilizao O nicomeiode utilizao dentrode umfluxo,comomostradoanteriormente.Dependendodo fluxoescolhido,estepoderserexecutadomanualmenteouatravsde umatarefaagendada. importante salientarque osenviossobaseadosnometadadode cliente Celular,casoo mesmo no possuaestainformaoa tarefado fluxonoenviaramensagemde SMS para este cliente.
9. 9. 8COREDocumentaode verso 2.4 Permitirque facetas apresentemapenas variaesdisponveis A insero de uma nova configurao na administrao do sistema permitir que o cliente possa configurar a exibio ou no de variaes de produtos que no estejammais disponveis na loja, da mesma forma que atualmente possvel fazer a mesma configurao para produtos indisponveis.
10. 10. 9COREDocumentaode verso 2.4 Configurao Dentrodas opesde Produtos > Listagens,foi adicionadaa configurao Exibirvariaessem estoque aofacetar,para que o cliente possavisualizarvariaesindisponveisnaslistagensdosite no momentoque ousuriorealizar umfacetamento.A mesmaconfiguraopode serrealizadapara as pesquisas,em Produtos> Pesquisa. No painel do sistema administrativo: Configs -> Configuraes gerais
11. 11. 10COREDocumentaode verso 2.4 Utilizao No site,entrandoemalgumacategoriadisponvel,podemosvisualizarque,parao exemploabaixo,o produtoemquestocontmvariaesdisponveis(azul) e indisponveis(verde),masmesmoassim ele retornadona listagem,umavezque foi configuradoparaexibirvariaessemestoque ao facetar.
12. 12. 11COREDocumentaode verso 2.4 Ao configurarparaque as variaesindisponveisno sejammaisexibidasaorealizarofacetamento, o produtodesaparece dalistagemcasoa facetaselecionada(nocasoa verde) estejaindisponvel no site. No painel do sistema administrativo: Configs -> Configuraes gerais
13. 13. 12COREDocumentaode verso 2.4 Financiamentopela lojavirtual O cliente teragorauma nova formade pagamentochamadaFinanciamento.Esse mtodode pagamentohabilitarumformulriocustomizadoparasolicitarinformaesaoclientefinal, mediante algumasconfiguraesnosistemaadministrativo.
14. 14. 13COREDocumentaode verso 2.4 Configurao 2. SistemaAdministrativo 2.1. Configurandoos Metadados Foi adicionada uma nova entidade para criao de metadados, chamada Forma de Pagamento. Entrando em Configs > Metadados, insira todos os metadados que sejam necessrios o cliente preencher no site (essas informaes sero utilizadas para gerar o formulrio de financiamento no site). Para cada metadado criado, diversas opes podero ser configuradas, dependendo da necessidade de cada cliente, como: - Obrigatoriedade da informao - Tamanho do campo - Tipo de dado - Entre outros.
15. 15. 14COREDocumentaode verso 2.4 2.2. Configurandoa Forma de Pagamento Financiamento Entre em Configs > Meios de Pagamento e, caso ainda no exista na listagem, insira uma nova forma de pagamento clicando em e escolha o Fornecedor do Servio como Financiamento. Aps inserir as informaes gerais sobre a forma de pagamento, na aba Personalizados ser possvel 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. 16. 15COREDocumentaode verso 2.4 Utilizao No momento de finalizar um pedido no site, caso esteja ativo na administrao, o cliente poder selecionar o meio de pagamento Financiamento, e preencher as informaes cadastradas para esse meio de pagamento. As validaes e obrigatoriedades de campos respeitaro as configuraes realizadas no sistema administrativo, nos metadados.
17. 17. 16COREDocumentaode verso 2.4 Fechamento do pedido De voltaao sistemaadministrativo,entrandoemBackoffice >Pedidose selecionandoopedidoque acabou de ser finalizado,asinformaesde financiamentopoderoservisualizadasnaaba Pagamento.
18. 18. 17COREDocumentaode verso 2.4 Debugde promoes nocarrinho Criamosuma ferramentaque auxiliarnoentendimentode que promoesestosendoaplicadas emum determinadocarrinho.A partirde uma rota determinadanopadro http://www.sualoja.com.br/carrinho/debug,voc poderacessare verificarquaispromoesforam ou no aplicadas,sobrescritasouanuladas.A ferramentaapresentartambmaspromoesna ordememque foram executadase separadasporgrupode promoo.
19. 19. 18COREDocumentaode verso 2.4 Configurao Essa rota ter restrio de IPS para controle de acesso, caso no consiga acess-la, favor entrar em contato com a equipe de suporte para que possamos cadastrar o seu IP.
20. 20. 19COREDocumentaode verso 2.4 Utilizao As promoes sero separadas por grupo, e listadas na ordem em que foram aplicadas. Est disponvel uma legenda (Aplicada, Anulada, No aplicada), para melhor entendimento da execuo das promoes. Aplicada significaque a promoo passou por todas as condies e foi executada. Anulada significaque a promoo foi sobrescrita por outra por regra de exclusividade. No aplicada significaque a promoo no atendeu a todas as condies. Acesse a seguinte url: http://www.sualoja.com.br/carrinho/debug
21. 21. 20COREDocumentaode verso 2.4 Contadorglobalde boletoporgatewayde pagamento Foi realizada a possiblidade de configurao para que as somas dos identificadores de boleto genricos possam ser contadas de forma global. Por exemplo, se voc possui boleto genrico Ita e Bradesco, ambos os identificadores (Nosso Nmero), iro seguir a contagem global. * Se voc deseja essa funcionalidade, entre em contato com o suporte tcnico para solicitar a configurao.
22. 22. 21COREDocumentaode verso 2.4 Gravarperfilde filtros porusurio* Widget criado especialmente para o auxlio na compra de peas de vesturio, onde armazena as medidas para que possa ser utilizado para indicar o tamanho ideal ao cliente. * Widget disponvel apenas para clientes que contrataram previamente o servio. Para solicitar a instalao preciso fazer requisio atravs do canal do suporte.
23. 23. 22COREDocumentaode verso 2.4 Instalao A instalao pode ser feita de duas maneiras, pelo gerenciador de Widgets, no editor de layout: Ou pelo editor de arquivo: {% profile_body_measure() %}
24. 24. 23COREDocumentaode verso 2.4 Parmetros Title: Ttulo do boto ModalTitle: Ttulo da modal ModalSubmit: Boto, salvar dados SubmitSuccess: Menssagem, salvo comsucesso SubmitError: Menssagem, erro ao salvar SaveProfile: Label: opo para salvar informaes no perfil Fields: Campos do metadados mostrados no form (Busto, Cintura, Quadril, Bojo) Metadados: Os campos utilizados pelo Widget so configurados pelo painel de metadados no admin (Configs > Metadados). A entidade para os campos devem ser Cliente Pessoa Fsica. No necessrio que o campo seja configurado como visvel no site, ele se torna visvel com o parmetro Fields do prprio Widget. Note que o Nome do campo deve ser igual ao configurado no Widget. No recomendado que o campo seja definido como obrigatrio.
25. 25. 24COREDocumentaode verso 2.4 A dica de cadastramento utilizada como sufixo para o input, utilize definies de medidas como cm. Customizaes: O Widget possui uma nova forma de customizao 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 esto disponveis para serem customizadas. wd.profile.body.measures.template Templates/button.template Templates/input.template Templates/mannequin.template O CSS para o Widget no includo automaticamente e neste caso necessrio que seja includo atravs 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 obrigatrio a customizao 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.
26. 26. 25COREDocumentaode verso 2.4 Integraodepreode brindesnoERPbacos Para clientes que utilizam o ERP bacos adicionamos uma melhoria que preenche o valor da DANFE - Documento Auxiliar da Nota Fiscal Eletrnica (NF-e) de forma correta para os preos dos produtos brindes na integrao de pedidos.
27. 27. 26COREDocumentaode verso 2.4 Melhoriasnas promoesde descontoprogressivo Adicionamos novas propriedades nas seguintes promoes de desconto progressivo: Promoes em pedidos Desconto progressivo Promoes em pagamento Desconto progressivo em meios de pagamento Foram adicionados filtros de produtos inclusivos e negados e uma nova opo de tipo de desconto Por faixa de quantidade do mesmo produto. Esses novos critrios permitem que o lojista faa uma regra para um grande nmero de produtos semgrande esforo.
28. 28. 27COREDocumentaode verso 2.4 Configurao 1. SistemaAdministrativo 1.1. Configurandopromoes (Condies e Benefcios) Para cada tipo de promoo com desconto progressivo diversas opes podero 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 devero receber a promoo Lista de produtos que no devero receber a promoo No painel do sistema administrativo: Marketing -> Promoes
29. 29. 28COREDocumentaode verso 2.4 2. Listade produtos possvel definir uma lista que dever receber as promoes, assimcomo a lista de produtos que no devero receber as promoes. No painel do sistema administrativo: Marketing -> Promoes
30. 30. 29COREDocumentaode verso 2.4 Histricode navegao porcookie Alteramos a forma de armazenamento da funcionalidade de histrico de navegao. A partir de agora as informaes sero gravadas atravs de cookies, o que possibilita a exibio dos itens visitados (produtos, categorias e buscas) por mais tempo e com menos uso de recursos do servidor.
31. 31. 30COREDocumentaode verso 2.4 AjusteparaBingseguir linksdepaginaode formacorreta Foi efetuada uma melhoria na marcao do html gerado para os resultados de busca de produtos de modo que o buscador bing consiga reconhecer corretamente os paginadores dessas pginas. Esta alterao foi necessria devido ao bing utilizar uma forma diferente do google e outros buscadores.
32. 32. 31COREDocumentaode verso 2.4 Melhoriasna funcionalidadede invalidaodecache noadmin Foram realizadas melhorias de interface e usabilidade na tela de Invalidao de Cache no Admin. As melhorias consistem em: Quantidade de proxys e clusters visveis Respostas mais amigveis para as aes de acordo com cada proxy ou cluster Unificao de aes Reduo no nmero de botes No painel do sistema administrativo: Configs -> Invalidao de Cache
33. 33. 32COREDocumentaode verso 2.4 Disponibilizar informaesde condies de pagamentonas promoes* Adicionamos ao contexto do site algumas informaes como as condies de meios de pagamentos configurados nas promoes, de forma a esta poder ser utilizada atravs do sistema de templates nas pginas de checkout do Core. Com esta implementao podemos apresentar a forma que est dando o desconto (boleto/carrinho, etc.) no checkout. Esta informao estar disponvel atravs dos componentes de checkout no seguinte mtodo: * Widget disponvel apenas para clientes que contrataram previamente o servio. Para solicitar a instalao preciso fazer requisio atravs do canal do suporte. {% Basket.BasketPayment %}
34. 34. 33COREDocumentaode verso 2.4 Melhoriaspara produtosKIT Foram realizadas melhorias na apresentao de produtos do tipo KIT, dentre eles, ajuste no clculo de frete, contexto com as imagens dos produtos internos e apresentao do produto no mobile.
35. 35. 34COREDocumentaode verso 2.4 Instalao / Ativao 3. Configuraodo KIT necessrio o cadastro adequado dos produtos do tipo KIT e a associao das medias dos produtos KIT e seus produtos associados. Importante: Caso a loja nunca utilizou este tipo de produto ou possui uma customizao, necessria a realizao dos ajustes pertinentes para apresentao da funcionalidade em concordncia com o layout da loja.
36. 36. 35COREDocumentaode verso 2.4 Melhoriasnoprocesso de invalidao automatizadade cache Foram realizadas melhorias na invalidao de caches de output automatizado da plataforma, mais especificamente, nas invalidaes relacionadas a alteraes em banners, alteraes em templates e alteraes em assets (css, js).
37. 37. 36COREDocumentaode verso 2.4 Funcionamento 1. Processode invalidaode cache O processo realizado para invalidao de cache no imediato, podendo levar at 2 minutos, pois so necessrios processamentos para determinar as pginas (urls) que devem receber a invalidao. Cada pgina 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 contedo. Quando identificada alguma alterao em um recurso vinculado, so determinadas as tags que devem ser invalidadas. 2. Processode invalidaode cache para banners O processo de invalidao de cache para banners so vinculados pelas posies de banner utilizadas na pgina. Este vinculo s acontece quando utilizado o widget de banners marketing_banner, sendo imprescindvel a sua utilizao. Alm disso, as imagens dos banners so enviadas para o CDN e so entregues no domnio com formato http://xxxxxxxxxxxxx.cloudfront.net/. Estas imagens enviadas ao CDN nunca so invalidadas. Ao alterar a imagem de um banner pela administrao 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 invalidao da imagem adicionando um parmetro querystring na imagem para que seja considerado como uma nova imagem. 3. Processode invalidaode cache para templates O processo de invalidao de cache para templates realizado pelo vinculo dos caminhos dos arquivos utilizados na pgina. Este vinculo acontece automaticamente durante a entrega do contedo pelo servidor. Ao alterar um template pelo gerenciador de arquivos ou configurao de design na administrao da plataforma o processo de invalidao iniciado. 4. Processode invalidaode cache para assets (css, js) O processo de invalidao de cache para assets (css, js) realizado por vnculos automaticamente gerados durante a entrega do contedo pelo servidor.
38. 38. 37COREDocumentaode verso 2.4 Ao alterar um arquivo de estilos ou de script pelo gerenciador de arquivos ou pelo gerenciador de recursos na administrao da plataforma o processo de invalidao iniciado. Importante perceber que estes recursos so combinados e minificados em um nico arquivo e entregues pelo CDN. Estes recursos entregues pelo CDN nunca so invalidados. Ao realizar a alterao em um arquivo, gerada uma nova hash para o arquivo combinado. Isto permite que o CDN automaticamente entregue o contedo mais atual e o cache no navegador do cliente tambm automaticamente atualizado.