************************
blogKomm 1.4 (04/13/02) 
************************

thankyou for using blogKomm. blogKomm is freeware. You are allowed to change the code! Please leave the copyright remark.
... if you have an idea please do not hesitate to tell me. i would appreciate it very much.

Please place a permanent link on your site to: http://www.blogkomm.com
thankyou. Holger

e-mail: holger@blogkomm.com 
   icq: 34471165
   







************************************************************************
howto make it run
************************************************************************

::::   1st step: downloading   ::::


in the downloaded folder you have the files:


blogkomm/comments.txt
blogkomm/module/blogkomm_show_link.php
blogkomm/module/do_comments.php



also you will have the files


blogkomm/admin/config.php
blogkomm/admin/index.php
blogkomm/admin/show.php
blogkomm/admin/edit.php

and one folder:

blogkomm/admin/images/..






::::    2nd step: uploading   :::: 

your server supports PHP4? good.

imagine you have a weblog at "http://my-domain.com/blog.php". so you take your ftp-client and upload the whole folder
into your blog-root-directory.

so you will have "http://my-domain.com/blogkomm/"

the filesettings should be:

blogkomm/module/blogkomm_show_link.php chmod 755 (rwxr-xr-x)
blogkomm/module/do_comments.php chmod 755 (rwxr-xr-x)
blogkomm/comments.txt chmod 666 (rwrw-rw-)




and the files of the admin tool.

blogkomm/admin/config.php chmod 700 (rwx----)
blogkomm/admin/index.php  chmod 755 (rwxr-xr-x)
blogkomm/admin/show.php   chmod 755 (rwxr-xr-x)
blogkomm/admin/edit.php   chmod 755 (rwxr-xr-x)


the directories should be set to chmod 777 (rwxrwxrwx)




::::    3rd step: modify you blogger-template   ::::


login to blogger.com, go on "template" and look for the <blogger>-part. 
there you enter the lines of the following code:




<Blogger>
<BlogDateHeader>
ΚΚΚ <h4><$BlogDateHeaderDate$></h4>
</BlogDateHeader>
<$BlogItemBody$><br>
<small>posted by <$BlogItemAuthor$> on <$BlogItemDateTime$></small>


<center>


<?

$blog_id=<$BlogItemNumber$>; 
$blog_mail="<$BlogItemAuthorEmail$>";
$file_name=$PHP_SELF; 

include ("blogkomm/module/blogkomm_show_link.php");

?> 

</center>


</Blogger>





finally you have to rename your blog-file to "blog.php" if the suffix is still ".html". 


thats it!

!!!!!! Archive-pages note:
       to make blogkomm working with your archiv pages make sure that they are in the same directory as your blog-file
       +
       If you want to keep your old CommentSystem, dont republish the archiv pages ... 



************************************************************************
howto modify some functions
************************************************************************


you can easily change some settings within "blogkomm_show_link.php".
check out for the first few lines you will find this peace of code:



// you can change these variables, change the value but keep away from the ";"

$html=0;             // allow (1) or disallow hmtl (0)
$mail_valid=0;       // user has to enter an e-mail (1) or doesn't (0)
$notify=1;           // you will get an e-mail notification (1) or don't (0)
$timeDiff= (-0);     // here you can set the time difference between your server and your "real" location (-x) or (+x)
$timeForm="12";      // set it to 24 if you want the time to be displayed like 13:14
$targetWin="_blank"; // to be set for the homepage link [H] in the comments
$user_mem=1;         // if you want to remember your user set it to "1" but make sure you got the additional
                     // code in your blog-template for firther instructions see your readme-file  or howto on blogkomm.com






::::    html- allowed or html-disallowed   :::: 

some people may want to allow users to write html-code into the comments-section.
in blogkomm its disallowed by default. 




::::    e-mail validation on/off and notification on/off   ::::

so here you can change the values of some variables from 0 to 1 and the other way round ... 
concerning e-mail notification if someone comments on a post and e-mail adress validation 




::::    time-zones    ::::

the var $timeDiff is about when your webhost is in a different timezone than you are. 
like in the blogger settings you change the setting in there from (+0) to (-2) or (+12) or whatever.




::::    target for hrefs ::::

the var $targetWin is for users who operate their blog in a popUp or within a frameset 





::::    user remember cookies   ::::

blogs who got most of the time the same people commenting might offer a user remember-function.
if this var is set to "one" a little checkbox is displayed. if your visitor comments and revisits your site 
within two weeks, his name, e-mail and website will be saved ina cookie on his computer 
to make it a more easy, and faster to give you credits and comments ...
well you know this fuction from many websites like "blogger.com" itself.

to make that work you have to add the following lines to your template into the very first line, before the <html> and <head> tags:



<? if (isset($rem)) {

setcookie ("blogKo_name", $comm_name,time()+1209600);
setcookie ("blogKo_mail", $comm_e_mail,time()+1209600);
setcookie ("blogKo_www", $comm_website,time()+1209600);

} 

if (!isset($submit)) {
$comm_name = $HTTP_COOKIE_VARS["blogKo_name"];
$comm_e_mail = $HTTP_COOKIE_VARS["blogKo_mail"];
$comm_website = $HTTP_COOKIE_VARS["blogKo_www"];
}

?>







************************************************************************
howto modify the look of it
************************************************************************

::::    the width of the comments area:   ::::


if you know html, it wont be a problem. open the file you included (see above). there you will find the following code:



/********* table to show the entries, modify html the way you want it ***********/ ?>

<br><br>


<table border="0" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td class="blogkomm_s"><? echo $entry;?></td>
</tr>
<tr>....


you can modify te table tag or whatever. you can even remove the table tag if you want to integrate the comments in an existing table.



::::    the font-size ... the font-face -- color and form-fields   ::::


the most easy way would be to add two css-classes to your blogger-template. if you add the following code to your blogger-template. 

<style type="text/css">
<!--
.blogkomm_s { font: 11px Arial, Helvetica, sans-serif}
.blogkomm_f { border: 1px solid}
.blogkomm_a { font: 11px Arial, Helvetica, sans-serif}
-->
</style>

you can change the look of the comments showing up (class="blogkomm_s") and the form-fields (class="blogkomm_f") and the links (class="blogkomm_a")




hope it works ... have fun ...