Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/brainsum/brainsum-dam
Source code for the inhouse Brainsum DAM site.
https://github.com/brainsum/brainsum-dam
brainsum dam digital-asset-management docker docker-compose drupal drupal-8 php7
Last synced: 15 days ago
JSON representation
Source code for the inhouse Brainsum DAM site.
- Host: GitHub
- URL: https://github.com/brainsum/brainsum-dam
- Owner: brainsum
- License: gpl-2.0
- Created: 2020-05-15T09:02:25.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-05-16T14:50:56.000Z (8 months ago)
- Last Synced: 2024-11-06T08:06:09.680Z (2 months ago)
- Topics: brainsum, dam, digital-asset-management, docker, docker-compose, drupal, drupal-8, php7
- Language: PHP
- Homepage:
- Size: 1.1 MB
- Stars: 1
- Watchers: 5
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Brainsum DAM
Based on the brainsum/damo-project composer project.
After drush si:
- `drush urol administrator admin`
## Fixing http->https link in JSONAPI when behind a reverse proxy.
If using apache add this:
```apacheconfig
RequestHeader set X-Forwarded-Proto "https"
RequestHeader set X-Forwarded-Port 443
```
---
# DAMo - Composer template
Composer template to kickstart Digital Assets Management projects.
This template was based on the following:
- [Drupal composer project](https://github.com/drupal-composer/drupal-project)
- [Drupal recommended project](https://www.drupal.org/docs/develop/using-composer/starting-a-site-using-drupal-composer-project-templates)
- [Thunder distro](https://github.com/thunder/thunder-project).
## Installation
Note: These commands have been tested on linux (ubuntu), they might need changes to work on other systems.
### Native composer
For the latest release:
```shell script
composer create-project brainsum/damo-project my-damo-project
```
For a specific release:
```shell script
composer create-project brainsum/damo-project:0.1.0 my-damo-project
```
### Composer in docker
For the latest release:
```shell script
DAMO_PROJECT_DIR=my-damo-project; mkdir "${DAMO_PROJECT_DIR}" && docker run --rm -u "$(id -u)":"$(id -g)" -w /app --mount type=bind,src="$(pwd)"/"${DAMO_PROJECT_DIR}",dst=/app wodby/drupal-php:7.3-dev-4.14.3 composer create-project brainsum/damo-project .
```
For a specific release:
```shell script
DAMO_PROJECT_DIR=my-damo-project; mkdir "${DAMO_PROJECT_DIR}" && docker run --rm -u "$(id -u)":"$(id -g)" -w /app --mount type=bind,src="$(pwd)"/"${DAMO_PROJECT_DIR}",dst=/app wodby/drupal-php:7.3-dev-4.14.3 composer create-project brainsum/damo-project:0.1.0 .
```
Note: The wodby/drupal-php image is just an example.
Note: Using an image with the `hirak/prestissimo` composer package will speed up the process, although it also might break things (see: ).
## Setup
### (Optional) Docker-compose
If you want to use docker-compose for development, you should copy `example.env` as `.env`, e.g `cp example.env .env`. Update its contents as required.
For starting and stopping the environment you can use the helper scripts provided with the project (`startup.sh` and `shutdown.sh`). These also look for a `docker-compose.local.yml` file so you can version control a generic config file and do local overrides (e.g ports, mounts).
### Drush
Copy `drush/example.drush.yml` as `drush/drush.yml`. Update its contents as required.
### Filesystem permission fixes
E.g on linux, you must fix file and directory permissions as well, e.g for "private_files", "web/sites/default/files", "tmp", ...
### Install
Use `drush site-install --account-pass=somestrongpass [email protected] --site-name=DAMo damo -y`
You also might want to add `--account-name` and `--account-mail`.
## Usage
### Main site
Upload your assets and that's it. You can download them, images can be styled for social media purposes, logo can be added, etc.
### API
The JSON:API module has been enabled, so you can serve your assets through that. An example would be using the [FileField Sources JSON API
](https://www.drupal.org/project/filefield_sources_jsonapi) module that allows you to configure file fields to allow downloading files from DAMo directly via the API.
## Development
For development info see the [DEVELOPMENT.md](./DEVELOPMENT.md) file.