Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- de:create:functions:pagestop [13.05.2019 21:30] – admin
+++ de:create:functions:pagestop [19.01.2025 10:58] (aktuell) – admin
@@ Zeile 8: / Zeile 8: @@
-===== Beispiel =====
+===== Beispiel: Screenout =====
 Im folgenden Beispiel wird ''pageStop()'' im Zusammenspiel mit einem Screen-Out Filter verwendet. So können auf der Screen-Out Seite noch weitere Inhalte (z.B. Fragen) platziert werden.
@@ Zeile 18: / Zeile 18: @@
 <code php>
 if ((value('SK01') == 1) or (value('SK01') == 7)) {
-  text('screenout');
+  text('screenout');  // Text zum Screenout anzeigen
-  buttonHide();
+  buttonHide();  // Weiter-Knopf ausblenden
-  pageStop();
+  setStatus('screenout'); // Status im Datensatz vermerkten
+  pageStop();  // Keine weiteren Inhalte auf der Seite anzeigen oder ausführen
 }
 </code>
-Ohne ''pageStop()'' müsste man die weiteren Element in den Filter aufnehmen...
+**Wichtig:** Der Text "screenout" darf nur über den PHP-Code in die Fragebogen-Seite eingebunden werden. Ziehen Sie den Text __nicht__ zusätzlich noch in die Seite.
+===== Beispiel: Zeitraum einschränken =====
+Mitunter verwendet man im Befragungsprojekt mehrere Fragebögen -- und nicht alle sollen für den selben Zeitraum verfügbar sein. Zugleich lässt sich in den **Projekt-Einstellungen** nur ein Befragungszeitraum für das gesamte Befragungsprojekt festlegen.
+Mit einem kleinen PHP-Filter auf der ersten Seite des Fragebogens können Sie festlegen, dass außerhalb eines definierten Zeitraums nur eine Fehlermeldung angezeigt wird.
+Legen Sie im **Fragenkatalog** in einer Rubrik Ihrer Wahl einen neuen Text an. Im folgenden Beispiel wird davon ausgegangen, dass der Text die Kennung TX02 hat. Der folgende PHP-Code sorgt dafür, dass der Fragebogen nur im Zeitraum zwischen dem 01.04.2021 und dem 30.06.2021 ausgefüllt werden kann.
 <code php>
-if ((value('SK01') == 1) or (value('SK01') == 7)) {
+if ((time() < strtotime('2021-04-01')) || (time() >= strtotime('2021-07-01'))) {
-  text('screenout');
+  text('TX02');
   buttonHide();
-} else {
+  pageStop();
-  question('AB01');
-  question('AB02');
 }
 </code>
-... oder man würde die Inhalte auf eine zusätzliche Seite (nach der aktuellen) legen, sodass auf der Seite keine Inhalte mehr folgen.
+Der in den Projekt-Einstellungen festgelegte Befragungszeitraum muss vor dem 1.4.2021 starten und/oder nach dem 30.06.2021 enden, damit der Filter aktiv werden kann.
+Genauso kann man einschränken, dass der Fragebogen nur in einem bestimmten Zeitfenster ausgefüllt werden kann. Der folgende PHP-Code erlaubt das Ausfüllen nur von 9 bis 11 Uhr.
 <code php>
-if ((value('SK01') == 1) or (value('SK01') == 7)) {
+if ((date('h') < 9) || (date('h') > 11)) {
-  text('screenout');
+  text('TX02');
   buttonHide();
-} else {
+  pageStop();
-  goToPage('next');
 }
 </code>