admin.pl -- ClioPatria administrative interface

This module provides HTTP services to perform administrative actions.

To be done

- Ideally, this module should be split into an api-part, a component-part and the actual pages. This also implies that the current `action'-operations must (optionally) return machine-friendly results.

 list_users(+Request)[private]

HTTP Handler listing registered users.

 user_table(+Options)//[private]

HTML component generating a table of registered users.

 create_admin(+Request)[private]

Create the administrator login.

 add_user_form(+Request)[private]

Form to register a user.

 add_user(+Request)[private]

API to register a new user. The current user must have administrative rights or the user-database must be empty.

 self_register(Request)[private]

Self-register and login a new user if cliopatria:enable_self_register is set to true. Users are registered with full read and limited (annotate-only) write access.

Returns a HTTP 403 forbidden error if:

• cliopatria:enable_self_register is set to false
• the user already exists

 edit_user_form(+Request)[private]

Form to edit user properties

 edit_user_form(+User)//[private]

HTML component to edit the properties of User.

 edit_user(Request)[private]

Handle reply from edit user form.

 del_user(+Request)[private]

Delete a user

 change_password_form(+Request)[private]

Allow user to change the password

 change_password_form(+UserID)//

HTML component that shows a form for changing the password for UserID.

 change_password(+Request)[private]

HTTP handler to change the password. The user must be logged on.

 login_form(+Request)[private]

HTTP handler that presents a form to login.

 user_login(+Request)[private]

Handle user and password. If there is a parameter return_to or openid.return_to, reply using a redirect to the given URL. Otherwise display a welcome page.

 user_logout(+Request)[private]

Logout the current user

 attribute_decl(+Param, -DeclObtions) is semidet[private]

Provide reusable parameter declarations for calls to http_parameters/3.

 add_openid_server_form(+Request)[private]

Return an HTML page to add a new OpenID server.

 new_openid_form// is det[private]

Present form to add a new OpenID provider.

 add_openid_server(+Request)[private]

Allow access from an OpenID server

 edit_openid_server_form(+Request)[private]

Form to edit user properties

 openid_server_table(+Options)//[private]

List registered openid servers

 edit_openid_server(Request)[private]

Handle reply from OpenID server form.

 del_openid_server(+Request)[private]

Delete an OpenID Server

 settings(+Request)[private]

Show current settings. If user has administrative rights, allow editing the settings.

 save_settings(+Request)[private]

Save modified settings.

 hidden(+Name, +Value)[private]

Create a hidden input field with given name and value