|
|
 |
Selecting .htaccess file options
To control automatic .htaccess file generation, log in to the administration program as the board administrator (typically "admin"), go to the Spam Blocker interface, and click the "Manage .htaccess" tab. Assuming you have correctly placed an ".htaccess" file in your Discus CGI directory as per the setup procedure noted below, you will see this option:
Allow Discus to maintain this .htaccess file: If checked, when an IP address is banned or un-banned through any Discus feature, the list of blocked IP addresses in the .htaccess file will be automatically synchronized. If not checked, the .htaccess file will not be synchronized. Note: unchecking this box does not delete or disable the .htaccess file -- if you want to do that, you need to remove the file manually using an FTP or command line access client.
Setting up an .htaccess file for the first time
It is unlikely that, upon the first installation of your Discus Professional discussion board, that you will have a writable .htaccess file in your Discus script directory. As such, in order to use this feature, you will first have to set up this file. This can be done as follows:
Using a text editor (such as Notepad) to create a new text document. Do NOT use a word processor like Microsoft Word or an HTML editor like Dreamweaver!
Copy the following text into the document you just created:
<Files board-post.cgi>
Order allow,deny
Allow from all
Deny from none
</Files>
Note: Replace cgi in the above example with the actual CGI extension that you chose, if different.
Save the text file and upload it to your web server using FTP, placing it in your Discus script directory (along with the other scripts such as "board-post.cgi"). Use ASCII mode when transferring the file.
If necessary, rename the file .htaccess (that's a "dot" followed by htaccess). Capitalization is important, and if you don't name this file correctly, it won't work.
Set permissions on the .htaccess file to 666 (rw-rw-rw-). (Most FTP programs present this as a series of checkboxes. You need to check both "read" and "write" for user, group, and other.)
After creating the file and setting permissions, click the "Manage .htaccess" tab again. You should then see the above mentioned option screen.
Solving the "Your .htaccess file exists but is not writable to this application" message
If you receive the message "Your .htaccess file exists but is not writable to this application" when setting up the .htaccess file, you have not properly set permissions on this file after uploading.
Using your FTP program, log in to your server and navigate to the Discus script directory (which also contains scripts such as "board-post.cgi").
Set permissions on the .htaccess file to 666 (rw-rw-rw-). (Most FTP programs present this as a series of checkboxes. You need to check both "read" and "write" for user, group, and other.)
System Requirements
The ".htaccess" file will be recognized only by Apache web servers, and then only if the server is configured to recognize those files. On other web servers, or Apache servers that have been configured not to recognize .htaccess files, this feature can still be set up but it will have no effect.
DiscusWare does not provide support for configuring the Apache web server. Please see the Apache documentation for additional documentation.
|