Go Back   vb.org Archive > vBulletin Article Depository > Read An Article > vBulletin 3 Articles
Reload this Page How To Install a vbulletin Hack: Guide to Newbies.
FAQ Community Calendar Today's Posts Search

Reply
Page 3 of 3 12 3
 
Thread Tools
How To Install a vbulletin Hack: Guide to Newbies.
Logician's Avatar
Logician
Join Date: Nov 2001
Posts: 4,449

MCSE, MCDBA, Coder

inside vb code
Show Printable Version Email this Page Subscription
Logician Logician is offline 05-27-2002, 10:00 PM
If you are new to vbulletin hacks, dont know how to apply a hack, instructions of the Author does not suffice to you or you still have difficulties and questions while applying a hack, I hope this "general guide" can help you a bit:

Let's begin with CRUCIAL tips, shall we?

BEFORE HACKING:

1- Before applying a hack do not forget to backup! This is the most important part of a hacking experience. If you backup properly, you dont need to worry about the consequences of applying any hack. Even if you do something wrong or the hack is buggy or conflicts with your board, you wont lose anything by trying it out. Doesnt it work? Just revert to your backed up board and you are safe.

You need to back up 2 things:
  • Your MYSQL database. You can back it up via Vbulletin Admin Control Panel/ Database Backup section. Even if you dont apply a hack, get used to back up your database once in a while. If anything goes wrong in your server, you can use your backup to get it up.
  • File You Edit: Always make a copy of the file the hack requires editing, before editing the original. If your hack does not work and if you want to revert to your old settings, just rename the copy you made (overwrite the modified file) and upload it back to your server. This is the best way of getting rid of an unsuccessful/unwanted/buggy hack.
2- In most of the hacks, the author will tell (or at least guess) which version of vbulletin the hack works with. In vbulletin.org vb version of the author is displayed in the hack's subject line too. It may seem crucial to you to NOT TO apply a hack if vbulletin version of the Author does not match yours but in MOST cases, this is NOT true. Most vbulletin versions (especially if they are close) are very similar to eachother and many hacks will work in many different vbulletin versions. I'm not talking here very different versions like 1.x.x and 2.x.x but, for instance it's VERY likely a hack written in v2.0.3 wil work with v2.2.2, v2.2.3, v2.2.5 etc. So how can you be sure?
  • Check the thread and see if author has mentioned about that or any user who applied the hack reported any problems with your vbulletin version or you just ask it away in the thread.
  • Hacks require editing of vbulletin files and they ask you to find some codes in these files to modify. Check if these codes exist (exactly) in your vbulletin version. If they do, this hack will work in your board with a chance of 99%.
  • Backup your files and apply the hack. What if it doesnt work, you can simply revert to your back up and you wont lose anything by trying, will you?
So dont be scared that version of the hack author's vbulletin is different than yours and take your chance if you really need/want that hack. Of course this tip does not apply to the hacks in which author specifically mentioned that hack DOES NOT work with version X or the code that requires modification does not exist in your file.

WHILE HACKING

1- Follow the hack author's instructions carefully. When it comes to coding, it REALLY matters if you miss or add an extra "dot" or even single "space" character. Therefore it's important to apply the hack verbatim, very carefully and without rush.

2- If the hack instruction asks you to edit a vbulletin file, use a TEXT EDITOR program to edit. Old "Notepad" will be your best friend when it comes to hacking. Do NOT use HTML programs such as Frontpage, DreamWeaver or Word Processing Programs such as MS Word, StarOffice to edit your files. If you know what to do, these programs can manage hack editing too, but if the settings of the programs are not properly configured, they can make unwanted modifications in the file you edit which results in errors (usually parse errors). However you will ALWAYS be safe with your Notepad, so try to use it whenever possible while applying the hacks.

3- If the author asked you to find a line in the code, use "Find" feature of your editor (You are using NotePad, dont you?) So you dont need to go through the entire text manually.

4- If you find the part which requires editing via "FIND", do not immediately apply the hack. Click [F3] (In NotePad) to extend your search and make sure there is only 1 occurence of the searched text in the file you edit. For example, if the author asked you to find the code
$array=$b;
there can be 2 or more of the same line and modifying the wrong one will cause unwanted results. Although it's Hack Author's responsibility to double check this, it will not hurt if you make sure that given line is unique in the code.

