La guía completa y documentación de Stella Ratings and Reviews, un plugin de valoración y reseñas en estrellas ligero, rápido y configurable para WordPress.

Tabla de Contenidos

1. Introducción y Arquitectura Principal
2. Instalación y Configuración
3. Shortcodes y Bloques de Diseño
4. Configuración General del Sistema
5. Campos de Formulario y Personalización
6. Ubicación Automática e Inserción
7. Seguridad, Límites y Anti-Spam
8. Características de la Versión Gratuita
9. Configuración de Características Pro
10. Integración con WooCommerce
11. Análisis e Informes Estadísticos
12. Gestión de Datos y Desinstalación
13. Licencias y Soporte Premium

1. Introducción y Arquitectura Principal

Stella Ratings and Reviews es un plugin de valoración y reseñas profesional de alto rendimiento diseñado para WordPress. Desarrollado desde cero para priorizar la velocidad de carga de la web, la limpieza de la base de datos y la máxima flexibilidad, permite a los propietarios de sitios web recopilar opiniones de clientes, mostrar resúmenes de estrellas interactivos y aprovechar las valoraciones para incrementar las conversiones y el posicionamiento en los motores de búsqueda.

El plugin está estructurado en dos partes bien diferenciadas:

Stella Ratings and Reviews (Núcleo Gratuito): Gestiona el selector de estrellas principal, el envío de reseñas por los usuarios, el panel de moderación básica AJAX, las etiquetas de traducción personalizadas en el frontal y las medidas de seguridad contra el spam.
Stella Ratings and Reviews Pro (Premium): Desbloquea funcionalidades visuales avanzadas como valoraciones divididas por múltiples criterios, subida de archivos multimedia (fotos y vídeos), estado automático de comprador verificado, marcado estructurado SEO JSON-LD para Google Rich Snippets, respuestas oficiales del administrador y plantillas de diseño exclusivas.

2. Instalación y Configuración

Cómo instalar la versión gratuita

Inicie sesión en su panel de administración de WordPress.
Vaya a Plugins > Añadir nuevo.
En la barra de búsqueda superior escriba Stella Ratings and Reviews.
Haga clic en Instalar ahora y, una vez descargado, pulse en Activar.

Cómo instalar la versión Pro

Importante: La versión gratuita de Stella Ratings and Reviews debe estar instalada y activa antes de poder habilitar el plugin Pro.

Descargue el archivo stella-ratings-pro.zip desde su panel de cliente.
Vaya a Plugins > Añadir nuevo en WordPress y haga clic en el botón superior Subir plugin.
Seleccione el archivo zip de su equipo y haga clic en Instalar ahora.
Una vez finalizado el proceso de subida, pulse en Activar plugin.

3. Shortcodes y Bloques de Diseño

Stella Ratings and Reviews le ofrece una libertad absoluta para colocar su sección de opiniones en el lugar que prefiera de la web. Puede insertar el widget en cualquier entrada, página fija o tipo de contenido personalizado.

Uso del Shortcode básico: `[stella_ratings]`

Por defecto, si añade este shortcode sencillo, el plugin cargará el widget interactivo y asociará automáticamente todas las valoraciones enviadas al ID de la página concreta en la que se encuentra incrustado.

Atributos avanzados del Shortcode

Puede refinar el funcionamiento del shortcode utilizando los siguientes parámetros:

Atributo	Tipo	Por defecto	Descripción
`product_key`	Texto	Slug de la página actual	Vincula las calificaciones a una clave de producto o servicio a su elección (por ejemplo: `[stella_ratings product_key="servicio-premium"]`). Ideal para landing pages o elementos dinámicos.
`limit`	Entero	`10`	Establece el número máximo de opiniones visibles antes de requerir paginación o el botón de carga progresiva.
`post_id`	Entero	ID de la entrada actual	Fuerza al widget a mostrar las opiniones vinculadas de forma exclusiva a un número de ID de post específico de WordPress.

Bloque nativo para Gutenberg

