Iars Calendar Plugin
About plugin XML layout description Homescreens with this plugin Send comment
Iars Calendar Plugin
To install this file you must download file following link above. This file must be started directly on your smartphone using file manager or Start menu
Download last version of plugin
Sample homescreen layout

This plugin must be added to your XML layout like followed:

<plugin clsid="{BB9D5D16-2C08-4a55-A90F-250CE324C9CC}" height="??" [start="??"]>
....
</plugin>
clsid must be the same as above, but you can change height to necessary value. Parameter start is optional. All formatting tags must be within this plugin tag.

Parameter "start" with value "usecalendar" will start standard calendar. Other values of start will call this application instead calendar. Omitted "start" parameter means, that pressing action button will just move plugin to current month and will not call any external applications.

Plugin code was wrote without any hacks or undocumented features so it must works on Smartphone 2003 and above, but it was created for Smartphone2002.

This plugin view consists of three parts:
1. Month name block
2. Year number block
3. Month days cell block
Month and year blocks are optional. And you can provide wname tag to set name of week days.

Month may have from 4 to 6 weeks, so month days cell block items (except weekdays title) are changing its height automatically according plugin height.

wname is an optional tag for the plugin XML. It provides weekday names for title section of month days cell block. These names must be in tag body:

<wname>mo tu we th fr sa su</wname>
Days must be separated using space. Each dayname length may be from one to three letters. You may provide it in any language, but you don't forget use unicode for it.

View of each part of any block is governed by value of <format> tag. This tag syntax is:

<format
state="normal|selected"
font-size=""
font-weight="normal|bold|"
fgcolor="transparent|#"
bgcolor="transparent|#"
valign="bottom|middle|top"
align="center|left|right"
/>

state: If value is selected, then settings are applied to element when plugin is selected. Otherwize this settings are for non-selected state.
fgcolor is a color of the text. #RRGGBB is standard html-form for RGB color. Canonical names for colors are not supported (COLOR_TEXT etc). Example: #RRGGBB for red is #ff0000.
bgcolor is color for the background of the block.
font-size and font-weight set text style parameters.
valign and align set position of text within block.
All parameters are optional.
Default values are: transparent for both colors, font-size: system-default, font-weight: system-default, valign: middle, align: center, state: normal

Month name block is described by month tag and format tag(s) within.

<month x="?" y="?">
<format>
</month>
x and y parameters is position of month info on plugin, relative to topleft corner of plugin. bgcolor, valign and align parameters (format tag) are ignored for this block.

Year name block is year tag with format tag(s) within.

<year x="?" y="?">
<format>
</year>
x and y parameters is position of month info on plugin, relative to topleft corner of plugin. bgcolor, valign and align parameters (format tag) are ignored for this block.

Month days cell will look according to layout tag. This tag is more complex than month or year. It has child elements: default, workday, weekend, today, grid and title. That is structure of tag looks like:

<layout x="?" y="?" hSpaceP="?" vSpaceP="?">
<default>
  <format/>
</default>
<workday>
  <format/>
</workday>
<weekend>
  <format/>
</weekend>
<saturday>
  <format/>
</saturday>
<sunday>
  <format/>
</sunday>
<today>
  <format/>
</today>
<grid type="?" color="?" />
<title height="?">
  <format/>
</title>
</layout>
layout parameters x and y has same meaning as in year or month. hSpaceP and vSpaceP set space in cell that is free from text, these values are percentage of free space.

There are three types of days for month: workday (monday till friday), weekend (saturday and sunday) and today (will be presented only for current month). Workday, weekend and today tags describe view for each of these three types of month days. default tag contains default values for any type of day and style of specific day-type is a combination of values from default tag and from specific tag. Value was set in default tag and later is changed in specific tag will have value from specific tag. format tag is standard format tag described above.

You can provide saturday and saturday tags to format according weekdays independently. That is when you use weekend tag you provide formatting tags for both saturday and sunday in single tag. Format of these tags similar to weekend tag.

Font-height value will be ignored for daytype tags, because this value and height of cell is set according to count of weeks for month. This count may vary from 4 to 6 and cells will be automatically sized to fit in plugin.

title tag contains settings for weekday names. If you add this tag to layout, then weekday names will be on a top of a month cell. Height of this area is value of height parameter while the style is one according to format tag(s). Default values for title tag are also inherited from default tag. font-height value doesn't ignored for this tag.

grid describes style of lines around each cell. type parameter may have horizontal or vertical value. This parameter shows which type of line should be painted. color sets a color (#RRGGBB) for this line. You can provide from zero to two grid (both horizontal and vertical) tags. If you will not provide grid tags then no lines will be painted.

Sample layout would be like followed:

<plugin clsid="{BB9D5D16-2C08-4a55-A90F-250CE324C9CC}" name="calendarplugin" height="83">
<wname>mo tu we th fr sa su</wname>
<month x="3" y="0">
<format font-size="15" font-weight="bold" fgcolor="#ffffff"/>
</month>
<year x="3" y="16">
<format font-size="13" font-weight="bold" fgcolor="#ffffff"/>
</year>
<layout x="40" y="0" hSpaceP="10" vSpaceP="1">
<default>
<format font-weight="bold" fgcolor="#CAE2E3" align="center" valign="middle" /> <format state="selected" font-weight="bold" fgcolor="#001906" align="center" valign="middle" bgcolor="#CAE2E3"/> </default>
<workday>
</workday>
<weekend>
<format fgcolor="#D72B1E"/>
<format state="selected" fgcolor="#9C170D" />
</weekend>
<today>
<format fgcolor="#14453E" bgcolor="#CAE2E3" />
<format state="selected" fgcolor="#ffffff" bgcolor="#14453E" />
</today>
<!-- grid type="horizontal" color="#000105" / -->
<!-- grid type="vertical" color="#000105" / -->
<title height="11">
<format font-size="10" fgcolor="#ffffff"/>
</title>
</layout>
</plugin>