[[PageOutline(2-5,Contents,pullout)]]
= Htgroups Plugin =
{{{
#!html
<div class="system-message" float="left" overflow="auto">
<b>Notice:</b> This plugin is deprecated in favor of the <a href="http://trac-hacks.org/wiki/UserManagerPlugin">UserManagerPlugin</a> or <a href="http://trac-hacks.org/wiki/HtGroupEditorPlugin">HtGroupEditorPlugin</a>.
</div>
}}}

== Description ==

Trac plugin to enable the same group file that you use with Apache's !AuthGroupFile or !AuthDigestGroupFile directive to be a provider of group membership information.

For Trac 0.11 this plugin depends on !ClearSilver. Consider the UserManagerPlugin or the Genshi-based HtGroupEditorPlugin as alternatives.

== Bugs/Feature Requests == 

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

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

== Download ==

Download the zipped source here:
|| ''Trac Version'' || ''Zip'' ||
|| 0.9              || [download:htgroupsplugin/0.9] ||
|| 0.10 and above   || [download:htgroupsplugin/trunk] ||

== Source ==

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

== Example ==

Requires setup in trac.ini

If you are not using the AccountManagerPlugin:
{{{
#!ini
[htgroups]
group_file = /var/trac/trac.htgroups
}}}

If you are using the AccountManagerPlugin:
{{{
#!ini
[account-manager]
group_file = /var/trac/trac.htgroups
}}}
See its documentation for more configuration options. Current plugin versions support only Trac versions down to 0.11 now.

Why the two variants?  The original plan was to extend the AccountManagerPlugin to manage the group file as well.  There is instead another handy plugin to this this now: the TracHtGroupEditorPlugin

== Recent Changes ==

[[ChangeLog(htgroupsplugin, 3)]]

== Author/Contributors ==

'''Author:''' [wiki:froosh] [[BR]]
'''Maintainer:''' ''none (deprecated)'' [[BR]]
'''Contributors:'''