Frequently Asked Questions

From FUDforum Wiki
Revision as of 18:51, 25 April 2009 by Naudefj (Talk | contribs)
Jump to: navigation, search

The FUDforum FAQ:

Contents

Installation FAQs

I've downloaded the installer and only see install.php, where is the files?

Install.php is like a self-extracting archive that contains all the files that you need within itself. Just run it (from your browser) and it will unpack all required files to the correct locations.

What's the difference between the zlib and the non-zlib installers?

The zlib files are compressed, hence smaller to download. For details, see http://www.php.net/manual/en/intro.zlib.php

To see if you have zlib installed, run this PHP script:

<?php
if (extension_loaded("zlib")) 
    echo "zlib is installed";
else
    echo "zlib is NOT installed";
?>

Theming FAQs

Why should I create my own theme instead of using the default?

Besides wanting to create a unique identity for your forum, users who want to change their themes should preferably create a separate theme to prevent subsequent upgrades (which may contain changes to the default theme) from overwriting their changes. If you don't plan to make any drastic theme changes, it's perfectly OK to use the default theme.

Why must I rebuild my theme after making manual changes?

After making manual changes to a theme's files (not via the Theme Editor), administrators must navigate to the Admin Control Panel -> Theme Manager to rebuild the theme. This is required for FUDforum to combine the theme's template, source and message files into the PHP scripts required to run the forum. The main advantage of this approach is that work is performed up-front making FUDforum's scripts lightning fast.

How do I disable the "Topic Description" field?

There are several ways to do it:

  • If you can use the field for something else, like a product version or so, just change its description in your "msg" file and recompile your themes:
post_descr:                     Topic Description:
  • Remove the line referencing "post_descr" from your theme's "post.tmpl" file and recompile your themes.
<tr class="RowStyleB"><td class="GenText">{MSG: post_descr}</td><td><input ...

Can I change the URL format?

The URL format depends on the theme you are using and what options you've enabled. Some examples:

Default theme:

  • With the Enable URL sessions (S=) and Track referrals (rid=) settings enabled, URL's will look like this:
http://127.0.0.1/forum/index.php?t=index&rid=2&S=1963f7fce4b7d3db9175dc3a4d6e8b7b
  • With the Enable URL sessions setting disabled and Track referrals enabled URL's will look like this:
http://127.0.0.1/forum/index.php?t=index&rid=2
  • When you disable Track referrals, it will be:
http://127.0.0.1/forum/index.php?t=index&

PATH_INFO theme:

The PATH_INFO theme (and Use PATH_INFO style URLs setting) can be used to enable search engine friendly URL's. A typical URL will be:

http://127.0.0.1/forum/index.php/i/

TIP: use webserver rewrite rules to remove the index.php part from your URL's.

Troubleshooting FAQs

FUDforum shows dates in English or with special characters?

This normally happens when the wrong locale was selected for a theme. Navigate to the Admin Control Panel -> Theme Manager to change your locale. When done, rebuild your themes.

The correct locale depends on your operating system. For example, one should typically use german on Windows systems, but de_DE.utf-8 on Linux/Unix systems. Always use a UTF-8 locale. Windows is the exception, as it doesn't have UTF-8 locales.

To get a list of installed locales on Linux (there is no equivalent Windows command), execute:

$ locale -a | grep de
de
de_DE
de_DE.ISO-8859-1
de_DE.ISO-8859-15
de_DE.UTF-8      <-- If possible, always pick a UTF-8 locale!
deutsch

FUDforum shows a blank screen. What now?

When you browse your FUDforum site and you get a blank page, it usually means that an error occurred, but PHP is configured not to display it.

  • Open your webserver's error logfile file (error_log for Apache) for details of the error.
  • To display errors on-screen, edit your forum's "index.php" file (or the script that causes the error) and add the following to the top (after the <?php tag):
error_reporting(E_ERROR | E_WARNING | E_PARSE | E_COMPILE_ERROR);
ini_set('display_errors', '1');
define('forum_debug', 1);

All my messages are empty, what is wrong?

FUDforum stores its metadata in the database and message bodies on disk in the FUDdata/messages directory (default setting, can be changed). If you can see your forums, users, etc., but your messages are empty, you need to check if your message files are still there and check if the webserver has read/write permissions on them. If required, restore them from a recent backup.

To trace the message path:

  • Pick a message and write down its message number (look for something like "message #528" in the header).
  • Query the file_id and offset where the message is stored. For example:
SELECT file_id, foff, length FROM fud28_msg WHERE id = 528;
10000	976757	2092
  • Look for the file with the selected file_id in your messages directory - in our case msg_10000.
$ ls
msg_10000
  • Check if the file contains the message body at the selected offset:
$ od -a -j 976757 -b 2092  msg_10000

FUDforum is slow, can I see the database queries?

Yes, edit index.php (or the required script) and uncomment the following line:

#define('fud_query_stats', 1);

Other FAQs

Who is using FUDforum?

There are too many sites to list here (do a Google search to see for yourself). Here are a couple, just to show that you are in good company:

Feel free to add your forum to the above list.

Who can host my forum for me?

If you don't want to install and maintain your own forum, contact one of the following provides to host your FUDforum solution for you:

How is FUDforum licensed?

FUDforum is released under version 2 of the GNU General Public License. In short, this means that FUDforum is free to download, use, distribute and modify. However, if any of these modifications are released to the public, that code must also be released under the same license as FUDforum. The copyright notice in all the source files, however, must be left intact. Any modification or removal of this copyright is illegal under the terms of the GNU General Public Licence.

Can I remove "Powered By FUDforum" from the footer?

Yes, you may remove the copyright from the footer, but please don't! If you must, please try to keep at least a small "Powered by FUDforum" with the link back to http://fudforum.org/ in some form on your forum.

Languages
Personal tools