Open main menu

Extension:ContactUs

MediaWiki extensions manual
OOjs UI icon advanced.svg
ContactUs
Release status: beta
Implementation Special page
Description Allows users to contact specific staff members of a wiki based on the nature of their inquiry.
Author(s) Justin Folvarcik (JFolvarciktalk)
Latest version 0.1 (2014-04-04)
MediaWiki 1.21-1.23
PHP 5.3+
License GNU General Public License 2.0 or later
Download
gzip, zip
  • $wgContactUs_Recipients
  • $wgContactUs_Groups
  • $wgContactUs_DisableGroups
Translate the ContactUs extension if it is available at translatewiki.net
Check usage and version matrix.

The ContactUs extension which allows administrators to assign roles to staff members, and then allows users and visitors to send emails to specific staff members based on the nature of their inquiry.

UseEdit

This extension creates the special page Special:ContactUs (which also uses the alias Special:Contact_Us), from which visitors and users alike can contact the staff. Blocked IP addresses and users will not be able to use the form.

InstallationEdit

  • Download and place the file(s) in a directory called ContactUs in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/ContactUs/ContactUs.php";
    
  • Configure as needed
  •   Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

ConfigurationEdit

There are some user defined settings which must be configured to use this extension.

To set which users should receive emails, and which kinds of emails they should receive, you will need to set some configuration values in your LocalSettings.php file.

To set a user named "Justin" to receive emails which are classified in the "tech," "feedback," and "affiliation" groups, you would set the following:

$wgContactUs_Recipients['Justin'] = array('tech', 'feedback', 'affiliation');

To set the global group "tech" with the dropdown option of "Technical questions and bug reports," you would set the following:

$wgContactUs_Groups['tech'] = "Technical questions and bug reports";

If you would prefer to simply use this extension as a mass contact for all users, you should set the following:

$wgContactUs_DisableGroups = true;

If you have disabled grouped emails, you can simply set the users with

$wgContactUs_Recipients['Justin'] = true;