feat: add site prefix column to device and rack tables
- derive prefix from the first word of the site name - display prefix as the first data column - support NetBox 4.6.5 through 4.6.x - add packaging, installation documentation, and tests
This commit is contained in:
@@ -0,0 +1,48 @@
|
||||
# NetBox Site Prefix
|
||||
|
||||
Plugin für NetBox 4.6.5, das in den Geräte- und Rack-Listen eine Spalte
|
||||
**Prefix** als erste Datenspalte anzeigt. Der Wert ist immer das erste Wort
|
||||
des zugewiesenen Standortnamens (`Site.name`).
|
||||
|
||||
Beispiele:
|
||||
|
||||
| Standort | Prefix |
|
||||
|---|---|
|
||||
| `Berlin Campus West` | `Berlin` |
|
||||
| `DC01 Frankfurt` | `DC01` |
|
||||
| kein Standort | `—` |
|
||||
|
||||
Das Plugin benötigt keine Datenbankmigration und speichert keine eigenen
|
||||
Daten.
|
||||
|
||||
## Installation
|
||||
|
||||
Im Python-Virtualenv von NetBox installieren:
|
||||
|
||||
```shell
|
||||
/opt/netbox/venv/bin/pip install /pfad/zu/Netbox-Prefixes
|
||||
```
|
||||
|
||||
Danach in `configuration.py` aktivieren:
|
||||
|
||||
```python
|
||||
PLUGINS = [
|
||||
# weitere Plugins ...
|
||||
"netbox_site_prefix",
|
||||
]
|
||||
```
|
||||
|
||||
Anschließend NetBox neu starten. `upgrade.sh` ist nicht erforderlich, kann
|
||||
aber wie bei anderen Plugin-Installationen ausgeführt werden.
|
||||
|
||||
Bei bestehenden Benutzern kann eine bereits gespeicherte persönliche
|
||||
Spaltenauswahl Vorrang vor den Standardspalten haben. In diesem Fall in der
|
||||
Geräte- bzw. Rack-Liste **Spalten konfigurieren** öffnen, **Prefix** auswählen
|
||||
und an die erste Position schieben oder die gespeicherte Tabellenkonfiguration
|
||||
zurücksetzen.
|
||||
|
||||
## Kompatibilität
|
||||
|
||||
- NetBox: 4.6.5 bis einschließlich 4.6.x
|
||||
- Python: ab 3.12
|
||||
|
||||
Reference in New Issue
Block a user