README

这是一个提供德语和英语的 Laravel 包，它包含一个开源隐私策略。

演示

一个使用相同文本的兄弟包 webflorist/隐私策略-vue 的示例应用可在以下网址找到
https://privacy-policy-vue-demo.netlify.app/

特性

语言
目前该包包含德语和英语语言文本。
单数/复数
您可以选择单数或复数视角。
(例如 我的网站... 与 我们的网站...)
包含的文本
- 一般 简介文本
- GDPR权利列表
- 数据控制者 简介
- 一般 数据安全 文本（SSL等）
- Cookie 信息
- 关于第三方数据处理者的数据处理的说明
  - Web托管
  - 网络分析
  - 交互式地图
  - 发送电子邮件（例如，联系表单）
- 关于外链的免责声明
- 所有使用的 处理器 列表

要求

此包支持从版本 5.5 到 8.x 的 Laravel。

安装

使用composer安装包
composer require webflorist/隐私策略-laravel
发布配置
php artisan vendor:publish --provider="Webflorist\PrivacyPolicy\PrivacyPolicyServiceProvider"
使用Laravel的 config 目录中的 privacy-policy.php 文件配置您的隐私策略。（详细信息见下文）。
在视图中包含隐私策略组件

    @component('webflorist-privacy-policy::privacy-policy')
    @endcomponent

配置

`data-controller`: 数组（必需）

数据控制者的联系信息。数组可以包含以下元素

[
	'organisation' => 'Acme Corporation',
	'name' => 'John Doe',
	'address' => 'Acme Street 1, 123456 Acme City, USA',
	'email' => 'privacy@example.com',
	'phone' => '+1 555-0123',
];

`singular`: 布尔值（必需）

设置为 true 以使用单数视角（例如，“我的网站...”）。

设置为 false 以使用复数视角（例如，“我们的网站...”）。

`data-processing`: 数组（可选）

您网站使用的数据处理。每个处理必须作为二维数组声明，其中处理类型作为键，其属性作为值数组声明。

支持的处理类型有

webhosting
analytics
maps
send_emails

处理属性的示例

processor: 字符串（必需）
提供此处理的处理器的键（可以是包含的其中之一或通过processors属性声明的）
service: 字符串（可选）
提供此处理的服务名称（例如，Google Analytics或Google Maps）
data_categories: 数组（必需）
此处理处理的数据类别数组。支持的值包括
- inventory_data
- usage_data
- geo_data
- usage_statistics
- contract_data
- payment_data

以下是一个完整的data_processing配置示例

[
	'webhosting' => [
		'processor' => ['netlify', 'storyblok'],
		'data_categories' => ['usage_data'],
	],
	'analytics' => [
		'processor' => 'google_eu',
		'service' => 'Google Analytics',
		'data_categories' => ['usage_data', 'usage_statistics'],
	],
	'maps' => [
		'processor' => 'google_usa',
		'service' => 'Google Maps',
		'data_categories' => ['usage_data', 'geo_data'],
	],
	'send_emails' => [
		'processor' => 'twilio_eu',
		'service' => 'Twilio Sendgrid',
		'data_categories' => ['usage_data', 'inventory_data'],
	],
];

`cookies`: 数组|false（必需）

此配置描述了您网站使用的Cookies。

如果您的网站完全不使用Cookies，只需将其设置为false。

如果不这样做，请将使用的Cookies分为第一方Cookies和第三方Cookies，并将它们作为cookies配置中first_party和third_party数组的子数组列出。

每个Cookies都由以下可能的属性组成的数组描述

name：String（必填）
Cookies的名称
purpose：String（必填）
Cookies用途的关键。可以是以下之一
- session：会话Cookie
- xsrf：用于防止“跨站请求伪造”攻击的Cookie
- hide_alert：防止在隐藏后再次显示Cookies对话框的Cookie
- all_choices：存储在Cookies对话框中显示的各种Cookies选择的Cookies
- analytics_choice：存储在Cookies对话框中关于使用网络分析的选择的Cookies
- maps_choice：存储在Cookies对话框中关于使用交互式地图的选择的Cookies
- analytics_third_party：由网络分析工具编写的Cookies
- maps_third_party：在显示交互式地图时设置的Cookies。
written_on：String（必填）
Cookies创建的时间。可以是以下之一
- every_visit：每次访问时编写
- hide_alert：在隐藏Cookies对话框时编写
- maps：在认可使用交互式地图时编写
- accept_cookies：在接受相应Cookies时编写
duration：String（必填）
Cookies的有效期。可以是以下之一
- end_of_session
- 1_year
- 2_years
- 24_hours
- 1_minute
- various
processor：String（第三方Cookies必填）提供此处理的处理程序的键（可以是包含的任何一个或通过processors属性声明的其中一个）

以下是一个Cookies配置示例

[
	'first_party' => [
		[
			'name' => 'session',
			'purpose' => 'session',
			'written_on' => 'every_visit',
			'duration' => 'end_of_session',
		],
	],
	'third_party' => [
		[
			'name' => '_ga, _gat, _gid',
			'purpose' => 'analytics_third_party',
			'written_on' => 'accept_cookies',
			'duration' => 'various',
			'processor' => 'google_eu',
			'service' => 'Google Analytics',
		],
	],
];

`processors`: 数组（可选）

使用data processings或cookies声明的处理程序的说明。

一些处理程序已经包含在内。

在处理程序配置中声明您自己的处理程序，为数组，处理程序的简写键作为键，其信息作为具有以下元素的数组

name String（必填）
公司名称
address String（必填）
公司的完整地址
privacy_policy String（必填）处理程序的隐私政策链接
privacy_shield String（可选）
处理程序的隐私盾条目链接。

以下是一个示例

[
	'acme_corp' => [
		'name' => 'Acme Corporation',
		'address' => 'Acme Street 1, 123456 Acme City, USA',
		'privacy_policy' => 'https://www.example.com/privacy',
		'privacy_shield' =>
			'https://www.privacyshield.gov/participant?id=a2zt0000000TOWQAA4',
	],
];

组件槽

webflorist-privacy-policy::privacy-policy组件提供以下命名槽来在各个位置插入自定义文本

免责声明

包含的文本应该适合符合GDPR的网站。

然而，我对这一点不承担任何责任。

许可证

此包是开源软件，许可协议为MIT许可。

webflorist / 隐私策略-laravel

维护者

详细信息

README

目录

演示

特性

要求

安装

配置

`data-controller`: 数组（必需）

`singular`: 布尔值（必需）

`data-processing`: 数组（可选）

`cookies`: 数组|false（必需）

`processors`: 数组（可选）

组件槽

免责声明

许可证

webflorist / 隐私策略-laravel

维护者

详细信息

README

目录

演示

特性

要求

安装

配置

data-controller: 数组（必需）

singular: 布尔值（必需）

data-processing: 数组（可选）

cookies: 数组|false（必需）

processors: 数组（可选）

组件槽

免责声明

许可证

`data-controller`: 数组（必需）

`singular`: 布尔值（必需）

`data-processing`: 数组（可选）

`cookies`: 数组|false（必需）

`processors`: 数组（可选）