DoliShortener

L'API universelle de raccourcissement d'URL pour les modules Dolibarr

Un appel shortenIt(). N'importe quel connecteur. Zéro lien cassé.

Tout module Dolibarr ayant besoin d'envoyer un lien dans un canal à format contraint — SMS, notification push, document imprimé — finit par réinventer sa propre logique de raccourcissement : choisir un service, gérer une clé API, gérer les pannes. DoliShortener centralise cette brique une bonne fois pour toutes : une classe d'abstraction unique, des connecteurs interchangeables configurés une seule fois par l'admin, et un registre d'usage pour tout auditer.

🔌 Une classe, trois connecteurs

Appelez DoliShortener::shortenIt($url) depuis n'importe quel module — DoliShortener résout le connecteur actif de l'entité (Bitly, TinyURL ou is.gd) et retourne une URL courte. Votre module n'a jamais besoin de savoir quel service est utilisé.

• ✅ is.gd fonctionne immédiatement — aucune clé API requise
• ✅ Bitly et TinyURL pris en charge via jeton d'accès
• ✅ Possibilité de forcer un connecteur précis par appel

🛡️ Ne casse jamais votre module appelant

Si le connecteur actif est en panne, en quota dépassé ou mal configuré, shortenIt() ne lève jamais d'exception — il retombe silencieusement sur l'URL longue d'origine et journalise l'échec. Un SMS d'invitation n'échoue jamais à cause d'une panne Bitly.

• ✅ Repli silencieux vers l'URL d'origine en cas d'échec du connecteur
• ✅ Timeout HTTP configurable pour protéger la latence de votre module
• ✅ Chaque tentative — succès ou échec — journalisée pour diagnostic

📋 Registre d'usage complet

Chaque lien raccourci est enregistré — URL longue, URL courte, connecteur utilisé, module appelant, date, auteur — filtrable par module et par connecteur. Auditez quel module génère du trafic, et diagnostiquez un souci de connecteur en quelques secondes.

• ✅ Écran de registre filtrable et paginé
• ✅ Statut succès/échec par entrée
• ✅ Onglet admin "Raccourcir maintenant" manuel, journalisé de la même façon

Fonctionnalités clés

Comment ça marche

1. Installez et activez DoliShortener.
2. Activez un ou plusieurs connecteurs dans Configuration — is.gd ne nécessite aucune configuration, Bitly et TinyURL nécessitent une clé API. Choisissez votre connecteur par défaut.
3. Depuis n'importe quel module, appelez DoliShortener::shortenIt($long_url, ['caller_module' => 'votremodule']) — ou utilisez l'onglet admin Raccourcir maintenant pour un lien ponctuel manuel.
4. Consultez l'usage à tout moment dans l'onglet Registre des liens.

Essayez-le

DoliShortener est un module API pensé pour les développeurs, sans interface dédiée sur les fiches métier en v1.0 — la meilleure façon de le tester est de l'installer sur une instance de test, d'activer le connecteur gratuit is.gd (aucune clé API requise), et d'appeler shortenIt() depuis l'onglet admin Raccourcir maintenant.

Support

DoliShortener est disponible sur le Dolistore pour un prix symbolique de 10€ — parfois offert avec l'achat d'autres modules DZProd (par exemple avec DoliSMS) ou lors de promotions. Pour de l'aide à l'intégration, des connecteurs sur mesure ou un support prioritaire : onboarding à 90€/h, développement spécifique sur devis.

📧 products@dzprod.net

Journal des modifications

v1.0.0

• Version initiale
• Classe d'abstraction shortenIt() avec connecteurs Bitly, TinyURL et is.gd
• Configuration des connecteurs par entité avec clés API chiffrées
• Registre d'usage avec filtres (module, connecteur, statut)
• Onglet admin manuel "Raccourcir maintenant"

Des questions ? 📧 support@dzprod.net

DoliShortener est activement maintenu avec des mises à jour régulières.