XThreads

My Spiel
XThreads is one of my larger plugins which I have been working on for a while.  Originally planned to release it inline with MyBB 1.6, but who knows when that'll be out.  It perhaps doesn't include everything I wanted it to, but does have most of the things (plus I want to move onto other projects).

What does it do?
Take a look at RateU's forum for some nice ideas of what it can do.  I also have some more basic examples here of what can be done with XThreads.  I'm pretty sure there are many other applications of this plugin, but those examples just give you some simple ideas.

The basic idea is giving you the ability to define custom fields for your threads, and providing methods to give you a lot of flexibility with customising forums.

Warning: I'm not going to bother with "beta" labels and so on.  I've done some testing on this myself, but it's by no means extensive.  Use this at your own risk.

Installation Instructions: standard installation procedures apply - you can find them in the announcement here.
You may need to CHMOD the uploads/xthreads_ul/ folder to 0777 after uploading the files (probably won't though).

Upgrade Instructions: unless stated otherwise, the general procedure for upgrades is to simply upload the new files, then visit your AdminCP.  In there, you'll be presented with a notice to run the upgrade - just follow what it says from there on.

Usage Instructions: this is a complex plugin, and unfortunately, you're probably going to have to figure this out yourself, depending on what you want to achieve with this plugin.  HTML and CSS knowledge is strongly recommended; you should also be familiar with MyBB's template system.  Some demonstrations can be found here - hopefully these will give you a good idea of how things work.  I suggest looking at the thread descriptions example, as this is fairly easy to understand (IMO).  If you can understand how everything works, there, perhaps try out the gallery example.

Known conflicting plugins
- MyPlaza Turbo -
If you are using MyPlaza Turbo, note that the author decided to use a particularly odd method to implement certain functionality, practically destroying compatibility with any plugin which hooks into the forum add/edit routines.  I've included a patch to address this issue - you need to replace inc/myplaza/myplaza_admin_plugin.php with the following file (it's unlikely that this will be committed as the author has decided to discontinue development)

  myplaza_admin_plugin.php (Size: 56.27 KB / Downloads: 2414)

- PL9 Forum Icons -
Affects certain functionality.  See here for a solution.

- PHP in Templates, v1.4 or older -
Similar to PL9 Forum Icons - solution is just to update to the latest version.

- MyAdvertisements - (update: older versions only, later versions may not conflict)
Affects some thread functionality, see here for a solution.

- Group Post CSS -
See here http://mybbhacks.zingaburga.com/showthre...http://mybbhacks.zingaburga.com/showthread.php?tid=378&pid=59

All bug reports, suggestions, criticisms are appreciated (though I may not always implement suggestions) so please feel free to post them.
If you find this plugin useful, I would be grateful if you could give some token of appreciation for the work that has gone into this, and perhaps post some example usages you've come up with in the XThreads forum to help others get an idea of what can be achieve with this plugin (and for my own interest's sake ).


Github: https://github.com/zingaburga/XThreads-MyBB-Plugin
Note: do NOT use the Github version, unless you know what you're doing
Changelogs: v1.10, v1.20, v1.21, v1.22, v1.23, v1.24, v1.25, v1.26, v1.27, v1.30, v1.31, v1.32, v1.337, v1.40, v1.41, v1.42, v1.43, v1.44, v1.45, v1.46, v1.47, v1.50, v1.51, v1.52, v1.53, v1.60, v1.61, v1.62, v1.63, v1.64, v1.65, v1.66, v1.67, v1.68

[ZiNgA BuRgA]

(03-01-2011 05:31 AM)RateU Wrote:  Yumi, I want to ask something.
Is there any reason why XThreads not enabling conditional globally (in template) if a user install XThreads but doesn't have Template Conditional or PHP In Template plugin installed?
I think (my personal opinion), XThreads and conditional is an amazing combo
But I don't know much about performance if this is the reason.

Well, we originally had PHP in Templates, so I've decided to keep the two systems separate so we don't have duplicate functionality (although the conditional code used in both is somewhat a duplicate).
I guess performance is another thing - conditionals in XThreads adds very little overhead whereas conditionals in templates is a bit more.

You're right that they do make sense together, but as we already are able to separate the functionality of the two, I think giving users this option makes things more flexible.
Hope that's what you wanted.

[RateU]

Yeah, I understand your reason, Yumi.
Thanks, for the explanation

[Pirata Nervo]

I love this plugin.

[Pirata Nervo]

Where does XThreads gets the templates for a certain forum? I can't seem to find where they get loaded. For some reason XThreads stopped working on my forum after I have upgraded today, I can't confirm that it was working yesterday though but I suspect it was.

However, I need to know where the templates get loaded, e.g. rf_forumdisplay_threadlist
So, anything like PREFIXforumdisplay_threadlist but if I search for forumdisplay_threadlist it won't show me anything similar to that.

Maybe here in xthreads_global_forumbits_tpl() however some of the templates do not get cached, like the one I referred above, which is obvious since that's just for forumbits but I really can't seem to understand where rf_forumdisplay_threadlist gets loaded and once I figure it out I can start debugging it and looking for what's causing it not to display - note that it doesn't display the forum display templates neither the showthread ones, only the original templates of the theme.

[RateU]

For the templates not loaded (if you are using Google SEO):
http://mybbhacks.zingaburga.com/showthre...http://mybbhacks.zingaburga.com/showthread.php?tid=747&pid=70

[Pirata Nervo]

(03-06-2011 05:31 AM)RateU Wrote:  For the templates not loaded (if you are using Google SEO):
http://mybbhacks.zingaburga.com/showthre...http://mybbhacks.zingaburga.com/showthread.php?tid=747&pid=70

Thanks RateU but what exactly can I do? Zinga doesn't provide the fix, I believe he has fixed it on Shemo's website but didn't provide a fix.

[RateU]

I'm sorry, unfortunately, I don't know too, Pirata.

[ZiNgA BuRgA]

Temporary fix (1.42 will have a better fix):
inc/plugins/xthreads.php:

Find and delete:

PHP Code:

xthreads_preglobal();

---

Find:

PHP Code:

function xthreads_global() {

---

Add after:

PHP Code:

xthreads_preglobal();

---

[Pirata Nervo]

Thanks zinga, I'll try it out tomorrow

[ZiNgA BuRgA]

Updated to v1.42:

• fix bug where the default forum sort option would sometimes revert to "Board Default" in the ACP (thanks to jim7777 for finding)
• fix bug allowing users to not set a value even if denied by permissions (thanks to RateU for reporting)
• resolved conflict with Google SEO custom URLs (thanks to Shemo for reporting)