This page is a translated version of the page Extension:CookieWarning and the translation is 100% complete.
发行状态: 稳定版
实现 用户界面
描述 在页面顶部添加通知,告知用户此 Wiki 使用 Cookie 进行操作。
最新版本 0.3.0 (2021年2月)
MediaWiki 1.35+
PHP 7.1+
许可协议 MIT授權條款
示例 DroidWiki.org
  • $wgCookieWarningGeoIPLookup
  • $wgCookieWarningGeoIPServiceURL
  • $wgCookieWarningForCountryCodes
  • $wgCookieWarningMoreUrl
  • $wgCookieWarningEnabled
季度下載量 58 (Ranked 80th)
正在使用的公开wiki数 985 (Ranked 258th)
問題 开启的任务 · 报告错误

扩展 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.


  • 下载文件,并将其放置在您extensions/文件夹中的CookieWarning目录内。
    开发者和代码贡献人员应从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 何时以及如何尝试定位用户。 可能的值:
  • none - 地理定位已关闭,扩展不会尝试根据 IP 地址定位用户。
  • php - The extension ships with a class that handles to request the service configured in wgCookieWarningGeoIPServiceURL to locate the user. The request timeout is 2 seconds, so depending on the connection of your server and the load of the configured service, this may slow down the request for the user. However, locating the user will work, even if the user has turned off JavaScript.
  • js - The extension will ship a client side JavaScript code to the user with each request, which will try to locate the user (again, using the service configured in $wgCookieWarningGeoIPServiceURL). The size of the shipped page will increase accordingly, however, the processing of the request does not depend on a third-party site anymore (like when using php).
	"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"


In October 2016, the CookiePolicy extension was merged into the CookieWarning extension, as both tried to solve the same problem. 以下部分将为您提供将 CookiePolicy 迁移到 CookieWarning 所需的信息。


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';


在 CookieWarning 中, $wgCookiePolicyGeoIPServiceURL 配置选项名为 $wgCookieWarningGeoIPServiceURL ,如果您使用它,您需要在 LocalSettings.php 中更改它。

这太简单了!我需要帮助!(也就是说,我发现了一个一个 BUG ,我该怎么办?)

You can always request help and report problems on the talk page or at Phabricator.