English

This plugin basically provides an ical calendar object that may be configured or used in other views or plugins. An admin configurable default view may also be used out-of-the-box.It integrates a small tool that make URL clickable (including email, ftp, or www.domain.tld addresses -without prefix)

• a configurable ical_viewer object that may be instanciated and uses wherever one want to ;
• an "instanciated" view is provided (index.php) with a demo calendar ; edit the file to configure ;
• ical_viewer.php script may be used to display calendars into "one_column" layout with a few modifications ;
• may use distant or local icla files - see readme.txt for examples.

Install & use :

1. Copy into mod/ directory
2. Activate the plugin
3. Configure :
   • default calendar URL
   • events display timeframe : days before current date (default : 7), and days after (default : 366)
   • number of events to display (default : 3)
4. Integration and usage :
   • default calendar page is at /mod/ical_viewer/index.php (no menu entry)
   • default view is called by : elgg_view('ical_viewer/read', array('entity' => $entity, 'full'=>true) )
   • you may use various input files and calendars by passing a new $entity with the following values :

      $entity = array(        'url' => "$url",         'title' => "$title",         'timeframe_before' => $timeframe_before, // Optional (default : 7 days)        'timeframe_after' => $timeframe_after,  // Optional (default : 366 days)        'num_items' => $num_items,  // Optional (default : 3 events)        );

See readme.txt file for code examples and local file input instead of distant URL.

Crédits :

• Devleopment supported by Innovations Democratic program.
• This plugin integrates iCalcreator class v2.6 library - copyright (c) 2007-2008 Kjell-Inge Gustafsson kigkonsult, www.kigkonsult.se/iCalcreator/index.php - ical@kigkonsult.se

Français

Ce plugin vise essentiellement à fournir un objet calendrier ical utilisable dans d'autres vues.Les URL spécifiées dans le fichier .ics source sont parsées et affichées sous forme de liens (y compris contacts mail, ftp, adresses non préfixées, etc.)

• un objet ical_viewer configurable peut être instancié et utilisé où bon vous semble ;
• une vue "instanciée" index.php est fournie avec un calendrier de démo, à titre d'exemple ;
• le fichier ical_viewer.php peut être utilisé pour afficher des calendriers en pleine page, avec quelques adaptations mineures.

Installation et utilisation :

1. Copier le plugin dans mod/
2. Activer le plugin
3. Le configurer :
   • URL du calendrier par défaut
   • fenêtre de validité des événements par défaut (nombre de jours antérieurs et postérieurs à la date actuelle)
   • nombre d'événements à afficher
4. Intégrer et utiliser :
   • le calendrier par défaut est accessible via la page /mod/ical_viewer/index.php
   • la vue par défaut est appelée via : elgg_view('ical_viewer/read', array('entity' => $entity, 'full'=>true) )
   • Pour l'utiliser, il faut instancier un objet $entity avec les valeurs suivantes :

      $entity = array(        'url' => "$url",         'title' => "$title",         'timeframe_before' => $timeframe_before, // Facultatif (7 jours par défaut)        'timeframe_after' => $timeframe_after,  // Facultatif (366 jours par défaut)        'num_items' => $num_items,  // Facultatif (3 événements par défaut)        );

Voir le fichier readme.txt pour des exemples de code.

Crédits :

• Développement financé par le programme Innovations Democratic.
• Ce plugin utilise la librairie iCalcreator class v2.6 - copyright (c) 2007-2008 Kjell-Inge Gustafsson kigkonsult, www.kigkonsult.se/iCalcreator/index.php - ical@kigkonsult.se