扩展:CookieWarning
![]() 发行状态: 稳定版 |
|
---|---|
实现 | 用户界面 |
描述 | 在页面顶部添加通知,告知用户此 Wiki 使用 Cookie 进行操作。 |
作者 |
|
最新版本 | 0.3.0 (2021年2月) |
MediaWiki | 1.35+ |
PHP | 7.1+ |
许可协议 | MIT授權條款 |
下載 | |
示例 | DroidWiki.org |
|
|
季度下載量 | 67 (Ranked 81st) |
正在使用的公开wiki数 | 985 (Ranked 258th) |
前往translatewiki.net翻譯CookieWarning扩展 | |
問題 | 开启的任务 · 报告错误 |
扩展 CookieWarning 是一个小而简单的扩展,它在你的维基上添加了一个小但清晰可见的信息横幅,通知用户这个维基使用 Cookie 来正常运行。 默认消息还包括一句话,如果用户继续使用 wiki ,则用户同意 wiki 使用 Cookie。
背景
在一些国家,法律要求(如欧盟)作为网站运营商,您需要向用户申请在网站上使用 Cookie 的许可。 In the EU, some of your partners may require you to ask your users to use cookies (e.g. because you use Google AdSense, which requires this notice[1]). To make it easier for wiki administrators to implement these notices, this extension was created (by Florianschmidtwelzow, primarily for use on droidwiki.de).
历史
This extension was merged with the former CookiePolicy extension, which provided a similar functionality and was originally written by Liz Lee for Wikia and further cleaned up and enhanced by Jack Phoenix for ShoutWiki.
安裝
- 下载文件,并将解压后的
CookieWarning
文件夹移动到extensions/
目录中。
开发者和代码贡献人员应从Git安装扩展,输入:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CookieWarning - 将下列代码放置在您的LocalSettings.php 的底部:
wfLoadExtension( 'CookieWarning' );
- 完成 – 在您的wiki上导航至Special:Version,以验证已成功安装扩展。
配置
After the successful installation of CookieWarning, you need to enable it with the configuration option $wgCookieWarningEnabled
, which you need to set to true in your "LocalSettings.php".
如果你有一个页面,解释你和你的合作伙伴如何在维基中使用 Cookies ,你可能想链接到这个页面。
For this, you can add another configuration option, $wgCookieWarningMoreUrl
, which simply takes the URL of the page (full or relative, but relative may not work, if you use subpages in your wiki!).
Alternatively you can set [[MediaWiki:Cookiewarning-more-link]]
to the URL of your site's privacy policy or similar page which explains about cookies.
配置参数
还有一些其他配置,可以帮助您使用 Cookie 信息栏定位正确的用户。 下表包含所有可能的选项。
配置 | 默认值 | 描述 |
---|---|---|
$wgCookieWarningEnabled
|
false
|
必须将此变量设置为 true 才能使扩展工作。
|
$wgCookieWarningMoreUrl
|
''
|
将URL设置为“更多信息”页面。 |
$wgCookieWarningGeoIPServiceURL
|
''
|
An IP location service, which takes the IP address of the visitor and returns a JSON string that complies to the freegeoip.net schema (example). CAUTION: If the geo-targeting is enabled, the IP address of your users will be directly (NOT anonymized!) sent to the service configured in this option, which may be a problem in some countries or jurisdictions. |
$wgCookieWarningGeoIPLookup
|
'none'
|
您希望 Wiki 何时以及如何尝试定位用户。 可能的值:
|
$wgCookieWarningForCountryCodes
|
{
"EU": "Europe",
"AD": "Andorra",
"AL": "Albania",
"AT": "Austria",
"BA": "Bosnia and Herzegovina",
"BE": "Belgium",
"BG": "Bulgaria",
"BY": "Belarus",
"CH": "Switzerland",
"CS": "Serbia and Montenegro",
"CZ": "Czech Republic",
"DE": "Germany",
"DK": "Denmark",
"EE": "Estonia",
"ES": "Spain",
"FI": "Finland",
"FO": "Faroe Islands",
"FR": "France",
"FX": "France, Metropolitan",
"GB": "United Kingdom",
"GI": "Gibraltar",
"GR": "Greece",
"HR": "Croatia",
"HU": "Hungary",
"IE": "Ireland",
"IS": "Iceland",
"IT": "Italy",
"LI": "Liechtenstein",
"LT": "Lithuania",
"LU": "Luxembourg",
"LV": "Latvia",
"MC": "Monaco",
"MD": "Moldova, Republic of",
"MK": "Macedonia",
"MT": "Malta",
"NL": "Netherlands",
"NO": "Norway",
"PL": "Poland",
"PT": "Portugal",
"RO": "Romania",
"SE": "Sweden",
"SI": "Slovenia",
"SJ": "Svalbard and Jan Mayen",
"SK": "Slovakia",
"SM": "San Marino",
"UA": "Ukraine",
"VA": "Holy See (Vatican City State)"
}
|
用户应在 Cookie 通知栏中看到的区域列表。 |
系统消息
If you would like to change the text of the messages shown navigate to the following pages and adjust as required:
- "MediaWiki:Cookiewarning-info"
- "MediaWiki:Cookiewarning-moreinfo-label"
- "MediaWiki:Cookiewarning-more-link"
- "MediaWiki:Cookiewarning-ok-label"
从CookiePolicy扩展迁移
In October 2016, the CookiePolicy extension was merged into the CookieWarning extension, as both tried to solve the same problem. 以下部分将为您提供将 CookiePolicy 迁移到 CookieWarning 所需的信息。
[[MediaWiki:Cookie-policy-link]]
The [[MediaWiki:Cookie-policy-link]]
interface message will be observed by CookieWarning, too, so you can use your customization of the message shown to the user with CookieWarning, too.
However, as this is just for backwards compatibility reasons, it's strongly recommended to change to the CookieWarning message [[MediaWiki:Cookiewarning-more-link]]
, e.g. by moving the page on your wiki, or using the configuration option $wgCookieWarningMoreUrl
to configure the target link.
基于 JavaScript 的地理定位
定位 CookiePolicy 中使用的用户的逻辑被合并到 CookieWarning 中。
但是,您需要通过在 LocalSettings.php
中设置以下选项来配置某些功能以启用它:
$wgCookieWarningEnabled = true;
$wgCookieWarningGeoIPLookup = 'js';
$wgCookiePolicyGeoIPServiceURL
在 CookieWarning 中, $wgCookiePolicyGeoIPServiceURL
配置选项名为 $wgCookieWarningGeoIPServiceURL
,如果您使用它,您需要在 LocalSettings.php 中更改它。
这太简单了!我需要帮助!(也就是说,我发现了一个一个 BUG ,我该怎么办?)
You can always request help and report problems on the talk page or at Phabricator.
参考资料
此扩展在以下wiki农场/托管网站和/或软件包中提供: 這不是一份權威名單。 即使某些wiki农场/托管网站和/或软件包未在这里列出,它们也可能提供此扩展。 请检查你的wiki农场/托管网站或软件包以确认提供情况。 |