Documentación

Manual de Linsei

Cómo descargar, instalar, configurar y usar tu acortador, paso a paso y sección por sección.

1. Qué es Linsei

Linsei es un acortador de URLs autoalojado: lo instalas en tu servidor y, desde un panel, creas enlaces cortos, los personalizas y mides cada clic. Tus datos nunca salen de tu hosting.

Es ligero (PHP con MySQL o SQLite) y crece contigo: varios usuarios con roles, estadísticas, idiomas, API y complementos.

2. Requisitos

  • PHP 8.0 o superior con PDO.
  • MySQL/MariaDB (recomendado) o SQLite (sin configuración).
  • Servidor Apache (con mod_rewrite) o Nginx.
  • Acceso por FTP o gestor de archivos.
Sin MySQL, elige SQLite en el instalador: funciona sin configurar nada.

3. Descarga

  1. Pulsa Descargar Linsei (.zip).
  2. Descomprime el archivo: verás index.php y las carpetas app/, assets/, plugins/ y data/.

4. Instalación

Sin consola ni comandos:

  1. Sube todo el contenido por FTP a la carpeta pública (p. ej. public_html).
  2. Abre tu web en el navegador: aparece el instalador.
  3. Paso 1: requisitos. Paso 2: base de datos (MySQL o SQLite). Paso 3: usuario administrador.
  4. Linsei crea config.php y las tablas solo.
Al terminar, deja config.php en solo lectura y usa HTTPS.

5. Acceso al panel

Entra en https://tudominio.com/admin con tu usuario y contraseña. Desde ahí gestionas todo; para salir, usa Cerrar sesión.

6. El panel de inicio

Al entrar ves un resumen: total de enlaces, clics, clics de hoy y enlaces activos, con un gráfico de los últimos días. El botón «+ Nuevo enlace» crea uno en segundos. El menú lateral lleva al resto.

7. Crear y personalizar enlaces

Pulsa «+ Nuevo enlace» y rellena:

  • URL de destino (obligatoria).
  • Código/slug: automático si lo dejas vacío, o el tuyo (tudominio.com/promo).
  • Prefijos por campaña (blog-mi-enlace).
  • Prefijo de título para clasificar.
  • Actualizar si existe: reutiliza un slug sin duplicar.

Al guardar, copias el enlace corto. La lista muestra la fecha de creación y permite ordenar por columna (destino, clics, fecha, estado), buscar y seleccionar varios para acciones en lote: exportar, activar, desactivar o borrar. También editas, copias o borras cada enlace.

8. Caducidad y límites

  • Fecha de expiración: deja de redirigir a partir de esa fecha.
  • Máximo de clics: se desactiva solo al alcanzar el tope.

Ideal para promociones temporales o enlaces de un solo uso.

9. Estadísticas

Cada enlace tiene su página de estadísticas, con todo lo que necesitas:

  • Clics totales y por período (día, semana, mes, año), con clics únicos.
  • País del visitante (la geolocalización viene de serie, sin configurar nada), dispositivo, navegador y sistema operativo.
  • Fuentes de tráfico (de dónde llegan los clics) y reparto por hora y día de la semana.
  • Gráfico de evolución y comparación entre enlaces.

El administrador ve todo; cada gestor, lo suyo, con el ranking de sus enlaces más visitados.

10. Usuarios y roles

Como administrador, en Gestores creas cuentas (con su email) y las activas o desactivas. Si un gestor olvida su contraseña, puede recuperarla por email o el administrador puede cambiársela al momento. Hay dos roles:

RolQué puede hacer
AdministradorControl total: todos los enlaces y estadísticas, usuarios, ajustes y actualizaciones.
GestorSolo sus propios enlaces y sus estadísticas.

Cada gestor trabaja aislado: varios equipos comparten la misma instalación sin pisarse.

Acciones sobre un gestor:

  • Activar/desactivar: un gestor desactivado no puede entrar al panel, pero sus enlaces siguen funcionando y sus estadísticas se conservan. Es reversible.
  • Cambiar email de recuperación o cambiar contraseña: actualizas sus datos de acceso al momento.
  • Eliminar: al eliminar un gestor, Linsei te pregunta qué hacer con sus enlaces: reasignarlos a otro gestor (se conservan los enlaces y sus estadísticas) o borrarlos (sus URLs dejan de funcionar; irreversible). Si solo quieres impedirle el acceso, desactívalo en vez de eliminarlo.
La recuperación por email necesita un servidor SMTP, que configuras en Ajustes.

11. Exportar a CSV

Desde la lista o las estadísticas puedes exportar a CSV (Excel y Google Sheets) para informes o copias, con filtros por fechas y por gestor.

12. Idioma del panel

El panel está en 8 idiomas: español, inglés, francés, portugués, alemán, italiano, neerlandés y polaco. Cambia con el selector de la cabecera; tu elección se recuerda. Desde Ajustes → Idiomas activas o desactivas idiomas y subes uno nuevo (un .php traducido). También puedes dejarlo por FTP en data/lang/ (a salvo de las actualizaciones).

13. La API

Crea enlaces desde otros programas. Cada usuario tiene su token (en su perfil). Ejemplo:

curl -X POST https://tudominio.com/api/links \ -H "Authorization: Bearer TU_TOKEN" \ -H "Content-Type: application/json" \ -d '{"url":"https://ejemplo.com/pagina-larga","slug":"promo"}'

La respuesta incluye el enlace corto. Es lo que usa la extensión de Chrome.

14. Complementos

Linsei se amplía con complementos sin tocar el núcleo. Tres formas de instalarlos:

  • Desde Complementos en el panel, instala los oficiales con un clic.
  • Pulsa «Subir complemento» para subir tu propio .zip.
  • O copia su carpeta en plugins/ por FTP.

¿Quieres crear el tuyo? Se enganchan con hooks (acciones y filtros). Tienes una guía completa con un ejemplo.

15. Seguridad

  • Contraseñas con bcrypt y sesiones nativas.
  • Protección CSRF en todos los formularios.
  • Registro de actividad por usuario.
  • Archivos del núcleo protegidos contra acceso directo.

Usa siempre HTTPS y deja config.php en solo lectura.

16. Actualizar

Linsei se actualiza con un clic. En Ajustes → Actualizar Linsei ves tu versión instalada y, si hay una nueva, un botón «Actualizar a la última versión». Linsei descarga el núcleo, hace una copia de seguridad y reemplaza solo los archivos del programa.

La actualización nunca toca tus complementos, tus datos ni tu config.php: tus enlaces, estadísticas y ajustes se conservan, y si algo fallara restaura la copia automáticamente.

También puedes actualizar a mano subiendo de nuevo los archivos del paquete (sin borrar config.php ni data/), pero con el botón no hace falta.

17. Ayuda y soporte

Dentro del panel tienes una página de Ayuda (/admin/ayuda). ¿Dudas o fallos? Escríbenos desde contacto.