=== WP HOURLY ===
Contributors: wordpressheroes
Donate link:
Tags: billable time tracking app,time tracking app,time tracking software,time tracking plugin,employee monitoring,employee screen monitoring,employee time tracking,time tracking,project management,billable time,hourly work,screenshots,track time with screenshots,upwork,woocommerce,woocommerce billable time,freelancer,freelancing,freelancing platform,freelancing website
Requires at least: 4.0
Tested up to: 5.2.2
Stable tag: trunk
Requires PHP: 7
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WP HOURLY allows you to track billable time and have your customers pay you for it through your WooCommerce website. It is ideal for Freelancers and Agencies alike, giving you to ability to create tasks and assign them to your team members (Employees). An Employee can then submit time records which will show up in the My Account section of your WooCommerce website. The plugin also features extensive reports as well.

== DESCRIPTION ==

WP HOURLY allows you to track billable time and have your customers pay you for it through your WooCommerce website. **It is ideal for Freelancers and Agencies alike**, giving you to ability to create tasks and assign them to your team members (Employees). An Employee can then submit time records which will show up in the My Account section of your WooCommerce website. The plugin also features extensive reports as well.

While this plugin is best suited for Agencies and Freelancers who need to charge for their hourly work directly on their website, and not on any big freelancing platform, it works just as fine for other businesses that need to provide time sheets to their Customers and have them paid out through WooCommerce. You can also run it without WooCommerce, but then, just the reports would be available and you would have to invoice your customers by diferent means (like an invoicing plugin or service, etc.)

**THE CONCEPT**

We are developing using WordPress our self and we do a lot of hourly work. We also work on freelancing platforms but we never liked the restrictiveness they come with or how uneasy it was to merge them into our country specific book keeping and accounting. So we went ahead to create our own solution. We developed WP HUORLY and we have since tracked over 14.000 billable hours with it in 2+ years.

**SO WHY COULDN'T YOU USE IT TO CHARGE YOUR CUSTOMERS BY THE HOUR AS WELL?**

Many agencies or freelancers already have at least a portfolio website. Many of them are running, you guessed it, WordPress. Even more, some may already be running WooCommerce and be selling other services, such as Hosting, Domain names, etc.

Thus, we decided to use WooCommerce as the backbone for this plugin and here is why:
* WooCommerce integrates easily with other invoicing or accounting plugins and software and billable time makes no exception
* WooCommerce makes it easy to accept Credit Card and PayPal payments
* Since WooCommerce comes with the My Account section for Customers, we found it very easy to tap into it… it makes perfect sense after all, as Customers need to see a history of the hours they paid

**So, WP HOURLY basically allows you to record billable time and have your customers pay it through your WooCommerce website**

