BY:PirateStarter/Einbinden

Aus Piratenwiki
Wechseln zu: Navigation, Suche

Diese Seite beschreibt im Detail, wie man PiratStarter mittels iframe in Webseiten einbindet.

Es gibt einen Assistenten unter http://www.piratestarter.de/technik/ fürs schnelle Einbinden.

ACHTUNG: PirateStarter ist noch in der Entwicklung. Daher ist auch dieser Text noch nicht fertig.

Voraussetzungen: iframe

Mittels des HTML-Tags iframe lassen sich ganze Webseiten in andere einbinden. PirateStarter wird ebenfalls so eingebunden.

Wenn Du in Deine Webseiten PirateStarter einbinden willst, musst Du lediglich ein iframe mit der entsprechenden Adresse einsetzen.

Beispiel: <iframe src=

https://stuke9.piratenpartei-bayern.de:443/starter.html?myid=KV_Irgendwo&betrag=42&zwecke=Plakate%20Irgendstadt,Podiumsdiskussionen,Sommerfest
https://stuke9.piratenpartei-bayern.de:443/starter.html?myid=KV_Irgendwo&betrag=42&zwecke=Plakate%20Irgendstadt,Podiumsdiskussionen,Sommerfest 
mit den Variablen
• myid=KV_Irgendwo
• betrag=42
• zwecke=Plakate%20Irgendstadt,Podiumsdiskussionen,Sommerfest

Hierbei wird mittels myid angegeben, wer da sammelt, und es wird per zwecke angegeben, wofür Mensch spenden kann, mehrere durch Kommas getrennt (Leerzeichen müssen durch die Zeichenfolge %20 ersetzt werden). Die beiden Variablen müssen angegeben werden, myid kannst Du Dir selbst geben, es sollte z.B. die Domain sein um einzigartig zu sein. Der Standardwert für betrag ist 25 und kann weggelassen werden.

HINWEIS: Da es sich um einen https-Aufruf handelt, bei dem das Zertifikat u.U. manuell bestätigt werden muss, kann es dazu kommen, dass PirateStarter nicht richtig im iframe angezeigt wird. Es empfiehlt sich daher, die Möglichkeit anzubieten, PirateStarter direkt zu öffnen (in einem separaten Fenster/Tab).

Einbinden in Wordpress

Aus Sicherheitsgründen blockiert Wordpress das HTML-Tag iframe. Daher bedarf es eines Plugins, um PirateStarter im Wordpress einzubinden.

Das simpelste und auch flexibelste iframe-Plugin für Wordpress heißt auch so: iframe.

Es kann in Seiten direkt und mittels des Text-Widgets auch in Sidebars platziert werden.

Ebenso kann, je nach Theme, auch das PlugIn iframe-Widget interessant sein. Hierbei muss man jedoch die Adresse anpassen, was zu Konflikten führen kann.

Anzeigen...

...in der Seitenleiste

Ist das iframe Widget installiert, dann steht dieses unter Design->Widgets zur Verfügung. Hier kann es in die Seitenleiste gezogen werden. Empfohlene Einstellungen sind

...in Seiten oder Beiträgen

Um den Text in Seiten einzubinden, wird folgender Code verwendet:

[dciframe]https://stuke9.piratenpartei-bayern.de:443/starter.html?myid=pageid,650,200,0,no[/dciframe]

Welche Varianten für width und height verwendet werden können, kann unter https://stuke9.piratenpartei-bayern.de/ nachgeschlagen werden.

Warum die Angabe des Ports 443?

Eigentlich sollte diese Angabe doch überflüssig sein? Schließlich ist 443 der Standardport für https. Aber aus irgend einem Grund wird beim Aufbau des Widgets manchmal auf http Port 80 umgeschaltet, wenn der Port nicht explizit festgelegt wurde. Im Ergebnis kommt dann unsere Kandidatenseite zum Vorschein.

Was ist die myid?

Die myid identifiziert die Webseite, welche das Modul einbindet. Die Angabe ist freiwillig, hilft aber statistische Auswertungen über die Verteilung der Spenden zu machen und kann durch so gewonnene Erkenntnisse dazu beitragen den Erfolg von PirateStarter zu erhöhen.

Als Wert für die myid eignet sich der Name der jeweiligen Gliederung oder die Nummer eines Stimm- oder Wahlkreises, aber auch der Name eines Kandidaten. Das muss kein Klarname sein. Ein eigens gewähltes Pseudonym ist hier genauso gut. Damit erkennt man sich bei einer Auswertung genauso gut wieder, wird aber nicht von anderen erkannt.

Weitere Parameter

Nach der Angabe der myid können weitere Parameter angegeben werden

  • betrag=zahl setzt den Startbetrag fest, der angezeigt werden soll.
  • zwecke=Zweck1,Zweck2,... fügt eine Auswahl von Spendenzwecken hinzu. Leerzeichen müssen dabei allerdings durch %20 ersetzt werden.

Um mehrere Parameter aneinander zu hängen werden diese mit einem & verbunden.

Beispiel: "https://stuke9.piratenpartei-bayern.de:443/starter.html?myid=KV_Irgendwo&betrag=42&zwecke=Plakate%20Irgendstadt,Podiumsdiskussionen,Sommerfest"

Weitere Fragen?

Falls Fragen auftreten, dann stehe ich gerne durch den Form Mailer unter meiner Benutzerseite zur Verfügung.