NRW:Kalender/Anleitung

Aus Piratenwiki
Wechseln zu: Navigation, Suche
Tango-office-calendar.svg Dieser Artikel ist veraltet. Es wird geprüft, ob er gelöscht oder aber aktualisiert wird. Du kannst den Artikel aber auch auf den neuesten Stand bringen oder archivieren.
Dieser Artikel ist seit 1451 Tagen ohne Bearbeitung.archivieren

Kalender

Der Kalender der Piratenpartei Landesverband Nordrhein-Westfalen beinhaltet die Termine der Piraten in NRW.

Er ist erreichbar unter der Webadresse:

http://kalender.piratenpartei-nrw.de

Der Kalender ist unterteilt in folgende Kategorien.

  • Stammtisch
  • Crew
  • Arbeitskreis
  • Arbeitsgruppe
  • Projektgruppe
  • Vorstand
  • Sonstige

Jeder dieser Kalender enthält alle Termine der letzten 60 Tage und die zukünftigen Termine.

Die im Kalender verwendeten Termine werden ausschließlich über die im Wiki der Piratenpartei hinterlegten Termine gepflegt. Dies ermöglicht eine einfache Pflege aller Termine, da hierfür meist auch Formulare bereit stehen, die sogar das Erlernen der Wiki-Syntax ersparen.

Für den Kalender werden vor allem Termine der Protokolle genutzt. Diese werden automatisiert ausgelesen und interpretiert. Da diese Interpretation leider auch ihre Grenzen findet sollte folgende Form der Terminbekanntgabe verwendet werden.

== Nächster Termin ==
:Ort:    Name des Ortes oder [[Mumble]]
:Datum:  02.10.2011
:Beginn: 20:00 Uhr

Dies ist nur ein Vorschlag, andere Formate werden ebenfalls interpretiert, können aber eventuell zu Fehldeutungen führen.

Als Ort sollte eine Adresse angegeben werden, wenn es geht auch mit dem Namen des Lokals. Sollte der Termin in Mumble stattfinden, so kann auch auf Mumble verwiesen werden. Dafür gibt es zwei Möglichkeiten:

  1. [[Mumble]] Verweist lediglich auf die Sprachkonferenzsoftware
  2. [[mumble:Nordrhein-Westfalen/Arbeitsgruppen/Website|Raum der Arbeitsgruppe Website]] Verweist mit einem Pseudolink direkt auf den Mumbleraum. Ist dieses installiert, so wird durch Klick auf den Link Mumble gestartet und der Raum automatisch betreten. Nordrhein-Westfalen/Arbeitsgruppe/Website ist in diesem Fall der Name des Raums.


Die Protokolle müssen in einer Unterkategorie der Kategorie:API:Kalender:NRW abgelegt werden. Beispielhaft soll dies am Arbeitskreis Datenschutz verdeutlicht werden.

Die eingebundene Vorlage {{Vorlage:Protokoll}} und den Abschnitt
== nächster Termin ==
 was: [[NRW:Arbeitskreis/Datenschutz|Arbeitskreis Datenschutz NRW]]
 wann: 5.Februar 2012
 beginn: 10:00
 ende: 17:00
 wo: [[NRW:Tag_der_politischen_Arbeit_2012.1|Tag der politischen Arbeit 2012.1]] Dortmund, siehe Link

Mit einem anderen Verfahren werden die Stammtische eingebunden, da diese meist nicht über ein Protokoll verfügen. Hier werden die Daten der Seite NRW-Web:Stammtische entnommen. Für Hilfe beim Eintragen eines Stammtischs wendet man sich bitte an Alexander Reintzsch.

Im Regelfall wird die Dauer eines Termins mit 2 Stunden festgelegt.

Webkalender

Unter http://kalender.piratenpartei-nrw.de findet man die mit phpicalender erstellte Weboberfläche des NRW-Kalenders.

Hier kann man die Kalender lesen. Auch hier sind die Kalender wieder getrennt nach ihrer Kategorie (siehe oben) auswählbar und kombinierbar. Dabei wird für jeden Kalender eine eigene Farbe für die bessere Unterscheidbarkeit genutzt. Ebenso hat man die Möglichkeit sich die Termine in vier verschiedenen Ansichten zeigen zu lassen.

  • Tag
  • Woche
  • Monat
  • Jahr

Es besteht die Möglichkeit den Kalender mittels Cookies für sich in der Ansicht nach den eigenen Bedürfnissen zu konfigurieren. Dafür steht eine Konfigurationsseite zur Verfügung, die über den auf der rechten Seite befindlichen Link "Einstellungen" erreichbar ist.

