CC Solicitud de documentación Producto
Documentación completa para el módulo de consulta de productos para PrestaShop (cc_ps_product_question) con funciones avanzadas de seguridad, estilo y gestión detallada de formularios de consulta.Índice
- Introducción
- Instalación
- Activación de la licencia
- Panel de gestión
- Configuración general
- Aspecto y ubicación
- Estilo de los botones
- Estilo modal
- Configuración del formulario
- Configuración del correo electrónico
- Sistema de seguridad
- Gestión de preguntas
- Resolución de problemas
- PREGUNTAS FRECUENTES
1. introducción
CC Ask Product es un módulo avanzado que permite a los clientes hacer preguntas directamente en la página del producto. El módulo ofrece una interfaz intuitiva que aumenta el compromiso de los clientes y les ayuda a tomar decisiones de compra mediante una comunicación sencilla con el personal de la tienda.Funciones principales del módulo:
- Formulario de preguntas directamente en la página del producto
- Botón completo y estilo modal
- Campos de formulario flexibles (nombre, correo electrónico, teléfono, mensaje)
- Sistema de seguridad avanzado
- Plantillas de correo electrónico multilingües
- Gestión de preguntas en el panel de administración
- Múltiples enganches para posicionamiento
- Protección contra spam y bots
2. instalación
Requisitos del sistema- PrestaShop 1.7.0.0 o posterior
- PHP 7.2 o posterior
- MySQL 5.6 o posterior
- Permiso para instalar módulos
- 256 MB de RAM como mínimo (se recomiendan 512 MB)
- Descargue el archivo ZIP del módulo de la tienda oficial códigos.cocos
- Inicie sesión en el panel de administración de PrestaShop
- Vaya a: Módulos > Gestor de módulos > Añadir nuevo módulo
- Haga clic en "Añadir módulo" y seleccione el archivo ZIP descargado.
- Una vez finalizada la instalación, haga clic en "Configurar".
Información
Tras la instalación, el módulo creará automáticamente las tablas de base de datos necesarias, los directorios para los correos electrónicos y establecerá la configuración por defecto. Será necesario configurar el módulo y activar la licencia antes de utilizar plenamente todas las funciones.
3. activación de la licencia
Antes de poder utilizar todas las funciones del módulo, es necesario activar la licencia:- Tras la instalación, proceda a la configuración del módulo
- Seleccione la pestaña "Licencia
- Introduzca la clave de licencia recibida tras la compra
- Haga clic en "Activar licencia".
- Tras la activación, aparecerá un mensaje de confirmación y se desbloquearán todas las funciones del módulo.
Advertencia
Sin una licencia activa, el módulo funcionará en modo restringido: el formulario funcionará, pero no se enviarán correos electrónicos y aparecerá un mensaje sobre una licencia inactiva en la parte superior del panel de administración.
4 Panel de gestión
El panel de gestión del módulo consta de varias pestañas que permiten una configuración y gestión completas:Pestañas principales:
- Configuración - configuración del módulo principal, estilo y formulario
- Preguntas - lista manejable de todas las preguntas recibidas
- Documentación - enlace a la documentación en línea
- Ayuda - enlace a la página de asistencia
- Plug-ins - extensiones COCOS adicionales
- Licencia - gestión de licencias de módulos
5. ajustes generales
En la sección de ajustes generales encontrarás las opciones básicas que controlan el funcionamiento del módulo:| Configuración | Descripción | Valor por defecto |
| Encender el módulo | Encendido/apagado global del módulo | En |
- En - el cuestionario es visible en todas las páginas de productos
- Fuera de - el formulario no aparece en ninguna página de producto
Consejo
Utilice este interruptor para desconectar rápidamente el módulo sin desinstalarlo, por ejemplo, durante el mantenimiento del taller o las pruebas.
6 Aspecto y ubicación
Esta sección permite controlar totalmente el aspecto y la posición del botón de pregunta:Etiqueta del botón
Campo multilingüe para establecer textos de botón diferentes para cada idioma activo en la tienda. Por defecto: "Preguntar por este producto".
Posición de los botones
El módulo ofrece múltiples opciones de ganchos para la colocación de los botones:
| Gancho | Descripción del artículo | Uso recomendado |
| displayProductAdditionalInfo | En información sobre el producto | El artículo más popular |
| displayProductButtons | Junto al botón "Añadir a la cesta | Alto compromiso de los clientes |
| displayAfterProductThumbs | Después de las miniaturas de los productos | Cuando hay poco espacio en la sección principal |
| displayHeader | En la cabecera de la página | Siempre visible |
| displayFooter | En el pie de página | Posición secundaria |
| displayCustomProductQuestion | Gancho a medida | Requiere modificar el tema |
Nota
El cambio de posición anula automáticamente el registro del módulo en los ganchos antiguos y lo registra en el nuevo. Un gancho personalizado requiere que se añada una llamada en el lugar apropiado del tema.
7. estilo del botón
El módulo ofrece un control total sobre la apariencia del botón sin tener que editar el CSS:Colores de los botones
- Color de fondo - color principal del botón (por defecto: #007bff)
- Color del texto - color de la inscripción en el botón (por defecto: #ffffff)
- Color después de pasar el ratón - color de fondo al pasar el ratón por encima (por defecto: #0056b3)
- Color del borde - color del marco del botón (por defecto: #007bff)
- Grosor del marco - anchura del borde en píxeles (0 = sin borde)
- Redondeo de esquinas - radio de redondeo en píxeles
- Acolchado - espaciado interno en formato CSS (por ejemplo, "10px 20px")
- Tamaño de letra - elección entre tamaños predefinidos (12px-20px)
- Grosor de la fuente - de Ligero (300) a Negrita (700)
- Icono - icono opcional de pregunta junto al texto
Consejo
Todos los estilos se aplican con la bandera !important, lo que garantiza que funcionen independientemente del tema. Puede previsualizar los cambios en vivo después de guardar la configuración.
8 Estilo modal
Control igualmente detallado de la apariencia del cuadro de diálogo del formulario:Colores modales
- Fondo de la cabecera - color de fondo de la sección superior (por defecto: #f8f9fa)
- Texto de cabecera - color del título modal (por defecto: #495057)
- Fondo modal - fondo principal del formulario (por defecto: #ffffff)
- Color del borde - marco modal completo (por defecto: #dee2e6)
- Redondeo de esquinas - radio de redondez de todo el modal
- Anchura máxima - en px, %, vw (por defecto: 600px)
- Color de fondo - el color del fondo translúcido detrás del modal
- Transparencia - 0% (invisible) a 100% (opaco)
9. configuración del formulario
La configuración flexible de los campos del formulario permite adaptarlo a las necesidades de la tienda:Configuración de los campos de contacto
Cada campo tiene dos opciones: visibilidad y requisito
| Campo | Opciones de configuración | Ajustes por defecto |
| Nombre | Mostrar campo / Campo obligatorio | Visible y obligatorio |
| Correo electrónico | Mostrar campo / Campo obligatorio | Visible y obligatorio |
| Teléfono | Mostrar campo / Campo obligatorio | Visible pero no obligatorio |
| Mensaje | Mostrar campo / Campo obligatorio | Visible y obligatorio |
- Variantes de productos - mostrar una lista de combinaciones de productos disponibles
- Mensaje de bienvenida - texto que aparece en la parte superior del formulario
El módulo comprueba automáticamente:
- Corrección del formato del correo electrónico
- Corrección del número de teléfono
- Presencia de al menos una información de contacto
- Longitud máxima de los campos (1000 caracteres para un mensaje)
- Protección contra XSS e inyecciones
Advertencia
Si desactiva todos los campos de contacto o los establece como no obligatorios, los clientes podrán enviar preguntas anónimas. Recomendamos dejar al menos el correo electrónico como obligatorio.
10. configuración del correo electrónico
Sistema integral de envío de notificaciones por correo electrónico al administrador y a los clientes:Ajustes básicos
- Correo electrónico del administrador - la dirección del destinatario de las preguntas (por defecto: correo electrónico de la tienda)
- Copia al cliente - envío de un acuse de recibo al solicitante
- Información adicional - pie de página de correo electrónico con información de contacto
El módulo ofrece un sistema de plantillas flexible:
- Plantilla por defecto - diseño de mensajes estándar
- Plantillas personalizadas - posibilidad de crear tus propios patrones
- Vista previa de la plantilla - posibilidad de previsualizar antes de usar
{nombre_cliente} - nombre_cliente
{email_cliente} - email del cliente
{teléfono_cliente} - teléfono del cliente
{nombre_producto} - nombre_producto
{url_producto} - enlace del producto
{message} el contenido de la pregunta
{fecha} - fecha de envío
{nombre_tienda} - nombre de la tienda
{email_footer} - información adicional
{customer_ip} - Dirección IP (sólo para administradores)
Nota
Las plantillas de correo electrónico se crean automáticamente para todos los idiomas activos durante la instalación. Puede editarlas en la carpeta /modules/cc_ps_product_question/mails/.
11. sistema de seguridad
El módulo incluye mecanismos avanzados de protección contra el spam y los ataques:Protección Honeypot
Un campo oculto invisible para los usuarios pero rellenado por bots. Si se rellena, el formulario se rechaza.
Limitación de frecuencia
- Tiempo de bloqueo - ventana de tiempo límite (por defecto: 60 segundos)
- Número máximo - número permitido de preguntas de una IP (por defecto: 3)
- Tiempo mínimo - tiempo mínimo de llenado (por defecto: 3 segundos)
- Tiempo máximo - tiempo de caducidad del formulario (por defecto: 30 minutos)
Tres tipos de verificación disponibles:
| Tipo de CAPTCHA | Descripción | Requisitos |
| Pregunta simple | Acción matemática (por ejemplo, 5 + 3 = ?) | No |
| Gráfico | Imagen con código a transcribir | Ampliación de la DG |
| Google reCAPTCHA | Verificación externa de Google | Claves API |
Lista negra de IP
Posibilidad de bloquear direcciones IP específicas. Lista separada por comas, compatible con IPv4 e IPv6.
Registro de seguridad
Toda actividad sospechosa se registra en el registro de errores del servidor con información:
- Dirección IP del atacante
- Tipo de intento de infracción
- Fecha del ataque
- Datos contextuales adicionales
Consejo
Recomendamos activar al menos la protección Honeypot y la restricción de frecuencia. Utilice CAPTCHA solo para grandes cantidades de spam.
12 Gestión de preguntas
La pestaña "Preguntas" ofrece un completo panel para gestionar las preguntas recibidas:Lista de preguntas
Tabla con todas las preguntas incluidas:
- Pregunta ID - identificador único
- Fecha de envío - fecha de creación de la pregunta
- Datos del cliente - nombre, correo electrónico, teléfono y dirección IP
- Nombre del producto - a qué producto se refiere su pregunta
- Contenido de la pregunta - mensaje completo del cliente
- Acciones - operaciones sobre la cuestión
- Paginación - dividido en páginas (20 preguntas por página)
- Enlaces de contacto - direcciones de correo electrónico y teléfonos clicables
- Vista previa de IP - enlace para comprobar la localización IP
- Eliminación individual - supresión de preguntas seleccionadas
- Supresión de todos los - limpiar toda la lista
El panel muestra automáticamente información útil:
- El número total de preguntas del sistema
- Sin preguntas
- Mensajes de error de la base de datos
Advertencia
Borrar preguntas es irreversible. Asegúrese de haber respondido a sus clientes antes de borrar sus preguntas. La función "Borrar todo" borra toda la base de datos de preguntas.
13 Solución de problemas
El botón no aparece en la página del producto- Compruebe si el módulo está activado en los ajustes generales
- Asegurarse de que la licencia está activa
- Compruebe que el gancho seleccionado es compatible con la plantilla
- Borrar la caché de PrestaShop
- Comprobación de conflictos con otros módulos
- Compruebe si hay errores de JavaScript en la consola del navegador
- Asegúrese de que la URL AJAX es correcta
- Comprobar los permisos de la base de datos
- Desactivar CAPTCHA y la seguridad temporalmente
- Compruebe que existe la tabla cc_product_question
- Compruebe la configuración de correo electrónico en PrestaShop
- Asegúrese de que la dirección del administrador es correcta
- Compruebe su carpeta de correo no deseado
- Probar el envío de correos electrónicos desde otros módulos
- Compruebe los errores de Mail::Send en los registros del servidor
- Comprobar que la IP del cliente no está en la lista negra
- Garantizar que los plazos de llenado sean realistas
- Desactivar CAPTCHA si causa problemas
- Compruebe que el campo Honeypot no está visible
- Verifica las claves reCAPTCHA si utilizas Google
- Compruebe que la tabla tiene todas las columnas necesarias
- Asegúrese de que los permisos de MySQL son correctos
- Prueba a desinstalar y volver a instalar el módulo
- Compruebe los registros de errores de MySQL
- Póngase en contacto con el administrador del servidor
Error
Si tiene problemas insolubles con el módulo, asegúrese de que está utilizando la última versión y de que su tienda PrestaShop está actualizada. En caso de dificultades, póngase en contacto con el soporte de COCOS a través de cocos.codes/soporte.
14. PREGUNTAS FRECUENTES
¿Puedo colocar el botón en un lugar personalizado?Sí, seleccione el hook "displayCustomProductQuestion" y añada una llamada en el lugar apropiado de la plantilla:
{hook h='displayCustomProductQuestion'}.¿Cómo puedo cambiar el aspecto del formulario?
Puede editar los archivos CSS en la carpeta /modules/cc_ps_product_question/views/css/ o utilizar la configuración de estilo del panel de administración.
¿Puedo añadir campos adicionales al formulario?
Actualmente, el módulo admite campos predefinidos. Para añadir nuevos campos es necesario modificar el código fuente del módulo.
¿Cómo puedo crear una plantilla de correo electrónico personalizada?
Copie el archivo product_question_admin.html de la carpeta mails/[language]/ y cámbiele el nombre a, por ejemplo, custom_product_question_admin.html. A continuación, seleccione la plantilla "personalizada" en la configuración.
¿Funciona el módulo con productos combinados?
Sí, si activa la opción "Mostrar variantes de productos", los clientes podrán seleccionar una combinación específica en la pregunta.
¿Cuánto tiempo se guardan las preguntas?
Las preguntas se almacenan indefinidamente hasta que son borradas manualmente por un administrador.
¿Puedo exportar preguntas?
Actualmente, el módulo no tiene una función de exportación incorporada, pero todos los datos se encuentran en la tabla cc_product_question y se pueden exportar a través de phpMyAdmin.
¿Qué ocurre cuando caduca la licencia?
Cuando caduque la licencia, el formulario seguirá funcionando, pero no se enviarán correos electrónicos. El acceso para ver las preguntas guardadas se mantendrá.
¿Admite el módulo tiendas multilingües?
Sí, el módulo es totalmente compatible con tiendas multilingües. Las etiquetas de los botones se pueden configurar por separado para cada idioma y las plantillas de correo electrónico se crean para todos los idiomas activos.
¿Con qué frecuencia se actualiza el módulo?
El módulo se actualiza periódicamente para garantizar la compatibilidad con las últimas versiones de PrestaShop e introducir nuevas funciones. Los titulares de una licencia válida tienen acceso gratuito a todas las actualizaciones.
¿Puedo utilizar el módulo en un entorno de prueba?
Sí, la licencia también permite utilizar el módulo en subdominios de prueba (por ejemplo, test.mojsklep.pl) y entornos de desarrollo locales. Consulte las condiciones de la licencia para obtener más información.
¿Cómo funciona la protección contra el spam?
El módulo utiliza varias capas de protección: Honeypot (campo oculto), restricciones de frecuencia por IP, control del tiempo de llenado, CAPTCHA opcional y listas negras de IP.
¿Funciona el formulario con la caché de páginas?
Sí, el formulario se carga dinámicamente mediante AJAX, por lo que funciona correctamente incluso con la caché de página activada.
¿Cómo puedo comprobar si se están enviando correos electrónicos?
Compruebe la pestaña "Avanzado > Correo electrónico" en el panel de control de PrestaShop y pruebe a enviar un correo electrónico de prueba. Si la prueba pasa, el problema puede estar en la configuración del módulo.
¿Puedo cambiar la dirección "de quién" en los correos electrónicos?
Los correos electrónicos se envían desde la configuración predeterminada de su tienda PrestaShop. Para cambiar el remitente, modifique la configuración en "Avanzado > Email".
¿Qué significa el error "La tabla no existe"?
Esto significa que la tabla de la base de datos no se creó durante la instalación. Prueba a desinstalar y volver a instalar el módulo o ponte en contacto con el servicio de asistencia.
¿Cómo puedo cambiar la longitud máxima de un mensaje?
Actualmente el límite es de 1000 caracteres y está definido en el código de seguridad. El cambio requiere la modificación del archivo SecurityHandler.php.
¿Funciona el módulo con los módulos SEO?
Sí, el módulo no interfiere con las URL ni con los metadatos de las páginas, por lo que es compatible con los módulos SEO.
¿Cómo funciona la protección contra los ataques XSS?
El módulo analiza automáticamente los mensajes en busca de patrones sospechosos como
