SEO Filter Installation Guide

Installation Process

Download and install a forum software (phpBB, punBB) (if not installed yet)
Turn off output compression (SEO Filter will handle this)
Download latest SEO Filter source code
Unzip/untar the archive file
Upload extracted files in your forum folder via FTP
Install SEO Filter Handler
You're ready to go at your forum url
if you have problems with SEO Filter please check support section

Have SEO Filter installed for you (pricing).

following instructions are also available in install.txt in SEO Filter package.

# 1 Installing SEO Filter Handler on a hosting with apache mod_rewrite module

If you are sure your hosting supports mod_rewrite Apache module
use following approach to install SEO Filter Handler otherwise you may receive
an "Internal Server Error" or a working forum without optimization due
to non installed SEO Filter Handler.

replace all occurrences of %%%FORUM_WEB_PATH%%% with
your forum web path (/punBB, /phpBB2, /forum or an empty string if the forum is installed on its own (sub)domain).

##### SEO Filter Handler Begin ##### # mod_rewrite RewriteEngine On RewriteOptions inherit RewriteRule ^/$ /seofilter.php [L] RewriteCond %{REQUEST_URI} !seofilter.php [NC] RewriteCond %{REQUEST_URI} !admin [NC] RewriteCond %{REQUEST_URI} %%%FORUM_WEB_PATH%%%/([^./]+\.(php|html?).*) RewriteRule (.*) %%%FORUM_WEB_PATH%%%/seofilter.php?seo-file=%1&%{QUERY_STRING} [L] ##### SEO Filter Handler End #####
Save in .htaccess and upload it where are your forum files.

Note #1:
When upgrading your forum you must disable SEO Filter Handler.

replace: "RewriteEngine On" -> "RewriteEngine Off"
and when you upgrade forum files you can turn it On again.

Note #2:
if you have already .html handlers
you must remove them because they may break SEO Filter Handler.

Warning:
Please be aware that your forum may stop operating for a while during SEO Filter installation.

example 1.1:

forum installed at http://domain.com/punBB

.htaccess

##### SEO Filter Handler Begin #####
# mod_rewrite
RewriteEngine On
RewriteOptions inherit
RewriteRule ^/$ /seofilter.php [L]
RewriteCond %{REQUEST_URI} !seofilter.php [NC] 
RewriteCond %{REQUEST_URI} !admin [NC] 
RewriteCond %{REQUEST_URI} /punBB/([^./]+\.(php|html?).*)
RewriteRule (.*) /punBB/seofilter.php?seo-file=%1&%{QUERY_STRING} [L]
##### SEO Filter Handler End #####

paste the lines above in a .htaccess file in where are forum files. if file exists append them.

example 1.2:

forum installed at http://forum.domain.com

.htaccess

##### SEO Filter Handler Begin #####
# mod_rewrite
RewriteEngine On
RewriteOptions inherit
RewriteCond %{REQUEST_URI} !seofilter.php [NC]
RewriteCond %{REQUEST_URI} !admin [NC] 
RewriteCond %{REQUEST_URI} /([^./]+\.(php|html?).*)
RewriteRule (.*) /seofilter.php?seo-file=%1&%{QUERY_STRING} [L]
##### SEO Filter Handler End #####

paste the lines above in a .htaccess file in where are forum files.
if file exists append them.

# 2 installing without mod_rewrite

2.1. replace %%%FORUM_WEB_PATH%%% with
your forum web path (/punBB, /phpBB2, /forum or an empty string if the forum is installed on its own (sub)domain).

.htaccess

##### SEO Filter Handler Begin #####
AddHandler seofilter-handler html
Action seofilter-handler %%%FORUM_WEB_PATH%%%/seofilter.php
##### SEO Filter Handler End #####

2.2. copy and paste lines below in forum's config.php before closing "?>"
if there is no closing "?>" append at the end.

config.php

##### SEO Filter Handler Begin ##### 
$seofilter_base_dir = dirname(__FILE__) . DIRECTORY_SEPARATOR;
require_once($seofilter_base_dir . "seofilter.php");
##### SEO Filter Handler End #####

Note #1:
When upgrading your forum you must disable SEO Filter Handler.

by adding "#" in front of each line both for .htaccess and.config.php

Note #2:
if you have already .html handlers
you must remove them because they may break SEO Filter Handler.

Warning:
Please be aware that your forum may stop operating for a while during SEO Filter installation.

example 2.1:

forum installed at http://domain.com/punBB

.htaccess
##### SEO Filter Handler Begin ##### AddHandler seofilter-handler html Action seofilter-handler /punBB/seofilter.php ##### SEO Filter Handler End #####

example 2.2:

forum installed at http://forum.domain.com

.htaccess
##### SEO Filter Handler Begin ##### AddHandler seofilter-handler html Action seofilter-handler /seofilter.php ##### SEO Filter Handler End #####

config.php
##### SEO Filter Handler Begin ##### $seofilter_base_dir = dirname(__FILE__) . DIRECTORY_SEPARATOR; require_once($seofilter_base_dir . "seofilter.php"); ##### SEO Filter Handler End #####