Es gibt neben der Webansicht im klassischen Kalender-Raster-Format auch die Liste der Termine in der unteren Hälfte der Seite. Ebenso gibt es eine Druckansicht, für den Fall, dass man die Termine ausdrucken möchte. Der entsprechende Link befindet sich rechts. Auch auf der rechten Seite befinden sich einige Felder mit denen man die angezeigten Termine nach bestimmten Werten filtern kann.

Zum Suchen von Terminen gibt es zusätzlich auf der rechten Seite ein Feld neben dem auf der rechten Seite ein Fragezeichen steht. Hiermit lassen sich die Termine nach einem beliebigen Begriff heraus filtern.

Beim Überfahren eines Termins mit dem Mauszeiger, werden Details zum jeweiligen Termin angezeigt. Durch einen Klick auf den Termin wird ein Pop-Up-Fenster angezeigt in dem weitere Details zum Termin zu finden sind. Beispielsweise die Webseite oder Links zu Karte bei Open Street Map (OSM) oder Google Maps (GMAP).

Abonnieren der Kalender

Für das Abonnieren der Kalender für die Weiterverwendung in einem externen Programm gibt es verschiedene Möglichkeit.

Alle Daten werden mit dem MIME-Type text/calender zurück gegeben. Das verwendete Datenformat ist iCalendar.

Diese werden von unterschiedlichen Programmen in unterschiedlicher Art und Weise interpretiert. Für die genaue Nutzung und Einrichtung des verwendeten Programms bitte die entsprechenden Seiten im Netz benutzten.

HINWEIS: Für alle Kalender gibt es ausschließlich lesenden Zugriff. Für das Ändern und Eintragen von Terminen gibt es schließlich das Wiki.

WebCal

