Thank You for purchasing TimeZone Employee Management & Time Clock.

If you have any questions that are beyond the scope of this help file, please do not hesitate to contact me via my Support Center.
I am always happy to help if you have any questions relating to TimeZone.

TimeZone Employee Management & Time Clock

I put a ton of love into this version, and added as many features as I could. Did I get every feature buyers requested? No, some features were taking more time to figure out on how to add, or just would not work as expected.

Please note that this is a complete re-write of TimeZone. I rebuilt just about everything from the ground up to provide you with the best Time Clock I could. Due to the re-write, you will not be able to import any records from the previous version of TimeZone. This is unavoidable due to many factors, mostly how time is now recorded in the database. Time tracking is now more accurate then ever before. I also rewrote how passwords and other user sensitive data was being encrypted, making TimeZone more secure.

I also removed some features that were really not in-line with TimeZone being primarily a Time Clock. Some of those are: Employee personal data like Salaries, Social Security Numbers and other personally identifiable information. I also removed the Leave feature as it was causing a lot of confusion for buyers, and is not really part of a Time Clock system. personally identifiable information & Leave is usually tracked in a Payroll system, which TimeZone is not.

If you have any questions or would like to give me feed-back on TimeZone's update, I would love to hear them. Your feed-back is what inspires new ideas for future updates. You can post your questions/feed-back on TimeZone's Forum at my Support Center.

As always, a BIG Thank You to all of my buyers, I really appreciate your continued support & trust in me.  

1. Unzip TimeZone and have a look around.

Unzip the TimeZone file and take a look at the file structure. You should see 9 folders and 2 files.

2. Create a New 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. timezone
  • The database username ie: database_user
  • The database password ie: database_password.

3. Upload TimeZone

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

Be sure to cmod/permissions the main (root), avatars and docs folders to 755.

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

1. Run the Online Setup Wizard

Installation is quite easy and only takes a few minutes.

Again, Make sure the main root folder (where you uploaded TimeZone to) and all other folders listed above is cmod to 755 or installation will fail.

Once TimeZone has finished uploading, simply go to http://www.yoursite.com/timezone/ (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.

2. Server Configuration Check

TimeZone REQUIRES PHP 5.3+ & MySQLi Connection, mcrypt_encrypt / mcrypt_decrypt, imagecreatefrompng (PNG Image Support) and fgetcsv (CSV File Support).
There is a Server Configuration Check that will display before you will be able to install TimeZone. If all checks out, great, click the button "Go! Start the Installation". If not, you will not see the "Start the Installation" button and will not be able to install TimeZone. Check with you host, and see if there is anything they can do for you.

3. Database Configuration

  • Usually (but not always - check with your web host) 'localhost' Hostname
  • Your username to access the database Database Username
  • Your database password Database Password
  • The name of the database you plan to install TimeZone to Database Name

Once you have input your database information, click on the "On to Step 2" button.

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

Your database has been correctly configured.

If you do not see the message above, and get a blank screen or an error - check your error logs. Most of the time this happens due to your web account/host not supporting a needed function. This can happen even if you pass the pre-installation check. Check with your web host and see if there is any thing they can do to help.

4. TimeZone Settings

