README

此扩展允许用户增加对自身数据的控制。

要求

• flarum/core - v1.8.3 或更高版本
• PHP - 8.0 或更高版本

安装或更新

使用 composer 手动安装

composer require flarum/gdpr:@beta

使用

所有论坛用户现在都可以在其账户设置页面中找到 个人数据 部分

从这里，用户可以自助导出论坛数据，或开始删除请求。删除请求将排队等待管理员/版主处理。任何在 30 天后仍未处理的请求将自动使用配置的默认方法（删除或匿名化）进行处理。

指定要使用的队列

如果您论坛运行多个队列，例如 low 和 high，您可以在 skeleton 的 extend.php 文件中指定此扩展的队列作业要运行在哪个队列上。

Flarum\Gdpr\Jobs\GdprJob::$onQueue = 'low';

return [
    ... your current extenders,
];

对于开发者

您可以通过利用 Flarum\Gdpr\Extend\UserData 扩展器轻松注册新的数据类型、删除现有的数据类型或在导出时排除用户表中的特定列。请确保您将 GDPR 扩展器包裹在条件扩展中，以便论坛所有者可以选择是否启用 GDPR 功能。此功能需要 flarum/core v1.8.3 或更高版本，因此应将其设置为您的扩展的最低要求。

注册新的数据类型

您的数据类型类应实现 Flarum\Gdpr\Contracts\DataType

<?php

use Flarum\Gdpr\Extend\UserData;
use Flarum\Extend;

return [
    (new Extend\Conditional())
        ->whenExtensionEnabled('blomstra-gdpr', fn () => [
            (new UserData())
                ->addType(Your\Own\DataType::class),

            ... other conditional extenders as required ...
        ]),
];

您创建的实现需要一个导出方法，它将接收一个 ZipArchive 资源。您可以使用它向存档添加任何字符串或实际文件。请确保正确命名文件，并始终以您的扩展 slug（blomstra-某些文件名）为前缀。

删除数据类型

如果出于任何原因您想排除某个特定数据类型，请执行以下操作

use Flarum\Gdpr\Extend\UserData;
use Flarum\Extend;

return [
    (new Extend\Conditional())
        ->whenExtensionEnabled('flarum-gdpr', fn () => [
            (new UserData())
                ->removeType(Your\Own\DataType::class),

            ... other conditional extenders as required ...
        ]),
];

在导出时排除用户表中的特定列

use Flarum\Gdpr\Extend\UserData;

return [
    (new Extend\Conditional())
        ->whenExtensionEnabled('flarum-gdpr', fn () => [
            (new UserData())
                ->removeUserColumn('column_name') // For a single column
                ->removeUserColumns(['column1', 'column2']), // For multiple columns

            ... other conditional extenders as required ...
        ]),
];

Flarum 扩展

以下是与该扩展提供 GDPR 数据集成的已知扩展。如果没有列出所需的扩展？请联系作者要求添加。

• 2FA，自 1.0.9
• Boring Avatars，自 1.0.0
• FoF Ban IPs，自 1.1.0
• FoF Drafts，自 1.2.8
• FoF Follow Tags，自 1.2.2
• FoF Terms，自 1.3.0
• FoF Upload，自 1.4.4
• Follow Users，自 1.4.1

常见问题解答 & 建议

• 生成 zip 存档可以推送到 队列功能。这对于大型社区以及与 GDPR 扩展一起工作的更多扩展特别重要，以允许数据导出。