| @@ -83,8 +83,24 @@ | ||
| 83 | 83 | */ |
| 84 | 84 | protected $_alignments; |
| 85 | 85 | |
| 86 | 86 | /** |
| 87 | + * Whether this chart supports animation or not. | |
| 88 | + * | |
| 89 | + * @access protected | |
| 90 | + * @var bool | |
| 91 | + */ | |
| 92 | + protected $_supportsAnimation = true; | |
| 93 | + | |
| 94 | + /** | |
| 95 | + * Which library does this this chart implement? | |
| 96 | + * | |
| 97 | + * @access protected | |
| 98 | + * @var string | |
| 99 | + */ | |
| 100 | + protected $_library = null; | |
| 101 | + | |
| 102 | + /** | |
| 87 | 103 | * Constructor. |
| 88 | 104 | * |
| 89 | 105 | * @since 1.0.0 |
| 90 | 106 | * |
| @@ -115,8 +131,10 @@ | ||
| 115 | 131 | '' => '', |
| 116 | 132 | '1' => esc_html__( 'Yes', 'visualizer' ), |
| 117 | 133 | '0' => esc_html__( 'No', 'visualizer' ), |
| 118 | 134 | ); |
| 135 | + | |
| 136 | + $this->hooks(); | |
| 119 | 137 | } |
| 120 | 138 | |
| 121 | 139 | /** |
| 122 | 140 | * Renders chart title settings. |
| @@ -141,8 +159,31 @@ | ||
| 141 | 159 | ); |
| 142 | 160 | } |
| 143 | 161 | |
| 144 | 162 | /** |
| 163 | + * Add the correct description for the manual configuration box. | |
| 164 | + */ | |
| 165 | + protected function _renderManualConfigDescription() { | |
| 166 | + self::_renderSectionStart(); | |
| 167 | + self::_renderSectionDescription( '<span class="viz-gvlink">' . sprintf( __( 'Configure the graph by providing configuration variables right from the %1$sGoogle Visualization API%2$s. You can refer to to some examples %3$shere%4$s.', 'visualizer' ), '<a href="https://developers.google.com/chart/interactive/docs/gallery/?#configuration-options" target="_blank">', '</a>', '<a href="https://docs.themeisle.com/article/728-manual-configuration" target="_blank">', '</a>' ) . '</span>' ); | |
| 168 | + } | |
| 169 | + | |
| 170 | + /** | |
| 171 | + * Add the correct example for the manual configuration box. | |
| 172 | + */ | |
| 173 | + protected function _renderManualConfigExample() { | |
| 174 | + return '{ | |
| 175 | + "vAxis": { | |
| 176 | + "ticks": [5, 10, 15, 20], | |
| 177 | + "titleTextStyle": { | |
| 178 | + "color": "red" | |
| 179 | + }, | |
| 180 | + "textPosition": "in" | |
| 181 | + } | |
| 182 | + }'; | |
| 183 | + } | |
| 184 | + | |
| 185 | + /** | |
| 145 | 186 | * Renders chart advanced settings group. |
| 146 | 187 | * |
| 147 | 188 | * @access protected |
| 148 | 189 | */ |
| @@ -148,9 +189,9 @@ | ||
| 148 | 189 | */ |
| 149 | 190 | protected function _renderAdvancedSettings() { |
| 150 | 191 | self::_renderGroupStart( esc_html__( 'Frontend Actions', 'visualizer' ) ); |
| 151 | 192 | self::_renderSectionStart(); |
| 152 | - self::_renderSectionDescription( esc_html__( 'Configure frontend actions here.', 'visualizer' ) ); | |
| 193 | + self::_renderSectionDescription( esc_html__( 'Configure frontend actions that need to be shown.', 'visualizer' ) ); | |
| 153 | 194 | self::_renderSectionEnd(); |
| 154 | 195 | |
| 155 | 196 | $this->_renderActionSettings(); |
| 156 | 197 | self::_renderGroupEnd(); |
| @@ -155,28 +196,16 @@ | ||
| 155 | 196 | $this->_renderActionSettings(); |
| 156 | 197 | self::_renderGroupEnd(); |
| 157 | 198 | |
| 158 | 199 | self::_renderGroupStart( esc_html__( 'Manual Configuration', 'visualizer' ) ); |
| 159 | - self::_renderSectionStart(); | |
| 160 | - self::_renderSectionDescription( __( 'Configure the graph by providing configuration variables right from the', 'visualizer' ) . ' <a href="https://developers.google.com/chart/interactive/docs/reference" target="_blank">Google Visualization</a> API.' ); | |
| 161 | - | |
| 162 | - $example = ' | |
| 163 | -{ | |
| 164 | - "vAxis": { | |
| 165 | - "ticks": [5, 10, 15, 20], | |
| 166 | - "titleTextStyle": { | |
| 167 | - "color": "red" | |
| 168 | - }, | |
| 169 | - "textPosition": "in" | |
| 170 | - } | |
| 171 | -}'; | |
| 172 | - | |
| 200 | + $this->_renderManualConfigDescription(); | |
| 173 | 201 | self::_renderTextAreaItem( |
| 174 | 202 | esc_html__( 'Configuration', 'visualizer' ), |
| 175 | 203 | 'manual', |
| 176 | 204 | $this->manual, |
| 177 | 205 | sprintf( |
| 178 | - esc_html__( 'One per line in valid JSON (key:value) format e.g. %s', 'visualizer' ), '<br><code>' . $example . '</code>' | |
| 206 | + esc_html__( 'One per line in valid JSON (key:value) format e.g. %s', 'visualizer' ), | |
| 207 | + '<br><code>' . $this->_renderManualConfigExample() . '</code>' | |
| 179 | 208 | ), |
| 180 | 209 | '', |
| 181 | 210 | array( 'rows' => 5 ) |
| 182 | 211 | ); |
| @@ -197,27 +226,27 @@ | ||
| 197 | 226 | self::_renderSectionStart( esc_html__( 'Actions', 'visualizer' ), false ); |
| 198 | 227 | self::_renderCheckboxItem( |
| 199 | 228 | esc_html__( 'Print', 'visualizer' ), |
| 200 | 229 | 'actions[]', |
| 201 | - isset( $this->actions ) && in_array( 'print', $this->actions ) ? true : false, | |
| 230 | + isset( $this->actions ) && in_array( 'print', $this->actions, true ) ? true : false, | |
| 202 | 231 | 'print', |
| 203 | - $disable_actions ? '<span class="viz-section-error">' . esc_html__( 'Upgrade to at least WordPress 4.7 to use this.', 'visualizer' ) . '</span>' : esc_html__( 'To enable printing the data.', 'visualizer' ), | |
| 232 | + $disable_actions ? '<span class="viz-section-error">' . esc_html__( 'Upgrade to at least WordPress 4.7 to use this.', 'visualizer' ) . '</span>' : esc_html__( 'To enable printing the chart/data.', 'visualizer' ), | |
| 204 | 233 | $disable_actions |
| 205 | 234 | ); |
| 206 | 235 | self::_renderCheckboxItem( |
| 207 | 236 | esc_html__( 'CSV', 'visualizer' ), |
| 208 | 237 | 'actions[]', |
| 209 | - isset( $this->actions ) && in_array( 'csv;application/csv', $this->actions ) ? true : false, | |
| 238 | + isset( $this->actions ) && in_array( 'csv;application/csv', $this->actions, true ) ? true : false, | |
| 210 | 239 | 'csv;application/csv', |
| 211 | 240 | $disable_actions ? '<span class="viz-section-error">' . esc_html__( 'Upgrade to at least WordPress 4.7 to use this.', 'visualizer' ) . '</span>' : esc_html__( 'To enable downloading the data as a CSV.', 'visualizer' ), |
| 212 | 241 | $disable_actions |
| 213 | 242 | ); |
| 214 | 243 | |
| 215 | - $disabled = ! ( class_exists( 'PHPExcel' ) && extension_loaded( 'zip' ) && extension_loaded( 'xml' ) && version_compare( PHP_VERSION, '5.2.0', '>' ) ); | |
| 244 | + $disabled = ! self::is_excel_enabled(); | |
| 216 | 245 | self::_renderCheckboxItem( |
| 217 | 246 | esc_html__( 'Excel', 'visualizer' ), |
| 218 | 247 | 'actions[]', |
| 219 | - isset( $this->actions ) && in_array( 'xls;application/vnd.ms-excel', $this->actions ) ? true : false, | |
| 248 | + isset( $this->actions ) && in_array( 'xls;application/vnd.ms-excel', $this->actions, true ) ? true : false, | |
| 220 | 249 | 'xls;application/vnd.ms-excel', |
| 221 | 250 | $disable_actions ? '<span class="viz-section-error">' . esc_html__( 'Upgrade to at least WordPress 4.7 to use this.', 'visualizer' ) . '</span>' : ( $disabled ? '<span class="viz-section-error">' . esc_html__( 'Enable the ZIP and XML extensions to use this setting.', 'visualizer' ) . '</span>' : esc_html__( 'To enable downloading the data as an Excel spreadsheet.', 'visualizer' ) ), |
| 222 | 251 | $disable_actions || $disabled |
| 223 | 252 | ); |
| @@ -223,9 +252,9 @@ | ||
| 223 | 252 | ); |
| 224 | 253 | self::_renderCheckboxItem( |
| 225 | 254 | esc_html__( 'Copy', 'visualizer' ), |
| 226 | 255 | 'actions[]', |
| 227 | - isset( $this->actions ) && in_array( 'copy', $this->actions ) ? true : false, | |
| 256 | + isset( $this->actions ) && in_array( 'copy', $this->actions, true ) ? true : false, | |
| 228 | 257 | 'copy', |
| 229 | 258 | $disable_actions ? '<span class="viz-section-error">' . esc_html__( 'Upgrade to at least WordPress 4.7 to use this.', 'visualizer' ) . '</span>' : esc_html__( 'To enable copying the data to the clipboard.', 'visualizer' ), |
| 230 | 259 | $disable_actions |
| 231 | 260 | ); |
| @@ -232,8 +261,25 @@ | ||
| 232 | 261 | self::_renderSectionEnd(); |
| 233 | 262 | } |
| 234 | 263 | |
| 235 | 264 | /** |
| 265 | + * Checks if the Excel module can be enabled. | |
| 266 | + */ | |
| 267 | + private static function is_excel_enabled() { | |
| 268 | + $vendor_file = VISUALIZER_ABSPATH . '/vendor/autoload.php'; | |
| 269 | + if ( is_readable( $vendor_file ) ) { | |
| 270 | + include_once( $vendor_file ); | |
| 271 | + } | |
| 272 | + | |
| 273 | + if ( version_compare( phpversion(), '5.6.0', '<' ) ) { | |
| 274 | + do_action( 'themeisle_log_event', Visualizer_Plugin::NAME, sprintf( 'PHP version %s not supported', phpversion() ), 'error', __FILE__, __LINE__ ); | |
| 275 | + return false; | |
| 276 | + } | |
| 277 | + | |
| 278 | + return class_exists( 'PhpOffice\PhpSpreadsheet\Spreadsheet' ) && extension_loaded( 'zip' ) && extension_loaded( 'xml' ) && extension_loaded( 'fileinfo' ); | |
| 279 | + } | |
| 280 | + | |
| 281 | + /** | |
| 236 | 282 | * Renders chart general settings group. |
| 237 | 283 | * |
| 238 | 284 | * @since 1.0.0 |
| 239 | 285 | * |
| @@ -310,12 +356,63 @@ | ||
| 310 | 356 | |
| 311 | 357 | self::_renderSectionStart( esc_html__( 'Tooltip', 'visualizer' ), false ); |
| 312 | 358 | $this->_renderTooltipSettigns(); |
| 313 | 359 | self::_renderSectionEnd(); |
| 360 | + | |
| 361 | + $this->_renderAnimationSettings(); | |
| 362 | + | |
| 363 | + do_action( 'visualizer_chart_settings', get_class( $this ), $this->_data, 'general', array( 'generic' => true ) ); | |
| 364 | + | |
| 314 | 365 | self::_renderGroupEnd(); |
| 315 | 366 | } |
| 316 | 367 | |
| 317 | 368 | /** |
| 369 | + * Renders animation settings section. | |
| 370 | + * | |
| 371 | + * @access protected | |
| 372 | + */ | |
| 373 | + protected function _renderAnimationSettings() { | |
| 374 | + if ( ! $this->_supportsAnimation ) { | |
| 375 | + return; | |
| 376 | + } | |
| 377 | + | |
| 378 | + self::_renderSectionStart( esc_html__( 'Animation', 'visualizer' ), false ); | |
| 379 | + | |
| 380 | + self::_renderCheckboxItem( | |
| 381 | + esc_html__( 'Animate on startup', 'visualizer' ), | |
| 382 | + 'animation[startup]', | |
| 383 | + isset( $this->animation['startup'] ) ? $this->animation['startup'] : 0, | |
| 384 | + true, | |
| 385 | + esc_html__( 'Determines if the chart will animate on the initial draw.', 'visualizer' ) | |
| 386 | + ); | |
| 387 | + | |
| 388 | + self::_renderTextItem( | |
| 389 | + esc_html__( 'Duration', 'visualizer' ), | |
| 390 | + 'animation[duration]', | |
| 391 | + isset( $this->animation['duration'] ) ? $this->animation['duration'] : 0, | |
| 392 | + esc_html__( 'The duration of the animation, in milliseconds', 'visualizer' ), | |
| 393 | + 0, | |
| 394 | + 'number' | |
| 395 | + ); | |
| 396 | + | |
| 397 | + self::_renderSelectItem( | |
| 398 | + esc_html__( 'Easing', 'visualizer' ), | |
| 399 | + 'animation[easing]', | |
| 400 | + isset( $this->animation['easing'] ) ? $this->animation['easing'] : null, | |
| 401 | + array( | |
| 402 | + 'linear' => esc_html__( 'Constant speed', 'visualizer' ), | |
| 403 | + 'in' => esc_html__( 'Start slow and speed up', 'visualizer' ), | |
| 404 | + 'out' => esc_html__( 'Start fast and slow down', 'visualizer' ), | |
| 405 | + 'inAndOut' => esc_html__( 'Start slow, speed up, then slow down', 'visualizer' ), | |
| 406 | + ), | |
| 407 | + esc_html__( 'The easing function applied to the animation.', 'visualizer' ) | |
| 408 | + ); | |
| 409 | + | |
| 410 | + self::_renderSectionEnd(); | |
| 411 | + | |
| 412 | + } | |
| 413 | + | |
| 414 | + /** | |
| 318 | 415 | * Renders tooltip settings section. |
| 319 | 416 | * |
| 320 | 417 | * @since 1.4.0 |
| 321 | 418 | * |
| @@ -351,10 +448,10 @@ | ||
| 351 | 448 | * |
| 352 | 449 | * @access protected |
| 353 | 450 | */ |
| 354 | 451 | protected function _renderViewSettings() { |
| 355 | - self::_renderGroupStart( esc_html__( 'Layout & Chart Area', 'visualizer' ) ); | |
| 356 | - self::_renderSectionStart( esc_html__( 'Layout', 'visualizer' ), false ); | |
| 452 | + self::_renderGroupStart( esc_html__( 'Chart Size & Placement', 'visualizer' ) ); | |
| 453 | + self::_renderSectionStart( esc_html__( 'Chart Size/Layout', 'visualizer' ), false ); | |
| 357 | 454 | self::_renderSectionDescription( esc_html__( 'Configure the total size of the chart. Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage.', 'visualizer' ) ); |
| 358 | 455 | |
| 359 | 456 | echo '<div class="viz-section-item">'; |
| 360 | 457 | echo '<a class="more-info" href="javascript:;">[?]</a>'; |
| @@ -371,9 +468,9 @@ | ||
| 371 | 468 | echo '</tr>'; |
| 372 | 469 | echo '</table>'; |
| 373 | 470 | |
| 374 | 471 | echo '<p class="viz-section-description">'; |
| 375 | - esc_html_e( 'Determines the total width and height of the chart.', 'visualizer' ); | |
| 472 | + esc_html_e( 'Determines the total width and height of the chart. This will only show in the front-end.', 'visualizer' ); | |
| 376 | 473 | echo '</p>'; |
| 377 | 474 | echo '</div>'; |
| 378 | 475 | |
| 379 | 476 | echo '<div class="viz-section-delimiter"></div>'; |
| @@ -410,9 +507,9 @@ | ||
| 410 | 507 | echo '</label>'; |
| 411 | 508 | echo '</div>'; |
| 412 | 509 | self::_renderSectionEnd(); |
| 413 | 510 | |
| 414 | - self::_renderSectionStart( esc_html__( 'Chart Area', 'visualizer' ), false ); | |
| 511 | + self::_renderSectionStart( esc_html__( 'Placement', 'visualizer' ), false ); | |
| 415 | 512 | self::_renderSectionDescription( esc_html__( 'Configure the placement and size of the chart area (where the chart itself is drawn, excluding axis and legends). Two formats are supported: a number, or a number followed by %. A simple number is a value in pixels; a number followed by % is a percentage.', 'visualizer' ) ); |
| 416 | 513 | |
| 417 | 514 | echo '<div class="viz-section-item">'; |
| 418 | 515 | echo '<a class="more-info" href="javascript:;">[?]</a>'; |
| @@ -484,8 +581,9 @@ | ||
| 484 | 581 | echo '<a class="more-info" href="javascript:;">[?]</a>'; |
| 485 | 582 | echo '<b>', $title, '</b>'; |
| 486 | 583 | echo '<select class="control-select ', implode( ' ', $classes ) , '" name="', $name, '" ', ( $multiple ? 'multiple' : '' ), ' ' , $atts, '>'; |
| 487 | 584 | foreach ( $options as $key => $label ) { |
| 585 | + // phpcs:ignore WordPress.PHP.StrictInArray.MissingTrueStrict | |
| 488 | 586 | $extra = $multiple && is_array( $value ) ? ( in_array( $key, $value ) ? 'selected' : '' ) : selected( $key, $value, false ); |
| 489 | 587 | echo '<option value="', $key, '"', $extra, '>'; |
| 490 | 588 | echo $label; |
| 491 | 589 | echo '</option>'; |
| @@ -510,9 +608,9 @@ | ||
| 510 | 608 | protected static function _renderColorPickerItem( $title, $name, $value, $default ) { |
| 511 | 609 | echo '<div class="viz-section-item">'; |
| 512 | 610 | echo '<b>', $title, '</b>'; |
| 513 | 611 | echo '<div>'; |
| 514 | - echo '<input type="text" class="color-picker-hex" name="', $name, '" maxlength="7" placeholder="', esc_attr__( 'Hex Value', 'visualizer' ), '" value="', is_null( $value ) ? $default : esc_attr( $value ), '" data-default-color="', $default, '">'; | |
| 612 | + echo '<input type="text" class="color-picker-hex color-picker" data-alpha="true" name="', $name, '" maxlength="7" placeholder="', esc_attr__( 'Hex Value', 'visualizer' ), '" value="', is_null( $value ) ? $default : esc_attr( $value ), '" data-default-color="', $default, '">'; | |
| 515 | 613 | echo '</div>'; |
| 516 | 614 | echo '</div>'; |
| 517 | 615 | } |
| 518 | 616 | |
| @@ -621,11 +719,11 @@ | ||
| 621 | 719 | * @static |
| 622 | 720 | * @access public |
| 623 | 721 | * @param string $description The description text. |
| 624 | 722 | */ |
| 625 | - public static function _renderSectionDescription( $description ) { | |
| 723 | + public static function _renderSectionDescription( $description, $classes = '' ) { | |
| 626 | 724 | echo '<div class="viz-section-item">'; |
| 627 | - echo '<div class="viz-section-description">', $description, '</div>'; | |
| 725 | + echo '<div class="viz-section-description ' . $classes . '">', $description, '</div>'; | |
| 628 | 726 | echo '</div>'; |
| 629 | 727 | } |
| 630 | 728 | |
| 631 | 729 | /** |
| @@ -667,8 +765,9 @@ | ||
| 667 | 765 | protected static function _renderCheckboxItem( $title, $name, $value, $default, $desc, $disabled = false ) { |
| 668 | 766 | echo '<div class="viz-section-item">'; |
| 669 | 767 | echo '<a class="more-info" href="javascript:;">[?]</a>'; |
| 670 | 768 | echo '<b>', $title, '</b>'; |
| 769 | + // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison | |
| 671 | 770 | echo '<input type="checkbox" class="control-check" value="', $default, '" name="', $name, '" ', ( $value == $default ? 'checked' : '' ), ' ', ( $disabled ? 'disabled=disabled' : '' ), '>'; |
| 672 | 771 | echo '<p class="viz-section-description">', $desc, '</p>'; |
| 673 | 772 | echo '</div>'; |
| 674 | 773 | } |
| @@ -690,5 +789,25 @@ | ||
| 690 | 789 | echo '<p class="viz-section-description">', $desc, '</p>'; |
| 691 | 790 | echo '</div>'; |
| 692 | 791 | } |
| 693 | 792 | |
| 793 | + /** | |
| 794 | + * Returns the library this chart implements. | |
| 795 | + */ | |
| 796 | + public function getLibrary() { | |
| 797 | + return $this->_library; | |
| 798 | + } | |
| 799 | + | |
| 800 | + /** | |
| 801 | + * Loads generic libraries conditionally. | |
| 802 | + */ | |
| 803 | + protected function load_dependent_assets( $libs ) { | |
| 804 | + if ( in_array( 'moment', $libs, true ) && ! wp_script_is( 'moment', 'registered' ) ) { | |
| 805 | + wp_register_script( 'moment', VISUALIZER_ABSURL . 'js/lib/moment.min.js', array(), Visualizer_Plugin::VERSION ); | |
| 806 | + } | |
| 807 | + | |
| 808 | + if ( in_array( 'numeral', $libs, true ) && ! wp_script_is( 'numeral', 'registered' ) ) { | |
| 809 | + wp_register_script( 'numeral', VISUALIZER_ABSURL . 'js/lib/numeral.min.js', array(), Visualizer_Plugin::VERSION ); | |
| 810 | + } | |
| 811 | + | |
| 812 | + } | |
| 694 | 813 | } |