5- After you find the place you will modify, be very careful about Author's command: Does he want you to
  • Add a code AFTER this line
  • Add a code BEFORE this line
  • Replace it with a new code.
As you can guess, this is crucial too!

6- If the author asked you to add a code AFTER or BEFORE a certain line, this means that you need to add this new code AS A NEW LINE (if not told otherwise). Let me demonstrate on an example: If author asked you to find the code:
PHP Code:
// value of a
$a=11;
// end here 
and add this line:
PHP Code:
$b=12; 
AFTER this code, this will be WRONG:
PHP Code:
// value of a
$a=11;
// end here $b=12; 
Why? Because you added (appended) right after the exiting line. However "add AFTER", means: "find the last line of original code, go at the end of that last line, press ENTER once and add the code there".

So this is right:
PHP Code:
// value of a
$a=11;
// end here
$b=12; 
So, make sure the inserted code is a new line after it is applied. It should NEITHER be appended after an existing line, NOR any exiting line is appended after it.

7- Try to copy paste from the hack text to your vbulletin code, instead of writing the code manually. This is the best method of applying a hack in most cases. However if you got "PARSE ERRORS" after installing your hack, this is sometimes because of COPY/PASTE process (especially if you are using OPERA as a browser and you copied from your browser window). In this case revert to your back up file and reapply the hack but this time by typing the code by hand (applies to small hacks only). Needless to say be very careful about what you typed and double check you didnt write even 1 character wrong.

8- After you made the necessary changes in the file, you need to upload it to your server. While uploading it via a FTP program make sure it's uploaded as an ASCII file, not a BIN file. (Applies files with .php extensions, ie all vbulletin scripts)

9- I have been asked many times so I'll give this tip here: If you need to modify the hack code to insert a "usergroup id" and if you dont know how to find it, here is how: Admin CP/User Groups/Modify will list all existing usergroups in your board. To learn the id for one of them, choose edit, RIGHT MOUSE click/Open in new browser Window then check your address bar, you'll see it at the end of line as usergroupid=X. That's the id you are looking for. Same tip works for finding forum ids, user ids etc. Just find the "edit" page of the info you need to learn its id, and open it in a new browser window.

10- Sometimes a hack may require you run a SQL command. Before running SQL queries in your MYSQL database make sure you backed up your database. To run SQL queries you have 3 options:
  • Your server may have an utility like "PHPmyAdmin" to run SQL queries. You can use these utilities.
  • You can use this vbulletin hack which helps you run SQL queries via Your VB Admin Control Panel
  • You can use this small independent script which have the same feature.
11- Some hacks instruction file can be named as "*.hack.php" and you may not read the instructions via text viewers. These are hacks which are designed with "VBHACKER" and you have to use this file to install these hacks. Simply put both files (vbhacker and hack itself) into your BOARD/ADMIN/ directory and run http://www.url/your_board/admin/vbhacker.php you will notice the hack name there and by clicking install you can install the hack automatically. If you got used to use text file instructions and want to install hacks manually, then vbhacker can create a text instruction file instead of installing the hack automatically too.

AFTER HACKING:

YOU INSTALLED THE HACK AND IT DOESNT WORK:

Ok dont panic! We'll get you out of trouble:
  • First read hack author's instructions and your applied code very carefully. Did you miss something?
  • Most of the times the hack does not work because of YOUR mistake, so let's be sure: Revert to your backup files, re-back up them and start from the begining. Proceed carefully and slowly!
  • Still not works? ok, first upload your back up files into your server so that we get your unhacked board online again. And check the hack's thread. Does anybody else have similiar problems like you encountered? Are there any solutions posted in the thread? No? ok post your bug report to your thread and ask author's or other users' assistence. Make sure in your message you have mentioned:
    * Vbulletin version of your board
    * What happens exactly when you install the hack?
    * Error messages you get, weird/unwanted/unexpected results hack produced etc.
    * When and under which circumstances errors/unexpected results occur?
    Write your message in DETAIL. Messages like "Hack doesnt work here" can neither help you nor others to help you.
  • Use vbulletin thread to ask for assistence. Hack Authors usually dont enjoy getting PMs or emails asking for hack support. They're busy people who are kind enough to share their codes without commercial intentions, so waiting professional, immediate and private "customer" support for their hacks is not so fair. Besides, asking in thread will help others to help you or answers given to you can help others in the future too..
  • Still no progress. It's ok, sometimes a hack does not work for you. There can be others with similiar features, check for them or just forget about it. No hack is so necessary or so crucial for your board, is it?

