How to make a PmWiki page private

Each group of pages has a set of attributes associated with it. One of these attributes is the "read" password, which if not set (default) means the page can be read by anyone. By setting the "read" password to id:*, you can prevent users who have not authenticated from accessing the group and any subpages.

Making a page private (or world-readable) can now be done by simply checking or unchecking the "Make page private" checkbox at the bottom of the editor page, as shown below:

Important Note: Setting a "read" password only protects the pages from Web access. Anyone who can log in to an ENGR machine can potentially directly read the files, without providing a password. You have been warned.

How to make a group and all subpages private

To make a group and all subpages private, you will need to change the group attributes. Open the URL:

Note that you need to replace GroupName with the name of the group you are trying to modify. For instance, if you wanted all pages like 'PrivateStuff/ClubhousePasswords' to be protected, you would want to replace the GroupName with PrivateStuff.

You should be presented with four textfields. Enter 'id:*' into the box labeled 'Set new read password:' and hit Save.

Your pages should now be protected. Test it by logging out and trying to access them — you should be required to log in before viewing them. The string 'id:*' is interpreted to mean any authenticated user.

To make a group and all subpages world readable

If you later decide to make the pages world-readable (caution!), repeat the above procedure, but substitute 'clear' for the "read" password. Once you save the changes, the group and all subpages should be world-readable.

To make an individual page private

Simply open the page you wish to protect. Append the string '?action=attr' to the URL. Change the "read" password to 'id:*'.

See the PmWiki documentation about Passwords for more details.