Miscellaneous Hacks - Featured Threads

Overview

This product is designed to allow for the creation, display and management of a list of threads that you wish to feature on your site. It gives you a convenient means of showcasing especially good thread content on your forum and give it the increased visibility to registered users and visitors alike that you likely already feel it so richly deserves. You will find that when the featured threads list is displayed on its static page, then the block element is not collapsible since it does not share space with any other content, otherwise it is collapsible so that users will not have to scroll past this list to get to other parts of the page it they wish not to. This is consistent with the behavior of other vBulletin elements.

You may choose to manage this list yourself, or allow others on your staff to share in or even take over the management duties. Some or all of your members may even be allowed and encouraged to be a part of the process by their nominations of threads for the list. You can choose to allow nominations via this product, or use vBulletin's intrinsic thread rating system, or use a combination of both systems. You may also choose to display the most replied threads as well. In this way you could elect to implement a threads of the week or month etc. by popular vote. This product makes all of this possible and easy to accomplish.

You will find that you have a great deal of flexibility in where and how the list is displayed. Those you designate as managers of the list can add, remove, and set the display order of the threads in the list. Also, you may choose to allow your managers to auto-create voting polls to narrow down the selection of nominated threads to be added as featured threads, which is posted to a forum of your choosing. This forum may be private so that only staff is involved in the final voting, or a public forum may be selected so that everyone may vote. All actions performed by users and managers are confirmed with a standard vBulletin redirect message.

Upon installation, two tables are added to your database, one to store the list of featured threads, and one to store the nominations data. Queries are joined so that the latest data for all threads is displayed in the lists and to minimize the redundancy of stored data. If the product is uninstalled, then naturally the two added tables are removed.

The product settings are conveniently sub-divided into the following six categories:

Location Of "Featured Threads" List

You may choose to have the featured threads list displayed on every page, either below the navbar or above the footer. You are given the option to exclude any scripts that you choose. For example you may not want the featured threads list to display on pages whose associated script names are inlinemod, member or online.

In addition to displaying the list on all pages, you may choose one or more of the following options:

• Display the list on your forum home page, either above or below the forums.
• Display the list on your forum display pages, either above or below the threads.
• Display the list on your show thread pages, either above or below the posts.

Note, the above 3 options will be effectively disabled if you have chosen to display on all pages to prevent duplication of content, unless you have set them as excluded scripts for displaying on all pages. This gives you increased control over these 3 pages. For example, you may wish for the featured threads list to display at the top of the page everywhere except on your home page, and so you could have it displayed below the forums there instead.

In addition to, or instead of these options, you may choose to display the list on its own static page. If you have chosen to display on all pages, that will naturally be disabled on the static page to prevent duplication of content. You then have the option to either create your own link to the page using the "Navigation Manager" or you may opt to have a link to the page auto-added as either a navtab:



A navlink on the navbar:



Or as a link in either the "Community" or "Quick Links" drop-down menus on the navbar:

Appearance Of "Featured Threads" List

You may choose to give the "Featured Threads" list element a custom title. This title will be used in the header of the list element, as the link text to the static page on the nav bar, and as the page title for the static page.

You may set a maximum height for the list that applies when it shares space with other content, that is, when it is not on the static page. A vertical scroll-bar is introduced when the list is taller than the maximum height you set. This height does not inlude the header element, just the table of data.

You may set the left/right margins of the list element as a percentage of the parent element. For example, if you wish for the list element to be 75% as wide as the parent element, and centered, then you would enter 12.5 for both the left and right margins. If you want the element to still be 75% as wide as the parent, but all the way on the right, then you would enter 25 for the left margin and 0 for the right margin.

You may set the background color for the "Featured Threads" element, using an HTML color picker.

You may define the CSS for the borders of the list element. This includes both the outer border and the inner borders of the table containing the data. The table cells are only given borders on the right.

You are given an HTML color picker for the color of the Forum/Thread links in the list, as well as the option to give any additional CSS for these links. You may also set the alignment for the thread links (left/center/right).

You may choose how the featured threads are sorted (by Thread Id/Thread Title/Date/Time Added To List/Thread Author User Id) and whether to sort in ascending or descending order. Note that when one of your managers imposes an order for the threads, then that ordering will take precedence.

You may chose to include optional thread information to be displayed, including Replies, Views, Last Poster, Forum, and Prefixes. Thread authors and titles are always displayed. The thread author has a tooltip showing when they created the thread. The replies has a tooltip giving a breakdown of everyone who posted in the thread, sorted in descending order by the number of posts, and then by user id in the case of ties in the number of posts. The last poster has a tooltip that shows when they posted that last post. All usernames in both lists (featured threads and nominated threads) are shown using their current HTML markup. And finally the thread has a tooltip showing a preview of the content of the first post. The number of characters is that which you have set in the AdminCP's general settings.

You can set the maximum number of characters of each thread's forum name to be displayed since these can be long and take up a lot of space. To display the complete forum names, set this maximum to zero. All forum titles that are truncated will have a tooltip that shows the complete forum name on mouse hover.

