C o p y r i g h t      2 0 0 5   C o d e   S o c i e t y .   A l l   r i g h t s   r e s e r v e d . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 C h a t t e r B o x . N E T   R e a d m e 
 
 = = = = = = = = = = = = = = = = = = = = = 
 
 
 
 W i t h   C h a t t e r B o x . N E T ,   y o u   c a n   q u i c k l y   s e t   u p   a   s i m p l e   c h a t   a r e a   o n   a n y 
 
 e x i s t i n g   A S P . N E T   p a g e   o n   y o u r   w e b   s i t e .   C h a t t e r B o x . N E T   i s   a n   A S P . N E T 
 
 u s e r   c o n t r o l . 
 
 
 
 C h a t t e r B o x . N E T   r e q u i r e s   A S P . N E T   2 . 0   o r   h i g h e r   t o   r u n . 
 
 
 
 Y O U   M U S T   A C C E P T   T H E   F O L L O W I N G   L I C E N S E   T E R M S   T O   U S E   T H I S   S O F T W A R E 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 Y o u   a r e   a l l o w e d   t o   u s e   t h i s   s o f t w a r e   f o r   a n y   l e g a l   p u r p o s e . 
 
 Y o u   c a n   m o d i f y ,   b u t   n o t   d i s t r i b u t e   m o d i f i e d   v e r s i o n s   o f   t h i s 
 
         s o f t w a r e . 
 
 Y o u   c a n   d i s t r i b u t e   u n a l t e r e d   c o p i e s   o f   t h i s   s o f t w a r e . 
 
 Y o u   m a y   n o t   r e m o v e   c o p y r i g h t   o r   b r a n d i n g   n o t i c e s .   Y o u   c a n   c h a n g e 
 
         t h e   l o o k   t o   m a t c h   y o u r   s i t e ,   b u t   t h e y   m u s t   b e   v i s i b l e . 
 
 T h e   a u t h o r ( s )   o f   t h i s   s o f t w a r e   c a n n o t   b e   h e l d   r e s p o n s i b l e   f o r 
 
         a n y   d a m a g e s   t h a t   m a y   b e   c a u s e d   a s   a   r e s u l t   o f   u s i n g   t h i s 
 
         s o f t w a r e . 
 
 T h i s   s o f t w a r e   i s   d i s t r i b u t e d   " A S   I S "   w i t h o u t   A N Y   w a r r a n t i e s , 
 
         i m p l i e d   o r   o t h e r w i s e . 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 A s   l o n g   a s   y o u   f o l l o w   t h e   a b o v e   r u l e s ,   e n j o y ! 
 
 
 
 V e r i f y   t h a t   y o u   h a v e   t h e   f o l l o w i n g   f i l e s   b e f o r e   p r o c e e d i n g : 
 
 
 
 +   u p l o a d / C h a t t e r B o x . a s c x 
 
 +   u p l o a d / C h a t t e r B o x . a s c x . c s 
 
 +   u p l o a d / C h a t t e r B o x . c s s 
 
 +   u p l o a d / C h a t t e r B o x . x m l 
 
 +   u p l o a d / C h a t t e r B o x A r r o w D o w n . p n g 
 
 +   u p l o a d / C h a t t e r B o x A r r o w U p . p n g 
 
 +   u p l o a d / C h a t t e r B o x C o m m e n t B G . p n g 
 
 +   u p l o a d / C h a t t e r B o x N a m e B G . p n g 
 
 +   c h a n g e l o g . t x t 
 
 +   r e a d m e . t x t 
 
 
 
 T a b l e   o f   C o n t e n t s 
 
 = = = = = = = = = = = = = = = = = 
 
 
 
 I .   I n s t a l l a t i o n 
 
 I I .   C o n f i g u r a t i o n   O p t i o n s 
 
 
 
 I .   I n s t a l l a t i o n 
 
 - - - - - - - - - - - - - - - 
 
 
 
 F o l l o w   t h e s e   s t e p s   t o   i n s t a l l   C h a t t e r B o x . N E T . 
 
 
 
 1 .     U p l o a d   a l l   f i l e s   i n   t h e   " u p l o a d "   f o l d e r   t o   y o u r   w e b   s e r v e r   i n   a   f o l d e r   o f 
 
         y o u r   c h o i c e   ( h e r e b y   k n o w n   a s   C h a t t e r B o x D i r ) . 
 
       
 
 2 .     G i v e   W r i t e / M o d i f y   p e r m i s s i o n s   o n   t h e   f i l e   " C h a t t e r B o x . x m l " . 
 
 
 
 3 .     O p e n   t h e   f i l e   y o u   w a n t   C h a t t e r B o x . N E T   t o   b e   i n c l u d e d   i n   a n d   a d d   3   l i n e s : 
 
 
 
         < % @   R e g i s t e r   T a g P r e f i x = " C S "   T a g N a m e = " C h a t t e r B o x " 
 
                 S r c = " C h a t t e r B o x D i r / C h a t t e r B o x . a s c x "   % > 
 
         N e a r   t h e   t o p   o f   t h e   f i l e ,   n e a r   t h e   o t h e r   d i r e c t i v e s .   M a k e   s u r e   t o   r e p l a c e 
 
         C h a t t e r B o x D i r   w i t h   t h e   a c t u a l   r e l a t i v e   o r   a b s o l u t e   p a t h   t o   t h e   f i l e . 
 
 
 
         < l i n k   h r e f = " C h a t t e r B o x D i r / C h a t t e r B o x . c s s "   t y p e = " t e x t / c s s " 
 
                 r e l = " s t y l e s h e e t "   / > 
 
         I n   t h e   h e a d   t a g   i n   y o u r   h t m l .   M a k e   s u r e   t o   r e p l a c e 
 
         C h a t t e r B o x D i r   w i t h   t h e   a c t u a l   r e l a t i v e   o r   a b s o l u t e   p a t h   t o   t h e   f i l e . 
 
 
 
         < C S : C h a t t e r B o x   r u n a t = " s e r v e r "   / > 
 
         O n   t h e   p a g e   i n   t h e   e x a c t   s p o t   y o u   w a n t   C h a t t e r B o x . N E T   t o   a p p e a r . 
 
 
 
 4 .     C o n f i g u r e   C h a t t e r B o x . N E T   u s i n g   t h e   c o n f i g   o p t i o n s   l i s t e d   b e l o w . 
 
 
 
 5 .     L o a d   u p   y o u r   p a g e   a n d   e n j o y ! 
 
 
 
 I I .   C o n f i g u r a t i o n   O p t i o n s 
 
 - - - - - - - - - - - - - - - - - - - - - - - - - 
 
 
 
 C h a t t e r B o x . N E T   a l l o w s   y o u   t o   s e t   s o m e   o p t i o n s   t o   c u s t o m i z e   h o w   i t   w o r k s . 
 
 I n   t h e   < C S : C h a t t e r B o x >   t a g ,   y o u   c a n   a d d   t h e   f o l l o w i n g   p r o p e r t i e s : 
 
 
 
 +   D a t a F i l e   -   s e t s   t h e   d a t a   s o u r c e   t o   u s e .   P o s t e d   m e s s a g e s   a r e   r e a d   f r o m   a n d 
 
         s t o r e d   i n   t h i s   f i l e .   T h i s   c a n   b e   a b s o l u t e   o r   r e l a t i v e   f r o m   t h e   i n c l u d e d 
 
         p a g e ' s   p a t h . 
 
         D e f a u l t :   " C h a t t e r B o x . x m l " 
 
         
 
 +   M a x M e s s a g e s   -   s e t s   t h e   n u m b e r   o f   m e s s a g e s   t o   d i s p l a y   a t   a n y   o n e   t i m e . 
 
         D e f a u l t :   " 1 0 " 
 
 
 
 +   M a x A r c h i v e   -   s e t s   t h e   n u m b e r   o f   m e s s a g e s   t o   s t o r e   i n   t h e   a r c h i v e . 
 
         I f   m o r e   m e s s a g e s   t h a n   t h i s   a r e   p o s t e d ,   t h e   o l d e r   m e s s a g e s   a r e 
 
         d e l e t e d   a n d   c a n n o t   b e   r e t r i e v e d . 
 
         D e f a u l t :   " 5 0 " 
 
 	 
 
 +   P a s s w o r d   -   s e t s   t h e   p a s s w o r d   t o   u s e   f o r   p o s t   e d i t / d e l e t e   o p e r a t i o n s 
 
 	 
 
 +   F i l t e r e d W o r d s   -   a   c o m m a   s e p a r a t e d   l i s t   o f   w o r d s   t o   c e n s o r .   L e a d i n g 
 
         a n d   t r a i l i n g   w h i t e s p a c e   b e t w e e n   e n t r i e s   i s   t r i m m e d . 
 
         E x :   " b a d 1 , b a d 2 , b a d 3 "   o r   " b a d 1 ,   b a d 2 ,   b a d 3 " 
 
 
 
 +   F i l t e r S y m b o l   -   t h e   t e x t   t o   r e p l a c e   c e n s o r e d   w o r d s   w i t h 
 
         D e f a u l t :   " * " 
 
 	 
 
 +   F i l t e r R e p e a t   -   " t r u e "   o r   " f a l s e " .   D e t e r m i n e s   w h e t h e r   t o   r e p e a t   t h e 
 
         F i l t e r S y m b o l   a   n u m b e r   o f   t i m e s   e q u a l   t o   t h e   c e n s o r e d   w o r d   l e n g t h . 
 
         D e f a u l t :   " t r u e " 
 
 
 
 +   
 
         
 
 F o r   e x a m p l e ,   y o u   m i g h t   d o : 
 
 
 
 < C S : C h a t t e r B o x   r u n a t = " s e r v e r "   D a t a F i l e = " d a t D i r / C h a t t e r B o x . x m l " 
 
         M a x M e s s a g e s = " 2 0 "   / > 
 
         
 
 T o   c h a n g e   h o w   C h a t t e r B o x . N E T   l o o k s ,   s i m p l y   m o d i f y   " C h a t t e r B o x . a s c x " . 
 
 
 
 I I I .   U s a g e 
 
 - - - - - - - - - - 
 
 
 
 *   D e l e t i n g   P o s t s   -   T o   d e l e t e   a   p o s t ,   h o v e r   t h e   c u r s o r   o v e r   t h e   b o t t o m 
 
         p o r t i o n   o f   a n y   p o s t   ( n e a r   t h e   s m a l l   < >   s y m b o l ) .   T h i s   w i l l   t r i g g e r 
 
         t h e   p a s s w o r d   b o x   a n d   d e l e t e   b u t t o n .   E n t e r   t h e   p a s s w o r d   a n d   c l i c k 
 
         d e l e t e .   N o t e   t h a t   y o u   C A N N O T   d e l e t e   i f   t h e r e   i s   o n l y   o n e   p o s t   l e f t . 
 
         T h i s   i s   t o   e n s u r e   n e w   p o s t s   c a n   b e   m a d e   f r o m   t h e   e x i s t i n g   d a t a   s t r u c t u r e . 
 
 
 
 *   A r c h i v e   V i e w i n g   -   O n l y   M a x M e s s a g e s   p o s t s   a r e   d i s p l a y e d   a t   a n y   o n e   t i m e 
 
         o n   t h e   p a g e .   U s e r s   c a n   c l i c k   t h e   u p   o r   d o w n   a r r o w s   t o   m o v e   a c r o s s 
 
         p a g e s   o f   m e s s a g e s ,   e a c h   o f   w h i c h   c o n t a i n s   M a x M e s s a g e s   p o s t s . 
 
 
 
 N o t e :   T h i s   f e a t u r e   r e q u i r e s   s e s s i o n   s u p p o r t .   T h i s   m e a n s   t h a t   i f   u s e r s   d o 
 
 n o t   h a v e   c o o k i e s   e n a b l e d ,   i t   w i l l   n o t   w o r k   u n l e s s   c o o k i e l e s s   s e s s i o n s   a r e 
 
 e n a b l e d   i n   y o u r   w e b . c o n f i g ,   o r   t h e   s e s s i o n   I D   i s   o t h e r w i s e   p a s s e d   t h r o u g h 
 
 t h e   U R L . 
 
 