YOU INSTALLED THE HACK AND IT WORKS:

Ok so you are done, right? No you are not!

1- Archive the hack you applied. If its instruction is an attached file, save it somewhere in case you need it in the future.

2- Post in hack's thread and say hack works for you without any problems and mention about your vbulletin version. Do this especially if you are one of the first to try this hack or if anyone else havent mentioned that hack works with the version of vbulletin you use. So you will help others using the same version understand they can also apply the hack safely.

3- Click INSTALL button in the hack's thread. This is not same by subscribing to that thread and you will not get any new message notifications by clicking install. By clicking it, you will be notified if hack author corrected a bug, released a new version of this hack. Besides you will help the author to get how many people find it useful and will motivate him to enchance the hack. You will also help other members evaluate the usefulness of the hack since many users check number of installations for a hack before deciding to use. Same applies rating hack's thread as well..

4- If you have ideas to make the hack better, new release requests etc, post them away. This can shed a light to author to enhance his hack or someone else get make improvements you requested.

5- A thank you message to hack author will not hurt anybody either.

That's it.. I hope this information can enhance your hacking experience as a newbie.

Regards,
Logician \\=^))

(To Mods: If you think this thread is more useful in an other forum, you can move it there)
Reply With Quote
  #22  
Old 11-16-2005, 12:57 AM
twincamfxd twincamfxd is offline
 
Join Date: Nov 2005
Posts: 32
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Thank you very much, I have been looking for this exactly before attempting my first hack. Very good read.
Reply With Quote
  #23  
Old 06-02-2006, 05:00 PM
zooki zooki is offline
 
Join Date: May 2006
Location: uk
Posts: 111
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
very useful, wish i knew how to start with moddifying vbulletin,
Reply With Quote
  #24  
Old 07-01-2006, 07:53 AM
satfox360's Avatar
satfox360 satfox360 is offline
 
Join Date: Jun 2006
Posts: 26
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Thank you for the tips.
Reply With Quote
  #25  
Old 07-10-2006, 06:45 AM
chkdgate's Avatar
chkdgate chkdgate is offline
 
Join Date: Jun 2006
Location: US
Posts: 264
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
This is a must read far all noobs like me. I really enjoyed your article and I must say that most of us get too excited when we see an awesome hack and then rush the modding process. After 7 successful hacks, I just got my first parse error and that really flipped me out. Reverting the templates didn't work but I forgot to uninstall the plugins and then, boom, gone. I guess it pays to read threads like these.
Reply With Quote
  #26  
Old 01-04-2007, 12:09 PM
sameerzx sameerzx is offline
 
Join Date: Jul 2006
Posts: 15
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
thanx alot ..very very useful post for me ..i just started learning these things lately .

appreciated ur effort .
Reply With Quote
  #27  
Old 01-08-2007, 07:20 PM
letsjoy's Avatar
letsjoy letsjoy is offline
 
Join Date: Jun 2006
Location: Dhump State
Posts: 197
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
very nice thanks
Reply With Quote
  #28  
Old 02-28-2007, 04:15 AM
Ruby2sdae2 Ruby2sdae2 is offline
 
Join Date: Feb 2007
Posts: 1
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Silly question probably but what are newbies for? :-) I am trying to add the new arcade and it is telling me to upload to chmod 0777 I think and I have no idea where to find that. I am getting a parse error when I click on arcade that is already on my forum. Also, I wasn't able to put it on all by different skins because some of the code I was needing to add to wasn't there like in the navbar.
Reply With Quote
  #29  
Old 03-07-2007, 05:47 PM
kstolee kstolee is offline
 
Join Date: Mar 2007
Location: Canada
Posts: 7
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
chmod 0777 refers to the permissions on the files/folders. I'm not sure if vBulletin has something built in to allow you change that from the control panel (I'm fairly new at this also). Usually this would be done from having shell access to the site.

I have no idea about the parse error, unfortunately, so I can't comment on that... but hopefully that answers your first question.
Reply With Quote
  #30  