You are given the option to have an alternating row background color be given to the rows (in all thread tables) to make reading each row easier. You may choose either not to have the alternating backgrounds at all, to have them only for your managers who will benefit more from them because of thread selections while managing the list, and for everyone to see them. An HTML color piker allows you to choose this alternate background color.

"Featured Threads" Icon

You may choose to display an image icon for the featured threads in several places. You are given a choice of 5 included icons, or you may upload your own and give its filename in the settings. You must upload your custom icon to the "markfl_featuredthreads/icons" folder. The icons are appropriately sized depending on the location they are displayed.

If you choose to use an icon, then they are displayed in the thread listing when viewing forums, to the immediate right of the thread titles for those threads in the featured threads list.



Support for this product can be found here:

• MHB - Featured Threads
• TAZ - Featured Threads

(continued in post #2)

[hazem_aliraqi]

thank u mark that was awesome installed and 5 stars

Q \ can i get the number (count) of the Featured Threads for each user ?

and add the count to postbit ?

[jagtpf]

Originally Posted by jagtpf

Line 1394 seems to be pointing at the 'if statement'.

The database in config.php is set to mysql - and everything else, Live and Test are running OK with this setting.

just discovered through diagnostics that vBulletin (admincp) has advised :
class_core.php

File does not contain expected contents!

[MarkFL]

Originally Posted by jagtpf

just discovered through diagnostics that vBulletin (admincp) has advised :
class_core.php

Did you upload a fresh version of that file and now everything works?

[MarkFL]

Originally Posted by hazem_aliraqi

thank u mark that was awesome installed and 5 stars


Q \ can i get the number (count) of the Featured Threads for each user ?

and add the count to postbit ?

I sort of already have this, if you set "Recognize "Featured Threads" Authors In Postbits/Profiles" to "Yes" in the "Icons" section of the settings. The icon has a tooltip that indicates how many "Featured Threads" the user has authored.

[ikopylov]

Hi Mark!
Minor bugs in mod Featured Threads v1.9.7

1
Replase all phrases to {vb:rawphrase vb_standart_phrase}
This is for non English forums

2
Find and replase
<br> ==> <br />
<img src="' . $icon . '">'; ==> <img src="' . $icon . '" alt="" />';
<input bla-bla-bla> ==> <input bla-bla-bla />
<hr></hr> ==> <hr />


3
This is for forums with UTF8:

$preview = substr($firstpost['pagetext'], 0, $vbulletin->options['threadpreview']);

==>

$preview = iconv_substr($firstpost['pagetext'], 0, $vbulletin->options['threadpreview'], 'UTF-8');

next

$forum_trunc = strlen($forum_name) > $forum_length ? substr($forum_name,0,$forum_length) . "...": $forum_name;

==>

$forum_trunc = strlen($forum_name) > $forum_length ? iconv_substr($forum_name,0,$forum_length, 'UTF-8') . "...": $forum_name;

4
Some forums have a short URL:
Member, Forum, Thread

return '<a title="' . $title . '" href="member.php?' . $user_name['userid'] . '-' . $user_name['username'] . '" target="_blank">' . $open_tag . $user_name['username'] . $close_tag . '</a>';

==>

return '<a title="' . $title . '" href="member.php?u=' . $user_name['userid'] . '" target="_blank">' . $open_tag . $user_name['username'] . $close_tag . '</a>';

next

$thread .= '<a title="' . get_thread_preview($threadinfo['firstpostid']) . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="showthread.php?' . $threadinfo['threadid'] . '-' . str_replace(' ', '-', $threadinfo['title']) . '">' . $threadinfo['title'] . '</a>';

==>

$thread .= '<a title="' . get_thread_preview($threadinfo['firstpostid']) . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="showthread.php?t=' . $threadinfo['threadid'] . '">' . $threadinfo['title'] . '</a>';

next

return '<td style="border-right: ' . $vbulletin->options['markfl_ft_border'] . '"><a title="' . $ftitle . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="forumdisplay.php?' . $ftthread['forumid'] . '-' . str_replace(' ', '-', $vbulletin->forumcache[$ftthread['forumid']]['title'])  . '">' . $forum_trunc . '</a></td>';

==>

return '<td style="border-right: ' . $vbulletin->options['markfl_ft_border'] . '"><a title="' . $ftitle . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="forumdisplay.php?f=' . $thread['forumid'] . '">' . $forum_trunc . '</a></td>';

[MarkFL]

Originally Posted by ikopylov

Hi Mark!
Minor bugs in mod Featured Threads v1.9.7

1
Replase all phrases to {vb:rawphrase vb_standart_phrase}
This is for non English forums

2
Find and replase
<br> ==> <br />
<img src="' . $icon . '">'; ==> <img src="' . $icon . '" alt="" />';
<input bla-bla-bla> ==> <input bla-bla-bla />
<hr></hr> ==> <hr />


3
This is for forums with UTF8:

$preview = substr($firstpost['pagetext'], 0, $vbulletin->options['threadpreview']);

==>

$preview = iconv_substr($firstpost['pagetext'], 0, $vbulletin->options['threadpreview'], 'UTF-8');

next

$forum_trunc = strlen($forum_name) > $forum_length ? substr($forum_name,0,$forum_length) . "...": $forum_name;

==>

$forum_trunc = strlen($forum_name) > $forum_length ? iconv_substr($forum_name,0,$forum_length, 'UTF-8') . "...": $forum_name;

4
Some forums have a short URL:
Member, Forum, Thread

return '<a title="' . $title . '" href="member.php?' . $user_name['userid'] . '-' . $user_name['username'] . '" target="_blank">' . $open_tag . $user_name['username'] . $close_tag . '</a>';

==>

return '<a title="' . $title . '" href="member.php?u=' . $user_name['userid'] . '" target="_blank">' . $open_tag . $user_name['username'] . $close_tag . '</a>';

next

$thread .= '<a title="' . get_thread_preview($threadinfo['firstpostid']) . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="showthread.php?' . $threadinfo['threadid'] . '-' . str_replace(' ', '-', $threadinfo['title']) . '">' . $threadinfo['title'] . '</a>';

==>

$thread .= '<a title="' . get_thread_preview($threadinfo['firstpostid']) . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="showthread.php?t=' . $threadinfo['threadid'] . '">' . $threadinfo['title'] . '</a>';

next

return '<td style="border-right: ' . $vbulletin->options['markfl_ft_border'] . '"><a title="' . $ftitle . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="forumdisplay.php?' . $ftthread['forumid'] . '-' . str_replace(' ', '-', $vbulletin->forumcache[$ftthread['forumid']]['title'])  . '">' . $forum_trunc . '</a></td>';

==>

return '<td style="border-right: ' . $vbulletin->options['markfl_ft_border'] . '"><a title="' . $ftitle . '" style="color: ' . $vbulletin->options['markfl_ft_linkcolor'] . '; ' . $vbulletin->options['markfl_ft_linkformat'] .'" href="forumdisplay.php?f=' . $thread['forumid'] . '">' . $forum_trunc . '</a></td>';

1.) Using phrasing (a HUGE task) is on my to-do list. It could be a while before I can get to it.

