From 622304ab3c7639c49c0c4dd6814ea6d8427ada0e Mon Sep 17 00:00:00 2001 From: lshprung Date: Sun, 24 Apr 2022 18:13:30 -0700 Subject: Created README --- README.md | 33 +++++++++++++++++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..79ddba2 --- /dev/null +++ b/README.md @@ -0,0 +1,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: +``` + +Then navigate to `localhost:/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` -- cgit