Added STATE_DESCRIPTIONS container type and state_descriptions campaign and in-group settings, change year to 2024

git-svn-id: svn://192.168.202.10@3804 3d104415-ff17-0410-8863-d5cf3c621b8a

agc_2-X/trunk/docs/GATEWAY_RECORDING_SERVER.txt

@@ -1,4 +1,4 @@
-VICI RECORDING GATEWAY SERVER	Started: 2023-01-14	Updated: 2024-02-13
+VICI RECORDING GATEWAY SERVER	Started: 2023-01-14	Updated: 2024-02-14
 
 
 
@@ -10,6 +10,8 @@ For outbound calls, the gateway recordings can be tied to the original Lead ID a
 
 For inbound calls, the gateway recordings can be tied to the original DID Log entry and UniqueID of the call on the VICIdial system. Depending on how complex the inbound call routing is, the gateway recording may also be able to be tied to a Lead ID.
 
+To view the Inbound and Outbound Gateway recordings in your VICIdial web admin screens, add a user with the ID of "GATEWAY" and the recordings will show up under that user.
+
 
 
 New scripts added:

agc_2-X/trunk/extras/MySQL_AST_CREATE_tables.sql

@@ -1123,7 +1123,8 @@ manual_vm_status_updates ENUM('ENABLED','DISABLED') default 'ENABLED',
 force_per_call_notes ENUM('DISABLED','ENABLED','5_CHARACTERS','15_CHARACTERS','30_CHARACTERS','100_CHARACTERS') default 'DISABLED',
 agent_search_ingroup_list ENUM('DISABLED','ENABLED','ENABLED_OVERRIDE') default 'DISABLED',
 hopper_hold_inserts ENUM('ENABLED','DISABLED') default 'DISABLED',
-daily_phone_number_call_limit TINYINT(3) UNSIGNED default '0'
+daily_phone_number_call_limit TINYINT(3) UNSIGNED default '0',
+state_descriptions VARCHAR(40) default '---DISABLED---'
 ) ENGINE=MyISAM;
 
 CREATE TABLE vicidial_lists (
@@ -1448,7 +1449,8 @@ third_alert_filename VARCHAR(100) default '',
 third_alert_delay INT(6) default '1000',
 third_alert_container VARCHAR(40) default 'DISABLED',
 third_alert_only VARCHAR(40) default 'DISABLED',
- agent_search_list VARCHAR(20) default ''
+agent_search_list VARCHAR(20) default '',
+state_descriptions VARCHAR(40) default '---DISABLED---'
 ) ENGINE=MyISAM;
 
 CREATE TABLE vicidial_stations (
@@ -5575,4 +5577,4 @@ INSERT INTO `wallboard_reports` VALUES ('AGENTS_AND_QUEUES','Agents and Queues',
 
 UPDATE system_settings set vdc_agent_api_active='1';
 
-UPDATE system_settings SET db_schema_version='1706',db_schema_update_date=NOW(),reload_timestamp=NOW();
+UPDATE system_settings SET db_schema_version='1707',db_schema_update_date=NOW(),reload_timestamp=NOW();

agc_2-X/trunk/extras/upgrade_2.14.sql

@@ -2597,3 +2597,9 @@ UPDATE system_settings SET db_schema_version='1705',db_schema_update_date=NOW()
 ALTER TABLE vicidial_qc_agent_log ADD qc_log_id INT(10) UNSIGNED;
 
 UPDATE system_settings SET db_schema_version='1706',db_schema_update_date=NOW() where db_schema_version < 1706;
+
+ALTER TABLE vicidial_campaigns ADD state_descriptions VARCHAR(40) default '---DISABLED---';
+
+ALTER TABLE vicidial_inbound_groups ADD state_descriptions VARCHAR(40) default '---DISABLED---';
+
+UPDATE system_settings SET db_schema_version='1707',db_schema_update_date=NOW() where db_schema_version < 1707;

agc_2-X/trunk/www/agc/vdc_db_query.php

@@ -2370,7 +2370,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 
 		$local_call_time='24hours';
 		##### gather local call time, user_group_script settings from campaign
-		$stmt="SELECT local_call_time,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five FROM vicidial_campaigns where campaign_id='$campaign';";
+		$stmt="SELECT local_call_time,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions FROM vicidial_campaigns where campaign_id='$campaign';";
 		$rslt=mysql_to_mysqli($stmt, $link);
 			if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00353',$user,$server_ip,$session_name,$one_mysql_log);}
 		if ($DB) {echo "$stmt\n";}
@@ -2385,6 +2385,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 			$camp_custom_three =		$row[4];
 			$camp_custom_four =			$row[5];
 			$camp_custom_five =			$row[6];
+			$state_descriptions =		$row[7];
 			}
 
 		$stmt="SELECT user_group,territory FROM vicidial_users where user='$user';";
@@ -4566,7 +4567,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 			if ( (strlen($preview)<1) or ($preview == 'NO') or (strlen($dial_ingroup) > 1) )
 				{
 				$use_custom_cid='N';
-				$stmt = "SELECT use_custom_cid,manual_dial_hopper_check,start_call_url,manual_dial_filter,use_internal_dnc,use_campaign_dnc,use_other_campaign_dnc,cid_group_id,scheduled_callbacks_auto_reschedule,dial_timeout_lead_container,manual_dial_cid,daily_call_count_limit,daily_limit_manual,call_limit_24hour_method,call_limit_24hour_scope,call_limit_24hour,call_limit_24hour_override,cid_group_id_two,daily_phone_number_call_limit FROM vicidial_campaigns where campaign_id='$campaign';";
+				$stmt = "SELECT use_custom_cid,manual_dial_hopper_check,start_call_url,manual_dial_filter,use_internal_dnc,use_campaign_dnc,use_other_campaign_dnc,cid_group_id,scheduled_callbacks_auto_reschedule,dial_timeout_lead_container,manual_dial_cid,daily_call_count_limit,daily_limit_manual,call_limit_24hour_method,call_limit_24hour_scope,call_limit_24hour,call_limit_24hour_override,cid_group_id_two,daily_phone_number_call_limit,state_descriptions FROM vicidial_campaigns where campaign_id='$campaign';";
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00313',$user,$server_ip,$session_name,$one_mysql_log);}
 				if ($DB) {echo "$stmt\n";}
@@ -4593,6 +4594,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 					$call_limit_24hour_override =			$row[16];
 					$cid_group_id_two =						$row[17];
 					$daily_phone_number_call_limit =		$row[18];
+					$state_descriptions =					$row[19];
 					}
 
 				### BEGIN check for Dial Timeout Lead Override ###
@@ -5806,7 +5808,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 				}
 			##### END if NOT preview dialing, send the call #####
 
-			$stmt = "SELECT campaign_script,campaign_script_two,browser_alert_sound,browser_alert_volume from vicidial_campaigns where campaign_id='$campaign';";
+			$stmt = "SELECT campaign_script,campaign_script_two,browser_alert_sound,browser_alert_volume,state_descriptions from vicidial_campaigns where campaign_id='$campaign';";
 			if ($DB) {echo "$stmt\n";}
 			$rslt=mysql_to_mysqli($stmt, $link);
 				if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00623',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -5818,6 +5820,7 @@ if ($ACTION == 'manDiaLnextCaLL')
 				$VDCL_campaign_script_two =		$row[1];
 				$VDCL_browser_alert_sound =		$row[2];
 				$VDCL_browser_alert_volume =	$row[3];
+				$state_descriptions =			$row[4];
 				}
 
 			##### find if script contains recording fields
@@ -5997,6 +6000,57 @@ if ($ACTION == 'manDiaLnextCaLL')
 					}
 				}
 