WebCal (webcal://) ist ein Pseudoprotokoll für die Übertragung von Kalender-Daten. Als Pseudoprotokoll ist es meist mit einer auf dem Endgerät installierten Anwendung verknüpft.

Um WebCal zu nutzen ist lediglich ein einzelner Kalender in der Weboberfläche auf http://kalender.piratenpartei-nrw.de auszuwählen. Da durch erscheint in der oberen, rechten Spalte ein Link mit dem Namen Abonnieren. Durch einen Klick auf diesen Link wird die Webcal-Anwendung geöffnet.

Um nur die Adresse des Links zu bekommen ist in den meisten Fällen die rechte Maustaste zu klicken und Link-Adresse kopieren oder ähnliches auszuwählen.

Die entsprechende URL sieht wie folgt aus:

webcal://kalender.piratenpartei-nrw.de/calendar/stammtisch.ics

ics

Das Datenformat iCalendar hat die Dateiendung .ics. Diese wird von den meisten Kalenderprogrammen interpretiert. Die Qualität der Interpretation und der angezeigten Daten ist bei jedem Programm unterschiedlich.

Um die ICS-Datei nutzen zu können, ist lediglich ein einzelner Kalender in der Weboberfläche auf http://kalender.piratenpartei-nrw.de auszuwählen. Da durch erscheint in der oberen, rechten Spalte ein Link mit dem Namen Herunterladen. Durch einen Klick auf diesen Link wird die Datei vom Server geladen und kann lokal gespeichert oder von einem Programm eingebunden werden.

Um nur die Adresse des Links zu bekommen, ist in den meisten Fällen die rechte Maustaste zu klicken und Link-Adresse kopieren oder ähnliches auszuwählen.

Die entsprechende URL sieht wie folgt aus:

http://kalender.piratenpartei-nrw.de/calendar/stammtisch.ics

CalDAV

CalDAV ist eine Spezifikation um Daten über das WebDAV-Protokoll auszutauschen. Damit lassen sich im Regelfall Kalender in beide Richtungen Synchronisieren. Da die hier verwendeten Kalender aber lediglich lesenden Zugriff gestatten ist das nicht möglich. Dennoch soll auch dieser Zugriff hier erläutert werden.

CalDAV basiert auf einer Nutzerauthentifikation, das heißt, dass der Benutzer sich mit einem Namen und einem Passwort gegenüber dem Server identifizieren muss.

Der Benutzername ist nr​w und das P​a​s​sw​​o​r​​t ist pira​​t​​en.

Die CalDAV-Adresse lautet:

caldav://kalender.piratenpartei-nrw.de/caldav/caldav.php/nrw

oder

http://kalender.piratenpartei-nrw.de/caldav/caldav.php/nrw

Danach folgt dann ein weiterer Schrägstich / und der Name der Kalenderkategorie in Kleinbuchstaben.

Beispielsweise für Stammtische:

caldav://kalender.piratenpartei-nrw.de/caldav/caldav.php/nrw/stammtisch

einzelner Termin

Es besteht ebenfalls die Möglichkeit bloß einen einzelnen Termin herunterzuladen. Auch hierfür wird das ICS-Datenformat verwendet. Um dies zu tun klickt man in der Webansicht auf einen Termin, worauf dann ein Pop-Up-Fenster erscheint. In diesem befindet sich ein Button mit der Aufschrift event download. Durch Klick auf den Button wird die ICS-Datei dieses Termins vom Server geladen und kann durch eine entsprechende Anwendung weiterverarbeitet werden.

RSS-Feed

RSS ist ein auf XML basierendes Format zum Abonnieren von Webinhalten. Die Webansicht bietet hier die Möglichkeit einzelne oder alle Kalender in diesem Format zu abonnieren. Dies kann tages-, wochen- oder monatsbasiert sein. Als RSS-Versionen stehen 0.91, 1.0 und 2.0 zur Verfügung.

Zunächst sind die entsprechenden Kalender in der Mehrfachauswahl festzulegen. Der Link um zu den RSS-Feeds zu gelangen befindet sich am Fuß der Webseite ganz unten und trägt den Namen RSS_Enabled.

Auf der RSS-Auswahl-Seite werden tabellarisch die RSS-Informationen aufgeführt. In der linken Spalte befindet sich der Name des Kalenders, in der rechten Spalte befindet sich ein Block von je drei mal drei Links für den entsprechenden Zeitraum und die entsprechende RSS-Version.

Durch Klicken auf das RSS-Symbol Feed-icon.svg wird der Feed geladen und kann beispielsweise als dynamisches Lesezeichen im Browser oder einem Feedreader eingebunden werden.

Stammtischsuche

Neben der direkten, kalenderbezogenen Ansicht bietet http://kalender.piratenpartei-nrw.de auch noch eine Stammtischsuche. Diese ermöglicht das Suchen nach Stammtischen in der Umgebung einer gewählten Adresse innerhalb Deutschlands.

Die Stammtischsuche erreicht man entweder über den Menüpunkt Stammtischsuche oder direkt über die Adresse http://kalender.piratenpartei-nrw.de/maps.

In die Eingabezeile wird eine Adresse eingegeben. Ist Javascript aktiviert, so wird nach dem Beenden der Eingabe automatisch nach den passenden Stammtischen gesucht. Ist es nicht aktiviert, so muss die Entertaste gedrückt oder Stammtisch Suchen geklickt werden.

Ist die eingegebene Adresse gültig, so wird das Eingabefeld grün umrandet und die entsprechenden Ergebnisse werden tabellarisch ausgegeben. Ist die Adresse nicht interpretierbar, so erscheint der Rahmen rot.

Die Ausgabe der Ergebnisse erscheint unterhalb des Suchfeldes in tabellarischer Form mit den Spalten Ort, Datum, Entfernung und Adresse. Eine Sortierung ist möglich nach den Spalten Ort, Datum und Entfernung. Die Entfernung bezeichnet die Luftlinie zwischen der eingegebenen Adresse und dem entsprechenden Stammtisch in Kilometern.

Zu jedem Stammtisch wird in der Spalte Ort der Name des Stammtischs angegeben, hinterlegt mit einem Link zur entsprechenden Wikiseite. Ebenso wird das Datum mit Tag und Uhrzeit angezeigt. In der letzten Spalte, Adresse, befinden sich zunächst der Name des Lokals, gegebenenfalls mit einem Link zu der entsprechenden Webseite und ein Link zur Google-Maps-Routenplanung, welche die eingegebene Adresse als Start- und die Stammtischadresse als Endpunkt annimmt.

HINWEIS: Für die Bestimmung der eingegebenen Adresse wird intern die API von Google Maps verwendet. Die Seite http://kalender.piratenpartei-nrw.de speichert die Eingabe hingegen nicht.

Als kleines Extra gibt es über dem Suchfeld einen Link zur Übersicht über Stammtische in NRW (Google-Maps). Dieser öffnet Google-Maps und zeigt dort alle Stammtische in NRW auf einer Karte auf. Dabei wird auf die automatisch generierte KML-Datei zugegriffen. Diese eignet sich auch um die Stammtische in Anwendungen wie Google-Earth anzeigen zulassen.

http://kalender.piratenpartei-nrw.de/maps/piraten_stammtische_nrw.kml

Administration

Der Administrator der Seite ist Alexander Reintzsch. Die Pflege der Daten, habt ihr selbst in der Hand. :P

Viel Spaß mit dem Kalender. Auf dass niemand mehr unpünktlich sein möge. ^^