Netbox plugin to manage attachments for any model
Project description
NetBox Attachments Plugin
Netbox plugin for attaching files to any model.
Features
This plugin provide following Models:
- NetBoxAttachment
Compatibility
Netbox | Plugin |
---|---|
>= 3.3.4 | 0.0.0 <-> 0.0.5 |
>= 3.4.0 | 0.0.6 <-> 1.0.6 |
>= 3.4.3 | 1.0.7 <-> 1.1.X |
>= 3.5.0 | 2.0.0 |
>= 3.6.0 | 3.0.0 |
>= 3.7.0 | 4.0.0 |
>= 4.0.0 | 5.0.0-beta1 |
Installation
The plugin is available as a Python package in pypi and can be installed with pip
pip install netbox-attachments
Enable the plugin in configuration.py
:
PLUGINS = ['netbox_attachments']
Restart NetBox and add netbox-attachments
to your local_requirements.txt
See NetBox Documentation for details
Configuration
The following options are available:
apps
:- Type: List
- Default: ['dcim', 'ipam', 'circuits', 'tenancy', 'virtualization', 'wireless']
- Description: Display
Attachments
feature on all models definded under the app label. Attachmets are displayed onright_page
of the detail-view of model.
display_default
:- Type: String
- Default: "additional_tab"
- Options: "left_page", "right_page", "full_width_page", "additional_tab"
- Description: Setup default setting of where attachments should be displayed under the models
display_setting
:- Type: Dict
- Default: {}
- Options: {<app_label.model>: <prefeered_display>}
- Example: {'dcim.devicerole': 'full_width_page', 'dcim.device': 'left_page', 'ipam.vlan': 'additional_tab'}
- Description: Set display setting for concrete model
- Tip: Proper
app_label
andmodel
names could be found at API<your_netbox_url>/api/extras/content-types/
Warning
additional_tab
does not work for Plugin models
Configuration Example:
PLUGINS_CONFIG = {
'netbox_attachments': {
'apps': ['dcim', 'ipam', 'circuits', 'tenancy', 'virtualization', 'wireless', 'inventory_monitor'],
'display_default': "right_page",
'display_setting': {'ipam.vlan': "left_page", 'dcim.device': "full_width_page", 'dcim.devicerole': "full_width_page", 'inventory_monitor.probe': "additional_tab"}
}
}
Enable Attachments for custom plugin (models)
- Append your plugin to configuration list
apps
: ['<plugin_name>']
- Extend detail templates
-
# At the TOP {% load plugins %} # Under a comments section {% plugin_right_page object %} # add the left_page and full_width for future extension
- Example (device - core model):
-
Screenshots
- Model View
- List View
- Detail View
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
netbox_attachments-5.0.0b1.tar.gz
(13.7 kB
view hashes)
Built Distribution
Close
Hashes for netbox_attachments-5.0.0b1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 240806add879190febcd947c676064a63b4cc70d9a5e5f6d4efdee6e01c3554b |
|
MD5 | 6b26c6824519361156dad3c415f27c81 |
|
BLAKE2b-256 | 9020b7acbdae1535d8340ccac6e7d6e72eb2dfb787f98a38af6bb48a721b3a8d |
Close
Hashes for netbox_attachments-5.0.0b1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 72b79a56655ed184e87d424190fdce9eaf9f52c5b554a76e8126b554bed8e02c |
|
MD5 | 563fc8d784ccd201571ed067c921cebe |
|
BLAKE2b-256 | e6e80ec2e955eb5260cfa5b1f94a5865eba0d28010c96453c2058d2cbb42c6d2 |