+			$state_color='';
+			$state_name='';
+			$state_debug='';
+			if ( (strlen($state_descriptions) > 0) and ($state_descriptions != '---DISABLED---') )
+				{
+				if ( (strlen($ig_state_descriptions) > 0) and ($ig_state_descriptions != '---DISABLED---') )
+					{$state_descriptions = $ig_state_descriptions;}
+				$stmt="SELECT container_entry FROM vicidial_settings_containers WHERE container_id='$state_descriptions';";
+				if ($DB) {echo "$stmt\n";}
+				$rslt=mysql_to_mysqli($stmt, $link);
+					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00XXX',$user,$server_ip,$session_name,$one_mysql_log);}
+				$SDE_ct = mysqli_num_rows($rslt);
+				$state_debug .= "$SDE_ct|$stmt|\n";
+				if ($SDE_ct > 0)
+					{
+					$row=mysqli_fetch_row($rslt);
+					$state_descriptions_container =		$row[0];
+					$SDcontainer_entry = preg_replace("/\r|\t|\'|\"/",'',$state_descriptions_container);
+					$state_settings = explode("\n",$SDcontainer_entry);
+					$state_settings_ct = count($state_settings);
+					$sdl=0;
+					while ($state_settings_ct >= $sdl)
+						{
+						$state_line_ARY = explode(",",$state_settings[$sdl]);
+						$state_match =			$state_line_ARY[0];
+						$state_setting_color =	$state_line_ARY[1];
+						$state_setting_name =	$state_line_ARY[2];
+						if ( (strlen($state_setting_color) > 0) and (strlen($state_setting_name) > 0) )
+							{
+							if ( (strlen($state_match) < 1) and (strlen($state) < 1) )
+								{
+								$state_color = $state_setting_color;
+								$state_name = $state_setting_name;
+								}
+							else
+								{
+								if ( (preg_match("/^$state$/i",$state_match)) and (strlen($state) > 0) )
+									{
+									$state_color = $state_setting_color;
+									$state_name = $state_setting_name;
+									}
+								}
+							}
+						$state_debug .= "$sdl     |$state_settings[$sdl]|   |$state_match|$state_setting_color|$state_setting_name|\n";
+						$sdl++;
+						}
+					}
+			#	$fp = fopen ("./vicidial_state_debug.txt", "w");
+			#	fwrite ($fp, "$state_debug\n");
+			#	fclose($fp);
+				}
 
 			$comments = preg_replace("/\r/i",'',$comments);
 			$comments = preg_replace("/\n/i",'!N',$comments);
@@ -6066,6 +6120,8 @@ if ($ACTION == 'manDiaLnextCaLL')
 			$LeaD_InfO .=	$VDCL_ingroup_script_color_two . "\n";
 			$LeaD_InfO .=	$VDCL_browser_alert_sound . "\n";
 			$LeaD_InfO .=	$VDCL_browser_alert_volume . "\n";
+			$LeaD_InfO .=	$state_color . "\n";
+			$LeaD_InfO .=	$state_name . "\n";
 
 			echo $LeaD_InfO;
 			}
@@ -6255,7 +6311,7 @@ if ($ACTION == 'manDiaLonly')
 		### check for manual dial filter and extension append settings in campaign
 		$use_eac=0;
 		$use_custom_cid='N';
-		$stmt = "SELECT manual_dial_filter,use_internal_dnc,use_campaign_dnc,use_other_campaign_dnc,extension_appended_cidname,start_call_url,scheduled_callbacks_auto_reschedule,dial_timeout_lead_container,daily_call_count_limit,daily_limit_manual,call_limit_24hour_method,call_limit_24hour_scope,call_limit_24hour,call_limit_24hour_override,custom_one,custom_two,custom_three,custom_four,custom_five,daily_phone_number_call_limit FROM vicidial_campaigns where campaign_id='$campaign';";
+		$stmt = "SELECT manual_dial_filter,use_internal_dnc,use_campaign_dnc,use_other_campaign_dnc,extension_appended_cidname,start_call_url,scheduled_callbacks_auto_reschedule,dial_timeout_lead_container,daily_call_count_limit,daily_limit_manual,call_limit_24hour_method,call_limit_24hour_scope,call_limit_24hour,call_limit_24hour_override,custom_one,custom_two,custom_three,custom_four,custom_five,daily_phone_number_call_limit,state_descriptions FROM vicidial_campaigns where campaign_id='$campaign';";
 		$rslt=mysql_to_mysqli($stmt, $link);
 			if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00325',$user,$server_ip,$session_name,$one_mysql_log);}
 		if ($DB) {echo "$stmt\n";}
@@ -6283,6 +6339,7 @@ if ($ACTION == 'manDiaLonly')
 			$camp_custom_four =						$row[17];
 			$camp_custom_five =						$row[18];
 			$daily_phone_number_call_limit =		$row[19];
+			$state_descriptions =					$row[20];
 			if ($extension_appended_cidname == 'Y')
 				{$use_eac++;}
 			}
@@ -10093,7 +10150,7 @@ if ($ACTION == 'VDADcheckINCOMING')
 					$script_recording_delay = $row[0];
 					}
 
-				$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action,timer_action_message,timer_action_seconds,timer_action_destination,campaign_script_two from vicidial_campaigns where campaign_id='$campaign';";
+				$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action,timer_action_message,timer_action_seconds,timer_action_destination,campaign_script_two,state_descriptions from vicidial_campaigns where campaign_id='$campaign';";
 				if ($DB) {echo "$stmt\n";}
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00114',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -10119,6 +10176,7 @@ if ($ACTION == 'VDADcheckINCOMING')
 					$VDCL_timer_action_seconds =	$row[14];
 					$VDCL_timer_action_destination =	$row[15];
 					$VDCL_campaign_script_two =		$row[16];
+					$state_descriptions =			$row[17];
 					}
 
 				$VDCL_group_web='';
@@ -10307,8 +10365,9 @@ if ($ACTION == 'VDADcheckINCOMING')
 				$ig_custom_three='';
 				$ig_custom_four='';
 				$ig_custom_five='';
+				$ig_state_descriptions='';
 
-				$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,inbound_survey,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_inbound_groups where group_id='$VDADchannel_group';";
+				$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,inbound_survey,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_inbound_groups where group_id='$VDADchannel_group';";
 				if ($DB) {echo "$stmt\n";}
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00119',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -10352,10 +10411,11 @@ if ($ACTION == 'VDADcheckINCOMING')
 					$ig_custom_three =					$row[34];
 					$ig_custom_four =					$row[35];
 					$ig_custom_five =					$row[36];
+					$ig_state_descriptions =			$row[37];
 
 					$status_group_gather_data = status_group_gather($row[27],'INGROUP');
 
-					$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,default_xfer_group,campaign_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_campaigns where campaign_id='$campaign';";
+					$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,default_xfer_group,campaign_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_campaigns where campaign_id='$campaign';";
 					if ($DB) {echo "$stmt\n";}
 					$rslt=mysql_to_mysqli($stmt, $link);
 						if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00181',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -10403,6 +10463,10 @@ if ($ACTION == 'VDADcheckINCOMING')
 						$camp_custom_three =				$row[21];
 						$camp_custom_four =					$row[22];
 						$camp_custom_five =					$row[23];
+						if ( (strlen($ig_state_descriptions) > 0) and (!preg_match("/---DISABLED---/",$ig_state_descriptions)) )
+							{$state_descriptions =		$ig_state_descriptions;}
+						else
+							{$state_descriptions =			$row[24];}
 
 						if ( ( (preg_match('/NONE/',$VDCL_ingroup_script)) and (strlen($VDCL_ingroup_script) < 5) ) or (strlen($VDCL_ingroup_script) < 1) )
 							{
@@ -10508,7 +10572,7 @@ if ($ACTION == 'VDADcheckINCOMING')
 					}
 				else
 					{
-					$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume from vicidial_campaigns where campaign_id='$VDADchannel_group';";
+					$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume,state_descriptions from vicidial_campaigns where campaign_id='$VDADchannel_group';";
 					if ($DB) {echo "$stmt\n";}
 					$rslt=mysql_to_mysqli($stmt, $link);
 						if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00121',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -10535,6 +10599,7 @@ if ($ACTION == 'VDADcheckINCOMING')
 						$VDCL_ingroup_script_two = 		$row[16];
 						$VDCL_browser_alert_sound =		$row[17];
 						$VDCL_browser_alert_volume =	$row[18];
+						$state_descriptions =			$row[19];
 						}
 
 					$script_recording_delay=0;
