OVERVIEW
This is a piece of blog software made with high traffic, search engines and security in mind. It comes with a variaty of tools needed to build and maintain an active blog. It doesn't come with a complete nice looking design, but there is some bogus stuff in place, so you can get a picture of how it works. The output is basicly build WC3 compatible, but when it comes to a conflict between WC3 and browsercompatibility, the later is chosen.

FEATURES
* Template system for mainpage, gallerypage, webmaster page, contact page.
* Pages are cached, which means low impact on the database. Site is ready for high traffic.
* Easy implementation of tradescript.
* Posting system with implemented prefix function for tradeprefix.
* Gallery generator with implemented sponsor code function.
* Image uploader with thumb creator. Cut-and-paste code will be generated to put in the galleries.
* Full featured crop tool, that makes it fast and easy to make thumbs for posts and gallery previews.
* htacces/htpassword generating tool.
* RSS 2.0 feed for posts (posts.xml).
* RSS 2.0 feed for galleries (galleries.xml).
* Google XML sitemap generator (sitemap.xml).
* Yahoo txt sitemap generator (yahoo.txt)
* Cleans up files and images, when deleting posts and galleries.
* Smart strip for long gallery names.
* Search engine friendly.
* Fast and secure.

FUTURE PROJECTS
* More control over the galleri page.
* Sceduled postings.
* News posting feature
* Setup done from just one file.
* Language packs
* I'll listen to the feedback from users, and improve where needed.

INSTALLATION
You need a Linux/freeBSD server with PHP, MYSQL and GD library. Imagemagic can be an advantage, but is not nessesary.
Upload all files in the package to your server (root or subfolder).

Folders CHMOD:
admin chmod 777
admin/BBcroptool chmod 777
admin/BBcroptool/temp chmod 777
design_elements/girl_thumbnails chmod 777
design_elements/post_thumbnails chmod 777
upload/img chmod 777
upload/thumbnails chmod 777
includes/posts chmod 777
the folder where you install the script has to be CHMOD 777
all other folders chmod 755

Files CHMOD:
galleries.php chmod 766
admin/BBcroptool/config.inc.php chmod 766
design_elements/show_gall_horisontal.php chmod 766
design_elements/show_gall_vertical.php chmod 766
design_elements/gallstyles.css chmod 766
design_elements/mainstyles.css chmod 766
includes/all files ending with inc.php chmod 766
includes/posts/page1.php chmod 766

Your Admin area is now located here:
http://www.yourdomain.com/installationfolder/admin

Go to settings menu in the admin, change the database and folder settings and hit the update button
click the link named "Create Database Tables"
(the "Mainpage" menu will not work, until you reload the admin page!)
Now create htaccess and htpasswd to protect your admin ares. You will also find the link in the "Settings" menu.

The installation is now finished, but you might want to look a little into the settings menu before you go further.

GETTING STARTED
Go to the "New Post" menu and make a couple of test posts. A couple of posts will help you to decide the design of your site. If you need to crop a picture for the post, then go to the "Crop Tool" menu, and crop a thumb for the post. You can always edit or delete posts again at a later point from the "Post List" menu.
Go to the templates menu and the styles menu, and make your design choices. The result can be seen if you click the "Main Page" menu.

Now make a couple of test galleries. Go to the "Upload Pics" menu and upload 14-20 images. The thumbs and code for the galleries will be generated. Copy the code, and paste in "gallery_html"-field in the "Add Gallery" menu. Now go to the "Crop Tool" menu and make your preview thumb. Fill out all the fields and hit the "Submit Gallery" button. Your first gallery is done, and can now be seen/edited/deleted from the "Gallery List" menu. The gallery preview thumb will also show up on the gallery page "galleries.php". If you are unhappy about the size of the thumbs in the gallery, then go to the "Settings" menu. Near the bottom you vill find values for gallery thumbs and the preview thumb for the gallery.

THE MENU'S:

"MAINPAGE" menu:
this link takes you to your mainpage. If you don't see all changes immediately, just edit a post. This is because of the cache system

