• TName
• TProps
  • Methods
• TAppLink
• TDashboardLink
• TWidgetLink
• TParams
• TParamsPersisted
• TWidgetState
• TStatePersisted
• TEnabledPermit
  • enabled()
  • enabledWhen()
• TDetailAction
  • Customize detail modal
  • Parameters
• TExportable
  • Properties
  • Methods
• TDataSource
• TFields
• TEvent
  • Methods
• TAction
  • Action return

---

Traits

TName #

TName trait allows object to get or set name with name() method. The Dashboard and Widget are implemented this trait.

Example:

class MyClass
{
    use \koolreport\dashboard\TName;
}

$obj = new MyClass();
echo $obj->name();
// Output "MyClass"

$obj->name("this is my class");
echo $obj->name();
//Output "this is my class"

TProps #

TProps facilitate object to get/set property for an object.

Example:

// Example of using object with TProps trait

$object
    ->hidden(true)
    ->width(1/2)
    ->cssClass("bold")
    ->cssStyle(function(){
        return "text-align:right";
    });

echo $object->hidden(); //true
echo $object->width(); //1/2
echo $object->cssClass(); //bold

//Anynomous function
$func = $object->cssStyle(); // Object() function
echo $object->_cssStyle(); // "text-align:right"

Methods #

When TProps is implemented in an object, object has below methods

Example:

use \koolreport\dashboard\TProps;
use \koolreport\dashboard\TConstructServices;

class MyClass
{
    use TProps;
    use TConstructServices;

    public function __construct()
    {
        $this->constructServices();

        $this->props([
            "width"=>120,
            "height"=>240,
            "color"=>"red",
        ]);
    }
}

$obj = new MyClass;

$obj
->width(240)
->height(360)
->color("blue")
->title(function($text){
    return "Title ".$text;
});

echo $obj->width(); //240
echo $obj->color(); //"blue"

echo $obj->getProp("width"); //240
echo json_encode ($object->extractProps(["width","height"])); // {"width":240,"height":360}

echo $obj->hasProp("width")?"yes":"no"; // "yes"

$obj->removeProps(["width","height"]); // Now there is only "color" property

$a = $obj->getProps(["color","title"]); //$a = ["blue", object{}];

$a = $obj->_getProps(["color","title"],["text"=>"abc"]); // $a = ["blue","Title abc"];

$title = $obj->_getProp("title",["text"=>"abc"]); //$title = "Title abc";

$title = $obj->_title(["text"=>"abc"]); //$title = "Title abc";

TAppLink #

TAppLink trait contains app() function which allows get/set the application object. Dashboard, Widget, Request are implemented this trait.

Example:

$this->app(); //Get the app object

$this->app($app); //Set the app object

TDashboardLink #

TDashboardLink trait contains dashboard() function which allows get/set the dashboard object. Widget is implemented this trait.

Example:

$this->dashboard(); //Get the dashboard object

$this->dashboard($dashboard); //Set the dashboard object

TWidgetLink #

TWidgetLink trait contains widget() function which allows get/set the widget object. Field is implemented this trait.

Example:

$this->widget(); //Get the widget object

$this->widget($widget); //Set the dashboard object

TParams #

TParams provides params() method to object. Dashboard and Widget are implemented this trait.

Example:

//Set parameters
$this->params([
    "year"=>2020,
    "productId"=>30,
    "features"=>[
        "size"=>20,
        "color"=>"blue"
    ]
]);

//Set parameter with function
$this->params(function(){
    return [
        "year"=>2020,
        "productId"=>30,
    ];
})

$this->params(); //Get all params

echo $this->params("year"); // Get only year parameter

//Mutate value
$this->params("market","asia"); // Add a new parameter "market" with value "asia"

$this->params("market,function(){
    return "asia";
})

TParamsPersisted #

The TParamsPersisted often goes with TParams inside Widget and Dashboard. That makes parameters set via TParams will be value persisted.

TWidgetState #

If a widget is equipped with TWidgetState, it will be able to get/set state value via state() method

//Set state
$this->state([
    "pageSize"=>10,
    "pageIndex"=>1
]);

$this->state(function(){
    return [
        "pageSize"=>10,
        "pageIndex"=>1
    ];    
})

//Get whole state
$state = $this->state();

// Get a value
$pageSize = $this->state("pageSize");

//Set a key value
$this->state("pageSize",10);

$this->state("pageSize",function(){
    return 10;
});