Old 02-06-2010, 11:36 AM
antarvasna antarvasna is offline
 
Join Date: Feb 2010
Posts: 8
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
must read for newbie for sure
Reply With Quote
  #31  
Old 05-21-2010, 12:22 AM
GoBoiano GoBoiano is offline
 
Join Date: Apr 2010
Posts: 15
Благодарил(а): 0 раз(а)
Поблагодарили: 0 раз(а) в 0 сообщениях
Default
Really Newbie Question. How do I import xml files from the server to vbulletin. Im trying to add the arcade hack to my forum, however, I am stuck at this crucial part.

https://vborg.vbsupport.ru/showthread.php?t=101554 <---This arcade.

I am stuck at the part where it says, "Enter the path to the Product-XML-File: ./includes/xml/product-ibproarcade.xml". I have no idea what to do with this part. Can anyone help me?
Reply With Quote
Reply
Page 3 of 3 12 3

« Previous Thread | Next Thread »

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts
BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Forum Jump


All times are GMT. The time now is 01:20 PM.

Contact Us - Archive - Top

Powered by vBulletin® Version 3.8.12 by vBS
Copyright ©2000 - 2024, vBulletin Solutions Inc.
X vBulletin 3.8.12 by vBS Debug Information
  • Page Generation 0.05030 seconds
  • Memory Usage 2,322KB
  • Queries Executed 25 (?)
More Information
Template Usage:
  • (1)SHOWTHREAD
  • (1)ad_footer_end
  • (1)ad_footer_start
  • (1)ad_header_end
  • (1)ad_header_logo
  • (1)ad_navbar_below
  • (1)ad_showthread_beforeqr
  • (4)bbcode_php
  • (1)footer
  • (1)forumjump
  • (1)forumrules
  • (1)gobutton
  • (1)header
  • (1)headinclude
  • (1)modsystem_article
  • (1)navbar
  • (4)navbar_link
  • (120)option
  • (1)pagenav
  • (1)pagenav_curpage
  • (2)pagenav_pagelink
  • (11)post_thanks_box
  • (11)post_thanks_button
  • (1)post_thanks_javascript
  • (1)post_thanks_navbar_search
  • (11)post_thanks_postbit_info
  • (10)postbit
  • (11)postbit_onlinestatus
  • (11)postbit_wrapper
  • (1)spacer_close
  • (1)spacer_open
  • (1)tagbit_wrapper 
Phrase Groups Available:
  • global
  • inlinemod
  • postbit
  • posting
  • reputationlevel
  • showthread
Included Files:
  • ./showthread.php
  • ./global.php
  • ./includes/init.php
  • ./includes/class_core.php
  • ./includes/config.php
  • ./includes/functions.php
  • ./includes/class_hook.php
  • ./includes/modsystem_functions.php
  • ./includes/functions_bigthree.php
  • ./includes/class_postbit.php
  • ./includes/class_bbcode.php
  • ./includes/functions_reputation.php
  • ./includes/functions_post_thanks.php 
Hooks Called:
  • init_startup
  • init_startup_session_setup_start
  • init_startup_session_setup_complete
  • cache_permissions
  • fetch_threadinfo_query
  • fetch_threadinfo
  • fetch_foruminfo
  • style_fetch
  • cache_templates
  • global_start
  • parse_templates
  • global_setup_complete
  • showthread_start
  • showthread_getinfo
  • forumjump
  • showthread_post_start
  • showthread_query_postids
  • showthread_query
  • bbcode_fetch_tags
  • bbcode_create
  • showthread_postbit_create
  • postbit_factory
  • postbit_display_start
  • post_thanks_function_post_thanks_off_start
  • post_thanks_function_post_thanks_off_end
  • post_thanks_function_fetch_thanks_start
  • post_thanks_function_fetch_thanks_end
  • post_thanks_function_thanked_already_start
  • post_thanks_function_thanked_already_end
  • fetch_musername
  • postbit_imicons
  • bbcode_parse_start
  • bbcode_parse_complete_precache
  • bbcode_parse_complete
  • postbit_display_complete
  • post_thanks_function_can_thank_this_post_start
  • pagenav_page
  • pagenav_complete
  • tag_fetchbit_complete
  • forumrules
  • navbits
  • navbits_complete
  • showthread_complete