@@ -10695,6 +10760,58 @@ if ($ACTION == 'VDADcheckINCOMING')
 						}
 					}
 
+				$state_color='';
+				$state_name='';
+				$state_debug='';
+				if ( (strlen($state_descriptions) > 0) and ($state_descriptions != '---DISABLED---') )
+					{
+					if ( (strlen($ig_state_descriptions) > 0) and ($ig_state_descriptions != '---DISABLED---') )
+						{$state_descriptions = $ig_state_descriptions;}
+					$stmt="SELECT container_entry FROM vicidial_settings_containers WHERE container_id='$state_descriptions';";
+					if ($DB) {echo "$stmt\n";}
+					$rslt=mysql_to_mysqli($stmt, $link);
+						if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00XXX',$user,$server_ip,$session_name,$one_mysql_log);}
+					$SDE_ct = mysqli_num_rows($rslt);
+					$state_debug .= "$SDE_ct|$stmt|\n";
+					if ($SDE_ct > 0)
+						{
+						$row=mysqli_fetch_row($rslt);
+						$state_descriptions_container =		$row[0];
+						$SDcontainer_entry = preg_replace("/\r|\t|\'|\"/",'',$state_descriptions_container);
+						$state_settings = explode("\n",$SDcontainer_entry);
+						$state_settings_ct = count($state_settings);
+						$sdl=0;
+						while ($state_settings_ct >= $sdl)
+							{
+							$state_line_ARY = explode(",",$state_settings[$sdl]);
+							$state_match =			$state_line_ARY[0];
+							$state_setting_color =	$state_line_ARY[1];
+							$state_setting_name =	$state_line_ARY[2];
+							if ( (strlen($state_setting_color) > 0) and (strlen($state_setting_name) > 0) )
+								{
+								if ( (strlen($state_match) < 1) and (strlen($state) < 1) )
+									{
+									$state_color = $state_setting_color;
+									$state_name = $state_setting_name;
+									}
+								else
+									{
+									if ( (preg_match("/^$state$/i",$state_match)) and (strlen($state) > 0) )
+										{
+										$state_color = $state_setting_color;
+										$state_name = $state_setting_name;
+										}
+									}
+								}
+							$state_debug .= "$sdl     |$state_settings[$sdl]|   |$state_match|$state_setting_color|$state_setting_name|\n";
+							$sdl++;
+							}
+						}
+				#	$fp = fopen ("./vicidial_state_debug.txt", "w");
+				#	fwrite ($fp, "$state_debug\n");
+				#	fclose($fp);
+					}
+
 				### if web form is set then send on to vicidial.php for override of WEB_FORM address
 				if ( (strlen($VDCL_group_web)>5) or (strlen($VDCL_group_name)>0) ) {echo "$VDCL_group_web|$VDCL_group_name|$VDCL_group_color|$VDCL_fronter_display|$VDADchannel_group|$VDCL_ingroup_script|$VDCL_get_call_launch|$VDCL_xferconf_a_dtmf|$VDCL_xferconf_a_number|$VDCL_xferconf_b_dtmf|$VDCL_xferconf_b_number|$VDCL_default_xfer_group|$VDCL_ingroup_recording_override|$VDCL_ingroup_rec_filename|$VDCL_default_group_alias|$VDCL_caller_id_number|$VDCL_group_web_vars|$VDCL_group_web_two|$VDCL_timer_action|$VDCL_timer_action_message|$VDCL_timer_action_seconds|$VDCL_xferconf_c_number|$VDCL_xferconf_d_number|$VDCL_xferconf_e_number|$VDCL_uniqueid_status_display|$custom_call_id|$VDCL_uniqueid_status_prefix|$VDCL_timer_action_destination|$DID_id|$DID_extension|$DID_pattern|$DID_description|$INclosecallid|$INxfercallid|$VDCL_group_web_three|$VDCL_ingroup_script_color|$VDCL_inbound_survey|$VDCL_survey_participate|$VDCL_ingroup_script_two|$VDCL_ingroup_script_color_two|$VDCL_browser_alert_sound|$VDCL_browser_alert_volume|\n";}
 				else {echo "X|$VDCL_group_name|$VDCL_group_color|$VDCL_fronter_display|$VDADchannel_group|$VDCL_ingroup_script|$VDCL_get_call_launch|$VDCL_xferconf_a_dtmf|$VDCL_xferconf_a_number|$VDCL_xferconf_b_dtmf|$VDCL_xferconf_b_number|$VDCL_default_xfer_group|$VDCL_ingroup_recording_override|$VDCL_ingroup_rec_filename|$VDCL_default_group_alias|$VDCL_caller_id_number|$VDCL_group_web_vars|$VDCL_group_web_two|$VDCL_timer_action|$VDCL_timer_action_message|$VDCL_timer_action_seconds|$VDCL_xferconf_c_number|$VDCL_xferconf_d_number|$VDCL_xferconf_e_number|$VDCL_uniqueid_status_display|$custom_call_id|$VDCL_uniqueid_status_prefix|$VDCL_timer_action_destination|$DID_id|$DID_extension|$DID_pattern|$DID_description|$INclosecallid|$INxfercallid|$VDCL_group_web_three|$VDCL_ingroup_script_color|$VDCL_inbound_survey|$VDCL_survey_participate|$VDCL_ingroup_script_two|$VDCL_ingroup_script_color_two|$VDCL_browser_alert_sound|$VDCL_browser_alert_volume|\n";}
@@ -10859,6 +10976,8 @@ if ($ACTION == 'VDADcheckINCOMING')
 			$LeaD_InfO .=	$ig_custom_three . "\n";
 			$LeaD_InfO .=	$ig_custom_four . "\n";
 			$LeaD_InfO .=	$ig_custom_five . "\n";
+			$LeaD_InfO .=	$state_color . "\n";
+			$LeaD_InfO .=	$state_name . "\n";
 
 			echo $LeaD_InfO;
 
@@ -11820,7 +11939,7 @@ if ($ACTION == 'VDADcheckINCOMINGother')
 				$row=mysqli_fetch_row($rslt);
 				$VDCL_front_VDlog	=$row[0];
 				}
-			$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_inbound_groups where group_id='$VDADchannel_group';";
+			$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_inbound_groups where group_id='$VDADchannel_group';";
 			if ($DB) {echo "$stmt\n";}
 			$rslt=mysql_to_mysqli($stmt, $link);
 				if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00500',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -11863,10 +11982,11 @@ if ($ACTION == 'VDADcheckINCOMINGother')
 				$ig_custom_three =					$row[33];
 				$ig_custom_four =					$row[34];
 				$ig_custom_five =					$row[35];
+				$ig_state_descriptions =			$row[36];
 
 				$status_group_gather_data = status_group_gather($row[27],'INGROUP');
 
-				$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_campaigns where campaign_id='$campaign';";
+				$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_campaigns where campaign_id='$campaign';";
 				if ($DB) {echo "$stmt\n";}
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00501',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -11908,6 +12028,10 @@ if ($ACTION == 'VDADcheckINCOMINGother')
 					$camp_custom_three =	$row[21];
 					$camp_custom_four =		$row[22];
 					$camp_custom_five =		$row[23];
+					if ( (strlen($ig_state_descriptions) > 0) and (!preg_match("/---DISABLED---/",$ig_state_descriptions)) )
+						{$state_descriptions =		$ig_state_descriptions;}
+					else
+						{$state_descriptions =		$row[24];}
 					}
 
 				# check for User Group override of agent script, and if that feature is enabled for this campaign
@@ -11951,7 +12075,7 @@ if ($ACTION == 'VDADcheckINCOMINGother')
 				}
 			else
 				{
-				$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_campaigns where campaign_id='$VDADchannel_group';";
+				$stmt = "SELECT campaign_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,user_group_script,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_campaigns where campaign_id='$VDADchannel_group';";
 				if ($DB) {echo "$stmt\n";}
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00505',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -11981,6 +12105,7 @@ if ($ACTION == 'VDADcheckINCOMINGother')
 					$camp_custom_three =			$row[20];
 					$camp_custom_four =				$row[21];
 					$camp_custom_five =				$row[22];
+					$state_descriptions =			$row[23];
 					}
 
 				$stmt = "SELECT group_web_vars from vicidial_campaign_agents where campaign_id='$VDADchannel_group' and user='$user';";