Again, follow the defaults and plug in your site's specific information. You can set your Administrator email, 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.
Include any sub-folder TimeZone may be installed in. (ie. http://www.mydomain.com/timezone/)
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 contact me via my Support Center.

5. The Primary Admin Account

Complete the Primary Admin Account form. This is the main, "Superuser" for TimeZone. 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 before you can log in as Administrator.

For security reasons and to stop any possible re-installations please, DELETE or RENAME the "install" folder.

Once TimeZone is installed, you can update the Site Settings after logging in as the Primary Admin. Go to Site Settings page from the Manage dropdown menu.

All Sensitive data is encrypted in the database.

1. Site Settings

These are the Global Settings that are used throughout TimeZone.

2. Localization Settings

3. Upload Settings

This is one of my first attempts at limiting what Administrators/Managers can access. Go to the "User Authorizations" link from the Users drop-down:

Select User from the drop-down, and then click "Load User". The User's basic information will be displayed and current Authorizations will be checked. You can then modify the User as needed. Save your changes. If you wish to load a new User, you will first need to clear any data that is currently being displayed.
Add Authorizations for a User to allow that User to access specific areas of TimeZone. A User needs to be set as an Administrator/Manager for the Authorizations to apply.

Administrators/Managers only have access to what they are authorized for. Superuser Accounts have access to everything, regardless of what their Access Authorizations are set to.
If you are not a Superuser and remove your permissions for User Access Authorizations, you will lose access to this page.

1. Language Files

TimeZone is translation ready. The primary Localization files are located in the folder named language/. If you want to use a different language other then English, you will need to translate the "custom.php" file. Once translated, you can then load that file via the Global Site Settings — Localization drop-down.

Want to change the footer links/text? Easily change the footer, and meta data in the language files. Look for the section includes/footer.php starting on line 100 in the language file you have loaded. Change lines 107 & 108 to your liking.

You can also change the site meta data in the same language file. In the start of the file under the "All Pages - Globals" look on lines 20 & 21. Again change these values as you need.

2. Date Formats

To change the way dates are formatted, you will need to modify the includes/functions.php file. Follow the instructions starting on line 172.
Uncomment (remove the double slash - //) from the date format you want to use
Comment (Add a double slash - //) to the front of the date formats you do NOT want to use

3. dataTables Table Tools Localizations

The dataTables Table Tools Plug-in will also need to be translated. I have tried to make this as easy as possible, moving all of the text that the plug-in uses to a separate include file — "tableTools.php". You can find this file in the main js folder:

Translate lines 9 through 18 just as you did in the language file. Do NOT modify any other code in this file.

4. simpleCalendar JS File

The simpleCalendar javascript file will need to be translated. The file "simpleCalendar.js" can be found in the js/ folder:

Again, follow the instructions at the top of the file.

5. Full Calendar JS File

The Full Calendar javascript include file will need to be translated. This powers the User's Calendar. The file "calendar.js" can be found in the js/includes/ folder:

Again, follow the instructions at the top of the file.

6. timeclock PHP File

The timeclock PHP include file will need to be translated. The file "timeclock.php" can be found in the includes/ folder:

Again, follow the instructions at the top of the file.

7. Finally, User Authorizations Javascript File

The User Authorization js file will also need to be translated. The file "adminAuths.js" can be found in the admin/js/ folder:

Again, follow the instructions at the top of the file.

1. CSS Styles

While TimeZone already has a modern interface based on Twitter's Bootstrap (version 3.3.4), many of you will want to integrate it into your own design. 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 "styles.css" and "custom.css". Both of these files can be found in the css folder.

The bootstrap.css file is the original, unmodified Bootstrap styles, and you should not alter this file. If you want to make any changes to the bootstrap components, you should add the changes to the custom.css file only.

2. Images

TimeZone uses a few images for the different logos and page background.

  • Main Background: images/bg.png (25px x 25px)
  • Header Logo: images/logo.png (265px x 65px)
  • Signin Logo: images/signin.png (350px x 86px)

The icons used in the sorting images for all dataTables are located in images/sorts folder.

Icons are generated from an Icon Font: Font Awesome (version 4.3.0). Check out all of Font Awesome's icons & usage at: http://fontawesome.io.

1. Dashboard

The Dashboard gives the user a basic breakdown of their account. They can easily see any new messages received, Open tasks and total hours for the week.

2. Calendar

The User's calendar has also been reworked, allowing special characters in Event Titles and Descriptions. The Calendar retrieves data from the database via AJAX on load. Users can create private events, and view all public events. Managers/Admins can create Public Events that will display on all user's calendars. This is a great features for notifications, holidays and approved time off.

3. Tasks

Tasks work basically the same as before, but now The assigned Manager and all Superusers can create and view User Tasks. No more creating a task for a user, assigning it to them and not being to see it again.

4. Messages

TimeZone has in integrated Private Messaging system. Send and receive messages from any active user.

5. My Account

Here the user will find their Schedule (if enabled), Time Logs, Personal Documents and their Account Profile. Users can upload their own documents, as well as view any documents Managers/Admins have uploaded for them. Their Schedule is view only. They can access all of their time entries, and all time worked history.

6. Users (Formally Employees)

Add your employees (refereed to as Users in TimeZone) via the Users New User menu link. Once a user account has been created, you can then use the User Authorizations to elevate the User to a Manager or an Administrator, and assign the appropriate permissions if needed. Users have access to all of TimeZone's base functions — Dashboard, Clocking In and Out, Messaging, Calendar, Tasks and if enabled, Schedules.

7. User Status

New! Now you can see who is clocked in and out easily on one page. If a user forgot to clock out, you can clock that user out from the User Status page. See total time worked for each user for the current week.

8. Reports

The Reports feature in TimeZone has been re-worked to include better reporting options. Easily see hours worked for any given time period. I have also included a feature to convert the total time to decimal hours.
New! Activity Report shows all activity from all users. Just about all actions log an Activity record. See who is clocking in by IP Address, Who is deleting what and what all of your users area doing inside of TimeZone.

9. Manage Schedules

New! As requested from many buyers, I have included a Schedules feature into TimeZone. Here you can either manually add schedule shifts, or upload a CSV file full of shifts. Work shifts show up on the users schedule calendar.
Uploading a CSV file of shifts is easy, just follow the instructions and the format on the example CSV template.

10. Manage Tasks

New! You can now create and manage Tasks for all employees. Create and assign a task to a user, and track the progress of that task.

10. Manage Timecards

Improved! Easily view all time recorded for all users. Click on the week you would like to view, and see all logged time records for that week. Tim In, Time Out, Type of entry, and more. easily manage the time entries with the ability to edit or delete a record. Time is shown in total hours and in decimal hours.

11. User Documents

Quickly and easily see all User documents uploaded through TimeZone. Upload, manage and view/download documents as needed.

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

If you are thinking of giving TimeZone 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 TimeZone better.

If you are having problems with TimeZone 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 TimeZone, 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.