**KEY PLUGIN FEATURES**
* Set a global Hourly Rate or specify a different hourly rate per Customer
* Assign Projects, Tasks and Time Records to a WooCommerce customer
* Allow that customer to checkout in WooCommerce and pay for the recorded billable time
* Display an "Unpaid hours" page in the My Account section so Customers can see what unpaid hours they have
* Time Records are grouped per week at the moment of checkout and on the WooCommerce order your Customer will see what time was paid for which week interval
* Allow your customers to pay each Week individually or only allow full payments
* Assign Time Records to your Employees and thus see how much time your team spends on what Tasks
* Find Projects and Tasks easy with the built in search and filter options
* List a breakdown of the billed time (Projects and Tasks) on the WooCommerce order page
* Compatible with the [Order Signature for WooCommerce](https://superwpheroes.io/product/order-signature-for-woocommerce-pro/ "Convert the WooCommerce order into a Signed Confirmation of Service document") plugin - turn your orders into Signed Confirmation of Service documents
* Mark Time Records as paid upon changing the WooCommerce Order status to Completed or mark them back to unpaid
* Detailed Time Sheet Reports both for Administrators and Customers
* Compatible with Bootstrap 4
* Adds a custom PayPal checkout gateway in order to charge for decimal quantities (by default, paypal does not allow to decimals in quantity but you may need to charge for 10.7h for example)
* Works great with Braintree Pyaments; should work just fine with most payment gateways

**PLANNED NEW FETURES SOON TO BE RELEASED**
* A dashboard widget to show Administrators all the unpaid hours in the system (ETA: we have it ready, it needs integrated)
* Braintree integration so you can charge your customers directly for the unpaid hours if they save their credit card with your WooCommerce. How cool is that?  (ETA: we have it ready, it needs integrated)
* A quick reports dashboard widget to show Administrators what hours were worked on what Customer account, per Day, Project, Task and Assignee  (ETA: we have it ready, it needs integrated)
* A quick reports dashboard widget to show Administrators what hours were worked by which Employee, per Day, Project and Task (ETA: we have it ready, it needs integrated)

**PRO ADD-ONS**
* [WP HOURLY TRACKER](https://wphourly.com/add-ons/wp-hourly-tracker/ "Track billable time with Screenshots") -  automate time tracking using the Desktop App (macOS,Windows and Linux) and provide your Customers with transparent time reports with Screenshots... kind of like Upwork, but at a reasonable cost. Offer your Customers the same experience they would get on a big freelancing platform, with no chains attached. Actually, with a bot of knowledge, you could use it to set up your own Freelancing website or marketplace. [DOWNLOAD HERE](https://wphourly.com/add-ons/wp-hourly-tracker/ "Download")
* ASANA Integration (we're working on it)
* JIRA Integration (we're working on it)
* TRELLO Integration (we're working on it)
* KANBAN TASKS BOARD (project management board) (we have it, just need to polish it up a bit)

== Installation ==

This section describes how to install the plugin and get it working.

e.g.

1. Make sure you already have WooCommerce installed on your website if you wish to charge the hours directly too; if not, you can still just run reports and invoice them to your customers any other way.
1. Unzip and upload the plugin folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen directly.
1. Activate the plugin through the 'Plugins' screen in WordPress
1. Use the Wp HOURLY menu screen in your WordPress dashboard to configure the plugin
1. Create a WooCommerce Product category to hold your Hourly Work products
1. Create as many WooCommerce products you need to use as hourly Work Rates. The price you set to these products are the rates you will charge your customers. Usually, just one product is enough
1. If you wish to charge a particular customer a different rate, just specify that rate on the User Edit screen in WordPress
1. Create at least one user with the role Employee and mark it as Active ( you can mark it as active AFTER the user has been generated in WordPress)
That's it!

Now, in order to actually start charging for your time you need to add time in one of the 2 following ways:

**separate time per Tasks and Projects**
1. Create a Project and assign it to a Customer
1. Create a Task and assign it to a Customer, Project and Assignee
1. Create Time Records and assign them to a Customer, Project, Task and Assignee

**just add time for a client**
1. Create time Records and assign them to a Customer

Only the Customer is a required field. You need to make sure that whatever you want the customer to see is assigned to that Customer, be it a Project, a Task or Time Records.

You may choose not to group your Time records by Projects and Tasks, but we can advise to do so: it is easier for you to manage on the long run and clients prefer to see things organised as well

== Frequently Asked Questions ==

= To what purposes can I use WP HOURLY? =
You can use WP HOURLY in any of the following setups
1. Use it as a hosted Project Management tool for your employees and customers, and if you have WooCommerce installed, charge your customers for the tracked time with WooCommerce
1. Use it together with the [WP HOURLY TRACKER](https://wphourly.com/add-ons/wp-hourly-tracker/ "Track billable time with Screenshots") add-on to monitor employee desktops and automate time tracking. Again, if WooComemrce is installed, that time can be paid by your customers through WooCommerce
1. Use WP HOURLY with the [WP HOURLY TRACKER](https://wphourly.com/add-ons/wp-hourly-tracker/ "Track billable time with Screenshots") in order to provide transparency to your customers; they love it! Think Upwork.
1. Use it as is, and add time manually or allow your employees to add time manually
1. We're not 100% sure of the required setup yet, but we have already tried WP HOURLY together with the [WP HOURLY TRACKER](https://wphourly.com/add-ons/wp-hourly-tracker/ "Track billable time with Screenshots") in a Freelancer Marketplace (freelancing website) setup. Most probably a multi-vendor setup would be required.

= What 3rd party plugins do I need in order to use WP HOURLY? =

The minimum needed is WooCommerce. WP HOURLY is in a sense an add-on for WooCommerce...in order to also charge your clients for the time tracked. if not, you can just use the reporting fucntionality and bill by other means.
After that, you can use any other WooCommerce plugin to handle your needs, such as an Invoicing plugin or an different payment gateway etc.
WP HOURLY basically allows you to sell a product ( let's say we have the "Hourly Development" product, that costs 50 USD ) at a Quantity equivalent to X (the amount of time tracked)

= Can people overwrite the Quantity (hours) in the cart? =

Nope. We made sure that people can not access that Cart if they are paying for hourly products. If they are looking to checkout with other products or services on your website, like Hosting for example, if you are selling hosting, they go on uninterrupted, but if they are looking to pay for their hours, then they can only access the checkout page and pay for it.

= What user roles does this plugin add or use? =

WP HOURLY adds an Employee role (which is basically and assignee for a Task or Time Record). This is done to help facilitate teams, or agencies. Single freelancers may not need this feature. If WooCommerce is not installed, then it will also create the Customer user role... time has to be billed to a customer, after all.

WP HOURLY heavily relies on the Customer role inserted by WooCommerce. This is basically your client, the entity who needs to pay for the generated billable time :)

= How do I use Invoices or accounting software integration with WP HOURLY? =

You do not. You use it with WooCommerce, that is the point :) Feel free to use any invoicing or accounting plugin or service that works with WooCommerce and you would have used regardless.

= GDPR =

This plugin does not use any kind of personal data except for what is already stored and used by your WordPress and WooCommerce website. So as long as you have GDPR covered for that, which you should, you should be good to go.


== Screenshots ==

1. WooCommerce Checkout page showing the hours about to be paid out, grouped by Weeks screenshot-1.(png).
2. WP HOURLY Projects page in the WordPress Dashboard screenshot-2.(png).
3. WP HOURLY Edit Project screen screenshot-3.(png).
4. WP HOURLY Edit Task screen screenshot-4.(png).
5. WP HOURLY Edit Time Record screen screenshot-5.(png).
6. WooCommerce Thank You page with activity report screenshot-6.(png).
7. WP HOURLY settings page screenshot-7.(png).
8. WP HOURLY Unpaid Hours in Customer My Account area (WooCommerce or with shortcode) screenshot-8.(png).
9. WP HOURLY view WooCommerce Order with activity breakdown. WP HOURLY orders are actually renamed to "Payments" as they are basically payments for services delivered and not orders for future payments screenshot-9.(png).

== Changelog ==


== Upgrade Notice ==