Welcome to Memberpages_XH 3.3

for CMSimple_XH 1.5 and php 5

Started by svarrer.dk (v. 0.1-1.7), maintained by ge-webdesign.de (v. 2.0-2.3),
and further evolved to version 3.0 and 3.1 by Svasti (3.1 with some hints from cmb to improve security, and 3.2 with code from cmb to show who is logged in.).

Memberpages_XH has two uses:

It provides a log-in field, where users (=members) can enter a user name and a password. After log-in the user is shown which other users are logged in. The log-in can be used to regulate access to other plugins, e.g. Forum_XH.
Memberpages can also hide pages and make them visible only to users who are logged-in.

For every user Memberpages can store user name, password, access level, e-mail adress and full name. Members can change their password, e-mail addres and full name after log-in. Pages can be given different accesslevels.

Memberpages keeps a detailed log file of all log-in actions.

Username and password accept accented letters, but no ', ", comma or spaces. Full name accepts additionally space and the apostroph.

3.3: Bugfix and version information

3.2:

On log-in the names of other logged-in members can be shown, either as full names or as usernames.
Admin e-mail adress in plugin config for password requests when no member's e-mail is available.

3.1:

Converting pages into memberpages now via pagedata tabs
Old method also possible. Method can be selected.
Memberpages have a colored "M" as pagedata tab, other pages have an normal "M"
If access level has been set, the level number will be added to the colored "M"-tab
Lots a small improvements
Slovak translation by Tata.

3.0:

simplified plugin configuration
comprehensive editable logfile
members can change password and email address
members can have forgotten password sent by email
easy uploading and downloading of members list
different choices of access management
Czech translation by oldnema.

Main changes compared to version 2.3:

New: membersnotice(), member()
Gone: memberswarning(), memberpages()
Changed: accesslevels can have only one value, members list can only have one source, either a standard php-file or a csv-file, and csv-file separator is always a comma.

Updating

From version 3.2 to 3.3

Exchange: index.php, admin.php, languages/default.php ... plus your language file

From version 3.0 or 3.1 to 3.2

Install the new version on top of the old version EXCEPT for folders
memberpages/data,
memberpages/config,
memberpages/logfile.
Leave these folders as they are.

Log in to your site.
Go to memberpages plugin config and click "Save Settings".
Go to members list an click "Save settings"

This will initialize the new variables.

IF you are updating from 3.0 be sure to check in config use #CMSimple member();#, otherwise your old memberpages will be accessable to everybody. You can change this setting afterwards:
Check use pagedata tab "M" and set all your memberpages via pagedata tab.
Then delete all #CMSimple member();# in your text. Uncheck "use #CMSimple member();#".

From older versions

First check where and under what name your members list is stored. Install new version on top of old version except for data, config an logfile folders. Log in to your site and go to memberpages plugin config, set "use pagedata tab M" and click "Save Settings" and go to file details via the link below the config settings. Make sure the correct file type for your members file is set. If there is the notice "Your members list is stored as csv file under:" click "Instead of csv file use php file for members list" and vici versa. Once you have set the correct file type, enter address and name of your old members file, starting from the cmsimple base.

Save an go to members list an click "Save settings".

Remove all memberpage-CMSimple-scripting from your text and set memberpages instead via pagedata tabs. Uncheck "use #CMSimple member()" in plugin config.

Setting up Memberpages

Unzip the zip file and upload the folder "memberpages" into the plugin-folder of your CMSimple installation. Then add an login-form either to your template or to some page of your site.

Login-form in the template:

Open the template file and put this php-code where the login form should be located: <?php echo memberslogin();?>

Login-form on a page:

Add this code to your page: #CMSimple $output.=memberslogin();# or this: {{{PLUGIN:memberslogin();}}}

If you have the login form on a normal page, you should add a logged-in-notice to your template so that members see that they are logged in. Otherwise there is no way to know if one is logged in or not. The logged in notice is only visible if you are logged in.

To add the logged-in-notice to your template open the template file and add the following php-code where the logged-in-notice should be located: <?php echo membersnotice();?>

How it looks like

… memberslogin(); … will produce a login-area like this:

After login members will see a changed login-area like this:

Memberpages_XH and Forum_XH