"NEW POST" menu:
Fill out the fields for title and link. If you use a tradescript, you might want to add a prefix to the link, in order to keep track of the outgoing clicks.
I.e if using Arrow trader the prefix would look like this:
"/cgi-bin/at3/out.cgi?id=198&tag=plug&trade= " -change the red number to fit the right site.
You can add/edit/delete as many prefix's as you want, and store them paired with the corresponding sites. When adding a new post, just pick the relevant sitename from the dropdown-list, and the prefix get's added in front of the link.

Add a description, and keep in mind that it will fit the layout on your front page.
Credit Text and Credit Link is filled, if you want to add a sort of "thanks to" in the post.
Hit "Post It" (posts.xml, galleries.xml, sitemap.xm, yahoo.txt get's updated).

"POST LIST" menu:
Here you'l find the complete list of you postings. Hit the "edit" link if you want to change something in the post. If you check the "delete" box before hitting "Edit Post", the post will of course get deleted, and the corresponding image will be cleared from your server.
(posts.xml, galleries.xml, sitemap.xm, yahoo.txt get's updated).

"ADD GALLERY" menu:
Pick a gallery title. It's recommended to use a title with more than one word. whitespaces between the words wil be replaced with a hyphen. The title will create the gallery file name. I.e will a tittle like "Ten Green Potatos" create a gallery called Ten-Green-potatos.php.

Insert the gallery-html, preferrable pasted code generated from the "Upload Pics" menu. This way the sponsor link wil be present at the image php-file.

Chose a sponsor from the dropdown list. You can add/edit/delete as many sponsors as you want, and store them paired with the corresponding code. This sponsor/sponsorcode will be accessible on the image show page.

Add a preview thumb for the gallery. This thumb will show up in your gallery page (galleries.php). The dimension of this image is determined in the "Settings" menu, and it will also be your first choice in the "Crop Tool" menu.
Now go to the "Crop Tool" menu (open in a new window) and make your preview thumb. Submit the gallery.
(posts.xml, galleries.xml, sitemap.xm, yahoo.txt get's updated).


"GALLERY LIST" menu:
Here you can see the complete list of your galleries. Hit the "edit" link if you want to change something in the gallery. If you check the "delete" box before hitting "Edit Gallery", the gallery will of course get deleted, and the corresponding preview image will be cleared from your server. The gallery itself will not get deleted, but replaced with the text:" this gallery has been removed...Visit MY SITE for the pics".
(posts.xml, galleries.xml, sitemap.xm, yahoo.txt get's updated).

"CROP TOOL" menu:
First time you use the tool, you have to upload a jpg image for cropping.
Chose desired cropping size from the drop down list. If you can't find what your looking for, then go to "config" in the croptool, and predefine the values you want. Deside if you want filters and/or mask applied. From the yelllow icon at the right you can upload a new picture for cropping.

How to use:
1. Load a jgp picture for cropping
2. Decide thumb-quality, and filters on/off
3. If nessesary go to "settings" and adjust desired initial values
4. Choose cropping dimension, use "Ctrl" and mousepointer for scaling
5. Double click the selected portion
6. Right click and save your thumb

The "config" should be self explanatory. Go there and try out some settings.

"UPLOAD PICS" menu:
This is where you upload the images for the gallery. Username and password is set in the "settings" menu.
Chose the amount of pictures you want in your gallery, and click the link "Upload multible files at once". Set the number of pictures you want in the top field, and hit "Go". Upload your pics, and copy the generated code. This code goes into the "gallery_html" field in the "Add Gallery" menu.

"TEMPLATES" menu:
Mainpage:
Top
here you may want to include your top-image, some links and maybe the horisontal gallry list

here is an example:
----------------------------------------------------------------------------------------------------------
<center>
<a href="http://www.yourdomain.com"><img src="design_elements/images/yourtop.gif" width="770" height="249" alt="HOME" border="0"></a>
<br>
<? readfile("design_elements/show_gall_horisontal.php"); ?>
</center>
----------------------------------------------------------------------------------------------------------

Bottom
this is the place to put the counter, copyright info, 2257 info etc.

Left + Right
a good spot to place your toplists and some functions
(you can leave out the left and / or right section if you want.)

functions mainly for the left or right column:
<? include("design_elements/dato.php"); ?> (include the date where you want it)
<a href="galleries.php">My Own Galleries</a> (link to your gallery page, example: theteenblog galleries )
<a href="webmasters.php">Webmaster Page</a> (link to your webmaster page)
<a href="surfers.php">Contact Siteowner</a> (link to your contact page)
<a href="posts.xml">RSS 2,0 Posts</a> (link to RSS feed of your posts)
<a href="galleries.xml">RSS 2,0 Galleries</a> (link to RSS feed of your galleries)
<a href="sitemap.xml">Google Sitemap</a> (link to the Google XML sitemap)
<a href="yahoo.txt">Yahoo Sitemap</a> (link to the yahoo txt sitemap)
<? readfile ("design_elements/show_gall_vertical.php"); ?> (includes the gallerylist as thumbs, txt-links or both)
<? readfile("design_elements/add.php"); ?> (use this if you want to organize your links, or leave it out)
<? readfile("design_elements/friends.php"); ?> (use this if you want to organize your links, or leave it out)
<? readfile("design_elements/more-friends.php"); ?> (use this if you want to organize your links, or leave it out)

Presentation:
text
Here is a spot reserved for "Welcome to my page" stuff. You can leave this section empty, if you want.

Posts:
format

%TITLE% (will be substituted with the title of the post, with permalink url to the single post)
%DATE% (will show the date of the post)
design_elements/post_thumbnails/%THUMB% (will show the image)
%LINK% (the url of the post)
%DESCRIPTION% (description of the post)
%CREDITLINK% (url to the site supporting the post)
%CREDITTEXT% (name of the the site supporting the post)

Example1. This is the initial format that comes with the BBBlog installation. the image size is 180x230.
----------------------------------------------------------------------------------------------------------
<table border="1" style="border-collapse:collapse; border:1px solid black;" align=center width="420" bordercolor="#000000" cellpadding="0" cellspacing="0">
<tr>
<td bgcolor="#E5E5E5">
<table width="100%" border="0" cellspacing="3" cellpadding="3">
<tr>
<td align="left" colspan="2"> <font size="+2">%TITLE% </font> (%DATE%)</td>
</tr>
<tr>
<td><a href="%LINK%" target="_blank"><img src="design_elements/post_thumbnails/%THUMB%" border="5"></a></td>
<td> %DESCRIPTION% </td>
</tr>
<tr>
<td colspan="2">
<div align="center">Thanks To <a href=%CREDITLINK% target="_blank"> %CREDITTEXT%</a></div>
</td>
</tr>
</table>
</td>
</tr>
</table>
<br>
<br>
----------------------------------------------------------------------------------------------------------

Example2 with a framed image. the image size is 420x310. Change the frame-image "purple_frame.gif" to suit your design!
----------------------------------------------------------------------------------------------------------
<div align="center"><table width="432" border="0">
<tr>
<td>
<div align="center"><font size="+2">%TITLE%</font></div>
</td>
</tr>
<tr>
<td>
<table style="background-image: url(design_elements/post_thumbnails/%THUMB%); background-repeat: no-repeat;
background-position: 50% 40%;" width="432" border="0" cellspacing="0" cellpadding="0">
<tr>
<td><a href="%LINK%" target="_blank"><img src="design_elements/images/purple_frame.gif" width="432" height="322" border="0" alt=""></a></td>
</tr>
</table>
</tr>
<tr>
<td> %DESCRIPTION%
</tr>
<tr>
<td><img src="design_elements/images/purple_frame_buttum.gif"> Thanks To <a href=%CREDITLINK% target="_blank"> %CREDITTEXT%</a> <img src="design_elements/images/purple_frame_buttum.gif"></td>
</tr>
</table><br><br></div>
----------------------------------------------------------------------------------------------------------

Galleries:
Top + Bottom + Left + Right
Fill in the desired html. Semilar to the mainpage above.

Adds for image show:
Fill in some adds, if you want that to show up above the images in the image show page. This is shown when you click an image in the gallery.

Webmasters:
Insert the content for your webmaster page "webmasters.php"

Surfers:
Insert the content for your contact page "surfers.php"

The changes in the Templates Menu will not be saved before you hit "Update" at the bottom of the page!



"STYLES" menu:
BBBlog comes with some initial css styles. These styles are setup so they are WC3 compatible. Some of the code takes care of the possibility to place a site image at the far left and right of the screen, as well as frame parameters for the images. It is also tested and proved valid in the most common browsers. It's adviceable to leave the styles almost intact, and adjust colors and stuff as needed. You can of course change that to whatever suits you, -but be carefull!

mainpage:
classes are:
body (covers the body section in general)
a: (links in the body section)
#bkgnd2 and #main (this stuf covers the whole body section, and is used for the gif at the right of the screen. If you want to keep this image, dont touch this section, except if you want to change the image)
.mainpresent_style (covers the presentation section)
.post_style (covers the post section)
.main_left_style (covers the left section)
.main_right_style (covers the right section)

galleries, gallery page and image show page
classes are:
body (covers the body section in general)
a: (links in the body section)
#bkgnd2 and #main (this stuf covers the whole body section, and is used for the gif at the right of the screen. If you want to keep this image, dont touch this section, except if you want to change the image)
.gallery_style (covers the mid section of the galleries)
.gallerylist_style (covers the mid section of galleries.php, -the gallery page)
.show_style (covers the body section of the image show page)

The changes in the Styles Menu will not be saved before you hit "Update" at the bottom of the page!



"SETTINGS" menu:

Setup:
Install folder:
leave this field empty if you install the script in the root directory. Write a slash (/) followed by the folder name, If you install in a subfolder. I.e if your subfolder is called "potato", then write "/potato" in the field.

DB Username:
Write your MYSQL database username.

DB Password:
Write your MYSQL database password.

DB Name:
Write your database name

DB Host:
Write your database host name (usualy "localhost")

Create Database Tables:
Click the link to set up the tables needed for BBBlog to work.

Create htaccess /htpasswd:
You want to protect your admin area. Follow the link and fill out the username and password field. Please remember your user/pass or write it down and keep in a safe place. After you have pushed "Encrypt and save" you will be promted for user/pass before you can go on with your work.
If you want a new user/pass at a later time, just repete the process.

Site Info:
Name of your site:
Write your site name here. It will show up on the proper places around the script.

Main page title:
Write your site title here. It will become the title on your main page

Trade Settings:
Include code for main:
This is the place to include the code for tracking the incoming hits for a tradescript. Per default this is set to "dummy.php" - an empty file, that is needed if you are using BBBlog without a tradescript.
If you use Arrow trader, write "trade-include.php" in this field. Edit that file to the proper include code, in case you use another tradescript.

Include code for galleries: (and gallerypage):
Same as above, except this is tracking the hits to the galleries.

Head Section:
<head> for main:
In this fiels you can add meta tags, javascript and stuff that usually fits into the head-section.

<head> for galleries:
same as above...

Settings for galleries:
Preview Thumb:
Deside the dimension of your gallery preview thumb here, and fill out this field

Thumb max-size:
Decide the max size (height or weidth) of the thumbs in the galleries, and fill out this field, The thumbs in the galleries will be cropped proportional to the original.

Big Image max:
Concider the max byte size of the full images (uploaded in the "Upload Pics" menu). This is just to make sure that you dont accidenly upload images, that takes too much load. Per default this is set to 100kb, but you can of course choose whatever you want. Write the number in bytes please!

Imageupload User:
Write the username that you want for the "Upload Pics" menu

Imageupload Pass:
Write the password that you want for the "Upload Pics" menu

Number of vertical thumb galleries to show:
This will control how many thumb galleries that are shown, when you make use of this inclusion:
<? readfile("design_elements/show_gall_vertical.php"); ?> ( usefull for left and right section).

Number of vertical text galleries to show:
This will control how many text galleries that are shown, when you make use of this inclusion:
<? readfile("design_elements/show_gall_vertical.php"); ?> ( usefull for left and right section).

Number of horizontal thumb galleries to show:
This will control how many thumb galleries that are shown, when you make use of this inclusion:
<? readfile("design_elements/show_gall_horisontal.php"); ?> ( not really usefull for left and right section).
Furthermore it controls how many galleriesshown per row in galleries.php, the gallery page.

Posts:
Number of posts:
Decide how many posts you want displayed on each page, and write the number here.



"HELP" menu:
You are reading the help files from the "help" menu right now. Open the link in a new window, so you can work at the same time.