Pular para o conteúdo principal
Quando um visitante acessa uma URL, a AllBay identifica o tipo de página, carrega os dados relevantes e renderiza o arquivo correspondente, com as variáveis globais mais as variáveis específicas daquela página.

Mapa de rotas

Os nomes seguem os aliases de resolução: a rota de produto aceita package ou product, coleção aceita category ou collection, checkout aceita checkout ou cart, 404 aceita not-found ou 404.
Os produtos das listas não são paginados no servidor: home, /products e busca trazem até 100; a coleção traz até 50, e só as 24 primeiras categorias vêm com produtos. Para paginar ou buscar o resto, use {% load "packages", category_id: category.id, page: query.page %} (ver Tags).

Busca

Na rota /search, o servidor entrega o catálogo (até 100 produtos) e filtra por ?category_id= e ?current_package= (remove esse produto da lista). O filtro de texto (?q=) é aplicado no navegador pelo tema/SDK. A página não é indexada por buscadores.

Página não encontrada (404)

  • Uma rota inexistente renderiza a sua página 404 com status HTTP 404 (não indexada).
  • Um produto inexistente também cai na página 404 (pathname = /404).
  • Uma coleção inexistente (/collections/x) renderiza a página de coleção vazia.
  • Um post inexistente renderiza a página de post sem post.
Sem página 404 no tema, o visitante recebe um 404 simples da plataforma.

Pedido e pagamento

/order/:id e /payment/:id não exigem login: abrem com a sessão do cliente ou com o link do pedido (que traz o token de acesso). Sem acesso, order fica vazio e allowed é false — mostre uma mensagem nesse caso.
Quando o pagamento já foi aprovado, /payment/:id redireciona para /order/:id.

Login é sempre da plataforma

A página /login não é renderizada pelo tema. Ao acessar /login, o visitante vai para a tela de login da AllBay e volta logado. Um pages/login.liquid no tema é ignorado. A área do cliente (/account*) é renderizada pelo tema, mas exige login: sem sessão, o visitante é levado ao login.

Manutenção

Não existe página de manutenção separada. Quando a loja está pausada, store.maintenance é true e o catálogo vem vazio — trate isso no seu layout:

Layouts

Há duas formas de envolver as páginas:
  • Layout automático: crie layouts/base.liquid com {{ content_for_layout }} onde a página deve entrar. Toda página é renderizada dentro dele.
  • Layout declarado: a página começa com {% layout 'layouts/layout' %} e o conteúdo dela entra no {% block %}{% endblock %} do layout — é o que o Vega usa. Ver Tags.
Se alguma página do tema usa {% layout %}, toda página que não declarar um layout é entregue sem <html>/<head> (como fragmento). Em temas com layout declarado, declare o layout em todas as páginas.