Welcome > SMCal > Setup
CMSimple-Plugins by QualiFIRE


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:

| +-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:


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:

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

55.675706 55.675706

52.518333 13.408333

53.076944 8.808889

51.225556 6.782778


50.113611 8.679722

53.568611 10.038611

52.374444 9.738611

50.9425 6.958889

51.333333 12.383333

48.139722 11.574444

48.776667 9.1775

44.838611 -0.578333

48.390833 -4.485556

45.759722 4.842222

43.2975 5.377222

43.702778 7.269167


47.504881 9.749247

48.303056 14.290556

48.208333 16.373056

46.951081 7.438637

46.200013 6.149985

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

powered by cmsimple.dk - template by Jens Bröcher Webdesign