*.ics field

Nb téléchargements : 201

Components

Code
Documentation
Miscellaneous
User interface

Licence

http://www.gnu.org/licenses/old-licenses/gpl-2.0.html

permet de fournir un type de champ, ainsi qu'un widget et un formateur pour fichier ics / iCalendar pouvant être utilisés avec un client de messagerie/calendrier programme

Back-office Front Widget Field Content Fields Syndication Site Structure Content Editing Experience Import and Export

Release

Status : Published

Projects : Modules

Maintenance status : Seeking co-maintainer(s)

Development status : Under active development

Supported Branches : 3.0.

Stable releases for this project are covered by the security advisory policy.

3.0.0

released 25 June 2023

Works with Drupal: ^9.3 || ^10

Install:

composer require 'drupal/ics_field:^3.0'

Covered by Drupal's security advisory policy

Release type : New features

2.0.1

released 31 January 2023

Works with Drupal: ^8.8 || ^9

Install:

composer require 'drupal/ics_field:^2.0'

Covered by Drupal's security advisory policy

Release type : Bug fixes

8.x-1.0

released 30 January 2017

Works with Drupal: 8.x

Install:

composer require 'drupal/ics_field:^1.0'

Covered by Drupal's security advisory policy

Description

INTRODUCTION

The *.ics field module provides a field type, along with a widget and a formatter that, when added to a node and combined with a Datetime field can produce *.ics (iCalendar) files that can be used with an email/calendar client program.

REQUIREMENTS

This module requires the following modules to be installed/enabled:

Datetime: https://www.drupal.org/docs/8/core/modules/datetime/
Token: https://www.drupal.org/project/token

and the following libraries to be available (autoloaded):

Html2Text: https://packagist.org/packages/html2text/html2text
iCal (by eluceo): https://packagist.org/packages/eluceo/ical

INSTALLATION

Install as you would normally install a contributed Drupal module. See: https://drupal.org/documentation/install/modules-themes/modules-8 for further information.

CONFIGURATION

The module provides no configuration. That being said, the following points are important:

It assumes that the process through which Drupal is run has file and folder create permissions for the public:// filesystem. It will store all ics files into the public://icsfiles folder if a user specified folder is not given, and when not found it will try to create it.

When adding a Calendar Dowload field to a content type, you are required to select a Datetime field from the same content type. That relation will allow the Calendar Download module to decide when generated events occur.

The field generates a public file, i.e. accessible without need of authentication.

USE OF TOKENS

The Calendar Download module supports using tokens inside the Summary and the Description sub-fields. Available tokens include the properties and fields of the given content type and are available through the UI as a list that can be click-inserted into the Summary or Description sub-fields.

While editing a node, by entering e.g. "[node:title]" into the Calendar Download's Summary sub-field and saving the node, the node's title will be inserted into the summary sub-field.

REFERENCES

The following links provide more information about the iCal format:

CONTRIBUTING

~~Github: https://github.com/stefanospetrakis/ics_field~~

We use a Github pull request workflow. Each pull request should have a related and cross-linked drupal.org issue and be made against the develop branch.

Important note (20/11/2020): Since https://git.drupalcode.org/project/ics_field (Gitlab) now accepts Merge (Pull) Requests and integrates with drupal.org, we are going to drop the github repo.

We welcome contributions in the following areas:

Unit tests - Test coverage is currently good but not great.

Toutes les informations proviennent du site drupal.org