DataFirefly Product Order: guia completo

O DataFirefly Product Order acrescenta uma página de administração dedicada para definir, por simples arrastar e largar, a ordem de apresentação dos seus produtos WooCommerce. Pode fixar uma ordem global para toda a loja ou uma ordem independente para cada categoria. A ordem personalizada só se aplica no front-end quando o cliente usa a ordenação predefinida: as ordenações por preço, popularidade ou avaliação ficam intactas. Este guia cobre a instalação, o ecrã de ordenação, a diferença entre ordem global e ordem por categoria, a aplicação no front-end, a regra «esgotados no fim», o desempenho, a compatibilidade e a resolução de problemas.

Instalação

1. Descarregue o arquivo df-product-order.zip a partir da sua conta DataFirefly.
2. Back-office do WordPress → Plugins → Adicionar → Carregar plugin → envie o ZIP e depois Ativar.
3. Na ativação, a extensão cria a sua tabela de posições (wp_dfpord_order) e acrescenta a entrada Produtos → Ordem dos produtos.

Primeiros passos em dois minutos

1. Abra Produtos → Ordem dos produtos.
2. No menu Âmbito, deixe «Ordem global (loja)» ou escolha uma categoria.
3. Arraste e largue os produtos na ordem pretendida com a pega situada à esquerda de cada linha. Cada movimento é gravado automaticamente.
4. Visite a sua loja: os produtos aparecem na nova ordem assim que a ordenação ativa for a «predefinida».

O ecrã «Ordem dos produtos»

Toda a gestão é feita em Produtos → Ordem dos produtos. O ecrã tem uma barra de ferramentas e a lista ordenável.

Barra de ferramentas

• Âmbito: escolha «Ordem global (loja)» ou uma categoria de produtos concreta. Mudar de âmbito recarrega a lista correspondente.
• Pesquisar: filtra a lista pelo nome do produto, útil para encontrar rapidamente um artigo numa categoria grande.
• Produtos esgotados no fim: interruptor que ativa a regra automática do lado da loja (ver mais abaixo). O seu estado é gravado assim que o altera.

Lista ordenável

Cada linha mostra uma pega de deslocação, a miniatura do produto, o nome (com um distintivo Esgotado quando for o caso) e o preço. Agarre numa linha pela pega, desloque-a e largue: a ordem é guardada em segundo plano e uma mensagem «Ordem guardada» confirma a operação.

Ordem global ou ordem por categoria

Os dois âmbitos são independentes e coexistem sem conflitos.

Ordem global (loja)

Define a ordem usada na página da loja e em qualquer lado onde os produtos sejam apresentados sem contexto de categoria. Para se manter compatível com o seu tema e as suas outras extensões, a ordem global sincroniza o campo nativo menu_order de cada produto.

Ordem por categoria

Cada categoria conserva a sua própria ordem, guardada na tabela dedicada wp_dfpord_order. Um mesmo produto pode assim aparecer no topo de uma categoria e mais abaixo noutra. Esta ordem aplica-se nas páginas de arquivo de categoria de produtos.

Aplicação no front-end

A ordem personalizada nunca substitui a escolha de ordenação dos seus visitantes. Aplica-se apenas quando a ordenação ativa é a ordenação predefinida da loja. Assim que um cliente seleciona «Ordenar por preço», «por popularidade» ou «por avaliação média», a escolha dele prevalece e a ordem personalizada é ignorada nessa página.

• Página Loja e listas sem categoria: ordem global.
• Páginas de arquivo de categoria: ordem da categoria em causa (na sua ausência, recurso à ordem global e depois ao título).

Regra «esgotados no fim»

Ativada pelo interruptor da barra de ferramentas, esta regra envia automaticamente os produtos esgotados para o fim da lista, do lado da loja, conservando a sua ordem personalizada para os produtos disponíveis. Junta-se à ordenação predefinida sem afetar as ordenações escolhidas pelo cliente.

Volume, desempenho e limites

• As posições são colocadas em cache (cache de objetos) para evitar consultas repetidas e manter as páginas da loja rápidas.
• O ecrã de administração carrega no máximo 200 produtos por âmbito; este limite pode ser aumentado por um programador, ajustando o limite de carregamento no código.
• A gravação de uma nova ordem atualiza as posições do âmbito e, na ordem global, o campo menu_order dos produtos em causa.

Compatibilidade e notas técnicas

• WordPress 6.4+, PHP 8.0 a 8.3, WooCommerce 7.0+, multisite.
• Compatibilidade HPOS (armazenamento de encomendas de alto desempenho) declarada.
• Ordem global guardada no campo nativo menu_order; ordem por categoria guardada na tabela wp_dfpord_order (chave única produto + categoria).
• Aplicação no front-end por filtragem das cláusulas de consulta, apenas na ordenação predefinida.
• Multilingue: é fornecido um modelo de tradução .pot (compatível com Polylang, WPML e Loco Translate).
• Arquitetura PSR-4 com autoloader, sem dependências do Composer nem chamadas a serviços de terceiros.

Desinstalação

A remoção da extensão a partir do ecrã de plugins executa uma limpeza completa: a tabela wp_dfpord_order é eliminada e as opções do plugin são apagadas. O campo menu_order dos produtos, sendo um dado nativo do WooCommerce, é conservado. A simples desativação não elimina qualquer dado.

FAQ e resolução de problemas

A ordem não aparece na loja. Verifique que a ordenação predefinida está selecionada (e não uma ordenação por preço ou por data). Confirme também a definição WooCommerce → Produtos → Apresentação e limpe a cache se usar uma extensão de cache de páginas.

A minha ordem por categoria não é tida em conta. Confirme que selecionou a categoria certa no menu «Âmbito» antes de ordenar, e que está a consultar a página de arquivo dessa categoria no front-end (e não a página da loja).

O arrastar e largar não reage. Force o recarregamento da página (cache do navegador) e verifique que nenhuma extensão de minificação ou de bloqueio de JavaScript impede o carregamento dos scripts de administração.

Um produto não aparece na lista. A lista está limitada a 200 produtos por âmbito e só mostra os produtos publicados. Use o campo de pesquisa, ou ordene por categoria para reduzir o volume.

Os produtos esgotados não descem. Ative o interruptor «Produtos esgotados no fim»; a regra só se aplica à ordenação predefinida, não às ordenações por preço, popularidade ou avaliação.