[[PageOutline(2-5,Contents,pullout)]] = Restrict access to sections of the Wiki == Description This plugin allows you to protect wiki pages against access. == Bugs/Feature Requests Existing bugs and feature requests for PrivateWikiPlugin are [report:9?COMPONENT=PrivateWikiPlugin here]. If you have any issues, create a [/newticket?component=PrivateWikiPlugin new ticket]. [[TicketQuery(component=PrivateWikiPlugin&group=type,format=progress)]] == Download Download the zipped source from [export:privatewikiplugin here]. == Source You can check out PrivateWikiPlugin from [/svn/privatewikiplugin here] using Subversion, or [source:privatewikiplugin browse the source] with Trac. == Installation Install the plugin, either for a single project or globally. See the details on how to install a plugin at [trac:TracPlugins]. To install the latest development branch, perform the following steps: 1. Run the following: {{{#!sh easy_install https://trac-hacks.org/svn/privatewikiplugin/trunk/ }}} 1. Enable the plugin in your `trac.ini` file: {{{#!ini [components] privatewiki.* = enabled }}} Alternatively, this plugin can be enabled in the Web Admin section of your Trac installation. 1. In `trac.ini` modify the `permission_policies` to include `PrivateWikiPolicy` before the default entries (order is important!). If permission policies from other plugins are used, care will need to be taken to ensure the correct order. If `AuthzPolicy` is used to implement TracFineGrainedPermissions, then the order is most likely `AuthzPolicy, PrivateWikiPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy`. Before: {{{#!ini [trac] permission_policies = DefaultPermissionPolicy, LegacyAttachmentPolicy }}} After: {{{#!ini [trac] permission_policies = PrivateWikiPolicy, DefaultPermissionPolicy, LegacyAttachmentPolicy }}} == Configuration In `trac.ini` add a `privatewikis` section, under that add a private_wikis field and list the Pages that you want to protect. Enter the pages in all upper case and replace /'s with _: {{{#!ini [privatewikis] private_wikis = IT,FOOBAR,FOOBAR_INFO }}} Once you have added this you will have some new permissions in the admin section. For example you will have `PRIVATE_VIEW_FOO` and `PRIVATE_EDIT_FOO_BAR` which will control which users can view or edit !FooBar and anything below it like !FooBar/Test. The downside is that this plugin sees Foo'''B'''ar and Foo'''b'''ar as the same page, so any restrictions on one will restrict the access of the other. == Recent Changes [[ChangeLog(privatewikiplugin, 3)]] == Author/Contributors '''Author:''' [wiki:eric256] [[BR]] '''Maintainer:''' [[Maintainer]] [[BR]] '''Contributors:'''