Tutorial: Installing D-shoutbox For Ipb V1.2 Making your installation even easier

[elevenmil 0]

Over the course of the summer I have tried hard to install a shoutbox into a new forum I was developing. I went to the Invisionalize forums and found several mods for shoutboxes, but none of them seemed to work. I first tried to install the D-Shoutbox, but upon this first try, I was unsuccessful. Eventually, after much frustration, and trying other mods, which didn't seem to stack up to Dean's features, I was determined to make it work. For some, editing your files (to the newbie that is) can be difficult, with everything looking like a foreign language (basically it is).

 

So I dedicate my time to fellow members of Xisto who want a shoutbox for their Invision Power Board. I want to make it easy for you, the newbie, to install and run your very own shoutbox. I hope you will find this easier than reading the actual D-Shoutbox instrucitons.

 

Here is a link to my forum with the shoutbox installed if you would like a demo

http://forums.xisto.com/no_longer_exists/

-----------------------------

 

Let's start the process.

 

1. First off, if you would like to install a shoutbox into your forum, you must go to the invisionalize forums and register. GO TO THE FORUMS AND REGISTER FIRST!

 

http://forums.invisionize.com/index.php

 

2. After registering, it will say you must wait until receiving the confirmation email, but that is not true, go ahead and log in (you must log in in order to download the D-Shoutbox package).

 

3. After doing this, click on the below link to take you to the D-Shoutbox mod.

 

http://mods.invisionize.com/db/index.php/f/1287

 

4. At the bottom of the page, click on "download", then on the next page, agree to the terms. At this time, the download notification should pop up. Click on save to save the compressed folder.

 

5. After the download, the D-Shoutbox folder should pop up. You will want to extract all files, so extract them to a place of your choosing.

 

6. After doing this, you will want to open the D-Shoutbox folder. Inside, you will see many additional folders, such as "html, style_images, sources, lang, Skin, and SQL Queries". For the newbie such as I once was, you should know that these are folders located in the name of your IPB (Invision Power Board) directory (in file manager(inside www folder)).

Important: For all folders and files you will involve, change, and upload, you will need to change your permissions to "777". To do this simply click on the folder or file, and on the right hand screen you will see "Change Permissions". Click on that to change them.

 

