summaryrefslogtreecommitdiff
path: root/demos/time-tracker/protected/pages/Welcome.page
blob: 65ada02d42f37206e39bca2b42376b3e1c0c9c5b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head>
	<title>Welcome</title>
	<style type="text/css">
		table {
			border-collapse:collapse;
		}
		
		td, th {
			border:1px solid black;
			padding: 10px;
		}
		
		th {
			text-align:left;
		}		
	</style>
</head>
<body>
	<h1>Time Tracker Starter Kit</h1>
	<p>
		Welcome to your new <strong>Time Tracker</strong> sample application. The key features are:</p>
	<ul>
		<li><strong>Projects.</strong> Define project information like due dates, hours to complete,
			project resources, and more.</li>
		<li><strong>Track Time.</strong> Track time spent each day by category and project.</li>
		<li><strong>Reports.</strong> Generate progress and team resource reports across multiple projects.</li>
	</ul>
	<p>
		The <a href="index.php">Time Tracker site is ready to run!</a> No changes are needed.</p>
		
	<hr />
		
	<h2>Site Members and Roles</h2>
	<p>
		Your Time Tracker Web site allows visitors to register as members and then log in.
		Members have specific privileges defined by roles such as administrator or guest.
		Each Time Tracker Web site defines site-specific roles.
		The following table describes what features are available to visitors in different roles.</p>
	<table>
		<tr>
			<th>Visitor</th>
			<th>Privileges</th>
			<th>Default Login</th>
		</tr>
		<tr>
			<td>
				Not logged in</td>
			<td>
				No privileges.</td>
			<td></td>
		</tr>
		<tr>
			<td>Logged in</td>
			<td>
				No privileges. All members must be associated at least with the role <strong>Consultant</strong>.</td>
			<td>N/A</td> 
		</tr>
		<tr>
			<td>Logged in as <br />
				<strong>Consultant</strong></td>
			<td>May log time entries only.</td>
			<td>username: <tt>consultant</tt><br />
				password: <tt>consultant</tt></td>
		</tr>
		<tr>
			<td>
				Logged in as<br />
				<strong>Project Manager</strong></td>
			<td>
				May additionally edit all projects and view reports.</td>
			<td>username: <tt>manager</tt><br />
				password: <tt>manager</tt></td>
		</tr>
		<tr>
			<td>
				Logged in as<br />
				<strong>Project Administrator</strong></td>
			<td>
				May additionally view the list of all users.</td>
			<td>username: <tt>admin</tt><br />
				password: <tt>admin</tt></td>
		</tr>
	</table>
	<p>
		Be sure to create a user name for yourself and assign yourself to a role (such as administrator) that can manage the site.</p>
	<p>
		Visitors can register by clicking the <strong>Create new </strong>user link on the home page.
		New members are activated automatically, and are assigned to a role as specified in the <tt>application.xml</tt> file.
		You can manage users (for example, assign them to a role) when login as administrator.
		For details, see <a href="#AppendixA">Appendix A</a>.</p>
		
	<hr />
	
	<h2>Projects and Time Entries</h2>
	<h3>To add a project and categories</h3>
	<ol>
		<li>Log in to the site as a member in the role <strong>Project Manager</strong> or <strong>Project Administrator</strong>.</li>
		<li>Click the <strong>Projects</strong> tab and then click <strong>Create New Project</strong>.</li>
		<li>Specify a project name, project manager, estimated complete date, estimated duration, and description.</li>
		<li>Under <strong>Specify Project Members</strong>, select a resource. You must select at least one resource. </li>
		<li>Click <strong>Save</strong>. A category pane is displayed on the right.</li>
		<li>Specify a category name, category abbreviation, and duration.</li>
		<li>Click <strong>Add</strong>. The new category is displayed in the categories list. </li>
		<li>Repeat steps 6 and 7 to create additional categories.</li>
	</ol>
	<h3>Log a Time Entry</h3>
	<ol>
		<li>Log in to the site as a consultant (member in the role <strong>Consultant</strong>).</li>
		<li>Click the <strong>Log</strong> tab.</li>
		<li>Under <strong>Log your hours</strong>, choose a project and a category and fill in the day, hours, and description.</li>
		<li>Make sure the correct consultant is selected in the <strong>Time Sheet For</strong> list. </li>
		<li>Click <strong>Add Entry</strong>.</li>
	</ol>

	<hr />
	
	<h2>Reports</h2>
	<h3>To create a project report</h3>
	<ol>
		<li>Log in to the site as a member in the role <strong>Project Manager</strong> or <strong>Project Administrator</strong>.</li>
		<li>Click the <strong>Reports</strong> tab and then click <strong>Project Reports</strong>. </li>
		<li>Under <strong>Select a project</strong>,<strong> </strong>choose one or more projects.</li>
		<li>Click <strong>Generate Report</strong>.</li>
	</ol>
	<h3>To create a resource report</h3>
	<ol>
		<li>Log in to the site as a member in the role <strong>Project Manager</strong> or <strong>Project Administrator</strong>.</li>
		<li>Click the <strong>Reports</strong> tab and then click <strong>Resources Report</strong>. </li>
		<li>Select one or more projects, select one or more resources, and then specify a date range. </li>
		<li>Click <strong>Generate Report</strong>.</li>
	</ol>
	
	<hr />
	
	<a name="AppendixA" />
	<h2>Appendix A - Manually Managing Members and Roles</h2>
	<p>
		Your Time Tracker Web site allows visitors to register as members.
		Members have specific privileges defined by a role you assign to them.
		A special administrative role has rights to perform all functions in the site.</p>
	<p>
		To create a user (member):</p>
	<ol>
		<li>Login as administrator, click <strong>Create New User</strong>.
		</li>
		<li>...</li>
	</ol>
	<p>
		To modify an existing member's role:</p>
	<ol>
		<li>Login as administrator, click <strong>List Users</strong>.
		</li>
		<li>...</li>
	</ol>

	<hr />
	
	<h2>Appendix B - Publishing Your Site</h2>
	<p>
		When you are ready to share the Web site with others, you can copy it to your Web server.
		You need to know the File Transfer Protocol (FTP) address of your server, and if required, the user name and password assigned to you.</p>
	<ol>
		<li>...</li>
	</ol>
</body>
</html>