fix: update UI strings for improved CTAs, grammar fixes, and consistency

Fix typos (hight→height, magnifiying→magnifying, maximun→maximum, Candelstick→Candlestick),
grammar errors (an user→a user, it working→it work, by change→by changing), and improve
UI copy across the plugin: clearer CTAs (Add New→Add New Chart, Insert→Insert Chart),
less jargon (Interpolate Nulls→Fill in Missing Values, Residue→Other Slice,
Aggregation Target→Group Tooltips By), more concise descriptions, and actionable
empty states.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: vytisbulkevicius

classes/Visualizer/Gutenberg/src/Components/Charts.js

@@ -244,7 +244,7 @@ class Charts extends Component {
 
 							</Fragment>						:
 							<p className="visualizer-no-charts">
-								{ __( 'No charts found.' ) }
+								{ __( 'No charts found. Create a chart in the Visualizer dashboard first.' ) }
 							</p>					:
 						<Placeholder>
 							<Spinner/>

classes/Visualizer/Module/Admin.php

@@ -399,7 +399,7 @@ public function enqueueMediaScripts() {
 				'visualizer',
 				array(
 					'i10n' => array(
-						'insert'    => __( 'Insert', 'visualizer' ),
+						'insert'    => __( 'Insert Chart', 'visualizer' ),
 					),
 				)
 			);
@@ -430,7 +430,7 @@ public function setupMediaViewStrings( $strings ) {
 				'title' => esc_html__( 'Visualizations', 'visualizer' ),
 			),
 			'routers'    => array(
-				'library' => esc_html__( 'From Library', 'visualizer' ),
+				'library' => esc_html__( 'Insert from Library', 'visualizer' ),
 				'create'  => esc_html__( 'Create New', 'visualizer' ),
 			),
 			'library'    => array(

classes/Visualizer/Module/Chart.php

@@ -888,7 +888,7 @@ private function _handleDataAndSettingsPage() {
 			'visualizer',
 			array(
 				'l10n'   => array(
-					'invalid_source'  => esc_html__( 'You have entered an invalid URL. Please provide a valid URL.', 'visualizer' ),
+					'invalid_source'  => esc_html__( 'The URL you entered is invalid. Please enter a valid URL.', 'visualizer' ),
 					'loading'         => esc_html__( 'Loading...', 'visualizer' ),
 					'json_error'      => esc_html__( 'An error occured in fetching data.', 'visualizer' ),
 					'select_columns'  => esc_html__( 'Please select a few columns to include in the chart.', 'visualizer' ),
@@ -1318,8 +1318,8 @@ public function uploadData() {
 			update_post_meta( $chart_id, Visualizer_Plugin::CF_EDITOR, $_POST['editor-type'] );
 		} else {
 			do_action( 'themeisle_log_event', Visualizer_Plugin::NAME, sprintf( 'CSV file with chart data was not uploaded for chart %d.', $chart_id ), 'error', __FILE__, __LINE__ );
-			$render->message = esc_html__( 'CSV file with chart data was not uploaded. Please try again.', 'visualizer' );
-			update_post_meta( $chart_id, Visualizer_Plugin::CF_ERROR, esc_html__( 'CSV file with chart data was not uploaded. Please try again.', 'visualizer' ) );
+			$render->message = esc_html__( 'No CSV file was received. Select a file and try uploading again.', 'visualizer' );
+			update_post_meta( $chart_id, Visualizer_Plugin::CF_ERROR, esc_html__( 'No CSV file was received. Select a file and try uploading again.', 'visualizer' ) );
 		}
 
 		do_action( 'themeisle_log_event', Visualizer_Plugin::NAME, sprintf( 'Uploaded data for chart %d with source %s', $chart_id, print_r( $source, true ) ), 'debug', __FILE__, __LINE__ );
@@ -1369,7 +1369,7 @@ public function uploadData() {
 			} else {
 				$error = $source->get_error();
 				if ( empty( $error ) ) {
-					$error = esc_html__( 'CSV file is broken or invalid. Please try again.', 'visualizer' );
+					$error = esc_html__( 'The CSV file couldn\'t be read. Check that it\'s properly formatted and try again.', 'visualizer' );
 				}
 				$render->message = $error;
 				do_action( 'themeisle_log_event', Visualizer_Plugin::NAME, sprintf( '%s for chart %d.', $error, $chart_id ), 'error', __FILE__, __LINE__ );
@@ -1499,7 +1499,7 @@ private function _handleDataPage() {
 			'visualizer',
 			array(
 				'l10n'   => array(
-					'invalid_source' => esc_html__( 'You have entered an invalid URL. Please provide a valid URL.', 'visualizer' ),
+					'invalid_source' => esc_html__( 'The URL you entered is invalid. Please enter a valid URL.', 'visualizer' ),
 					'loading'        => esc_html__( 'Loading...', 'visualizer' ),
 					'invalid_format' => esc_html__( 'This format pattern is not supported in the series settings field. To display percentages, use the Manual Configuration option instead.', 'visualizer' ),
 				),

classes/Visualizer/Render/Library.php

@@ -48,7 +48,7 @@ protected function _toHTML() {
 		echo '<h2>';
 		esc_html_e( 'Visualizer Library', 'visualizer' );
 		echo ' <div class="viz-add-new-group">';
-		echo '<a href="javascript:;" class="add-new-h2 add-new-chart">', esc_html__( 'Add New', 'visualizer' ), '</a>';
+		echo '<a href="javascript:;" class="add-new-h2 add-new-chart">', esc_html__( 'Add New Chart', 'visualizer' ), '</a>';
 		echo '<button type="button" class="viz-add-new-toggle" aria-haspopup="true" aria-expanded="false"><span class="dashicons dashicons-arrow-down-alt2"></span></button>';
 		echo '<div class="viz-add-new-menu" role="menu" aria-hidden="true">';
 		echo '<button type="button" class="viz-add-new-item" data-viz-builder="ai">', esc_html__( 'AI Chart Builder', 'visualizer' ), '</button>';
@@ -78,7 +78,7 @@ private function _renderMessages() {
 			echo '<p>';
 			printf(
 				// translators: %s - the name of the option.
-				esc_html__( '%s option is disabled in your php.ini config. Please, enable it by change its value to 1. This option increases the speed of remote CSV uploading.', 'visualizer' ),
+				esc_html__( '%s option is disabled in your php.ini config. Please enable it by changing its value to 1. This option increases the speed of remote CSV uploading.', 'visualizer' ),
 				'<b>allow_url_fopen</b>'
 			);
 			echo '</p>';
@@ -347,10 +347,10 @@ private function _renderLibrary() {
 			echo '<div class="items"><div class="visualizer-chart">';
 			echo '<div class="visualizer-chart-canvas visualizer-nochart-canvas">';
 			echo '<div class="visualizer-notfound">';
-			echo esc_html__( 'No charts found', 'visualizer' );
+			echo esc_html__( 'No charts found. Click \'Add New Chart\' to create one.', 'visualizer' );
 			echo '<p><h2>';
 			echo '<div class="viz-add-new-group">';
-			echo '<a href="javascript:;" class="add-new-h2 add-new-chart">', esc_html__( 'Add New', 'visualizer' ), '</a>';
+			echo '<a href="javascript:;" class="add-new-h2 add-new-chart">', esc_html__( 'Add New Chart', 'visualizer' ), '</a>';
 			echo '<button type="button" class="viz-add-new-toggle" aria-haspopup="true" aria-expanded="false"><span class="dashicons dashicons-arrow-down-alt2"></span></button>';
 			echo '<div class="viz-add-new-menu" role="menu" aria-hidden="true">';
 			echo '<button type="button" class="viz-add-new-item" data-viz-builder="ai">', esc_html__( 'AI Chart Builder', 'visualizer' ), '</button>';

classes/Visualizer/Render/Sidebar.php

@@ -341,7 +341,7 @@ protected static function _renderColorPickerItem( $title, $name, $value, $defaul
 		echo '<div class="viz-section-item">';
 			echo '<b>', $title, '</b>';
 			echo '<div>';
-				echo '<input type="text" class="color-picker-hex color-picker" data-alpha-enabled="true" name="', $name, '" maxlength="7" placeholder="', esc_attr__( 'Hex Value', 'visualizer' ), '" value="', is_null( $value ) ? $default_color : esc_attr( $value ), '" data-default-color="', $default_color, '">';
+				echo '<input type="text" class="color-picker-hex color-picker" data-alpha-enabled="true" name="', $name, '" maxlength="7" placeholder="', esc_attr__( 'Hex Color Code', 'visualizer' ), '" value="', is_null( $value ) ? $default_color : esc_attr( $value ), '" data-default-color="', $default_color, '">';
 			echo '</div>';
 		echo '</div>';
 	}
@@ -476,7 +476,7 @@ protected function _renderFormatField( $index = 0 ) {
 					isset( $this->series[ $index ]['format'] ) ? $this->series[ $index ]['format'] : '',
 					sprintf(
 						// translators: %1$s - HTML link tag, %2$s - HTML closing link tag.
-						esc_html__( 'Enter custom format pattern to apply to this series value, similar to the %1$sICU pattern set%2$s. Use something like #,### to get 1,234 as output, or $# to add dollar sign before digits. Pay attention that if you use &#37; percentage format then your values will be multiplied by 100.', 'visualizer' ),
+						esc_html__( 'Enter custom format pattern to apply to this series value, similar to the %1$sICU pattern set%2$s. Use something like #,### to get 1,234 as output, or $# to add dollar sign before digits. Note: Using the &#37; percentage format will multiply your values by 100.', 'visualizer' ),
 						'<a href="http://icu-project.org/apiref/icu4c/classDecimalFormat.html#_details" target="_blank">',
 						'</a>'
 					),

classes/Visualizer/Render/Sidebar/ChartJS.php

@@ -206,7 +206,7 @@ protected function _renderGeneralSettings() {
 			self::_renderSectionStart( esc_html__( 'Font Styles', 'visualizer' ), false );
 				echo '<div class="viz-section-item">';
 					echo '<a class="more-info" href="javascript:;">[?]</a>';
-					echo '<b>', esc_html__( 'Family And Size', 'visualizer' ), '</b>';
+					echo '<b>', esc_html__( 'Font Family And Size', 'visualizer' ), '</b>';
 
 					echo '<table class="viz-section-table" cellspacing="0" cellpadding="0" border="0">';
 						echo '<tr>';
@@ -244,7 +244,7 @@ protected function _renderGeneralSettings() {
 					// let's have a default otherwise the chart behaves weird when hovering in edit mode
 					isset( $this->legend['position'] ) ? $this->legend['position'] : 'top',
 					$this->_legendPositions,
-					esc_html__( 'Determines where to place the legend, compared to the chart area.', 'visualizer' )
+					esc_html__( 'Sets the legend position relative to the chart.', 'visualizer' )
 				);
 
 				self::_renderCheckboxItem(
@@ -257,7 +257,7 @@ protected function _renderGeneralSettings() {
 
 				echo '<div class="viz-section-item">';
 					echo '<a class="more-info" href="javascript:;">[?]</a>';
-					echo '<b>', esc_html__( 'Family And Size', 'visualizer' ), '</b>';
+					echo '<b>', esc_html__( 'Font Family And Size', 'visualizer' ), '</b>';
 
 					echo '<table class="viz-section-table" cellspacing="0" cellpadding="0" border="0">';
 						echo '<tr>';

classes/Visualizer/Render/Sidebar/Columnar.php

@@ -60,7 +60,7 @@ protected function _renderColumnarSettings() {
 					'isStacked',
 					$this->isStacked,
 					$this->_yesno,
-					esc_html__( 'If set to yes, series elements are stacked.', 'visualizer' )
+					esc_html__( 'When enabled, series elements are stacked.', 'visualizer' )
 				);
 
 				echo '<div class="viz-section-delimiter"></div>';

classes/Visualizer/Render/Sidebar/Google.php

@@ -181,7 +181,7 @@ protected function _renderGeneralSettings() {
 			self::_renderSectionStart( esc_html__( 'Font Styles', 'visualizer' ), false );
 				echo '<div class="viz-section-item">';
 					echo '<a class="more-info" href="javascript:;">[?]</a>';
-					echo '<b>', esc_html__( 'Family And Size', 'visualizer' ), '</b>';
+					echo '<b>', esc_html__( 'Font Family And Size', 'visualizer' ), '</b>';
 
 					echo '<table class="viz-section-table" cellspacing="0" cellpadding="0" border="0">';
 						echo '<tr>';
@@ -218,7 +218,7 @@ protected function _renderGeneralSettings() {
 					'legend[position]',
 					isset( $this->legend['position'] ) ? $this->legend['position'] : '',
 					$this->_legendPositions,
-					esc_html__( 'Determines where to place the legend, compared to the chart area.', 'visualizer' )
+					esc_html__( 'Sets the legend position relative to the chart.', 'visualizer' )
 				);
 
 				self::_renderSelectItem(
@@ -324,10 +324,10 @@ protected function _renderTooltipSettigns() {
 			array(
 				''          => esc_html__( 'Default', 'visualizer' ),
 				'focus'     => esc_html__( 'The tooltip will be displayed when the user hovers over an element', 'visualizer' ),
-				'selection' => esc_html__( 'The tooltip will be displayed when the user selects an element', 'visualizer' ),
+				'selection' => esc_html__( 'The tooltip will be displayed when the user selects an element.', 'visualizer' ),
 				'none'      => esc_html__( 'The tooltip will not be displayed', 'visualizer' ),
 			),
-			esc_html__( 'Determines the user interaction that causes the tooltip to be displayed.', 'visualizer' )
+			esc_html__( 'Controls when the tooltip appears.', 'visualizer' )
 		);
 
 		self::_renderSelectItem(
@@ -373,7 +373,7 @@ protected function _renderViewSettings() {
 
 				echo '<div class="viz-section-delimiter"></div>';
 
-				self::_renderSectionDescription( esc_html__( 'Configure the background color for the main area of the chart and the chart border width and color.', 'visualizer' ) );
+				self::_renderSectionDescription( esc_html__( 'Set the chart\'s background color, border width, and border color.', 'visualizer' ) );
 
 				self::_renderTextItem(
 					esc_html__( 'Stroke Width', 'visualizer' ),
@@ -447,7 +447,7 @@ protected function _renderViewSettings() {
 					echo '</table>';
 
 					echo '<p class="viz-section-description">';
-						esc_html_e( 'Determines the width and hight of the chart area.', 'visualizer' );
+						esc_html_e( 'Determines the width and height of the chart area.', 'visualizer' );
 					echo '</p>';
 				echo '</div>';
 			self::_renderSectionEnd();

classes/Visualizer/Render/Sidebar/Graph.php

@@ -192,7 +192,7 @@ protected function _renderHorizontalAxisGeneralSettings() {
 			isset( $this->hAxis['direction'] ) ? $this->hAxis['direction'] : '',
 			array(
 				''   => '',
-				'1'  => esc_html__( 'Identical Direction', 'visualizer' ),
+				'1'  => esc_html__( 'Default Direction', 'visualizer' ),
 				'-1' => esc_html__( 'Reverse Direction', 'visualizer' ),
 			),
 			esc_html__( 'The direction in which the values along the horizontal axis grow.', 'visualizer' )
@@ -307,7 +307,7 @@ protected function _renderVerticalAxisGeneralSettings() {
 			isset( $this->vAxis['direction'] ) ? $this->vAxis['direction'] : '',
 			array(
 				''   => '',
-				'1'  => esc_html__( 'Identical Direction', 'visualizer' ),
+				'1'  => esc_html__( 'Default Direction', 'visualizer' ),
 				'-1' => esc_html__( 'Reverse Direction', 'visualizer' ),
 			),
 			esc_html__( 'The direction in which the values along the vertical axis grow.', 'visualizer' )
@@ -479,7 +479,7 @@ protected function _renderHorizontalAxisFormatField() {
 				esc_html__( 'Enter custom format pattern to apply to horizontal axis labels.', 'visualizer' ),
 				sprintf(
 					// translators: %1$s - HTML link tag, %2$s - HTML closing link tag.
-					esc_html__( 'For number axis labels, this is a subset of the decimal formatting %1$sICU pattern set%2$s. For instance, $#,###.## will display values $1,234.56 for value 1234.56. Pay attention that if you use #%% percentage format then your values will be multiplied by 100.', 'visualizer' ),
+					esc_html__( 'For number axis labels, this is a subset of the decimal formatting %1$sICU pattern set%2$s. For instance, $#,###.## will display values $1,234.56 for value 1234.56. Note: Using the #%% percentage format will multiply your values by 100.', 'visualizer' ),
 					'<a href="http://icu-project.org/apiref/icu4c/classDecimalFormat.html#_details" target="_blank">',
 					'</a>'
 				),
@@ -510,7 +510,7 @@ protected function _renderVerticalAxisFormatField() {
 				esc_html__( 'Enter custom format pattern to apply to vertical axis labels.', 'visualizer' ),
 				sprintf(
 					// translators: %1$s - HTML link tag, %2$s - HTML closing link tag.
-					esc_html__( 'For number axis labels, this is a subset of the decimal formatting %1$sICU pattern set%2$s. For instance, $#,###.## will display values $1,234.56 for value 1234.56. Pay attention that if you use #&#37;&#37; percentage format then your values will be multiplied by 100.', 'visualizer' ),
+					esc_html__( 'For number axis labels, this is a subset of the decimal formatting %1$sICU pattern set%2$s. For instance, $#,###.## will display values $1,234.56 for value 1234.56. Note: Using the #&#37;&#37; percentage format will multiply your values by 100.', 'visualizer' ),
 					'<a href="http://icu-project.org/apiref/icu4c/classDecimalFormat.html#_details" target="_blank">',
 					'</a>'
 				),

classes/Visualizer/Render/Sidebar/Linear.php

@@ -185,11 +185,11 @@ protected function _renderLineSettingsItems() {
 				'single'   => esc_html__( 'Single data point', 'visualizer' ),
 				'multiple' => esc_html__( 'Multiple data points', 'visualizer' ),
 			),
-			esc_html__( 'Determines how many data points an user can select on a chart.', 'visualizer' )
+			esc_html__( 'Determines how many data points a user can select on a chart.', 'visualizer' )
 		);
 
 		self::_renderSelectItem(
-			esc_html__( 'Aggregation Target', 'visualizer' ),
+			esc_html__( 'Group Tooltips By', 'visualizer' ),
 			'aggregationTarget',
 			$this->aggregationTarget,
 			array(
@@ -199,7 +199,7 @@ protected function _renderLineSettingsItems() {
 				'auto'     => esc_html__( 'Group selected data by x-value if all selections have the same x-value, and by series otherwise', 'visualizer' ),
 				'none'     => esc_html__( 'Show only one tooltip per selection', 'visualizer' ),
 			),
-			esc_html__( 'Determines how multiple data selections are rolled up into tooltips. To make it working you need to set multiple selection mode and tooltip trigger to display it when an user selects an element.', 'visualizer' )
+			esc_html__( 'Determines how multiple data selections are rolled up into tooltips. To make it work, you need to set multiple selection mode and tooltip trigger to display it when a user selects an element.', 'visualizer' )
 		);
 
 		echo '<div class="viz-section-delimiter"></div>';