=== MWR Hit Counter ===
Colaboradores: scriptsworks
Autor: Daniel Martín Ochoa
URL del autor: https://miwebrentable.com
Enlace de donaciones: https://www.paypal.me/miwebrentable
Etiquetas: contador de visitas, contador de páginas, visitas, contador, bloque Gutenberg
Requiere al menos: 5.0
Probado hasta: 7.1
Requiere PHP: 7.4
Versión estable: 1.4.0
Licencia: GPLv2 o posterior
URL de licencia: https://www.gnu.org/licenses/gpl-2.0.html

MWR Hit Counter es un contador global y ligero para WordPress con doce estilos visuales, tamaños, comportamiento de conteo configurable, formato numérico, opciones por shortcode y bloque Gutenberg.

== Descripción ==

MWR Hit Counter muestra un único contador para todo el sitio. Cada shortcode o bloque utiliza el mismo total almacenado. Incluye estilos para distintos diseños y permite personalizar la apariencia sin instalar una plataforma de analítica externa.

== Características ==

* Doce estilos: Classic, Digital, Dot Matrix, Modern, Sky Blue, Neon, Minimal, Flip Clock, Digital Watch, Compact Counter, Bubble Counter y Plain Text.
* Tres tamaños: Normal, Small y Compact.
* Conteo una vez por navegador durante 30 días o en cada carga de página.
* Exclusión opcional de usuarios conectados con permiso para administrar los ajustes.
* Separadores numéricos y precisión configurable para valores compactos.
* Opciones por shortcode para estilo, tamaño, animación, formato y precisión.
* Bloque dinámico de Gutenberg con ajustes individuales.
* Flip Clock imita un contador mecánico de paletas y anima los cambios de cifra.
* Digital Watch dibuja los números con siete segmentos luminosos.
* Compact Counter abrevia cifras grandes con K, M, B y T sin modificar el total almacenado.
* Bubble Counter muestra cada cifra en una burbuja; los separadores quedan fuera.
* Plain Text evita los estilos decorativos del plugin para que se pueda personalizar con CSS.
* Vista previa en vivo, copia del shortcode con un clic y widget en el escritorio de WordPress.
* Panel adaptable con secciones desplegables.

== Notas de actualización ==

La versión 1.4.0 incorpora una migración de compatibilidad para instalaciones antiguas que guardaban el total en la columna `counter`. Si `count` está vacío y existe un valor antiguo positivo, se copia a `count`; nunca se sobrescribe un total moderno distinto de cero. Se conserva el shortcode `[mwrcounter]` y el comportamiento actual de sus atributos.

El atributo `start` mantiene el comportamiento establecido desde la versión 1.3.0: inicializa el total guardado solo cuando el total es cero. Esta versión no cambia ese comportamiento para evitar alterar sitios existentes.


== Instalación ==

1. Haz una copia de seguridad de los archivos del plugin y de la base de datos.
2. Sube el ZIP desde Plugins > Añadir nuevo > Subir plugin. Si WordPress no permite reemplazar la versión instalada, desactívala y reemplaza los archivos sin borrar los datos del plugin.
3. Activa MWR Hit Counter.
4. Ve a Ajustes > MWR Hit Counter para configurar los valores predeterminados.
5. Añade [mwrcounter] a una página o entrada, o inserta el bloque MWR Hit Counter en Gutenberg.

== Estilos ==

* Classic: contador claro con borde oscuro.
* Digital: cifras verdes sobre un fondo oscuro estilo terminal.
* Dot Matrix: números creados con una cuadrícula de 5x7 píxeles luminosos cuadrados, inspirada en los displays electrónicos clásicos.
* Modern: cifras blancas sobre fondo oscuro y esquinas redondeadas.
* Sky Blue: cifras blancas sencillas sobre un fondo azul claro.
* Neon: texto violeta con resplandor sobre fondo oscuro.
* Minimal: tipografía sencilla con subrayado sutil.
* Flip Clock: tarjetas retro de paletas abatibles. Activa la animación global o usa animation="1".
* Digital Watch: cifras dibujadas con siete segmentos LED de color violeta.
* Compact Counter: representa valores grandes como 1.25K, 2.4M, 1.2B o 1T. Los valores menores de 1.000 se muestran completos.
* Bubble Counter: coloca cada cifra numérica dentro de un círculo.
* Plain Text: muestra el número sin decoración propia del plugin y permite aplicar CSS personalizado.

== Ajustes globales ==

* Valor actual: establece manualmente el total que se mostrará.
* Estilo y tamaño: define valores predeterminados. El shortcode o bloque Gutenberg puede sobrescribirlos individualmente.
* Comportamiento del conteo: una vez por navegador cada 30 días, usando la cookie propia mwrcounter, o en cada carga de página. Varias instancias en una misma solicitud solo incrementan el total global una vez.
* Excluir administradores: omite las solicitudes de usuarios conectados con permiso manage_options.
* Formato numérico: usa el idioma del sitio de WordPress, separador de miles con punto, coma, espacio o sin separador.
* Decimales compactos: selecciona cero, uno o hasta dos decimales. Se eliminan los ceros finales innecesarios.

