68 lines
2.0 KiB
Markdown
68 lines
2.0 KiB
Markdown
# Programvareverkstedet nettside
|
|
|
|
A website created with the latest and greatest web technologies.
|
|
May contain blackjack and other things one tends to include in awesome projects.
|
|
|
|
## Installation
|
|
|
|
git clone --recursive https://github.com/Programvareverkstedet/nettsiden.git
|
|
|
|
Put it in a folder your webserver can find.
|
|
|
|
## Development setup
|
|
|
|
Make sure you have sqlite3 and PHP installed, with pdo-sqlite module.
|
|
These can be obtained from your package manager.
|
|
|
|
./dev.sh
|
|
|
|
On Windows, you have to perform a `composer install` manually beforehand. Make sure you have PHP and sqlite3 available in path:
|
|
|
|
dev.bat
|
|
|
|
### Dependency management
|
|
|
|
`dev.sh` will ensure the git submodules have been pulled, then download the `composer` package manager to the php archive file `composer.phar` and run it.
|
|
Composer will check for the php extension `pdo_sqlite` which must be enabled on your system. This usually includes installing a php-sqlite3 package and enabling it in `/etc/php/php.ini`:
|
|
|
|
[PHP]
|
|
extension=pdo_sqlite
|
|
extension=sqlite3
|
|
extension=ext-curl
|
|
|
|
Composer is used as such:
|
|
|
|
php composer.phar update
|
|
php composer.phar install
|
|
|
|
### Docker
|
|
|
|
We provide a simple docker-compose setup for local development.
|
|
First ensure that docker is running:
|
|
|
|
sudo systemctl start docker
|
|
|
|
then
|
|
|
|
DOCKER_USER=$(id -u):$(id -g) docker-compose up
|
|
|
|
|
|
### Admin account
|
|
|
|
Login goes through `idp.pvv.ntnu.no` via SAML, so you have to use your PVV account.
|
|
(This only works if you use the hostname `localhost`)
|
|
To make your account into an admin accout, run:
|
|
|
|
sqlite3 pvv.sqlite 'INSERT INTO users (uname, groups) VALUES ("your_username", 1);'
|
|
|
|
If using docker, when running:
|
|
|
|
DOCKER_USER=$(id -u):$(id -g) docker-compose exec nettside sqlite3 pvv.sqlite 'INSERT INTO users (uname, groups) VALUES ("your_username", 1);'
|
|
|
|
If not already running:
|
|
|
|
DOCKER_USER=$(id -u):$(id -g) docker-compose run nettside sqlite3 pvv.sqlite 'INSERT INTO users (uname, groups) VALUES ("your_username", 1);'
|
|
|
|
|
|
## Hosting
|