| // +----------------------------------------------------------------------+ /** * Base class for sidebar settings of linear based charts. * * @category Visualizer * @package Render * @subpackage Sidebar * * @since 1.0.0 * @abstract */ abstract class Visualizer_Render_Sidebar_Linear extends Visualizer_Render_Sidebar_Graph { /** * Determines whether we need to render curve type option or not. * * @since 1.0.0 * * @access protected * @var boolean */ protected $_includeCurveTypes; /** * The array of available curve types. * * @since 1.0.0 * * @access protected * @var array */ protected $_curveTypes; /** * Determines whether we need to render focus target option or not. * * @since 1.0.0 * * @access protected * @var boolean */ protected $_includeFocusTarget; /** * Constructor. * * @since 1.0.0 * * @access public * @param array $data The data what has to be associated with this render. */ public function __construct( $data = array() ) { parent::__construct( $data ); $this->_includeCurveTypes = true; $this->_includeFocusTarget = true; $this->_curveTypes = array( '' => '', 'none' => esc_html__( 'Straight line without curve', Visualizer_Plugin::NAME ), 'function' => esc_html__( 'The angles of the line will be smoothed', Visualizer_Plugin::NAME ), ); } /** * Renders general settings block for horizontal axis settings. * * @since 1.4.0 * * @access protected */ protected function _renderHorizontalAxisGeneratSettings() { parent::_renderHorizontalAxisGeneratSettings(); self::_renderTextItem( esc_html__( 'Number Format', Visualizer_Plugin::NAME ), 'hAxis[format]', isset( $this->hAxis['format'] ) ? $this->hAxis['format'] : '', sprintf( '%s

%s

