# Space Profiles Installation Guide

This guide installs the `space_profiles` 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 `space_profiles`.

```bash
git clone https://gitea.kelinreij.duckdns.org/humhub-modules/space-profiles.git \
  /var/www/localhost/htdocs/protected/modules/space_profiles
```

If the folder already exists:

```bash
cd /var/www/localhost/htdocs/protected/modules/space_profiles
git pull
```

## 3. Enable the Module

In HumHub UI:

1. Go to `Administration` -> `Modules`.
2. Enable `Space Profiles`.
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 with module enabled.
2. Confirm profile page renders the template sections.
3. Confirm space settings page saves expected profile fields.

## Docker Example

```bash
docker exec humhub php /var/www/localhost/htdocs/protected/yii migrate/up \
  --include-module-migrations=1 --interactive=0
```