Extension:LegalLogin

From mediawiki.org
Jump to navigation Jump to search
Other languages:
English • ‎polski • ‎العربية
MediaWiki extensions manual
OOjs UI icon advanced.svg
LegalLogin
Release status: stable
Screenshot of the LegalLogin extension UI.png
Implementation User activity
Description The LegalLogin extension require acceptance of legal policies and correct answer on test questions during account creation and login.
Author(s) Pavel Astakhov (Pastakhovtalk)
Maintainer(s) WikiTeq team
Latest version 1.0
Compatibility policy Snapshots releases along with MediaWiki. Master is not backwards compatible.
MediaWiki 1.35.0
PHP 7.4.3+
Database changes Yes
Tables legallogin_accepted
legallogin_logged
License GNU General Public License 2.0 or later
Download
README
$wgLegalLoginPolicies, $wgLegalLoginQuestions, $wgLegalLoginExpiration, $wgLegalLoginInterval, $wgLegalLoginLogActions
legallogin-view-log
Translate the LegalLogin extension if it is available at translatewiki.net

Check usage and version matrix.

The LegalLogin extension require acceptance of legal policies and correct answer on test questions during account creation and login.

This extension was created for WikiWorks.

Installation[edit]

  • Download and place the file(s) in a directory called LegalLogin in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    wfLoadExtension( 'LegalLogin' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Configuration parameters[edit]

$wgLegalLoginPolicies
The list of legal policies that will require acceptance during account creation and login. Only pages in NS_MEDIAWIKI namespaces allowed as correct values.
$wgLegalLoginQuestions
The questions that users will need to answer correctly before login. Only pages in NS_MEDIAWIKI namespaces allowed as correct values.
$wgLegalLoginExpiration
Require acceptance of legal policies again after defined seconds.
$wgLegalLoginInterval
Require acceptance of legal policies again after defined number of logins.
$wgLegalLoginLogActions
Save LegalLogin actions like acceptance of the policies to Special:Log.

Example:

$wgLegalLoginPolicies = [
   'Terms and Conditions of Use' => [ // text from MediaWiki:Terms and Conditions of Use, title is the same
      'require scrolling' => true, // user must scroll it to down or open in popup windows before accept
   ],
   'Privacy policy' => [ // text from MediaWiki:Privacy policy
      'captionmsg' => 'privacy-policy-caption', // MediaWiki:Privacy-policy-caption // caption of the policy
   ],
];


$wgLegalLoginQuestions = [
   'I hate this site' => [
      'answer' => false,
      'help' => 'This is a hint',
   ],
   'I love this site' => [
      'answer' => true,
   ]
];

User rights[edit]

legallogin-view-log
Allow to view LegalLogin actions like acceptance of the policies in "Special:Log"
Wikiteq - logo.png This extension is professionally maintained by the WikiTeq team.