7. First lets take care of the "html" folder. In your file manager, in your IPB folder, click to access the contents of the html folder. Create a new folder "shoutbox" and change permissions to 777. Now click to go inside this new folder. Now create folders from the number 1 through the number 12. After doing so, click inside folder "1", then click on "upload file(s)". From there, browse to your downloaded D-Shoutbox folder, click on html, then shoutbox, then 1, and upload all of the images. (For some reason, I thought I didn't have to upload all of these images from folders 1 through 12, but the shoutbox wouldn't work when I didn't, so to be safe, go ahead and do it). After uploading these images, go to folder "2", and go ahead and proceed to upload all of the images located within folders 1-12. You don't have to change permissions for the images.

 

You are now done with uploading with the "html" folder.

 

8. Lets take care of the "lang" folder. Click to access its contents, you will see the "en" folder. Click to see its contents, and click to upload files. Browse your downloaded folders to find the "lang_shoutbox" file and upload it.

 

You are now done uploading files under the "lang" folder.

 

9. Next is the "Skin" folder. Click to access its files and folders, then click on "s1". Inside, click to upload files and browse to find the two files "skin_shoutbox" and "skin_shoutbox2". Proceed to upload.

 

You are now done uploading files under the "Skin" folder.

 

10. Now lets access the "sources" folder. Inside you will need to see these three folders - "Admin" "Shoutbox" and "storeitems". If you do not see these folders you need to create them and type them exactly as punctuated. After this, go inside your "Admin" folder. Proceed to upload the file "ad_Shoutbox". Now go back and click to get inside your "Shoutbox" folder and proceed to upload the five files located under the same folder of your downloaded folder. Now go back to "storeitems", click to access inside and create the folder "dshoutbox". After creation go inside the folder and upload the 9 files you should see under the same folder of your downloaded folder.

 

You are now done uploading files under the "sources" folder.

 

11. Now go to "style_images" folder, and click to access its contents. You will see the "1" folder, click inside to access and upload the files you will see under the same folder of your downloaded folder.

 

You are finished uploading into the "style_images" folder.

 

Now go back to your main set of folders (where you will also see "sources, style_images, Skin", etc...). Create the folder "SQL Queries", click to access its contents and upload "Install SQL".

 

You are now finsished with the "SQL Queries" folder.

 

12. Only a few more things to upload. Now, under your main set of folders, go to upload, and upload the following files you downloaded - "dinstall" and "sb_iframe". Now only one more file to upload. Go back to you "www" folder and upload the following file "sb_web"

 

*Check point* Now this may be easier if you have an FTP client, but if you don't like me then this has taken a period of time to do. Take a breath there fella, relax for a second. But, make sure everything you have clicked and uploaded has had its permissions changed to "777". This is important. Also change your IPB folder's permissions to "777". Now you are ready for the installation. This is where I will try to make it as easy as possible for you.

 

1. Open up the "read me" file in the D-Shoutbox folder you downloaded. This is our reference.

 

2. Go to your IPB main folder, click on "dinstall.php", and on the right hand side a the bottom click on the option of opening it in a browser. In the opened browser, click on install button, and afterwards, delete it out of your directory.

 

3. Now, back in the D-Shoutbox read me file, click to do the edits for index.php. To be safe, go ahead and change permissions to 777 for all of the files you will be editing.

 

It will tell you to look for the following, but when inside index.php you will not see this.

 

//--------------------------------//  Expire subscription?//--------------------------------

Instead, look for the following located a little more than 2/3 the way down the file.

 

//--------------------------------// Decide what to do//--------------------------------

Above this, go ahead and copy and paste the code...

 

//--------------------------------// D-Shoutbox Functions//--------------------------------require ROOT_PATH."sources/Shoutbox/sbfuncs.php";$sbfunc = new SBFUNC;$DB->query("SELECT * FROM trap17_ipbshoutbox_settings");$shoutbox = $DB->fetch_row();$ibforums->sbcolors = $sbfunc->get_sbcolors();$ibforums->dshoutbox_glink = $sbfunc->get_glink();$ibforums->globalshouts = $sbfunc->global_shouts();

Next you will need to find the following code.

 

'modcp'    => 'mod_cp',

You can find this code relatively close to the previous code in the first step, it is basically right below it.

 

Insert the following below the code.

'Shoutbox' => 'Shoutbox/Shoutbox','sbextras' => 'Shoutbox/Extras',

Save the file and move on to admin.php editing.

 

4. In admin.php, the code you need to find is almost at the very bottom of the file. Go ahead and find

'mysql'     => 'mysql',

and paste below that...

 

'Shoutbox'  => 'Shoutbox',

Save the file and move on to editing sources/functions.php.

 

5. After opening the file, the code you will need to find is a little before 2/3 of the way down. You can find it relatively after

//---------------------------------------        // Get the template        //---------------------------------------

After finding

 $ibforums->skin['template'] = str_replace( "<% NAVIGATION %>"     , $nav                     , $ibforums->skin['template']);

you will want to add this below

$sb = $DB->query("SELECT * FROM trap17_ipbshoutbox_settings");	$shoutbox = $DB->fetch_row($sb);	if ($shoutbox['showglobal'] == 1)	{   $ibforums->skin['template'] = str_replace( "<% DSHOUTBOX %>"    , $skin_universal->dshoutbox() , $ibforums->skin['template']);        }

Next find

m.joined, m.last_post,

It is located about 7/8 of the way down. Copy and paste this after the previous code

m.use_dshoutbox, m.dshouts, m.dshouts_alltime, m.dshoutbox_mod, m.dshout_limit, m.dshouts_today, m.last_shout_time, m.sb_shoutboxtype, m.sb_showavatars, m.sb_showshouttime, m.sb_defaultcolor , m.sb_refresh, m.sb_sbcardstyle, m.sb_sbcard_value , m.sb_showsmiliest , m.sb_showtdshouters, m.sb_showtpshouters,

Save the file and move on to editing sources/Usercp.php.

 

6. This one should be easy to do, not hard to find what you need to look for. Scroll down not to far from the very top and you should see the code you need to find.

     //------------------------------      case '28':      	$this->pass_change();      	break;      case '29':      	$this->do_pass_change();      	break;

Go ahead and proceed with the instructions, adding the following below

     case '40':      	$this->shoutbox_settings();      	break;      case '41':      	$this->do_shoutbox_settings();      	break;      //------------------------------

After this, scroll all the way to the bottom, all the way, and paste above

}?>