@@ -12874,7 +12999,7 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 					$CBcomments =		trim("$row[3]");
 					}
 				}
-			$stmt="SELECT owner_populate,user_group_script FROM vicidial_campaigns where campaign_id='$campaign';";
+			$stmt="SELECT owner_populate,user_group_script,state_descriptions FROM vicidial_campaigns where campaign_id='$campaign';";
 			$rslt=mysql_to_mysqli($stmt, $link);
 				if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00459',$user,$server_ip,$session_name,$one_mysql_log);}
 			if ($DB) {echo "$stmt\n";}
@@ -12884,6 +13009,7 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 				$row=mysqli_fetch_row($rslt);
 				$owner_populate =			$row[0];
 				$user_group_script =		$row[1];
+				$state_descriptions =		$row[2];
 				}
 			$ownerSQL='';
 			if ( ($owner_populate=='ENABLED') and ( (strlen($owner) < 1) or ($owner=='NULL') ) )
@@ -13011,7 +13137,7 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 				$script_recording_delay = $row[0];
 				}
 
-			$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_inbound_groups where group_id='$VDADchannel_group';";
+			$stmt = "SELECT group_name,group_color,web_form_address,fronter_display,ingroup_script,get_call_launch,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_xfer_group,ingroup_recording_override,ingroup_rec_filename,default_group_alias,web_form_address_two,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,uniqueid_status_display,uniqueid_status_prefix,timer_action_destination,web_form_address_three,status_group_id,ingroup_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_inbound_groups where group_id='$VDADchannel_group';";
 			if ($DB) {echo "$stmt\n";}
 			$rslt=mysql_to_mysqli($stmt, $link);
 				if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00468',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -13054,10 +13180,11 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 				$ig_custom_three =					$row[33];
 				$ig_custom_four =					$row[34];
 				$ig_custom_five =					$row[35];
+				$ig_state_descriptions =			$row[36];
 
 				$status_group_gather_data = status_group_gather($row[27],'INGROUP');
 
-				$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five from vicidial_campaigns where campaign_id='$campaign';";
+				$stmt = "SELECT campaign_script,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,default_group_alias,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,timer_action_destination,campaign_script_two,browser_alert_sound,browser_alert_volume,custom_one,custom_two,custom_three,custom_four,custom_five,state_descriptions from vicidial_campaigns where campaign_id='$campaign';";
 				if ($DB) {echo "$stmt\n";}
 				$rslt=mysql_to_mysqli($stmt, $link);
 					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00469',$user,$server_ip,$session_name,$one_mysql_log);}
@@ -13103,6 +13230,10 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 						$camp_custom_four =				$row[21];
 						$camp_custom_five =				$row[22];
 						}
+					if ( (strlen($ig_state_descriptions) > 0) and (!preg_match("/---DISABLED---/",$ig_state_descriptions)) )
+						{$state_descriptions =		$ig_state_descriptions;}
+					else
+						{$state_descriptions =		$row[24];}
 
 					if ( ( (preg_match('/NONE/',$VDCL_ingroup_script)) and (strlen($VDCL_ingroup_script) < 5) ) or (strlen($VDCL_ingroup_script) < 1) )
 						{
@@ -13269,6 +13400,58 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 					}
 				}
 
+			$state_color='';
+			$state_name='';
+			$state_debug='';
+			if ( (strlen($state_descriptions) > 0) and ($state_descriptions != '---DISABLED---') )
+				{
+				if ( (strlen($ig_state_descriptions) > 0) and ($ig_state_descriptions != '---DISABLED---') )
+					{$state_descriptions = $ig_state_descriptions;}
+				$stmt="SELECT container_entry FROM vicidial_settings_containers WHERE container_id='$state_descriptions';";
+				if ($DB) {echo "$stmt\n";}
+				$rslt=mysql_to_mysqli($stmt, $link);
+					if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'00XXX',$user,$server_ip,$session_name,$one_mysql_log);}
+				$SDE_ct = mysqli_num_rows($rslt);
+				$state_debug .= "$SDE_ct|$stmt|\n";
+				if ($SDE_ct > 0)
+					{
+					$row=mysqli_fetch_row($rslt);
+					$state_descriptions_container =		$row[0];
+					$SDcontainer_entry = preg_replace("/\r|\t|\'|\"/",'',$state_descriptions_container);
+					$state_settings = explode("\n",$SDcontainer_entry);
+					$state_settings_ct = count($state_settings);
+					$sdl=0;
+					while ($state_settings_ct >= $sdl)
+						{
+						$state_line_ARY = explode(",",$state_settings[$sdl]);
+						$state_match =			$state_line_ARY[0];
+						$state_setting_color =	$state_line_ARY[1];
+						$state_setting_name =	$state_line_ARY[2];
+						if ( (strlen($state_setting_color) > 0) and (strlen($state_setting_name) > 0) )
+							{
+							if ( (strlen($state_match) < 1) and (strlen($state) < 1) )
+								{
+								$state_color = $state_setting_color;
+								$state_name = $state_setting_name;
+								}
+							else
+								{
+								if ( (preg_match("/^$state$/i",$state_match)) and (strlen($state) > 0) )
+									{
+									$state_color = $state_setting_color;
+									$state_name = $state_setting_name;
+									}
+								}
+							}
+						$state_debug .= "$sdl     |$state_settings[$sdl]|   |$state_match|$state_setting_color|$state_setting_name|\n";
+						$sdl++;
+						}
+					}
+			#	$fp = fopen ("./vicidial_state_debug.txt", "w");
+			#	fwrite ($fp, "$state_debug\n");
+			#	fclose($fp);
+				}
+
 			### if web form is set then send on to vicidial.php for override of WEB_FORM address
 			if ( (strlen($VDCL_group_web)>5) or (strlen($VDCL_group_name)>0) ) {echo "$VDCL_group_web|$VDCL_group_name|$VDCL_group_color|$VDCL_fronter_display|$VDADchannel_group|$VDCL_ingroup_script|$VDCL_get_call_launch|$VDCL_xferconf_a_dtmf|$VDCL_xferconf_a_number|$VDCL_xferconf_b_dtmf|$VDCL_xferconf_b_number|$VDCL_default_xfer_group|$VDCL_ingroup_recording_override|$VDCL_ingroup_rec_filename|$VDCL_default_group_alias|$VDCL_caller_id_number|$VDCL_group_web_vars|$VDCL_group_web_two|$VDCL_timer_action|$VDCL_timer_action_message|$VDCL_timer_action_seconds|$VDCL_xferconf_c_number|$VDCL_xferconf_d_number|$VDCL_xferconf_e_number|$VDCL_uniqueid_status_display|$custom_call_id|$VDCL_uniqueid_status_prefix|$VDCL_timer_action_destination|$DID_id|$DID_extension|$DID_pattern|$DID_description|$INclosecallid|$INxfercallid|$VDCL_group_web_three|$VDCL_ingroup_script_color|$VDCL_ingroup_script_two|$VDCL_ingroup_script_color_two|$VDCL_browser_alert_sound|$VDCL_browser_alert_volume|\n";}
 			else {echo "X|$VDCL_group_name|$VDCL_group_color|$VDCL_fronter_display|$VDADchannel_group|$VDCL_ingroup_script|$VDCL_get_call_launch|$VDCL_xferconf_a_dtmf|$VDCL_xferconf_a_number|$VDCL_xferconf_b_dtmf|$VDCL_xferconf_b_number|$VDCL_default_xfer_group|$VDCL_ingroup_recording_override|$VDCL_ingroup_rec_filename|$VDCL_default_group_alias|$VDCL_caller_id_number|$VDCL_group_web_vars|$VDCL_group_web_two|$VDCL_timer_action|$VDCL_timer_action_message|$VDCL_timer_action_seconds|$VDCL_xferconf_c_number|$VDCL_xferconf_d_number|$VDCL_xferconf_e_number|$VDCL_uniqueid_status_display|$custom_call_id|$VDCL_uniqueid_status_prefix|$VDCL_timer_action_destination|$DID_id|$DID_extension|$DID_pattern|$DID_description|$INclosecallid|$INxfercallid|$VDCL_group_web_three|$VDCL_ingroup_script_color|$VDCL_ingroup_script_two|$VDCL_ingroup_script_color_two|$VDCL_browser_alert_sound|$VDCL_browser_alert_volume|\n";}
