Index

How do I enable LDAP?
How do I change the header or footer? What files do I edit?
Why do I keep getting a 403 or 500 error when I try to access the main page?
I logged in with LDAP but I'm not the administrator. How do I get admin privileges back?

How do I enable LDAP?

By default, the application is configured to not use LDAP. In order to enable LDAP, you need to update ./php_auth/defines.php to contain LDAP information, making sure to set USING_LDAP to true.

//ldap info
define ('USING_LDAP', true);
define ("LDAP_HOST","");
define ("LDAP_HOST_2","");
define ("LDAP_PORT","");
define ("SUFFIX","");
define ("BASE_DN","");
define ("BIND_DN","");
define ("BIND_PWD","");

Comment out all instances of "use Net::LDAP" in CGI.pl
Restore the original DBNameToIdAndCheck() in globals.pl (it's still there, just commented out)

See the bug reported on disabling LDAP to read the discussions and get more info.

How do I change the header or footer? What files do I edit?

The helpdesk has template files for most of its content. These can be edited to customize the look and feel so it doesn't look like it belongs to OSU.

First, you should get a feel for the Template Toolkit syntax:

Read the Template Toolkit documentation

You will want to edit these files:

/template/en/default/global/header.html.tmpl
/template/en/default/global/footer.html.tmpl

You will be able to customize most of the look by editing these template files. We suggest trying to use CSS as much as possible, because it is the proper way to add fonts, colors, background images, etc.

Changing the template and branding

Why do I keep getting a 403 or 500 error when I try to access the main page?

This may be caused by a number of reasons. First, make sure you have followed the install instructions for apache. Once you double check those, check:

Permissions on the .cgi files should allow execution by the web-group/web-user.
The .htaccess file generated by checksetup.pl is not readable by the web server.
You are not allowing access to this directory in your default apache configuration.

These are common problems we've seen. Overall, you should check your apache error logs to see what error you are receiving. That will help you find the source of the problem.

How do I set up the spellchecker?

Spelling most likely won't work out of the box because it needs to be configured to work for your specific installation. Here are the steps you need to take to enable it.

Insert your helpdesk address in line 12 of /speller/server-scripts/spellchecker.php
```
$installationURL = 'http://YOURDOMAIN/YOURPATH';
```
Insert your helpdesk address in line 16 of /speller/spellCheck.js
```
this.installationURL = 'http://rankin.osuosl.org/helpdesk';
```
If the spell checker doesn't work properly, make sure aspell/pspell is set up for PHP.
Note that if you have a stingy pop-up blocker, it may block the pop-up for the spellchecker.

I logged in with LDAP but I'm not the administrator. How do I get admin priveleges back?

This happens when the initial admin email you chose does not match your LDAP email. In this case, you will want to:

Log in as the account you created during the installation
Use your admin account to grant admin priveleges to your LDAP account