the following code shown in the instructions (extremely large code, I won't paste it here, but you should know what the code is to paste).

 

Go ahead and save the file and move on to editing sources/Admin/admin_pages.php.

 

7. This step is also fairly easy. Simply scroll all the way to the bottom, you will immediately see the code you are told to find. Copy and paste the code instructed above the ?> and save the file.

 

8. Open up sources/lib/usercp_functions.php. This is another easy edit. Simply scroll all the way to the bottom and paste the large instructed code above

}?>

Go ahead and save the file and move on to editing lang/en/lang_error.php

 

9. Very easy one again. At the very beginning of the file, you'll easily find the code

<?php$lang = array (

Go ahead and paste the instructed code below.

 

Save the file and move on to editing lang/en/lang_online.php.

 

10. This is not a large file, so you should have no trouble finding the code. Follow the instructions, find the code, and place below the added code.

 

Save the file and move on to editing lang/en/lang_ucp.php.

 

11. This is easy as well. At the very top you'll see the code you are looking for. Follow the instructions placing the new code below the code you were told to find.

 

Save the file and go to edit skin/s1/skin_global.php.

 

12. The first step is easy, the code to find is once again at the top of the page. Copy and paste the new code below the code you were told to find.

 

The second code you are to find is located just about 1/2 way down the file. Find the code

    <img src="{$ibforums->vars['img_url']}/atb_calendar.gif" border="0" alt="" /> <a href='{$ibforums->base_url}act=calendar'>{$ibforums->lang['tb_calendar']}</a>

and simply place

{$ibforums->dshoutbox_glink}

below that.

 

Save the file and proceed to edit skin/s1/skin_ucp.php.

 

13. The first code you will need to find in this large file is between 1/2 way down and 2/3 way down the file. If you can come across the code

<!--TABLE TO FIX IE/6 ISSUEThe one where 23% margin + 100% table = 123% in IE6 o_O-->

then a few lines below that you should find what you are looking for. So go ahead and find

 · <a href='{$base_url}act=UserCP&CODE=04'>{$ibforums->lang['m_board_opt']}</a><br />

and place below the following.

 · <a href='{$base_url}act=UserCP&CODE=40'>{$ibforums->lang['m_sbox_opt']}</a><br />

The second code you need to find is easily found at the very bottom of the file. Simply copy and paste the added code above the

}?>

Go ahead and save the file.

 

*NOTE* If you have more than one skin already, you will need to do steps 12 and 13 for every other skin you have (such as if you have a folder s2, s3, etc...).

 

Wow, time for the breather. Get a drink, stretch, whatever, you the newbie is about to see your new shoutbox. Go to your forum, log in and access your admin CP. Go to the board wrappers section under skins and templates, select the skin to edit and find the

<% NAVIGATION %>

Place

<% DSHOUTBOX %>

below that. Do this for every skin.

 

Boom, it's over. Go to your forums homepage and see if your shoutbox is there. You can change your shoutbox settings in you admin cp if you want to, it is found at the bottom of your admin cp controls.

 

- Common errors -

 

If you have errors, then one of the following may have happened.

1. You did not change your permissions to 777 for everything you edited, created, or uploaded.

2. The database may not have been automatically updated.

 

If your database was not updated, simple go to your main control panel, click on phpMyAdmin, select the database your forum runs on, and run the following quiery.

 

