[How to] Write Plug-ins/Hooks

[Brad]

This is your basic guide to making plug-ins and hooks, as we are all coming over from the 'hack the files' mentality I am posting this thread more for people that are used to hacking the 3.0.x source code and looking to port modifications. Although a newbie should be able to come away with a good understanding of how to do this to :).

Things to consider

Ok before we get started here are a few things to keep in mind. First and foremost plug-ins are stored in the database, serlized, unserlized and evaled on page generation. If you code preforms badly with such a wrapper forget making a plug-in and just hack it, trust me you'll thank yourself for it when your forum gets large.

Second thing, hooks will not get you into every corner of the code. Some things will always be done best with a hack. For example if you are looking to add something but need to query the db for some extra data and want to avoid and extra query (in other words you are going to modify an existing one with a join or such) forget it and hack it in, there are no hooks that let you modify existing queries.

Last but not least hooks are not magic, don't add a million of them and expect your forum to run as fast as it did when you first installed it. Only plug-in/hack-in what you really need!

Ok enough with the boring stuff, lets add our first plug-in!

Basics:

First thing you need to do is make sure plug-ins are enabled, you can find this option in the admin cp by browsing to vBoptions -> Select Plugin/Hook System from menu -> Set Enable Plugin/Hook System to yes.

Now head to the add plug-in page located at http://www.yoururl.com/forum/admincp/plugin.php?do=add

Lets go over what all these options mean:

Hook Location: This is where the php code will be executed at, hook locations at defined all across vBulletin. You can find them by opening and php file and searching for the var $hook. When you find a bit of php code like this you have found a hook:

($hook = vBulletinHook::fetch_hook('showthread_postbit_crea te')) ? eval($hook) : false;

See that bit fetch_hook('showthread_postbit_create')? Well the text "showthread_postbit_create" is the name of this hook, if you look in the drop down you will find that listed in there somewhere. Incase you are wondering that hook is located in showthread.php at line 1012

Title: This is the title of your plug-in, use a good name because this is the only thing you have to identify the plug-in in the plug-in manager.

Plugin PHP Code: Can you guess? This is where you put your custom php code, on page generation it is executed at the hook location in the .php files. Note that you do not need <?php ?> tags here, in other words:

wrong:

<?php $var = true; ?>

Right:

$var = true;

Plugin is Active: Allows you to turn the plug-in on/off without removing it. If set to 'yes' php code is ran on page execution.

Edit - Thanks to Revan (https://vborg.vbsupport.ru/member.php?u=47482) for this addition:

vbulletin_plugins.xml
If you need to tell your users to add a lot of plugins, this will become tedious as much copy/pasting is required. A simpler way would be to use the .xml import. It works just like the importing of templates and phrases, by adding the contained code as a Plugin.
The correct format for a plugin.xml file is like so (thanks to Live Wire):
<?xml version="1.0" encoding="ISO-8859-1"?>
<plugins>
<plugin active="1">
<title>vB Category Icons</title>
<hookname>forumdata_start</hookname>
<phpcode><![CDATA[$this->validfields['forumhomeicon'] = array(TYPE_STR, REQ_NO);]]></phpcode>
</plugin>
</plugins>
Explanations:
<plugin active="1"> - The 'active' attribute determines the default value of 'Plugin is Active' in the Plugin Manager.
<title></title> - Self explanatory, it is the 'Title' field in the Manager.
<hookname></hookname> - The 'Hook Location' you would select.
<phpcode><![CDATA[ ]]></phpcode> - Anything added in the space between these is added to the 'Plugin PHP Code' part.

Tips

At first approach coding the plug-in like a hack.

Open the php file you would normally edit and get your mind around the new code.

Once you have a good understanding of the new code you should start looking for where you need to add your custom php. Once you find the right location in the code start looking for a nearby hook, if you don't see one you can work with you are out of luck! :(

Edit- Thanks to KirbyDE (https://vborg.vbsupport.ru/member.php?u=47102) for his addition:

Something that might come in handy for those developing Plugins:

In class_hook.php FIND

function &fetch_hook($hookname)
{


BELOW that ADD

DEVDEBUG("Calling Hook $hookname");


Then (if debug mode is turned on) you can see which hooks are being called, and when they are being called.

Once you find your hook note its name and apply your changes in the admincp, from here on out you are on your own :)

[amykhar]

Thanks, Brad. It's nice to have a plugins for dummies tutorial to get started with :)

[Logikos]

Excellent! Now i understand the hooks system.

[amykhar]

I'm glad somebody does :D

The first hack I looked at porting doesn't look like it will be able to use the hook system, unfortunately. I really wish jelsoft had come up with a more extensible way to format queries. If the queries have to be changed, we run into the same problems we had before.

I would love it if the arguments to a query were set up in an array format that could be easily added to. That way, if we are forced to add into an existing query, the user could modify the arguments to the query rather than the query itself. It would be so much easier to prevent hack conflicts and installation errors that way.

Amy

[Brad]

Amy: If you see a good spot for a hook request it at vBulletin.com, this is one of the main reasons we are encourged to hack the beta :)

[Logikos]

Brad i have a question, I ported my icons hack. But i have to hack the admincp/forum.php for the option to show up in the admincp. Does the Hooks system work in the admincp/ dir? From what i read in the code it doesn't.

Maybe you have another solution to this.

Its just this:

print_textarea_row('description', 'forum[description]', $forum['description']);

[Andreas]

Unfortunately there are currently no hooks within the AdminCP.
Therefor you will have to modify the files.

[Logikos]

Unfortunately there are currently no hooks within the AdminCP.
Therefor you will have to modify the files.
Then whats the point! Bah, so much for that... :p

[Brad]

Then whats the point! Bah, so much for that... :p
Less file modification = easier to upgrade.

Like I said, you see a useful place for a hook request one at vBulletin.com! :)