2.) Those slashes add no functionality to HTML and are not necessary.

3.) I will eventually look into adding UTF-8 encoding functionality. I'm learning as I go.

4.) I tried giving URLs that are the most standard, and play nicely with SEO mods.

[ikopylov]

1.
It is very necessary. Put it at 1st line in you TODO list. )))

2.
If we used the specification DOCTYPE HTML it would be appropriate to use <br>
But in VB we use specification DOCTYPE XHTML in this case it is necessary to use <br />, <hr />, <input />, <img /> and then the code is valid

3.
php substr() function with utf-8 leaves "�" marks at the end before "..."
I showed how to solve this little problem

4.
Maybe you can add settings option SEO link | Standard Link

[jagtpf]

Originally Posted by MarkFL

Did you upload a fresh version of that file and now everything works?

To be honest, I haven't. Reason being that the Live and Test Forums run perfectly well with the file as it is.
Your Mod seems to be the first instance of something not totally right.

But I'll give it a try and, obviously, let you know.

Many thanks for your kind work and patience on helping.

One food for thought as an enhancement could be options to create more than one variety of nomination? Similar to DBTechs vBnominate...


EDIT : Sorry Mark - have updated the class_core.php file (test forum) - diagnostics clears as OK - but the error continues.

[MarkFL]

Originally Posted by jagtpf

To be honest, I haven't. Reason being that the Live and Test Forums run perfectly well with the file as it is.
Your Mod seems to be the first instance of something not totally right.

But I'll give it a try and, obviously, let you know.

Many thanks for your kind work and patience on helping.

One food for thought as an enhancement could be options to create more than one variety of nomination? Similar to DBTechs vBnominate...


EDIT : Sorry Mark - have updated the class_core.php file (test forum) - diagnostics clears as OK - but the error continues.

From what I gather from the code you posted, the error has to do with a query...but I don't know which one(s), as there are many queries in this product. What version of vB/PHP/MySQL are you running?

[jagtpf]

Originally Posted by MarkFL

From what I gather from the code you posted, the error has to do with a query...but I don't know which one(s), as there are many queries in this product. What version of vB/PHP/MySQL are you running?

(Don't forget I'm only running (!) this on my test Forum via xampp; so there might - probably - possibly be fewer/no issues on the Live).

vB 4.2.3 C1

PC - test Forum
Server Type WINNT
Web Server Apache v2.4.17
PHP 5.6.15
MySQL Version 10.1.9-MariaDB
MySQL Packet Size 1.00 MB

Live Forum
Server Type Linux
Web Server Apache
PHP 5.6.16
MySQL Version 5.6.28
MySQL Packet Size 256.00 MB