Para aquellos sitios modernos que utilizan el editor por bloques (Gutenberg), el plugin incluye el bloque nativo Stella Ratings Block. Busque "Stella Ratings" en el buscador de bloques y arrástrelo a su diseño. Podrá configurar todos los parámetros de manera visual desde el menú lateral derecho.

4. Configuración General del Sistema

Ajuste el funcionamiento básico del sistema de valoración accediendo a Stella Ratings > Ajustes en el menú lateral de su panel de control.

Reseñas por página: Configura la cantidad de opiniones que se muestran antes de que el usuario tenga que interactuar para ver más.
Activar botón "Cargar más": Oculte la paginación numérica tradicional y active un moderno sistema asíncrono basado en AJAX con un botón de carga progresiva.
Orden de clasificación predeterminado: Elija bajo qué criterio se ordenan las valoraciones en la carga inicial (ej. Más recientes, Mejor puntuadas o Más útiles).
Restringir a usuarios registrados: Impida la participación de visitas anónimas obligando a los usuarios a iniciar sesión en WordPress antes de enviar una reseña.

5. Campos de Formulario y Personalización

En la sección de **Configuración de Campos del Formulario** de los ajustes, tiene el control total sobre los campos de datos que introduce en el frontal.

Campos estándar

Gestione la presencia y obligatoriedad de los siguientes campos de datos:

Su Nombre: El alias público que identifica al autor de la reseña.
Su Correo Electrónico: Dirección de email privada (vital para las medidas de control anti-spam y comprobaciones de compras).
Su Sitio Web: Enlace opcional a la web del usuario.
Texto de la Reseña: El cuerpo del mensaje de opinión del cliente.

Configuración de campos personalizados

Añada campos adicionales adaptados a su negocio (como por ejemplo "Nombre de la empresa", "Grupo de edad" o "Talla adquirida") directamente desde el creador de campos en los ajustes. Esta información extra se asocia a la reseña y se muestra bajo el nombre del autor para dar mayor contexto al resto de compradores.

6. Ubicación Automática e Inserción

Si desea ahorrarse el trabajo de pegar el shortcode manualmente en cada publicación, configure las reglas de inserción global en la sección de Ubicación Automática.

Activar ubicación automática: Habilita la inserción automática del widget según las reglas que defina.
Tipos de contenido objetivo: Marque los tipos de contenido donde deba mostrarse (ej. Entradas, Páginas o formatos personalizados).
Categorías / Términos de taxonomía: Restrinja la inserción para que actúe únicamente en determinadas categorías de WordPress.
Posición en pantalla: Seleccione si prefiere que se inserte Debajo del contenido del post o en la parte superior del artículo.

7. Seguridad, Límites y Anti-Spam

Blindes su sitio web frente a posibles intentos de fraude en las votaciones, bots y spam publicitario mediante herramientas avanzadas de control.

Una reseña por correo electrónico: Limita cada dirección de email a una sola opinión por cada clave de producto. Si se intenta votar de nuevo, se muestra un mensaje emergente de advertencia personalizable.
Limitación de tasa por IP: Evite el envío masivo de opiniones bloqueando la subida desde una misma IP si supera el máximo configurado por horas (ej. máximo 3 valoraciones por IP cada 2 horas).
Control de flujo AJAX anti-spam: Ralentiza de forma inteligente los procesos de envío para detener ataques automatizados sin mermar la experiencia del usuario.

8. Características de la Versión Gratuita

La versión gratuita incluye una excelente base de herramientas de primer nivel listas para su uso en entornos de producción:

