data:
  loader: yaml
  options:
    type: 'folder'
    path: 'data/database/'

fal:
  storages:
    - identifier: default
      storagePath: fileadmin/

ordering:
  fe_users:
    after: [ "fe_groups" ]
  tt_content:
    after: [ "sys_category" ]

operations:
  envFileGenerator:
    envFiles:
      pids:
        path: pids.env
        values:
          PID_404: "{pages:404:uid}"

_variables:
  paragraph: "<p>Lorem ipsum dolor sit amet, <a href=\"t3://page?uid={pages:home}\">consetetur</a> sadipscing elitr</p>"

tt_content:
  - identifier: example
    pid: "{pages:home}"
    CType: text
    bodytext: "{variable:paragraph}"

pages:
  - identifier: home
    pid: "{pages:root}"
    sorting: 100
    doktype: 1
    title: Home
    is_siteroot: 1

tt_content:
  - identifier: example
    pid: "{pages:home}"
    CType: heaader
    header: My example content
    header_layout: 1

pages:
  - identifier: home
    pid: "{pages:root}"
    sorting: 100
    doktype: 1
    title: Home
    # Slugs are generated automatically for pages
    is_siteroot: 1

tt_content:
  - identifier: example
    pid: "{pages:home}"
    CType: heaader
    header: My example content
    header_layout: 1

<?php

namespace MyVendor\MyExtension\Operation;

use KM2\DataSeeder\Attribute\Operation;
use KM2\DataSeeder\Operation\OperationInterface;

#[Operation(identifier: 'my-custom-operation', beforeDataSeeding: true)]
class MyCustomOperation implements OperationInterface
{
    public function run(Configuration $configuration, VariableCollection $variables, ?RootNode $rootNode): void
    {
        // $rootNode is null for operations executed before data seeding.
        echo "This operation is executed before data seeding.";
    }
}

<?php

namespace MyVendor\MyExtension\Operation;

use KM2\DataSeeder\Attribute\Operation;
use KM2\DataSeeder\Operation\OperationInterface;

#[Operation(identifier: 'my-custom-operation')]
class MyCustomOperation implements OperationInterface
{
    public function run(Configuration $configuration, VariableCollection $variables, ?RootNode $rootNode): void
    {
        echo "This operation is executed after data seeding.";
    }
}

<?php

namespace MyVendor\MyExtension\Loaders;

use KM2\DataSeeder\Attribute\DataLoader;
use KM2\DataSeeder\DataHandling\Loader\DataLoaderInterface;

#[DataLoader(identifier: 'myLoader')]
class MyCustomOperation implements OperationInterface
{
    public function load(array $options = []): SeedingData
    {
        $variables = new VariableCollection($options['variables']);
        $staticData = [
            'pages' => [
                [
                    'identifier' => 'home',
                    'pid' => '{pages:root}',
                    'title' => 'Home',
                    'doktype' => '{variable:defaultPageType}',
                ],
            ],
        ];

        return new SeedingData($staticData, $variables);
    }
}

data:
  loader: myLoader
  options:
    variables:
      defaultPageType: 1

<?php

namespace MyVendor\MyExtension\Processors;

use KM2\DataSeeder\Attribute\SeedingProcessor;
use KM2\DataSeeder\Configuration\DataTransferObject\Configuration;
use KM2\DataSeeder\DataHandling\Processors\ProcessorInterface;
use KM2\DataSeeder\DataHandling\RuntimeValues;

#[SeedingProcessor(identifier: 'categoryProcessor', before: ['records'], after: ['pages', 'sys_file'])]
class MyCustomOperation implements ProcessorInterface
{
    protected Configuration $configuration;

    protected RuntimeValues $runtimeValues;

    public function setConfiguration(Configuration $configuration): void
    {
        $this->configuration = $configuration;
    }

    public function setRuntimeValues(RuntimeValues $runtimeValues): void
    {
        $this->runtimeValues = $runtimeValues;
    }

    public function canProcess(NodeInterface $node): bool
    {
        return $node->getRecordType() === 'sys_category';
    }

    public function process(NodeInterface $node): void
    {
        // Write node properties to database.

        // Mark node as processed to skip further processing.
        $node->setProcessed(true);
    }
}

<?php

namespace MyVendor\MyExtension\PropertyConverters;

use KM2\DataSeeder\Attribute\PropertyConverter;
use KM2\DataSeeder\Configuration\DataTransferObject\Configuration;
use KM2\DataSeeder\DataHandling\Property\Converter\PropertyConverterInterface;
use KM2\DataSeeder\DataHandling\Property\Property
use KM2\DataSeeder\DataHandling\RuntimeValues;

#[PropertyConverter(identifier: 'replace-placeholder-property-converter', before: ['variable-property-converter'])]
class MyCustomOperation implements PropertyConverterInterface
{
    protected Configuration $configuration;

    protected RuntimeValues $runtimeValues;

    public function setConfiguration(Configuration $configuration): void
    {
        $this->configuration = $configuration;
    }

    public function setRuntimeValues(RuntimeValues $runtimeValues): void
    {
        $this->runtimeValues = $runtimeValues;
    }

    public function convert(Property $property, NodeInterface $node): bool
    {
        $propertyValue = $property->getValue();
        if (!str_contains($propertyValue, '--placeholder--')) {
            return false;
        }

        $newPropertyValue = (string)str_replace('--placeholder--', 'Lorem ipsum', $propertyValue);
        $property->setValue($newPropertyValue);

        // When true is returned, property conversion is stopped for this property.
        return true;
    }
}