Tasked Documentation

Tasked Task ManagementNovember 2014

Thank you for purchasing Tasked Task Management.
If you have any questions that are beyond the scope of this help file, please do not hesitate to email me via my Code Canyon Profile.
I am always happy to help if you have any questions relating to Tasked.

For the latest version of this document, please visit the Online Version.

A. Pre-installation Top

1. Unzip Tasked and have a look around.

Unzip the Tasked file and take a look at the file structure. You should see 7 folders and 3 files.

2. Create a Database.

First step is to create a MySQL database, and if you do not have a default one, a database user. This process is explained in great detail on many websites and web hosts. Once you have the database setup, you will need:

The hostname - Usually (but not always - check with your web host) 'localhost'
The database name - ie. tasked
The database username - ie: database_user
The database password - ie: database_password

3. Upload Tasked

Upload all the files you unzipped to your web host, keeping the file system intact.

Be sure to chmod the main folder (or sub-folder) to 755 to allow the config.php file to create/write during install.

You should now have the following folders/files on your host account:

B. Installation Top

Run the Online Setup Wizard

Installation is quite easy and only takes a few minutes.

Once Tasked has finished uploading, simply go to http://www.yoursite.com/tasked/ (or wherever sub-folder you uploaded it to) and follow the on-screen instructions.
Easy to do, just follow the defaults and plug in your specific information.

1. Server Configuration Check

Tasked REQUIRES minimum PHP 5.3 & MySQLi Connection, and mcrypt_encrypt / mcrypt_decrypt.

There is a Server Configuration Check that will display before you will be able to install Tasked. If all checks out, great, click the button "Start the Installation". If not, you will not see the "Start the Installation" button and will not be able to install Tasked. Check with you host, and see if there is anything they can do for you.

2. Database Configuration & Time Zone

Tasked requires a MySQLi connection in order to run.
Hostname On most web hosts this usually defaults to "localhost"
Database Name The name of the database you plan to install Tasked to
Database Username Your username to access the database
Database Password Your database password
Select Time Zone Select your Time Zone from the dropdown

Once you have input your database information, click on the "On to Step 2" button.
If you run into any errors here, simply empty the database of any tables that have been created, delete the config.php file from the folder you uploaded Tasked to, and try again.

If everything was configured correctly, you will see the following:

3. Tasked Settings

Again, follow the defaults and plug in your site's specific information. You can set your Administrator password and Site name to be anything you would like. Once completed, be sure to hit "On to Step 3" to save your settings.

Installation URL: This should be auto-filled for you*.

*If the Installation URL is not auto-filled, you will need to enter it manually.
This is needed for email notifications. Include any sub-folder Tasked may be installed in. (ie. http://www.mydomain.com/fessup/)
Look at your browser's URL bar, and use that (remove the install/install.php from the end) as your Installation URL.

If you have any questions on this, please do not hesitate to email me via my Code Canyon Profile.

4. The Primary Admin Account

Complete the Primary Admin Account form. This is the main, "Superuser" for Tasked. This Admin Account cannot be deleted through the web UI, only from within the database (ie. PHPMyAdmin).
Once you have filled in the information for the Primary Admin, click the "Complete Install" button to complete the installation.

Once installation is completed, you will need to go back into your FTP application, and either rename or delete the installation folder on your webhost before you can log in as Administrator.

For security reasons please, DELETE or RENAME the "install" folder, otherwise you will not be able to log in as Administrator.

C. Custom Settings Top

1. Dates throughout Tasked

To change the way dates are displayed, you will need to edit the includes/functions.php file. The first functions are used to change the way dates are displayed. Follow the instructions to use the display format you would like.

Uncomment (remove the double slash - //) from the one you want to use.
Comment (Add a double slash - //) to the front of the ones you do NOT want to use.

I have included a few examples, and you can find more documentation on PHP's date() format here. If you have any questions on this, please do not hesitate to email me via my Code Canyon Profile.

2. Weather Widget

I have included a Weather Widget with Tasked. The weather is provided by simpleWeather. simpleWeather is a jQuery plugin to display current weather data for any location. You can disable the Weather Widget in the Site Settings if you choose not to use it (Global - will disable the Weather Widget for all users). Users can set their location via their profile.

3. Calendar Widget

I have also included a small Calendar Widget. This calendar does not hook in to the user's calendar, and is just there for easy reference. You can disable the Calendar Widget in the Site Settings if you choose not to use it (Global - will disable the Calendar Widget for all users).

D. Site Settings Top

1. Tasked General Settings

Once Tasked is installed, you can update the Site Settings after logging in as the Primary Manager. Go to Site Settings page from the Dashboard dropdown menu.

Installation URL Used in Notification emails. Must include the trailing slash.
Site Name ie. Tasked (Appears at the top of the browser and in other headings throughout the site).
Site Email Used in email notifications as the "from/reply to" email address.
Select Language Choose the Language file to use throughout Tasked.
Enable Self-Registrations Set to No to disable the ability for anonymous users Creating New Accounts.
Enable Weather Widget Global - Enables/Disables the Weather Widget for all users.
Enable Calendar Widget Global - Enables/Disables the Calendar Widget for all users.

2. Localization Files

Tasked is translation ready. All Localization files are located in the language folder. If you do not see your language file, you can use any of the other files. Once complete, upload the translations to your host in the correct folder. You can then set Tasked to use the files you translated in the Site Settings.

Any language files you may want to use will need to be translated from English.

E. Advanced — Styling & Images Top

1. Custom Styling

While Tasked already has a modern flat interface based on Twitter's Bootstrap Version 3.2.0, many of you will want to update it to your own liking. This is very easy, however, you will need to be able to write HTML/CSS code. For those that aren't versed, here is a quick overview. The easiest way to change the look is by editing the default CSS files named "tasked.css" and "custom.css". Next is to edit the page files, located in both the main and pages folder.

2. Images

Tasked uses a few images, the logo in the header is 170 x 890px. You can find a .psd of the logo with the files you downloaded from Code Canyon. All icons are generated from an Icon Font: Font Awesome (version 4.2.0). Check out all of Font Awesome's icons & usage at: http://fontawesome.io.

Icons & Images can be changed to your liking.

3. DataTables — Table plug-in for jQuery

DataTables is a plug-in for the jQuery Javascript library. It is a highly flexible tool, based upon the foundations of progressive enhancement, and will add advanced interaction controls to any HTML table.

Take a look at all of the awesome features DataTables offers at http://www.datatables.net

F. Help & Support Top

Please, if you have any questions, run into any issues or just need some help, do not hesitate to contact me.
I believe in providing the best support possible, and I monitor my email just about 24/7.

If you are thinking of giving Tasked anything less then 5 Stars, please tell me what I can do to make it a 5 Star experience for you.
I love to hear feedback, and welcome any suggestions you may have to make Tasked better.

G. A Note About FTP Top

If you are having problems with Tasked after successfully installing and logging in the for the first time you should check your FTP software settings. I have found in many cases that numerous FTP programs are not uploading files correctly.

Check your FTP program to see if it is uploading files in ASCII - which is causing the file code to be uploaded in one long line.
Try changing it to Binary and uploading the files again. Upload everything except the install folder and the config file (or better yet, if you have not started using Tasked, just wipe the install and the database and reinstall a fresh copy).
I use CuteFTP for my uploads and ran into this problem when all of the sudden everything I was working on just seemed to stop working as expected.