56 lines
1.3 KiB
Markdown
56 lines
1.3 KiB
Markdown
# Animal Management Installation Guide
|
|
|
|
This guide installs the `animal_management` module in a reusable way for any HumHub instance.
|
|
|
|
## 1. Requirements
|
|
|
|
- HumHub `1.14+`
|
|
- Module directory access on the target instance
|
|
- Optional but recommended: `rescue_foundation` module
|
|
|
|
## 2. Clone into HumHub Modules Directory
|
|
|
|
The folder name must be exactly `animal_management`.
|
|
|
|
```bash
|
|
git clone https://gitea.kelinreij.duckdns.org/humhub-modules/animal-management.git \
|
|
/var/www/localhost/htdocs/protected/modules/animal_management
|
|
```
|
|
|
|
If the folder already exists:
|
|
|
|
```bash
|
|
cd /var/www/localhost/htdocs/protected/modules/animal_management
|
|
git pull
|
|
```
|
|
|
|
## 3. Enable the Module
|
|
|
|
In HumHub UI:
|
|
|
|
1. Go to `Administration` -> `Modules`.
|
|
2. Enable `Animal Management`.
|
|
3. Enable it per space where needed.
|
|
|
|
## 4. Run Migrations
|
|
|
|
From the HumHub app host/container:
|
|
|
|
```bash
|
|
php /var/www/localhost/htdocs/protected/yii migrate/up \
|
|
--include-module-migrations=1 --interactive=0
|
|
```
|
|
|
|
## 5. Verify
|
|
|
|
1. Open a space where the module is enabled.
|
|
2. Confirm Animals views load.
|
|
3. Confirm medical/progress/transfer flows render without errors.
|
|
|
|
## Docker Example
|
|
|
|
```bash
|
|
docker exec humhub php /var/www/localhost/htdocs/protected/yii migrate/up \
|
|
--include-module-migrations=1 --interactive=0
|
|
```
|