Wcal 2.7 documentation

Creating calendars

A new Calendar is created by adding the calendar definition in the wcal.conf file. For example, the sample wcal.conf file that comes with Wcal distribution contains the definition of three calendars:
  1. commercial
  2. production
  3. savignon
You can add parameters to the calendar definition (see Configuring Wcal). In the sample file, only long name is set for the three calendars. 
user=commercial
        long name = Commercial
end user

user=production
        long name = Production
end user

user=savignon
        long name = Joël Savignon
end user

Creating multiple views on the same calendar

Imagin you want to allow a user john to access to a calendar cal1 in read/write mode and allow another user jack to access to this calendar only in read only mode, you can write in the wcal.conf file: 
user=cal1
         long name = Calendar RW
end user

user=cal1ro
         read only = true
         data id = cal1
         long name = Calendar RO
end user
data id = cal1 means that the data of cal1ro is the data of cal1. The calendar cal1ro is the same as cal1 except that you can't modify events in it. This calendar will appear with a small Calendar RW icon.

Restricting access to calendars

Now that we have a read/write and a read only version of the calendar, we can change the .htaccess file in the calendars directories to restrict access to certain users.

The file /home/httpd/html/wcal/cal1/.htaccess can be for example: 

AuthType Basic 
AuthUserFile /usr/local/apache/conf/htpasswd.users 
AuthName "Calendar RW" 
Require john
And the file /home/httpd/html/wcal/cal1ro/.htaccess can be for example: 
AuthType Basic 
AuthUserFile /usr/local/apache/conf/htpasswd.users 
AuthName "Calendar RO" 
Require jack
Login/password will be prompt when accessing to the different calendars. For more information about Apache access restriction, see the Apache documentation on the Apache web site.

Important : don't create manually the .htaccess files in the web directories but use the access file resource in the wcal.conf file. .htaccess files will be generated from the value of this resource.

Creating groups of users

You can create groups of users for display purpose or to restrict access to a set of calendars. Groups will apear at the top of the main page with a small Group icon. If you click on this icon, you can access to the group main page.

Groups can contain users but also other groups (subgroups). So you can have a complete users tree and you can use the data id resource to create links between them.

Groups are defined with the group resource. This is an example of a users tree definition. 

group=group1

  long name = Group 1

  group=group11

    long name = Group 1.1

    user=us111
      long name = User 1.1.1
    end user

    user=us112
      long name = User 1.1.1
      data id = us22
    end user

  end group

  user=us11
    long name = User 1.1
  end user

  user=us12
    long name = User 1.2
  end user

end group

group=group2

  long name = Group 2

  user=us21
    long name = User 2.1
  end user

  user=us22
    long name = User 2.2
  end user

end group
You can restrict access to some groups by adding a access file resource in the group section.
Back to the Wcal main page