Serve ICS calendar as JSON for websites
Find a file
2024-01-08 00:38:17 +01:00
ICal Update ICal 2023-04-23 20:07:52 +02:00
index.php Added interval filter 2024-01-08 00:34:54 +01:00
LICENSE Initial commit 2021-10-13 14:08:58 +02:00
README.md Add info for interval param 2024-01-08 00:38:17 +01:00

Hackcal

This script is using PHP ICS Parser to parse ics files, e.g. from Nextcloud. The output is an very simple json for embedding the calender into html websites. Its presorted by days and preformatted to use less js on client side for date interpretation. The server part requires php-intl


Installation

Just copy the files into your php capable webserver directory. Be sure, that the cache folder is writeable by the script and the locale set in the index.php is available on the system.

Usage

Just call the url. You can filter by categories by adding /?filter=category to the request. You can expand the interval of the events by adding /?interval= to the request. The number represents the amount of future months as an integer between 1..12.

Example integration using jQuery.

You will need to include a <div id="hackcal"></div> placeholder in your html page and embed also the jQuery js library.

(function($) {

    var cal_uri = "https://YOURDOMAIN/hackcal/";
    var uri_regex = /(https?:\/\/([-\w\.]+)+(:\d+)?(\/([\w\/\-_\.]*(\?\S+)?)?)?)/ig

    $.getJSON(cal_uri, function(data) {
	var items = [];
        $.each(data, function(date, day) {
            items.push("<tr data-date='" + date + "'><th colspan='3'>" + day.name + "</th><th>" + day.weekday + "</th></tr>");
            $.each(day.events, function(uid, event) {
		event.description = event.description.replace(/\n/g,"<br>").replace(uri_regex, "<a href='$1' target='_blank'>$1</a>");
                items.push("<tr data-uid='" + uid + "'><td>" + event.datestr + "</td><td>" + event.summary + "</td><td>" + ((event.location)?event.location:'') + "</td><td>" + ((event.description)?event.description:'') + "</td></tr>");
            });
        });
	$('#hackcal').html("<table><tbody>" + items.join( "" ) + "</tbody></table>");
    });

})(jQuery);