a fork of TaskBoard with personal improvements, mostly around stability and usability with Postgres
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Olivier 'reivilibre' 2261b4b1b7 1.0.4 1 month ago
.github Update screenshots and minor fixes from demo creation 1 year ago
.vscode Proper JSON format 1 year ago
src 1.0.4 1 month ago
test Merge master to dev... because I'm an idiot 1 year ago
tools Cleanup 1 year ago
.dockerignore Add Dockerfile 1 year ago
.editorconfig Initial transition to @angular/cli and webpack 4 years ago
.gitignore Add a proper config system 1 month ago
.travis.yml Update .travis.yml 7 months ago
CHANGELOG.md Update changelog with v1.0.2 updates 1 year ago
Dockerfile Small fixes 1 year ago
LICENSE Update license dates 1 year ago
README.md Add build instructions 1 month ago
angular.json Add a proper config system 1 month ago
docker-compose.yml Add ability to debug with vscode and docker 1 year ago
karma.conf.js Upgrade to Angular 8 - CI build will fail 2 years ago
package-lock.json locks changed 1 month ago
package.json 1.0.4 1 month ago
tsconfig.app.json Upgrade to Angular 8 - CI build will fail 2 years ago
tsconfig.json Minor cleanup and sorting tweak 1 year ago
tsconfig.spec.json Upgrade to Angular 8 - CI build will fail 2 years ago
xdebug.ini Add ability to debug with vscode and docker 1 year ago

README.md

REIVILIBRE'S PERSONAL FORK

This fork is being developed for stability and compatibility with Postgres.

TaskBoard

Build Status Codacy Badge Join the chat at https://gitter.im/kiswa/TaskBoard Join the discussion at https://reddit.com/r/TaskBoard

A Kanban-inspired app for keeping track of things that need to get done.

The goal of TaskBoard is to provide a simple and clean interface to a functional and minimal application for keeping track of tasks. It's not trying to be the next Trello or LeanKit.

Installation

Prerequisites

A web server running PHP 7.x with sqlite enabled (it may work on PHP 5.6, but is not supported). See PHP Supported Versions.

The server must have sqlite3 and php7-sqlite installed. - OR - If you're comfortable changing code, you can use any database supported by RedBeanPHP.

Using PHP-FPM

You are able to use PHP-FPM if you remove (or comment out) the php_value items in the api/.htaccess file, then set them in a .user.ini See Documentation

Install

Installing TaskBoard is as easy as 1, 2, 3!

  1. Download the latest release since v1.0.0
  2. Extract it to your webserver
  3. Verify the api directory is writable

If you intend to use email features, you will need to edit api/helpers/mailer.php.

Server Config

Apache

The directory you create for TaskBoard must have AllowOverride set so the .htaccess files work.

You also have to have mod_rewrite installed and enabled.

Nginx

Example Nginx configuration:

server {
  server_name ...;

  listen 443 ssl http2;
  listen [::]:443 ssl http2;

  client_max_body_size 100M;
  client_body_buffer_size 128k;

  # Note: You should disable gzip for SSL traffic.
  # See: https://bugs.debian.org/773332
  #
  # Read up on ssl_ciphers to ensure a secure configuration.
  # See: https://bugs.debian.org/765782

  ssl_certificate /etc/nginx/tls/....pem;
  ssl_certificate_key /etc/nginx/tls/....key;
  include snippets/olivier-good-tls.conf;

  add_header X-Frame-Options SAME-ORIGIN;
  add_header X-Content-Type-Options nosniff;

  root /var/www/taskboard/taskboard_{{ taskboard.version }};
  index index.php index.html;
  autoindex off;

  location / {
    try_files $uri $uri/ /index.html;
  }

  location /api {
    try_files $uri $uri/ @rewriteApi;
  }

  location @rewriteApi {
    rewrite ^(.*)$ /api/index.php last;
    break;
  }

  location ~ [^/]\.php(/|$) {
    fastcgi_split_path_info ^(.+?\.php)(/.*)$;
    if (!-f $document_root$fastcgi_script_name) {
      return 404;
    }

    fastcgi_param HTTP_PROXY "";
    fastcgi_pass unix:/var/run/php/php-fpm.sock;
    fastcgi_index index.php;
    include snippets/fastcgi-php.conf;
  }

  location ~ /\.ht {
    # deny htaccess
    deny all;
  }
}

