Merge branch '5.0' into mcp

Author: adriendupuis

.github/workflows/code_samples.yaml

@@ -9,6 +9,7 @@ jobs:
         runs-on: "ubuntu-22.04"
         strategy:
             matrix:
+                fail-fast: false
                 php:
                     - "8.4" # Upper supported version
                     - "8.3" # Lower supported version
@@ -45,12 +46,15 @@ jobs:
                   dependency-versions: highest
 
             - name: Run PHPStan analysis
+              continue-on-error: true
               run: composer phpstan
 
             - name: Run Deptrac analysis
+              continue-on-error: true
               run: composer deptrac
 
             - name: Run Rector check
+              continue-on-error: true
               run: composer check-rector
 
     code-samples-inclusion-check:

code_samples/api/graphql/config/services.yaml

@@ -0,0 +1,5 @@
+services:
+    App\GraphQL\Schema\MyFieldDefinitionMapper:
+        decorates: Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper
+        arguments:
+            $innerMapper: '@.inner'

code_samples/api/graphql/src/GraphQL/Schema/MyCustomFieldDefinitionMapper.php

@@ -0,0 +1,37 @@
+<?php declare(strict_types=1);
+
+namespace App\GraphQL\Schema;
+
+use Ibexa\Contracts\Core\Repository\Values\ContentType\ContentType;
+use Ibexa\Contracts\Core\Repository\Values\ContentType\FieldDefinition;
+use Ibexa\Contracts\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\FieldDefinitionMapper;
+use Ibexa\GraphQL\Schema\Domain\Content\Mapper\FieldDefinition\DecoratingFieldDefinitionMapper;
+use Symfony\Component\Serializer\NameConverter\CamelCaseToSnakeCaseNameConverter;
+
+class MyFieldDefinitionMapper extends DecoratingFieldDefinitionMapper implements FieldDefinitionMapper
+{
+    protected function getFieldTypeIdentifier(): string
+    {
+        return 'my_field_type';
+    }
+
+    public function mapToFieldValueInputType(ContentType $contentType, FieldDefinition $fieldDefinition): ?string
+    {
+        if (!$this->canMap($fieldDefinition)) {
+            return parent::mapToFieldValueInputType($contentType, $fieldDefinition);
+        }
+
+        return $this->nameMyFieldInputType($contentType, $fieldDefinition);
+    }
+
+    private function nameMyFieldInputType(ContentType $contentType, FieldDefinition $fieldDefinition): string
+    {
+        $converter = new CamelCaseToSnakeCaseNameConverter(null, false);
+
+        return sprintf(
+            '%s%sInput',
+            $converter->denormalize($contentType->identifier),
+            $converter->denormalize($fieldDefinition->identifier)
+        );
+    }
+}

code_samples/api/graphql/src/GraphQL/Schema/MyFieldDefinitionMapper.php

@@ -0,0 +1,7 @@
+@use '@ibexa-admin-ui/src/bundle/Resources/public/scss/_alerts.scss' as *;
+
+.ibexa-alert {
+    &--notification {
+        @extend .ibexa-alert--info;
+    }
+}

code_samples/api/notifications/assets/scss/notifications.scss

@@ -0,0 +1,69 @@
+framework:
+    notifier:
+        chatter_transports:
+            slack: '%env(SLACK_DSN)%'
+ibexa:
+    system:
+        default:
+            notifier:
+                subscriptions:
+                    # The configuration below is added to the `default` scope without overriding the one defined in ibexa.yaml
+                    # Custom subscriptions:
+                    Ibexa\OrderManagement\Notification\OrderStatusChange:
+                        channels:
+                            - chat
+                    Ibexa\Payment\Notification\PaymentStatusChange:
+                        channels:
+                            - chat
+                    Ibexa\Shipping\Notification\ShipmentStatusChange:
+                        channels:
+                            - chat
+                    App\Notifications\CommandExecuted:
+                        channels:
+                            - ibexa
+                            - email
+                            - log
+        admin_group:
+            notifier:
+                subscriptions:
+                    # The configuration below is added to the `admin_group` scope without overriding the one defined in ibexa_admin_ui.yaml
+                    # Custom subscriptions:
+                    App\Notifications\CommandExecuted:
+                        channels:
+                            - ibexa
+                            - email
+                            - log
+                    App\Notifications\ControllerFeedback:
+                        channels:
+                            - browser
+        storefront_group:
+            notifier:
+                subscriptions:
+                    # The configuration defined in ibexa.yaml for `default` scope is repeated as the configuration below overrides it
+                    Ibexa\Contracts\User\Notification\UserPasswordReset:
+                        channels:
+                            - email
+                    Ibexa\Contracts\User\Notification\UserInvitation:
+                        channels:
+                            - email
+                    Ibexa\Contracts\FormBuilder\Notifications\FormSubmitted:
+                        channels:
+                            - email
+                    # Custom subscriptions:
+                    Ibexa\OrderManagement\Notification\OrderStatusChange:
+                        channels:
+                            - chat
+                    Ibexa\Payment\Notification\PaymentStatusChange:
+                        channels:
+                            - chat
+                    Ibexa\Shipping\Notification\ShipmentStatusChange:
+                        channels:
+                            - chat
+                    App\Notifications\CommandExecuted:
+                        channels:
+                            - ibexa
+                            - email
+                            - log
+                    App\Notifications\ControllerFeedback:
+                        channels:
+                            - browser

