= Team Roster  =

{{{
#!html
<div class="system-message"><a href="http://trac-hacks.org/wiki/UserManagerPlugin"><b>UserManagerPlugin</b></a> is now out. All teamroster's features are included in UserManagerPlugin. Please contact me if you have any problems migrating to UserManagerPlugin. </div>
}}}

== Description ==

The main goals of this plugin are:
 - Help defining project's team inside project's workspace( Including pictures )
 - Increase cross-project visibility into project's team.

== Bugs/Feature Requests == 

Existing bugs and feature requests for TeamRosterPlugin are 
[report:9?COMPONENT=TeamRosterPlugin here].

If you have any issues, create a 
[http://trac-hacks.org/newticket?component=TeamRosterPlugin&owner=cbalan new ticket].

== Download ==

Download the zipped source from [download:teamrosterplugin here].

== Source ==

You can check out TeamRosterPlugin from [http://trac-hacks.org/svn/teamrosterplugin here] using Subversion, or [source:teamrosterplugin browse the source] with Trac.

== Configuration ==
Enable the plugin in trac.ini:
{{{
[components]
tracteamroster.* = enabled
}}}

== API ==

{{{
#!python

from tracteamroster.api import UserProfilesSystem, UserProfile

# Get profile by id(username)
user_profile = UserProfilesSystem(env).get_userProfile( "cbalan" )

# Get active userProfiles
team = UserProfilesSystem(env).get_active_userProfiles()

# Search users ( Dummy example: All active developers that have an gmail account )
search_result_list = UserProfilesSystem(env).search_userProfile(UserProfile( role="developer", email="%gmail.com", enabled=1 ))

# Add user Profile
UserProfilesSystem(env).add_userProfile(UserProfile(id="jfoo", name="John Foo", email="jfoo@asd.org", role="developer"))

# Update
someUserProfile = UserProfilesSystem(env).get_userProfile("jfoo")
someUserProfile.role = "senior developer"
someUserProfile.bio = """
Maecenas ut mauris. Morbi congue nunc ut tortor. Pellentesque molestie cursus enim. 
Praesent gravida consequat mauris. Nulla cursus cursus magna. 
Sed libero. Integer dapibus urna in mauris. 

Fusce fringilla: 
 - Mauris ipsum mauris, semper at, lacinia ultrices, pellentesque eget, arcu. 
 - Etiam vel enim et nunc luctus gravida. Morbi suscipit scelerisque odio. 
 - Mauris porta. 

Nullam dui. Nullam egestas, massa eu condimentum mattis, enim ipsum tincidunt purus, 
vitae vestibulum sapien eros vitae libero.
"""

someUserProfile.save()

# Remove
UserProfilesSystem(env).remove_userProfile(someUserProfile)

}}}

== Example ==

In order to use it(out of the box) you have to :
    1. Define project's team by using 'Manage Team' option from the trac admin page.
    1. Call !TeamRoster macro in wiki pages. 

== Screenshots ==
[[Image(snapshot2.png, width=400px)]]
[[Image(snapshot4.png, width=400px)]][[BR]]
[[Image(snapshot3.png, width=400px)]]
[[Image(snapshot5.png, width=400px)]]

== Recent Changes ==

[[ChangeLog(teamrosterplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:cbalan] [[BR]]
'''Contributors:'''