supplierlink3/README.md

# SupplierLink3 for [Dolibarr ERP & CRM](https://www.dolibarr.org)

**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](https://www.gnu.org/licenses/fdl-1.3.en.html).

---

# SupplierLink3 für [Dolibarr ERP & CRM](https://www.dolibarr.org) (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`