plugin:davcal
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
plugin:davcal [2018-09-10 11:22] – andyboeh | plugin:davcal [2024-02-08 09:03] (current) – [davcal Plugin] LMS23 | ||
---|---|---|---|
Line 3: | Line 3: | ||
---- plugin ---- | ---- plugin ---- | ||
description: | description: | ||
- | author | + | author |
- | email : dev@aboehler.at | + | email : dev@aboehler.at |
type : Syntax Plugin | type : Syntax Plugin | ||
- | lastupdate : 2017-11-24 | + | lastupdate : 2022-08-04 |
- | compatible : Elenor Of Tsort, Detritus, Hrun, Frusterick Manners | + | compatible : Elenor Of Tsort, Detritus, Hrun, Frusterick Manners, Greebo, Hogfather, Igor, "Jack Jackrum", |
depends | depends | ||
conflicts | conflicts | ||
similar | similar | ||
- | tags : calendar, ical, caldav | + | tags : calendar, ical, caldav, !discontinued |
- | downloadurl: | + | downloadurl: |
- | bugtracker : https://code.rnb-consulting.at/tag/davcal_plugin/ | + | bugtracker : https://github.com/dokufreaks/dokuwiki-plugin-davcal/issues |
- | sourcerepo : http://www.aboehler.at/hg/davcal/ | + | sourcerepo : https://github.com/dokufreaks/dokuwiki-plugin-davcal |
donationurl: | donationurl: | ||
screenshot_img : | screenshot_img : | ||
---- | ---- | ||
+ | |||
+ | FIXME **Look for new maintainer - Would be nice if someone could take on this plugin and develop it further! \\ | ||
+ | However, any help with a javascript update is welcome!** FIXME | ||
+ | |||
+ | |||
+ | ===== New repository ===== | ||
+ | The original authors repository https:// | ||
+ | https:// | ||
+ | |||
+ | Pull requests are welcome. | ||
==== DAVCal provides ==== | ==== DAVCal provides ==== | ||
Line 31: | Line 41: | ||
===== Requirements ===== | ===== Requirements ===== | ||
- | * You need the sqlite PlugIn | + | * You need the [[plugin:sqlite]] PlugIn |
* You need at least PHP 5.4 (required by the underlying DAV library), including the PHP XML module (php-xml((openSUSE users add the packages php5-dom, php5-xmlwriter, | * You need at least PHP 5.4 (required by the underlying DAV library), including the PHP XML module (php-xml((openSUSE users add the packages php5-dom, php5-xmlwriter, | ||
* CalDAV synchronisation requires | * CalDAV synchronisation requires | ||
Line 42: | Line 52: | ||
Search and install the plugin using the [[plugin: | Search and install the plugin using the [[plugin: | ||
- | |||
- | ==== Nginx usage ==== | ||
- | |||
- | Since //.ics// url are a bit weird, the following hack is required to make them work: | ||
- | |||
- | < | ||
- | location ~ ^/ | ||
- | include fastcgi_params; | ||
- | fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; | ||
- | fastcgi_param REDIRECT_STATUS 200; | ||
- | fastcgi_pass unix:/ | ||
- | |||
- | fastcgi_split_path_info ^(.+\.php)(.*)$; | ||
- | fastcgi_param PATH_INFO $fastcgi_path_info; | ||
- | fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info; | ||
- | } | ||
- | </ | ||
- | |||
===== Examples/ | ===== Examples/ | ||
Line 91: | Line 83: | ||
In order to display a table with events, the syntax is slightly different: | In order to display a table with events, the syntax is slightly different: | ||
- | < | + | < |
</ | </ | ||
- | This creates tabular output and starts from 2015/10/20 ('' | + | This creates tabular output and starts from 2015/10/20 ('' |
If you want to get all events up to and including today, you can do the following: | If you want to get all events up to and including today, you can do the following: | ||
Line 126: | Line 118: | ||
| sort | '' | | sort | '' | ||
| timezone | Any timezone supported by PHP | Specify the timezone the events should be displayed in. Defaults probably to UTC, depending on your server configuration. | | | timezone | Any timezone supported by PHP | Specify the timezone the events should be displayed in. Defaults probably to UTC, depending on your server configuration. | | ||
+ | | nolocation | not specified | If specified, the field ' | ||
+ | | calname | '' | ||
===== Settings ===== | ===== Settings ===== | ||
The admin can specify default settings for all calendars (timezone, week numbers, ...) in the settings panel. Users can override the settings on a per-user basis by clicking on the link ' | The admin can specify default settings for all calendars (timezone, week numbers, ...) in the settings panel. Users can override the settings on a per-user basis by clicking on the link ' | ||
+ | |||
+ | ==== Nginx usage ==== | ||
+ | |||
+ | Since //.ics// url are a bit weird, the following hack is required to make them work: | ||
+ | |||
+ | < | ||
+ | location ~ ^/ | ||
+ | include fastcgi_params; | ||
+ | fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; | ||
+ | fastcgi_param REDIRECT_STATUS 200; | ||
+ | fastcgi_pass unix:/ | ||
+ | |||
+ | fastcgi_split_path_info ^(.+\.php)(.*)$; | ||
+ | fastcgi_param PATH_INFO $fastcgi_path_info; | ||
+ | fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info; | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | Also, CalDAV requires a similar code block for nginx. | ||
+ | < | ||
+ | location ~ ^/ | ||
+ | include fastcgi_params; | ||
+ | fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; | ||
+ | fastcgi_param REDIRECT_STATUS 200; | ||
+ | fastcgi_pass unix:/ | ||
+ | |||
+ | fastcgi_split_path_info ^(.+\.php)(.*)$; | ||
+ | fastcgi_param PATH_INFO $fastcgi_path_info; | ||
+ | fastcgi_param PATH_TRANSLATED $document_root$fastcgi_path_info; | ||
+ | } | ||
+ | </ | ||
+ | |||
+ | Also, the caret (^) might need to be removed from the location line to get either block to work in some nginx configurations. | ||
===== Synchronization (Client Mode) ===== | ===== Synchronization (Client Mode) ===== | ||
Line 200: | Line 227: | ||
DavCAL currently supports the languages | DavCAL currently supports the languages | ||
- | * English (en) | ||
* Dutch (nl) | * Dutch (nl) | ||
+ | * English (en) | ||
* French (fr) | * French (fr) | ||
* German (de and de-informal) | * German (de and de-informal) | ||
+ | * Russian (ru) | ||
- | If you would like to provide translations, | + | If you would like to provide translations, |
===== Limitations ===== | ===== Limitations ===== | ||
Line 229: | Line 257: | ||
=== Change Log === | === Change Log === | ||
- | {{rss>http://feeds.feedburner.com/ | + | {{rss>https://github.com/dokufreaks/ |
=== Known Bugs and Issues === | === Known Bugs and Issues === | ||
- | Please use the bug tracker (" | + | [[https://github.com/dokufreaks/dokuwiki-plugin-davcal/issues|Use GitHub]] |
- | + | ||
- | * Timezone support is not fully tested | + | |
- | * Recurring events should be displayed correctly, but there is no user-interface to add/edit them | + | |
- | * Due to the underlying DAV library, you need at least PHP 5.4. Otherwise, you'll get PHP parse errors. | + | |
=== ToDo/Wish List === | === ToDo/Wish List === | ||
- | Please use the bug tracker (" | + | [[https://github.com/dokufreaks/dokuwiki-plugin-davcal/issues|Use GitHub]] |
- | * Add editor support for recurring events. Please! nth.DayPerMonth, | ||
- | * Translations (please contact me via E-Mail if you would like to contribute translations) | ||
plugin/davcal.1536571341.txt.gz · Last modified: 2018-09-10 11:22 by andyboeh