Esta documentação serve como guia para as agências parceirtas Wake que desejam migrar lojas do Storefront 1.0 para o Storefront 2.0 com base na estrutura atualizada da branch checkout-ssrdo repositório awake.

👍

Dica:

Recomendamos que a migração seja feita de forma automatizada pela interface do admin da loja, a fim de reduzir ao máximo o trabalho manual e a propensão ao erro. Saiba mais sobre o processo de migração automatizado aqui .

Passo a passo da migração

1. Arquivos obrigatórios a serem copiados

Copiar todos os arquivos listados abaixo da branch checkout-ssr de awake para o projeto da loja:

📁 Pages
Pages/account/

Pages/checkout/

Pages/login/

Pages/partner/

📁 Queries
Queries/account/

Queries/checkout/

Queries/login/

Queries/partner/

📁 CSS
Assets/CSS/output_base.css_

Assets/CSS/output_account.css

Assets/CSS/output_checkout.css

Assets/CSS/output_login.css

Assets/CSS/output_partner.css

Assets/CSS/input_base.css

Assets/CSS/input_account.css

Assets/CSS/input_checkout.css

Assets/CSS/input_login.css

Assets/CSS/input_partner.css

📁 Imagens
Copiar todas as imagens do diretório:

Assets/Img/icons/

2. Atualizar arquivos de configuração

Configs/pages.json
Copiar as configurações de páginas de checkout (rotas e templates).

Configs/settings.json

Adicione a propriedade:

"wake_components_version": "v1"

3. Atualizar SDK do Storefront

No arquivo Components/sdk_client.html ou Components/utils/sdk_client.html, substituir o Storefront SDK antigo pelo SDK Full (entenda mais sobre SDK Full aqui)

<script src="https://static.fbits.net/storefront-sdk/latest/storefront-sdk-full.min.js?theme={{- store.theme -}}&v={{- store.last_modified -}}"></script>

Validação e testes

• Use o preview da loja para testar todas as páginas migradas.

❗️

Importante!

O Storefront 2.0 aceita apenas conectores de pagamento tokenizados

🚨

Ação Imediata Necessária: Ajuste de URLs Pós-Migração

Após a finalização da migração dos arquivos e dos ajustes de layout, é obrigatório abrir um ticket de configuração junto à Wake.

Este procedimento é essencial para atualizar os parâmetros de redirecionamento de links em áreas críticas, como: Páginas de Minha Conta, E-mails Transacionais e outros URLs sistêmicos.

Risco: A falta de abertura deste ticket resultará no direcionamento desses links para o checkout antigo, podendo causar falhas operacionais e problemas na jornada do cliente.