Obtendo dados - CentralCart

A tag load permite carregar dados dinâmicos da loja diretamente nos templates. Os dados carregados ficam disponíveis como variáveis na página.

Sintaxe

<% load nome_da_entidade argumento: valor, outro_argumento: valor %>

Após o carregamento, os dados ficam disponíveis na variável com o mesmo nome da entidade. Por exemplo, <% load posts %> cria a variável posts.

Entidades disponíveis

affiliate

Carrega os dados do programa de afiliados do cliente autenticado.

<% load affiliate %>

<% if affiliate %>
  <p>Código: <%= affiliate.code %></p>
  <p>Comissão: <%= affiliate.commission %>%</p>
<% endif %>

affiliate_settings

Carrega o status e configurações do programa de afiliados da loja.

<% load affiliate_settings %>

<% if affiliate_settings.active %>
  <a href="/affiliate">Programa de Afiliados</a>
<% endif %>

orders

Carrega os pedidos do cliente autenticado com paginação e filtros. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`page`	number	`1`	Número da página
`limit`	number	`20`	Itens por página
`detailed`	boolean	`false`	Incluir dados detalhados (pacotes com meta, entregas, anotações, variáveis)
`status`	string	—	Filtro por status, separado por vírgula (ex: `"APPROVED,PENDING"`)

<% load orders page: 1, limit: 10, detailed: true %>

<% if orders.data.size > 0 %>
  <% for order in orders.data %>
    <div class="order">
      <span>Pedido #<%= order.internal_id %></span>
      <span>Status: <%= order.status %></span>
      <span>Total: <%= order.price | format_price %></span>
    </div>
  <% endfor %>

  <!-- Paginação -->
  <p>Página <%= orders.meta.current_page %> de <%= orders.meta.last_page %></p>
<% else %>
  <p>Nenhum pedido encontrado.</p>
<% endif %>

Filtro por status:

<!-- Apenas pedidos aprovados e pendentes -->
<% load orders status: "APPROVED,PENDING", limit: 5 %>

A tag orders requer que o cliente esteja autenticado. Se não estiver logado, nenhum dado será carregado.

feedbacks

Carrega as configurações de avaliações da loja e, opcionalmente, a lista de avaliações públicas e a avaliação do pedido atual. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`list`	boolean	`false`	Carrega a lista de avaliações públicas em `feedbacks`
`limit`	number	`30`	Quantidade de avaliações (quando `list: true`)
`order_id`	string	—	`internal_id` do pedido (padrão: pedido do contexto atual)

Variáveis criadas:

feedback_settings — configurações de avaliação da loja
feedbacks — lista de avaliações públicas (apenas com list: true). Cada item: rating, message, client_name, created_at, date_label, product (id, name, image, slug)
order_feedback — avaliação do pedido atual, se houver (pedido aprovado)

<% load feedbacks list: true, limit: 6 %>

<% for feedback in feedbacks %>
  <div class="review">
    <strong><%= feedback.client_name %></strong>
    <span>★ <%= feedback.rating %></span>
    <p><%= feedback.message %></p>
    <small><%= feedback.date_label %></small>
  </div>
<% endfor %>

package_feedbacks

Carrega as avaliações de um produto específico, junto com um resumo estatístico. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`package_id`	number	—	ID do pacote (padrão: pacote do contexto atual)
`limit`	number	`100`	Quantidade de avaliações

Variáveis criadas:

feedback_settings — configurações de avaliação da loja
package_feedback_summary — resumo: total, average, average_label, average_rounded, distribution (lista de stars, count, percent)
package_feedbacks — lista de avaliações. Cada item: rating, message, client_name, date_label

<% load package_feedbacks limit: 10 %>

<% if package_feedback_summary %>
  <p>
    Nota média: <%= package_feedback_summary.average_label %>
    (<%= package_feedback_summary.total %> avaliações)
  </p>
<% endif %>

