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.
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.
/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.liquidcom{{ 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.