Manual

Contents

• Display
  • Integration of GuestCal into your site
  • Templates
  • Multiple Languages
• Installation
  • Password for the administration area
• Bug fixing
  • The colours of the calendar are not displayed correctly
  • My provider only supports PHP5, if the files end on .php5

Display

Integration of GuestCal into your site

There are two ways to integrate CuestCal into your site:
You can either customise the template to fit the layout of your site, or you can embed GustCal with <iframe>:

<iframe src="http://demo.guestcal.com/?lang=en" name="GuestCal" width="700" height="450" frameborder="0" scrolling="no"></iframe>

Using GET-parameters, you can specify the language, object or date in GuestCal (if you already have a language selection in your website):

Variable	Description
lang	Language abbreviation; de for German, en for English
object	ID of the object in display. You can find these in the admin area of “Objects”. If you select 0, all objects will be displayed in a list.
year	Year in display

The following example selects object 1 for the year 2010 in english:

http://www.guestcal.de/demo/?lang=en&object=1&year=2010

Templates

In the main directory of GuestCal and in the directory admin/ you can find the folder templates/. There you can create multiple folders with templates. By default, the template default/ will be used.

Every template consists of the html files head.php, foot.php and the CSS file main.css. You may customise these however you like to change GuestCals design.

Multiple Languages

GuestCal 2.0 supports multiple languages. German and English are pre-installed. To install further languages, please follow these instructions:

1. Copy the content of one of the existing language files into a new file in the directory “lang/”, e.g. “xyz.inc.php”. The “xyz”-part must not be longer than 3 characters.

2. Add a row in the table”languages”:
- “id” will be set automatically.
- “name” is the name of the language.
- “abbr” has to be the first part of the file name, in the example above “xyz”.

Installation

Password for the administration area

This version GuestCal does not have its own user administration. It is your own responsibility to secure the administration area. If you install GuestCal on an Apache Server, the easiest way to do this is with a .htaccess file. That will be enough to secure the directory “admin/” with a password. A manual how to do this can be found here: http://www.elated.com/articles/password-protecting-your-pages-with-htaccess/

In most cases your hosting provider will offer an easy way to secure certain directories.

Bug fixing

The colours of the calendar are not displayed correctly

Cause:
If the colors are not displayed correctly, it is likely that the automatically generated CSS file is not sent in the MIME type text/css. This happens if there is any data written before the HTTP-Header. A few characters are accidentally send if a file in UTF-8 is saved with BOM.

Solution:
When saving the file config.inc.php make sure to save it as UTF-8 without BOM. If your editor does not support this charset you can alternatively use ISO 8859-1 (= Latin-1).

My provider only supports PHP5 if the files end on .php5

Rename the files index.php, css.php, admin/index.phpsowieadmin/setup/index.php into *.php5 um. Afterward, change these rows found in templates/default/head.php or admin/templates/default/head.php

<link rel="stylesheet" href="css.php" charset="utf-8"> or alternatively
<link rel="stylesheet" href="' . BASEDIR . 'css.php" charset="utf-8">

into:

<link rel="stylesheet" href="css.php5" charset="utf-8"> bzw.
<link rel="stylesheet" href="' . BASEDIR . 'css.php5" charset="utf-8">