<% for feedback in package_feedbacks %>
  <div class="review">
    <span>★ <%= feedback.rating %></span>
    <p><%= feedback.message %></p>
  </div>
<% endfor %>

user_spent

Carrega o total gasto por um cliente (somatório dos pedidos aprovados). Pelo menos um dos parâmetros deve ser informado. Parâmetros:

Parâmetro	Tipo	Descrição
`client_email`	string	E-mail do cliente
`client_identifier`	string	Identificador do cliente

Variáveis criadas:

user_spent — total_net_received (líquido) e total_gross_received (bruto)

<% load user_spent client_email: user.email %>

<% if user_spent %>
  <p>Total gasto: <%= user_spent.total_gross_received | format_price %></p>
<% endif %>

checkout_fields

Carrega as variáveis customizadas configuradas para o checkout da loja.

<% load checkout_fields %>

<% for field in checkout_fields %>
  <div class="field">
    <label><%= field.name %></label>
    <input type="text" name="<%= field.identifier %>" />
  </div>
<% endfor %>

packages

Carrega os pacotes (produtos) da loja com filtros e paginação. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`page`	number	`1`	Número da página
`limit`	number	`10`	Pacotes por página
`category_id`	number \| `"all"`	—	Filtra por categoria. Use `"all"` para listar apenas pacotes com categoria definida
`q`	string	—	Busca pelo nome do pacote
`search_category`	boolean	`false`	Quando usado junto com `q`, também busca por nome de categoria
`include_variations`	boolean	`false`	Inclui variações na listagem (por padrão retorna apenas pacotes principais)
`order_by`	string	`position:asc`	Ordenação. Formato: `coluna:direção` (ver tabela abaixo)

Valores aceitos em order_by:

Coluna	Descrição
`created_at`	Data de criação
`price`	Preço
`sales_count`	Número de vendas

A direção pode ser asc (crescente) ou desc (decrescente). Exemplo: price:desc ordena do mais caro para o mais barato.

<% load packages page: 1, limit: 12, order_by: "sales_count:desc" %>

<div class="products">
  <% for package in packages.data %>
    <a href="/package/<%= package.slug %>" class="product-card">
      <img src="<%= package.image %>" alt="<%= package.name %>" />
      <h3><%= package.name %></h3>
      <span><%= package.pricing.price | format_price %></span>
    </a>
  <% endfor %>
</div>

package

Carrega um produto específico por slug ou ID, com variações e campos completos. Parâmetros:

Parâmetro	Tipo	Descrição
`slug`	string	Slug do produto
`id`	number	ID do produto

Pelo menos um dos parâmetros (slug ou id) deve ser informado. Diferente de packages, esta tag carrega um único produto na variável package (não uma lista paginada), incluindo variations e fields.

<% load package slug: "vip-inicial" %>

<% if package %>
  <div class="product">
    <img src="<%= package.image %>" alt="<%= package.name %>" />
    <h1><%= package.name %></h1>
    <p><%= package.description %></p>
    <span><%= package.pricing.price | format_price %></span>

    <% for variation in package.variations %>
      <button data-id="<%= variation.id %>">
        <%= variation.name %> — <%= variation.pricing.price | format_price %>
      </button>
    <% endfor %>
  </div>
<% endif %>

posts

Carrega os posts do blog da loja com paginação. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`page`	number	`1`	Número da página
`limit`	number	`20`	Posts por página

<% load posts page: 1, limit: 6 %>

<div class="blog">
  <% for post in posts.data %>
    <article>
      <h2><a href="/post/<%= post.slug %>"><%= post.title %></a></h2>
      <p><%= post.description %></p>
    </article>
  <% endfor %>

  <p>Página <%= posts.meta.current_page %> de <%= posts.meta.last_page %></p>
</div>

post

Carrega um post específico do blog por ID ou slug. Parâmetros:

Parâmetro	Tipo	Descrição
`id`	number	ID do post
`slug`	string	Slug do post

