# Recherchecontributive.org Website

This project is the website for recherchecontributive.org.

## Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

### Prerequisites

What things you need to install the software and how to install them

  - docker
  - docker-compose
  - A code editor

In you local dns (/etc/hosts for example), map you Docker machine IP to the domain name `recherchecontributive.test`.

### Installing

Build docker images:

```
$ docker-compose build
```

Launch the project

```
$ docker-compose up
```
or
```
$ docker-compose up -d
```

import data.

```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root db import - < /path/to/recherchecontributive_dbase.sql
```

Replace strings in database:

```
docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root search-replace https://recherchecontributive.org http://recherchecontributive.test:8080
```

Import media files:
```
$ tar -C src/web/app/ -zxf /path/to/recherchecontributive_media.tar.gz 
```

Navigate to http://recherchecontributive.test:8080.

## Data management

**!! BEWARE !!**: Do not launch the `docker-compose down` command before exporting data. This command delete the `db` container's data volume end therefore delete the database.

### Export database
```
$ docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root db export --add-drop-table - > recherchecontributive_dbase_2019-04-19.sql
```

### Export media
```
$ tar zcf recherchecontributive_media_2019-04-19.tar.gz -C src/web/app/ uploads
```

### Import database

```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root db import - < recherchecontributive_dbase_2019-04-19.sql
```

If needed do a search replace after this to update the site urls:

```
$ docker-compose exec wp /var/www/html/vendor/bin/wp --allow-root search-replace https://recherchecontributive.org http://recherchecontributive.test:8080
```

Or change the administration password
```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root user update admin --prompt=user_pass
```

## Deployment

TODO...

## Built With

* [Wordpress](https://wordpress.org/) - The CMS used

## Versioning

We use [SemVer](http://semver.org/) for versioning. For the versions available, see the [tags on this repository](https://www.iri.centrepompidou.fr/dev/hg/recherchecontributive.org/tags). 

## Authors

* **Yves-Marie Haussonne** - *Initial work*

## License

This project is licensed under the CecCill License - see the [LICENSE.md](LICENSE.md) file for details

## Acknowledgments

* Hat tip to anyone whose code was used
* Wordpress: https://wordpress.org/
* Bedrock: https://roots.io/bedrock
* Docker for local wordpress development: https://urre.me/writings/docker-for-local-wordpress-development/