Register_XH facilitates to restrict access to certain CMSimple pages to registered users. Therefore it has a simple user and group management as well as a login form, with the optional possibility for visitors to register per email. It is used by some other plugins to add user management (e.g. Chat_XH and Forum_XH).
Please do read this documentation before you encounter any problems!
Register_XH is a plugin for CMSimple_XH. It requires a UTF-8 encoded version.
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select "Register" from "Plugins".
You can change the default settings of Register_XH in "Plugin Config". Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done in "Plugin Language". You can translate the character strings to your own language, or customize them according to your needs.
The look of Register_XH can be customized in "Plugin Stylesheet".
The first thing you should do is to adjust the user groups according to your needs. You can do this in "Register" → "Group administration". If you like you can register users in "Register" → "User administration". Both dialogs should be pretty much self explaining. The status field is "activated" for users having the full priviledges according to their groups, "locked" for users who may not change their preferences. For users who have registered, but no yet activated their account, it contains a code. Don't change that, as the user won't be able to activate the account later.
Note that the group and user CSV files could be accessed directly by calling their URL. An .htaccess file to prohibit this for Apache servers is already contained in the default data folder. For other servers or for custom data folders you have to take care for yourself, that those data are protected from non authorized access.
Please note also, that the possibility to switch to admin mode after being logged in as registered admin has been removed. The call to registeradminmodelink() is now deprecated and doesn't return the link anymore. IMO plugins should not offer any backdoor to circumvent the core's login security.
To offer the user the possibility to log in and optionally register first, the login form must be displayed. You can put it in the template, so it's shown on all pages:
<?php echo registerloginform(); ?>
Alternatively you can put it on one or several CMSimple pages:
{{{PLUGIN:registerloginform();}}}
If the user forgot his password, he can request an email with the login credentials. If registration of new users is allowed, they can register themselves, and an email with the activation link will be sent to them, so they can activate their account and log in nearly immediately. All this happens without requiring any actions from the admin, but he receives copies of the emails to be informed.
After successfull login the user can edit his user preferences, i.e. name, email address and password. Unregistering, i.e. deleting the account, is also possible in the preferences dialog.
Note that all login and logout attempts will be logged in the logfile/logfile.txt.
To restrict the access to a CMSimple page to certain user groups, you have to enter on that page:
{{{PLUGIN:access('LIST-OF-GROUPS');}}}
LIST-OF-GROUPS is the comma separated list of access groups that will have access to the page. For example:
{{{PLUGIN:access('admin,member,guest');}}}
{{{PLUGIN:access('admin');}}}
Depending on the PHP ini settings max_input_vars, suhosin.post.max_vars and suhosin.request.max_vars there is a limit on the maximum number of users that can be administrated in the plugin back-end. In a default configuration of PHP >= 5.3.9 at most 142 users are allowed. The plugin checks this limit, and does not permit more users to be added. If this limit is exceeded, you have to administrate the users in users.csv manually.
Register_XH is licensed as freeware.
© 2007 Carsten Heinelt
© 2010-2012 Gert Ebersbach
© 2012-2013 Christoph M. Becker
Slovak translation © 2012 Dr. Martin Sereday
Czech translation © 2012-2013 Josef Němec
Danish translation © 2012 Jens Maegard
Russian translation © 2012 Lubomyr Kydray
Register was developed in 2007 by Carsten Heinelt. In 2010 he gave permission to Gert Ebersbach to adapt it to CMSimple_XH and to further improve it. The plugin was then distributed as Register_mod_XH. In 2012 Gert Ebersbach discontinued the developement, and gave me the permission to maintain and distribute the plugin. Many thanks to Carsten Heinelt and Gert Ebersbach for their good work and the permission to further maintain the plugin!
The code for creating the captcha image is based on code from Geniz' Guestbook. The code from Michael Svarrer's Memberpages plugin has been used as example for the Register plugin.
The plugin icon is designed by Wendell Fernandes. Many thanks for publishing this icon as freeware.
This plugin uses free applications icons from Aha-Soft. Many thanks for making these icons freely available.
And last but not least many thanks to Peter Harteg, the "father" of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.