README

neucore-plugin

编写 Neucore 插件所需的类。

文档可以在 Neucore 仓库中的 https://github.com/tkhamez/neucore/blob/main/doc/Plugins.md 找到。

有关插件列表，请参阅 https://github.com/tkhamez/neucore#plugins-and-related-software。

开发环境

docker build --tag neucore-plugin .
docker run -it --mount type=bind,source="$(pwd)",target=/app --workdir /app neucore-plugin /bin/sh

变更日志

4.0.0 - 2024-06-01

• 已停止对 PHP 8.0 的支持，最低所需版本现在为 8.1.0（与 Neucore >=2.5.0 相同）。

3.0.0 - 2023-07-29

此版本需要 Neucore 版本 2.2.0 或更高版本。

• 将最低所需 PHP 版本提高到 8.0.2，从 8.0.0。
• 将 symfony/yaml 更新到版本 6，从 5。

2.1.0 - 2023-03-18

• 为 NavigationItem 构造函数添加了可选的 groups 和 managerGroups 参数。
• 添加了 PluginConfiguration::$name。

2.0.0 - 2023-02-18

重大变更

• Data\CoreAccount 的所有属性现在都可以为 null，除了新的 $playerId 和 $playerName 属性。
• 删除了 Data\CoreRole::$identifier。

其他变更

• 添加了 Data\CoreEsiToken 类
• 添加了 Data\CoreMemberTracking 类
• 添加了 Data\CoreMovedCharacter 类
• 添加了 Data\CoreAccount::$playerId
• 添加了 Data\CoreAccount::$playerName
• 添加了 Data\CoreCharacter::$playerName
• 添加了 Core\AccountInterface
• 添加了 Core\DataInterface
• 添加了 Core\FactoryInterface::getAccount()
• 添加了 Core\FactoryInterface::getData()
• 菜单条目现在也允许在 "服务" 菜单中。

1.0.0 - 2023-02-11

• 重大变更：添加了 GeneralInterface::command()。
• 添加了 PluginConfiguration::$active。
• 添加了 NavigationItem::$roles。

0.11.0 - 2023-01-15

• 添加了 CoreAccount::$groupsDeactivated。
• 添加了 CoreAccount::getMemberGroups()。

0.10.0 - 2023-01-06

此版本添加了（包括其他）新的 "通用" 插件类型。

重大变更

• 更改了 ServiceInterface::__construct 签名。
• 更改了 ServiceInterface::request 签名。
• 将 ServiceConfiguration 类重命名为 PluginConfiguration 并将其移动到 Neucore\Plugin\Data 命名空间。
• 添加了 ServiceInterface::search 方法。
• 删除了 ObjectProvider（由 ServiceConfiguration::__construct 中提供的新 FactoryInterface 对象替换）。
• 将 CoreCharacter、CoreGroup 和 ServiceAccountData 移动到 Neucore\Plugin\Data 命名空间。

其他变更

• 添加了插件类型 "通用"。
• 为通用（非服务）插件添加了 GeneralInterface。
• 添加了 FactoryInterface。
• 添加了 CoreAccount 和 CoreRole 类。
• 从 plugin.yml 中删除了 "type"（它由实现的接口确定）。

0.9.2 - 2022-12-28

• 添加了 plugin.yml。

0.9.1 - 2022-12-27

• 添加了 ObjectProvider::createHttpRequest 方法。

0.9.0 - 2022-12-25

• 添加了 ServiceInterface::onConfigurationChange()。
• 添加了具有 getHttpClient 和 getSymfonyYamlParser 方法的 ObjectProvider 类。
• 已停止对 PHP 7.4 的支持，最低所需版本现在为 8.0。
• 允许 psr/log 版本 1.1、2 或 3。

0.8.0 - 2022-06-19

• 将最低 PHP 版本提高到 7.4。
• 添加了 ServiceInterface::moveServiceAccount()。

0.7.1 - 2022-05-21

• 如果 ServiceAccountData::$name 无法进行 json 编码，则类将返回错误消息。

0.7.0 - 2022-01-16

• 将 $groups 参数添加到 ServiceInterface::request

0.6.0 - 2022-01-01

• 将 ServiceAccountData::displayName 重命名为 name

0.5.0 - 2021-09-17

• 为 CoreCharacter 添加了 $playerId 属性。
• 将 STATUS_NONMEMBER 添加到 ServiceAccountData。
• 添加了 ServiceConfiguration 类。
• 在 ServiceInterface 构造函数中将 $configurationData 替换为 ServiceConfiguration 对象。
• 从 ServiceInterface::getAccounts() 中移除了 $groups 参数。
• 将 $mainCharacter 参数添加到 ServiceInterface::updateAccount()。
• 添加了 ServiceInterface::updatePlayerAccount()。
• 添加了 ServiceInterface::getAllPlayerAccounts()。
• 添加了 ServiceInterface::request()。

0.4.0 - 2021-09-04

• 将 $displayName 添加到 ServiceAccountData。

0.3.0 - 2021-09-03

• 将 $configurationData 参数添加到 ServiceInterface 构造函数。

0.2.0 - 2021-01-29

• 添加了 ServiceInterface::getAllAccounts。

0.1.1 - 2021-01-08

• 在 composer.json 中要求启用 json 扩展。

0.1.0 - 2021-01-06

• 初始版本发布。