@@ -13444,6 +13627,8 @@ if ($ACTION == 'LeaDSearcHSelecTUpdatE')
 			$LeaD_InfO .=	$ig_custom_three . "\n";
 			$LeaD_InfO .=	$ig_custom_four . "\n";
 			$LeaD_InfO .=	$ig_custom_five . "\n";
+			$LeaD_InfO .=	$state_color . "\n";
+			$LeaD_InfO .=	$state_name . "\n";
 
 			echo $LeaD_InfO;
 

agc_2-X/trunk/www/agc/vicidial.php

@@ -1,7 +1,7 @@
 <?php
 # vicidial.php - the web-based version of the astVICIDIAL client application
 # 
-# Copyright (C) 2023  Matt Florell <vicidial@gmail.com>    LICENSE: AGPLv2
+# Copyright (C) 2024  Matt Florell <vicidial@gmail.com>    LICENSE: AGPLv2
 #
 # Other scripts that this application depends on:
 # - vdc_db_query.php: Updates information in the database
@@ -731,10 +731,11 @@
 # 231129-0952 - Added phone number daily call limits
 # 231129-1359 - Fix for Dial-In-Group user-group issue #1493
 # 231129-1540 - Added refresh_panel agent API function
+# 240214-0400 - Added state_descriptions banners
 #
 
-$version = '2.14-697c';
+$version = '2.14-698c';
-$build = '231129-1540';
+$build = '240214-0400';
 $php_script = 'vicidial.php';
 $mel=1;					# Mysql Error Log enabled = 1
 $mysql_log_count=103;
@@ -1041,6 +1042,7 @@ $webphone_width			= 460;	# set the webphone frame width
 $webphone_height		= 500;	# set the webphone frame height
 $webphone_pad			= 0;	# set the table cellpadding for the webphone
 $webphone_location		= 'right';	# set the location on the agent screen 'right' or 'bar'
+$banner_height			= 15;	# state description banner
 $MAIN_COLOR				= '#CCCCCC';	# old default is E0C2D6
 $SCRIPT_COLOR			= '#E6E6E6';	# old default is FFE7D0
 $FORM_COLOR				= '#EFEFEF';
@@ -3109,7 +3111,7 @@ else
 				$HKstatusnames = substr("$HKstatusnames", 0, -1); 
 
 				##### grab the campaign settings
-				$stmt="SELECT park_ext,park_file_name,web_form_address,allow_closers,auto_dial_level,dial_timeout,dial_prefix,campaign_cid,campaign_vdad_exten,campaign_rec_exten,campaign_recording,campaign_rec_filename,campaign_script,get_call_launch,am_message_exten,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,alt_number_dialing,scheduled_callbacks,wrapup_seconds,wrapup_message,closer_campaigns,use_internal_dnc,allcalls_delay,omit_phone_code,agent_pause_codes_active,no_hopper_leads_logins,campaign_allow_inbound,manual_dial_list_id,default_xfer_group,xfer_groups,disable_alter_custphone,display_queue_count,manual_dial_filter,agent_clipboard_copy,use_campaign_dnc,three_way_call_cid,dial_method,three_way_dial_prefix,web_form_target,vtiger_screen_login,agent_allow_group_alias,default_group_alias,quick_transfer_button,prepopulate_transfer_preset,view_calls_in_queue,view_calls_in_queue_launch,call_requeue_button,pause_after_each_call,no_hopper_dialing,agent_dial_owner_only,agent_display_dialable_leads,web_form_address_two,agent_select_territories,crm_popup_login,crm_login_address,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,use_custom_cid,scheduled_callbacks_alert,scheduled_callbacks_count,manual_dial_override,blind_monitor_warning,blind_monitor_message,blind_monitor_filename,timer_action_destination,enable_xfer_presets,hide_xfer_number_to_dial,manual_dial_prefix,customer_3way_hangup_logging,customer_3way_hangup_seconds,customer_3way_hangup_action,ivr_park_call,manual_preview_dial,api_manual_dial,manual_dial_call_time_check,my_callback_option,per_call_notes,agent_lead_search,agent_lead_search_method,queuemetrics_phone_environment,auto_pause_precall,auto_pause_precall_code,auto_resume_precall,manual_dial_cid,custom_3way_button_transfer,callback_days_limit,disable_dispo_screen,disable_dispo_status,screen_labels,status_display_fields,pllb_grouping,pllb_grouping_limit,in_group_dial,in_group_dial_select,pause_after_next_call,owner_populate,manual_dial_lead_id,dead_max,dispo_max,pause_max,dead_max_dispo,dispo_max_dispo,max_inbound_calls,manual_dial_search_checkbox,hide_call_log_info,timer_alt_seconds,wrapup_bypass,wrapup_after_hotkey,callback_active_limit,callback_active_limit_override,comments_all_tabs,comments_dispo_screen,comments_callback_screen,qc_comment_history,show_previous_callback,clear_script,manual_dial_search_filter,web_form_address_three,manual_dial_override_field,status_display_ingroup,customer_gone_seconds,agent_display_fields,manual_dial_timeout,manual_auto_next,manual_auto_show,allow_required_fields,dead_to_dispo,agent_xfer_validation,ready_max_logout,callback_display_days,three_way_record_stop,hangup_xfer_record_start,max_inbound_calls_outcome,manual_auto_next_options,agent_screen_time_display,pause_max_dispo,script_top_dispo,routing_initiated_recordings,dead_trigger_seconds,dead_trigger_action,dead_trigger_repeat,dead_trigger_filename,scheduled_callbacks_force_dial,callback_hours_block,callback_display_days,scheduled_callbacks_timezones_container,three_way_volume_buttons,manual_dial_validation,mute_recordings,leave_vm_no_dispo,leave_vm_message_group_id,campaign_script_two,browser_alert_sound,browser_alert_volume,three_way_record_stop_exception,pause_max_exceptions,transfer_button_launch,leave_3way_start_recording,leave_3way_start_recording_exception,calls_waiting_vl_one,calls_waiting_vl_two,in_man_dial_next_ready_seconds,in_man_dial_next_ready_seconds_override,transfer_no_dispo,local_call_time,pause_max_url,agent_hide_hangup,ig_xfer_list_sort,script_tab_frame_size,user_group_script,agent_hangup_route,agent_hangup_value,agent_hangup_ig_override,show_confetti,custom_one,custom_two,custom_three,custom_four,custom_five,allow_chats,dead_stop_recording,force_per_call_notes FROM vicidial_campaigns where campaign_id = '$VD_campaign';";
+				$stmt="SELECT park_ext,park_file_name,web_form_address,allow_closers,auto_dial_level,dial_timeout,dial_prefix,campaign_cid,campaign_vdad_exten,campaign_rec_exten,campaign_recording,campaign_rec_filename,campaign_script,get_call_launch,am_message_exten,xferconf_a_dtmf,xferconf_a_number,xferconf_b_dtmf,xferconf_b_number,alt_number_dialing,scheduled_callbacks,wrapup_seconds,wrapup_message,closer_campaigns,use_internal_dnc,allcalls_delay,omit_phone_code,agent_pause_codes_active,no_hopper_leads_logins,campaign_allow_inbound,manual_dial_list_id,default_xfer_group,xfer_groups,disable_alter_custphone,display_queue_count,manual_dial_filter,agent_clipboard_copy,use_campaign_dnc,three_way_call_cid,dial_method,three_way_dial_prefix,web_form_target,vtiger_screen_login,agent_allow_group_alias,default_group_alias,quick_transfer_button,prepopulate_transfer_preset,view_calls_in_queue,view_calls_in_queue_launch,call_requeue_button,pause_after_each_call,no_hopper_dialing,agent_dial_owner_only,agent_display_dialable_leads,web_form_address_two,agent_select_territories,crm_popup_login,crm_login_address,timer_action,timer_action_message,timer_action_seconds,start_call_url,dispo_call_url,xferconf_c_number,xferconf_d_number,xferconf_e_number,use_custom_cid,scheduled_callbacks_alert,scheduled_callbacks_count,manual_dial_override,blind_monitor_warning,blind_monitor_message,blind_monitor_filename,timer_action_destination,enable_xfer_presets,hide_xfer_number_to_dial,manual_dial_prefix,customer_3way_hangup_logging,customer_3way_hangup_seconds,customer_3way_hangup_action,ivr_park_call,manual_preview_dial,api_manual_dial,manual_dial_call_time_check,my_callback_option,per_call_notes,agent_lead_search,agent_lead_search_method,queuemetrics_phone_environment,auto_pause_precall,auto_pause_precall_code,auto_resume_precall,manual_dial_cid,custom_3way_button_transfer,callback_days_limit,disable_dispo_screen,disable_dispo_status,screen_labels,status_display_fields,pllb_grouping,pllb_grouping_limit,in_group_dial,in_group_dial_select,pause_after_next_call,owner_populate,manual_dial_lead_id,dead_max,dispo_max,pause_max,dead_max_dispo,dispo_max_dispo,max_inbound_calls,manual_dial_search_checkbox,hide_call_log_info,timer_alt_seconds,wrapup_bypass,wrapup_after_hotkey,callback_active_limit,callback_active_limit_override,comments_all_tabs,comments_dispo_screen,comments_callback_screen,qc_comment_history,show_previous_callback,clear_script,manual_dial_search_filter,web_form_address_three,manual_dial_override_field,status_display_ingroup,customer_gone_seconds,agent_display_fields,manual_dial_timeout,manual_auto_next,manual_auto_show,allow_required_fields,dead_to_dispo,agent_xfer_validation,ready_max_logout,callback_display_days,three_way_record_stop,hangup_xfer_record_start,max_inbound_calls_outcome,manual_auto_next_options,agent_screen_time_display,pause_max_dispo,script_top_dispo,routing_initiated_recordings,dead_trigger_seconds,dead_trigger_action,dead_trigger_repeat,dead_trigger_filename,scheduled_callbacks_force_dial,callback_hours_block,callback_display_days,scheduled_callbacks_timezones_container,three_way_volume_buttons,manual_dial_validation,mute_recordings,leave_vm_no_dispo,leave_vm_message_group_id,campaign_script_two,browser_alert_sound,browser_alert_volume,three_way_record_stop_exception,pause_max_exceptions,transfer_button_launch,leave_3way_start_recording,leave_3way_start_recording_exception,calls_waiting_vl_one,calls_waiting_vl_two,in_man_dial_next_ready_seconds,in_man_dial_next_ready_seconds_override,transfer_no_dispo,local_call_time,pause_max_url,agent_hide_hangup,ig_xfer_list_sort,script_tab_frame_size,user_group_script,agent_hangup_route,agent_hangup_value,agent_hangup_ig_override,show_confetti,custom_one,custom_two,custom_three,custom_four,custom_five,allow_chats,dead_stop_recording,force_per_call_notes,state_descriptions FROM vicidial_campaigns where campaign_id = '$VD_campaign';";
 				$rslt=mysql_to_mysqli($stmt, $link);
 				if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'01013',$VD_login,$server_ip,$session_name,$one_mysql_log);}
 				if ($DB) {echo "$stmt\n";}
