Linda Carlstad

Description

The official website for the student association Linda Carlstad in Sweden, Karlstad. The association is under and with support from Karlstad University. Linda Carlstad is a association for students studying computer science, web development and software system design.

Installation

- Docker (Recommended)

Install Docker on your system and follow the docker steps below.

- Unix

Follow the official Laravel documentation for a detailed walkthrough using any Unix system, like macOS or any distribution on Linux.

Laravel documentation

- macOS

Follow this simple guide to run a Laravel (8.x) project on your macOS based computer.

Felix Wetell's guide

- Windows

Follow this simple guide to run a Laravel (8.x) project on your Windows based computer.

Felix Wetell's guide

Fetch the project to your machine, either using the GUI or the command below.

git clone https://github.com/Linda-Carlstad/lindacarlstad.se.git

Locate the project on your machine via the terminal and follow the steps below.

Initialize the projects environment file

cp .env.example .env

Linda Carlstad website uses the same database as the Linda Carlstad Admin Panel, see how to set up the datbase in that project before continuing with this one. The name of the database is therefore dependent of what you have named the database in the Linda Carlstad Admin Panel project. Credentials should match that one to be used in this project See example below.

Edit the .env file with your database credentials. Here is an example:

DB_HOST=mariadb
DB_PORT=3306
DB_DATABASE=adminpanel
DB_USERNAME=user
DB_PASSWORD=my_secure_password

- Docker setup

Start the docker instances and the website.

docker compose up -d

- Useful commands

Enter a bash shell within the php docker image (exit to end the session)

docker exec -it linda_admin_frontend /bin/bash

To stop the docker instances, run the command below in a new terminal session:

docker compose stop

Installation part 2 (non-docker users)

Install all composer dependencies:

composer install

Install all NPM dependencies:

npm install

Copy and generate application key:

php artisan key:generate

Run this to generate CSS and JS files:

npm run dev

Run the local development server:

php artisan serve

Usage

The website uses the information filled in using the custom-build CMS system, Admin Linda Carlstad.

Ports if docker is used:

• phpmyadmin: 8090
• MariaDB: $DB_PORT (default is 3306)
• laravel: 8000

Images

Landing page

About us

Contact form

Program overview

Footer

Songs

Song overview

Hidden songs gate

Initation

Initiation overview

Initiation show

Initiation information

Initiation contact

Contributing

Can also be found here - Contributing to Linda Carlstad

- Issues

• Screenshot the problem
• Open a new issue
• Give it a meaningful title
• Describe the issue clearly
• Upload the screenshot
• Add useful labels
• Submit issue

- Coding

• See the issue list
• Assign yourself to an issue
• Open a new branch
• Create your beautiful code
• Create a pull request

Software

Recommended apps to get going fast:

• Atom/Sublime/PHPStorm
• MAMP
• Sequal Pro
• Google Chrome/Mozilla FireFox
• Sketch (design tool)

Credits

Special thanks to Linda Carlstad It-committee 2018/2019 for creating this website.