# DataFirefly Custom Textile Printing: personalização têxtil para PrestaShop

> Apresentação O módulo adiciona um bloco de personalização por baixo do botão de adicionar ao carrinho dos produtos que escolher. O cliente indica as quantidades por tamanho, marca as zonas,…

- Página: <https://www.datafirefly.com/pt/documentation/dftextileprint/>
- Idioma: pt
- Atualizado em: 2026-09-24
- Outros idiomas: [fr](https://www.datafirefly.com/documentation/dftextileprint/index.md), [en](https://www.datafirefly.com/en/documentation/dftextileprint/index.md), [es](https://www.datafirefly.com/es/documentation/dftextileprint/index.md), [de](https://www.datafirefly.com/de/documentation/dftextileprint/index.md), [it](https://www.datafirefly.com/it/documentation/dftextileprint/index.md), [pl](https://www.datafirefly.com/pl/documentation/dftextileprint/index.md), [nl](https://www.datafirefly.com/nl/documentation/dftextileprint/index.md)
- Índice: <https://www.datafirefly.com/pt/documentation/llms.txt>

## Apresentação

O módulo adiciona um bloco de personalização por baixo do botão de adicionar ao carrinho dos produtos que escolher. O cliente indica as quantidades por tamanho, marca as zonas, escolhe uma técnica e um número de cores, envia o ficheiro e vê o preço calculado em tempo real. O detalhe da personalização acompanha a encomenda até à fatura graças à personalização nativa do PrestaShop. Depois da encomenda, um fluxo por estados gere o envio de ficheiros, a prova e a produção.

## Instalação

1. Em **Módulos > Gestor de módulos**, clique em **Carregar um módulo** e envie o ZIP `dftextileprint`.
2. O módulo cria as suas tabelas, um produto oculto `DF-TEXTILE-SETUP` que suporta os custos de preparação e um menu **Catálogo > Personalização têxtil**.
3. São criados dados de demonstração: serigrafia, bordado e vinil com as suas tabelas, e seis zonas (peito esquerdo, frente, costas, nuca, duas mangas). Pode alterá-los ou eliminá-los.

Não elimine o produto `DF-TEXTILE-SETUP`. Se desaparecer, o módulo volta a criá-lo ao guardar as definições.

## Definições

No separador **Definições** do módulo:

- **Custos de preparação no carrinho**: linha separada (uma por personalização) ou repartidos no preço por peça. Aplica-se às novas personalizações.
- **Regra de imposto dos custos**: imposto do produto de custos.
- **Grupo de atributos dos tamanhos**: mantenha a deteção automática se o grupo se chamar Tamanho, Size, Taille, Größe, etc.
- **Tamanho máximo do ficheiro** e **tipos aceites**. O limite real é limitado pela configuração PHP do servidor (upload_max_filesize, post_max_size); aparece um aviso se o seu valor for superior.
- **Ficheiro obrigatório**: sem esta opção, o cliente pode encomendar e enviar o ficheiro mais tarde.
- **Personalização com texto**: tipos de letra propostos e cores do texto (uma por linha, formato Nome=#hex).
- **Depois da encomenda**: fluxo de provas na conta do cliente, prazo dos lembretes automáticos, estados de encomenda automáticos, email de notificação da oficina.

## Técnicas e tabelas de preços

Cada técnica tem:

- uma **tabela de preços por peça sem IVA**: uma linha por escalão de quantidade («a partir de 10», «a partir de 25»...) e uma coluna por número de cores;
- uma **quantidade mínima** (por exemplo 10 peças em serigrafia);
- um **modo de custos de preparação**: por cor (quadros), por design (programação de bordado, ficheiro de corte) ou nenhum;
- uma **tabela de custos** decrescente com a quantidade.

A quantidade considerada é o total de todos os tamanhos e cores do produto na personalização. Os preços introduzem-se sem IVA na moeda predefinida e são convertidos automaticamente.

## Zonas de personalização

Uma zona tem um nome, um lado (frente ou costas), uma posição na pré-visualização, um tamanho máximo de impressão em milímetros, um suplemento opcional por peça e a lista de técnicas permitidas (nenhuma marcada significa todas). Posicione-a com o rato no editor: arraste o retângulo, e o canto para redimensionar.

A opção **Personalização com texto** permite ao cliente escrever o mesmo texto para todas as peças ou uma linha por peça (nomes e números), em vez de um ficheiro ou além dele.

## Produtos e categorias

A personalização ativa-se por regras, por produto ou por categoria. Uma regra de produto prevalece sobre as regras de categoria, e uma regra de produto inativa desativa a personalização desse produto. Para cada regra:

- **Forma da peça**: t-shirt, sweat com capuz, saco tote ou boné;
- **Personalização obrigatória**: oculta o botão nativo do carrinho, o cliente passa sempre pelo bloco de personalização;
- **Zonas e técnicas disponíveis**: restrinja a lista se necessário;
- **Pré-visualização**: silhueta na cor da combinação ou fotos do produto.

### Pré-visualização com fotos e calibração das zonas

No modo fotos, indique a posição da foto da frente e da foto das costas na ordem das imagens do produto (0 mantém a silhueta para as costas). As imagens associadas a uma combinação têm prioridade, por isso cada cor mostra a sua foto. Depois posicione cada zona na foto no editor; numa regra de categoria, escolha um produto de exemplo fotografado como os outros.

## O percurso do cliente

1. Indica as quantidades por tamanho. As outras cores já indicadas ficam listadas em «Também nesta encomenda».
2. Marca uma ou várias zonas, escolhe técnica e número de cores e consulta os preços por escalão.
3. Envia o ficheiro pelo botão ou arrastando-o, depois move e redimensiona o logótipo na pré-visualização. Um indicador de resolução avisa quando o ficheiro é fraco demais para o tamanho de impressão.
4. O resumo mostra peças, personalização, custos e total, com a sugestão do escalão seguinte. Pode **descarregar um orçamento** ou **adicionar ao carrinho**.

São considerados os descontos de quantidade nativos do produto e as peças já no carrinho. Se o mesmo ficheiro já estiver no carrinho noutro produto, na mesma zona, com a mesma técnica e o mesmo número de cores, o escalão calcula-se sobre o total e os custos de preparação são cobrados uma só vez.

## Carrinho, encomenda e fatura

Cada linha de tamanho e cor inclui o preço da personalização por peça e o seu resumo. A linha dos custos de preparação está bloqueada numa unidade e não pode ser removida sozinha; desaparece com a personalização. Se o produto tiver uma promoção percentual, o módulo compensa para que a personalização mantenha o preço da sua tabela.

## Depois da encomenda: ficheiros, provas e estados

Cada personalização encomendada segue um estado: ficheiro em falta, ficheiro recebido, prova por aprovar, alterações pedidas, prova aprovada, em produção, concluído.

- **Do lado do cliente**: a partir do detalhe da encomenda ou da ligação segura recebida por email (também para convidados), envia um ficheiro em falta, abre a prova, aprova-a ou pede alterações com um comentário, e pode voltar a encomendar a mesma personalização com um clique.
- **Do lado da loja**: o painel **Personalização têxtil** da página da encomenda mostra a pré-visualização, a repartição por tamanho, os ficheiros, as instruções e o histórico. Daí envia a prova (imagem ou PDF) e altera o estado, com email opcional ao cliente.
- **Lembretes**: um email de lembrete parte uma vez quando uma prova ou um ficheiro aguarda há mais tempo do que o prazo escolhido. Funcionam com o tráfego da loja; também pode chamar o URL de cron indicado nas Definições.
- **Estado da encomenda**: escolha o estado PrestaShop aplicado quando todas as personalizações estão em produção e depois concluídas.

## Separador Produção e ficha de oficina

O separador **Produção** lista todas as personalizações encomendadas, por urgência, com filtros por estado e pesquisa por encomenda, cliente ou produto. Marque várias linhas para alterar o estado de uma só vez ou imprimir as fichas. A **ficha de oficina** inclui a pré-visualização, a repartição por tamanho com caixas de verificação, as zonas, uma miniatura do ficheiro, as instruções e a lista de nomes. As listas de nomes também se exportam em CSV a partir da encomenda.

## Resolução de problemas

- **O bloco não aparece**: verifique que uma regra ativa abrange o produto e que é proposta pelo menos uma zona e uma técnica ativas.
- **Os tamanhos não são detetados**: escolha o grupo de atributos dos tamanhos nas Definições.
- **O envio de um ficheiro falha**: compare o tamanho do ficheiro com o limite indicado; se necessário, aumente upload_max_filesize e post_max_size no seu alojamento.
- **As alterações de templates não aparecem após uma atualização**: limpe a cache em **Parâmetros avançados > Desempenho**.
- **Um funcionário não consegue enviar uma prova**: precisa de permissões de edição sobre as encomendas ou sobre o módulo.