4.7.7 Public portal page for anonymous accessOther languages

4.7.7 Public portal page for anonymous access

Note that the feature described in this section must have been enabled by the BSCW system administrator by setting INDEX-PAGE-EXT='index*.html' in the BSCW configuration file.

BSCW folders with public access (anonymous user is a member of the folder's member group) may be equipped with an additional portal page for anonymous access. This file must be named index.html (but see also section "Other languages" below).

The mechanism of index.html in a BSCW folder is similar to the presence of an index.html file in a Web site's directory.

The purpose of this feature is that the members of the folder may use the "normal" BSCW interface to work on a folder, change its sub-folders and documents etc., whereas the anonymous user is presented with a different HTML page -- namely the content of index.html -- which serves as a portal to the folder or to parts of it. The actual folder and its contents is then hidden to the anonymous user. The anonymous user may not even be aware that he accesses a BSCW server.

A possible application for these portal pages could be that you organize a conference for which authors should anonymously upload their contributions into a BSCW workspace (see step 4. below for some details).

Here is how you create portal pages in BSCW:

Edit index.html to your needs. Relative links inside index.html may refer to objects in your folder. Optionally, you may include BSCW operations (e.g., "Add Document", see next step) in index.html so that the anonymous user may directly invoke them within the portal.
Upload the file index.html into your folder.
Invite user "anonymous" to become a member of your folder. Please note that "anonymous" is a special user as he has restricted access rights by default (read-only).
Optional: Use the portal page for anonymous upload.
As an example where anonymous upload is useful, imagine that you want to use index.html (or another HTML page in the respective folder) to allow authors of a conference to submit their papers and store them -- invisible for the authors -- in a BSCW folder. The file index.html would then consist of the conference home page, it may include links to graphics, documents etc., all stored and managed in your BSCW folder by your workspace members, the members of the organising committee. To let anonymous users upload contributions to the conference you might include a link like this:
http://<bscw-server>/bscw/bscw.cgi/0/folder-id?op=addoc
You may also modify the BSCW upload form to better suit your needs. Copy the BSCW upload form (you may need to ask your BSCW system administrator for its precise location)
<bscw_dir>/BSCW4/messages/english/upload.html
from your BSCW server and modify it to your liking; please make sure that you do not remove or change the HTML FORM relevant variables.
The following is an example what the HTML code for such a page may look like:
```
<x!-- Example for a modified upload form
					xyz_upload.html -->
<x!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
<HTML><HEAD><TITLE>Upload document</TITLE></HEAD> <H1>Upload
your contribution to XYZ workshop</EM></H1>

<FORM ENCTYPE="multipart/form-data"
	 ACTION=".?op=_addoc"
	 METHOD=POST>
<INPUT TYPE="hidden" NAME="op" VALUE="addoc">

Choose your local dokument:<BR>
<INPUT NAME="files" TYPE="file" SIZE=60 ACCEPT="*/*">
<P>
<INPUT TYPE="submit" VALUE="Upload your document">
</FORM>

</BODY></HTML>
```
Place xyz_upload.html into your BSCW folder so that you can put a relative link to it into english.html:
<A HREF="./xyz_upload.html"> Upload document here </A>
Note that "anonymous" must have access rights to add documents to this folder (cf. section 4.7.6.1).
Anonymous users may now access your folder using the public addressing scheme in BSCW:
http://your-bscw-server/pub/bscw.cgi/0/folder-id

Using the URL http://your-bscw-server/bscw/bscw.cgi/0/folder-id will present the BSCW folder for non-anonymous users in its full functionality.

Other languages

Please note that all other available languages may also be used, e.g. if you also provide a file index-de.html in this directory with a German translation of the file index.html, anonymous users who have selected the German language interface for their browser will see the German version of the portal page.