Dokumentation contentXXL CMS Version 5.3

 

 
 

Allgemein

Mit dem Umfrage-Modul können Umfragen oder Abstimmungen / Bewertungen realisiert werden. Hierzu werden Themen und mögliche Antworten vorgegeben. Ein Nutzer kann für etwas abstimmen und danach (optional) das Gesamtergebnis sehen. Mehrfachabstimmung wird vom System verhindert.  Es können außerdem Inhalte wie z. B. Objekte des Newsmoduls (Artikel) bewertet werden (verknüpfte Umfrage).

Synonyme Bezeichnung: Voting.

 

Hinweis: Für das Modul sind Customization Points vorhanden. Detaillierte Informationen finden Sie im Support- und Partnerportal. Bitte beachten Sie auch die Dokumentation für Entwickler

 
 

Spezielle Einstellungen

Folgende spezielle Einstellungen können getroffen werden:

Verknüpftes Modul

  • Als verknüpftes Umfragemodul verwenden: Wenn diese Option aktiviert ist, wird die Umfrage im Sinne einer Bewertung mit einem Inhaltsobjekt in der Einzelansicht verknüpft.

Templates Einzelansicht: Hier werden die Templates für die Einzelansichten (Web und Druck) zugewiesen.

  • Detailansicht: Wählen Sie hier das gewünschte Template für die Detail- oder Einzelansicht der Umfrage aus.
  • Druckvorschau: Wählen Sie hier das gewünschte Template für die Druckansicht der Umfrage aus.

Templates Listenansicht:

  • Anzahl Vorschau groß: Anzahl der Elemente, die mit dem Template für „Vorschau groß“ in der Listenansicht angezeigt werden sollen.
  • Anzahl Spalten groß: Anzahl der Spalten, die mit dem Template für „Vorschau groß“ in der Listenansicht angezeigt werden sollen.
  • Vorschau groß: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht groß aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau klein ermöglicht die Priorisierung von Informationen durch einen Template-Wechsel nach einer bestimmten Anzahl von Elementen, beispielsweise in eine kleinere Darstellung.
  • Vorschau groß alternierend: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht groß alternierend aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau groß alternierend ermöglicht einen Darstellungs-Wechsel bei jeder Zeile, um beispielsweise die Lesbarkeit zu erhöhen.
  • Anzahl Vorschau klein: Anzahl der Elemente, die mit dem Template für „Vorschau klein“ in der Listenansicht angezeigt werden sollen.
  • Anzahl Spalten klein: Anzahl der Spalten, die mit dem Template für „Vorschau klein“ in der Listenansicht angezeigt werden sollen.
  • Vorschau klein: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht klein aus. Der Wechsel zwischen einem Template für Vorschau groß und Vorschau klein ermöglicht die Priorisierung von Informationen durch einen Template-Wechsel nach einer bestimmten Anzahl von Elementen, beispielsweise in eine kleinere Darstellung.
  • Vorschau klein alternierend: Wählen Sie hier das gewünschte Template für die Vorschau-/Listenansicht klein alternierend aus. Der Wechsel zwischen einem Template für Vorschau klein und Vorschau klein alternierend ermöglicht einen Darstellungs-Wechsel bei jeder Zeile, um beispielsweise die Lesbarkeit zu erhöhen.

Blättern in der Vorschau

  • Kopfbereich: Wählen Sie hier das gewünschte Template für den Kopfbereich der Vorschau-/Listendarstellung. Dort können beispielsweise Blätterfunktionen dargestellt werden.
  • Fußbereich: Wählen Sie hier das gewünschte Template für den Fußbereich der Vorschau-/Listendarstellung. Dort können beispielsweise Blätterfunktionen dargestellt werden.

Antworten Einstellungen

  • Antworten Listenansicht: Listenansichten von Antworten können ohne Tabellen (als Repeater) oder mit Tabellen (als Datalist) dargestellt werden. Wir empfehlen, im Sinne der Barrierefreiheit und der vollständigen Kontrolle über die Gestaltung, Listenansichten ohne Tabellen darzustellen – obwohl die Darstellung mit Tabellen oft einfacher zu templaten ist.
  • Einfach-Auswahl / Einfach-Auswahl alternierend: Ist für eine Umfrage nur eine Antwort erlaubt (Single Choice), werden hier die ensprechenden Templates ausgewählt (Verwendung von Radiobuttons).
  • Mehrfach-Auswahl / Mehrfach-Auswahl alternierend: Sind für eine Umfrage mehrere Antworten erlaubt (Multiple Choice), werden hier die ensprechenden Templates ausgewählt (Verwendung von Checkboxen).
  • Ergebnis / Ergebnis alternierend: Die Templates für die Ergebnisanzeige werden hier zugewiesen.

Erweiterte Einstellungen

  • Rotationsmodus: Ist dieser Modus gesetzt, werden ein oder mehrere (entsprechend der Anzahl Vorschau groß) zufällig ausgewählte Listenelemente dargestellt. Diese Funktionalität bedingt einen abgeschalteten Seiten-Cache für die jeweilige Seite.

Hinweis: Wir empfehlen statt dem Server-seitigen Rotationsmodus im Template per Javascript eine Client-seitige Liste aufzubauen. Dann kann das Caching erhalten bleiben.

  • Teasermodus: Ist dieser Modus gesetzt, wird die Einzelansicht des Objektes auf einer anderen Seite in einem anderen Modul (entsprechend der Ziel-ModulID) und auf einer anderen Seite (entsprechend der Ziel-SeitenID) geöffnet. Dieses Objekt muss dort ebenfalls veröffentlicht sein.
  • Ziel-ModulID / Ziel-SeitenID: Durch die Angabe von Ziel-ModulID und Ziel-SeitenID kann ein Öffnen für das angegebene Modul und die angegebene Seite erzwungen werden. Ansonsten wird eine beliebige weitere Veröffentlichung verwendet.
  • Feature-Modus: Ist dieser Modus gesetzt, wird der erste Artikel in der Liste in Einzelansicht geöffnet. Andere Objekte in dem Modul sowie andere Module auf der Seite können in diesem Modus nicht mehr dargestellt werden.

 

 

 

 
 

Template: Kopf

<TABLE align="center">
<TBODY>
<TR>
<TD><SPAN [mvif:FirstPage:neq:]><A href="[FirstPage]"><< </A></SPAN></TD>
<TD><SPAN [mvif:PreviousPage:neq:]><A href="[PreviousPage]">< </A></SPAN></TD>
<TD>Page [CurrentPageNumber] of [TotalPageCount]</TD>
<TD><SPAN [mvif:NextPage:neq:]><A href="[NextPage]">> </A></SPAN></TD>
<TD><SPAN [mvif:LastPage:neq:]><A href="[LastPage]">>> </A></SPAN></TD></TR></TBODY></TABLE>

 

Template: Element (Listenansicht)

<SCRIPT language=vb runat="server">
Sub Page_PreRender() 
if context.items("lang") = 1 then
Vote.Text = "Abstimmen »"
else
Vote.Text = "Vote »"
end if
End Sub
</SCRIPT>
 <DIV class=object_title_pos>
<DIV class=border_left[ci:theme]><A class=title_pos href="[morelink]">[Title]</A> [editbutton] </DIV>
<DIV class=title_pos>[answers]</DIV>
<DIV class=clear></DIV>
<DIV class=title_pos [mvif:preview:neq:]>[Preview]<BR></DIV>
<DIV class=title_pos [mvif:isClosed:eq:False]>[lbn:vote:text="Abstimmen »"]</DIV></DIV>

 

Template: Antwort (Einfach-Auswahl)

<div class="vote_answerlist>[rb:id:] [Title]</DIV>

 

Template: Antwort (Mehrfach-Auswahl)

<div class="vote_answerlist>[cb:id:] [Title]</DIV>

 

Template: Ergebnis

<div alt="""" class="vote_answerlist>[Title]" code="" height="11" img="" src=""[BarImageUrl]"" width="[imagedimension:10:200]>  ([VotesCount]">

 

 
 

Platzhalter:Antwort/Ergebnis

Platzhaltername

Typ

Platzhalterbeschreibung

[BarImageUrl]

string

Url der Grafik zur optischen Darstellung des Abstimmungsergebnisses.

[ImageDimension:minvalue:maxvalue]

integer

Der Platzhalter dient der Skalierung der verwendeten Grafik bei der Darstellung des Abstimmungsergebnisses. Die Größe der Grafik in Pixel errechnet sich aus dem angegebenen maxvalue multipliziert mit dem Quotienten aus der Zahl von Stimmen für die jeweilige Antwort und der Gesamtzahl der Antworten.

[ItemID]

integer

DatenbankID des Votings.

[Preview]

string

Vorschautext.

[SortOrder]

integer

Die Sortierreihenfolge der Antwort / des Ergebnisses.

[Title]

string

Die gestellte Frage.

[TotalVotesCount]

integer

Gesamtanzahl aller Stimmen für diese Umfrage.

[VotesCount]

integer

Gesamtanzahl aller Stimmen für diese Antwort.

[VotingAnswerID]

integer

DatenbankID der Antwort / des Ergebnisses.

[VotingItemID]

integer

DatenbankID des Votings.

[VotingLanguageID]

integer

Die LanguageID der Abstimmung (z.B. 1 für Deutsch, 2 für Englisch).

Anmerkung:
Um eine Antwort für das Voting zur Verfügung zu stellen zu können, benötigen Sie einen Radiobutton (Einfach-Auswahl) oder Checkboxen (Mehrfach-Auswahl), z. B. [rb:vote:] oder [cb:vote:].

 

 

Template: Einzelansicht

Platzhaltername

Typ

Platzhalterbeschreibung

[Answers]

control

Stellt das ausgewählte Antwort-Template dar.

[Author]

string

Ersteller der Umfrage.

[Description]

string

Textdaten (WYSIWYG).

[EditButton]

string

Schaltfläche, um die Umfrage im Objekt-Edit-Manager zu bearbeiten.

[ErrorCode]

integer

Fehlercode:
0 = OK
1 = Mehr Antworten müssen ausgewählt werden
2 = Es dürfen nur weniger Antworten ausgewählt werden

[ErrorMessage]

string

zugehörige Fehlermeldung.

[Headline]

string

Überschrift.

[ImageUrl]

string

Url des Vorschaubilds.

[IsClosed]

string

Gibt an, ob die Abstimmung beendet ist (Zeit abgelaufen oder User hat bereits abgestimmt).

[Keywords]

string

SEO-Keywords

[MaximumAnswers]

integer

Maximal erlaubte Zahl von Antworten.

[MinimumAnswers]

integer

Minimal erforderliche Zahl von Antworten.

[Preview]

string

Vorschautext.

[PreviewImage]

integer

RAID (RessourceAssignID) des Vorschaubilds.

[PrintLink]

string

Url zur Druckansicht.

[Title]

string

Titel der Umfrage.

[UserSetting1..5]

string

Benutzerdefinierte Felder.

Zum Absenden des Formulars kann jeder Button-Platzhalter (bn, lbn, ibn) mit der id="vote" oder dem Attribut CommandName="vote" verwendet werden.

 

Template: Kopfbereich

Platzhaltername

Typ

Platzhalterbeschreibung

[CurrentPageNumber]

integer

Aktuelle Seitennummer – Paging.

[FirstPage]

string

Url zur ersten Seite – Paging.

[IsListView]

string

Gibt an, ob sich das Modul in der Listenansicht befindet.

[LastPage]

string

Url zur letzten Seite – Paging.

[ModulePreview]

string

Vorschautext des Moduls.

[ModulePreviewImage]

string

Vorschaubild des Moduls (RAID).

[ModulePreviewImage_alt]

string

Textinformation zum Vorschaubild (Tooltip).

[NextPage]

string

Url zur nächsten Seite – Paging.

[PreviousPage]

string

Url zur vorherigen Seite – Paging.

[PrintLink]

string

Url zur Druckansicht.

[ReturnToListLink]

string

Url zurück zur Listenansicht.

[ReturnToOriginalListLink]

string


Url zurück zur Listenansicht (bei Paging der Einzelansicht).

[ShownFrom]

integer

Index des ersten Elements, das auf der aktuellen Seite angezeigt wird.

[ShownTo]

integer

Index des letzten Elements, das auf der aktuellen Seite angezeigt wird.

[TellAFrendLink]

string

Url zum Empfehlungs-Modul (Tell-a-Friend).

[TotalItemsCount]

ineger

Anzahl aller Elemente – Paging.

[TotalPageCount]

integer

Anzahl aller Seiten – Paging.

Anmerkung:
Sie können einen Button wie etwa [bn:vote:Text=“Vote“] statt im Listen- oder Einzelansichtstemplate im Kopftemplate einbauen. Dabei werden mit einem Klick alle auf der Seite veröffentlichten Umfragen des Moduls abgesendet.
Dieser Button muss auch hier entweder die ID “vote” besitzen wie im Beispiel oder das Attribut CommandName=“vote“ tragen.
Um einen solchen Button unsichtbar zu schalten, sobald alle Abstimmung geschlossen sind,  verwenden Sie folgendes Statement:

<DIV [mvifci:isallclosed:neq:True]>[bn:vote:Text="Vote"]</DIV>
 

 

Template: Element

Platzhaltername

Typ

Platzhalterbeschreibung

[Answers]

control

Stellt das ausgewählte Antwort-Template dar.

[Author]

string

Ersteller der Umfrage.

[Description]

string

Textdaten (WYSIWYG).

[EdiButton]

string

Schaltfläche, um die Umfrage im Objekt-Edit-Manager zu bearbeiten.

[ErrorCode]

integer

Fehlercode:
0 = OK
1 = Mehr Antworten müssen ausgewählt werden
2 = Es dürfen nur weniger Antworten ausgewählt werden

[ErrorMessage]

string

zugehörige Fehlermeldung.

[Headline]

string

Überschrift.

[ImageUrl]

string

Url des Vorschaubilds.

[IsClosed]

string

Gibt an, ob die Abstimmung beendet ist (Zeit abgelaufen oder User hat bereits abgestimmt).

[Keywords]

string

SEO-Keywords.

[MaximumAnswers]

integer

Maximal erlaubte Zahl von Antworten.

[MinimumAnswers]

integer

Minimal erforderliche Zahl von Antworten.

[Morelink]

string

Url zur Detailansicht.

[ObjectVotesAverage]

float

Durchschnittliche Bewertung. Dieser Platzhalter ist nur verfügbar bei "verknüpften Umfragen".

[ObjectVotesAverageInt]

integer

Der abgerundete Wert des Platzhalters [ObjectVotesAverage]. Dieser Platzhalter ist nur verfügbar bei "verknüpften Umfragen".

[ObjectVotesCount]

integer

Gesamtzahl der Stimmen. Dieser Platzhalter ist nur verfügbar bei "verknüpften Umfragen".

[Preview]

string

Vorschautext.

[PreviewImages]

integer

RAID (RessourceAssignID) des Vorschaubilds.

[Title]

string

Titel der Umfrage.

[Usersetting1...5]

string

Benutzerdefinierte Felder.

Zum Absenden des Formulars kann jeder Button-Platzhalter (bn, lbn, ibn) mit der id="vote" oder dem Attribut CommandName="vote" verwendet werden.

 

 
 

Das Basisdaten-Formular

 

Eine Umfrage wird als Objekt im Votingmodul veröffentlicht. Bitte beachten Sie bei der Erfassung die sehr wichtigen Umfrageeinstellungen im unteren Bereich des Formulars.

 


 

  • Titel: Tragen Sie hier das Thema der Umfrage ein (dieser Eintrag wird auch intern zur Identifikation des Objekts verwendet).
  • Kopfzeile: Tragen Sie hier gegebenfalls eine Kopfzeile zu der Umfrage ein (sofern vom Template unterstützt).
  • Vorschaubild: Auswahl / Ändern / Entfernen eines Bildes aus dem Ressourcen-Manager.
  • Vorschau: Tragen Sie hier gegebenfalls einen Vorschautext für die Umfrage ein (sofern vom Template unterstützt).
  • endet am: Tragen Sie hier das Datum ein, an dem die Umfrage enden soll. Nur während dieser Zeit ist es möglich, abzustimmen. Anschließend können die Umfrageergebnisse abgerufen werden.
  • Mehrfachantworten erlauben: Standardmäßig ist nur eine Antwort möglich. Wenn Sie dieses Klickfeld aktivieren, können bei der Antwort mehrere Checkboxen selektiert werden.
  • Min. Antworten erzwingen: Geben Sie hier optional eine Mindestzahl von Antworten ein. Beispiel: Wenn Sie hier 2 eintragen, muss der Benutzer mindestens 2 Antworten auswählen, damit das Formular abgeschickt wird.
  • Max. Antworten erlauben: Geben Sie hier optional eine Obergrenze für die Zahl von Antworten ein. Beispiel: Wenn Sie hier 2 eintragen, darf der Benutzer maximal 2 Antworten auswählen, damit das Formular abgeschickt wird.

 

Antworten

Die möglichen Antworten werden im zusätzlichen Register "Antworten" angelegt. Mit Klick auf "Neu" wird dazu ein neues Fenster geöffnet.

Wählen Sie zunächst die Sprache aus, für die die Antwort erfasst werden soll. Füllen Sie dann die Felder aus, die Sie im Template für Ihre Umfrage benötigen. "Wertung" ist ein Zahlenwert und kann genutzt werden, um einen Durchschnittswert aus dem Abstimmungsergebnis zu berechnen (das würde beispielsweise Sinn machen, wenn als mögliche Antworte eine Note zwischen eins und sechs vergeben werden kann). Sollen die Ergebnisse in einem Säulen- oder Balkendiagramm dargestellt werden, wählen Sie hier bitte eine geeignete Grafik aus dem Ressourcenmanager.

Die Liste der für die Umfrage verfügbaren Antworten kann mit den entsprechenden Pfeil-Buttons sortiert werden. Die jeweilige aktuelle Stimmenzahl wird angezeigt. Es besteht die Möglichkeit, das Abstimmungsergebnis auf den Ausgangswert zurückzusetzen.