Domine Maria Ratings con esta completa guía de instalación y usuario, que abarca desde la configuración básica hasta funciones avanzadas y antispam.

1. Requisitos del Sistema

PHP: Versión 8.0 o superior.
Extensiones: json y mbstring son obligatorias. Si elige MySQL/MariaDB, la extensión mysqli también es obligatoria.
CAPTCHA (Pro): Para usar Cloudflare Turnstile o Google reCAPTCHA v3, se requiere HTTPS saliente (se prefiere curl; de lo contrario, allow_url_fopen debe estar On en php.ini).
Correos (Pro): Se requieren capacidades SMTP salientes o PHP mail() para la verificación Doble Opt-in y correos de notificación al administrador.

2. Guía de Instalación

Paso 1: Subir los Archivos

Extraiga el archivo comprimido de Maria Ratings y suba la carpeta completa a su entorno de alojamiento web a través de FTP, SFTP o el administrador de archivos de su panel de control.

Paso 2: Ejecutar el Instalador

Navegue al archivo de instalación en su navegador (por ejemplo: https://su-sitio.com/maria-ratings/install.php). El instalador visual le guiará para crear su cuenta de administrador (usuario y contraseña).

Paso 3: Elegir un Motor de Almacenamiento

Durante la instalación, debe seleccionar cómo desea almacenar los datos:

Archivos JSON: La opción más simple. Requiere cero configuración y es ideal para sitios pequeños o pruebas. Asegúrese de que su carpeta storage/ tenga permisos de escritura.
MySQL/MariaDB: Altamente recomendado para entornos de producción, funciones multimedia Pro y sitios web de alto tráfico. Necesitará proporcionar su host, base de datos, usuario, contraseña y prefijo de tabla.

Una vez completada la instalación, puede iniciar sesión en su panel de administración navegando a /admin/.

3. Actualizar de Free a Pro

Si está actualizando de Maria Ratings Free a Pro, no tiene que perder sus reseñas existentes:

Suba los archivos Pro y sobrescriba su instalación Free existente.
Importante para usuarios JSON: Asegúrese de no sobrescribir su directorio storage/ existente, ya que este contiene sus datos en vivo.
Si utilizó MySQL/MariaDB, simplemente ejecute el instalador Pro y conéctese con exactamente las mismas credenciales de base de datos. Sus datos existentes serán reconocidos automáticamente.

4. Insertar el Widget de Reseñas

Para mostrar el widget de reseñas en su sitio web, coloque el siguiente fragmento HTML exactamente donde desea que aparezcan las reseñas:

<div data-maria-ratings data-product-key="id-de-su-producto"></div>
<script src="https://su-sitio.com/maria-ratings/embed.js" defer></script>

Nota: Cambie id-de-su-producto a un identificador único para el producto, servicio o página específica que se está reseñando. Esto asegura que las reseñas se mantengan separadas en su sitio.

5. Panel de Administración y Moderación

Inicie sesión en su panel (/admin/index.php) para gestionar sus reseñas. Desde aquí, puede:

Moderar Reseñas: Aprobar, rechazar o eliminar reseñas pendientes.
Responder a Clientes (Pro): Publicar respuestas del propietario directamente debajo de las reseñas.
Exportar Datos: Descargar un archivo CSV con todas sus reseñas para copias de seguridad o análisis externo.
Configurar Ajustes: Ajustar los límites de envío, palabras bloqueadas, campos de formulario y orígenes permitidos.

6. Guía Detallada de Configuración

El panel de Maria Ratings está dividido en varias pestañas. Aquí hay un desglose completo de lo que puede controlar:

Configuración General

Auto-Aprobar Reseñas: Elija si las reseñas se publican de inmediato o se retienen para moderación manual. También puede configurarlo para auto-aprobar solo reseñas de 4 y 5 estrellas.
Reseñas Por Página: Controle cuántas reseñas se cargan inicialmente antes de que el usuario tenga que hacer clic en "Cargar Más".
Ordenación: Establezca el comportamiento predeterminado (Más recientes, Más antiguas, Mayor calificación o Menor calificación).
Tema: Cambie entre temas predeterminados (como Clásico u Oscuro) para que coincida con la estética de su sitio.
Orígenes Permitidos: Una configuración crítica de seguridad. Ingrese los dominios exactos (ej. https://su-sitio.com) donde su widget está incrustado para evitar que los atacantes envíen reseñas desde webs no autorizadas.

Campos de Formulario y Mensajes

Visibilidad y Requisitos de Campos: Tome control total sobre Nombre, Correo y Sitio Web. Para cada uno, decida si se muestra en el formulario, si es obligatorio y si se muestra públicamente.
Textos Personalizados y Traducciones: Personalice el texto de botones, etiquetas y mensajes de éxito. Este es el lugar perfecto para traducir el widget a su idioma.

Spam y Seguridad (Free y Pro)

Límite de Tasa por IP: Restrinja cuántas reseñas se pueden enviar desde la misma dirección IP en un plazo específico (ej. límite de 3 reseñas por 24 horas) para detener inundaciones.
Una Reseña Por Correo: Evite que los usuarios inflen artificialmente las calificaciones enviando múltiples reseñas para el mismo producto con el mismo correo electrónico.
Palabras Bloqueadas: Cree una lista separada por comas de palabras prohibidas (groserías, nombres de la competencia, o "http://"). Las reseñas que las contengan serán bloqueadas.

Funciones Pro e Integraciones

Si utiliza Maria Ratings Pro, tiene acceso a una suite dedicada de configuraciones premium:

Carga de Medios: Active la subida de fotos y videos. Puede establecer el número máximo de archivos por reseña y restringir el tamaño (en MB) para ahorrar espacio en su servidor.
Calificaciones Multicriterio: En lugar de solo una calificación general, puede definir métricas personalizadas (ej. Calidad, Valor, Soporte) y requerir que los clientes califiquen cada una.
Editor de Texto Enriquecido: Reemplaza el cuadro de texto estándar con un hermoso editor WYSIWYG, permitiendo texto en negrita, cursiva y formateado.
Votos de Utilidad: Permita a los visitantes del sitio votar si una reseña fue útil o no útil.
Insignias Verificadas: Muestre una insignia oficial de "Verificado" junto a los revisores que han completado la verificación por correo electrónico.
Esquema SEO (JSON-LD): Inyecte automáticamente datos estructurados en su web para que Google muestre estrellas de calificación directamente en los resultados de búsqueda.
Configuración CAPTCHA: Seleccione Google reCAPTCHA v3 o Cloudflare Turnstile para bloquear bots silenciosamente. Ingrese su Clave de Sitio y Clave Secreta para activarlo.
Configuración de Correo SMTP: Ingrese sus credenciales SMTP (Host, Puerto, Usuario, Contraseña, Encriptación) para enviar correos de verificación Doble Opt-in de manera confiable.
Notificaciones al Administrador: Envíe automáticamente una alerta por correo a su bandeja de entrada en el momento en que se envía una nueva reseña.
Verificación Doble Opt-in: Para prevenir reseñas falsas, puede forzar a los usuarios a verificar su correo electrónico a través de un enlace automatizado antes de que la reseña pase a moderación.

7. Mejores Prácticas de Seguridad

Antes de lanzar su sistema de reseñas al público, asegúrese de aplicar estas medidas de seguridad:

Orígenes Permitidos: En la configuración, defina explícitamente los dominios permitidos. No use el comodín * en un entorno de producción.
Proteger el Almacenamiento JSON: Si usa JSON, debe bloquear el acceso web directo al directorio storage/ para evitar fugas de datos. Los usuarios de Apache están protegidos por defecto por el .htaccess incluido. Si usa Nginx o IIS, debe configurar las reglas de su servidor para denegar explícitamente el acceso a esta carpeta.

Maria Ratings: Guía completa de instalación y usuario