manifest / content / excel-visualizer

LuRoss Tablas

Muestra hojas de cálculo de Google (publicadas como CSV) en el sitio, con caché, buscador y orden. Uso: [luross_tabla hoja="slug"]

by Lucuma Agency · github.com/lucumaagency/excel-visualizer

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/lucumaagency/excel-visualizer/archive/refs/heads/main.zip

No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Readme github.com/lucumaagency/excel-visualizer ↗

Plugin de WordPress para mostrar una hoja de cálculo de Google (publicada como CSV) dentro del sitio, con caché, buscador, orden y paginación. Solo visualiza: no escribe nada en la hoja.

Sin dependencias externas. No carga DataTables ni jQuery.

Instalación

Deploy desde GitHub (WP Pusher / GitHub Deploy). El archivo principal luross-tablas.php está en la raíz del repo, que es lo que espera el instalador.

También se puede instalar descargando el repo como ZIP y subiéndolo en Plugins → Añadir nuevo → Subir plugin.

Publicar la hoja

Si el archivo es un .xlsx subido a Drive (URL con rtpof=true), ábrelo y haz Archivo → Guardar como Hoja de cálculo de Google. Un xlsx subido no ofrece "Publicar en la web".
En la copia nativa: Archivo → Compartir → Publicar en la web.
Selecciona solo la pestaña que quieres mostrar y el formato CSV.
Publica y copia la URL.

Ojo: publicar en la web hace esa pestaña accesible para cualquiera con el enlace. No la uses con datos internos.

Configuración

En Ajustes → LuRoss Tablas registras cada hoja:

Campo	Descripción
Slug	Identificador que usarás en el shortcode
Título	Se muestra encima de la tabla (opcional)
URL	La URL del CSV publicado
Caché	Minutos que se guarda la respuesta antes de volver a leer Google

El botón Vaciar caché fuerza una relectura inmediata.

Uso

[luross_tabla hoja="precios"]

Parámetro	Por defecto	Descripción
`hoja`	—	Slug de la hoja registrada. Obligatorio
`titulo`	el configurado	Sobrescribe el título
`buscador`	`si`	Campo de búsqueda en vivo
`orden`	`si`	Ordena al hacer clic en el encabezado
`encabezado`	`si`	La primera fila del CSV es la cabecera
`filas`	`0`	Filas por página. `0` muestra todas
`saltar`	`auto`	Descarta las filas de título previas a la cabecera. Acepta un número de filas
`estados`	`si`	Si hay una columna "estado", sus valores se pintan como etiquetas de color

Ejemplo con paginación y sin buscador:

[luross_tabla hoja="precios" filas="25" buscador="no"]

Detalles

El CSV se parsea con fgetcsv, así que respeta comillas y saltos de línea dentro de una celda.
Se descartan filas y columnas completamente vacías, que Google suele añadir de sobra.
El orden detecta valores numéricos (S/ 1,250.00, 45%) y los compara como números, no como texto.
La búsqueda ignora tildes.
Muchas hojas traen una o varias filas de título antes de la cabecera real. Con saltar="auto" se detecta la primera fila que tiene al menos el 60% de sus celdas con contenido y se toma como cabecera.
Si existe una columna cuyo nombre contiene "estado", sus valores se pintan como etiquetas: verde para disponible, gris para vendido, ámbar para separado y reservado. Cualquier otro valor usa el gris neutro. Se añaden más en el CSS con .lt-estado[data-estado="..."].
En pantallas menores a 640px cada fila se apila como ficha, usando la cabecera como etiqueta de cada dato.
Los errores (hoja sin publicar, URL caída) solo se muestran a usuarios que pueden editar contenido. El visitante no ve nada.

Colores

Definidos como variables CSS en .lt-wrap, para ajustarlos sin tocar el resto de la hoja de estilos:

.lt-wrap {
    --lt-acento: #e87a1e;
    --lt-texto:  #1a1a1a;
    --lt-suave:  #555;
    --lt-linea:  #ececec;
    --lt-fondo:  #fafaf8;
}