LICENSE

@@ -1,6 +1,6 @@
 BSD 3-Clause License
 
-Copyright (c) 2023, Bugo
+Copyright (c) 2023-2024, Bugo
 
 Redistribution and use in source and binary forms, with or without
 modification, are permitted provided that the following conditions are met:

README.md

@@ -3,7 +3,7 @@
 [![SMF 2.1](https://img.shields.io/badge/SMF-2.1-ed6033.svg?style=flat)](https://github.com/SimpleMachines/SMF2.1)
 ![License](https://img.shields.io/github/license/dragomano/plugin-loader)
 ![Hooks only: Yes](https://img.shields.io/badge/Hooks%20only-YES-blue)
-![PHP](https://img.shields.io/badge/PHP-^7.0-blue.svg?style=flat)
+![PHP](https://img.shields.io/badge/PHP-^8.0-blue.svg?style=flat)
 [![Crowdin](https://badges.crowdin.net/plugin-loader/localized.svg)](https://crowdin.com/project/plugin-loader)
 
 [Описание на русском](README.ru.md)
@@ -12,7 +12,7 @@ This concept mod is inspired by the Wedge plugin system. It adds plugin support
 
 Plugins are standalone modifications that do not need to be installed or removed through the Package Manager. They don't make changes to SMF files and run entirely on hooks.
 
-The key source file of the plugin is **plugin.php** with the anonymous class and the **hooks** method, which is executed through the _integrate_pre_load_ hook. Also in the directory of each plugin should be a file **plugin-info.xml**, which contains the key data of the plugin:
+The entry point of each plugin is **plugin.php** with an anonymous class inside. Also in the directory of each plugin should be a file **plugin-info.xml**, which contains the key data of the plugin:
 
     * name
     * description
@@ -88,15 +88,11 @@ Plugins that require creation of tables in the database for their work must cont
 <?php
 
 /**
- * plugin.php
- *
  * @package Example
  * @link https://plugin-site.com
  * @author Author https://author-site.com
- * @copyright 2023 Author
+ * @copyright 2024 Author
  * @license https://opensource.org/licenses/MIT The MIT License
- *
- * @version 0.1
  */
 
 use Bugo\PluginLoader\Plugin;
@@ -106,17 +102,9 @@ if (!defined('SMF'))
 
 return class extends Plugin
 {
-	public function getName(): string
-	{
-		return 'example';
-	}
-
-	public function hooks(): void
-	{
-		add_integration_function('integrate_load_theme', __CLASS__ . '::loadTheme#', false, __FILE__);
-		add_integration_function('integrate_menu_buttons', __CLASS__ . '::menuButtons#', false, __FILE__);
-	}
+	public const NAME = 'example';
 
+	#[Hook('integrate_load_theme', self::class . '::loadTheme#', __FILE__)]
 	public function loadTheme(): void
 	{
 		// Your code
@@ -141,6 +129,7 @@ return class extends Plugin
 		// var_dump($this->getSettings());
 	}
 
+	#[Hook('integrate_menu_buttons', self::class . '::menuButtons#', __FILE__)]
 	public function menuButtons($buttons): void
 	{
 		// var_dump($buttons);
@@ -149,7 +138,7 @@ return class extends Plugin
 
 ```
 
-As you can see, all the hooks required by the plugin are listed in the `hooks` method, which is executed if the plugin is enabled.
+As you can see, all hooks required by the plugin are defined using the `Hook` attribute.
 
 ## Example plugin language file
 

README.ru.md

@@ -3,7 +3,7 @@
 [![SMF 2.1](https://img.shields.io/badge/SMF-2.1-ed6033.svg?style=flat)](https://github.com/SimpleMachines/SMF2.1)
 ![License](https://img.shields.io/github/license/dragomano/plugin-loader)
 ![Hooks only: Yes](https://img.shields.io/badge/Hooks%20only-YES-blue)
-![PHP](https://img.shields.io/badge/PHP-^7.0-blue.svg?style=flat)
+![PHP](https://img.shields.io/badge/PHP-^8.0-blue.svg?style=flat)
 [![Crowdin](https://badges.crowdin.net/plugin-loader/localized.svg)](https://crowdin.com/project/plugin-loader)
 
 [Description in English](README.md)
@@ -12,7 +12,7 @@
 
 Плагины — это автономные модификации, которым не требуется установка или удаление через Менеджер пакетов. Они не вносят изменения в файлы SMF и работают полностью на хуках.
 
-Ключевым source-файлом у плагина является **plugin.php** с анонимным классом внутри и методом **hooks**, выполняемым через хук _integrate_pre_load_. Также в директории каждого плагина должен находиться файл **plugin-info.xml**, содержащий ключевые данные плагина:
+Точкой входа каждого плагина является **plugin.php** с анонимным классом внутри. Также в директории каждого плагина должен находиться файл **plugin-info.xml**, содержащий ключевые данные плагина:
 
     * название
     * описание
@@ -88,35 +88,24 @@ example_plugin/
 <?php
 
 /**
- * plugin.php
- *
  * @package Example
  * @link https://plugin-site.com
  * @author Author https://author-site.com
- * @copyright 2023 Author
+ * @copyright 2024 Author
  * @license https://opensource.org/licenses/MIT The MIT License
- *
- * @version 0.1
  */
 
+use Bugo\PluginLoader\Hook;
 use Bugo\PluginLoader\Plugin;
 
-if (!defined('SMF'))
+if (! defined('SMF'))
 	die('No direct access...');
 
 return class extends Plugin
 {
-	public function getName(): string
-	{
-		return 'example';
-	}
-
-	public function hooks(): void
-	{
-		add_integration_function('integrate_load_theme', __CLASS__ . '::loadTheme#', false, __FILE__);
-		add_integration_function('integrate_menu_buttons', __CLASS__ . '::menuButtons#', false, __FILE__);
-	}
+	public const NAME = 'example';
 
+	#[Hook('integrate_load_theme', self::class . '::loadTheme#', __FILE__)]
 	public function loadTheme(): void
 	{
 		// Ваш код
@@ -141,6 +130,7 @@ return class extends Plugin
 		// var_dump($this->getSettings());
 	}
 
+	#[Hook('integrate_menu_buttons', self::class . '::menuButtons#', __FILE__)]
 	public function menuButtons($buttons): void
 	{
 		// var_dump($buttons);
@@ -149,7 +139,7 @@ return class extends Plugin
 
 ```
 
-Как видите, все требуемые плагином хуки перечисляются в методе `hooks`, который выполняется только при включении плагина.
+Как видите, все требуемые плагином хуки определяются с помощью атрибута `Hook`.
 
 ## Пример языкового файла плагина
 

Sources/PluginLoader/HasInvoke.php

@@ -0,0 +1,28 @@
+<?php
+
+/**
+ * @package Plugin Loader
+ * @link https://github.com/dragomano/Plugin-Loader
+ * @author Bugo <bugo@dragomano.ru>
+ * @copyright 2023-2024 Bugo
+ * @license https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License
+ */
+
+namespace Bugo\PluginLoader;
+
+use ReflectionClass;
+
+trait HasInvoke
+{
+	public function __invoke(): void
+	{
+		$reflectionClass = new ReflectionClass(static::class);
+		foreach ($reflectionClass->getMethods() as $method) {
+			$attributes = $method->getAttributes(Hook::class);
+
+			foreach ($attributes as $attribute) {
+				$attribute->newInstance();
+			}
+		}
+	}
+}

Sources/PluginLoader/Hook.php

@@ -0,0 +1,22 @@
+<?php /** @noinspection PhpMultipleClassDeclarationsInspection */
+
+/**
+ * @package Plugin Loader
+ * @link https://github.com/dragomano/Plugin-Loader
+ * @author Bugo <bugo@dragomano.ru>
+ * @copyright 2023-2024 Bugo
+ * @license https://opensource.org/licenses/BSD-3-Clause The 3-Clause BSD License
+ */
+
+namespace Bugo\PluginLoader;
+
+use Attribute;
+
+#[Attribute(Attribute::TARGET_METHOD)]
+final class Hook
+{
+	public function __construct(string $name, string $method, string $file)
+	{
+		add_integration_function($name, $method, false, $file);
+	}
+}