@@ -3305,6 +3307,23 @@ else
 				$campaign_chat_enabled =	$row[188];
 				$dead_stop_recording =		$row[189];
 				$force_per_call_notes = 	$row[190];
+				$state_descriptions =		$row[191];
+
+				$state_descriptions_banner=0;
+				if ( ($state_descriptions != '---DISABLED---') and (strlen($state_descriptions) > 0) )
+					{
+					$stmt="SELECT container_entry FROM vicidial_settings_containers WHERE container_id='$state_descriptions';";
+					$rslt=mysql_to_mysqli($stmt, $link);
+							if ($mel > 0) {mysql_error_logging($NOW_TIME,$link,$mel,$stmt,'01XXX',$VD_login,$server_ip,$session_name,$one_mysql_log);}
+					if ($DB) {echo "$stmt\n";}
+					$stde_ct = mysqli_num_rows($rslt);
+					if ($stde_ct > 0)
+						{
+						$row=mysqli_fetch_row($rslt);
+						$$state_descriptions_settings =		$row[0];
+						$state_descriptions_banner++;
+						}
+					}
 
 				$force_per_call_notes_minimum=0;
 				if ($force_per_call_notes != 'DISABLED')
@@ -5530,6 +5549,13 @@ if ($webphone_location == 'bar')
 #	$SFheight = ($SFheight + $webphone_height);
 	$SRheight = ($SRheight + $webphone_height);
 	}
+if ($state_descriptions_banner > 0) 
+	{
+#	$SCheight = ($SCheight + $banner_height);
+#	$SFheight = ($SFheight + $banner_height);
+	$SRheight = ($SRheight + $banner_height);
+	}
+
 $AVTheight = '0';
 if ($is_webphone) {$AVTheight = '20';}
 
@@ -6429,6 +6455,8 @@ if ($enable_fast_refresh < 1) {echo "\tvar refresh_interval = 1000;\n";}
 	var ig_custom_three='';
 	var ig_custom_four='';
 	var ig_custom_five='';
+	var state_color='';
+	var state_name='';
 	var closecallid='';
 	var xfercallid='';
 	var custom_field_names='';
@@ -6669,6 +6697,7 @@ if ($enable_fast_refresh < 1) {echo "\tvar refresh_interval = 1000;\n";}
 	var dead_stop_recording='<?php echo $dead_stop_recording ?>';
 	var dead_count=0;
 	var APIskip=0;
+	var state_descriptions_banner='<?php echo $state_descriptions_banner ?>';
 	var DiaLControl_auto_HTML = "<a href=\"#\" onclick=\"AutoDial_ReSume_PauSe('VDADready','','','','','','','YES');\"><img src=\"./images/<?php echo _QXZ("vdc_LB_paused.gif") ?>\" border=\"0\" alt=\"You are paused\" /></a>";
 	var DiaLControl_auto_HTML_ready = "<a href=\"#\" onclick=\"AutoDial_ReSume_PauSe('VDADpause','','','','','','','YES');\"><img src=\"./images/<?php echo _QXZ("vdc_LB_active.gif") ?>\" border=\"0\" alt=\"You are active\" /></a>";
 	var DiaLControl_auto_HTML_OFF = "<img src=\"./images/<?php echo _QXZ("vdc_LB_blank_OFF.gif") ?>\" border=\"0\" alt=\"pause button disabled\" />";
@@ -10438,12 +10467,13 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 								did_custom_five									= change_array[64];
 								status_group_statuses_data						= change_array[65];
 								last_call_date									= change_array[66];
-
 								ig_custom_one									= change_array[71];
 								ig_custom_two									= change_array[72];
 								ig_custom_three									= change_array[73];
 								ig_custom_four									= change_array[74];
 								ig_custom_five									= change_array[75];
+								state_color										= change_array[76];
+								state_name										= change_array[77];
 
 								// build statuses list for disposition screen
 								VARstatuses = [];
@@ -10817,6 +10847,15 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 									}
 								api_switch_lead_triggered=0;
 
