supplierlink3/README.md

SupplierLink3 for Dolibarr ERP & CRM

Version 2.0 | License: GPL v3 | Author: Eduard Wisch

Dolibarr module for linking supplier webshops with products and displaying stock levels.

Features

Shop Links

• Direct access to supplier webshops from within Dolibarr
• Automatic URL generation with supplier article number
• Multi-supplier support with popup selection (sorted by price)
• Configurable shop icon (FontAwesome)
• Same supplier opens in same browser tab

Stock Display

Colored badges for quick overview:

• Red: Out of stock (< 1)
• Orange: Below minimum stock (alert threshold)
• Gray: Below desired stock
• Green: Sufficient stock

Supported Areas

• Customer Orders
• Proposals/Quotes
• Supplier Orders
• Stock Replenishment
• Product Card

Quick Supplier Order Creation

• "Create Supplier Order" button in customer orders
• Automatic product and quantity transfer
• Supplier reference with customer name and order number

Installation

From ZIP file

1. Go to menu Home > Setup > Modules > Deploy external module
2. Upload the zip file

Manual Installation

1. Copy module folder to /custom/supplierlink3/
2. In Dolibarr: Setup > Modules > SupplierLink3 - activate
3. On activation, extrafield shop_url is created for suppliers

Configuration

Admin Center

Settings under Setup > Modules > SupplierLink3 > Settings

Display Settings

Enable/disable the function for each area:

• Customer Orders
• Proposals
• Supplier Orders
• Stock Replenishment
• Product Card

Icon Settings

Customizable FontAwesome icons:

• Shop Icon: Default fas fa-store
• Stock Icon: Optional

Debug Mode

• Disabled by default
• When enabled, writes to /tmp/supplierlink3_debug.log

Setting up Shop URL for Suppliers

1. Open supplier > Edit
2. Fill extrafield "Shop URL" (e.g. https://shop.supplier.com/article/)
3. The supplier article number is automatically appended

Usage

In Orders/Proposals

• Click shop icon next to stock level
• Multiple suppliers: Dropdown with price comparison
• Same supplier opens in same browser tab

Creating Supplier Order

1. Open customer order
2. Click "Create Supplier Order" button
3. Select supplier
4. Select products
5. Create order

Technical Details

Hooks

• ordersuppliercard - Supplier Orders
• ordercard - Customer Orders
• propalcard - Proposals
• productcard - Product Card
• productpricecard - Product Prices
• stockreplenishlist - Replenishment List

Database

Uses extrafield shop_url in llx_societe_extrafields.

File Structure

supplierlink3/
├── admin/
│   ├── setup.php              # Settings
│   └── about.php              # About page
├── class/
│   └── actions_supplierlink3.class.php  # Hook implementation
├── core/modules/
│   └── modSupplierLink3.class.php       # Module definition
├── js/
│   └── replenish.js           # JavaScript for replenishment
├── langs/
│   ├── de_DE/supplierlink3.lang
│   └── en_US/supplierlink3.lang
├── lib/
│   └── supplierlink3.lib.php
└── create_supplier_order.php  # Create supplier order

Changelog

Version 2.0

• Admin center completely redesigned
• Settings per area (enable/disable)
• Configurable icons (FontAwesome)
• Debug mode disabled by default
• Bilingual (German/English)
• Stock replenishment list integrated
• Improved icon alignment

Version 1.0

• Initial release
• Shop links in orders
• Stock badges
• Supplier order from customer order

Translations

Translations are available in:

• German (de_DE)
• English (en_US)

Additional translations can be added by creating files in langs/xx_XX/supplierlink3.lang

Support

For questions or issues: data@data-it-solution.de

Licenses

Main Code

GPLv3 or (at your option) any later version. See file COPYING for more information.

Documentation

All texts and readmes are licensed under GFDL.

---

SupplierLink3 für Dolibarr ERP & CRM (Deutsch)

Version 2.0 | Lizenz: GPL v3 | Autor: Eduard Wisch

Dolibarr-Modul zur Verknüpfung von Lieferanten-Webshops mit Produkten und Anzeige von Lagerbeständen.

Funktionen

Shop-Links

• Direkter Zugang zu Lieferanten-Webshops aus Dolibarr heraus
• Automatische URL-Generierung mit Lieferanten-Artikelnummer
• Multi-Lieferanten-Unterstützung mit Popup-Auswahl (sortiert nach Preis)
• Konfigurierbares Shop-Symbol (FontAwesome)
• Gleicher Lieferant öffnet sich im gleichen Browser-Tab

Lagerbestand-Anzeige

Farbige Badges für schnelle Übersicht:

• Rot: Nicht auf Lager (< 1)
• Orange: Unter Mindestbestand (Alarm-Schwelle)
• Grau: Unter Wunschbestand
• Grün: Ausreichend auf Lager

Unterstützte Bereiche

• Kundenaufträge
• Angebote
• Lieferantenbestellungen
• Nachbestellung (Lager)
• Produktkarte

Schnelle Lieferantenbestellung

• Button "Lieferantenbestellung erstellen" im Kundenauftrag
• Automatische Übernahme von Produkten und Mengen
• Lieferanten-Referenz mit Kundenname und Auftragsnummer

Konfiguration

Shop-URL für Lieferanten einrichten

1. Lieferant öffnen > Bearbeiten
2. Extrafeld "Shop URL" ausfüllen (z.B. https://shop.lieferant.de/artikel/)
3. Die Lieferanten-Artikelnummer wird automatisch angehängt

Admin-Center

Einstellungen unter Einstellungen > Module > SupplierLink3 > Einstellungen

Anzeige-Einstellungen

Aktivieren/Deaktivieren pro Bereich:

• Kundenaufträge
• Angebote
• Lieferantenbestellungen
• Nachbestellung (Lager)
• Produktkarte

Symbol-Einstellungen

• Shop-Symbol: Standard fas fa-store
• Lagerbestand-Symbol: Optional

Debug-Modus

• Standardmäßig deaktiviert
• Schreibt bei Aktivierung nach /tmp/supplierlink3_debug.log