Issue #3954 - Added option for showing mandatory field explanation on forms

Kernel/Config/Files/XML/Ticket.xml

@@ -15568,4 +15568,13 @@ Thanks for your help!
             </Hash>
         </Value>
     </Setting>
+
+    <Setting Name="Ticket::Frontend::AsteriskExplanation" Required="0" Valid="0">
+        <Description Translatable="1">Display a message explaining that the asterisk indicates mandatory fields.</Description>
+        <Navigation>Frontend::Base</Navigation>
+        <Value>
+            <Item ValueType="Checkbox">1</Item>
+        </Value>
+    </Setting>
+
 </otobo_config>

Kernel/Modules/AgentTicketActionCommon.pm

@@ -3215,6 +3215,13 @@ sub _Mask {
 
     # End Widget Article
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # get output back
     return $LayoutObject->Output(
         TemplateFile => $Self->{Action},

Kernel/Modules/AgentTicketBounce.pm

@@ -312,6 +312,13 @@ $Param{Signature}";
             );
         }
 
+        # explanatory message about asterisk
+        if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+            $LayoutObject->Block(
+                Name => 'AsteriskExplanation',
+            );
+        }
+
         # print form ...
         my $Output = $LayoutObject->Header(
             Value     => $Ticket{TicketNumber},
@@ -458,6 +465,13 @@ $Param{Signature}";
             $Param{InformationFormat}   = $Param{Body};
             $Param{InformSenderChecked} = $Param{InformSender} ? 'checked ' : '';
 
+            # explanatory message about asterisk
+            if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+                $LayoutObject->Block(
+                    Name => 'AsteriskExplanation',
+                );
+            }
+
             my $Output = $LayoutObject->Header(
                 Type      => 'Small',
                 BodyClass => 'Popup',

Kernel/Modules/AgentTicketCompose.pm

@@ -1807,7 +1807,7 @@ sub Run {
             }
         }
 
-        # build new repsonse format based on template
+        # build new response format based on template
         $Data{ResponseFormat} = $LayoutObject->Output(
             Template => $ResponseFormat,
             Data     => { %Param, %DataHTML },
@@ -2377,6 +2377,13 @@ sub _Mask {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # create & return output
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketCompose',

Kernel/Modules/AgentTicketCustomer.pm

@@ -277,6 +277,14 @@ sub Form {
         );
     }
 
+    # explanatory message about asterisk
+    my $ConfigObject = $Kernel::OM->Get('Kernel::Config');
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     $Output .= $LayoutObject->Output(
         TemplateFile => 'AgentTicketCustomer',
         Data         => \%Param

Kernel/Modules/AgentTicketEmail.pm

@@ -3704,6 +3704,13 @@ sub _MaskEmailNew {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # get output back
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketEmail',

Kernel/Modules/AgentTicketEmailOutbound.pm

@@ -2103,6 +2103,13 @@ sub _Mask {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # create & return output
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketEmailOutbound',

Kernel/Modules/AgentTicketEmailResend.pm

@@ -1239,6 +1239,13 @@ sub _Mask {
         push @{ $Param{AttachmentList} }, $Attachment;
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # Create & return output.
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketEmailResend',

Kernel/Modules/AgentTicketForward.pm

@@ -1991,6 +1991,13 @@ sub _Mask {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # create & return output
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketForward',

Kernel/Modules/AgentTicketMerge.pm

@@ -493,6 +493,13 @@ sub Run {
             );
         }
 
+        # explanatory message about asterisk
+        if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+            $LayoutObject->Block(
+                Name => 'AsteriskExplanation',
+            );
+        }
+
         $Output .= $LayoutObject->Output(
             TemplateFile => 'AgentTicketMerge',
             Data         => { %Param, %Ticket, %Article, }

Kernel/Modules/AgentTicketMove.pm

@@ -1723,6 +1723,13 @@ sub AgentMove {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketMove',
         Data         => {

Kernel/Modules/AgentTicketPhone.pm

@@ -3326,6 +3326,13 @@ sub _MaskPhoneNew {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # get output back
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketPhone',

Kernel/Modules/AgentTicketPhoneCommon.pm

@@ -1536,6 +1536,13 @@ sub _MaskPhone {
         );
     }
 
+    # explanatory message about asterisk
+    if ( $ConfigObject->Get('Ticket::Frontend::AsteriskExplanation') ) {
+        $LayoutObject->Block(
+            Name => 'AsteriskExplanation',
+        );
+    }
+
     # create & return output
     return $LayoutObject->Output(
         TemplateFile => 'AgentTicketPhoneCommon',