Kildekoden bak https://www.pvv.ntnu.no/
Go to file
Oystein Kristoffer Tveit 814e5bc6c7 www/tjenester: move nettsiden from github to gitea 2024-08-21 10:46:43 +02:00
dist Update dependencies 2024-04-10 21:44:58 +02:00
gammel dokumentasjon Added documentation from outdated repo. Covers alot of the wishes for the new website for the uninformed. 2016-08-29 19:46:52 +02:00
inc Calendar: Remove recurring events for summer break 2024 2024-06-11 17:09:35 +02:00
nix nix/shell: create slideshow dir 2024-08-17 01:35:14 +02:00
src Various: Replace deprecated functions to support php 8.3 2024-08-17 18:31:43 +02:00
www www/tjenester: move nettsiden from github to gitea 2024-08-21 10:46:43 +02:00
.gitattributes add .gitattributes 2021-08-12 12:50:01 +02:00
.gitignore Build new nix {module,package,flake}. Adapt to new config variables 2024-04-10 21:44:58 +02:00
.gitmodules Update OAuth2 client library 2017-11-11 15:37:13 +01:00
Dockerfile Update minor dependency changes 2023-01-19 11:26:56 +01:00
README.md Clarify dependencies 2022-01-25 15:06:27 +01:00
composer.json Update dependencies 2024-04-10 21:44:58 +02:00
composer.lock Update dependencies 2024-04-10 21:44:58 +02:00
docker-compose.yaml Add dockerfile for local development 2021-08-11 22:28:48 +02:00
flake.lock Update dependencies, fix broken flake 2024-04-10 21:44:58 +02:00
flake.nix flake.nix: remove abundant todos 2024-08-21 07:37:08 +02:00

README.md

Programvareverkstedets 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, php and pdo-sqlite installed. These can be obtained from your package manager. Then make sure PHP has the curl, pdo-sqlite, ext-dom and sqlite3 extensions enabled, see /etc/php/php.ini.

To install all mentioned requirements on debian: apt install composer sqlite3 php8.1-sqlite3 simplesamlphp php-xml, followed by composer update.

./dev.sh

On Windows you can use chocolatey and git bash to run ./dev.sh. Install php and sqlite, then enable these extensions in C:\tools\php80\php.ini: mbstring, openssl, curl, pdo-sqlite and sqlite3

Alternatively you may use cmd on Windows. In this case you'll have to perform a composer install manually beforehand. Good luck.

dev.bat

Dependency management

dev.sh will ensure the git submodules have been properly pulled, then download the composer package manager to a php archive file named composer.phar, then run it. Composer will then check for the php extensions needed, such as 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 access the local development site via the the hostname localhost) To make your account into an admin account, run:

sqlite3 pvv.sqlite 'INSERT INTO users (uname, groups) VALUES ("YOUR_USERNAME", 1);'

If using docker, when already 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