Event::getByKey

Aus iTrack
(Unterschied zwischen Versionen)
Wechseln zu: Navigation, Suche
(type)
(Änderung 37510 von 119.252.88.23 (Diskussion) rückgängig gemacht.)
 
(122 dazwischenliegende Versionen von 24 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
Ausgabe einer Liste von Events anhand eines Schlüssels
+
{|class="function"
__NOTOC__
+
{|class="toc overview"
+
 
|+Übersicht
 
|+Übersicht
 
!Modul
 
!Modul
|Event
+
|[[Integration von Events|Event]]
 
|-
 
|-
 
!Name
 
!Name
Zeile 11: Zeile 9:
 
!URL
 
!URL
 
|<code><nowiki>http://lib.itrack.de/event/?getByKey</nowiki></code>
 
|<code><nowiki>http://lib.itrack.de/event/?getByKey</nowiki></code>
|-
 
!Parameter
 
|<code>[[#type|type]]<br />[[#look|look]]<br />[[#file|file]]</code>
 
 
|-
 
|-
 
!HTML-TAG
 
!HTML-TAG
Zeile 19: Zeile 14:
 
|-
 
|-
 
!HTML-ID
 
!HTML-ID
|<code>#event</code>
+
|<code>#page</code> (opt.)
 
|-
 
|-
!JS-Initialisierung
+
!HTML-Klasse
|keine
+
|<code>.event</code><br /><code>.pages</code> (opt.)<br /><code>.selector</code> (opt.)<br /><code>.stats</code> (opt.)
 +
|-
 +
!Technik
 +
|[[#CSS-Definitionen|CSS]]<br />[[#JavaScript|JavaScript]]
 +
|-
 +
!Parameter
 +
|<code>[[#css|css]]<br />[[#display|display]]<br />[[#file|file]]<br />[[#items|items]]<br />[[#limit|limit]]<br />[[#link|link]]<br />[[#offset|offset]]<br />[[#priority|priority]]<br />''sort''<br />[[#theme|theme]]<br />[[#top|top]]<br />'''[[#type|type]]'''</code>
 
|}
 
|}
 +
Ausgabe einer Gruppe von Events als Liste anhand eines Musters
 +
 +
<!--HTML-ID <code>#page</code> und JavaScript werden für die Seitenauswahl eingesetzt.-->
  
 
==Parameter==
 
==Parameter==
====type====
+
====css====
{| class="toc overview"
+
{| class="parameter"
 
|+Übersicht
 
|+Übersicht
 +
!Bedeutung
 +
|Einbindung von CSS
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 
!Typ
 
!Typ
|erforderlich
+
|Integer
 
|-
 
|-
!Wert
+
!Werte
 +
|<code>0<br />1</code>
 +
|-
 +
!Standard
 +
|<code>1</code>
 +
|}
 +
<div>
 +
Folgende Konstanten stehen zur Verfügung:
 +
*<code>0</code><br />Ausgabe ohne CSS
 +
*<code>1</code><br />Ausgabe mit CSS
 +
</div>
 +
 
 +
<!--
 +
====depth====
 +
Anzahl der übergeordneten Gliederungs-Ebenen (Integer).
 +
obsolet
 +
 
 +
-->
 +
 
 +
====display====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Darstellungsmodus
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 +
!Typ
 
|Integer
 
|Integer
 +
|-
 +
!Werte
 +
|<code>EVT_SHORT<br />EVT_SUMMARY<br />EVT_COMPLETE</code>
 +
|-
 +
!Standard
 +
|<code>EVT_SUMMARY</code>
 +
|}
 +
<div>
 +
Folgende Konstanten stehen zur Verfügung:
 +
*<code>EVT_SHORT</code><br />kurze Darstellung
 +
*<code>EVT_SUMMARY</code><br />kurze Darstellung mit Zusammenfassung
 +
*<code>EVT_COMPLETE</code><br />komplette Darstellung
 +
Bei der Darstellung <code>EVT_COMPLETE</code> enthält die Ausgabe eine Seitenstatistik sowie ggf. eine Möglichkeit zur Seitenauswahl. Diese Darstellungsart sollte daher nur einmal pro Seite vorkommen.
 +
</div>
 +
 +
====file====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|DateiPfad
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 +
!Typ
 +
|String
 +
|-
 +
!Werte
 +
|gültige URL-Zeichen
 +
|-
 +
!Standard
 +
|<code>null</code>
 +
|}
 +
<div>
 +
In Abhängigkeit des Parameters <code>[[#display|display]]</code> hat dieser Parameter zwei Bedeutungen:
 +
*<code>display = EVT_COMPLETE</code><br />Pfad zur Datei, die die Übersicht der Events dieses Typs anzeigt. Wenn angegeben, wird der Link <code>Übersicht...</code> angezeigt.
 +
*sonstige Werte<br />Pfad zur Datei, die ggf. das Event vollständig anzeigt (MasterDatei). Wenn angegeben, wird der Link <code>mehr...</code> angezeigt.
 +
Es sind absolute sowie relative Pfadangaben möglich.
 +
 +
Der Linktext wird vorgegeben oder kann mit <code>[[#link|link]]</code> bestimmt werden.
 +
</div>
 +
 +
====items====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Anzahl SeitenItems
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 +
!Typ
 +
|Integer
 +
|-
 +
!Werte
 +
|pos. Zahlen
 
|-
 
|-
 
!Standard
 
!Standard
 
|<code>0</code>
 
|<code>0</code>
 
|}
 
|}
Event-Typ
+
<div>
 +
Anzahl der Events, die auf einer Seite dargestellt werden
 +
</div>
  
Event-Typen sind hierarchisch geordnet. Es wird zwischen den HauptTypen Termine, News und Anträge unterschieden. Damit bestimmt ---   NEU MACHEN --- man die grundsätzliche Art des Umgangs mit einem Event. Für jede TypGruppe gibt es weitere Verfeinerungen.
+
====limit====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Max. Anzahl anzuzeigender Events
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 +
!Typ
 +
|Integer
 +
|-
 +
!Werte
 +
|pos. Zahlen
 +
|-
 +
!Standard
 +
|<code>0</code>
 +
|}
 +
<div>
 +
Maximale Anzahl der anzuzeigenden Events. 0 für alle.
 +
</div>
  
Zur Auswahl stehen folgende Werte:
+
====link====
PETITIONS........für Anträge
+
{| class="parameter"
  └ 2..................für Beschlüsse
+
|+Übersicht
NEWS..................für Nachrichten
+
!Bedeutung
  ├ 4..................für Infotexte
+
|Linktext
  └ 5..................für Pressemitteilungen
+
|-
DATES................für Termine
+
!Verwendung
  ├ 7..................für Versammlungen (parteiintern)
+
|optional
  │ ├ 8..............für Sitzungen (Vorstand etc.)
+
|-
  │ ├ 9..............für Parteitage (und Mitgliederversammlungen)
+
!Typ
  │ └10..............für programmatische Treffen
+
|String
  └11..................für Veranstaltungen (öffentlich)
+
|-
    ├12..............für Vorträge
+
!Werte
    ├13..............für Stammtische
+
|Text
    ├14..............für Infostände
+
|-
    ├15..............für Seminare
+
!Standard
    └16..............für Konferenzen
+
|<code>null</code>
 +
|}
 +
<div>
 +
Wenn Sie bei diesem Parameter einen Text angeben, wird dieser als Link angezeigt. Vorraussetzung ist, daß ein Link mit <code>[[#file|file]]</code> definiert ist.<br />'''experimentell'''
 +
</div>
  
====look====
+
====offset====
{| class="toc overview"
+
{| class="parameter"
 
|+Übersicht
 
|+Übersicht
 +
!Bedeutung
 +
|Ausgabeversatz
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 
!Typ
 
!Typ
 +
|Integer
 +
|-
 +
!Werte
 +
|pos. Zahlen
 +
|-
 +
!Standard
 +
|<code>0</code>
 +
|}
 +
<div>Verwenden Sie diesen Parameter, wenn die Ausgabe von Items erst an der Stelle <code>offset</code> beginnen soll.</div>
 +
 +
====priority====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Priorität
 +
|-
 +
!Verwendung
 
|optional
 
|optional
 
|-
 
|-
!Wert
+
!Typ
 
|Integer
 
|Integer
 +
|-
 +
!Werte
 +
|<code>EVT_NORMAL<br />EVT_HIGH</code>
 
|-
 
|-
 
!Standard
 
!Standard
|<code>COMPLETE</code>
+
|<code>EVT_NORMAL</code>
 
|}
 
|}
Darstellungsmodus
+
<div>
 +
Über die Priorität bestimmen Sie, ob besondere Events verwandter Gliederungen angezeigt werden sollen.
 +
 
 +
Wenn Sie für die Priorität <code>EVT_HIGH</code> einstellen, werden auch Events der direkt untergeordneten Gliederungen sowie anderer Gliederungen der eigenen Region. Voraussetzung ist dabei, daß auch die Events eine hohe Priorität haben.
  
 
Folgende Konstanten stehen zur Verfügung:
 
Folgende Konstanten stehen zur Verfügung:
*<code>SHORT</code><br />kurze Darstellung
+
*<code>EVT_NORMAL</code><br />normale Priorität
*<code>SUMMARY</code><br />kurze Darstellung mit Zusammenfassung
+
*<code>EVT_HIGH</code><br />hohe Priorität
*<code>COMPLETE</code><br />komplette Darstellung
+
</div>
  
====file====
+
====sort====
{| class="toc overview"
+
{| class="parameter"
 
|+Übersicht
 
|+Übersicht
 +
!Bedeutung
 +
|Sortierung
 +
|-
 +
!Verwendung
 +
|optional
 +
|}
 +
<div>
 +
Bestimmt die Sortierung der Ausgabe.<br />'''Noch nicht implementiert'''
 +
</div>
 +
 +
<!--
 +
====state====
 +
Status
 +
obsolet
 +
:Ist kein Status gesetzt, werden ausschließlich nicht interne Events abgezeigt.<br />Ist der Status auf intern gesetzt, erhält man ausschließlich die Internen. Dies ist derzeit bei Events im Mitgliederbereich der Fall.
 +
:Zur Auswahl stehen die Werte:
 +
NORMAL..............normal
 +
INTERN..............intern
 +
-->
 +
 +
====theme====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Thema
 +
|-
 +
!Verwendung
 +
|optional
 +
|-
 
!Typ
 
!Typ
 +
|Integer
 +
|-
 +
!Werte
 +
|siehe [[Verwaltung|Verwaltungsbereich]]
 +
|-
 +
!Standard
 +
|<code>0</code>
 +
|}
 +
Themen spezifizieren ein Event inhaltlich. Sie sind hierarchisch geordnet.
 +
 +
Die aktuell gültigen Werte finden Sie im Verwaltungsbereich unter dem Menupunkt <code>Events &rarr; Konstanten</code>.
 +
<!--
 +
Zur Auswahl stehen die Werte:
 +
'''NICHT AKTUELL'''
 +
NONE..................kein Thema
 +
    1..................für Verbandsarbeit
 +
    2..................für Orts- & Stadtpolitik
 +
    3..................für Regionalpolitik
 +
    4..................für Bezirkspolitik
 +
    5..................für Landespolitik
 +
    6..................für Bundespolitik
 +
    7..................für Europapolitik
 +
-->
 +
 +
====top====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|Anzahl übergeordneter<br />Gliederungs-Ebenen
 +
|-
 +
!Verwendung
 
|optional
 
|optional
 
|-
 
|-
!Wert
+
!Typ
|String
+
|Integer
 +
|-
 +
!Werte
 +
|pos. Zahlen
 
|-
 
|-
 
!Standard
 
!Standard
|<code>null</code>
+
|<code>0</code>
 
|}
 
|}
Pfad zur Masterdatei
+
<div>
 +
Anzahl der übergeordneten Gliederungs-Ebenen
  
Es sind absolute sowie relative Pfadangaben möglich.
+
Hiermit wird festgelegt, bis zu welcher übergeordneten Ebene Events angezeigt werden.
 +
Beispiel: Eine 1 bei der FDP Unterfranken zeigt auch Events der FDP Bayern mit an.
 +
</div>
 +
 
 +
====type====
 +
{| class="parameter"
 +
|+Übersicht
 +
!Bedeutung
 +
|EventTyp
 +
|-
 +
!Verwendung
 +
|<span class="required">erforderlich</span>
 +
|-
 +
!Typ
 +
|Integer
 +
|-
 +
!Werte
 +
|siehe [[Verwaltung|Verwaltungsbereich]]
 +
|-
 +
!Standard
 +
|<code>0</code>
 +
|}
 +
<div>
 +
EventTypen bestimmen die grundlegende Darstellung eines Events (so haben z.B. News eine andere HTML-Struktur als Termine). Sie sind hierarchisch geordnet. Auf der obersten Ebene finden Sie die HauptTypen, die im Wesentlichen die Darstellung festlegen.
 +
 
 +
Die aktuell gültigen Werte finden Sie im Verwaltungsbereich unter dem Menupunkt <code>Events &rarr; Konstanten</code>.
 +
</div>
 +
<!--
 +
Zur Auswahl stehen die Werte:
 +
'''NICHT AKTUELL'''
 +
PETITIONS........für Anträge
 +
  └ 2..................für Beschlüsse
 +
NEWS..................für Nachrichten
 +
  ├ 4..................für Infotexte
 +
  └ 5..................für Pressemitteilungen
 +
DATES................für Termine
 +
  ├ 7..................für Versammlungen (parteiintern)
 +
  │ ├ 8..............für Sitzungen (Vorstand etc.)
 +
  │ ├ 9..............für Parteitage (und Mitgliederversammlungen)
 +
  │ └10..............für programmatische Treffen
 +
  └11..................für Veranstaltungen (öffentlich)
 +
    ├12..............für Vorträge
 +
    ├13..............für Stammtische
 +
    ├14..............für Infostände
 +
    ├15..............für Seminare
 +
    └16..............für Konferenzen
 +
-->
  
 
<!--
 
<!--
Zeile 120: Zeile 379:
 
  ?>
 
  ?>
  
=== Einzelne Events ===
+
===Einzelne Events===
 
Der nachfolgende Code ist an der gewünschten Stelle in der Datei einzufügen.
 
Der nachfolgende Code ist an der gewünschten Stelle in der Datei einzufügen.
 
  <?php
 
  <?php
Zeile 126: Zeile 385:
 
  ?>
 
  ?>
  
=== Mehrere Events ===
+
===Mehrere Events===
 
Der nachfolgende Code ist an der gewünschten Stelle in der Datei einzufügen.
 
Der nachfolgende Code ist an der gewünschten Stelle in der Datei einzufügen.
 
  <?php
 
  <?php
Zeile 132: Zeile 391:
 
  ?>
 
  ?>
  
=== Bedeutung der Parameter ===
+
===Bedeutung der Parameter===
 
-->
 
-->
* depth<br />Anzahl der übergeordneten Gliederungs-Ebenen (Integer).
 
:iermit wird festgelegt, bis zu welcher übergeordneten Ebene Events angezeigt werden.
 
:Beispiel: Eine 1 bei der FDP Unterfranken zeigt auch Events der FDP Bayern mit an.
 
  
* priority<br />EventPriorität (Integer)
+
==Fehlermeldungen==
:Bi hoher Priorität werden auch Events der nächsttieferen Gliederungs-Ebene sowie der Schwester-Verbände derselben Ebene angezeigt. Dies ist bei der Darstellung der Gesamtübersicht äußerst empfehlenswert.
+
''keine''
:Beispiel:<br />Bei der FDP Unterfranken werden so auch Events der Kreisverbände sowie z.B. der JuLis Unterfranken angezeigt.
+
:Zur Auswahl stehen die Werte:
+
NORMAL..............normale Priorität
+
HIGH..................hohe Priorität
+
  
* state<br />Status
+
==Technik==
:st kein Status gesetzt, werden ausschließlich nicht interne Events abgezeigt.<br />Ist der Status auf intern gesetzt, erhält man ausschließlich die Internen. Dies ist derzeit bei Events im Mitgliederbereich der Fall.
+
===HTML-Struktur===
:Zur Auswahl stehen die Werte:
+
NORMAL..............normal
+
INTERN..............intern
+
  
*theme<br />Event-Thema (Integer)
+
===CSS-Definitionen===
:vent-Themen sind hierarchisch geordnet. Es wird zwischen den TypGruppen Termine, News und Anträge unterschieden. Damit bestimmt man die grundsätzliche Art des Umgangs mit einem Event. Für jede TypGruppe gibt es weitere Verfeinerungen.
+
;<nowiki>#</nowiki>page
:Zur Auswahl stehen folgende Werte:
+
:Seitennavigation
NONE..................kein Thema
+
;.event
    1..................für Verbandsarbeit
+
:Liste der Events
    2..................für Orts- & Stadtpolitik
+
;.pages
    3..................für Regionalpolitik
+
:Anzeige der Seitenzahlen
    4..................für Bezirkspolitik
+
;.selector
    5..................für Landespolitik
+
:Auswahl der Seitenzahlen
    6..................für Bundespolitik
+
;.stats
    7..................für Europapolitik
+
:Seitenstatistik
  
* num<br />Event-Anzahl (Integer)
+
===JavaScript===
:maximale Anzahl der anzuzeigenden Events. 0 für alle.
+
<code>initPage</code>
  
 +
[[Category:Webmaster]]
 
[[Category:Module]]
 
[[Category:Module]]
 
[[Category:Events]]
 
[[Category:Events]]

Aktuelle Version vom 13. Januar 2012, 21:18 Uhr

Übersicht
Modul Event
Name getByKey
URL http://lib.itrack.de/event/?getByKey
HTML-TAG UL
HTML-ID #page (opt.)
HTML-Klasse .event
.pages (opt.)
.selector (opt.)
.stats (opt.)
Technik CSS
JavaScript
Parameter css
display
file
items
limit
link
offset
priority
sort
theme
top
type

Ausgabe einer Gruppe von Events als Liste anhand eines Musters


Inhaltsverzeichnis

[Bearbeiten] Parameter

[Bearbeiten] css

Übersicht
Bedeutung Einbindung von CSS
Verwendung optional
Typ Integer
Werte 0
1
Standard 1

Folgende Konstanten stehen zur Verfügung:

  • 0
    Ausgabe ohne CSS
  • 1
    Ausgabe mit CSS


[Bearbeiten] display

Übersicht
Bedeutung Darstellungsmodus
Verwendung optional
Typ Integer
Werte EVT_SHORT
EVT_SUMMARY
EVT_COMPLETE
Standard EVT_SUMMARY

Folgende Konstanten stehen zur Verfügung:

  • EVT_SHORT
    kurze Darstellung
  • EVT_SUMMARY
    kurze Darstellung mit Zusammenfassung
  • EVT_COMPLETE
    komplette Darstellung

Bei der Darstellung EVT_COMPLETE enthält die Ausgabe eine Seitenstatistik sowie ggf. eine Möglichkeit zur Seitenauswahl. Diese Darstellungsart sollte daher nur einmal pro Seite vorkommen.

[Bearbeiten] file

Übersicht
Bedeutung DateiPfad
Verwendung optional
Typ String
Werte gültige URL-Zeichen
Standard null

In Abhängigkeit des Parameters display hat dieser Parameter zwei Bedeutungen:

  • display = EVT_COMPLETE
    Pfad zur Datei, die die Übersicht der Events dieses Typs anzeigt. Wenn angegeben, wird der Link Übersicht... angezeigt.
  • sonstige Werte
    Pfad zur Datei, die ggf. das Event vollständig anzeigt (MasterDatei). Wenn angegeben, wird der Link mehr... angezeigt.

Es sind absolute sowie relative Pfadangaben möglich.

Der Linktext wird vorgegeben oder kann mit link bestimmt werden.

[Bearbeiten] items

Übersicht
Bedeutung Anzahl SeitenItems
Verwendung optional
Typ Integer
Werte pos. Zahlen
Standard 0

Anzahl der Events, die auf einer Seite dargestellt werden

[Bearbeiten] limit

Übersicht
Bedeutung Max. Anzahl anzuzeigender Events
Verwendung optional
Typ Integer
Werte pos. Zahlen
Standard 0

Maximale Anzahl der anzuzeigenden Events. 0 für alle.

[Bearbeiten] link

Übersicht
Bedeutung Linktext
Verwendung optional
Typ String
Werte Text
Standard null

Wenn Sie bei diesem Parameter einen Text angeben, wird dieser als Link angezeigt. Vorraussetzung ist, daß ein Link mit file definiert ist.
experimentell

[Bearbeiten] offset

Übersicht
Bedeutung Ausgabeversatz
Verwendung optional
Typ Integer
Werte pos. Zahlen
Standard 0
Verwenden Sie diesen Parameter, wenn die Ausgabe von Items erst an der Stelle offset beginnen soll.

[Bearbeiten] priority

Übersicht
Bedeutung Priorität
Verwendung optional
Typ Integer
Werte EVT_NORMAL
EVT_HIGH
Standard EVT_NORMAL

Über die Priorität bestimmen Sie, ob besondere Events verwandter Gliederungen angezeigt werden sollen.

Wenn Sie für die Priorität EVT_HIGH einstellen, werden auch Events der direkt untergeordneten Gliederungen sowie anderer Gliederungen der eigenen Region. Voraussetzung ist dabei, daß auch die Events eine hohe Priorität haben.

Folgende Konstanten stehen zur Verfügung:

  • EVT_NORMAL
    normale Priorität
  • EVT_HIGH
    hohe Priorität

[Bearbeiten] sort

Übersicht
Bedeutung Sortierung
Verwendung optional

Bestimmt die Sortierung der Ausgabe.
Noch nicht implementiert


[Bearbeiten] theme

Übersicht
Bedeutung Thema
Verwendung optional
Typ Integer
Werte siehe Verwaltungsbereich
Standard 0

Themen spezifizieren ein Event inhaltlich. Sie sind hierarchisch geordnet.

Die aktuell gültigen Werte finden Sie im Verwaltungsbereich unter dem Menupunkt Events → Konstanten.

[Bearbeiten] top

Übersicht
Bedeutung Anzahl übergeordneter
Gliederungs-Ebenen
Verwendung optional
Typ Integer
Werte pos. Zahlen
Standard 0

Anzahl der übergeordneten Gliederungs-Ebenen

Hiermit wird festgelegt, bis zu welcher übergeordneten Ebene Events angezeigt werden. Beispiel: Eine 1 bei der FDP Unterfranken zeigt auch Events der FDP Bayern mit an.

[Bearbeiten] type

Übersicht
Bedeutung EventTyp
Verwendung erforderlich
Typ Integer
Werte siehe Verwaltungsbereich
Standard 0

EventTypen bestimmen die grundlegende Darstellung eines Events (so haben z.B. News eine andere HTML-Struktur als Termine). Sie sind hierarchisch geordnet. Auf der obersten Ebene finden Sie die HauptTypen, die im Wesentlichen die Darstellung festlegen.

Die aktuell gültigen Werte finden Sie im Verwaltungsbereich unter dem Menupunkt Events → Konstanten.


[Bearbeiten] Fehlermeldungen

keine

[Bearbeiten] Technik

[Bearbeiten] HTML-Struktur

[Bearbeiten] CSS-Definitionen

#page
Seitennavigation
.event
Liste der Events
.pages
Anzeige der Seitenzahlen
.selector
Auswahl der Seitenzahlen
.stats
Seitenstatistik

[Bearbeiten] JavaScript

initPage

Meine Werkzeuge
Namensräume

Varianten
Aktionen
Navigation
Werkzeuge