WP Manifestindependent plugin directory
manifest / ecommerce / woo-catalog-excel-import

WooCommerce Spreadsheet Product Importer

Importe seus produtos do Excel para o WooCommerce

by Cyfer Development · github.com/fernandocyfer/woo-catalog-excel-import · website

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/fernandocyfer/woo-catalog-excel-import/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
Readme github.com/fernandocyfer/woo-catalog-excel-import ↗

Importação e atualização em massa de produtos WooCommerce a partir de planilhas CSV ou Excel (.xlsx), com validação, relatório por linha, modelos incluídos e exportação do catálogo no mesmo formato.

Autor: Cyfer Development · Licença: GPL-2.0-or-later

Funcionalidades

Área Descrição
Produtos simples Nome, descrições, preços, stock, categorias, imagens por URL, peso e dimensões.
Variáveis e variações Linhas variavel / variacao, SKU pai, atributos globais e por variação.
SKU Identificador único: SKU existente atualiza o produto; SKU novo cria entrada.
Categorias Criação automática quando não existem; várias categorias separadas por vírgula.
Imagens Descarga a partir de URL para a biblioteca de media (erros registados sem bloquear o restante).
Relatório Resumo de criados, atualizados e erros por linha; último relatório guardado no admin.
Exportar Aba dedicada: CSV alinhado ao modelo com variações, para editar e reimportar.
HPOS Declara compatibilidade com encomendas em tabelas personalizadas (WooCommerce).

Cabeçalhos de coluna aceites em português ou inglês (mapeamento centralizado no plugin).

Requisitos

  • WordPress 6.2 ou superior
  • WooCommerce 8.0 ou superior (plugin marcado como dependência)
  • PHP 8.0 ou superior

O pacote de distribuição (ZIP) já inclui a pasta vendor/ com o PhpSpreadsheet — não é necessário Composer na loja.

Instalação

Uso normal (ZIP ou cópia completa da pasta)

  1. Envie o ZIP em Plugins → Adicionar novo → Enviar plugin, ou copie a pasta do plugin (com vendor/ dentro) para wp-content/plugins/.
  2. Ative o plugin em Plugins.
  3. Confirme que o WooCommerce está ativo.

A partir do código-fonte sem vendor/ (desenvolvimento)

Se o repositório não trouxer vendor/, na raiz do plugin execute:

composer install --no-dev --optimize-autoloader

Depois ative o plugin no WordPress.

Pacotes de release (mantenedores)

Antes de gerar o ZIP para clientes ou WordPress.org, garanta dependências de produção:

composer install --no-dev --optimize-autoloader

Inclua a pasta vendor/ no arquivo compactado.

Onde usar no admin

WooCommerce → Spreadsheet import

  • Importar — envio de .csv ou .xlsx.
  • Ajuda — modelos CSV (modelo-padrao.csv, modelo-variacoes.csv) e documentação de colunas.
  • Exportar — descarga do catálogo atual no formato compatível com a importação.

Utilização resumida

  1. Prepare a planilha com as colunas mínimas (Nome e SKU; no modelo com variações siga o ficheiro modelo).
  2. Envie o ficheiro e execute a importação.
  3. Consulte o relatório (criados / atualizados / erros).
  4. Para uma cópia editável do catálogo existente, use a aba Exportar.

Comportamento da importação

  1. Validação do ficheiro (tipo, tamanho, colunas obrigatórias).
  2. Validação linha a linha (nome, SKU, preços, stock, status, URLs de imagem quando preenchidas).
  3. Criação ou atualização de produtos com base no SKU (o tipo na loja deve corresponder: simples, variável ou variação).
  4. Opções e hooks usam o prefixo wcspi_; text domain: wc-spreadsheet-product-importer.

Desenvolvimento

  • Namespace PHP: WCSPI\
  • Estrutura principal: app/ (serviços, repositórios, validadores, helpers), views/, includes/, templates/.

Para contribuir: fork, branch por funcionalidade ou correção, e pull request com descrição clara das alterações.

Apoio e doações

Se este plugin for útil para o seu projeto, pode apoiar o desenvolvimento contínuo:

Buy Me a Coffee — Cyfer Development

O apoio ajuda a manter compatibilidade com novas versões do WordPress e WooCommerce, documentação e melhorias de qualidade.

Licença

Este projeto está licenciado sob a GNU General Public License v2.0 or later.
Consulte o ficheiro LICENSE (referência oficial) ou a cópia incluída no repositório, se existir.

Ligações