Extension:Newsletter/zh

**MediaWiki扩展手册**
Newsletter; 发行状态：稳定版
实现	用户界面, 通知
描述	Enables users to publish and subscribe to newsletters
作者	Tina Johnson, Tony Thomas
最新版本	1.2.1 (2017-07-09)
MediaWiki	1.25+
PHP	5.4+
数据库更改	是
	表 nl_issues; ; nl_newsletters; ; nl_publishers; ; nl_subscriptions;
	添加权限 newsletter-create; newsletter-delete; newsletter-manage; newsletter-restore;
	使用的函数钩 ArticleDelete; BeforeCreateEchoEvent; ContentModelCanBeUsedOn; CustomEditor; EditFilterMergedContent; LoadExtensionSchemaUpdates; LoginFormValidErrorMessages; PageUndelete; SkinTemplateNavigation::Universal; TitleMove; UserMergeAccountFields; getUserPermissionsErrors;
许可证	GNU General Public License 2.0 or later
下載	下載扩展 ; Git [?]: 浏览存储库 (Phabricator · GitHub); Gerrit代码复核; Git提交日誌; 下載原始碼（tarball壓縮）;
	前往translatewiki.net翻譯Newsletter扩展
問題	开启的任务 · 报告错误

This page is a translated version of the page Extension:Newsletter and the translation is 36% complete.

The Newsletter extension provides a catalog of newsletters registered in a given wiki, an easy way for publishers to announce new issues, and an easy way for users to subscribe/unsubscribe and be notified via web or email when new issues are announced. A "newsletter" is defined as a publication that has a name, a wiki home page, and a single or central wiki page for each issue or edition. 检查Help:Extension:Newsletter 来获得用户手册。

You can test the extension at test.wikipedia.org. We welcome feedback and contributions!

Functionality

Special:Newsletters

List of newsletters that are registered with the service, with their basic information, generated automatically.
Registered users can subscribe to newsletters in order to receive notifications about new issues announced, via web or email, according to their Echo preferences. It is not expected to offer delivery to user talk pages.
Registered users can check the newsletters they have subscribed to, and they can unsubscribe.

Special:RegisterNewsletter

Administrators can add existing newsletters to the system. They must provide the title of the newsletter; a link to an existing wiki page that serves as main page; and a description.

Newsletter wiki page UI

Publishers can announce issues for newsletters that have been added into the system via Special:RegisterNewsletter. Echo notifications are sent to subscribers when an issue is announced.
Administrators, existing publishers, and other users granted the rights can add and remove publishers. They must provide the name of the newsletter and username of the publisher. (This is separate from Special:UserRights; the right exists only in relation to a specific newsletter.)
Administrators, existing publishers and other users granted the rights can also view, add, and remove subscribers from newsletters.

要求

Install Echo - Newsletter extension makes use of Echo notifications to notify subscribed users of new issues when announced by the newsletters, and to notify new publishers and subscribers added.
In order be registered with the service, a newsletter must have a name, a central "home page" and in order to publish issues/editions and issue notifications, each issue must have its own page (or central page, such as a table of contents).

安裝

下载文件，并解压Newsletter文件夹到extensions/目录中。
开发者和代码贡献人员应改从Git安装此扩展，输入：
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Newsletter
```
請新增下列代码到您的LocalSettings.php 文件的底部：
```
wfLoadExtension( 'Newsletter' );
```
請运行更新脚本，它将自动创建此扩展所必须的数据库表。
完成 – 請导航至您的wiki上的Special:Version，以验证此扩展已成功安装。

用户权限

預設上，只有管理員（sysop）群組擁有這個權限。你可以在LocalSettings.php中添加这个权限。

Right	Description
newsletter-create	注册新闻报
newsletter-delete	删除新闻报
newsletter-manage	从新闻报中添加或移除发布者或订阅者
newsletter-restore	恢复一份新闻报

For example, the following configuration would allow any user to do anything they want with the Newsletter extension, such as creating a new newsletter, deleting an existing newsletter, or managing an existing newsletter by adding or removing publishers.

$wgGroupPermissions['*']['newsletter-create'] = true;
$wgGroupPermissions['*']['newsletter-delete'] = true;
$wgGroupPermissions['*']['newsletter-manage'] = true;
$wgGroupPermissions['*']['newsletter-restore'] = true;

历史

This extension was created in 2013, then modified heavily as part of a Google Summer of Code 2015 project. Its development team is formed mostly by volunteers, and we welcome new contributors. After a lot of additional work by other contributors, it was made available to Wikimedia users on July 2017.

参见

此扩展用于一个或多个维基媒体项目。这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。特定wiki上的已安装的扩展的完整列表位于Special:Version页面。

此扩展在以下wiki农场/托管网站和/或软件包中提供：

Miraheze