Documentation

Manuel de Linsei

Comment télécharger, installer, configurer et utiliser votre raccourcisseur, étape par étape et section par section.

1. Qu'est-ce que Linsei

Linsei est un raccourcisseur d'URL auto-hébergé : installez-le sur votre serveur et, depuis un panneau, créez des liens courts, personnalisez-les et mesurez chaque clic. Vos données ne quittent jamais votre hébergement.

Léger (PHP avec MySQL ou SQLite), il évolue avec vous : plusieurs utilisateurs avec rôles, statistiques, langues, API et extensions.

2. Prérequis

  • PHP 8.0 ou plus avec PDO.
  • MySQL/MariaDB (recommandé) ou SQLite (sans configuration).
  • Apache (avec mod_rewrite) ou Nginx.
  • Accès FTP ou gestionnaire de fichiers.
Pas de MySQL ? Choisissez SQLite dans l'installateur : aucune configuration.

3. Téléchargement

  1. Cliquez sur Télécharger Linsei (.zip).
  2. Décompressez : vous verrez index.php et les dossiers app/, assets/, plugins/ et data/.

4. Installation

Ni console ni commandes :

  1. Envoyez tout par FTP dans le dossier public (p. ex. public_html).
  2. Ouvrez votre site : l'installateur apparaît.
  3. Étape 1 : prérequis. Étape 2 : base de données (MySQL ou SQLite). Étape 3 : administrateur.
  4. Linsei crée config.php et les tables tout seul.
Ensuite, mettez config.php en lecture seule et utilisez HTTPS.

5. Accès au panneau

Allez sur https://tudominio.com/admin avec vos identifiants. Vous gérez tout depuis là ; pour quitter, Déconnexion.

6. Le tableau de bord

À l'entrée, un résumé : total de liens, clics, clics du jour et liens actifs, avec un graphique des derniers jours. Le bouton « + Nouveau lien » en crée un en quelques secondes. Le menu latéral mène au reste.

7. Créer et personnaliser des liens

Cliquez sur « + Nouveau lien » et remplissez :

  • URL de destination (obligatoire).
  • Code/slug : automatique si vide, ou le vôtre (votredomaine.com/promo).
  • Préfixes par campagne (blog-mon-lien).
  • Préfixe de titre pour classer.
  • Mettre à jour si existe : réutilise un slug sans doublon.

En enregistrant, copiez le lien court. La liste affiche la date de création et permet de trier par colonne (destination, clics, date, statut), de rechercher et de sélectionner plusieurs liens pour des actions groupées : exporter, activer, désactiver ou supprimer. Vous pouvez aussi modifier, copier ou supprimer chaque lien.

8. Expiration et limites

  • Date d'expiration : ne redirige plus après cette date.
  • Clics maximum : se désactive seul une fois la limite atteinte.

Idéal pour les promotions temporaires ou les liens à usage unique.

9. Statistiques

Chaque lien a sa page de statistiques, avec tout ce qu'il faut :

  • Clics totaux et par période (jour, semaine, mois, année), avec clics uniques.
  • Pays du visiteur (la géolocalisation est incluse, sans configuration), appareil, navigateur et système d'exploitation.
  • Sources de trafic (d'où viennent les clics) et répartition par heure et jour de la semaine.
  • Graphique d'évolution et comparaison de liens.

L'administrateur voit tout ; chaque gestionnaire, le sien, avec le classement de ses liens les plus visités.

10. Utilisateurs et rôles

En tant qu'administrateur, dans Gestionnaires vous créez des comptes (avec leur email) et les activez ou désactivez. Si un gestionnaire oublie son mot de passe, il peut le récupérer par email ou l'administrateur peut le changer aussitôt. Deux rôles :

RôleCapacités
AdministrateurContrôle total : tous les liens et stats, utilisateurs, réglages et mises à jour.
GestionnaireUniquement ses propres liens et stats.

Chaque gestionnaire travaille de façon isolée : plusieurs équipes partagent une installation sans interférence.

Actions sur un gestionnaire :

  • Activer/désactiver : un gestionnaire désactivé ne peut plus se connecter, mais ses liens continuent de fonctionner et ses statistiques sont conservées. C'est réversible.
  • Changer l'email de récupération ou changer le mot de passe : mettez à jour ses identifiants aussitôt.
  • Supprimer : à la suppression d'un gestionnaire, Linsei demande quoi faire de ses liens : les réattribuer à un autre gestionnaire (liens et statistiques conservés) ou les supprimer (ses URLs cessent de fonctionner ; irréversible). Si vous voulez seulement bloquer l'accès, désactivez-le au lieu de le supprimer.
La récupération par email nécessite un serveur SMTP, que vous configurez dans Réglages.

11. Exporter en CSV

Depuis la liste ou les statistiques, vous pouvez exporter en CSV (Excel et Google Sheets) pour des rapports ou des sauvegardes, avec filtres par dates et gestionnaire.

12. Langue du panneau

Le panneau est en 8 langues : espagnol, anglais, français, portugais, allemand, italien, néerlandais et polonais. Changez avec le sélecteur de l'en-tête ; votre choix est mémorisé. Depuis Réglages → Langues vous activez/désactivez des langues et en ajoutez une (un .php traduit). Vous pouvez aussi le déposer par FTP dans data/lang/ (à l'abri des mises à jour).

13. L'API

Créez des liens depuis d'autres programmes. Chaque utilisateur a son token (dans son profil). Exemple :

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 réponse inclut le lien court. C'est ce qu'utilise l'extension Chrome.

14. Extensions

Linsei s'étend avec des extensions sans toucher au cœur. Trois façons de les installer :

  • Depuis Extensions dans le panneau, installez les officielles en un clic.
  • Cliquez sur « Téléverser un module » pour envoyer votre propre .zip.
  • Ou copiez son dossier dans plugins/ par FTP.

Envie de créer la vôtre ? Elles s'accrochent via des hooks (actions et filtres). Voici un guide complet avec un exemple.

15. Sécurité

  • Mots de passe avec bcrypt et sessions natives.
  • Protection CSRF sur tous les formulaires.
  • Journal d'activité par utilisateur.
  • Fichiers du cœur protégés contre l'accès direct.

Utilisez toujours HTTPS et laissez config.php en lecture seule.

16. Mise à jour

Linsei se met à jour en un clic. Dans Réglages → Mettre à jour Linsei, vous voyez votre version installée et, s'il y en a une nouvelle, un bouton « Mettre à jour vers la dernière version ». Linsei télécharge le cœur, fait une sauvegarde et remplace seulement les fichiers du programme.

La mise à jour ne touche jamais vos extensions, vos données ni votre config.php : vos liens, statistiques et réglages sont conservés, et en cas d'échec la sauvegarde est restaurée automatiquement.

Vous pouvez aussi mettre à jour à la main en renvoyant les fichiers du paquet (sans supprimer config.php ni data/), mais le bouton rend cela inutile.

17. Aide et support

Dans le panneau, une page d'Aide (/admin/ayuda). Questions ou bugs ? Écrivez-nous depuis contact.