Getting Started with ZK Calendar

From Documentation


DocumentationZK Calendar EssentialsGetting Started with ZK Calendar
Getting Started with ZK Calendar




Here we introduce the required setup for a web application to use ZK Calendar.


Setup by Maven

We recommend managing your project with Maven. First, you check the available version in ZK Maven CE repository[1]. Then, you can adopt ZK Calendar easily by simply adding a dependency like the following example. [2]


<dependency>
	<groupId>org.zkoss.calendar</groupId>
	<artifactId>calendar</artifactId>
	<version>${calendar.version}</version>
</dependency>



  1. ZK Calendar is GPL/Commercial dual licensed.
  2. If you didn't setup zk maven repository yet, you have to setup zk maven repository too.

Manually Installing the ZK Calendar JAR

  1. Downloaded ZK CE 7.0.3 or above
  2. Downloaded ZK Calendar Binary
  3. Extract those 2 zip files, include all JAR files by putting them into your project's /WEB-INF/lib

Depending on your IDE the steps will differ, however, the most important part is both ZK Calendar and ZK’s JAR files are included in your project's classpath. The easiest way to create a compatible project is to use ZK Studio and then include calendar.jar as a library.

A Very Basic Application

After setup, we can create an index.zul with the content below to verify the setup works or not.

<zk>
    <calendars/>
</zk>


This gives you the very first ZK Calendar application. When a server starts, navigate to index.zul and the following page should be displayed.

ZKCalEss Simple calendar application.png


Congratulations! That is all it takes to embed ZK Calendar within your ZK application.

Demo Project

You can also start up with the example project, zkcalendardemo, from github.


The example project is at Github


Last Update : 2021/01/18

Copyright © Potix Corporation. This article is licensed under GNU Free Documentation License.