Examples - Liturgical-Calendar/LiturgicalCalendarAPI GitHub Wiki

Looking to display liturgical data on your website? See Using the API on your website for a user-friendly introduction to the component libraries.

Component libraries

The recommended way to integrate with the Liturgical Calendar API is through the official component libraries, which handle API communication, content negotiation, and UI rendering:

• liturgy-components-js — ES6 module components (NPM package) including ApiClient, CalendarSelect, WebCalendar, LiturgyOfTheDay, LiturgyOfAnyDay, and more
• liturgy-components-php — Reusable PHP UI components (Packagist package) including CalendarSelect, ApiOptions, and WebCalendar

Standalone examples

Several standalone example applications demonstrate direct usage of the API. These are hosted on the frontend at https://litcal.johnromanodorazio.com/examples.php and their source code lives in a separate repository:

• PHP web calendar — Uses cURL in PHP to request and render the calendar
• JavaScript web calendar — Uses AJAX to request and render the calendar
• FullCalendar month view — Uses the FullCalendar framework for a calendar grid view
• FullCalendar with messages — Same as above, with the API's computation messages displayed above the calendar

Contributions are welcome — fork the examples repo, create your own example, and submit a Pull Request.

Liturgy of the Day

An Amazon Alexa newsbrief skill that reads the Liturgy of the Day: https://github.com/Liturgical-Calendar/AmazonAlexa-newsbrief

Liturgy of any Day

A page for looking up the liturgy on any given date (e.g., one's baptism day): https://litcal.johnromanodorazio.com/liturgyOfAnyDay.php

Source code in the Frontend repository:

• liturgyOfAnyDay.php
• assets/js/liturgyOfAnyDay.js

This implementation uses the liturgy-components-js library with ApiClient, CalendarSelect, ApiOptions, and LiturgyOfAnyDay.

API documentation

The usage page at https://litcal.johnromanodorazio.com/usage.php provides an interactive overview of the API, including calendar subscription URLs and request parameter configuration.

OpenAPI / Swagger documentation is available at https://litcal.johnromanodorazio.com/dist/.

---

For Developers: ← [API keys]] ](/Liturgical-Calendar/LiturgicalCalendarAPI/wiki/[[Home)