PHPackages                             benediktengel/google-calendar-plugin - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. benediktengel/google-calendar-plugin

ActiveKirby-plugin[API Development](/categories/api)

benediktengel/google-calendar-plugin
====================================

Plugin to get easy the content of your Google-calendar in your Kirby-Website

13113[6 issues](https://github.com/BenediktEngel/google-calendar-plugin/issues)PHP

Since Mar 28Pushed 7y ago1 watchersCompare

[ Source](https://github.com/BenediktEngel/google-calendar-plugin)[ Packagist](https://packagist.org/packages/benediktengel/google-calendar-plugin)[ RSS](/packages/benediktengel-google-calendar-plugin/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)DependenciesVersions (1)Used By (0)

google-calendar-plugin
======================

[](#google-calendar-plugin)

Plugin to get easy the content of your Google calendar as a list in your Kirby-Website.

**Requirements:** [Kirby CMS](https://getkirby.com) &gt;= v3.0.1

Installation
------------

[](#installation)

There are three ways to get the plugin:

### Download

[](#download)

Download and copy this repository to `/site/plugins/`. That's it. You're done.

### Git submodule

[](#git-submodule)

Go to the root of your Project, copy `git submodule add https://github.com/benediktengel/G´google-calendar-plugin.git site/plugins/google-calendar-plugin` in your command line and press enter. Done. The plugin appears in `site/plugins`.

### Composer

[](#composer)

Copy `composer require benediktengel/google-calendar-plugin` to your command line and press enter. Done. Also here, the plugin appears in `site/plugins`.

Setup
-----

[](#setup)

### 1. Set your API-Key and your calendarID in your `site/config/config.php`

[](#1-set-your-api-key-and-your-calendarid-in-your-siteconfigconfigphp)

```
'benediktengel.google-calendar-plugin.apikey' => 'YOUR-API-KEY',
'benediktengel.google-calendar-plugin.calendarID' => 'YOUR-CALENDAR-ID'
```

Need Help? [How to get them.](/howtogetkey.md)

### 2. Place the snippet in your template

[](#2-place-the-snippet-in-your-template)

Find the right place for the calendar and add ``

### 3. Be glad

[](#3-be-glad)

You did it.

Options
-------

[](#options)

- Set your API-Key: `benediktengel.google-calendar-plugin.apikey' => 'YOUR-API-KEY'`

    - required
- Set your calendarID: `'benediktengel.google-calendar-plugin.calendarID' => 'YOUR-CALENDAR-ID'`

    - required
- Change the date format: `'benediktengel.google-calendar-plugin.formatDate' => 'd.m.Y'`

    - default: `'d.m.Y'`
    - optional
- Change the time format: `'benediktengel.google-calendar-plugin.formatTime' => 'H:i'`

    - default: `'H:i'`
    - optional
- What attributes of the events do you want: `'benediktengel.google-calendar-plugin.attributes' => []`

    - default: `['title', 'dateStart','timeStart', 'dateEnd', 'timeEnd', 'description', 'location', 'url']`
    - possible:
        - `'title'`
        - `'dateStart'`
        - `'timeStart'`
        - `'dateEnd'`
        - `'timeEnd'`
        - `'description'`
        - `'location'`
        - `'url'`
    - optional
- Show only upcoming events: `'benediktengel.google-calendar-plugin.upcoming' => true`

    - default: `true`
    - optional
    - works only if `attributes` are set to default or the attribute `dateEnd` is set.
- Shorten the displayed description: `'benediktengel.google-calendar-plugin.descriptionLength' => '300'`

    - default: `'300'`
    - optional
    - works only if `cutDescription` is true
- Don't short the description: `'benediktengel.google-calendar-plugin.cutDescription' => true`

    - default: `true`
    - optional
- Name of the link: `'benediktengel.google-calendar-plugin.linkName' => 'Show more.'`

    - default: `'Show more.'`
    - optional
- Style it!

    Each Event comes like this, so you can use the classes to style:

    ```

            New Year's Eve party

                31.12.2018 20:00
             -

                01.01.2019 08:00

            My place

            Come to celebrate the new year together.

                Show more.

    ```

Roadmap
-------

[](#roadmap)

- Section for the settings
- month view
- week view

Wishes? Write an [issue](https://github.com/BenediktEngel/google-calendar-plugin/issues/new) and use the label `enhancement`.

Problems?
---------

[](#problems)

Write an [issue](https://github.com/BenediktEngel/google-calendar-plugin/issues/new) and maybe I can help you.

License
-------

[](#license)

MIT

Credits
-------

[](#credits)

[Benedikt Engel](https://github.com/benediktengel), 2019

---

Want to support me? If yes, [buy me a coffee](buymeacoff.ee/Ij7WUef0o) ☕. [Beer](paypal.me/benediktengel) is also okay🍻.

Thanks!

###  Health Score

20

—

LowBetter than 13% of packages

Maintenance11

Infrequent updates — may be unmaintained

Popularity14

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity38

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/35c3ad5eb22992f3a4c58d3d008beef89204b445a8705d7c6d0a229d8f3d9437?d=identicon)[benediktengel](/maintainers/benediktengel)

---

Top Contributors

[![BenediktEngel](https://avatars.githubusercontent.com/u/32795896?v=4)](https://github.com/BenediktEngel "BenediktEngel (10 commits)")

---

Tags

kirby-pluginkirby3-plugin

### Embed Badge

![Health badge](/badges/benediktengel-google-calendar-plugin/health.svg)

```
[![Health](https://phpackages.com/badges/benediktengel-google-calendar-plugin/health.svg)](https://phpackages.com/packages/benediktengel-google-calendar-plugin)
```

###  Alternatives

[exsyst/swagger

A php library to manipulate Swagger specifications

35816.3M7](/packages/exsyst-swagger)[hubspot/api-client

Hubspot API client

24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol

An implementation of the Minecraft: Bedrock Edition protocol in PHP

172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram

Telegram driver for BotMan

94452.6k6](/packages/botman-driver-telegram)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
