Documentação

Primeiros passos

As suas escolhas

• Versões do PrestaShop — 8.x, 9.x ou ambas, na barra por baixo da caixa de texto. Ambas é o valor por omissão. Suportar as duas custa por vezes alguma coisa, porque alguns hooks do back office e certos padrões de controlador diferem, e o agente avisa-o quando é o caso; a 1.7 aparece no seletor mas não pode ser escolhida.
• Idiomas — as traduções que o próprio módulo leva consigo: inglês, francês, alemão, espanhol, italiano, neerlandês, polaco e português, em qualquer combinação, com inglês, francês, espanhol e alemão ativos por omissão. Cada idioma a mais é tempo real de construção, porque é traduzido e fotografado. Não confundir com o idioma em que vê este site, que muda no rodapé ou na sua conta.
• Multiloja — ligue se a sua loja usa o modo multiloja do PrestaShop. Decide se as definições são por loja ou globais e se as tabelas próprias levam uma coluna de loja: barato de decidir antes do build, caro de acrescentar depois.
• Captura de referência — anexe um PNG, JPEG ou WebP até 5 MB quando uma imagem for mais rápida do que um parágrafo, por exemplo a página exata onde quer que o módulo apareça. Fica anexada à conversa que abre; descreva também o que mostra, porque é o texto da especificação que orienta a construção.
• Tema — o agente pergunta se o tema clássico chega ou se o módulo tem de sobreviver a um tema à medida. Essa resposta decide com que cuidado os templates do front office se ligam à loja, por isso vale um momento de reflexão.

Créditos de build

One credit is one module, taken all the way: written, tested, translated, documented and packaged. Accounts start with none; we add credits when you request them. There is no card and no payment page.

A conversa não custa nada, por mais longa que seja. O crédito é gasto no momento em que aprova — e, se a entrega ao pipeline falhar precisamente nesse momento, volta logo para o seu saldo. O que lhe resta está na página da sua conta.

Cada aprovação gasta um, seja um segundo módulo ou uma versão diferente de um que já tem. Quando o saldo chega a zero, o botão de construir fica desativado; escreva-nos para o endereço no rodapé para o carregar.

Instalar o módulo entregue

O que transfere é um .zip de módulo PrestaShop vulgar e corrente, com o nome do módulo e a sua versão. Precisa de uma loja em PrestaShop 8.x ou 9.x com PHP 8.1 ou superior — as versões que escolheu ao descrevê-lo. Ninguém da module.monster toca na sua loja; instala-o você mesmo, pela via que costuma usar:

• No back office, vá a Módulos e depois ao Gestor de Módulos e use «Carregar um módulo» para lá colocar o .zip. O PrestaShop descompacta-o e instala-o de uma só vez. O ecrã está no mesmo sítio em 8.x e em 9.x.
• Ou descompacte o .zip e copie a pasta resultante para o diretório /modules da sua loja, por FTP ou SSH, mantendo exatamente o nome da pasta. O módulo passa então a aparecer no Gestor de Módulos, onde carrega em Instalar.
• De qualquer das formas, termina no Gestor de Módulos: «Configurar» abre a página de definições do próprio módulo no back office. Desinstalar a partir desse mesmo ecrã remove as tabelas, os separadores e as definições que tinha criado.

Instale-o primeiro numa cópia de testes da sua loja e percorra-o aí. É PHP corrente que lhe pertence — leia-o, altere-o, entregue-o ao seu programador — mas é código que a sua loja nunca correu, e uma loja em produção é um mau sítio para o descobrir.

Limites e expectativas

• Um módulo de cada vez, do tamanho do que um bom programador constrói num dia. Uma ideia maior é reduzida, durante a conversa, à versão mais pequena que se aguenta sozinha, ficando o resto como sugestão para um módulo seguinte.
• Apenas PrestaShop 8.x e 9.x, com PHP 8.1 ou superior. Nada mais antigo é suportado, incluindo a 1.7.
• O módulo é construído e testado sobre uma instalação PrestaShop padrão. Um tema muito personalizado, ou outro módulo a disputar o mesmo hook, pode ainda assim exigir ajustes já na sua loja.
• Um módulo pode falar com um serviço externo, mas a conta e as credenciais são suas e essa parte não pode ser exercitada nos testes. Conte com verificar uma integração dessas na sua própria loja de testes.
• Aprovar fecha a especificação. A conversa passa a seguir a construção em vez de aceitar alterações, por isso uma revisão é um novo build e mais um crédito. Leia o resumo antes de carregar no botão.
• O que transfere é o .zip do módulo. O guia ilustrado escrito durante a construção não vai lá dentro — escreva-nos se quiser uma cópia.
• Sem acesso em qualquer dos sentidos: nada é instalado na sua loja por si, e o módulo nunca liga para casa. Isso significa também que não há atualizações automáticas — o que transferiu fica como está até construir algo novo.
• Há builds que falham. Uma etapa que continua a voltar errada é repetida até três vezes e depois o módulo é assinalado como precisando de atenção, em vez de entregar algo partido. Vê isso na página do módulo, e nós próprios vamos ver o que aconteceu.