summaryrefslogtreecommitdiff
path: root/README.md
blob: 79ddba2791d9ec4402eee8f4a693b8ccc89b948b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Assignment List

assignment_list is an unorthodox calendar/todo manager. It can be used to manage tasks and was originally designed as a means for managing assignments for my college classes. A MySQL database is used to manage tables and groups, and the backend is handled by PHP.

### Requirements

- MySQL
- PHP

### Usage

It is recommended for first-time users to run the `setup.php` script, which will create a `config.php` file for the backend to connect to the MySQL database and tables with the necessary columns and and constraints.

```
$ php setup.php
```

assignment_list can be self-hosted. To self-host, first start a PHP server:

```
$ php -S localhost:<port number>
```

Then navigate to `localhost:<port number>/assignment_list.html`.

The first thing to do is to create a new "class" or group. Then, after a class has been created, assignments can be added to the class. Options for each assignment include **edit**, **clone**, **mark as done/not done**, and **delete**

### Extending

assignment_list supports custom CSS rules and JS scripting. The following paths will automatically be sourced by the page

- `custom/custom.css`
- `custom/custom.js`