Ultra rápido y ligero: Optimizado para la máxima velocidad y rendimiento del sitio con cero sobrecarga de base de datos y carga mínima de recursos.
Moderación dinámica por AJAX: Modere, apruebe o elimine reseñas de usuarios al instante desde un panel de control único y sin recargas de página.
Campos de formulario personalizados: Agregue, elimine o personalice campos fácilmente (como "Nombre de la empresa" o "Puesto de trabajo") para recopilar información de clientes a medida.
Integración flexible mediante shortcodes: Coloque el widget de calificación de estrellas en cualquier lugar usando el shortcode simple [stella_ratings] con parámetros personalizados.
Adaptación inteligente al tema: Se adapta perfectamente al estilo, tipografía, colores y modos claro/oscuro de su tema activo de forma nativa.
Salvaguardas de privacidad del autor: Controles de visibilidad y encriptación de correo electrónico integrados para proteger la privacidad de los autores y cumplir con las normas de privacidad.
Barra de resumen visual de calificaciones: Muestra un hermoso desglose de calificaciones con porcentajes de estrellas y la puntuación promedio general.
Gestión granular de campos: Establezca campos específicos como obligatorios u opcionales para guiar a los usuarios durante el envío.
Carga selectiva de recursos: Carga scripts y hojas de estilo solo en las páginas donde el widget de reseñas está activo para evitar ralentizaciones generales en el sitio.
Seguridad robusta contra CSRF y spam: Utiliza nonces de WordPress y comprobaciones de validación internas para bloquear eficazmente los envíos de spam.
Seguimiento específico de productos: Vincule fácilmente las calificaciones a claves únicas mediante atributos de shortcode para segmentar las reseñas por producto.

9. Configuración de Características Pro

El plugin Pro abre todo un ecosistema de herramientas diseñadas para elevar la imagen de marca de su negocio en internet. Incluye las siguientes ventajas Pro:

Diseños premium de Glassmorphism: Elija entre modernos diseños visuales, impresionantes modos oscuros o elegantes cuadrículas tipo masonry.
Respuestas oficiales del propietario: Genere confianza respondiendo públicamente a los comentarios positivos o negativos directamente desde el panel de administración.
Archivos multimedia adjuntos: Permita a los usuarios subir fotos o videos de alta calidad con sus reseñas para mostrar el uso en la vida real.
Sistema de votación de utilidad: Permita a los visitantes votar a favor o en contra de las reseñas para destacar de forma dinámica los comentarios más útiles.
Edición directa de reseñas: Permita a los clientes o compradores registrados actualizar, modificar o corregir sus calificaciones enviadas previamente.
Aprobación automática de reseñas: Ahorre tiempo administrativo aprobando automáticamente las reseñas de clientes verificados o usuarios conectados.
Filtrado avanzado de reseñas: Permita a los usuarios clasificar y filtrar las reseñas por más recientes, mayor calificación, menor calificación o más útiles.
Marcado de esquemas enriquecidos de Google (Rich Snippets): Genera automáticamente marcado de esquemas listo para SEO para que las estrellas de calificación aparezcan en los resultados de búsqueda.
Integración directa con WooCommerce: Reemplaza o mejora perfectamente el sistema de reseñas nativo de WooCommerce con la moderna interfaz de Stella.
Alertas de notificación por correo electrónico: Notifique instantáneamente a los administradores del sitio por correo electrónico cada vez que se envíe una nueva reseña.
Análisis histórico de calificaciones: Visualice gráficos intuitivos en el panel de control para realizar un seguimiento de las tendencias de calificación y el volumen de reseñas a lo largo del tiempo.
Licencia para un solo sitio: Úselo en un solo sitio web de producción con actualizaciones automáticas y soporte.
Licencia multisitio: Úselo en múltiples sitios web con soporte prioritario y actualizaciones.

Cómo habilitar y configurar las herramientas Pro

A. Valoraciones multi-criterio

Permite a los usuarios puntuar aspectos detallados de su producto (como Calidad, Atención al cliente, Envío, Relación Calidad-Precio).

Acceda a Stella Ratings > Ajustes > Características Pro.
Active la casilla de verificación Habilitar valoraciones multi-criterio.
En el cuadro de texto de Definir criterios, escriba los términos que desee separados por comas (ej. Calidad, Precio, Soporte, Envío).
Guarde los cambios. Se mostrarán controles deslizantes individuales para cada opción y el panel administrativo calculará sus respectivas notas medias.

B. Subida de archivos multimedia (Fotos y Vídeos)

Aumente la credibilidad permitiendo a sus clientes añadir pruebas visuales reales a sus opiniones.