%s', esc_html__( 'Enter custom format pattern to apply to horizontal axis labels.', Visualizer_Plugin::NAME ), sprintf( esc_html__( 'For number axis labels, this is a subset of the decimal formatting %sICU pattern set%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_Plugin::NAME ), '', '' ), sprintf( esc_html__( 'For date axis labels, this is a subset of the date formatting %sICU date and time format%s.', Visualizer_Plugin::NAME ), '', '' ) ) ); } /** * Renders general settings block for vertical axis settings. * * @since 1.4.0 * * @access protected */ protected function _renderVerticalAxisGeneralSettings() { parent::_renderVerticalAxisGeneralSettings(); self::_renderTextItem( esc_html__( 'Number Format', Visualizer_Plugin::NAME ), 'vAxis[format]', isset( $this->vAxis['format'] ) ? $this->vAxis['format'] : '', sprintf( '%s

%s', esc_html__( 'Enter custom format pattern to apply to vertical axis labels.', Visualizer_Plugin::NAME ), sprintf( esc_html__( 'For number axis labels, this is a subset of the decimal formatting %sICU pattern set%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_Plugin::NAME ), '', '' ) ) ); } /** * Renders line settings items. * * @since 1.0.0 * * @access protected */ protected function _renderLineSettingsItems() { echo '

'; echo '[?]'; echo '', esc_html__( 'Line Width And Point Size', Visualizer_Plugin::NAME ), ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo '

'; echo ''; echo '

'; echo '

'; esc_html_e( 'Data line width and diameter of displayed points in pixels. Use zero to hide all lines or points.', Visualizer_Plugin::NAME ); echo '

'; echo '

'; if ( $this->_includeCurveTypes ) { self::_renderSelectItem( esc_html__( 'Curve Type', Visualizer_Plugin::NAME ), 'curveType', $this->curveType, $this->_curveTypes, esc_html__( 'Determines whether the series has to be presented in the legend or not.', Visualizer_Plugin::NAME ) ); } echo '

'; if ( $this->_includeFocusTarget ) { self::_renderSelectItem( esc_html__( 'Focus Target', Visualizer_Plugin::NAME ), 'focusTarget', $this->focusTarget, array( '' => '', 'datum' => esc_html__( 'Focus on a single data point.', Visualizer_Plugin::NAME ), 'category' => esc_html__( 'Focus on a grouping of all data points along the major axis.', Visualizer_Plugin::NAME ), ), esc_html__( 'The type of the entity that receives focus on mouse hover. Also affects which entity is selected by mouse click.', Visualizer_Plugin::NAME ) ); } self::_renderSelectItem( esc_html__( 'Selection Mode', Visualizer_Plugin::NAME ), 'selectionMode', $this->selectionMode, array( '' => '', 'single' => esc_html__( 'Single data point', Visualizer_Plugin::NAME ), 'multiple' => esc_html__( 'Multiple data points', Visualizer_Plugin::NAME ), ), esc_html__( 'Determines how many data points an user can select on a chart.', Visualizer_Plugin::NAME ) ); self::_renderSelectItem( esc_html__( 'Aggregation Target', Visualizer_Plugin::NAME ), 'aggregationTarget', $this->aggregationTarget, array( '' => '', 'category' => esc_html__( 'Group selected data by x-value', Visualizer_Plugin::NAME ), 'series' => esc_html__( 'Group selected data by series', Visualizer_Plugin::NAME ), 'auto' => esc_html__( 'Group selected data by x-value if all selections have the same x-value, and by series otherwise', Visualizer_Plugin::NAME ), 'none' => esc_html__( 'Show only one tooltip per selection', Visualizer_Plugin::NAME ), ), 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_Plugin::NAME ) ); echo '

'; self::_renderTextItem( esc_html__( 'Point Opacity', Visualizer_Plugin::NAME ), 'dataOpacity', $this->dataOpacity, esc_html__( 'The transparency of data points, with 1.0 being completely opaque and 0.0 fully transparent.', Visualizer_Plugin::NAME ), '1.0' ); } /** * Renders lines settings. * * @since 1.0.0 * * @access protected */ protected function _renderLineSettings() { self::_renderGroupStart( esc_html__( 'Lines Settings', Visualizer_Plugin::NAME ) ); self::_renderSectionStart(); $this->_renderLineSettingsItems(); self::_renderSectionEnd(); self::_renderGroupEnd(); } /** * Renders concreate series settings. * * @since 1.0.0 * * @access protected * @param int $index The series index. */ protected function _renderSeries( $index ) { self::_renderSelectItem( esc_html__( 'Visible In Legend', Visualizer_Plugin::NAME ), 'series[' . $index . '][visibleInLegend]', isset( $this->series[$index]['visibleInLegend'] ) ? $this->series[$index]['visibleInLegend'] : '', array( '' => '', '0' => esc_html__( 'No', Visualizer_Plugin::NAME ), '1' => esc_html__( 'Yes', Visualizer_Plugin::NAME ), ), esc_html__( 'Determines whether the series has to be presented in the legend or not.', Visualizer_Plugin::NAME ) ); echo '

'; echo '[?]'; echo '', esc_html__( 'Line Width And Point Size', Visualizer_Plugin::NAME ), ''; echo ''; echo ''; echo ''; echo ''; echo ''; echo '

'; $line_width = isset( $this->series[$index]['lineWidth'] ) ? $this->series[$index]['lineWidth'] : ''; echo ''; echo '

'; $point_size = isset( $this->series[$index]['pointSize'] ) ? $this->series[$index]['pointSize'] : ''; echo ''; echo '

'; echo '

'; esc_html_e( 'Overrides the global line width and point size values for this series.', Visualizer_Plugin::NAME ); echo '

'; echo '

'; $this->_renderFormatField( $index ); if ( $this->_includeCurveTypes ) { self::_renderSelectItem( esc_html__( 'Curve Type', Visualizer_Plugin::NAME ), 'series[' . $index . '][curveType]', isset( $this->series[$index]['curveType'] ) ? $this->series[$index]['curveType'] : '', $this->_curveTypes, esc_html__( 'Determines whether the series has to be presented in the legend or not.', Visualizer_Plugin::NAME ) ); } self::_renderColorPickerItem( esc_html__( 'Color', Visualizer_Plugin::NAME ), 'series[' . $index . '][color]', isset( $this->series[$index]['color'] ) ? $this->series[$index]['color'] : null, null ); } }