README.md
author ymh <ymh.work@gmail.com>
Wed, 04 Dec 2019 11:40:06 +0100
changeset 0 505fe5249d9c
child 3 5301eb6ce6e2
permissions -rw-r--r--
add foundations for pharmakon (bedrock + deploy)

# pharmakon.fr Website

This project is the website for pharmakon.fr.

## 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 `pharmakon.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/pharmakon_dbase.sql
```

Replace strings in database:

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

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

Navigate to http://pharmakon.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 - > pharmakon_dbase_2019-04-19.sql
```

### Export media
```
$ tar zcf "pharmakon_media_$(date '+%Y-%m-%d').tar.gz" -C src/web/app/ uploads
```

### Import database

```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root db import - < pharmakon_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://pharmakon.fr http://pharmakon.test:8080
```
Set the template root
```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root option set template_root "/var/www/pharmakon.fr/web/wp/wp-content/themes"
```

delete options
```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root option delete _site_transient_update_themes
```
```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root option delete _site_transient_theme_roots
```


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

Flush cache
```
$ docker-compose exec -T wp /var/www/html/vendor/bin/wp --allow-root cache flush
```


## 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/pharmakon.fr/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/