Kaetzchen: /* API-Funktionen */

2024-12-13T07:21:48Z

‎API-Funktionen

RMk am 18. Dezember 2006 um 16:37 Uhr

2006-12-18T16:37:45Z

Neue Seite

{{dolex-link}}

Die '''Startseitenfunktionen''' sind eine Reihe von Funktionen und Regelungen bei der Erstellung von Startseiten der [[Partei|Parteien]] und [[Initiativen]].

== Popups, DolLogo und Formales==

=== Popupfenster ===
[[Bild:Dollogo_gross.png|right|thumb|Geändertes DolLogo der Initiative Fußball Bundesliga Tipprunde]]

;<nowiki><a href="javascript:openPublicWin(dURL,wName,wWidth,wHeight,wParam);">Linktext</a>;</nowiki>
:Variablen
:dURL : zu öffnende URL
:wName : Name des Fensters
:wWidth : Breite des Fensters
:wHeight : Höhe des Fensters
:wParam : weitere Parameter zum Öffnen des Fensters

Bis auf dURL können alle anderen Variablen auch weggelassen werden.

=== Ersetzen des dolLogos ===

Das große dol2day Logo kann mit Hilfe dieses Befehls ersetzt werden.

* [setDolLogo='Imagepfad']

=== Formalia ===

* Keine HTML-Tags wie html, body oder title dürfen benutzt werden
* Am besten benutzt man eine Tabelle mit 600 Pixel Breite und steckt den Inhalt der Seite hinein. (siehe [http://www.dol2day.com/index.php3?position=2215&typ=ini_id&typ_id=2974&thread_id=148893&forum_id=5368 Tutorial für Initiativseitenbau])
* '''Wichtig''': Immer " und nicht ' benutzen!

<br>

== API-Funktionen ==

Die '''API-Funktionen''' (engl. Application Programming Interface) sind eine direkte Anbindung an die Datenbank von dol2day. Mit ihrer Hilfe kann man verschiedene Werte aus der Datenbank aufrufen und auf Startseiten von Initiativen oder Parteiseiten widergeben.

=== Liste der API Funktionen ===

;get_current_pid()
:Liefert die aktuelle Benutzer_id
;db_nickname(benutzer_id)
:Liefert den Nicknamen zur Benutzer_id samt aller Kennzeichnungen, wie z.B. der Vereinsmitgliedschaft (blaue Färbung) oder dem Moderator-Status
;db_nickname(benutzer_id, X)
:Wie db_nickname(benutzer_id), X wird ersetzt durch 1: ohne Kennzeichnung, 2: Nur Verein, 3: Nur Moderator
;db_benutzer_online(benutzer_id)
:Liefert den Onlinestatus zur Benutzer_id (Text: online/offline). [http://www.dol2day.com/index.php3?thread_id=147867&position=2215&referrer=2205&typ=ini_id&typ_id=2974&forum_id=5368 (Beispiel)]
;db_partei_kuerzel(partei_id)
:Liefert das Partei Kürzel (z.B. [[SIP]])
;db_partei_name(partei_id)
:Liefert den Partei Namen
;db_benutzer_id(nickname)
:Liefert die benutzer_id
;db_nickname(get_current_pid())
:Persönliche Begrüßung auf Partei- und Ini-Seiten
;db_online_anz(id,art)
:Liefert, wieviele Mitglieder aus Partei X oder Initiative Y online sind. Art muss ersetzt werden durch "p" für Parteien oder "i" für Initiativen
;db_mitglieder_online(id, art, anzeige, format)
:Gibt aus, welche Mitglieder online sind. Für "art" muss "p" für Parteien oder "i" für Initiativen angegeben werden. Bei "anzeige" kann man die Zahlen 0 bis 3 eintragen, damit legt man fest, ob die Nicknames mit Vereinskennzeichnung oder ohne, mit Moderatorenkügelchen oder ohne angezeigt werden. Bei "format" gibt es zwei Möglichkeiten derzeit: Ihr tragt eine 0 ein, dann werden die Namen einfach nacheinander ausgegeben. Oder ihr tragt eine 1 ein, dann werden die Namen in einer Tabelle untereinander ausgegeben.

== Tipps und Tricks ==

=== Eigene Offline/Online-Grafik für einzelne Mitglieder ===

<nowiki><img src="http://www.dein-webspace.de/db_benutzer_online(benutzer_id).gif"></nowiki> angeben und auf dem Webspace die Dateien offline.gif und online.gif ablegen (funktioniert mit beliebiger Datei-Endung). Durch die API-Funktion wird wie oben beschrieben der Text offline/online ausgegeben und der Browser gibt die entsprechende Datei wieder.

=== Offline/Online farblich hervorheben ===

Damit ein Link farblich verändert wird um den Offline/Online-Status eines Mitgliedes auszugeben muss der Link die Klasse "db_benutzer_online(benutzer_id)" bekommen.

;Beispiel:

<nowiki><a href="http://dol2day.com/..." class="db_benutzer_online(benutzer_id)">Linkname</a></nowiki>

Im Quelltext muss dann noch das CSS angegeben werden:

<nowiki><style>
.online:link { color: #000 }
.online:visited { color: #000 }
.online:hover { color: #666 }
</style></nowiki>

== Weblinks ==

* [http://www.dol2day.com/index.php3?position=14000&ini_id=3028 Initiative API-Funktionen (inklusive Demonstration)]
* [http://www.dol2day.com/index.php3?position=14000&ini_id=2974 Initiative Hilfe für Ini- und Parteiadmins (inklusive Tutorials)]
* [http://www.dol2day.com/index.php3?position=14000&ini_id=3654 Hilfsinitiative zur Gestaltung von Ini- und Parteiseiten ]

[[Kategorie:Technik]]

@@ Zeile 35: / Zeile 35: @@
 == API-Funktionen ==
-Die '''API-Funktionen''' (engl. Application Programming Interface) sind eine direkte Anbindung an die Datenbank von dol2day. Mit ihrer Hilfe kann man verschiedene Werte aus der Datenbank aufrufen und auf Startseiten von Initiativen oder Parteiseiten widergeben.
+Die '''API-Funktionen''' (engl. Application Programming Interface) sind eine direkte Anbindung an die Datenbank von dol2day. Mit ihrer Hilfe kann man verschiedene Werte aus der Datenbank aufrufen und auf Startseiten von Initiativen oder Parteiseiten wiedergeben.
 === Liste der API Funktionen ===

Startseitenfunktionen - Versionsgeschichte

Kaetzchen: /* API-Funktionen */

RMk am 18. Dezember 2006 um 16:37 Uhr