Difference between revisions of "Wiki Setup"

From Nuclear Physics Group Documentation Pages
Jump to navigationJump to search
 
(Added information for the Ldap Authentication extension.)
Line 8: Line 8:
 
* Pick the skin: monobook  -- This is where you could do serious customization of the interface.
 
* Pick the skin: monobook  -- This is where you could do serious customization of the interface.
 
* Change the Logo picture: set $wgLogo to images/UNHNPG_logo.png and put correct image there.
 
* Change the Logo picture: set $wgLogo to images/UNHNPG_logo.png and put correct image there.
 +
 +
== Extensions ==
 +
 +
Currently the only installed extension is [http://www.mediawiki.org/wiki/Extension:LDAP_Authentication Ldap Authentication] version 1.2a (Current as of 9/21/09).
 +
 +
=== Ldap Authentication ===
 +
 +
LdapAuthentication.php is located in the wiki folder on Roentgen under extensions. The configuration settings for the extension are located in the LocalSettings.php file.
 +
 +
==== Settings ====
 +
 +
These are the settings currently configured for the Ldap Authentication (located at the bottom of LocalSettings.php):
 +
 +
# includes the LDAP Authentication Plugin
 +
require_once( "$IP/extensions/LdapAuthentication.php" );
 +
$wgAuth = new LdapAuthenticationPlugin();
 +
 +
# Sets the name for the LDAP domain
 +
$wgLDAPDomainNames = array( "physics" );
 +
 +
# Sets the domain names of LDAP servers to use
 +
$wgLDAPServerNames = array( "physics" => "einstein.unh.edu"  );
 +
 +
# LDAP binding options
 +
$wgLDAPSearchStrings = array(
 +
"physics"=>"uid=USER-NAME,ou=People,dc=physics,dc=unh,dc=edu" 
 +
);
 +
$wgLDAPSearchAttributes = array( "physics" => "uid" );
 +
$wgLDAPBaseDNs = array( "physics" => "dc=physics,dc=unh,dc=edu" );
 +
 +
# Specifies the type of encryption to use. TLS is the default, but it's
 +
# explicitly set here just to be safe.
 +
$wgLDAPEncryptionType = array( "physics" => "tls" );
 +
 +
# Retrieves user information from LDAP
 +
$wgLDAPRetrievePrefs = array( 'physics' => true );
 +
 +
# Disables using the local database for user authentication.
 +
$wgLDAPUseLocal = false;
 +
 +
 +
In order for the Ldap Authentication plugin to work you need to add a line to the LdapAuthenticaion.php file that includes AuthPlugin.php. It should look like this:
 +
 +
require_once("AuthPlugin.php");
 +
 +
and should be placed above the line which reads:
 +
 +
class LdapAuthenticationPlugin extends AuthPlugin {
 +
 +
If this isn't included you will just get a blank white page due to a php error.

Revision as of 12:00, 21 September 2009

A standard "media wiki" was installed on roentgen (nuclear.unh.edu) in /var/www/nuclear
This was originally in the now defunct "physics" directory, our old physics website. I moved it and made a link "wiki".

Customizations

So far the only changes made to standard install:

  • Pick the skin: monobook -- This is where you could do serious customization of the interface.
  • Change the Logo picture: set $wgLogo to images/UNHNPG_logo.png and put correct image there.

Extensions

Currently the only installed extension is Ldap Authentication version 1.2a (Current as of 9/21/09).

Ldap Authentication

LdapAuthentication.php is located in the wiki folder on Roentgen under extensions. The configuration settings for the extension are located in the LocalSettings.php file.

Settings

These are the settings currently configured for the Ldap Authentication (located at the bottom of LocalSettings.php):

# includes the LDAP Authentication Plugin
require_once( "$IP/extensions/LdapAuthentication.php" );
$wgAuth = new LdapAuthenticationPlugin();

# Sets the name for the LDAP domain
$wgLDAPDomainNames = array( "physics" );

# Sets the domain names of LDAP servers to use
$wgLDAPServerNames = array( "physics" => "einstein.unh.edu"  );

# LDAP binding options
$wgLDAPSearchStrings = array( 
"physics"=>"uid=USER-NAME,ou=People,dc=physics,dc=unh,dc=edu"  
);
$wgLDAPSearchAttributes = array( "physics" => "uid" );
$wgLDAPBaseDNs = array( "physics" => "dc=physics,dc=unh,dc=edu" );

# Specifies the type of encryption to use. TLS is the default, but it's 
# explicitly set here just to be safe.
$wgLDAPEncryptionType = array( "physics" => "tls" );

# Retrieves user information from LDAP
$wgLDAPRetrievePrefs = array( 'physics' => true );

# Disables using the local database for user authentication. 
$wgLDAPUseLocal = false; 


In order for the Ldap Authentication plugin to work you need to add a line to the LdapAuthenticaion.php file that includes AuthPlugin.php. It should look like this:

require_once("AuthPlugin.php");

and should be placed above the line which reads:

class LdapAuthenticationPlugin extends AuthPlugin {

If this isn't included you will just get a blank white page due to a php error.