DROP TABLE IF EXISTS trap17_ipbshoutbox;DROP TABLE IF EXISTS trap17_ipbshoutbox_badwords;DROP TABLE IF EXISTS trap17_ipbshoutbox_colors;DROP TABLE IF EXISTS trap17_ipbshoutbox_settings;DROP TABLE IF EXISTS trap17_ipbshoutbox_stats;CREATE TABLE trap17_ipbshoutbox (  id int(11) NOT NULL auto_increment,  name text NOT NULL,  uid int(11) NOT NULL,  message longtext NOT NULL,  time text NOT NULL,  time_time int not null default '0',  color varchar(25) not null,  PRIMARY KEY  (id));CREATE TABLE trap17_ipbshoutbox_badwords (  id int(11) NOT NULL auto_increment,  bword varchar(255) NOT NULL default '',  switch varchar(255) default NULL,  exact tinyint(1) NOT NULL default '0',  PRIMARY KEY  (id));CREATE TABLE trap17_ipbshoutbox_colors (  id int(11) NOT NULL auto_increment,  color varchar(255) NOT NULL,  PRIMARY KEY  (id));CREATE TABLE trap17_ipbshoutbox_settings (  online tinyint(1) NOT NULL default '1',  sbname varchar(255) NOT NULL default 'D-Shoutbox',  postspp int(11) NOT NULL default '10',  flood int(11) NOT NULL default '10',  flood_seconds int(11) NOT NULL default '30',  guestviewsb tinyint(1) NOT NULL default '1',  guestposting tinyint(1) NOT NULL default '0',  minimum_refresh int(11) default '30',  refresh int(11) NOT NULL default '30',  banner tinyint(1) default '0',  bannerurl varchar(255) default NULL,  autodelete tinyint(1) default '0',  addays smallint(3) default '0',  showava tinyint(1) NOT NULL default '1',  showglobal tinyint(1) NOT NULL default '1',  showou tinyint(1) NOT NULL default '1',  showrules tinyint(1) NOT NULL default '1',  showtods tinyint(1) NOT NULL default '1',  todsnum int(11) default '10',  showtops tinyint(1) NOT NULL default '1',  topsnum int(11) default '10',  smiliestable tinyint(1) NOT NULL default '1',  iframe tinyint(1) NOT NULL default '1',  iframeh mediumint(5) NOT NULL default '370',  iframew mediumint(5) NOT NULL default '100',  noavatar_name varchar(255) NOT NULL default '',  avatar_dims varchar(255) NOT NULL default '80x80',  allowsmilies tinyint(1) NOT NULL default '1',  allowbbcodes tinyint(1) NOT NULL default '1',  usestorep tinyint(1) default NULL,  useshopp tinyint(1) default NULL,  usesbcard tinyint(1) default NULL,  chargeperpost int(11) default NULL,  shoppoints int(11) default NULL,  storepoints int(11) default NULL,  website_extra text,  error_msg_1 text NOT NULL,  error_msg_2 text NOT NULL,  error_msg_3 text NOT NULL,  error_msg_4 text NOT NULL,  error_msg_5 text NOT NULL,  error_msg_6 text NOT NULL,  error_msg_7 text NOT NULL,  error_msg_8 text NOT NULL,  error_msg_9 text NOT NULL,  gsnum int(11) NOT NULL default '5',  wordwrap int(11) NOT NULL default '0',  gseffect int(2) NOT NULL default '0',  skin_selection char(3) NOT NULL default 'new',  sbdisplay char(1) NOT NULL default 'L',  global_rlb tinyint(1) NOT NULL default '0');CREATE TABLE trap17_ipbshoutbox_stats (  totalshouts int(11) NOT NULL default '0',  shouts_alltime int(11) NOT NULL default '0');INSERT INTO trap17_ipbshoutbox VALUES ('1', 'Dean (D-Scripting)', '0', 'Hello,<br>Thanks for installing D-Shoutbox 5.7! This is just a post by me to show that your new D-Shoutbox is working. You may keep this shout here or delete it.<br>Thanks again for installing D-Shoutbox 5.7', '', '', 'black');INSERT INTO trap17_ipbshoutbox_colors VALUES ('1', 'black');INSERT INTO trap17_ipbshoutbox_colors VALUES ('2', 'blue');INSERT INTO trap17_ipbshoutbox_colors VALUES ('3', 'red');INSERT INTO trap17_ipbshoutbox_colors VALUES ('4', 'green');INSERT INTO trap17_ipbshoutbox_colors VALUES ('5', 'yellow');INSERT INTO trap17_ipbshoutbox_stats VALUES ('1', '1');INSERT INTO trap17_ipbshoutbox_settings VALUES (1, 'D-Shoutbox', 10, 10, 30, 1, 0, 30, 30, 0, '', 0, 0, 1, 1, 1, 1, 1, 10, 1, 10, 1, 1, 370, 100, '', '80x80', 1, 1, 0, 0, 0, 0, 0, 0, '', 'Sorry, guests cant view the shoutbox!', 'The shoutbox is currently offline!', 'You are not allowed to view the shoutbox!', 'You must be a shoutbox moderator to use this feature!', 'You are not allowed to post to the shoutbox!', 'Guests are not allowed to post to the shoutbox!', 'You have been banned from the shoutbox!', 'You can't delete the shout because it is not yours!', 'You have reached your daily shout limit for the day!',5, 30, 1, 'new', 'L', 1);ALTER TABLE trap17_ipbgroupsADD g_view_dshoutbox tinyint(1) DEFAULT '1',ADD g_post_dshoutbox tinyint(1) DEFAULT '1',ADD g_dshoutbox_mod tinyint(1) DEFAULT '0',ADD g_dshout_limit varchar(200) DEFAULT '0',ADD g_dshouts_today varchar(200) NOT NULL;ALTER TABLE trap17_ipbmembersADD use_dshoutbox tinyint(1) DEFAULT '1',ADD dshouts mediumint(5) NOT NULL DEFAULT '0',ADD dshouts_alltime int(11) NOT NULL,ADD dshoutbox_mod tinyint(1) default '0',ADD dshout_limit varchar(200) default '0',ADD dshouts_today varchar(200) NOT NULL,ADD last_shout_time int(11) NOT NULL,ADD sb_shoutboxtype tinyint(1) default '0',ADD sb_showavatars tinyint(1) default '1',ADD sb_showshouttime tinyint(1) default '1',ADD sb_defaultcolor varchar(15) NOT NULL,ADD sb_refresh int(3) NOT NULL default '0',ADD sb_sbcardstyle int(2) default '1',ADD sb_sbcard_value int(11) NOT NULL default '100',ADD sb_showsmiliest tinyint(1) default '1',ADD sb_showtdshouters tinyint(1) default '1',ADD sb_showtpshouters tinyint(1) default '1';INSERT INTO trap17_ipbcache_store (cs_key, cs_value) VALUES ('sbrules', '<b><u><center>D-Shoutbox Rules!</center></u></b>\n<br />Below are listed the main rules of the D-Shoutbox.  We can\'t list out every minor detail because it would take forever!\n<br /><ul>\n<br /><li>Be kind to others using the D-Shoutbox\n<br /><li>Do <u>NOT</u> cuss or use bad language\n<br /><li>Respect everyone and treat the forums with care for since it took a good amount of time to create\n<br /><li>Be active and have fun!\n<br /></ul>\n<br />Those are just the main features.\n<br />Remember to abide by these so you dont get banned!');

