Version 1

Tweaking Bitweaver

Created by: laetzer, Last modification: 13 Feb 2010 (21:06 UTC) by laetzer

For advanced users! - A lot of adjustments to Bitweaver can be made by tweaking the templates files (*.tpl) of the current style. Other tweaks may require you to change PHP code. This means, your changes could break other features, or they might be lost after upgrades. Also, some tweaks might be so effective they should be included in the next release, or be their own package. Some tweaks might be so specific ("bad") that normal users shouldn't be encouraged, but alerted to use them.

Lynx style

Bitweaver uses a browser sniffing library. If a site is visited by a text browser, the style "Lynx" is automatically served to the user agent. While this is generally an advantage, it can be a disadvantage with a customized theme. The Lynx style includes certain templates that might have been excluded on purpose (like the login form, or text-based navigation links), and also brings its own doctype declaration which might not be true for the rest of the page (again, this applies only if you wrote your own theme). Certain services like and source code validators also receive code that didn't actually want to send them. To disable it, comment this part:


// if we're viewing this site with a text-browser, we force the text-browser theme
global $gSniffer;
if( !
$gSniffer->_feature_set['css1'] && !$gSniffer->_feature_set['css2'] ) {
$gBitThemes->setStyle'lynx' );


Depending on database and server setup, getting Unicode input or output to work can be tricky. If you're using MySQL, so far there's this page about MySQL and character encoding.

FCKeditor custom files

The rich text editor FCKeditor (or CKeditor) lets you customize not only which buttons your users can see, but also which styles they can choose from (via an XML file), plus some other settings. This is discussed on FckeditorPackage.

Safe Mode etc.

If any problems with PHP's Safe Mode or open_basedir occur, the first thing that should be tried is to force the /temp/-path in kernel/config_inc.php. More about all this: InstallUnderSafeMode.


This file, placeed in Bitweaver's root directory, usually addresses bitweaverPerformance and Security. There's a page discussing The perfect .htaccess file for Bitweaver.
Page History
17 Feb 2010 (16:03 UTC)
added if user
Current • Source
View • Compare • Difference • Source