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 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.

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.

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.

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.

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.