[amykhar]

I am not sure a hook would help my problem. For example, if you look at index.php, you see a query to get the logged in users.


$forumusers = $db->query_read("
SELECT
user.username, (user.options & " . $vbulletin->bf_misc_useroptions['invisible'] . ") AS invisible, user.usergroupid,
session.userid, session.inforum, session.lastactivity,
IF(displaygroupid=0, user.usergroupid, displaygroupid) AS displaygroupid
FROM " . TABLE_PREFIX . "session AS session
LEFT JOIN " . TABLE_PREFIX . "user AS user ON(user.userid = session.userid)
WHERE session.lastactivity > $datecut
" . iif($vbulletin->options['displayloggedin'] == 1, "ORDER BY username ASC") . "
");


Now, I need to know the useragent field from the sessions table. So, I have to change the query to:


$forumusers = $db->query_read("
SELECT
user.username, (user.options & " . $vbulletin->bf_misc_useroptions['invisible'] . ") AS invisible, user.usergroupid,
session.userid, session.inforum, session.lastactivity,session.useragent,
IF(displaygroupid=0, user.usergroupid, displaygroupid) AS displaygroupid
FROM " . TABLE_PREFIX . "session AS session
LEFT JOIN " . TABLE_PREFIX . "user AS user ON(user.userid = session.userid)
WHERE session.lastactivity > $datecut
" . iif($vbulletin->options['displayloggedin'] == 1, "ORDER BY username ASC") . "
");


I don't think a hook would change that for me. But, if each query had it's arguments defined in a structure that defined the columns to read, update, or insert and had a way to set up joins, etc. outside the query in a clean, easy to modify way (such as adding arguments to an array), then we could hack right in there without worry of conflicts or sql syntax issues.

Amy

[Andreas]

Hmm .... a Query class!
That's what would be needed.

Example

$query->add_join($table, $alias, $condition);
$query->add_fields(array('field1', 'field2' => 'fieldalias'));
$query->add_condition($operator, $condition);
...

[amykhar]

Hmm .... a Query class!
That's what would be needed.

Example

$query->add_join($table, $alias, $condition);
$query->add_fields(array('field1', 'field2' => 'fieldalias'));
$query->add_condition($operator, $condition);
...

Exactly!

[Fusion]

Hmm .... a Query class!
That's what would be needed.

Example

$query->add_join($table, $alias, $condition);
$query->add_fields(array('field1', 'field2' => 'fieldalias'));
$query->add_condition($operator, $condition);
...

Actually, that's an excellent idea.

[Revan]

I have an addition to this tutorial:

vbulletin_plugins.xml
If you need to tell your users to add a lot of plugins, this will become tedious as much copy/pasting is required. A simpler way would be to use the .xml import. It works just like the importing of templates and phrases, by adding the contained code as a Plugin.
The correct format for a plugin.xml file is like so (thanks to Live Wire):
<?xml version="1.0" encoding="ISO-8859-1"?>
<plugins>
<plugin active="1">
<title>vB Category Icons</title>
<hookname>forumdata_start</hookname>
<phpcode><![CDATA[$this->validfields['forumhomeicon'] = array(TYPE_STR, REQ_NO);]]></phpcode>
</plugin>
</plugins>
Explanations:
<plugin active="1"> - The 'active' attribute determines the default value of 'Plugin is Active' in the Plugin Manager.
<title></title> - Self explanatory, it is the 'Title' field in the Manager.
<hookname></hookname> - The 'Hook Location' you would select.
<phpcode><![CDATA[ ]]></phpcode> - Anything added in the space between these is added to the 'Plugin PHP Code' part.


// end my contribution (if this is being merged into the first post, nothing below this is to be included)

And just for all you lazy people out there, here is an empty set, ready for copypasting into a blank xml file (only the <?xml and <plugins> tags need to be there already):
<plugin active="1">
<title></title>
<hookname></hookname>
<phpcode><![CDATA[]]></phpcode>
</plugin>

I hope this helps hack writers that want to minimise the hassle for the end-user :)

[Cap'n Steve]

First and foremost plug-ins are stored in the database, serlized, unserlized and evaled on page generation. If you code preforms badly with such a wrapper forget making a plug-in and just hack it, trust me you'll thank yourself for it when your forum gets large.

Could you elaborate on this? Are there some known problems with eval() or something else?

[Logikos]

Could you elaborate on this? Are there some known problems with eval() or something else?

What he means is, if your code is just;

echo $threadid;


You better off hacking it, as if you add it to the plugin area, it has to call a query just to call that line.

The above is just a stupid example for you to understand better. Obviously we won't be using a echo in our hacks.

[Paul M]

I have an addition to this tutorial:

<snip>
If you have developed the plugin on your own board then all you need do is use the plugin manager's download feature to create your ready made xml file for others to use.

[Marco van Herwaarden]

Guys (and girls) please don't use threads in the How-To's forum to say thank you or discuss things. Only post How-To's and additions to them so we can get clean instructions on how to solve problems.

[Andreas]

Something that might come in handy for those developing Plugins:

In class_hook.php FIND

function &fetch_hook($hookname)
{


BELOW that ADD

DEVDEBUG("Calling Hook $hookname");


Then (if debug mode is turned on) you can see which hooks are being called, and when they are being called.

[dwh]

I'm trying to get a handle on these hooks. What if you want to write custom code and just hook it into opening a new pm, or starting a new thread. How would that work?

Also is there a difference between a Plug-In and a Hook or are they the same thing?

[Marco van Herwaarden]

A Plug-In is the code that uses a Hook to attach itself to exisitng code.

[Revan]

hacking it, as if you add it to the plugin area, it has to call a query just to call that line.Not true. I tried adding 5 plugins to the showthread all with useless variable definitions, and it did not call any additional queries.

[dreck]

Thanks Brad

[deathemperor]

When adding new plugin, there's a input field name 'Developer Key' . Do you know what it does, Brad ? the strange thing is that I installed 2 vb3.5 board, one has it but the another doesn't

Edit: it shows when you enabled debug mode

[dwh]

A Plug-In is the code that uses a Hook to attach itself to exisitng code.

I think I get it. So it's like "including" some code in a certain place in the code? Is that all??

I thought it was going to be more of a standardized method of calling certain functions.

Like if you want to start a new thread each time someone registers, instead of copying all the code around creating a new thread you just call build_new_post() (which surprisingly wasn't enough in vb 3.07). Or for a custom PM every time someone reaches 100 posts you call build_new_pm().

It sounds like this is very different than I was expecting.

[Marco van Herwaarden]

You can see a Plugin as an externally definable include.

What you are talking about has nothing to fo with Plugins, but with standard functions offered, and maybe with approaching this as OOP classes.

[dwh]

You can see a Plugin as an externally definable include.

What you are talking about has nothing to fo with Plugins, but with standard functions offered, and maybe with approaching this as OOP classes.

Thanks for explaining it.

To tell the truth, I'm pretty disappointed by this. It sounds like adding a ton of complexity to something as simple as inserting a bit of code in a file. This might actually make upgrades worse. Includes need to happen at the right place. I'd rather look at the code on one page when upgraded to see if the placement has to change. Now if there are 3 mods working on a similar piece of code, it will be much harder to get a feel of the flow of the code. As it is, with regular code, to follow the logic you need to look at all the included files. I've found that to be quite a pain several times, but there it's understandable. I dunno. Maybe it will all work out, but I'm wondering if this is such a good thing...

What's the big benefit? Just to make mods easier to install for newbies?

(Just in case this comes off wrong, I'm not trying to say this in a negative manner or just to nag...I also want to check if I'm understanding this properly and give feedback about it. As always, I want it clear that I love vb!)

[sketch42]

ok im a bit confused at how these hooks work.. i mean i understand the basics of it but i think i need a bit more explanation

now say i wanted to add my code into /admincp/user.php
and i want to modify this area

// ###################### Start Edit Access #######################
if ($_REQUEST['do'] == 'editaccess')
{
if (!can_administer('canadminpermissions'))
{
print_cp_no_permission();
}

$vbulletin->input->clean_array_gpc('r', array(
'userid' => TYPE_INT
));

$user = $db->query_first("SELECT username, options FROM " . TABLE_PREFIX . "user WHERE userid = " . $vbulletin->GPC['userid']);

$accesslist = $db->query_read("SELECT * FROM " . TABLE_PREFIX . "access WHERE userid = " . $vbulletin->GPC['userid']);

//echo '<h1>$db->numrows($accesslist) = ' . $db->num_rows($accesslist) . '<br />user.hasaccessmask = ' . ($user['options'] & $vbulletin->bf_misc_useroptions['hasaccessmask'] ? 'yes' : 'no') . '</h1>';

while ($access = $db->fetch_array($accesslist))
{
$accessarray[$access['forumid']] = $access;
}

print_form_header('user', 'updateaccess');
construct_hidden_code('userid', $vbulletin->GPC['userid']);

print_table_header($vbphrase['edit_access_masks'] . ": <span class=\"normal\">$user[username]</span>", 2, 0);
print_description_row($vbphrase['here_you_may_edit_forum_access_on_a_user_by_user_ basis']);
print_cells_row(array($vbphrase['forum'], $vbphrase['allow_access_to_forum']), 0, 'thead', -2);
print_label_row('&nbsp;', '
<input type="button" value="' . $vbphrase['all_yes'] . '" onclick="js_check_all_option(this.form, 1);" class="button" />
<input type="button" value=" ' . $vbphrase['all_no'] . ' " onclick="js_check_all_option(this.form, 0);" class="button" />
<input type="button" value="' . $vbphrase['all_default'] .'" onclick="js_check_all_option(this.form, -1);" class="button" />
');


so the closest hook i could find is this
($hook = vBulletinHook::fetch_hook('useradmin_update_save') ) ? eval($hook) : false;

which is 20 lines above
so would i need to do this?
($hook = vBulletinHook::fetch_hook('useradmin_update_save') ) ? eval($hook) : false;

// save data
$userid = $userdata->save();
if ($vbulletin->GPC['userid'])
{
$userid = $vbulletin->GPC['userid'];
}

// ################################################## ###########################
// now do the redirect

if ($vbulletin->GPC['modifyavatar'])
{
define('CP_REDIRECT', "usertools.php?do=avatar&amp;u=$userid");
}
else if ($vbulletin->GPC['modifyprofilepic'])
{
define('CP_REDIRECT', "usertools.php?do=profilepic&amp;u=$userid");
}
else
{
define('CP_REDIRECT', "user.php?do=modify&amp;u=$userid" . ($userdata->insertedadmin ? '&insertedadmin=1' : ''));
}

print_stop_message('saved_user_x_successfully', $user['username']);
}

// ###################### Start Edit Access #######################

BLAH BLAH BLAH CUSTOM PHP CODE


or am i way off base?

[dwh]

Actually, that's an excellent idea.

Has there been any traction on this idea? Does vb think of doing this in a future version?

[DJ RRebel]

yeah ... I'd have to agree that most of the hacking I've done and would like to do involves calling extra fields in the database ... I haven't really looked into it yet, but it would seem that it would make alot of sense to have hooks at the end of some select statements.

... or better yet, have "replacement hooks" for some queries ... where the default querry would be used ... but if there was an active hook for that location, that segment would be replaced. Although I'm guessing this 2nd option would make you have to change your hook after upgrading if the original query required changes.

Anyhow ... I guess I should try a Plug-in or two before I make too many more suggestions! lol

[PennylessZ28]

Nice, this is going to help alot as I'm starting to dabble in writting some custom stuff for a concept board I am creating on my test server.

[Wired1]

Don't know if this was mentioned anywhere yet, but you can create your own hook locations. I did it for one of my hacks.

[pyro.699]

is there a list? any where, that tells you what each hook location is for?

(i need on that runs when your posting a new thread)

[timetunnel]

Hello.

This thread has help me figure out the 'hook' system (ref: https://vborg.vbsupport.ru/showthread.php?t=100597) finally (actually, I hadn't needed it previously except for variable creation, until yesterday). You'll see my interpretation in that ref'd thread.

Hope it helps. :squareeyed:

P.S. This hook system is brilliant! I've worked with many other software programs and the vB structure is at the top on the pyramid in its design.

[monotreme]

Don't know if this was mentioned anywhere yet, but you can create your own hook locations. I did it for one of my hacks.

To create your own hook locations (I'm talking to Wired1) don't you have to hack the core code? Still I guess its better to insert one line hook definition than 60 lines of code.

[davidw]

<font color="SeaGreen">* christianb subscribes to this thread</font>

[Wired1]

To create your own hook locations (I'm talking to Wired1) don't you have to hack the core code? Still I guess its better to insert one line hook definition than 60 lines of code.

Exactly, 1 line is better than 60. It's also much harder for someone to screw up and/or fix 1 line than 60 as well (e.g. misplacement, typo, etc).

If anyone's interested I could write up a quick tutorial about it.

[Cap'n Steve]

To create your own hook locations (I'm talking to Wired1) don't you have to hack the core code? Still I guess its better to insert one line hook definition than 60 lines of code.

You can also add hooks to your own code, which is what I thought he was talking about.

[timetunnel]

Hello.

Wired1, any tutorials are always welcomed.

Cap'n Steve, I'd also like to know how to add hooks to custom code.

Thanks folks.

[Wired1]

Yeah, you can add hooks anywhere. It's pretty easy actually.

Can't remember which hack I added a custom hook for (it's either the extra info one or the profile one), but one of them has the basic instructions for it. I'll try to whip one up in a couple of days.

[timetunnel]

Hello.

How do you create a 'product' plugin file like the one at https://vborg.vbsupport.ru/showthread.php?t=99579

(see the code in Ted S's 'welcome hdr 4 0 6.zip' file download).

In the xml file contained in the zip file, it begins with the tags, '<product...>' then '<templates>', then '<plugins>', etc.

Was this coded by hand or is there a template that is used to create these types of xml files for importing into the vB Plugin system? I see how to create the <plugins> code using the vB Plugin Manager (Download) in AdminCP, but not the rest. I'd like to create a clean file for creating templates via this type of xml so when I create revisions for others, I can make it where they can 'import' the complete xml 'product/plugin' vs. using a 'txt' file download that says, 'Find' this, 'Add' that, etc.

Thanks in advance.

[TyleR]

Hello.

How do you create a 'product' plugin file like the one at https://vborg.vbsupport.ru/showthread.php?t=99579

(see the code in Ted S's 'welcome hdr 4 0 6.zip' file download).

In the xml file contained in the zip file, it begins with the tags, '<product...>' then '<templates>', then '<plugins>', etc.

Was this coded by hand or is there a template that is used to create these types of xml files for importing into the vB Plugin system? I see how to create the <plugins> code using the vB Plugin Manager (Download) in AdminCP, but not the rest. I'd like to create a clean file for creating templates via this type of xml so when I create revisions for others, I can make it where they can 'import' the complete xml 'product/plugin' vs. using a 'txt' file download that says, 'Find' this, 'Add' that, etc.

Thanks in advance.

it's coded by hand, I believe..atleast thats how i've coded mine thus far.

[Marco van Herwaarden]

You should not code Product/Plugin XML-files by hand. If you set the correct Product everywhere (new templates, phrases, settings,...) it will all be in the file when you export it.

[timetunnel]

You should not code Product/Plugin XML-files by hand. If you set the correct Product everywhere (new templates, phrases, settings,...) it will all be in the file when you export it.
How? Is this done within vB AdminCP? If so, where? How to create e.g. a new template or phrases using the plugin manager (or wherever in vB) without coding by hand? How to '...set the correct Product everywhere...'? What is that?

Thanks in advance.

[Cap'n Steve]

<a href="showthread.php?t=92953" title="vBulletin.org Forum - Article 92953">This thread should answer all your questions.</a>

[timetunnel]

Thank you. Thank you. Thank you. This is just what I need to get more power out of this wonderful software.

[HaMaDa4eVeR]

Hello
I would like to use function.php file in my priavte plugins and I didn't find sutable Hook Location
I need to change this line :

return $datefunc($format, $timestamp_adjusted);
with this :


$new=$datefunc($format, $timestamp_adjusted);
$new=preg_replace('/AM/', 'After Morining', $new);
$new=preg_replace('/PM/', 'P - M', $new);

return $new;

[HaMaDa4eVeR]

Is there any 1 can help me here

[Cap'n Steve]

Look in whatever function is contained in $datefunc. If that doesn't work you'll probably need to modify the code.

[Marco van Herwaarden]

Are AM & PM not defined by Phrases? Couldn't you just change the phrase?


EDIT: No it looks like this is not phrased

[Logikos]

Second thing, hooks will not get you into every corner of the code. Some things will always be done best with a hack. For example if you are looking to add something but need to query the db for some extra data and want to avoid and extra query (in other words you are going to modify an existing one with a join or such) forget it and hack it in, there are no hooks that let you modify existing queries.

This quote should be updated:

You can join into Queries now:
Lets say you wanted to show some custom info on each post. In 3.0x you would modify an exsiting query. Its the biggest query in showthread.php. Starts like "$posts = $db->query_read("".

You would have to add you own SELECT statments like table.username AS username, and JOIN statements like LEFT JOIN " . TABLE_PREFIX . "user AS user ON(user.userid = post.userid). You don't need to do that anymore.

If you wanted to do this is 3.5 using hooks you can. Open showthread.php and find around line: 923-924. You should see...


$hook_query_fields = $hook_query_joins = '';
($hook = vBulletinHook::fetch_hook('showthread_query')) ? eval($hook) : false;

Under that you will see a very large query, in that query you will notice the variables, $hook_query_fields, and $hook_query_joins. Thats your ticket into this query.

You would simple go into the plugins, add new plugin and write it like so: Plugin Name is "showthread_query"

$hook_query_fields = ",tablename.rowname AS newname";
$hook_query_joins = "LEFT JOIN " . TABLE_PREFIX . "tablename AS newtable ON(tablename.rowname = post.rowname)";


Tips:
Just remember to start "$hook_query_fields" variable with a comma.
You can also add conditions around this which is great I think. Example:

if ($var == $var2)
{
$hook_query_fields = ",tablename.rowname AS newname";
$hook_query_joins = "LEFT JOIN " . TABLE_PREFIX . "tablename AS newtable ON(tablename.rowname = post.rowname)";
}


Hope this helps some advance users. :)

[Eagle Creek]

Can't this thread be sticky :-)?

[LaCN]

Help..

I got this part in my plugin:


if ( ($vbulletin->options['LaCN_enable']) && ($vbulletin->userinfo[usergroupid] == '0') )
{
$guestIC = $vbulletin->options['LaCN_guest_text'];
}


eval('$LaCN_message = "' . fetch_template('LaCN_message') . '";');

in the templates I have this:


blabla
$LaCN_message
blabla


blabla
$guestIC
blabla


the template shows.
But $guestIC won't show :(

What's wrong ?

[Wired1]

Re-read the instructions. Your code that calls the hook is wrong, and you need to enter the hook into the xml file that holds the hooks.

[LaCN]

Before I make an xml file, I'm building it first as if it was already installed ;)
The plugin is set in the global_start hook, so that's fine.

the plugin itself has to add the to be used templated to the cache, that's what I've used that eval line for

[Lea Verou]

Can one add hooks in plugins (for add-ons)?
I guess not, but I don't lose anything by asking...

[Opserty]

Can one add hooks in plugins (for add-ons)?
I guess not, but I don't lose anything by asking...
https://vborg.vbsupport.ru/showthread.php?t=82703

Another article by Brad lol :)

[Lea Verou]

https://vborg.vbsupport.ru/showthread.php?t=82703

Another article by Brad lol :)
I read the whole thread but there is nothing mentioned about hooks in plugins.

[Opserty]

I read the whole thread but there is nothing mentioned about hooks in plugins.
Have you tried it out anyway? I don't really see the point of including a hook in your plugin code if people want to develop modifications for it then they could just edit the plugin code. I guess it is your choice but it wouldn't be something I would do.

[Lea Verou]

Have you tried it out anyway? I don't really see the point of including a hook in your plugin code if people want to develop modifications for it then they could just edit the plugin code. I guess it is your choice but it wouldn't be something I would do.
In fact, I want to develop a "bridge" for users that have one of my modifications and one I'm planning to release soon. I don't want them to edit the plugin code, because they'll have to do it over and over again on each update.
So hooks would really come in handy here.

[Opserty]

Fair enough, I don't see why that link I posted wouldn't work the same in a plugin. Just do the same but instead of writing the hook in the PHP file stick it in your plugin. No harm in trying if you haven't already done so :p

Did you get some kind of error or was it just not working?

[Lea Verou]

I didn't try it yet, as I didn't need it at the time (I need it today).
I'll try soon though and post what happened.

[amnesia623]

Is this tutorial current as of vb 3.6.8?

I'm looking for a plugin tutorial and wondered if this is still relavent

[Birched]

The advice by KirbyDE at the end of the main entry was BY FAR the most useful part for me, but yes, I believe it is all still relevant.

[Hubbitus]

At the beginning, thank you for the good basic guide.

But I'm not completely understudying how I can associate my hook with two or more "hookname" at once? E.g. "newreply_post_start", "newthread_post_start".
<title>vB Category Icons</title>
<hookname>forumdata_start</hookname>

If I try this code:

<title>vB Category Icons</title>
<hookname>newreply_post_start</hookname>
<hookname>newthread_post_start</hookname>
I get hook, associated to "useradmin_edit_start", as I understood the first item at the list.

Is it the only way to make the fully copy of the code into a new hook and associate it with new hookname???

[Opserty]

This tutorial is old. You can add plugins through the AdminCP via the Plugin Manager.

I don't think it is possible to associate the same code to two hooks. Just copy the code over to a new plugin to create code for another hook.

[Hubbitus]

This tutorial is old. You can add plugins through the AdminCP via the Plugin Manager.
Of cause, I known. But, I'm don't known how associate the same code to two hooks in this case too.

I don't think it is possible to associate the same code to two hooks. Just copy the code over to a new plugin to create code for another hook.
If no other, "normal" way, off cause i do that. But I hope that someone will prompt more correct way.

[hobeau]

Hi, I just want to display a list of users who have posted on a thread at the top of the thread using the hook system. I'm brand new to VBulletin and was wondering if there is a good tutorial or documentation that would help. I've looked in the vb manual and it just has like 2 pages on writing plugins. Can anyone help?

[wottech]

If you wanted to do this is 3.5 using hooks you can. Open showthread.php and find around line: 923-924. You should see...


$hook_query_fields = $hook_query_joins = '';
($hook = vBulletinHook::fetch_hook('showthread_query')) ? eval($hook) : false;

Under that you will see a very large query, in that query you will notice the variables, $hook_query_fields, and $hook_query_joins. Thats your ticket into this query.

You would simple go into the plugins, add new plugin and write it like so: Plugin Name is "showthread_query"

$hook_query_fields = ",tablename.rowname AS newname";
$hook_query_joins = "LEFT JOIN " . TABLE_PREFIX . "tablename AS newtable ON(tablename.rowname = post.rowname)";




Is there a way to add WHERE and ORDER statements to this query as well, using hooks?