External requirements: This plugin requires the following additional components that must be installed separately:

• phpCAS library
• or from github

PHP needs to be configured with curl and xml support for phpCAS to work see phpCAS requirements

Search and install the plugin using the Extension Manager. Refer to Plugins on how to install plugins manually.

You have to download the phpCAS library and place it in the folder of the plugin so that the file lib/plugins/authplaincas/phpCAS/CAS.php exists.

To really use this authentication plugin some customization is necessary next to the settings available in the plugin settings interface.

You should copy the file plaincas.settings.php to your conf folder and do the modifications there. (alternatively you can move it wherever you want and specify the path in the conf/local.protected.php file (create when not existing) with $conf['plugin']['authplaincas']['settings_file'])

The four functions in plaincas.settings.php are slightly documented.

In general the procedure is as follows:

1. The CAS attributes are fetched through the phpCAS library
2. The CAS attributes are passed to the functions in the plaincas.settings.php file
3. The mail and name are returned based on the attributes in plaincas_user_attributes
4. The attributes for the groups are assembled and returned in plaincas_pattern_attributes
5. All elements of the array returned in plaincas_pattern_attributes are checked against the regular expressions returned from plaincas_group_patterns
6. The keys of the expressions which match will be assigned as groups of the user.

Maybe you don't want everybody from the CAS server to log in on your dokuwiki?

No problem! specify a comma separated list of groups of which at least one has to be assigned in order for the user to be saved.

You want to assign groups to certain usernames rather than the CAS attributes?

No problem! in the plaincas.settings.php file you can return an array with the function plaincas_custom_groups with the groups as keys and an array with the usernames as values.

In the future the plugin could also support the local users list that authplain uses.

Make sure the newest version of the plugin is installed. If using the plugin manager make sure the current version is installed. If you continue to have problems put this in conf/local.php $conf['plugin']['authplaincas']['debug'] = TRUE;

[discussions should ideally be deleted and turned into FAQ entries along the way]

Could be placed on an external page (e.g. plugin:pluginname:discussion) to have a distinction between user comments and author docs