Setup

1. Where do I get the Calendar?

The sun & moon calendar plugin SMCal is available at my website as download. The actual version is 0.1 beta. The sun & moon calendar will be continously enhanced. It is an advantage to take a look what's new time by time.

2. What must be done before you install?

  1. First you have to install CMSimple. If you don't have it, please download this from www.cmsimple.com or from www.cmsimple.org.

  2. As next step you have to install the Plugin-Loader from Michael Svarrer or from CMSimple. Without one of the two loader the Guestbook plugin definitely not work.
    You can download the Michael Svarrer's Plugin-Loader from cmsimple.de/cmsimple/index.php?Plugins_%26amp%3B_Downloads. A description how install the Plugin-Loader is included inside of the zipfile.
    Alternatively you can use and download CMSimple 3.0 Plugin-Loader from www.cmsimple.org/?Downloads:Old_versions. Download version 3.0 (and only this version) and unzip the file index.php from folder plugins into the folder plugins.

3. How to install the Calendar?

Download the zip-file from Download and unzip it into the folder .cmsimpleplugins. Take care to check the "use folder names" option while unzipping. After unzip you should have the following structure:

 +-plugins
| +-smcal
| +-config
| +-css
| +-help
| +-images
| +-languages


After this you can start CMSimple and login into the Admin area. Now you should see the Plugin in the list of all plugins. If you don't see it, something is wrong (check the folder structure).

4. How to use the Calendar?

4.1 Installation and Build in to your Website

First you should create a own main page with <H1>, or subpages with <H2> or <H3>, as a container for the calendar. Plug the calendar in your CMSimple-page by adding the line

#CMSimple $output.= smc_table();#

into your text, directely following to the heading. You can copy the text line directly from the description here. But please take care to control the HTML-code directly and delete, if necessary, the FONT tags. Will you see something like

#<FONT size=2>CMSimple $output.= smc_table();#</FONT>
you should delete all FONT tags, because they are causing errors.

4.2 Combination with Calendar Plugin

When you already have installed the calender-Plugin from Michael Svarrer , the SMCal plugins uses automatically the choosen month and year and creates the sun & moon calendar depending on this dates.

You can install the calendar plugin by yourself or use CMSimple+ which contains the plugin already.

For supporting the "next month" and "previous month" option, you have to switch the option prev_next_button = True of the calendar plugin. (And of course you have to include the month overview int your template).

5. Can I use multiple Languages?

SMCal supports the use of multiple languages. There are no specific commands necessary. Gbook detects automatically which language is currently used and choose the dependent language file.

At the moment the plugin SMCal comes with the following languages:

 English
 French
 German

If your language is not listed above, you can create your language as well. Just copy an exiting language file (e.g. en.php), rename this file according to the used language and translate the texts inside.

At this point I like to say "Thank you very much" to all the people, which have sent their translations to me!

Please feel free to send new languages files to me. I will include them in the very next setup, the author will be mentioned!

6. Configuration

The plugin SMCal can be configured individually by several setting.

The following settings are available:

location latitude:
location longitude:
location name:
sun zenith:
date format:
show creator:
debug:

location latitude: This value specifies the latitude of the city/place you want to use for calculating the sun & moon calendar. In the following table you will find some example values.

location longitude: This value specifies the longitude of the city/place you want to use for calculating.

location name: This value will be used fot displaying the name of the city as a header.

Example values (source: www.wikipedia.de):

Country Location Name Location Latitude Location Longitude
Danmark

Kopenhagen
55.675706 55.675706
Germany

Berlin
52.518333 13.408333

Bremen
53.076944 8.808889

Düsseldorf
51.225556 6.782778

Erding
48.3061
11.9064

Frankfurt/Main
50.113611 8.679722

Hamburg
53.568611 10.038611

Hannover
52.374444 9.738611

Köln
50.9425 6.958889

Leipzig
51.333333 12.383333

München/Munich
48.139722 11.574444

Stuttgart
48.776667 9.1775
France

Bordeaux
44.838611 -0.578333

Brest
48.390833 -4.485556

Lyon
45.759722 4.842222

Marseille
43.2975 5.377222

Nizza
43.702778 7.269167

Paris
48.862222
2.350833
Austria

Bregenz
47.504881 9.749247

Linz
48.303056 14.290556

Wien
48.208333 16.373056
Switzerland

Bern
46.951081 7.438637

Genf
46.200013 6.149985

Zürich
47.378886 8.540007

sun zenith: This value defines the angle for the zenith. Usually a value of 90.5 is used. You can use other values too for calculating the sun set.
The civil sun set is defined as 6 degrees under the hoizon, which means you have to define a value of 96.0 for the zenith.
The nautical sun rise is defined by 12 degrees under the horizon. In this case you have to definie for sun zenith a value of 102.
The astronomical sun set is defined by 18 degrees. To calulated the values for this case, you have to specify a value of 108.

date format: Use this field for defining how the date of the message should be displayed on the screen. The values of the field are the same as the date() function of PHP allows.

show creator: At the bottom of the guestbook will be a link to the author shown. If this text should not be shown this field must be set to False. Switching off this display is only possible after contacting the author. Possible values for this field are True or False.

debug: This option switches on the debug mode, which display internal information, which can be helpful when you have trouble with the plugin. Possible values are True or False.

7. Adapting the Layout

The layout, eg. the used colors and fonts of the sun & moon calendar SMCal, will be basically defined by the settings stored in the file stylesheet.css in the folder css. In this file all colors, fonts and font sizes for the calendar are defined there. There are two different color definitions already predefined: Blue and green. These definitions can be used easily just by renaming the files, eg. rename the file stylesheet.green.css into stylesheet.css to use the green color definition.

The stylesheet file can be modified of course. The entries have the following meaning:
Class Description
.smcTableHeader Formatting of header over table
.smcTable Formatting of table
.smcMonthcell Formatting of the table cell which contains the month name
.smcWeekend Formatting of table rows of weekend days
.smcWeekday Formatting of table rows of week days