-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
38 additions
and
1 deletion.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,2 +1,33 @@ | ||
# inventree-template-editor-plugin | ||
A visual editor to build InvenTree label templates | ||
|
||
[![License: GPL3](https://img.shields.io/badge/License-GPLv3-yellow.svg)](https://opensource.org/license/gpl-3-0) | ||
![CI](https://github.com/wolflu05/inventree-template-editor-plugin/actions/workflows/ci.yml/badge.svg) | ||
|
||
A visual editor to quickly build InvenTree label templates. | ||
|
||
![](https://github.com/user-attachments/assets/2879e1ac-7fd5-4008-a740-34438620fb2b) | ||
|
||
## ⚙️ Installation | ||
|
||
Install this plugin as follows: | ||
|
||
1. Goto the Admin Center > Plugins > Plugin Settings and make sure to enable the "Enable interface integration" switch. | ||
|
||
2. Click on "Install Plugin" at the top of the Plugins table on that page and enter `inventree-template-editor-plugin` as package name. Enable the "Confirm plugin installation" switch and click "Install". | ||
|
||
3. Search for the plugin in the table and activate it | ||
|
||
> [!IMPORTANT] | ||
> At least InvenTree v0.17 is required to use this plugin. | ||
## 🏃 Usage | ||
|
||
Goto the Admin Center > Label Templates and create a new Label template. Click on it in the table and select the "Label Designer". Click on the shapes on the left bar to add them to the label canvas. | ||
|
||
## 🧑💻 Development | ||
|
||
1. Install as editable install to your inventree installation via `pip install -e /path/to/inventree-template-editor-plugin` | ||
2. Enable the plugin | ||
3. Install js dependencies via `cd inventree_template_editor/frontend && npm ci` | ||
4. Enable the dev mode for the plugin to use the vite dev server (that you need to start via `npm run dev`) in the InvenTree `config.yml` via `customize.inventree_template_editor_plugin_dev: true` | ||
5. Restart InvenTree and start vite dev server via `npm run dev` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters