Hide last authors
gru 10.3 1 [[**Plugin download**>>url:https://customer.formcycle.eu/index.php/apps/files/?dir=/FORMCYCLE%20-%20Plugins%20Customer/plugin-bundle-widget-xrating&fileid=17292||target="_blank"]] (requires login)
gru 1.1 2
3 {{content/}}
4
gru 6.2 5 {{panel float="right"}}
gru 6.3 6 (% class="block text-align-center%){{icon name="star" size="4x"/}}
gru 1.1 7
gru 10.3 8 (% class="block%)The icon for widgets of type //Rating//.
gru 6.2 9 {{/panel}}
10
11
gru 10.3 12 == Overview ==
gru 6.2 13
gru 10.3 14 {{figure image="2_WidgetXrating_Formular_de.png" clear="h3"}}The rating plugin adds a list of icons where the user can choose a rating by clicking on one of the icons.{{/figure}}
gru 6.2 15
gru 10.3 16 This plugin adds a new form widget that is available in the {{designer/}}. It lets the user choose a rating by clicking on the appropriate number of icons. You can change the number of icons as well as the icon type and color in the properties panel to the right of the {{designer/}}. When the user selects a rating, that rating is transmitted to the server as the value of the rating form field. You can also configure that value in the {{designer/}}.
gru 1.1 17
gru 10.3 18 == Installing ==
gru 1.1 19
gru 10.3 20 Install the plugin as a client or system plugin. You can find a tutorial on how to install plugins here: [[here>>doc:Formcycle.UserInterface.Client.Plugins.WebHome]].
gru 1.1 21
gru 10.3 22 == Settings ==
gru 1.1 23
gru 10.3 24 This widget offers the following settings in the properties panel to the right of the {{designer/}}:
gru 1.1 25
26 {{internBaseOptionsElement page="base" headline="h3"/}}
27
gru 6.6 28 {{internBaseOptionsElement page="label" headline="h3"/}}
29
gru 10.3 30 === Options ===
gru 6.6 31
gru 10.3 32 {{figure image="3_WidgetXrating_Optionen_de.png" clear="h3"}}Sample configuration for a rating plugin.{{/figure}}
gru 6.8 33
gru 10.3 34 Rating element have ad additional options section. Here you can select the number of icons and enter the value that is submitted when the user chooses a rating.
gru 6.6 35
gru 10.3 36 You can either enter this data manually, or select a [[CSV data source>>doc:Formcycle.UserInterface.Data.Sources.WebHome]] that contains the available ratings and the corresponding value.
gru 6.6 37
gru 1.1 38 {{internBaseOptionsElement page="cond" headline="h3"/}}
39
40 {{internBaseOptionsElement page="help" headline="h3"/}}
41
42 {{internBaseOptionsElement page="css" headline="h3"/}}
43
44 {{internBaseOptionsElement page="attr" headline="h3"/}}
45
46 {{internBaseOptionsElement page="avail" headline="h3"/}}
47
48 {{internBaseOptionsElement page="misc" headline="h3"/}}
49
gru 10.3 50 == Word and PDF export ==
gru 1.1 51
gru 10.3 52 {{figure image="4_WidgetXrating_Export_de.png" clear="h3"}}Layout of a rating widget when the form is exported as a Word or PDF document{{/figure}}
gru 1.1 53
gru 10.3 54 When the form is exported as a Word or PDF document, rating element are displayed like normal select elements with the configured options.
gru 1.1 55
gru 10.3 56 == CSS layout ==
gru 1.1 57
gru 10.3 58 You can adjust the layout of the icons and the colors via custom CSS.
gru 1.1 59
gru 10.3 60 For example, if you would like to change the third icon of the rating element with the name //rate1//:
61
gru 1.3 62 {{code language="css"}}
gru 10.3 63 [xn=rate1] .idx3 i::before{
64 content: "\e906";
gru 1.1 65 }
gru 1.3 66 {{/code}}
gru 1.1 67
gru 10.3 68 To change the color of the sixth icon for the rating element with the name //rate2// (only when it is active or the user hovers over the icon):
gru 1.3 69
70 {{code language="css"}}
gru 10.3 71 [xn=rate2] .idx6.hover i,
72 [xn=rate2] .idx6.active i {
73 color: #55C937;
gru 1.1 74 }
gru 1.3 75 {{/code}}
gru 1.1 76
77 {{velocity}}
78 ##{{content moveToTop="true"/}}
gru 10.3 79 ##{{figure image="1_WidgetXrating_Designer_de.png" clear="h1"}}The icon for form widgets of type //Rating//.{{/figure}}
gru 1.1 80 {{/velocity}}
Copyright 2000-2024