(Opens in a new window - öffnet in einem neuen Fenster)
Kurz-Dokumentation Polls Plugin
Version Polls 1.0 - released 01/2020
Polls ist ein CMSimple Plugin, mit dem Umfragen auf CMSimple Seiten durchgeführt erden können. Es basiert auf dem Script LittlPoll » - vielen Dank an den unbekannten Schöpfer.
1. Systemvoraussetzungen
Voraussetzung ist eine funktionierende Installation von CMSimple 4.2 oder höher, empfohlen wird die aktuelle Version von CMSimple »
2. Installation
- zip-Datei herunterladen und mit einem geeigneten Programm entpacken
-
- Laden Sie die komplette Ordner-Struktur des Verzeichnisses "CMSimpleRoot" (die Verzeichnisse "plugins" und "content") in das Installationsverzeichnis von CMSimple hoch.
- Ihr ftp Programm wird evtl. merken, dass es diese Verzeichnisse bereits gibt, und Sie fragen, ob Sie das wirklich tun wollen. Beantworten Sie diese Frage einfach mit "ja", "ok" oder was immer Ihr ftp Programm anbietet.
- Bei einem Update laden Sie einfach den Ordner "content" nicht mit hoch.
- Vergeben Sie mit Ihrem ftp-Programm die erforderlichen Lese- und Schreibrechte für Ordner und Dateien.
Vor einem Update erstellen Sie unbedingt eine Sicherheitskopie des alten Plugins, damit Sie eventuelle Änderungen/Ergänzungen an der stylesheet.css, der Konfiguration und den Sprachdateien wieder herstellen können.
3. Datei- und Ordnerrechte
Damit das Programm funktioniert und arbeiten kann (bzw. administrierbar ist), müssen auf manchen Servern für bestimmte Dateien und Ordner Schreib- und Leserechte vergeben werden.
Dateien: chmod 666
- ./plugins/polls/languages/alle Dateien
- ./plugins/polls/config/config.php
- ./plugins/polls/css/stylesheet.css
- In allen Polls-Ordnern unter ./content/plugins/polls/ die Dateien lp_data.txt, lp_ip.dat und lp_settings.php
Ordner: chmod 777
- ./plugins/polls/languages/
- ./content/plugins/polls/
- ./content/plugins/polls/alle Ordner/
Auf den meisten modernen Servern ist das jedoch nicht notwendig.
4. Die Plugin Aufrufe
4.1 Einfacher Pluginaufruf
Pluginaufruf im Inhalt:
{{{plugin:poll_iframe('Ordnername');}}}
Pluginaufruf im Template:
<?php echo poll_iframe('Ordnername'); ?>
Ordnername: Der Name des Ordners der Umfrage. Die verfügbaren Ordner (Umfragen) finden Sie unter./content/plugins/polls/ oder im Backend in der Auswahlbox.
Im Backend kann man die Vorlagen kopieren und in einer Textarea bearbeiten. Die Ordnernamen der Vorlagen beginnen mit einem Unterstrich (_ordnerame).
Benutzen Sie auf keinen Fall die Vorlagen produktiv, sondern nur als Kopiervorlagen oder zu Testzwecken.
Ihre eigenen Umfragen sollten Kopien dieser Vorlagen sein und keinen Unterstrich am Anfang haben.
4.2 Erweiterter Pluginaufruf
Polls berechnet die Höhe des iFrames automatisch. Sollten trotzdem vertikale Scrollbalken auftreten, können Sie den erweiterten Pluginaufruf verwenden. Ein zweiter (optionaler) Parameter erweitert die Höhe des iFrames.
Pluginaufruf im Inhalt:
{{{plugin:poll_iframe('Dateiname','heightPlus');}}}
Pluginaufruf im Template:
<?php echo poll_iframe('Dateiname','heightPlus'); ?>
- Dateiname: Der Name der Datei ohne Dateiendung.
- heightPlus (optional): Erweiterung der Höhe des iFrames in px (Angabe ohne px). Standardwert ist 36.
5. Subsites und Zweitsprachen
Die Datendateien liegen normalerweise im Ordner content/plugins/polls/ der Hauptseite, auch für Subsites oder Zweitsprachen.
Wenn Sie jedoch in einer Subsite oder Zweitsprache einen Ordner ./content/plugins/polls/ anlegen, sucht das Plugin die Datendateien in diesem Ordner. Das ist vor allem in Zweitsprachen sinnvoll, da in den Datendateien auch der Titel des Diagramms und die Beschriftungen enthalten sind.