# Personalização de Produto (gravação, texto, imagem): guia completo

> Apresentação O módulo Personalização de Produto permite aos seus clientes personalizar um artigo diretamente a partir da ficha de produto: introdução de um texto / gravação (com tipo de letra…

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

## Apresentação

O módulo **Personalização de Produto** permite aos seus clientes personalizar um artigo diretamente a partir da ficha de produto: introdução de um **texto / gravação** (com tipo de letra e cor) ou **carregamento de uma imagem**. A personalização aparece em **pré-visualização em direto sobre a fotografia do produto**, com posicionamento por arrastar e largar e tamanho e rotação ajustáveis, e cada opção pode aplicar um **acréscimo de preço** (montante fixo ou percentagem) adicionado automaticamente ao carrinho.

O módulo é compatível com **PrestaShop 8.x e 9.x**. Cria as suas próprias tabelas e não sobrepõe as fichas de produto existentes: a personalização é comandada por opções que cria, dirigidas por categoria e afináveis produto a produto.

## Instalação

1. Comprima a pasta `dfcustomizer` (ou use diretamente o arquivo `dfcustomizer.zip` fornecido).
2. No back-office, abra **Módulos > Gestor de módulos**.
3. Clique em **Carregar um módulo** e coloque o arquivo ZIP.
4. Terminada a instalação, clique em **Configurar** para criar as suas opções.

Na instalação, o módulo cria as tabelas necessárias (`dfc_option` e as tabelas associadas, `dfc_product_override`, `dfc_customization`) e regista os hooks de apresentação na ficha de produto, no carrinho e na encomenda.

## Configuração: criar uma opção

Vá a **Módulos > dfcustomizer > Configurar** para criar e gerir as suas opções de personalização. Cada opção define um tipo de personalização, o seu impacto no preço e o seu âmbito de aplicação.

### Tipo de personalização

- **Texto / gravação**: o cliente introduz um texto. Pode oferecer uma escolha de **tipo de letra** e de **cor** (ambas opcionais).
- **Carregamento de imagem**: o cliente envia um ficheiro no formato **JPG, PNG ou WEBP**.

Nos tipos de letra propostos para a gravação, verifique que o conjunto de caracteres cobre os acentos e a cedilha do português (ã, õ, ç, á, é). Um tipo de letra decorativo incompleto pode fazer desaparecer estes caracteres na pré-visualização e no ficheiro de produção.

### Impacto no preço

Cada opção pode acrescentar um suplemento ao preço do produto:

- um **montante fixo sem IVA**, ou
- uma **percentagem** do preço do produto.

O suplemento aparece em tempo real do lado do cliente e é refletido no carrinho (ver a secção Carrinho e preços).

### Âmbito por categoria

Assinale as **categorias** a que a opção se deve aplicar: a opção só aparecerá nos produtos dessas categorias. Se **nenhuma categoria** for assinalada, a opção aplica-se a **todo o catálogo**.

### Substituição por produto

Na **ficha de produto** (separador **Módulos**), cada produto dispõe de uma definição de substituição. Pode:

- **herdar** as opções definidas pelas categorias (comportamento predefinido);
- **escolher as suas próprias opções** especificamente para esse produto;
- **desativar** totalmente a personalização para esse produto.

## Do lado do cliente (front-office)

Na ficha de produto, o cliente introduz o seu texto (tipo de letra, cor) ou envia a sua imagem. A personalização aparece de imediato em **pré-visualização em direto sobre a fotografia do produto**:

- **posicionamento** por arrastar e largar sobre a imagem;
- **cursores de tamanho e de rotação** para ajustar o resultado.

O suplemento de preço ligado às opções escolhidas aparece em direto. Ao adicionar ao carrinho, a personalização e uma **pré-visualização achatada em formato PNG** são guardadas para serem recuperadas na encomenda.

## Carrinho e preços

O suplemento é acrescentado ao preço do artigo no carrinho através de uma regra de preço ligada ao carrinho (`SpecificPrice` associado ao `id_cart`). Este acréscimo é **recalculado a cada gravação do carrinho** e **eliminado automaticamente** se o produto for retirado do carrinho.

**A ter em conta:** só é possível uma personalização por par _produto / combinação_ e por carrinho.

## Do lado da encomenda

### Back-office

Na página de uma encomenda, um painel **«Personalizações de produto»** resume cada personalização: o texto introduzido, o **ficheiro do cliente descarregável** e a pré-visualização gerada. Fica assim com tudo o que é necessário para a produção (gravação, impressão, etc.).

### Front-office

O cliente encontra um resumo das suas personalizações no **detalhe da sua encomenda**.

Um artigo personalizado a pedido do consumidor está entre as exceções ao direito de livre resolução previstas no artigo 17.º do Decreto-Lei n.º 24/2014. Se explorar esta exceção, indique-o claramente na ficha do produto e nas suas condições de venda, uma vez que a informação prévia é uma condição para poder invocá-la.

## Notas técnicas

- **Tabelas criadas:** `dfc_option` (mais `dfc_option_lang` e `dfc_option_category`), `dfc_product_override`, `dfc_customization`.
- **Acréscimo de preço:** aplicado através de `SpecificPrice` ligado ao carrinho (`id_cart`), recalculado a cada gravação do carrinho e eliminado se o produto for retirado.
- **Ficheiros dos clientes:** guardados em `modules/dfcustomizer/uploads/`, pasta cuja execução de PHP está bloqueada por um ficheiro `.htaccess`, por segurança.

**Limitação:** uma personalização por par produto/combinação e por carrinho.

## Resolução de problemas

### A opção de personalização não aparece na ficha de produto

Confirme que a opção está ativa e que as suas **categorias** incluem a categoria do produto (ou que nenhuma categoria está assinalada, para abranger todo o catálogo). Verifique depois a **substituição por produto** (separador Módulos da ficha): a personalização não deve estar desativada nesse produto. Por fim, limpe a cache do PrestaShop.

### O suplemento de preço não aparece no carrinho

O acréscimo é recalculado ao gravar o carrinho. Confirme que a opção tem mesmo um impacto no preço (montante fixo ou percentagem) e recarregue o carrinho. Se o produto foi retirado e voltou a ser adicionado, a personalização tem de ser refeita.

### O carregamento da imagem é recusado

Só são aceites os formatos **JPG, PNG e WEBP**. Verifique o formato do ficheiro e o tamanho máximo de carregamento permitido pelo seu alojamento (`upload_max_filesize` e `post_max_size` do PHP).

## Desinstalação

A desinstalação retira os hooks e a configuração do módulo. Guarde previamente os ficheiros dos clientes presentes em `modules/dfcustomizer/uploads/` e os dados de personalização das encomendas, se os quiser conservar.

## Perguntas frequentes

### O módulo é compatível com o PrestaShop 9?

Sim, o módulo é compatível com PrestaShop 8.x e 9.x.

### Posso cobrar a personalização?

Sim. Cada opção pode aplicar um suplemento, sob a forma de montante fixo sem IVA ou de percentagem do preço do produto, acrescentado automaticamente ao carrinho.

### É possível limitar uma opção a certos produtos?

Sim, de duas formas: pelo **âmbito por categoria** da opção e pela **substituição por produto**, que permite a cada ficha herdar, escolher as suas próprias opções ou desativar a personalização.

### O cliente pode acrescentar várias personalizações ao mesmo artigo?

É guardada apenas uma personalização por par produto/combinação e por carrinho.