###############################################
####                                        ###
##                                           ##
#   Simple Bulletin Board - SBB4+ Edition     #
#   V4.2                                      #
#   2013-10-11                                #
#   envato@homac.net                          #
##                                           ##
####                                        ###
###############################################
#
#

Thank You for purchasing Simple-BB

The idea behind Simple-BB is an easy to use implement and simple Bulettin Board.



++++++++++++
+ Features +
++++++++++++

Easy to implement to your homepage, just upload files, define your setting in conf.php, create sql-tables, add some lines to you site, ready to ...  

* Protecting forum from non-registered users
* Activation by user or admin or disable activation
* Private Messaging
* The value of the mount of topics per page can be changed
* 3 CAPTCHA modules GD, GD-less and reCAPTCHA for registering new Users
* SEO Support
* attachments for topics and posts
* polls for topics
* pagination allover
* timeslot to enable editing of user's posts
* RSS-Feed for forums
* TXT-Exports for topics
* Own templates can be defined 
* Users can register themself and are able to post topics immediately after registration and logging in
* Administrators can make users to Administrators, Moderators and Default users
* Moderators are able to delete posts, delete complete topics, activate/deactivate/edit/delete users
* Users can enable/disable board and user notifications
* Users can contact other users via the board (if notification enabled)
* Users will be notified if one of their active topics got a new post
* BB-Code for topics and posts is implemented
* including Youtube and Vimeo embedding
* Multilanguage Support (English, German included)
* Ready to add more languages
* social shares (facebook, google, twitter)
* like posts
* dislike posts
* ... 

++++++++++++++++
+ Requirements +
++++++++++++++++

php5.x
mysql5.x
optional GD Library
optional mod_rewrite

++++++++++++++++
+ Special Note +
++++++++++++++++

This Board is to include into your existing site, it's not enough to link to the sbb folder
Take a look to the including-examples folder (the plain ones are minimum including examples)

++++++++++++++++
+ Installation +
++++++++++++++++

- Just unzip, upload and define Your options in the conf.php [upload the whole sbb folder]

- Run setup.php and follow instructions
 
- To implement the forum into your site some things have to be done (examples are attached -> index.php, plain.php):
    
#####
# Open the file where the forum should be implemented. This file has to be a php file (e.g.: just rename your file.html into file.php)
#####

#####
# At the top (really the top, nothing should be writen above) post these lines
#####
    
<?php
ini_set("session.gc_maxlifetime",84600);
@session_start();
include("sbb/forum.php");
?>

#####
# In the HTML-Header of your site post these lines anywhere between <head> and </head>
# ATTENTION: Use the correct path to the files (e.g. sbb/ )
# if you're already using JQuery you shouldn't include it twice, but above the sbb js files 
#####

<link rel="stylesheet" href="<?php echo $template_path . "/styles.css"; ?>" type="text/css">
<script type="text/javascript" src="sbb/js/jquery.1.9.1.min.js"></script>
<script type="text/javascript" src="sbb/js/jquery.tipsy.js"></script>
<link rel="stylesheet" href="sbb/css/tipsy.css" type="text/css" />
<script type="text/javascript" src="sbb/js/sbb.js"></script>
<?php echo $sbb_add2head; ?>

####
# for SEO titles
# find the title-tag in your header <title> </title>
# and add before </title>
# i.e.: <title>My Website <?php echo $sbb_add2title; ?></title>
####

<?php echo $sbb_add2title; ?>

#####
# now find the place where the forum should be displayed and post
#####

<?php echo $sbb_forum; ?>


++++++++++++++++++++++++++++++++++++
+ User/Pass for the 1st admin user +
++++++++++++++++++++++++++++++++++++

User: admin
Pass: pass

++++++++++++
+ Redesign +
++++++++++++

Feel free to use your own css-codes and create your own templates
Source images of the buttons are attached 

++++++++++++++++++++++++++++++
+ REALLY USEFULL INFORMATION +
++++++++++++++++++++++++++++++

More or less important variables within the conf.php
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The extensions for the avatars

  $img_ext_arr = array("jpg", "jpeg", "png", "gif");

Important information for your database

  $db_host = "localhost";                             //change!!
  $db_user = "SBB";                               //change!!
  $db_pass = "SBB";                               //change!!
  $db_name = "SBB";                               //change!!

  $ftable_prefix = "SBB2_";

Adminmailaddress to inform about language or database troubles

  $conf_admin_mail = "SBB@DOMAIN.TLD";                //change

If you have misconfigured your .htaccess and are not able to access board administration st the following variable to false (uncomment) and SEO is disabled and you can reach the board administration again

  //$board_config->seo = false;        

Languages
~~~~~~~~~

With SBB 2.0 a new language system is implemented

the language files can be find in the sbb/lang directory

each language has it's directory (en - english, de - german)

there are two lang.php files and some text files (for mailings))

to add a new language just copy i.e. the en folder to it for example and modify the lang.php and txt-files

after creating the new directory the language can be selected in the board administration

if you like to check if there are missing language keys in your installation you can run sbb/lang/langcheck.php (new since 3.2)

External Smilies
~~~~~~~~~~~~~~~~

To enable external Smilies you just have to upload gif files into the sbb/images/smilies/ directory.

To disable the external Smilies just remove the gif files, you could delete or rename the smilies-folder too to disable this function

The suitable bbcodes will be generated automatically 

External Avatars
~~~~~~~~~~~~~~~~

To enable external Smilies you just have to upload folders into the sbb/images/avatars/ directory.

To disable the external Smilies just remove folder in the avatars folder
  
Templates
~~~~~~~~~

SINCE 4.0 a new Template Engine is used: Quickskin (http://quickskin.worxware.com/)

Template defaultXHTML: light XHTML Template
Template CarbonCity: dark XHTML Template
Template Marabellow: dark XHTML Template
Template Silk: dark XHTML Template
Template sLime: dark XHTML Template
Template Velvet: dark XHTML Template

The template directory sbb/templates contains the template directories. SBB is shipped with the default templates.
If you like to design a new template just copy the directory into another one within the templates directory and define your new template in the board administration

The template-class is equipped with some functions - you will find more infos on http://quickskin.worxware.com/

The class was extended and reprogrammed and got some fixes by me


++++++++++++++++++++
+ More Information +
++++++++++++++++++++

Some icons from FamFam
CAPTCHA class from phpcaptcha.org
GD-less CAPTCHA -> tipps from Homepage-Total.de