Pelo menos um dos parâmetros (id ou slug) deve ser informado.

<% load post slug: "como-comprar" %>

<% if post %>
  <article>
    <h1><%= post.title %></h1>
    <div><%= post.content %></div>
  </article>
<% endif %>

Carrega um widget específico e seus dados. Os dados variam conforme o tipo do widget. Parâmetro obrigatório:

Parâmetro	Tipo	Descrição
`type`	string	Tipo do widget (case-insensitive)

Tipos disponíveis:

PRODUCT_HIGHLIGHT

Destaque de produto. Retorna os dados completos do pacote configurado.

<% load widget type: "PRODUCT_HIGHLIGHT" %>

<% if widget.package_highlight %>
  <div class="highlight">
    <img src="<%= widget.package_highlight.image %>" />
    <h2><%= widget.package_highlight.name %></h2>
    <span><%= widget.package_highlight.price | format_price %></span>
  </div>
<% endif %>

MONTH_GOAL

Meta mensal de faturamento.

<% load widget type: "MONTH_GOAL" %>

<% if widget.month_goal %>
  <div class="goal">
    <p>Meta: <%= widget.month_goal.goal | format_price %></p>
    <p>Atual: <%= widget.month_goal.current | format_price %></p>
    <div class="bar" style="width: <%= widget.month_goal.percentage %>%"></div>
  </div>
<% endif %>

TOP_DONATORS

Ranking dos maiores compradores em um período. Por padrão, lista os 5 maiores do mês atual. Parâmetros:

Parâmetro	Tipo	Padrão	Descrição
`from`	string (data)	início do mês atual	Data inicial do período (ex: `"2026-01-01"`)
`to`	string (data)	fim do mês atual	Data final do período (ex: `"2026-03-31"`)
`limit`	number	`5`	Quantidade de compradores. Máximo: `10`

O intervalo entre from e to é limitado a no máximo 3 meses. Se to ultrapassar from + 3 meses, a data final é ajustada automaticamente. O limit é travado em no máximo 10.

<% load widget type: "TOP_DONATORS", from: "2026-01-01", to: "2026-03-31", limit: 10 %>

<% if widget.top_donators %>
  <ol>
    <% for donator in widget.top_donators.data %>
      <li>
        <span><%= donator.name %></span>
        <% if widget.top_donators.show_amount %>
          <span><%= donator.amount | format_price %></span>
        <% endif %>
      </li>
    <% endfor %>
  </ol>
<% endif %>

CONNECTION_BOARD

Quadro de conexão (ex: IP de servidor de jogo).

<% load widget type: "CONNECTION_BOARD" %>

<% if widget.connection_board %>
  <div class="connect">
    <p>Conecte-se: <code><%= widget.connection_board.address %></code></p>
  </div>
<% endif %>

DISCORD

Widget de Discord. Retorna o ID do servidor para integração.

<% load widget type: "DISCORD" %>

<% if widget.discord %>
  <iframe
    src="https://discord.com/widget?id=<%= widget.discord.server_id %>&theme=dark"
    width="350"
    height="500"
    frameborder="0"
  ></iframe>
<% endif %>

Se você tiver qualquer dúvida, entre em contato com a nossa equipe de suporte em nosso WhatsApp e Discord.

​Sintaxe

​Entidades disponíveis

​affiliate

​affiliate_settings

​orders

​feedbacks

​package_feedbacks

​user_spent

​checkout_fields

​packages

​package

​posts

​post

​widget

​PRODUCT_HIGHLIGHT

​MONTH_GOAL

​TOP_DONATORS

​CONNECTION_BOARD

​DISCORD

Sintaxe

Entidades disponíveis

affiliate

affiliate_settings

orders

feedbacks

package_feedbacks

user_spent

checkout_fields

packages

package

posts

post

widget

PRODUCT_HIGHLIGHT

MONTH_GOAL

TOP_DONATORS

CONNECTION_BOARD

DISCORD