If this still doesn't work, let me know and I will see what I can do. The support forum for this mod over on the invision forums basically no longer gives support, so if anything goes wrong let me know and I'll be sure to do my best to help you.

 

I hope this makes it easier for all of the newbies out there. It seemed like a overwhelming task to me at first, but with some patience, it turns out it wasn't that hard. Good luck to everyone out there who uses this to install their new shoutbox, and I hope to hear good results.

 

- elevenmil

[Saint_Michael 3]

interesting tutorial it should help those starting out in the forum making to install a shoutbox for quicker communication.

[TripleH13 0]

thanks man your the best i was just trying to do this. it never installed to so hopefull i will understand this and get my shoutbox set up thanks again

[chiclete 0]

I'm not sure if I'm for or against this tutorial.Everyone who has already installed IPB and extensions knows that those addons come with tutorials just like yours and if you follow you can install it very easy... But... every tutorial is welcome, so... Thanks!

[elevenmil 0]

Yes, the mods have their own installation instructions, that is mentioned in the tutorial...to use the D-Shoutbox instructions as a reference...This tutorial is aimed at the newbie, it breaks down the instructions and gives you a better idea of where to find the codes. Also, it is important to note that when editing the index.php file you won't find the code it tells you to look for, so this fixes up that little problem too.