Nota: este plugin es un contador sencillo, no una plataforma completa de analítica. El modo de cookie aproxima una visita por navegador durante 30 días; no identifica personas de forma única. El modo de cada carga cuenta solicitudes renderizadas por el servidor. Una caché de página completa puede evitar que PHP se ejecute en visitas almacenadas en caché; los bots y las solicitudes automatizadas también pueden afectar el total.

== Shortcode ==

Uso básico:

[mwrcounter]

Atributos disponibles:

* style="classic|digital|dot-matrix|modern|sky-blue|neon|minimal|flip-clock|digital-watch|compact|bubble|plain": selecciona el estilo.
* size="normal|small|compact": selecciona el tamaño.
* animation="1" activa la animación; animation="0" la desactiva.
* format="locale|dot|comma|space|none": sobrescribe el formato numérico.
* precision="0|1|2": sobrescribe la precisión de Compact Counter.
* start="100": establece el total inicial en 100 solo si el total guardado es cero.

Ejemplos:

[mwrcounter]
[mwrcounter style="flip-clock" animation="1" size="small"]
[mwrcounter style="digital-watch"]
[mwrcounter style="compact" format="dot" precision="1"]
[mwrcounter style="bubble" size="compact"]
[mwrcounter style="plain" format="space"]

Cuando se omite un atributo, se utiliza el ajuste global correspondiente. Todos los contadores comparten el mismo total global.

== Bloque Gutenberg ==

Busca "MWR Hit Counter" en la categoría Widgets del editor. El bloque dinámico comparte el total global con el shortcode y puede sobrescribir el estilo, tamaño, animación, formato y precisión. El marcador de posición del editor no incrementa el contador.

== Tamaños ==

* Normal: tamaño predeterminado.
* Small: tamaño reducido para barras laterales y zonas compactas.
* Compact: el tamaño más pequeño.

== Personalización CSS ==

Cada instancia incluye la clase .mwr-hit-counter, una clase de estilo y otra de tamaño. El plugin no fuerza la alineación: utiliza el bloque contenedor, el tema o CSS personalizado para ubicarlo.

Ejemplo para Plain Text:

.mwr-hit-counter.mwr-counter-plain {
    font-size: 2rem;
    color: #333333;
    font-weight: 700;
    text-decoration: none;
}

Clases de estilo: .mwr-counter-classic, .mwr-counter-digital, .mwr-counter-modern, .mwr-counter-neon, .mwr-counter-minimal, .mwr-counter-flip-clock, .mwr-counter-digital-watch, .mwr-counter-compact, .mwr-counter-bubble y .mwr-counter-plain.

Clases de tamaño: .mwr-counter-size-normal, .mwr-counter-size-small y .mwr-counter-size-compact.

== Preguntas frecuentes ==

= ¿Cuenta visitantes únicos? =

No. El modo de cookie limita los incrementos repetidos desde el mismo navegador durante 30 días. No identifica a una persona de forma exacta.

= ¿Puedo mostrar varios estilos con el mismo total? =

Sí. Cada shortcode o bloque puede utilizar su propio estilo, tamaño y formato numérico, mientras comparte el total global.

= ¿Compact Counter cambia el valor almacenado? =

No. Solo cambia la presentación. Por ejemplo, 1.250 puede mostrarse como 1.25K o 1,25K según el idioma y la configuración.

= ¿Puedo excluir mis propias visitas? =

Activa "Excluir administradores" en los ajustes. Se omiten las solicitudes de usuarios conectados que puedan administrar los ajustes del sitio.

= ¿Se conservan los datos al actualizar? =

Sí. La actualización conserva la tabla del contador y los nombres de las opciones existentes.

== Registro de cambios ==

= 1.4.0 =
* Se amplió el contador a doce estilos visuales, incluidos Flip Clock, Digital Watch, Compact Counter, Bubble Counter, Plain Text, Dot Matrix y Sky Blue.
* Se incorporaron los tamaños Normal, Small y Compact, con opciones por shortcode y bloque.
* Se añadieron modos de conteo configurables, exclusión opcional de administradores, formato numérico y precisión para valores compactos.
* Se incorporó un bloque dinámico de Gutenberg, conservando el shortcode `[mwrcounter]` y el contador global compartido.
* Se rediseñó el panel de ajustes con vista previa en vivo, galería de estilos y copia del shortcode con un clic.
* Se agregaron animación Flip Clock, dígitos de siete segmentos y estilos visuales adicionales.
* Se incluyeron traducciones al español de España y Argentina y mejoras de internacionalización.
* Se mejoró la migración de tablas antiguas para conservar los totales existentes al actualizar.
* Se añadió una sección informativa de MWR Hit Counter Pro y se renovaron los enlaces de soporte.