Máximo número de archivos: Límite cuántos archivos puede subir un usuario en una sola reseña (ej. Máximo 5).
Tamaño de archivo permitido: Fije un límite de Megabytes (ej. 5MB) para evitar saturar el almacenamiento de su hosting.
Extensiones de archivo válidas: Filtros de seguridad aceptan los formatos jpg, jpeg, png, webp para imágenes y mp4, mov, avi para grabaciones de vídeo. Al hacer clic sobre ellos en la web se abren en un elegante visor interactivo.

C. Marcado estructurado Schema para Google SEO

Introduce código JSON-LD en las cabeceras de su web de forma automática.

Active el **Esquema de Calificación Agregada (Aggregate Rating Schema)** para alimentar la nota media global a los robots de búsqueda de Google.
Active **Incluir reseñas individuales en el marcado** para exportar también las opiniones escritas completas con los nombres de sus autores.
Compruebe la validez del marcado introduciendo la URL de su página de producto en la herramienta oficial de Google Rich Results Test.

D. Votaciones de utilidad

Muestra unos botones discretos bajo cada comentario en los que los usuarios pueden valorar su relevancia mediante pulgares arriba ("Útil") o abajo ("No útil"). Las opiniones que más votos útiles acumulen subirán de forma automática a la parte superior de la lista.

E. Respuestas oficiales de la dirección

Interactúe con su audiencia respondiendo de manera formal.

Acceda al panel de control general de Stella Ratings en el menú administrador.
Localice la opinión que desee comentar y pulse en Responder.
Escriba su mensaje en la ventana emergente AJAX y pulse en guardar. Su respuesta se mostrará anidada directamente bajo el comentario original con una etiqueta que la identifica como respuesta del propietario de la web.

F. Plantillas de diseño Premium

Actualice la imagen de su sección de opiniones seleccionando estilos avanzados en el panel de control: **Glassmorphism** (efecto de cristal translúcido), **Modo Oscuro Moderno** o la maquetación en **Cuadrícula Masonry** para distribuir las valoraciones en dinámicas tarjetas visuales.

10. Integración con WooCommerce

Stella Ratings and Reviews Pro incluye soporte avanzado para WooCommerce. Marcando la opción Integración directa con WooCommerce en los ajustes del plugin, el sistema reemplazará al instante el módulo de opiniones clásico de sus páginas de producto de WooCommerce por la atractiva interfaz de Stella.

Etiquetas automáticas de Comprador Verificado

Cuando un usuario identificado que ha comprado previamente el artículo escribe su opinión, Stella comprueba de forma automática su historial de pedidos de WooCommerce. Si confirma el pago de una compra completada, añadirá un **Sello dorado de Comprador Verificado** junto a su nombre de usuario en la tienda, eliminando cualquier duda sobre la veracidad de su reseña.

11. Análisis e Informes Estadísticos

Visite la sección de Stella Ratings > Análisis para estudiar el estado y la evolución de las críticas de su comercio.

Índice de Satisfacción del Cliente (CSAT): Muestra la relación porcentual entre las opiniones excelentes (4 y 5 estrellas) y el volumen total recibido.
Ratio de Compradores Verificados: Gráfico de reparto que detalla el volumen de opiniones emitidas por compradores reales frente al de los clientes generales.
Matriz Leaderboard de contenidos: Listado detallado de todas las páginas de la web con el número de críticas acumuladas, nota media global y porcentaje de respuestas completadas.

12. Gestión de Datos y Desinstalación

Para evitar dejar residuos innecesarios en caso de limpieza de su instalación, el plugin respeta el control de datos de su base de datos.

Eliminar datos al desinstalar: Si marca esta opción en los ajustes de la Danger Zone, el plugin borrará de forma permanente todas las opiniones, tablas SQL de votaciones, registros de spam y configuraciones al desinstalar. Manténgala desactivada si solo desea apagar el plugin de forma temporal sin perder las reseñas escritas.

Stella Ratings and Reviews - Documentación y guía útil