code_samples/api/notifications/config/packages/notifications.yaml

@@ -0,0 +1,4 @@
+services:
+    App\Notifier\Channel\LogChannel:
+        tags:
+            - { name: 'notifier.channel', channel: 'log' }

code_samples/api/notifications/config/services.yaml

@@ -0,0 +1,16 @@
+<?php declare(strict_types=1);
+
+use App\Notifications\MyNotification; // extends Symfony\Component\Notifier\Notification\Notification
+use Ibexa\Contracts\Notifications\Value\Notification\SymfonyNotificationAdapter;
+use Ibexa\Contracts\Notifications\Value\Recipent\SymfonyRecipientAdapter;
+use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipient;
+
+$subject = 'My subject';
+
+/** @var \Ibexa\Contracts\Notifications\Service\NotificationServiceInterface $notificationService */
+/** @var \Ibexa\Contracts\Core\Repository\UserService $userService */
+/** @var \Ibexa\Contracts\Core\Repository\PermissionResolver $permissionResolver */
+$notificationService->send(
+    new SymfonyNotificationAdapter(new MyNotification($subject)),
+    [new SymfonyRecipientAdapter(new UserRecipient($userService->loadUser($permissionResolver->getCurrentUserReference()->getUserId())))],
+);

code_samples/api/notifications/notification_send.php

@@ -0,0 +1,67 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Command;
+
+use App\Notifications\CommandExecuted;
+use Ibexa\Contracts\Core\Repository\UserService;
+use Ibexa\Contracts\Notifications\Service\NotificationServiceInterface;
+use Ibexa\Contracts\Notifications\Value\Notification\SymfonyNotificationAdapter;
+use Ibexa\Contracts\Notifications\Value\Recipent\SymfonyRecipientAdapter;
+use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipient;
+use Symfony\Component\Console\Attribute\AsCommand;
+use Symfony\Component\Console\Command\Command;
+use Symfony\Component\Console\Input\InputInterface;
+use Symfony\Component\Console\Output\OutputInterface;
+use Symfony\Component\Notifier\Recipient\RecipientInterface;
+
+#[AsCommand(name: 'app:send_notification', description: 'Example of command sending a notification')]
+class NotificationSenderCommand extends Command
+{
+    /** @param array<int, string> $recipientLogins */
+    public function __construct(
+        private readonly NotificationServiceInterface $notificationService,
+        private readonly UserService $userService,
+        private readonly array $recipientLogins = ['admin'],
+    ) {
+        parent::__construct();
+    }
+
+    protected function execute(InputInterface $input, OutputInterface $output): int
+    {
+        /** @var array<int, \Throwable> $exceptions */
+        $exceptions = [];
+
+        try {
+            // Do something
+            if (random_int(0, 1) == 1) {
+                throw new \RuntimeException('Something went wrong');
+            }
+            $exitCode = Command::SUCCESS;
+        } catch (\Exception $exception) {
+            $exceptions[] = $exception;
+            $exitCode = Command::FAILURE;
+        }
+
+        $recipients = [];
+        foreach ($this->recipientLogins as $login) {
+            try {
+                $user = $this->userService->loadUserByLogin($login);
+                $recipients[] = new UserRecipient($user);
+            } catch (\Exception $exception) {
+                $exceptions[] = $exception;
+            }
+        }
+
+        $this->notificationService->send(
+            new SymfonyNotificationAdapter(new CommandExecuted($this, $exitCode, $exceptions)),
+            array_map(
+                static fn (RecipientInterface $recipient): SymfonyRecipientAdapter => new SymfonyRecipientAdapter($recipient),
+                $recipients
+            )
+        );
+
+        return $exitCode;
+    }
+}

code_samples/api/notifications/src/Command/NotificationSenderCommand.php

@@ -0,0 +1,28 @@
+<?php declare(strict_types=1);
+
+namespace App\Controller;
+
+use App\Notifications\ControllerFeedback;
+use Ibexa\Contracts\Notifications\Service\NotificationServiceInterface;
+use Ibexa\Contracts\Notifications\Value\Notification\SymfonyNotificationAdapter;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\Response;
+use Symfony\Component\Routing\Attribute\Route;
+
+class NotificationSenderController extends AbstractController
+{
+    public function __construct(
+        private readonly NotificationServiceInterface $notificationService,
+    ) {
+    }
+
+    #[Route('/notification-sender')]
+    public function index(): Response
+    {
+        $this->notificationService->send(
+            new SymfonyNotificationAdapter((new ControllerFeedback('Message sent from controller'))->emoji('👍')),
+        );
+
+        return $this->render('@ibexadesign/notification-sender-controller.html.twig');
+    }
+}