+								if (state_descriptions_banner > 0)
+									{
+									if (state_color.length > 1)
+										{
+										document.getElementById("BannerPanel").style.background = state_color;
+										document.getElementById("BannerPanel").innerHTML = "<font class=\"body_text\">&nbsp;<?php echo _QXZ("State"); ?>: " + document.vicidial_form.state.value + " - " + state_name + " &nbsp; </font>";
+										}
+									}
+
 								if (useIE > 0)
 									{
 									var regCTC = new RegExp("^NONE","ig");
@@ -12190,6 +12229,8 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 								CalL_ScripT_color_two							= MDnextResponse_array[62];
 								browser_alert_sound								= MDnextResponse_array[63];
 								browser_alert_volume							= MDnextResponse_array[64];
+								state_color										= MDnextResponse_array[65];
+								state_name										= MDnextResponse_array[66];
 
 								// build statuses list for disposition screen
 								VARstatuses = [];
@@ -12433,6 +12474,15 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 								if ( (CalL_ScripT_color_two.length > 1) && (SSenable_second_script > 0) )
 									{document.getElementById("Script2Contents").style.backgroundColor = CalL_ScripT_color_two;}
 
+								if (state_descriptions_banner > 0)
+									{
+									if (state_color.length > 1)
+										{
+										document.getElementById("BannerPanel").style.background = state_color;
+										document.getElementById("BannerPanel").innerHTML = "<font class=\"body_text\">&nbsp;<?php echo _QXZ("State"); ?>: " + document.vicidial_form.state.value + " - " + state_name + " &nbsp; </font>";
+										}
+									}
+
 								if ( (document.vicidial_form.LeadPreview.checked==false) && ( (manual_dial_validation != 'Y') || (manual_entry_dial > 0) ) )
 									{
 									reselect_preview_dial = 0;
@@ -12816,6 +12866,8 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 				leave_3way_start_recording_filename='';
 				three_way_call_cid = orig_three_way_call_cid;
 				APIskip=0;
+				document.getElementById("BannerPanel").style.background = panel_bgcolor;
+				document.getElementById("BannerPanel").innerHTML = '';
 				if (manual_dial_preview < 1)
 					{
 					document.vicidial_form.LeadPreview.checked=false;
@@ -13774,12 +13826,14 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 							last_call_date									= check_VDIC_array[66];
 						//	CalL_ScripT_id_two								= check_VDIC_array[67];
 						//	CalL_ScripT_color_two							= check_VDIC_array[68];
-
 							ig_custom_one									= check_VDIC_array[71];
 							ig_custom_two									= check_VDIC_array[72];
 							ig_custom_three									= check_VDIC_array[73];
 							ig_custom_four									= check_VDIC_array[74];
 							ig_custom_five									= check_VDIC_array[75];
+							state_color										= check_VDIC_array[76];
+							state_name										= check_VDIC_array[77];
+						//	alert("state debug: |" + document.vicidial_form.state.value + '|'  + state_color + '|'  + state_name + '|');
 
 							// build statuses list for disposition screen
 							VARstatuses = [];
@@ -14315,6 +14369,14 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 								var dial_display_number = phone_number_format(callnum);
 								alert(" <?php echo _QXZ("Incoming:"); ?> " + dial_display_number + "\n <?php echo _QXZ("Group"); ?>- " + VDIC_data_VDIG[1] + " &nbsp; " + VDIC_fronter);
 								}
+							if (state_descriptions_banner > 0)
+								{
+								if (state_color.length > 1)
+									{
+									document.getElementById("BannerPanel").style.background = state_color;
+									document.getElementById("BannerPanel").innerHTML = "<font class=\"body_text\">&nbsp;<?php echo _QXZ("State"); ?>: " + document.vicidial_form.state.value + " - " + state_name + " &nbsp; </font>";
+									}
+								}
 							}
 						else if ( ((email_enabled>0 && EMAILgroupCOUNT>0) || (chat_enabled>0 && CHATgroupCOUNT>0 && campaign_chat_enabled=='Y')) && AutoDialWaiting==1)
 							{
@@ -17202,6 +17264,8 @@ function set_length(SLnumber,SLlength_goal,SLdirection)
 					leave_3way_start_recording_filename='';
 					three_way_call_cid = orig_three_way_call_cid;
 					APIskip=0;
+					document.getElementById("BannerPanel").style.background = panel_bgcolor;
+					document.getElementById("BannerPanel").innerHTML = '';
 					if (manual_auto_next > 0)
 						{manual_auto_next_trigger=1;   manual_auto_next_count=manual_auto_next;}
 					if (agent_display_fields.match(adfREGentry_date))
@@ -23007,14 +23071,19 @@ $zi=2;
 	<?php
 	if ($webphone_location == 'bar')
 		{
-        echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";
+        echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" alt=\"webphone-bar spacer\" /><br />\n";
 		}
+	?>	
+	<span id="post_phone_time_diff_span"><b><font color="red"><span id="post_phone_time_diff_span_contents"></span></font></b></span>
+    <font class="body_text"> <?php echo _QXZ("STATUS:"); ?> <span id="MainStatuSSpan"></span><span id=timer_alt_display></span><span id=manual_auto_next_display></span></font>
+	<?php
+	if ($state_descriptions_banner > 0)
+        {echo "<br /><img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\"  alt=\"banner spacer\" /><br />\n";}
 	$alt_phone_selected='';
 	if ( ($alt_number_dialing=='SELECTED') or ($alt_number_dialing=='SELECTED_TIMER_ALT') or ($alt_number_dialing=='SELECTED_TIMER_ADDR3') )
 		{$alt_phone_selected='CHECKED';}
 	?>
-	<span id="post_phone_time_diff_span"><b><font color="red"><span id="post_phone_time_diff_span_contents"></span></font></b></span>
+	</td></tr>
-    <font class="body_text"> <?php echo _QXZ("STATUS:"); ?> <span id="MainStatuSSpan"></span><span id=timer_alt_display></span><span id=manual_auto_next_display></span></font></td></tr>
     <tr><td colspan="3"><span id="busycallsdebug"></span></td></tr>
     <tr><td width="150px" align="left" valign="top">
 	<font class="body_text"><center>
@@ -23507,6 +23576,8 @@ $zi=2;
 </span>
 <!-- END *********   Here is the main VICIDIAL display panel -->
 
+<span style="position:absolute;left:0px;top:67px;z-index:<?php $zi++; echo $zi ?>;" id="BannerPanel"><font class="body_text">&nbsp;</font> </span>
+
 <!-- ZZZZZZZZZZZZ  action links -->
 
 <span style="position:absolute;left:0px;top:<?php echo $DBheight ?>px;z-index:<?php $zi++; echo $zi ?>;" id="debugbottomspan"></span>
@@ -23662,6 +23733,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SPwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_script" id="ScriptContents"><?php echo _QXZ("AGENT SCRIPT"); ?></div></font></td></tr></table>
 </span>
@@ -23674,6 +23747,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SPwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_script" id="Script2Contents"><?php echo _QXZ("AGENT SCRIPT 2"); ?></div></font></td></tr></table>
 </span>
@@ -23686,6 +23761,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SSwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_form" id="FormContents"><iframe src="./vdc_form_display.php?lead_id=&list_id=&stage=WELCOME" style="background-color:transparent;" scrolling="auto" frameborder="0" allowtransparency="true" id="vcFormIFrame" name="vcFormIFrame" width="<?php echo $SDwidth ?>px" height="<?php echo $SSheight ?>px" STYLE="z-index:<?php $zi++; echo $zi ?>"> </iframe></div></font></td></tr></table>
 </span>
@@ -23694,6 +23771,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SSwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_form" id="EmailContents"><iframe src="./vdc_email_display.php?lead_id=&list_id=&stage=WELCOME" style="background-color:transparent;" scrolling="auto" frameborder="0" allowtransparency="true" id="vcEmailIFrame" name="vcEmailIFrame" width="<?php echo $SDwidth ?>px" height="<?php echo $SSheight ?>px" STYLE="z-index:<?php $zi++; echo $zi ?>"> </iframe></div></font></td></tr></table>
 </span>
@@ -23702,6 +23781,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SSwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_form" id="ChatContents"><iframe src="./vdc_chat_display.php?lead_id=&list_id=&dial_method=<?php echo $dial_method; ?>&stage=WELCOME&server_ip=<?php echo $server_ip; ?>&user=<?php echo $VD_login.$VARchatgroupsURL ?>" style="background-color:transparent;" scrolling="auto" frameborder="0" allowtransparency="true" id="CustomerChatIFrame" name="CustomerChatIFrame" width="<?php echo $SDwidth ?>px" height="<?php echo $SSheight ?>px" STYLE="z-index:<?php $zi++; echo $zi ?>"> </iframe></div></font></td></tr></table>
 </span>
@@ -23710,6 +23791,8 @@ if ($agent_display_dialable_leads > 0)
 	<?php
 	if ($webphone_location == 'bar')
         {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$webphone_height."px\" /><br />\n";}
+	if ($state_descriptions_banner > 0)
+        {echo "<img src=\"./images/"._QXZ("pixel.gif")."\" width=\"1px\" height=\"".$banner_height."px\" /><br />\n";}
 	?>
     <table border="0" bgcolor="<?php echo $SCRIPT_COLOR ?>" width="<?php echo $SSwidth ?>px" height="<?php echo $SSheight ?>px"><tr><td align="left" valign="top"><font class="sb_text"><div class="noscroll_form" id="InternalChatContents"><iframe src="./agc_agent_manager_chat_interface.php?action=BLANK" style="background-color:transparent;" scrolling="auto" frameborder="0" allowtransparency="true" id="InternalChatIFrame" name="InternalChatIFrame" width="<?php echo $SDwidth ?>px" height="<?php echo $SSheight ?>px" STYLE="z-index:<?php $zi++; echo $zi ?>"> </iframe></div></font></td></tr></table>
 </span>

agc_2-X/trunk/www/vicidial/help_documentation.txt

@@ -1,4 +1,4 @@
-# version: 20231228184301
+# version: 20240214213601
 users-user	User ID	<QXZ>This field is where you put the users ID number, can be up to 20 digits in length, Must be at least 2 characters in length. We strongly recommend not reusing user accounts for different users, for reporting accuracy. To disable a user account, set the Active option to -N-.</QXZ>
 users-pass	Password	<QXZ>This field is where you put the users password. Must be at least 2 characters in length, unless the User Password Minimum Length system setting is enabled, which will require a longer password. Only letters and numbers are allowed in user passwords. A medium strength user password will be at least 10 characters in length, and a strong user password will be at least 20 characters in length and have letters as well as at least one number. It is recommended that you use a longer password if possible, stringing together several unrelated words with no spaces, and a number somewhere in the string. The maximum size of a password is 100 characters.</QXZ>
 users-force_change_password	Force Change Password	<QXZ>If this option is set to Y then the user will be prompted to change their password the next time they log in to the administration webpage or the agent screen. Default is N.</QXZ>
@@ -362,6 +362,7 @@ campaigns-screen_labels	Agent Screen Labels	<QXZ>You can select a set of agent s
 campaigns-allow_required_fields	Allow Required Fields	<QXZ>Must be enabled for required fields as defined in screen labels to work. Once a field is designated as required, the agent will not be allowed to hang up a lead until there is something filled in within that field, this will affect all calls the agent receives or places. Default is N for disabled.</QXZ>
 campaigns-status_display_fields	Status Display Fields	<QXZ>You can select which variables for calls will be displayed in the status line of the agent screen. CALLID will display the 20 character unique call ID, LEADID will display the system lead ID, LISTID will display the list ID, NAME will display the customer name. Default is CALLID.</QXZ>
 campaigns-status_display_ingroup	Status Display In-Group	<QXZ>This option if set to ENABLED will display the In-Group name in the agent screen when an inbound call is sent to the agent. Default is ENABLED.</QXZ>
+campaigns-state_descriptions	State Descriptions Banner	<QXZ>If this option is set to a valid STATE_DESCRIPTIONS container type, then a banner will be displayed in the agent screen below the current call status banner near the top of the screen when a call is delivered to the agent. This field uses the lead -state- field value. You can use any HTML-safe color for these. If the state is blank, you can set a blank value in the container to set a description for them. The Default is DISABLED. The STATE_DESCRIPTIONS container entry should have one state per line with 3 fields on every line separated by a commas: State,Color,Description. For example:<br>FL,Yellow,Florida Sunshine<br>GA,PeachPuff,Georgia Peaches<BR>WI,Orange,Wisconsin Cheeses</QXZ>
 campaigns-agent_display_fields	Agent Display Fields	<QXZ>This option allows you to display hidden fields as read-only in the agent screen. Available fields are entry_date, source_id, date_of_birth, rank, owner, last_local_call_time. Default is blank.</QXZ>
 campaigns-agent_screen_time_display	Agent Screen Time Display	<QXZ>This option allows you to display a link on the agent screen that when clicked will open a frame showing the agent their time statistics for the day. There are several options that will determine what information is displayed. If RANGE is in the option, it will allow the agent to select a date range to see stats from. If EXTENDED is in the option, it will show additional columns and separate the time by campaign. Default is DISABLED.</QXZ>
 campaigns-use_internal_dnc	Use Internal DNC List	<QXZ>This defines whether this campaign is to filter leads against the Internal DNC list. If it is set to Y, the hopper will look for each phone number in the DNC list before placing it in the hopper. If it is in the DNC list then it will change that lead status to DNCL so it cannot be dialed. Default is N. The AREACODE option is just like the Y option, except it is used to also filter out an entire area code in North America from being dialed, in this case using the 201XXXXXXX entry in the DNC list would block all calls to the 201 areacode if enabled.</QXZ>
@@ -681,6 +682,7 @@ inbound_groups-customer_chat_screen_colors	Customer Chat Screen Colors	<QXZ>This
 inbound_groups-customer_chat_survey_link	Customer Chat Survey Link	<QXZ>This option allows you to define a link that the customer can go to after their chat session is over so that they can take a survey. If no link is defined then the customer will not be presented with a link. default is the empty.</QXZ>
 inbound_groups-customer_chat_survey_text	Customer Chat Survey Text	<QXZ>If the Survey Link above is populated, then this field can be used to define the text that is shown to the customer for them to click on to go to the survey link. default is the empty, in which case -PLEASE TAKE OUR SURVEY- will be used.</QXZ>
 inbound_groups-populate_lead_ingroup	Populate Lead In-Group	<QXZ>If this option is ENABLED, then when a new lead is created when going into an In-Group, the security_phrase or Show field will be populated with the Group ID of the In-Group. Default is ENABLED.</QXZ>
+inbound_groups-state_descriptions	State Descriptions Banner	<QXZ>If this option is set to a valid STATE_DESCRIPTIONS container type, and the agent is logged into a campaign with State Descriptions Banner enabled, then a banner will be displayed in the agent screen below the current call status banner near the top of the screen when a call is delivered to the agent. This option will override the campaign setting for calls from this In-Group. This field uses the lead -state- field value. You can use any HTML-safe color for these. If the state is blank, you can set a blank value in the container to set a description for them. The Default is DISABLED. The STATE_DESCRIPTIONS container entry should have one state per line with 3 fields on every line separated by a commas: State,Color,Description. For example:<br>FL,Yellow,Florida Sunshine<br>GA,PeachPuff,Georgia Peaches<BR>WI,Orange,Wisconsin Cheeses</QXZ>
 inbound_groups-populate_lead_province	Populate Lead Province	<QXZ>If this option is not DISABLED, then the system will look up the original DID that the inbound call came in on and populate one of the listed DID fields in the province field on the customer lead. The OW options will overwrite the province field every time the call enters this In-Group. Default is DISABLED.</QXZ>
 inbound_groups-populate_lead_owner	Populate Lead Owner	<QXZ>If this option is not DISABLED, then the system will look up the original DID that the inbound call came in on and populate one of the listed DID fields in the owner field on the customer lead. The OW options will overwrite the owner field every time the call enters this In-Group. If the OWNERCUSTOM option is used, then the owner field will only be populated with the value used to search for the lead with, if that Handle Method was used. Default is DISABLED.</QXZ>
 inbound_groups-populate_state_areacode	Populate Lead State Areacode	<QXZ>If this option is not DISABLED, then the system will look up the state that the areacode of the phone number is from and populate the state field with that value. If the OVERWRITE_ALWAYS option is selected, then every time that lead goes through this in-group, the state field will be looked up and populated again. Default is DISABLED.</QXZ>