chore: sync module from working instance and add install guide
This commit is contained in:
55
INSTALL.md
Normal file
55
INSTALL.md
Normal file
@@ -0,0 +1,55 @@
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user