Documentación

Primeros pasos

Qué eliges

• Versiones de PrestaShop: 8.x, 9.x o ambas, en la barra bajo el cuadro de texto. Ambas es lo predeterminado. Soportar las dos a veces cuesta algo, porque ciertos hooks del back office y algunos patrones de controlador cambian entre versiones, y el agente te lo dirá cuando sea el caso; la 1.7 aparece en el selector pero no se puede elegir.
• Idiomas: las traducciones que el propio módulo lleva dentro — inglés, francés, alemán, español, italiano, neerlandés, polaco y portugués, en cualquier combinación, con inglés, francés, español y alemán activados por defecto. Cada idioma extra es tiempo real de build, porque se traduce y se captura en imágenes. No lo confundas con el idioma en que ves este sitio, que cambias en el pie de página o en tu cuenta.
• Multitienda: actívalo si tu tienda usa el modo multitienda de PrestaShop. Decide si los ajustes son por tienda o globales y si las tablas propias llevan una columna de tienda; es barato dejarlo claro antes del build y caro añadirlo después.
• Captura de referencia: adjunta un PNG, JPEG o WebP de hasta 5 MB cuando una imagen sea más rápida que un párrafo, por ejemplo la página exacta donde quieres que aparezca el módulo. Se adjunta a la conversación que abres; describe también lo que muestra, porque lo que guía la construcción es el texto de la especificación.
• Tema: el agente pregunta si basta con el tema clásico o si el módulo tiene que sobrevivir a uno personalizado. Esa respuesta decide con cuánta prudencia se enganchan las plantillas del front office, así que piénsalo un momento.

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.

La conversación no cuesta nada, dure lo que dure. El crédito se gasta en el momento en que apruebas y, si justo entonces falla la entrega al pipeline, vuelve enseguida a tu saldo. Lo que te queda está en tu página de cuenta.

Cada aprobación gasta uno, tanto si es un segundo módulo como una versión distinta de uno que ya tienes. Cuando el saldo llega a cero, el botón de construcción se desactiva; escríbenos a la dirección del pie de página para recargarlo.

Instalar el módulo que recibes

La descarga es un .zip de módulo de PrestaShop normal y corriente, con el nombre del módulo y su versión. Necesita una tienda con PrestaShop 8.x o 9.x y PHP 8.1 o superior: las versiones que elegiste al describirlo. Nadie de module.monster toca tu tienda; lo instalas tú, por la vía que uses habitualmente:

• En el back office, entra en Módulos y luego en Gestor de módulos, y usa «Subir un módulo» para soltar ahí el .zip. PrestaShop lo descomprime e instala de una vez. La pantalla está en el mismo sitio en 8.x y en 9.x.
• O descomprime el .zip y copia la carpeta resultante en el directorio /modules de tu tienda por FTP o SSH, manteniendo el nombre de la carpeta tal cual sale del .zip. El módulo aparecerá entonces en el Gestor de módulos, donde pulsas Instalar.
• En ambos casos, termina en el Gestor de módulos: «Configurar» abre la página de ajustes del propio módulo en el back office. Desinstalarlo desde esa misma pantalla elimina las tablas, las pestañas y los ajustes que había creado.

Instálalo primero en una copia de pruebas de tu tienda y recórrelo allí. Es PHP corriente que te pertenece — léelo, cámbialo, pásaselo a tu programador — pero es código que tu tienda no ha ejecutado nunca, y una tienda en producción es mal sitio para descubrirlo.

Límites y expectativas

• Un módulo cada vez, del tamaño de lo que un buen programador construiría en un día. Una idea más grande se recorta durante la conversación hasta la versión más pequeña que se sostiene sola, y el resto se propone como otro módulo posterior.
• Solo PrestaShop 8.x y 9.x, con PHP 8.1 o superior. Nada anterior está soportado, tampoco la 1.7.
• El módulo se construye y se prueba sobre una instalación estándar de PrestaShop. Un tema muy personalizado, u otro módulo que se pelee por el mismo hook, todavía puede pedir ajustes una vez esté en tu tienda.
• Un módulo puede hablar con un servicio externo, pero la cuenta y las credenciales son tuyas y esa parte no se puede ejercitar en las pruebas. Da por hecho que una integración así hay que verificarla en tu propia tienda de pruebas.
• Aprobar cierra la especificación. A partir de ahí la conversación sigue la construcción en lugar de aceptar cambios, así que una revisión es un build nuevo y otro crédito. Lee el resumen antes de pulsar el botón.
• Lo que descargas es el .zip del módulo. La guía ilustrada que se escribe durante la construcción no va dentro; escríbenos si quieres una copia.
• Sin acceso en ninguna dirección: no se instala nada en tu tienda por ti y el módulo nunca llama a casa. Eso también significa que no hay actualizaciones automáticas: lo que descargaste se queda como está hasta que construyas algo nuevo.
• Hay builds que fallan. Un paso que sigue saliendo mal se reintenta hasta tres veces y después el módulo se marca como que necesita atención, en lugar de entregar algo roto. Lo verás en la página del módulo, y nosotros lo revisamos.