How to Upload an Extension to Phpbb3
This extension requires the PluggableAuth extension to be installed first.
PHPBB_Auth Release condition: stable | |
---|---|
Implementation | User identity , Database |
Clarification | Enables MediaWiki authentication using phpBB user credentials. |
Author(s) | Nicholas Dunnawaytalk |
Latest version | 4.0.0 (2022-03-xiv) |
MediaWiki | 1.31+ |
License | GNU General Public License 2.0 or afterwards |
Download | GitHub:
Note: Read Me |
Bank check usage and version matrix. |
The PHPBB_Auth extension allows MediaWiki users to log in using phpBB user credentials and disallows the cosmos of new accounts in MediaWiki. The extension uses the PluggableAuth extension to work with MediaWiki 1.35 and later.
Requirements [edit]
The extension requires
- PHP vii.3+
- MySQL 5+
- MediaWiki ane.31+
- phpBB iii.2+
Installation [edit]
If you demand help, mail service an outcome on GitHub.
- Download and install the PluggableAuth extension.
- Download the PHPBB_Auth extension from GitHub.
- Extract the archive and move the contents to
extensions/Auth_phpBB
. - Add the lawmaking below to the bottom of LocalSettings.php.
$wgAuth_Config = [ //======================================================================= // Required settings 'PathToPHPBB' => '../phpbb3/' , // Path from this file to your phpBB install 'UserTB' => 'phpbb3_users' , // Name of your phpBB user table 'GroupsTB' => 'phpbb3_groups' , // Name of your phpBB groups tabular array 'User_GroupTB' => 'phpbb3_user_group' , // Proper name of your phpBB user_group table // Make MediaWiki usernames match the example of the phpBB usernames (except // with the first letter fix to uppercase). Setting this to false causes // usernames to be all lowercase except for the beginning character. // NOTE: Before June 2016 this setting was always false, changing information technology to // true on an install where it previously was fake will crusade users with // uppercase characters to announced as separate users from their previous // all-lowercase account! 'UseCanonicalCase' => true , ]; // load the authentication extensions wfLoadExtension ( 'PluggableAuth' ); wfLoadExtension ( 'Auth_phpBB' );
Optional features [edit]
PHPBB_Auth supports several optional features likewise, including connecting to phpBB tables in an external database, requiring users to exist a fellow member of a specific phpBB group to log in, customized error messages, and custom phpBB-to-MediaWiki username translation.
See the project'due south README for more information on how to configure these.
Known issues [edit]
Usernames rules [edit]
MediaWiki does non follow the same user naming conventions equally phpBB, then at that place may exist problem if someone uses an invalid username. Although all MediaWiki usernames are valid in phpBB, some phpBB usernames are not valid in MediaWiki. For case, MediaWiki does not allow the '[]' bracket symbols.
In that location are a few means to solve this problem:
- The suggested approach for existing phpBB installations is to create a custom phpBB user contour field where a phpBB admin can set a MediaWiki-friendly username for users with incompatible names. The Custom phpBB-to-MediaWiki username translation section of the README goes into this in depth.
- Installing a phpBB extension to restrict MediaWiki-incompatible characters in phpBB.
- Limit phpBB username characters to Alphanumeric but in the User registration settings of phpBB3.
Furthermore, watch out that MediaWiki doesn't allow the same phrase as countersign that you chose for your username. phpBB doesn't have a problem with password and username existence the same phrase.
Problems with non sharing a database [edit]
Some users feel an mistake when phpBB and MediaWiki are in different databases, while other users have no trouble doing so. It's possible that this may be related to non-English software, which is mutual to users reporting the error.
Release log [edit]
For release since three.1.0, see the project's releases page on GitHub.
- Release iii.1.0 (Mar. 22, 2016)
- Update to MySQLi and php7
- Update iAuthPlugin.php
- Update Auth_phpbb.php
- Add User type check as per Community Contributions
- Release 3.0.iii (Jan. 1, 2008)
- Fixed a potential SQL injection security pigsty.
- Added support for multiple Wiki Groups.
- Release 3.0.2 (December. 28, 2007)
- Now works with and requires phpBB3.
- Now works with and requires MW ane.xi.x
- Now requires PHP5.
- Uses phpBB3 username case folding methods.
- Uses phpass for password hashing.
- When the user is not in the "Wiki" group the user now sees a MediaWiki error that says and then.
- When the user is not found in the phpBB user database they now encounter a MediaWiki error asking them to register.
- Added a link to phpBB'southward register folio from the login screen.
- Plug-in at present uses MediaWiki Hooks.
- Release 2.7
- Fixed a potential SQL injection security hole.
- Release 2.6
- Fixed a login bug where MW was displaying an error the showtime time a user logged into it.
- Now works with MW 9.2
- Release ii.5
- I made a modify to the MySQL connection that might fix some of the issues people have been having .
- Release 2.4
- Better MySQL fault reporting. More solid MySQL Query calls.
- Release two.iii
- phpBB usernames with an apostrophe in them volition at present work.
- Release ii.2
- Fixed a issues that was printing a SQL statment when called.
- Release 2.1
- Fixed a issues that was not letting preferences be saved.
- Release ii.0
- Works with MediaWiki 1.5.x
- Fixed the dup name issues. The ane.v release of MediaWiki added a new function to check for the right casing of a name earlier adding it to the wiki database.
- I examination user names with a infinite in them and they seem to work fine too.
- Added support for phpBB and the wiki existence on two different servers/databases.
- With the new release of MediaWiki one.5, I was able to disable some template stuff.
- Release 1.nine
- Now auto detects MySQL version and uses the correct query.
- Ver 1.9 will work on both MySQL 4.0.x and iv.1.x
- Release one.7
- Added the code to allow the admin to disable the phpBB wiki group requirement.
- Release ane.five
- MediaWiki forces all usernames into a beginning letter uppercase the balance lower case. (gotroot becomes Gotroot) This is ok until you accept a user who has an capital letter alphabetic character in the middle of their proper name. (RetroFit becomes Retrofit) This can cause a problem when trying to Auth with the phpBB user table. I do non have a fix for this. (FIXED)
Source: https://www.mediawiki.org/wiki/Extension:PHPBB_Auth
0 Response to "How to Upload an Extension to Phpbb3"
Post a Comment