Module Description
This module provides a block to display a calendar powered by FullCalendar 5. It creates a block called 'FullCalendar block' which accepts event source as a json (URL) feed. The URL can be a relative or absolute link. You may use a relative link if the event source is a Drupal view.
REQUIREMENTS
This module requires FullCalendar library (https://github.com/fullcalendar/fullcalendar). It may also make use of DOMPurify (https://github.com/cure53/DOMPurify) to handle sanitization of HTML when rendering custom event descriptions in a dialog popup to prevent potential XSS attacks. As well as support for the Moment (https://fullcalendar.io/docs/moment-plugin) and RRule (https://fullcalendar.io/docs/rrule-plugin) plugins. By default, all required libraries will be loaded from a CDN (usually https://unpkg.com) automatically if they could not be located on disk. A cache clear is typically required following a change in the library states.
INSTALLATION
COMPOSER INSTALLATION You can install this module as a normal installation process of Composer. Optionally, if you'd like to automatically install the external libraries into your local Drupal instance, then you may add drupal/fullcalendar_block as a drupal-libraries-dependencies of the zodiacmedia/drupal-libraries-installer plugin.
* Ensure that packages of type drupal-library are properly configured to install to the /libraries directory.
* Add the composer dependency: composer require zodiacmedia/drupal-libraries-installer.
* Add the library to the zodiacmedia/drupal-libraries-installer Drupal libraries dependencies list:
{ "extra": { "drupal-libraries-dependencies": [ "drupal/fullcalendar_block" ] } } Then run composer install as normal.
MANUAL INSTALLATION If you are manually installing the module and require the external Javascript libraries to be loaded from your server, then you may download and extract the following into your Drupal root directory: URL: https://registry.npmjs.org/fullcalendar/-/fullcalendar-5.11.4.tgz Destination: /libraries/drupal-fullcalendar
URL: https://registry.npmjs.org/dompurify/-/dompurify-2.4.5.tgz Destination: /libraries/DOMPurify
URL: https://registry.npmjs.org/moment/-/moment-2.29.4.tgz Destination: /libraries/moment
URL: https://registry.npmjs.org/rrule/-/rrule-2.7.1.tgz Destination: /libraries/rrule
URL: https://registry.npmjs.org/@fullcalendar/rrule/-/rrule-5.11.4.tgz Destination: /libraries/fullcalendar-rrule
URL: https://registry.npmjs.org/@fullcalendar/moment/-/moment-5.11.4.tgz Destination: /libraries/fullcalendar-moment
If the required external libraries are unavailable locally, then they will be loaded from a CDN (usually https://unpkg.com).
EXTRA FILES Please be advised that there is a demo folder (rrule/dist/esm/demo) in the RRule zip file, in which there is an index.html file (see PSA-2011-002). And if the libraries are being manually installed, then you should probably delete the demo folder on your server post-installation. However, if the RRule library is being loaded from the CDN or composer (with integration with the zodiacmedia/drupal-libraries-installer plugin), then you do not need to worry about this step.
CONFIGURATION
1. Go to the Block layout configuration page (/admin/structure/block). 2. Click the 'Place block' button in the area you want the calendar block take place. 3. In the pop-up dialog search 'FullCalendar block' and then place the block. 4. Click the 'Configure' button of the block to set up the block. 5. The 'Event source URL' is mandatory which is the JSON feed URL providing the event data of the calendar. For example, https://fullcalendar.io/api/demo-feeds/events.json 6. The 'Advanced setting' provides the capability to add or modify any options of the FullCalendar, which has to be valid JSON/YAML format text. For example, following will set the initial date at 2022-05-01, "initialDate": "2022-05-01" 7. After saving the configurations, you might need to clear the cache to apply the changes.
8. (Optional) If you are using a Drupal view as the data source and you want to load events via AJAX, you need to expose the view filter as the start day and end day and then name them accordingly. The view URL looks like this,
/event-feed?start=2023-01-01T00%3A00%3A00-05%3A00&end=2023-02-12T00%3A00%3A00-05%3A00
You can get an example from https://www.drupal.org/docs/contributed-modules/fullcalendar-block/how-t...
DEVELOPMENT
* During development, you may switch to non-minified assets by specifying the following in your local `settings.php` and clearing the Drupal cache:
// Enable non-minified assets. $settings['fullcalendar_block.dev_mode'] = TRUE; * There is a hook called 'hook_fullcalendar_block_settings_alter' for other modules to modify the block settings, includeing the calendar options.
More details about this hook see https://git.drupalcode.org/project/fullcalendar_block/-/blob/1.0.x/fullc...
* JavaScript events.
* fullcalendar_block.beforebuild. An event to let other modules know that a calendar will be built
* fullcalendar_block.build. An event to let other modules know when a calendar has been built.
More details about those events see: https://git.drupalcode.org/project/fullcalendar_block#development
FEATURES:
* FullCalendar 5.
* Fully configurable via the block setting.
* Support simple recurring events out of box. https://fullcalendar.io/docs/recurring-events
* Support loading events via Ajax once needed.
* Support the moment and RRule fullcalendar plugins. RRULE generator, https://jakubroztocil.github.io/rrule/
* Event colorize.
* Initial(current) date specified by the URL parameter.For example, http://d8.local/?start=2022-01, that will display the calendar in January 2022.
REQUIREMENTS
This module requires FullCalendar library (https://github.com/fullcalendar/fullcalendar). It may also make use of DOMPurify (https://github.com/cure53/DOMPurify) to handle sanitization of HTML when rendering custom event descriptions in a dialog popup to prevent potential XSS attacks. As well as support for the Moment (https://fullcalendar.io/docs/moment-plugin) and RRule (https://fullcalendar.io/docs/rrule-plugin) plugins. By default, all required libraries will be loaded from a CDN (usually https://unpkg.com) automatically if they could not be located on disk. A cache clear is typically required following a change in the library states.
INSTALLATION
COMPOSER INSTALLATION You can install this module as a normal installation process of Composer. Optionally, if you'd like to automatically install the external libraries into your local Drupal instance, then you may add drupal/fullcalendar_block as a drupal-libraries-dependencies of the zodiacmedia/drupal-libraries-installer plugin.
* Ensure that packages of type drupal-library are properly configured to install to the /libraries directory.
* Add the composer dependency: composer require zodiacmedia/drupal-libraries-installer.
* Add the library to the zodiacmedia/drupal-libraries-installer Drupal libraries dependencies list:
{ "extra": { "drupal-libraries-dependencies": [ "drupal/fullcalendar_block" ] } } Then run composer install as normal.
MANUAL INSTALLATION If you are manually installing the module and require the external Javascript libraries to be loaded from your server, then you may download and extract the following into your Drupal root directory: URL: https://registry.npmjs.org/fullcalendar/-/fullcalendar-5.11.4.tgz Destination: /libraries/drupal-fullcalendar
URL: https://registry.npmjs.org/dompurify/-/dompurify-2.4.5.tgz Destination: /libraries/DOMPurify
URL: https://registry.npmjs.org/moment/-/moment-2.29.4.tgz Destination: /libraries/moment
URL: https://registry.npmjs.org/rrule/-/rrule-2.7.1.tgz Destination: /libraries/rrule
URL: https://registry.npmjs.org/@fullcalendar/rrule/-/rrule-5.11.4.tgz Destination: /libraries/fullcalendar-rrule
URL: https://registry.npmjs.org/@fullcalendar/moment/-/moment-5.11.4.tgz Destination: /libraries/fullcalendar-moment
If the required external libraries are unavailable locally, then they will be loaded from a CDN (usually https://unpkg.com).
EXTRA FILES Please be advised that there is a demo folder (rrule/dist/esm/demo) in the RRule zip file, in which there is an index.html file (see PSA-2011-002). And if the libraries are being manually installed, then you should probably delete the demo folder on your server post-installation. However, if the RRule library is being loaded from the CDN or composer (with integration with the zodiacmedia/drupal-libraries-installer plugin), then you do not need to worry about this step.
CONFIGURATION
1. Go to the Block layout configuration page (/admin/structure/block). 2. Click the 'Place block' button in the area you want the calendar block take place. 3. In the pop-up dialog search 'FullCalendar block' and then place the block. 4. Click the 'Configure' button of the block to set up the block. 5. The 'Event source URL' is mandatory which is the JSON feed URL providing the event data of the calendar. For example, https://fullcalendar.io/api/demo-feeds/events.json 6. The 'Advanced setting' provides the capability to add or modify any options of the FullCalendar, which has to be valid JSON/YAML format text. For example, following will set the initial date at 2022-05-01, "initialDate": "2022-05-01" 7. After saving the configurations, you might need to clear the cache to apply the changes.
8. (Optional) If you are using a Drupal view as the data source and you want to load events via AJAX, you need to expose the view filter as the start day and end day and then name them accordingly. The view URL looks like this,
/event-feed?start=2023-01-01T00%3A00%3A00-05%3A00&end=2023-02-12T00%3A00%3A00-05%3A00
You can get an example from https://www.drupal.org/docs/contributed-modules/fullcalendar-block/how-t...
DEVELOPMENT
* During development, you may switch to non-minified assets by specifying the following in your local `settings.php` and clearing the Drupal cache:
// Enable non-minified assets. $settings['fullcalendar_block.dev_mode'] = TRUE; * There is a hook called 'hook_fullcalendar_block_settings_alter' for other modules to modify the block settings, includeing the calendar options.
More details about this hook see https://git.drupalcode.org/project/fullcalendar_block/-/blob/1.0.x/fullc...
* JavaScript events.
* fullcalendar_block.beforebuild. An event to let other modules know that a calendar will be built
* fullcalendar_block.build. An event to let other modules know when a calendar has been built.
More details about those events see: https://git.drupalcode.org/project/fullcalendar_block#development
FEATURES:
* FullCalendar 5.
* Fully configurable via the block setting.
* Support simple recurring events out of box. https://fullcalendar.io/docs/recurring-events
* Support loading events via Ajax once needed.
* Support the moment and RRule fullcalendar plugins. RRULE generator, https://jakubroztocil.github.io/rrule/
* Event colorize.
* Initial(current) date specified by the URL parameter.For example, http://d8.local/?start=2022-01, that will display the calendar in January 2022.
Module Link
Project Usage
260
Security Covered
Covered By Security Advisory
Version Available
Production
Module Summary
This module aims to solve the problem of displaying a calendar powered by FullCalendar 5 with event sources from a JSON feed, allowing for customization and configuration of the calendar block in Drupal.
Data Name
fullcalendar_block
OPENAI CHATBOT
OPENAI CHATBOT
