sydney/IPB
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Version 5.0.0 beta 1

Browse Source
This commit is contained in:
Neo committed 2025-12-19 16:27:35 -08:00
1 parent 25ddeb65d6
commit 15c7beabc5
6736 files changed
+627902 -497943
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

system/Helpers/Chart/Chart.php
+51 -34
View File
@@ -11,9 +11,26 @@
namespace IPS\Helpers;
/* To prevent PHP errors (extending class does not exist) revealing path */
if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) )
use InvalidArgumentException;
use IPS\DateTime;
use IPS\Output;
use IPS\Request;
use IPS\Theme;
use LengthException;
use LogicException;
use function count;
use function defined;
use function in_array;
use function is_array;
use function is_bool;
use function is_null;
use function is_numeric;
use function is_string;
if ( !defined( '\IPS\SUITE_UNIQUE_KEY' ) )
{
header( ( isset( $_SERVER['SERVER_PROTOCOL'] ) ? $_SERVER['SERVER_PROTOCOL'] : 'HTTP/1.0' ) . ' 403 Forbidden' );
header( ( $_SERVER['SERVER_PROTOCOL'] ?? 'HTTP/1.0' ) . ' 403 Forbidden' );
exit;
}
@@ -38,30 +55,30 @@ if ( !\defined( '\IPS\SUITE_UNIQUE_KEY' ) )
) );
* @endcode
*/
class _Chart
class Chart
{
/**
* @brief Headers
* @see addHeader();
*/
public $headers = array();
public array $headers = array();
/**
* @brief Rows
* @see addHeader();
*/
public $rows = array();
public array $rows = array();
/**
* @brief Google Charts will assume numbers can be negative, which can produce graphs showing negative data points if no data is provided. The default baheviour is to set the minimum value to 0. Change this property if the chart should be able to show negative number values.
*/
public $numbersCanBeNegative = FALSE;
public bool $numbersCanBeNegative = FALSE;
/**
* Add Header
*
* @param string $label Label
* @param string $type Type of value
* @param string $label Label
* @param string $type Type of value
* @li string
* @li number
* @li boolean
@@ -70,7 +87,7 @@ class _Chart
* @li timeofday
* @return void
*/
public function addHeader( $label, $type )
public function addHeader( string $label, string $type ) : void
{
$this->headers[] = array( 'label' => $label, 'type' => $type );
}
@@ -78,55 +95,55 @@ class _Chart
/**
* Add Row
*
* @param array $values Values, in the order that headers were added
* @param array $values Values, in the order that headers were added
* @return void
* @throws \LogicException
* @throws LogicException
*/
public function addRow( $values )
public function addRow( array $values ) : void
{
if ( \count( $values ) !== \count( $this->headers ) )
if ( count( $values ) !== count( $this->headers ) )
{
throw new \LengthException('COLUMN_COUNT_MISMATCH');
throw new LengthException('COLUMN_COUNT_MISMATCH');
}
$i = 0;
$values = array_values( $values );
foreach ( $this->headers as $data )
{
$value = \is_array( $values[ $i ] ) ? $values[ $i ]['value'] : $values[ $i ];
$value = is_array( $values[ $i ] ) ? $values[ $i ]['value'] : $values[ $i ];
switch ( $data['type'] )
{
case 'string':
if ( !\is_string( $value ) )
if ( !is_string( $value ) )
{
throw new \InvalidArgumentException( "VALUE_{$i}_NOT_STRING" );
throw new InvalidArgumentException( "VALUE_{$i}_NOT_STRING" );
}
break;
case 'number':
if ( !\is_numeric( $value ) and !\is_null( $value ) )
if ( !is_numeric( $value ) and !is_null( $value ) )
{
throw new \InvalidArgumentException( "VALUE_{$i}_NOT_NUMBER" );
throw new InvalidArgumentException( "VALUE_{$i}_NOT_NUMBER" );
}
break;
case 'bool':
if ( !\is_bool( $value ) )
if ( !is_bool( $value ) )
{
throw new \InvalidArgumentException( "VALUE_{$i}_NOT_BOOL" );
throw new InvalidArgumentException( "VALUE_{$i}_NOT_BOOL" );
}
break;
case 'date':
case 'datetime':
case 'timeofday':
if ( !( $value instanceof \IPS\DateTime ) )
if ( !( $value instanceof DateTime ) )
{
throw new \InvalidArgumentException( "VALUE_{$i}_NOT_DATETIME" );
throw new InvalidArgumentException( "VALUE_{$i}_NOT_DATETIME" );
}
if ( \is_array( $values[ $i ] ) )
if ( is_array( $values[ $i ] ) )
{
$values[ $i ]['value'] = $value->rfc3339();
}
@@ -145,25 +162,25 @@ class _Chart
/**
* Render
*
* @param string $type Type
* @param array $options Options
* @param string $format Value for number formatter
* @see <a href='https://google-developers.appspot.com/chart/interactive/docs/gallery'>Charts Gallery - Google Charts - Google Developers</a>
* @param string $type Type
* @param array $options Options
* @param string|null $format Value for number formatter
* @return string
*@see <a href='https://google-developers.appspot.com/chart/interactive/docs/gallery'>Charts Gallery - Google Charts - Google Developers</a>
*/
public function render( $type, $options=array(), $format=NULL )
public function render( string $type, array $options=array(), string $format=NULL ): string
{
if ( !\IPS\Request::i()->isAjax() )
if ( !Request::i()->isAjax() )
{
\IPS\Output::i()->jsFiles[] = 'https://www.gstatic.com/charts/loader.js';
\IPS\Output::i()->headJs .= "google.charts.load( '47', { 'packages':['corechart'] } );";
Output::i()->jsFiles[] = 'https://www.gstatic.com/charts/loader.js';
Output::i()->headJs .= "google.charts.load( '47', { 'packages':['corechart'] } );";
}
if ( !$this->numbersCanBeNegative and \in_array( $type, array( 'LineChart', 'ColumnChart' ) ) and !isset( $options['vAxis']['viewWindow']['min'] ) )
if ( !$this->numbersCanBeNegative and in_array( $type, array( 'LineChart', 'ColumnChart' ) ) and !isset( $options['vAxis']['viewWindow']['min'] ) )
{
$options['vAxis']['viewWindow']['min'] = 0;
}
return \IPS\Theme::i()->getTemplate( 'global', 'core', 'global' )->chart( $this, $type, json_encode( $options ), $format );
return Theme::i()->getTemplate( 'global', 'core', 'global' )->chart( $this, $type, json_encode( $options ), $format );
}
}