server {
    server_name ...;

    listen 80;
    listen [::]:80;

    # permanent redirect preserving method (POSTs not converted to GETs)
    return 301 https://$server_name$request_uri;
}

You might need to replace php-fpm.sock with a different path for your PHP version.

IIS

See the Wiki Page

First Use

Open a web browser to the location you installed TaskBoard and use admin as the username and password to log into TaskBoard.

Go to the Settings page to update your user (username, email, password, etc.) and create your first board!

Features

Users & Settings

There are three types of users, and the settings page is slightly different for each.

  • User - View boards assigned to them and update their own settings and options.
  • Board Admin - Same as above, with the ability to manage boards they are added to.
  • Admin - Same as above, with the ability to add/remove users and boards.

Settings Page

Boards

Each board may have as many columns as needed. For example, a software project might have columns like:

  • Proposed
  • Backlog
  • In Work
  • Test
  • Done
  • Archived

Or maybe you want to track a simple todo list with just:

  • Todo
  • Doing
  • Done

It's all up to you! However many columns you have, each column may have tasks added to it, and tasks can be dragged to other columns as they progress (or edited and assigned to a new column).

Boards may also have categories for additional organization, e.g. Bug, Enhancement, New Feature.

Boards Page

Tasks

A task only has to have a Title to be added to a board, but there is much more available. Tasks may be assigned to any user on the board (or left Unassigned), and include options for Due Date, Color, Points (an optional difficulty rating), and Category.

TaskBoard uses a Markdown parser for the Description, allowing for better display of details (like this readme).

Once a task has been entered, it may have Comments (also supporting Markdown) or Attachments added to it by viewing the task detail. There is a link to edit the task, which takes you to a modal much like the original add task dialog.

For admin users, there is also a link to delete the task. This view also shows the task's activity log on the side of the screen, displaying the complete history of events related to the task.

Tasks

Development

Developing on TaskBoard is pretty simple too.

  1. Clone the repository and navigate to it git clone https://github.com/kiswa/TaskBoard && cd TaskBoard/
  2. Run git checkout dev to work on the dev branch
  3. If you don't have it already, install the Angular CLI globally with npm i -g @angular/cli
  4. Run npm i to install dependencies (this also installs the API dependencies)
  5. Run npm run watch for the build to automatically run after any change

Building

Run npm run build to build. The dist directory will be created with the build.

Unit Tests

Both the API and App are unit tested. To run all tests, use the command npm run test. For only one set, run npm run test:api or npm run test:app.

To have the app tests run & update as you work, use the command npm run test:watch.

If you want to run a single API test, add the following comment block before the test function and use the command npm run test:api-single.

/**
 * @group single
 */

If you want to run a single App test, change the test from it('should do something', ...); to fit('should do something', ...); and only that test will run.

These tests are run by Travis CI on PRs and commits. A PR with failing or missing tests will not be merged.

Contributing

Fork the repository and make your changes on the dev branch.

Create a pull request against the dev branch to merge your changes with the main repository.

Make sure to include/update unit tests.

Feedback

Constructive feedback is appreciated! If you have ideas for improvement, please add an issue or implement it and submit a pull request.

If you find a bug, please post it on the Issue Tracker.

How It's Made

Front End

Back End

Lines of Code

Because I like seeing the numbers.

src

Language Files Blank Comment Code
TypeScript 67 977 129 4103
PHP 20 744 37 2243
HTML 21 268 2 1572
SASS 14 299 10 1347
SUM: 122 2288 178 9265

Command: cloc --exclude-dir=vendor,favicons --exclude-ext=json,svg,ini src/

test

Language Files Blank Comment Code
TypeScript 38 1017 8 3540
PHP 11 784 19 2272
SUM: 49 1801 27 5812

Command: cloc --exclude-ext=xml test/