# DataFirefly Product Order: guia completo > Guia completo de instalação, configuração e utilização do DataFirefly Product Order para ordenar os seus produtos WooCommerce por arrastar e largar. - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/datafirefly-product-order/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-product-order/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-product-order/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-product-order/index.md), [it](https://www.datafirefly.com/it/documentation/datafirefly-product-order/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-product-order/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-product-order/index.md) - Índice: 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**. Requer WordPress 6.4 ou superior, PHP 8.0 ou superior e WooCommerce 7.0 ou superior. Compatível com HPOS (armazenamento de encomendas de alto desempenho), multisite e multilingue. Sem dependências do Composer e sem serviços externos. ## 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». Para um resultado visível de imediato, verifique que a ordenação predefinida da sua loja é mesmo «Ordenação predefinida» (Definições do WooCommerce → Produtos → Apresentação), e não uma ordenação por data ou por preço. ## 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. A lista carrega até 200 produtos por âmbito, o que é largamente suficiente para ordenar uma categoria. Numa loja muito grande, prefira a ordenação categoria a categoria em vez da vista global. ## 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. Defina primeiro uma ordem global limpa e depois afine categoria a categoria apenas onde for necessário. Os produtos sem posição numa categoria colocam-se automaticamente depois dos que têm posição, seguindo a ordem global e depois o título. ## 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. A regra atua na apresentação: não altera a ordem que gravou. Desative o interruptor para voltar a uma classificação estritamente manual. ## 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.