TStatePersisted #

This trait if used inside your dashboard will make your dashboard state persisted. That means when you navigate to other dashboard and come back to the dashboard, the UI components will stay the same. All parameters or what you have selected will be preserved.

<?php
use \koolreport\dashboard\Dashboard;

class MyDashboard extends Dashboard
{
    use \koolreport\dashboard\TStatePersisted;
    ...
}

TEnabledPermit #

TEnabledPermit provides methods enabled() and enabledWhen() method to object. Dashboard, Widget and Field are implemented this trait.

enabled() #

Get or set the availability of object

Example:

$this->enabled(false); // Disable the object

// Set by function
$this->enabled(function($request) {
    return $request->user()->hasRole("admin");
});

// Get status
$enabled = $this->enabled();

enabledWhen() #

If your application is provided with Permit object then you can use enabledWhen()

Example:

$this->enabledWhen("beAdmin");

//The "beAdmin" is define like this

class Permit extends \koolreport\dashboard\Permit
{
    protected function beAdmin($request, $sender)
    {
        return $request->user()->hasRole("admin");
    }
}

//The Permit will be provided to Application like this:

class App extends \koolreport\dashboard\Application
{
    protected function permission()
    {
        return Permit::create();
    }
}

TDetailAction #

TDetailAction provides hosted class with ability to open detail modal. The object created by class will have a showDetail property to allow detail modal to be open. The hosted class also need to provide a custom detailModal() to define the content of modal.

For example, Google Chart's ColumnChart is included with TDetailAction so you can do:

class MyDashboard extends Dashboard
{
    protected function content()
    {
        return [
            ColumnChart::create("myChart")
                ->detailShowable(true),
            Button::create()->text("Show detail")
                ->onClick(
                    Client::widget("myChart")->showDetail()
                )
        ];
    }
}

Code explanation:

1. You allow ColumnChart to show detail data by setting ->detailShowable(true)
2. On button click at client-side, myChart will open detail modal and show its data

Customize detail modal #

You can change the detail modal content by overwriting the detailModal() method and return your own Modal:

use \koolreport\dashboard\containers\Modal;

class MyChart extends ColumnChart
{
    protected function detailModal($params=[])
    {
        return Modal::create()
                ->title("My Own Modal")
                ->sub([
                    //Anything
                ]);
    }
}

Parameters #

As you notice from above example, the detailModal() method receives an array as parameters. This is the parameters sent from trigger method showDetail() for example:

Client::widget("myChart")->showDetail([
    "key"=>"value"
])

TExportable #

TExportable is used inside Widget and Dashboard class. It provide exporting capability for the hosted class. Below are properties and methods added:

Properties #

Methods #

TDataSource #

TDataSource provides hosted class with dataSource() method which will be used to provide different type of datasource to hosted class.

TFields #

TFields provides hosted class with fields() method which will be used to fetch list of fields and their configuration for hosted class.

TEvent #

TEvent will add to hosted class ability to register an event and trigger an event.

Methods #

Example:

//Register an event
$this->registerEvent("Init",function(){
    echo "Init occur";
});

//Fire an event when somthing happens
$this->fireEvent("Init");

TAction #

TAction are used inside Dashboard and Widget so that they can receive action request from client-side.

When a object has TAction traits, you will be able to create actions by two ways:

First way: Inside class

class MyObject
{
    protected function actionAnyAction($request,$response)
    {
        //Do something
    }
}

Second way: On the object

MyObject::create()
    ->action("anyAction",function($request, $response){
        // Do something
    })

Action return #

Within the handling function of action, we can trigger javascript to run at clientside or open an notification:

Javascript: Some javacript to run at client-side

class MyObject
{
    protected function actionAnyAction($request,$response)
    {
        //Response with some javascript code

        return "alert('something to notice')";

        return Client::app()->changeLanguage("ES"); // Javacript to change language

        return Client::logout();

        return "console.log('what a good day');";
    }
}

Notification: Show notification of success or failure

use koolreport\dashboard\notifications\Alert;
use koolreport\dashboard\notifications\Note;
use koolreport\dashboard\notifications\Confirm;
class MyObject
{
    protected function actionAnyAction($request,$response)
    {
        //Response with some javascript code

        return Alert::danger("The process has failed");

        return Note::success("The process has done");

        return Confirm::info("Please confirm your action");
    }
}

To understand more about $request and $response in action, please visit Request & Response.