[baffo 0]

I am a newbie and I have encountered an error when I finished the installation and editing.

 

When I want to access my website it shows an mysql eror like this:

There appears to be an error with the Da' Strikers database.

You can try to refresh the page by clicking here, if this does not fix the error, you can contact the board administrator by clicking here

 

Error returned:

 

mySQL query error: SELECT moderator.mid as is_mod, moderator.allow_warn, m.id, m.name, m.mgroup, m.password, m.email, m.restrict_post, m.view_sigs, m.view_avs, m.view_pop, m.view_img, m.auto_track,

                              m.mod_posts, m.language, m.skin, m.new_msg, m.show_popup, m.msg_total, m.time_offset, m.posts, m.joined, m.last_post, m.use_dshoutbox, m.dshouts, m.dshouts_alltime, m.dshoutbox_mod, m.dshout_limit, m.dshouts_today, m.last_shout_time, m.sb_shoutboxtype, m.sb_showavatars, m.sb_showshouttime, m.sb_defaultcolor , m.sb_refresh, m.sb_sbcardstyle, m.sb_sbcard_value , m.sb_showsmiliest , m.sb_showtdshouters, m.sb_showtpshouters,

                  m.last_visit, m.last_activity, m.dst_in_use, m.view_prefs, m.org_perm_id, m.temp_ban, g.*

                  FROM trap17_ipbmembers m

                    LEFT JOIN trap17_ipbgroups g ON (g.g_id=m.mgroup)

                    LEFT JOIN trap17_ipbmoderators moderator ON (moderator.member_id=m.id OR moderator.group_id=m.mgroup )

                  WHERE m.id=1

 

mySQL error: Unknown column 'm.use_dshoutbox' in 'field list'

mySQL error code:

Date: Sunday 18th of September 2005 09:51:17 AM

 

on my adminCP all works perfectly, also the Dshotbox menu appears and most of its functions works except the main page on it.

 

DO you have some suggestions?

[leiaah 0]

What a timely tutorial! Thanks very much I NEED this!

[elevenmil 0]

Just wanted to update this thread as TripleH's problem has been solved, although he is pretty much inactive anymore, and baffo's problem as well has been solved. If you have any questions at all be sure to ask me. I am also proposing to you a pay installation option as from installing this for others who have now become inactive I don't want to waste my time in the future. I will install your shoutbox for you for 10 credits hassle free, satisfaction guaranteed . If you've installed it but have general questions, I still may do it for free . Feel free to PM me here or at IPBGaming.com.

[InsaneXterminator 0]

hey. sorry for a very noobish question, but where do i find the folders like html, etc etc...are they at the host i have used for my forum?

[jlhaslip 4]

yes they are at your Hosting account inside the public_html or www folder.

[InsaneXterminator 0]

i couldnt find either of the two folders there, so i made a folder called www and uploaded all files there. will that work?
also, wen i try to run dinstall.php, it gives me this error::

Warning: require(./conf_global.php) [function.require]: failed to open stream: No such file or directory in /www/110mb.com/g/a/m/e/r/z/-/u/gamerz-united/htdocs/dinstall.php on line 68

please help me with this.
thanks!

[iGuest 3]

Invision Free or Invision Power Board

Tutorial: Installing D-shoutbox For Ipb V1.2

 

Is the D-shoutbox only for the Invision Power Boards or for Invision Free forums which are hosted free by IF?

 

Although there is a "File Manager" in the AdminCP of IF, it seems to be lacking a lot.

 

-reply by mree

[AngelArvil 0]

hi! I'm new here...Is it the same with installing in to vBulletin?And I also want my shoutbox in my forum to be view in my main site.. is it possible?Thanks in advance