Extension:Newsletter
Newsletter Release status: stable |
|
---|---|
File:Create Newsletter.PNG | |
Implementation | User interface, Notify |
Description | Enables users to publish and subscribe to newsletters |
Author(s) | Tina Johnson, Tony Thomas |
Latest version | 1.2.1 (2017-07-09) |
MediaWiki | 1.25+ |
PHP | 5.4+ |
Database changes | Yes |
Tables | nl_issues nl_newsletters nl_publishers nl_subscriptions |
License | GNU General Public License 2.0 or later |
Download | |
Help | Help:Extension:Newsletter |
|
|
Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
Translate the Newsletter extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
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. For user documentation, check 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.
Special:ManageNewsletter
- 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.
Requirements
- 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).
Installation
- <translate> [[<tvar name=2>Special:ExtensionDistributor/Newsletter</tvar>|Download]] and move the extracted <tvar name=name>
Newsletter
</tvar> folder to your <tvar name=ext>extensions/
</tvar> directory.</translate>
<translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Newsletter - <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>
wfLoadExtension( 'Newsletter' );
- <translate> Run the [[<tvar name=update>Special:MyLanguage/Manual:Update.php</tvar>|update script]] which will automatically create the necessary database tables that this extension needs.</translate>
- File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>
User rights
By default, only users in 'sysop' group have this permissions.
You can set up the user rights in LocalSettings.php
.
Right | Description |
---|---|
newsletter-create | Register newsletters |
newsletter-delete | Delete newsletters |
newsletter-manage | Add or remove publishers or subscribers from newsletters |
newsletter-restore | Restore a newsletter |
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;
History
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.
See also
- Movement broadcasting (use cases)
- Extension:EmailPage
- Extension:MassMessage
- Extension:TranslationNotifications
File:Wikimedia-logo black.svg | <translate> This {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is being used on one or more [[<tvar name=2>m:Special:MyLanguage/Wikimedia projects</tvar>|Wikimedia projects]].</translate> <translate> This probably means that the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension|skin}} is stable and works well enough to be used by such high-traffic websites.</translate> <translate> Look for this {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extension's|skin's}} name in Wikimedia's <tvar name=2>CommonSettings.php</tvar> and <tvar name=3>InitialiseSettings.php</tvar> configuration files to see where it's installed.</translate> <translate> A full list of the {{<tvar name=1>#ifeq:Extension|Extension</tvar>|extensions|skins}} installed on a particular wiki can be seen on the wiki's <tvar name=ver>Special:Version</tvar> page.</translate> |
Create Newsletter.PNG |
- Pages with script errors
- Pages with broken file links
- Stable extensions
- User interface extensions
- Notification extensions
- Extensions without a compatibility policy
- Extensions with manual MediaWiki version
- GPL licensed extensions
- Extensions in Wikimedia version control
- ArticleDelete extensions
- BeforeCreateEchoEvent extensions
- ContentModelCanBeUsedOn extensions
- CustomEditor extensions
- EditFilterMergedContent extensions
- LoadExtensionSchemaUpdates extensions
- LoginFormValidErrorMessages extensions
- PageUndelete extensions
- TitleMove extensions
- UserMergeAccountFields extensions
- GetUserPermissionsErrors extensions
- All extensions
- Extensions used on Wikimedia
- ContentHandler extensions