=================================================
Instructions for Installing Censura with vbPortal
=================================================
Written by Darren Lewis (www.thebookforum.com)

Instuctions Version 1.00 (16 November 2002).
Tested with Censura V1.14.01b and vbPortal 3.0 beta 2.

=======
CENSURA
=======
Censura is a powerful reviews application available at www.incursio.com

Censura already has built-in options to integrate with forum communities including vbulletin, phpBB and several others.

These instructions are for installing Censura so that it fits into your vbPortal system.
It will allow Censura to use your vbPortal header and footer templates.

============
INSTRUCTIONS
============

Step 1
======
Open your Censura index.php file in a good text editor (eg TextPad)
Add this code to the very top of the index.php just after the <?

chdir( "../");
include("mainfile.php");
global $nukeurl, $bburl, $bbuserinfo;
// Optional code to show the vbportal breadcrumb
$index=0;
$Pmenu="";
$breadcrumb="Censura"; // Change this to whatever you want to call your Censura install eg Reviews
// End of optional code
chdir( "./censura"); // Change this to the directory your censura install uses.


Add this code to the top if any other custom Censura pages you create eg hot_items.php, most_pageviews.php

Step 2
======
Open your Censura startup.php file in your text editor

Find this line of code (approx line 27)

error_reporting(1);

Add this code after it

chdir( "../");
include("mainfile.php");
global $nukeurl, $bburl, $bbuserinfo;
// Optional code to show the vbportal breadcrumb
$index=0;
$Pmenu="";
$breadcrumb="Censura"; // Change this to whatever you want to call your Censura install eg Reviews
// End of optional code
chdir( "./censura"); // Change this to the directory your censura install uses.

Save the file and upload to your server to replace the exising one.

Step 3
======

Upload the included censura-header.php and censura-footer.php files to your censura folder on your server.
You may edit these to include any other code you wish to use.

For reference this is the contents of the two files

censura-header.php
~~~~~~~~~~~~~~~~~~
<?
chdir( "../");
include("header.php");
chdir( "./censura"); // Change this to the directory your censura install uses.
?>

censura-footer.php
~~~~~~~~~~~~~~~~~~
<?
chdir( "../");
include("footer.php");
chdir( "./censura"); // Change this to the directory your censura install uses.
print("<center>"); // This line will ensure the Censura Copyright is centered at the bottom of the page. Change to something else to format the Censura copyright bit.
?>

Step 4
======
Enter your Censura admin screen, and set the header & footer to external files.
Configuration -> General Options -> Headers/Footers

Set the "External Header File:" as censura-header.php
Set the "External Footer File:" as censura-footer.php


That's it!

Any questions, ask in the thread at www.phpportals.com and I'll try to help

Known Problems
==============
1
~
Will NOT work for external Vendor header and footer files, as vendor.php is encoded, and there is no startup.php equivalent (will speak with Scott at Incursio about this).

2
~
You still need to edit the Censura templates to fit your site.
Changes made to your vbportal styles & themes will not affect your censura templates.
Will try to update this hack with new Censura templates which can use vbportal variables.

3
~
The dynamic Censura page title will not work as the pages are using the generic vbportals one instead. Not sure how to solve this one yet.
May have to create some way of getting vbportal to create dynamic page titles.
May be able to set up a variable in the vbportal header.php file?