If you don't use Memberpages to hide pages, uncheck both methods to hide pages. If you use Forum_XH 1beta1 and want to display the full name of users, change line 170 in plugins/forum/index.php from return isset($_SESSION['Name']) ? $_SESSION['Name'] : (
to
return isset($_SESSION['fullname']) ? $_SESSION['fullname'] : (

Converting normal pages to Memberpages

Set method to make memberpages in config. Uncheck unused method for better speed of your site.

Via pagedata tabs:

Set pages as memberpages via the pagedata tab "M" above the editor menu. There you can also set the access level, except when your access mode is "members see all memberpages". The data you enter will be stored in the pagadata.php. Unchecking the pagedata tab method in plugin config will clean the pagadata.php of all memberpage entries.
Via inserting #CMSimple member();# in the text

Put the code #CMSimple member();# or {{{PLUGIN:member();}}} anywhere in a page that you want to convert to a memberpage. To add an accesslevel put the number of the level between the parentheses, e.g. #CMSimple member(3);# or {{{PLUGIN:member(3);}}} for level 3.

Note: If the call member(); is still in the text of a page, while this method has been unchecked, selection of that page will produce a fatal php error and you will get an empty screen! Although the plugin tries to prevent this, it could still happen while working in a subsite or second language. In this case go back in your browser, select edit mode and delete #CMSimple member();# in the text.

Choosing the access mode

Memberpages without access-level (= level 0) are visible to all members. Concerning pages with access level you can choose between the following modes:

If you don't use access level, choose "members see all memberpages". The access level will not be shown in the member's list.
"access to pages with SAME OR LOWER access value" gives e.g. a member with access level 3 access to pages with access level 0, 1, 2, and 3
"access to pages with SAME or no access value" gives e.g. a member with access level 3 access to pages with access level 0 and 3.
This mode is useful when you have to give different persons exclusive access to different pages. Set the number of selectable access levels in the next field. You can even have 100 access levels for 100 exclusive pages.
"access set per member in DETAIL for 3, 4 or 5 page levels" offers detailed access management. You can set the access allowance per member individually to single or multiple page access levels. (Internally the same access number is used as in the other options, only now its binary value is used and every bit allows access to a higher page access level. E.g. a member, who had formerly access level 3 will have his number translated into 00011. The binary number determines access to page levels 5,4,3,2,1, i.e. he will have access to pages with access level 1 and 2, and of course to 0.)

Automatic login

You can set automatic login for members. If set, the plugin saves a cookie on the users computer after the user logs in. However, if the user logs off, the cookie will be deleted, and the user has to log in again the next time. Automatic login works only, if the user doesn't log off.

Password forgotten?

This can be displayed under the Login button. A click will ask for the members user name. IF the user name and an email address is found in the members list, the forgotten password will be send to that email address.

For sending an email the plugin needs a valid sender's address. The sender's address has to be entered in plugin config under Site e-mail address. Without sender's address "Password forgotten?" will not be displayed.

An admin e-mail address can be enteren in plugin config for password requests or users, of whom no e-mail address is found, Without this admin address thoses request will be sent to the site e-mail.

Saving members list in a csv file

As started in previous versions this version still allows two ways to store the members list. Contrary to prior versions now only one method can be used at a time:

via a php-file
via a csv-file (csv = comma separated values)

Advantage of csv usage is that a link to user control panel appears once a member is logged in. In the user control panel he can change his password and email address. Disadvantage is that csv-files need special protection (see below).

Advantage of php usage is that no special file protection is needed.

You can start using the php-file method and later decide to use a csv-file. The php-data can be imported into the csv-file via the uploading menu. (Go from plugin config to file details. There click on upload, without having selected a file. The plugin will lead you to a menu where you can import the php-file data

Choosing the csv-method gives you the possibility of easy download and upload of the csv file. The csv file can be edited in spread sheet programs like Microsoft Excel. The csv file structure consists of simple comma separated values, i.e. per line: user,password,accesslevel,emailadress,fullname

Changing the location where the members file is saved

The members file can be stored in any location on your server. Go to the bottom of plugin config where you find a small link -> file details. This link leads to a page where you can

set the location of the memberfile (you can even change the name of the file, but be sure to not change the file ending)
change from csv file to php file
download and upload a csv members file
restore a backup of a csv members file
move members data from a php file to a csv file

If you use the csv file, be sure you have a protection. The default location of the csv-file (./plugins/memberpages/data/) is protected by .htaccess. Without protection the csv-file can be read by anybody on the internet. If you want to store the member.csv, e.g. under userfiles/memberpages/data/, copy also the .htaccess file to that location.

If you use the php file method to store your members list, no additional protection is required.