BayernSPD News-Modul

Das News-Modul der Bayern-SPD erlaubt euch, unsere aktuellen News ohne Programmierkenntnisse in eure eigene Website einzubinden. Ihr müsst lediglich zwei Zeilen HTML-Code in eure Website kopieren:

          <script type="text/javascript" charset="utf-8" src="http://bayernspd.de/newsmodul/"></script>
<div id="bayernspdnews-container"></div>

Die erste Zeile kann auch im Kopfbereich (also zwischen <head> und </head>) eures HTML-Dokuments stehen. Die zweite Zeile ist ein "Platzhalter" – wo diese Zeile steht, werden die News erscheinen!

Dies ist das einfachste Beispiel. Es gibt verschiedene Varianten dieses Codes, um das Newsmodul in jede Website passend zu integrieren. Rechts seht ihr z.B einen News-Kasten mit einer Breite von 250 Pixeln, der von diesem Text umflossen wird. Damit ihr sehen könnt, was möglich ist, haben wir Beispielseiten gebaut, auf denen auch der jeweils benötigte Code zu finden ist. Ihr könnt den Code aus diesen Beispielseiten herauskopieren und sofort loslegen – weiter unten finden sich dann noch Erklärungen für jene, die es ganz genau wissen möchten.

Ihr habt folgende Möglichkeiten:

Newsbereich mit zwölf Newsmeldungen und voller Breite (Beispiel 1)
Newsbereich mit einer begrenzten Anzahl an Newsmeldungen (Beispiel 2)
Newsbereich mit einer festgelegten Breite, der links steht und vom restlichen Inhalt der Seite umflossen wird (Beispiel 3)
wie Beispiel 3, jedoch rechts platziert (Beispiel 4)
Kombination aus allen Möglichkeiten (Beispiel 5)

Verfügbare Parameter

Wie man in den Beispielen sieht, kann das Erscheinungsbild des Newsmoduls durch so genannte Parameter verändert werden, die man an die Adresse (URL) des Newsmoduls anhängt. Die "Grundadresse" des Moduls – die immer im Code auftaucht – ist:

          http://bayernspd.de/newsmodul/

An diese URL kann man verschiedene "Parameter" anhängen, um das Newsmodul zu konfigurieren:

width – das ist die Breite des Newsmoduls; sie kann durch eine Zahl (in Pixeln) oder einen Prozentsatz angegeben werden; die Voreinstellung ist 100%, deshalb nimmt das Modul immer die ganze verfügbare Breite ein, wenn man die Breite nicht ausdrücklich angibt;
Beispiel: width=300
align – das ist die Platzierung des Newsmoduls (die sich natürlich nur bei einer Breite kleiner als 100 Prozent auswirkt); man kann die Werte left (links) oder right (rechts) angeben; die Voreinstellung ist "links";
Beispiel: align=right
limit – damit wird die Anzahl der Newsmeldungen begrenzt; erlaubt ist jede positive, ganze Zahl – allerdings beschränken wir die Auslieferung auf zwölf Newsmeldungen; sinnvoll sind also nur Zahlen von 1 bis 11;
Beispiel: limit=6
style – wenn man diesem Parameter den Wert compact zuweist, wird das Aussehen des Newsmoduls für besonders schmale Bereiche (z.B. die rechte Seitenspalte im alten dreispaltigen BayernSPD-Layout) optimiert; in diesem Fall ist die Schriftgröße kleiner, der blaue Kopfbalken füllt die Breite komplett aus, und die Aufzählungszeichen vor den Meldungen entfallen zugunsten breiterer Textabsätze;
Beispiel: style=compact
linkstyle – mit diesem Parameter kann das Erscheinungsbild der verlinkten Texte im Newslettermodul verändert werden; wenn man den Wert bayernspd zuweist, erscheinen die Links so wie auf der aktuellen BayernSPD-Website, also unterstrichen und mit roter Schrift; das ist sinnvoll, wenn man das Newsmodul in das Layout der BayernSPD oder eine ähnliche Optik einbindet;
Beispiel: linkstyle=bayernspd

Parameter werden mit einem Fragezeichen angehängt. Wenn man z.B. nur 5 Newsmeldungen anzeigen möchte, schreibt man:

          http://bayernspd.de/newsmodul/?limit=5

Für eine Breite von 300 Pixeln schreibt man:

          http://bayernspd.de/newsmodul/?width=300

Wenn man zwei oder mehr Parameter übergeben will, trennt man die einzelnen Parameter mit dem Zeichen &, oder noch besser (weil XHTML-konform) mit dem codierten Zeichen & – zum Beispiel:

          http://bayernspd.de/newsmodul/?limit=7&amp;width=300&amp;align=right

Die Reihenfolge der Parameter spielt keine Rolle!

Technische Erläuterung (nicht wichtig für die Nutzung!)

Das Newsmodul der BayernSPD funktioniert so ähnlich wie Google-Anzeigen. Duch ein so genanntes JavaScript werden die Inhalte (also der Kasten mit den Newsmeldungen) in eine bestehende Website geschrieben. Der Clou dabei ist, dass dieses Script erst dann auf unserem Server erzeugt wird, wenn es aufgerufen wird – es enthält also automatisch die neuesten Newsmeldungen.

Die Lösung mit einem JavaScript hat verschiedene Vorteile:

das Script lässt sich in jede Website einbinden, unabhängig von der Technik des Webservers und der Website; das ist entscheidend, weil die Websites der BayernSPD-Ortsvereine ganz unterschiedliche Technik benutzen;
das Script ist sehr kurz und kann einfach kopiert werden;
da das Script vom Server der BayernSPD geladen wird, können wir es jederzeit verbessern, ohne dass der Code auf allen Websites geändert werden müsste;
das JavaScript lädt automatisch eine ebenfalls dynamisch erzeugte CSS-Datei, die für das Design der News-Kastens verantwortlich ist; auch darum müsst ihr euch also nicht kümmern;

Wenn es euch interessiert, könnt ihr euch Beispiele der dynamisch erzeugten Dateien unter den folgenden Links ansehen. Ihr könnt auch die Parameter in der Adresszeile eures Browsers verändern und testen, was herauskommt…

JavaScript-Datei: http://bayernspd.de/newsmodul/?limit=6&width=300&align=right
CSS-Datei: http://bayernspd.de/newsmodul-css/?width=300&align=right