[5.3] [Events] Use event classes for Sampledata plugins (#43636)

* SampleData Event

* SampleData testing

* SampleData multilang

* SampleData blog

Author: Fedik

libraries/src/Event/CoreEventAware.php

@@ -203,6 +203,8 @@ trait CoreEventAware
         'onPageCacheSetCaching' => PageCache\SetCachingEvent::class,
         'onPageCacheGetKey'     => PageCache\GetKeyEvent::class,
         'onPageCacheIsExcluded' => PageCache\IsExcludedEvent::class,
+        // Sample Data
+        'onSampledataGetOverview' => SampleData\GetOverviewEvent::class,
         // Mail
         'onMailBeforeRendering' => Mail\BeforeRenderingMailTemplateEvent::class,
     ];

libraries/src/Event/SampleData/GetOverviewEvent.php

@@ -0,0 +1,29 @@
+<?php
+
+/**
+ * Joomla! Content Management System
+ *
+ * @copyright  (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\CMS\Event\SampleData;
+
+use Joomla\CMS\Event\Result\ResultAware;
+use Joomla\CMS\Event\Result\ResultAwareInterface;
+use Joomla\CMS\Event\Result\ResultTypeObjectAware;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Cass for Sample data events
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+class GetOverviewEvent extends SampleDataEvent implements ResultAwareInterface
+{
+    use ResultAware;
+    use ResultTypeObjectAware;
+}

libraries/src/Event/SampleData/SampleDataEvent.php

@@ -0,0 +1,43 @@
+<?php
+
+/**
+ * Joomla! Content Management System
+ *
+ * @copyright  (C) 2024 Open Source Matters, Inc. <https://www.joomla.org>
+ * @license    GNU General Public License version 2 or later; see LICENSE.txt
+ */
+
+namespace Joomla\CMS\Event\SampleData;
+
+use Joomla\CMS\Event\AbstractImmutableEvent;
+
+// phpcs:disable PSR1.Files.SideEffects
+\defined('_JEXEC') or die;
+// phpcs:enable PSR1.Files.SideEffects
+
+/**
+ * Base class for Sample data events
+ *
+ * @since  __DEPLOY_VERSION__
+ */
+abstract class SampleDataEvent extends AbstractImmutableEvent
+{
+    /**
+     * Constructor.
+     *
+     * @param   string  $name       The event name.
+     * @param   array   $arguments  The event arguments.
+     *
+     * @throws  \BadMethodCallException
+     *
+     * @since   __DEPLOY_VERSION__
+     */
+    public function __construct($name, array $arguments = [])
+    {
+        parent::__construct($name, $arguments);
+
+        if (!\array_key_exists('subject', $this->arguments)) {
+            throw new \BadMethodCallException("Argument 'subject' of event {$name} is required but has not been provided");
+        }
+    }
+}