Módulo PrestaShop de dropshipping TRAINING-DISTRIBUTION
🌐 Catálogo fonte disponível em: 
🇫🇷 Catálogo 100% francês nativo. Sem tradução automática: textos escritos diretamente em FR pelo fornecedor, ideal para lojas 🇫🇷 FR / 🇧🇪 BE / 🇨🇭 CH / 🇨🇦 CA.
💪 🏋️ 🔥
Módulo Training-Distribution Dropshipping Desporto
O módulo que automatiza de A a Z o seu dropshipping de cross-training, fitness e nutrição desportiva no PrestaShop
PrestaShop 1.7 → 9.x · 2 300 produtos · 32 marcas · 10 categorias desporto · CRON 24/7
Vai lançar uma loja de material de musculação, um site de cross-training, um e-commerce de nutrição desportiva ou de roupa desportiva? Trabalha com Training-Distribution (grossista francês especializado em Cross Training e fitness) e passa os seus dias a copiar 2 300 fichas de produto, a carregar manualmente as múltiplas fotos por produto, a recriar cada tamanho/cor como um produto distinto (porque as referências do fornecedor mudam entre tamanhos), a mapear cada categoria às secções corretas da sua árvore?
Com o Módulo Training-Distribution dropshipping desporto cross-training fitness, tudo se torna automático. Insere o URL do CSV Training-Distribution, clica em "Iniciar importação", e o módulo cria os seus 2 300 produtos PrestaShop em francês com o seu tamanho + cor no título, as suas N fotos a partir da célula única CSV, a sua referência nativa, numa árvore de 10 categorias desporto pronta a usar (Vestuário Mulher, Vestuário Desportivo, Calçado, Meias, Mãos & Pegas, Proteções corpo, Cordas & Cargas, Nutrição & Suplementos, Acessórios desporto, Outro).
⚡ Antes vs Depois do Módulo Training-Distribution
| Tarefa |
❌ Sem o módulo |
✅ Com o módulo |
| Importar 2 300 referências desporto | 80h+ manual, cópia do portal Training-Distribution | 1 clique, ~2h em segundo plano |
| Cor + Tamanho no título | Inserção manual «Joelheiras Preto Tamanho XL» no fim do título | Auto-anexar «— Cor · Tamanho XX» + truncatura 128 chars |
| Multi-imagens de célula única | Parsing manual dos URLs concatenados por vírgulas | Split + validação auto, 1ª = cover |
| Descrição CSV vazia (nenhuma fornecida) | Fichas fantasma, mau SEO, taxa de rejeição | Auto-geração HTML estruturado nome + marca + cat |
| Categoria única CSV (1 nível) | Criação manual de uma árvore coerente desporto | 10 cats principais + 42 sub-cats criadas na instalação |
| Codificação ISO-8859-1 (não UTF-8) | Caracteres franceses partidos («Mapalé», «Genouillères») | Conversão automática célula a célula |
| Símbolo € mal codificado (¤ em ISO) | Preços com «¤» ou falhas na importação | ¤ removido automaticamente, preços limpos |
| Imagem original BO PrestaShop 9 | Imagem partida BO PS9 (bug oficial) | Fix BO PS9 incluído: cópia 1:1 do ficheiro original |
| Atualizar preços/stocks | Refazer tudo do zero todos os dias | Modo leve automático: atualização preços+stocks apenas |
👤 A quem se dirige este módulo?
🏋️
E-commerce Cross Training & Fitness
Vende material cross-training (joelheiras, cintos, pegas, cordas de saltar, discos bumper, alças), roupa training, calçado de Halterofilismo. Training-Distribution é referência FR nestes nichos com ROKFIT, REHBAND, PICSIL, VELITES como marcas de bandeira.
💪
Loja de musculação
Oferece acessórios de força e musculação: cintos de força, munhequeiras, joelheiras, coletes lastrados, halterofilismo. ~150 referências especificamente de musculação no catálogo.
🥤
E-commerce nutrição desportiva
Proteínas, BCAA, pre-workout, snacks proteicos (BAREBELLS, NOCCO), bebidas energéticas, omega 3 e suplementos alimentares desporto. ~150 referências nutrição para uma oferta francófona completa.
🎯 Funcionalidades completas do Módulo Training-Distribution
🎨 Cor + Tamanho anexados ao título — Inovação Training-Distribution
Particularidade do CSV Training-Distribution. Ao contrário dos outros fornecedores, a «Referência» muda para cada tamanho (ex. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — todas diferentes). Pior ainda: a coerência nem sequer é garantida na truncatura (linha L tem `R-N_GEN_0535_L` com hífen em vez de underscore). Consequência: impossível agrupar várias linhas em 1 produto com as suas combinations PS.
Solução adotada pelo módulo: 1 linha CSV = 1 produto PS distinto, e a cor + tamanho são anexadas automaticamente ao título do produto com um formato gráfico cuidado.
Exemplo:
"Par de Joelheiras Preto 5 mm | REHBAND" + Cor "Preto" + Tamanho "XL"
→ "Par de Joelheiras Preto 5 mm | REHBAND — Preto · Tamanho XL"
- Truncatura automática a max 128 caracteres (limite
Product::name PS): se o título concatenado ultrapassar, o título original é truncado com «…» para deixar lugar à cor + tamanho intactos
- UTF-8 safe: a truncatura usa
mb_substr(), nunca cortado a meio de um caractere multi-byte
- Formato gráfico: em-dash (—) + middot (·) para boa legibilidade visual
- Referência nativa por produto: a «Referência» do CSV é usada como
Product::reference (campo PS nativo)
🌳 Árvore desporto — 10 categorias principais × 42 subcategorias
O CSV Training-Distribution só expõe UM ÚNICO nível de categoria por produto («Catégorie»). O módulo compensa isso propondo na instalação uma árvore desporto de 10 categorias principais prontas a usar, com 42 subcategorias que reproduzem identicamente os nomes expostos pelo CSV.
| Categoria principal | Subcategorias CSV agrupadas |
|---|
| Vestuário Mulher | Sutiãs desporto · T-shirts - Crop tops · Têxtil Mulher Desporto |
| Vestuário Desportivo | T-shirts - Tops · Sweats - Hoodies · Calções - Leggings · Calções - Joggers · Fato de banho |
| Calçado | Cross Training · Halterofilismo & Powerlifting |
| Meias | Treino · Desporto criança · Meias respiráveis & training leves |
| Mãos & Pegas | Pegas com/sem magnésio · Pegas Cross Training · Tape & Proteção · Magnésio · Patches Velcro |
| Proteções corpo | Cintos de força · Joelheiras · Munhequeiras · Colete lastrado |
| Cordas & Cargas | Cordas de saltar · Cabos de substituição · Discos Bumper · Alça de tração |
| Nutrição & Suplementos | Proteínas/BCAA/Pre Workout · Snacks · Bebidas energéticas · Vitaminas · Omega 3 · Nutrição Desporto |
| Acessórios desporto | Faixas · Bonés/Gorros · Óculos · Cantis · Saco de desporto · Cartão presente |
| Outro | Diversos / A classificar (fallback: Início, vazio, «Catalogue Sport…», desconhecido) |
- Criação multilingue na instalação: 10 cats principais + 42 sub-cats criadas idempotentemente sob a sua categoria raiz PS
- Cache DB do mapping: a cat CSV resolvida é memorizada em
wp_trainingdist_category_mapping para os imports seguintes
- Separador Mappings categorias no BO: tabela auto-carregada com seletor das 42 sub-cats + botão Re-mapear para fundir ou renomear após o import
- Fallback inteligente: se a cat CSV é vazia, «Início», «Categoria» ou «Catalogue Sport…», o produto é encaminhado para Outro > Diversos / A classificar
- Rede de segurança: a cada abertura do módulo BO, a árvore é re-verificada. Uma cat eliminada manualmente é recriada automaticamente
📸 Multi-imagens de célula única «URL Images»
A coluna «URL Images» do CSV contém N URLs separados por vírgulas numa célula entre aspas (ex. «url1.jpg,url2.jpg,url3.jpg»). O módulo split por vírgula, valida cada URL (prefixo http(s)) e importa todas as imagens.
- 1º URL = cover automaticamente
- Validação formato via
getimagesize(): JPEG/PNG/GIF/WebP, ficheiros corrompidos rejeitados sem crashear o import
- Geração auto de todos os tamanhos PS (small, medium, large, home_default…)
- Fix BO PrestaShop 9 incluído: cópia 1:1 do ficheiro original
<id>.jpg além das variantes
- Download resiliente: retry × 3 com backoff em 503/timeout, log de erro se falha total (o import continua)
📝 Descrição auto-gerada (CSV sem descrição do fornecedor)
Training-Distribution não fornece NENHUMA coluna descrição no CSV. O módulo gera sistematicamente uma descrição HTML estruturada a partir do rótulo, marca, categoria e referência — para nunca ter uma ficha de produto fantasma no front (anti-rejeição + bom SEO).
🔤 Codificação ISO-8859-1 + separador vírgula
O CSV training-distribution está em ISO-8859-1 com separador vírgula (ao contrário dos outros módulos que usam UTF-8 + ";"). O módulo gere isso:
- Conversão ISO-8859-1 → UTF-8 célula a célula via
mb_convert_encoding() com auto-deteção se já em UTF-8
- Símbolo moeda ¤ (= € mal codificado Win-1252) removido automaticamente do fim dos preços
- Decimais vírgula convertidos em ponto nas colunas Preço e Peso
- Célula URL Images entre aspas: vírgulas internas preservadas pelo
fgetcsv standard, splitting feito em importMultiImages()
⚡ Arquitetura import tempo real
O cenário que muda tudo:
- 📥 Preparação: o módulo descarrega o CSV do URL Training-Distribution e coloca as 2 300 linhas em cache JSON
- 🚀 Import "1 linha CSV = 1 chamada AJAX": sem freeze de 2 horas, vê cada produto criado um a um
- 📊 Barra de progresso vermelha & dourada: percentagem live + contador X/Y
- 📋 Diário live: badge colorido (Criado / Atualizado / Ignorado / Erro) + referência + título + ID PS#
- ⏸️ Botão Parar a qualquer momento, retoma possível
- 📈 Stats live: Linhas tratadas · Criados · Atualizados · Ignorados · Erros
→ Adeus página que rema. Adeus preocupação. Vê tudo o que se passa.
💰 Margens & SEO configuráveis
4 modos de cálculo de preço
| Modo | Descrição |
|---|
| RRP ⭐ (predefinição) | Preço de venda CSV tal qual — o mais simples para começar. |
| Escalões | % diferente conforme o escalão de preço sem IVA (5 escalões configuráveis: 0-15€/15-30€/30-60€/60-120€/120€+ — adaptado às proteínas a 30€ como aos discos bumper a 200€+). |
| Markup fixo | Um único % aplicado (50% por defeito → preço sem IVA × 1.5). |
| Wholesale | Preço de compra sem IVA tal qual (venda B2B a ginásios, coaches, etc.). |
Templates SEO personalizáveis
- Meta title / meta description com variáveis:
{name}, {brand}
- Tags PS franceses auto-gerados a partir de brand + category + cor (se presente)
- Modo leve (light update): 2º import = atualização preços+stocks apenas, as suas personalizações BO são preservadas
- Auto-desativação rutura stock (opção) ou «manter visível para o SEO»
- Imagem na descrição: injeção da 1ª imagem na descrição longa (boost SEO on-page)
⏰ CRON 24/7 — 3 ações automatizadas
| Ação CRON |
Papel |
Frequência aconselhada |
full_import | Import completo (criações + light updates) | 1×/dia |
light_sync | Atualização preço + stock + disponibilidade dos produtos já importados (modo leve) | a cada 2-4h |
cleanup_logs | Limpeza logs > N dias (retenção configurável) | 1×/semana |
- Chave secreta 32 caracteres hex gerada na instalação — os seus URLs CRON não podem ser adivinhados
- Regeneração a 1 clique da chave em caso de fuga
- Auto-relançamento assíncrono: auto-rechamada em segundo plano se o time-budget é atingido (60s por defeito)
- Retoma precisa: retoma exatamente na linha onde parou
- Lock anti-concorrência via flock: sem execuções paralelas
- Retry download CSV 3× com backoff 2s/4s/6s
- Botão Stop do lado BO para parar limpamente um CRON em curso
- Modo teste com limite de produtos configurável (10-100 para validar rapidamente)
🏷️ O catálogo Training-Distribution em números
2 300
referências catálogo
10
cats principais desporto
Marcas de bandeira do catálogo Training-Distribution (extrato por volume):
ROKFIT
REHBAND
PICSIL
BAREBELLS
NOCCO
TYR
NORTHERN SPIRIT
VELITES
CELLUCOR C4
VERY BAD WOD
HEXXEE SOCKS
BARBELL REGIMENT
+ 20 outras marcas
🛠️ Manutenção — Eliminação seletiva
- ☐ Produtos importados: deteção a 4 fontes (meta, supplier, product_supplier, mapping categorias), compatível PS9 multi-shop com fallback wipe SQL nas tabelas relacionadas
- ☐ Atributos órfãos: este módulo não cria NENHUM atributo PS (cor+tamanho anexados ao título, sem combinations). Esta caixa só tem efeito se criou manualmente atributos no BO
- ☐ Marcas órfãs: elimina os fabricantes Training-Distribution (ROKFIT, REHBAND, PICSIL, BAREBELLS, NOCCO, TYR, NORTHERN SPIRIT, VELITES, …) que já não têm nenhum produto
- ☐ Fornecedor Training-Distribution: elimina o fornecedor apenas se já não tiver nenhum produto associado
- ☐ Diários internos: truncate das tabelas history e import_errors
Tripla confirmação (caixa de diálogo + introdução ELIMINAR + botão). A árvore de categorias não é apagada — gerida pelo módulo, recriada na próxima abertura se a eliminou manualmente.
⭐ 12 razões para escolher o Módulo Training-Distribution
- 🚀 Instalação 3 minutos: URL CSV + iniciar o import
- 🎨 Cor + Tamanho anexados ao título com truncatura 128 chars UTF-8 safe — solução limpa face às refs CSV incoerentes
- 🇫🇷 Mono-língua francês nativo — descrições FR redigidas humanamente por Training-Distribution
- 🔤 Conversão ISO-8859-1 → UTF-8 automática (caracteres franceses preservados)
- 📝 Auto-geração SDE sistemática (CSV sem descrição do fornecedor)
- 🌳 10 categorias desporto prontas à instalação + 42 subcategorias alinhadas com o CSV
- 📸 Multi-imagens N URLs de célula única + fix BO PS9 incluído
- 💰 4 modos de preço (RRP / Escalões / Markup fixo / Wholesale) — adaptados aos diferenciais de preço proteínas/discos bumper
- ⚡ Import tempo real produto-por-produto: barra live, diário consola, botão Parar
- ♻️ Modo leve automático em re-import: atualização preços+stocks apenas
- ⏰ CRON 24/7 com time-budget, auto-relançamento assíncrono, retry, lock
- 💎 Nenhum AdminController, nenhuma Tab BO, nenhum override: não polui o seu menu, não quebra os seus outros módulos
🎬 Como funciona em 4 passos
1
Instale o módulo
Descarregue o ZIP, instale via o BO. Auto-criação de 5 tabelas, do fornecedor Training-Distribution, da chave CRON e da árvore desporto (10 cats × 42 sub-cats).
2
Insira o URL CSV
Vá a Parâmetros, cole o URL fornecido por Training-Distribution. Configure a categoria raiz sob a qual a árvore é criada (Início por defeito).
3
Configure as suas margens
Modo RRP por defeito. Pode também escolher Escalões (5 escalões) / Markup fixo / Wholesale. Templates SEO personalizáveis com {name}/{brand}.
4
Inicie o import
Clique em "Iniciar import". Modo teste 20 produtos primeiro para validar, depois import completo 2 300 produtos (~2h). Vê cada produto criado com a sua Cor + Tamanho em título à frente dos seus olhos.
🔧 Compatibilidade técnica
| PrestaShop | 1.7.x → 9.x (testado em PS 9.0) |
| PHP | 7.4 mínimo, recomendado 8.1+ |
| MySQL / MariaDB | 5.7+ / 10.3+ |
| cURL | Ativado (download CSV + imagens) |
| Multi-shop | Compatível (força CONTEXT_ALL para a eliminação) |
| Hooks utilizados | Nenhum (sem poluição da cadeia de eventos) |
| Override de classe | Nenhum (preserva os seus outros módulos) |
| AdminController | Nenhum |
| Separador sidebar BO | Nenhum (não polui o seu menu) |
| Conta Training-Distribution B2B | Conta requerida para a faturação e o acesso ao CSV |
| URL CSV | A pedir ao seu comercial Training-Distribution |
❓ Perguntas frequentes
P: O Módulo Training-Distribution funciona em PrestaShop 9?
R: Sim, totalmente compatível PS 9.x. O módulo gere a migração específica PS9 onde meta_keywords foi retirado (passagem auto para ps_tag) bem como o bug PS9 onde a imagem original não aparece na página de edição de produto BO (fix por cópia 1:1 do ficheiro <id>.jpg).
P: Porquê 1 linha CSV = 1 produto (sem agrupamento tamanho/cor)?
R: Porque o CSV training-distribution não expõe uma referência pai comum entre os tamanhos de um mesmo produto. Cada tamanho tem uma ref totalmente diferente (ex. `R_N_GEN_0535_XS`, `_S`, `_M`, `_L`, `_XL` — todas distintas), e mesmo a truncatura não funciona (linha L tem `R-N_GEN_0535_L` com hífen). Então impossível agrupar. Solução: 1 linha = 1 produto, tamanho anexado ao título.
P: Os títulos «— Cor · Tamanho XL» arriscam ser longos. Como é gerido?
R: O módulo trunca automaticamente o título original (com «…») se necessário para ficar abaixo do limite PS de 128 caracteres, mantendo sempre a cor + tamanho intactos. UTF-8 safe (nunca cortado a meio de um caractere multi-byte).
P: Como é criada a hierarquia de categorias?
R: Na instalação, o módulo cria 10 categorias principais desporto + 42 subcategorias sob a sua raiz PS (Início por defeito). A cada import, a «Catégorie» CSV é mapeada para a subcategoria correta via uma tabela interna. Se não corresponder, cai em «Outro > Diversos / A classificar» (nunca um erro). Separador Mappings para fundir ou renomear após o import.
P: O CSV está em ISO-8859-1 — como o módulo gere isso?
R: O módulo converte cada célula de ISO-8859-1 para UTF-8 via mb_convert_encoding() (com auto-deteção se a célula já é UTF-8). Os caracteres franceses como «Genouillères», «Brassières», «Mapalé» são preservados. O símbolo «¤» no fim dos preços (= € mal codificado Win-1252) é removido automaticamente. Decimais vírgula convertidos em ponto.
P: Porque é que a minha descrição é auto-gerada?
R: O fornecedor Training-Distribution não fornece nenhuma coluna descrição no CSV. Para nunca ter uma ficha de produto fantasma no front (e prejudicial ao SEO), o módulo gera um texto HTML estruturado a partir do nome + marca + categoria + referência. Pode personalizar manualmente as fichas que lhe interessam — o modo leve já não as substituirá.
P: Posso importar várias vezes o mesmo CSV?
R: Sim. Modo leve automático: os produtos existentes são detetados via a sua Referência CSV (= sku único por linha) e apenas o seu preço + stock são atualizados. As suas descrições, imagens, categorias e tags não são reescritos — mantém as suas personalizações.
P: Como eliminar todos os produtos Training-Distribution?
R: Separador Importação → Eliminação seletiva → marque «Produtos importados» + «Marcas órfãs» + «Fornecedor Training-Distribution» + «Diários» → ELIMINAR. Tripla confirmação para evitar erros.
P: E se eu quiser parar um import em curso?
R: Botão «Parar» disponível durante o import (UI) e durante o CRON (flag file). Stop limpo no fim do produto em curso, gravação do estado para retoma na linha exata de paragem.
P: O módulo é compatível multi-shop?
R: Sim. As categorias e produtos são criados em todos os shops ativos. A eliminação força CONTEXT_ALL para evitar o quirk PS9 onde Product->delete() retorna false em multi-shop.
P: Nenhum AdminController, nenhuma Tab BO?
R: Confirmado. O módulo utiliza unicamente getContent() + AJAX. Sem poluição do menu BO PrestaShop. Nenhum override de classe core.
💪 Pronto para automatizar o seu dropshipping desporto?
O Módulo Training-Distribution dropshipping desporto cross-training fitness é a ferramenta mais completa para vender as 2 300 referências Training-Distribution (cross-training, fitness, musculação, nutrição desportiva) em PrestaShop. Uma só vez configurado, importa automaticamente o catálogo com cor + tamanho em título, as suas N fotos por produto, a sua hierarquia desporto pronta a usar.
⚡ INSTALAÇÃO 3 MIN · 📚 IMPORT TEMPO REAL · 🛡️ COMPATÍVEL PS 1.7 → 9 · 🇫🇷 SUPORTE FRANCÊS
📋 Detalhes técnicos para developers
Tabelas BDD criadas (5): wp_trainingdist_history, wp_trainingdist_import_errors, wp_trainingdist_product_meta (sku único = Referência CSV), wp_trainingdist_combination_meta (sku único), wp_trainingdist_category_mapping (csv_path único)
Configurações PS: WPTD_SETTINGS (JSON), WPTD_SUPPLIER_ID, WPTD_CRON_KEY, WPTD_LAST_IMPORT_AT, WPTD_LAST_IMPORT_COUNT, WPTD_LAST_UPLOADED_CSV, WPTD_CRON_LAST_*
CSV Training-Distribution (10 colunas ISO-8859-1, separador vírgula): Marque, Catégorie, Nom, Taille, Couleur, URL Images, Stock, Poids, Référence, Prix de vente (com ¤ stripped)
Arquitetura: 5 classes PHP limpas (TdCompat, TdCategoryTaxonomy, TdCategoryMapper, TdFeatureMapper [código morto by design — sem Features neste CSV], TdCsvImporter) + módulo principal + router AJAX + CRON. Nenhum override de classe core PrestaShop.
Aliases motor partilhado: sku → Référence, name_fr → Nom, brand → Marque, category → Catégorie, price → Prix de vente, weight → Poids (em kg nativos, não gramas), qty → Stock, size → Taille, color → Couleur, image-url-1 → URL Images (célula única splittada).
appendVariantToName(): helper que anexa «— Cor · Tamanho XX» ao nome produto com truncatura 128 chars UTF-8 safe (mb_substr). Se o título concatenado ultrapassar, o título original é truncado com «…» para manter cor+tamanho intactos.
importMultiImages(): split a célula URL Images por vírgula, valida cada URL (preg_match `^https?://`), 1ª URL = cover. Download com retry × 3 backoff, validação getimagesize JPEG/PNG/GIF/WebP, geração auto de todos os tamanhos PS via ImageManager::resize, fix BO PS9 por cópia 1:1 do ficheiro original <id>.jpg.
ensureSupplierExists(): INSERT SQL direto (não new Supplier() + ->add() que falha silenciosamente em PS9). Deteção dinâmica da coluna meta_keywords em ps_supplier_lang (presente PS7, retirada PS9). Multi-shop via ps_supplier_shop. Rede de segurança: chamada também antes de cada import (não apenas na instalação).
Cache estático Db::getValue(): as 4 queries de existência em processRow() utilizam useCache=false para bypassar o cache estático PS que persiste entre workers PHP-FPM (senão os re-imports não encontram os produtos já importados e criam duplicados).
Segurança: pSQL() em todo o lado, pasta uploads/ protegida, validação formato imagens, CSRF nativo PS em AJAX, escapes HTML sistemáticos, hash_equals() em chave CRON.
Compatibilidade PS9 específica: migração auto meta_keywords → ps_tag/ps_product_tag via Tag::addTags(), gestão do quirk Product::delete() que retorna false em multi-shop, fix BO PS9 imagem original.
Codificação: conversão ISO-8859-1 → UTF-8 célula a célula via mb_convert_encoding() com deteção prévia se já UTF-8 válido. Stripping do símbolo ¤ + espaços não-separáveis nos preços. Conversão vírgula decimal → ponto.
📦 Módulo desenvolvido por WebPoint · webpoint.fr · Atualizações regulares · Código limpo & comentado
