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: 2410)

- 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

[Shemo]

edit, I figured it out.

several templates were missing some code from it.

[Sama34]

Could it be possible to allow users to insert upload files into their message just like the attachment system does? Specially images.

[Seabody]

The postbit_first template? Set up the thread field as standard, and for the Display Format, set it to something like:

Code:

<a href="{URL}"><img src="{URL} /></a>

---

Insert it into the postbit_first template.

[ZiNgA BuRgA]

(04-07-2013 02:35 PM)Sama34 Wrote:  Could it be possible to allow users to insert upload files into their message just like the attachment system does? Specially images.

If you have PHP in Templates, you could theoretically achieve this via a preg_replace, and then provide some Javascript inserter to add it into the post.
This is, of course, if you don't want to make your users copy the xtattachment URL and use that.

But I'd just use MyBB's attachment system if that's what you want - it'll also be consistent across all posts...

[Shemo]

is it possible to properly filter some categories with xthreads across different sub-forums?

for example, rateu has set up category filtering in the product review mod here, but it only appears to work correctly when all of the categories are within the same forum section, and not spread out to sub-forums.

my reasoning for wanting that functionality is so that I can set up the sub-forums to redirect to the filtered category instead of viewing all of the reviews for all of the categories.

[ZiNgA BuRgA]

The MyBB forumdisplay won't display threads from more than one forum at a time, if that's what you're asking.
XThreads doesn't change this behaviour.

(04-09-2013 01:28 PM)Shemo Wrote:  my reasoning for wanting that functionality is so that I can set up the sub-forums to redirect to the filtered category instead of viewing all of the reviews for all of the categories.

If I understand you correctly, you'd just use the forum link feature to redirect users to the URL with the filter applied.

[Shemo]

(04-09-2013 02:32 PM)ZiNgA BuRgA Wrote:  The MyBB forumdisplay won't display threads from more than one forum at a time, if that's what you're asking.
XThreads doesn't change this behaviour.

(04-09-2013 01:28 PM)Shemo Wrote:  my reasoning for wanting that functionality is so that I can set up the sub-forums to redirect to the filtered category instead of viewing all of the reviews for all of the categories.

If I understand you correctly, you'd just use the forum link feature to redirect users to the URL with the filter applied.

since the sub-forums are hidden to non-admins and mods at the moment, I can't give you live links, but I did take a screenshot of how I'm wanting to use the product review xthreads mod:



as you see, each forum will have a sub-forum for reviews (soap & cream reviews, blade reviews, etc.)..

if I go into the soap & cream review sub-forum, this is how it looks (direct sub-forum url - remember, this link is not viewable for non-admins & mods http://shavenook.com/forum-soap-cream-reviews)



when I click the 'soaps & creams' category on the right, it redirects to this url and shows nothing in that category: http://shavenook.com/forum-soap-cream-re...http://shavenook.com/forum-soap-cream-reviews?filtertf_pfcat=Soaps%20an



when I click on another category while still in the soap & cream reviews sub-forum, like brushes for example, http://shavenook.com/forum-soap-cream-re...http://shavenook.com/forum-soap-cream-reviews?filtertf_pfc it's not filtering anything because I guess any brush reviews were created in the brush review sub-forum, http://shavenook.com/forum-brush-reviews

I guess what I'd need to do, if it's possible, is have the filters redirect to the proper sub-forums.

for example, if someone is within the soap & cream reviews section and clicks on one of the categories on the right side other than the soaps & creams category, it'll filter to the appropriate sub-forum.  is this possible?

--------

edit: blah, I'm probably going to do away with that categories box on the right hand side of the forumdisplay pages as it really won't serve a purpose for me in the way I'm wanting it to work since the review categories aren't in the same forum to begin with.

[ZiNgA BuRgA]

Yeah, I don't even know why you're using filters in the first place if this is what you want to achieve.

[Seabody]

ZiNgA, {$first_post} does not seem to be displaying properly. I set "Show first post on every showthread page" to Yes, and moved {$first_post}, applying a little formatting, but nothing appears to have changed.

Source output:

HTML Code

<div class="float_right" style="width: 20%;"> </div>

---

Template:

HTML Code

<div class="float_right" style="width: 20%;"> {$first_post} </div>

---

Edit: NM, I didn't have a postbit_first template. Fixed.

[avril]

Hi everyone.
Im using xthreads for some time now and would like to share my experience,
on what options i found missing in xthreads but required while working on customising various sites.

Summarising these experiences i gathered thought's about these missing options
and added it as new feature's suggestions which i believe may improve xthreads usability.
(even tho xthreads are allready excellent, no one said it cant be mega excellent and ultra awesome)

The suggestions are :
issue #7, New option - thread field 'Not applicable forums' (importance - 10/10 critical stuff happen without it!)
issue #8, New option - xthreads works in chosed templates (importance - 7/10 can live without it but its sometime hassle)
issue #9, New option - hidden lock variable, xthreads interface in ACP visible to uID's (importance - 3/10 could be nice addition)