* needing support ? Ask and answer in the chat at irc.kde.org, channel #kde
* needing support ? Ask and answer in the chat at irc.kde.org, channel #kde
= Developing KTimeTracker =
If you are interested in helping to develop KTimeTracker, see '''[[KTimeTracker/Developing the Developing section]]'''
* look at [http://bugs.kde.org/buglist.cgi?short_desc_type=allwordssubstr&short_desc=&long_desc_type=allwordssubstr&long_desc=&product=KTimeTracker&component=general&component=reporting&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bugidtype=include&bug_id=&votes=&emailassigned_to1=1&emailtype1=substring&email1=&emailassigned_to2=1&emailreporter2=1&emailcc2=1&emailtype2=substring&email2=&changedin=&chfieldfrom=&chfieldto=Now&chfieldvalue=&order=Reuse+same+sort+as+last+time&cmdtype=doit&newqueryname=&namedcmd=allKTimeTrackerbugs our Bugzilla]
* join our discussion on irc.kde.org, channel #kontact
* learn programming with KDE's [http://techbase.kde.org/Development/Tutorials Programming Tutorial]
== So you want to become a KTimeTracker developer ==
Here are your classes:
* mainwindow.*: Is the main window of the KDE application
* karm_part.*: Is the KPart of KTimeTracker
** timetrackerwidget.*: Is a widget with no or several tabs that contain
*** taskview.*: Is a treeListWidget that contains:
**** task.*: A QObject and QTreeWidgetItem. A task can be constructed from a taskview and a todo. As soon as you instanciate a task, it becomes visible in your TreeWidget.
**** karmstorage.*: Is the storage backend that contains a:
***** KCal::ResourceCalendar
== Nokia N810 ==
I got a Nokia N810 from Nokia to allow me porting KTimeTracker to it. I appreciate this a lot and am now kompiling KTimeTracker for arm. The project is not ready, here is what I found out:
To kompile KTimeTracker for the Nokia N810
* add the maemo repository
* install openssh
== dbus ==
dbus is clearly a developer topic. To test the dbus functionality of your KTimeTracker, have KTimeTracker running and proceed like in this example:
You want to test the translation of KTimeTracker. For this, you want to call KTimeTracker in, say, german. For this, you need to know how you at all can call a KDE 4 program in another language than english. Here is as an example how I call akregator in german:
The following similar programs can give you inspiration how to move forward developing:
* hourglass
* gnotime
* titrax
* taskCoach
* Hamster
== Kontact plugin vs. Standalone ==
The Kontact plugin is realized via a KPart. The elegant solution would be to have one KPart that can be integrated into Kontact and one shell that just displays the KPart. This is not so far now. At the moment, karm_part.cpp implements the KTimeTracker part and mainwindow.cpp implements the standalone application.
Here's a patch that allows us to use the karm part (karm_part.cpp) as widget of mainwindow, not perfect yet, but showing a direction:
The idletimedetector is in the equally-named .cpp and .h file. It starts a qtimer and at every timeout, checks, if the X extension delivers for the last user interaction a timepoint that is further away than the maxIdleTime.
== About storage ==
The storage of your KTimeTracker data takes place in an iCal file. That format needs a bit of explanation. A simple one looks like the following:
KTimeTracker tracks time spent on various tasks. It is useful for tracking billable hours and can report the hours logged by task and day.
This time history can be exported to a comma-delimited text file for import into other billing and/or project management tools.
KTimeTracker detects when your keyboard and mouse are idle and can associate different tasks with different desktops, two tools that can help keep the timer running on the correct task.
Using KTimeTracker
What KTimeTracker can do for you
The current stable version of KTimeTracker (4.1) can:
organize and stopwatch tasks, subtasks
KTimeTracker allows you to organize and stopwatch your work. You can put your daily todo-list into that tool. You can group your work by tasks, subtask and n-th level tasks, meaning that every subtask can still have a subtask below it, up to some 1000 levels.
edit task history and comments
KTimeTracker allows you to edit your task's history and to put a comment for every event that you have stopped:
Options
KTimeTracker 4 has the following behavior options:
Compatibility
Up to KDE 3.1 (incl.), flat files were used to store the data. From KDE 3.2 on, the iCal format is used, but flat files can still be imported until KDE 4. With KDE 4, the custom fields
X-KDE-karm-duration, X-KDE-karm-totalTaskTime, X-KDE-karm-totalSessionTime and X-KDE-karm-desktopList were renamed to X-KDE-KTimeTracker-duration and the respective other names. KTimeTracker 4 can still read karm iCal files, but not the other way round.
