Getting Started

Customization refers to a series of actions that enable you to personalize your agent, data source, or collection.
An agent is an HTTP server that serves the Forest Admin front-end application. A data source is a database or an API that you want to connect to Forest Admin. A collection is a set of data that you want to manage in Forest Admin.
Among other things, you can modify your agent by incorporating data sources, using plugins, customizing collections, and adding charts. Additionally, you can personalize your data sources by offering choices that cater to all data source types. Lastly, you can adapt your collections by including actions, fields, relations, segments between the data sources and other functionalities.
Customizing your collection
To learn more about the customization options available to you, see the following menu.
To customize a collection, your best bet is to use the customizeCollection method.
The customizeCollection method allows you to customize a collection's behavior.
This method takes two parameters:
The name of the collection you want to customize.
The function that defines the customizations you want to make.
Usage
For the example below we will customize the task and user collections from a datasource.
use ForestAdmin\AgentPHP\Agent\Utils\Env;
use ForestAdmin\AgentPHP\DatasourceCustomizer\CollectionCustomizer;
use ForestAdmin\AgentPHP\DatasourceCustomizer\Decorators\Computed\ComputedDefinition;
​
$forestAgent->addDatasource(
    new DoctrineDatasource($forestAgent->getEntityManager(), ['url' => Env::get('DATABASE_URL')])
)
    ->customizeCollection(
        'Task',
        function (CollectionCustomizer $builder) {
            $builder->addField('title', new ComputedDefinition(/* ... field definition ... */));
        }
    )
    ->customizeCollection(
        'User',
        function (CollectionCustomizer $builder) {
            $builder->addField('name', new ComputedDefinition(/* ... field definition ... */));
        }
    );
​
Last modified 1mo ago