The Arcive of Official vBulletin Modifications Site.

About Developer · **Released**: 01-03-2014

Hey vB.org

This is my first hack and I hope this increases your site activity/engagement/traffic. All your suggestions will be taken into account and will be 100% supported, so don't hesitate to post here. EASY INSTALL!

Feedbacks HIGHLY APPRECIATED.

What is Ranker?
Ranker is a popular platform used by millions of people, that utilizes the wisdoms of crowds to deliver the best opinions possible about any topic where a list is the best answer. Anyone can participate simply by voting or reranking lists, and the more who do, the better the ranking gets. Our ranking algorithms have been honed by years of testing and study, and we have protections against gaming the system. Ranker has been featured on popular media like Forbes Magazine

What is the Ranker Widget:
The ranker widget is an embeddable list that livens up your forum content with a fun, votable list.

See the Ranker Widget in action:
http://personalitycafe.com/general-c...-emotions.html
http://community.ranker.com/babes-pa...red-heads.html

Popular Brands Using the Widget:
Forbes
Canadian Broadcasting Corporation
NextWeb
Movies.com
Complex.com
Spoilertv.com
SBNation
and more!

How the Ranker Poll Differs from vBulletin Poll

More engaging than a typical poll (Ability for users to add items after being published)
Offers more data points
Up and Down Voting.
Images next to the items
More customizations and options
Reach additional users from Ranker.

How Ranker helps your Forum/Site
Ranker?s free widget is a fun way to add a unique poll to your site.

Increase user engagement

Websites that use the widget report see 15-50% user engagement on each poll and a time-on-page increase of 70%.

Easy to install

It's as easy to install as a YouTube embed!

More comments more return visits

These polls inspire passionate discussion and return visits to see if the rankings change, and sites that post polls as blog posts see 125% more comments than a typical post.

Rich data on your users

If you make regular lists for your users to vote on, we can provide you with rich data on your users' preferences.

More exposure for your site

Your list will also be featured on Ranker.com with custom branding and a link back to your site. This is the referral traffic my site PersonalityCafe has been getting from Ranker from the past month:

Check out the article SEO Link Building with Ranker - http://pointblankseo.com/ranker-link-building

Installation

Enable for your users

Download the xml file attached to this post
Go to your Admincp -> Plugins & Products -> Manage Products -> Add/Import Product
To modify the Widget Width and # Items to display, go to Admincp -> Settings -> Options -> Ranker Widget Embedding

Creating a List and Embedding

Go to Ranker.com
Create an account
Create a List
After creating a list, click on the More Options -> Embed This List -> Click Get Started -> Once done customizing, click Done.
While making a new post/thread, paste the Embed Code into the editor.
Refresh the page after posting. Congrats! You now know how to embed a list.
Here's a visual onhow to embed a Ranker List on your forum.

Embedding List to Forum Block (Like http://personalitycafe.com/forum/)

Go to your Admincp -> Forums & Moderators -> Forum Blocks Manager -> Add Block -> Choose Custom HTML/PHP
Title Your Block
Under Content Type Choose "HTML"
Paste the Ranker Widget Code into the "Content" form.
Save

profanitytalker · #2 01-04-2014, 03:58 AM

Embedding A List

Step 1: Go on the list page.

Step 2: Click on More Options

Step 3: Click on Embed This List

Step 4: Click Get Started

Step 5: Once done customizing, click Done.

Step 6: Copy the embed code.

Step 7: While making a new post/thread, paste the Embed Code into the editor.

Step 8 (Final): Refresh the page after posting. Congrats! You now know how to embed a list.

BirdOPrey5 · #3 01-05-2014, 01:06 PM

By default HTML in posts is disabled in VB4/VB3 and so pasting HTML code into a post won't work.

[s]Enabling HTML can only be done (be default) on a per-forum basis so it is extremely dangerous to enable HTML is any forum untrusted users can post in. If you do enable HTML in a forum then please make sure only you or very trusted Admins have permission to post in said forums.[/s]

Edit- See explanation in next post.

profanitytalker · #4 01-06-2014, 12:18 AM

Quote:

Originally Posted by BirdOPrey5

By default HTML in posts is disabled in VB4/VB3 and so pasting HTML code into a post won't work.

Enabling HTML can only be done (be default) on a per-forum basis so it is extremely dangerous to enable HTML is any forum untrusted users can post in. If you do enable HTML in a forum then please make sure only you or very trusted Admins have permission to post in said forums.

Hmmm? This mod/plugin doesn't require you to enable HTML on the forum. It automatically converts the Ranker embed code into a tag.

T2x · #5 01-06-2014, 06:35 PM

The mod apparently looks for ranker embed codes when posts are made and pulls out a few variables then generates a bb code tag which vbulletin automatically sanitizes.

When parsing the post for bbcode, if the user has image posting permissions it will generate this code

PHP Code:


			
'<a role="link" class="rnkrw-widget" data-rnkrw-id="'.intval($matches[1]).
'" data-rnkrw-width="'.$rankerwidgetwidth.'" data-rnkrw-rows="'.$rankernumitems.
'" href="'.htmlspecialchars_uni($matches[2]).'">'.htmlspecialchars_uni($matches[3]).
'</a><script id="rnkrw-loader" type="text/javascript" async="true" src="//widget.ranker.com/static/rnkrw2.js"></script>
<script>var RNKRW = RNKRW || {};RNKRW.pref = {"header":{"image":true}};</script>'

I can also see they are preventing xss injection in the href attribute by validating that the url conforms to this regex:

Code:

https?:\/\/www\.ranker\.com\/[a-z0-9\-\/_]+

Alan_SP · #6 01-06-2014, 07:21 PM

It would be great if you could make something like this (c&p from my request here: http://ozzmodz.com/showthread.php/53...m-with-threads)

Quote:

Originally Posted by Alan_SP

There was "mod" (now I see it's deleted) that mentioned integration with

Code:

http://www.ranker.com/

This site enables creating different lists, and users can vote in those lists, reranking them, adding items and many other things. Also, and this is reason why it could be useful, this mods allow that we easily create HTML 5 widget from each list.

If we could have list on first post (that's why I'm looking for good mod to do that), or even better, have widget to the right (or left), like sidebar in vB4 (but we can't actually use sidebar, as each thread should be connected to different Ranker.com's list), it would be great.

Anyway, my first option is to use mod that enables first post visible on every page. Even better, if we could have sidebar version.

Mod should connect widget code with each thread ID, show widget right (or left) of thread content and thus enable users to vote in a widget and to write in a thread.

This is how I envision it:

We could enable this mod only in certain forums. Only certain usergroups would be able to enter widget code, as it is HTML (preferably that we could use HTML 5 code in that), for security reasons.

After that, mod would show "normal" thread, with widget to the side, users would vote in a widget, write in a thread and we all be happy to the rest of our lives.

I hope you would make it into mod, I think this has great potentials.

My further explanation in different thread:

Quote:

Originally Posted by Alan_SP

Here you can see Ranker.com's widgets: http://www.ranker.com/widget/info.htm?ref=more

They are very vertical oriented, as you can see.

Imagine that thread is linked with certain list (term used on Ranker.com), i.e. we can see that Ranker.com widget of this certain list only when viewing this thread.

This widget is placed like sidebar in vB4, but only in threads, independently from sidebars. To link list (widget) and thread, we put widget code in form and it than changes postbit in such way that thread is narrowed making place for widget. Thread otherwise acts like normal thread, but displays widget left or right from thread.

And we can choose in which forums and which usergroups can enter widget code.

More or less, that's it in a nutshell.

It would make great integration and lists would be easily seen on every page of the thread all the time.

profanitytalker · #7 01-06-2014, 09:36 PM

Quote:

Originally Posted by T2x

The mod apparently looks for ranker embed codes when posts are made and pulls out a few variables then generates a bb code tag which vbulletin automatically sanitizes.

When parsing the post for bbcode, if the user has image posting permissions it will generate this code

PHP Code:


			
'<a role="link" class="rnkrw-widget" data-rnkrw-id="'.intval($matches[1]).

'" data-rnkrw-width="'.$rankerwidgetwidth.'" data-rnkrw-rows="'.$rankernumitems.

'" href="'.htmlspecialchars_uni($matches[2]).'">'.htmlspecialchars_uni($matches[3]).

'</a><script id="rnkrw-loader" type="text/javascript" async="true" src="//widget.ranker.com/static/rnkrw2.js"></script>

<script>var RNKRW = RNKRW || {};RNKRW.pref = {"header":{"image":true}};</script>'

I can also see they are preventing xss injection in the href attribute by validating that the url conforms to this regex:

Code:

https?:\/\/www\.ranker\.com\/[a-z0-9\-\/_]+

I appreciate verifying the plugin. Cheers to ya!

:up: We made sure that the plugin is safe to install. I think Birdsofprey was referencing the last post I made (no plugin) where I suggested to enable HTML on the board - which is a big no no.

profanitytalker · #8 01-06-2014, 09:56 PM

Quote:

Originally Posted by Alan_SP

It would be great if you could make something like this (c&p from my request here: http://ozzmodz.com/showthread.php/53...m-with-threads)

My further explanation in different thread:

It would make great integration and lists would be easily seen on every page of the thread all the time.

Ooo. This is interesting. We'll play around and see what we can come up with. So basically a sidebar module within the thread that shows the widget correct?

davidatlas · #9 01-07-2014, 04:30 PM

Hi. I went ahead and installed this on my board. My members love it. Do you know if we can add our own ads to these polls? That would be an interesting concept.

profanitytalker · #10 01-07-2014, 09:54 PM

Quote:

Originally Posted by davidatlas

Hi. I went ahead and installed this on my board. My members love it. Do you know if we can add our own ads to these polls? That would be an interesting concept.

Hi David,

Thanks for trying out the plugin. I think revenue sharing is on the roadmap for the polls. Not sure though. I'll confirm with the developers.

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.15540 seconds Memory Usage 2,351KB Queries Executed 24 (?)
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 (3)bbcode_code (2)bbcode_php (6)bbcode_quote (1)footer (1)forumjump (1)forumrules (1)gobutton (1)header (1)headinclude (1)modsystem_post (1)navbar (4)navbar_link (120)option (1)pagenav (1)pagenav_curpage (2)pagenav_pagelink (10)post_thanks_box (1)post_thanks_box_bit (10)post_thanks_button (1)post_thanks_javascript (1)post_thanks_navbar_search (1)post_thanks_postbit (10)post_thanks_postbit_info (9)postbit (1)postbit_attachment (10)postbit_onlinestatus (10)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 fetch_musername post_thanks_function_fetch_thanks_end post_thanks_function_thanked_already_start post_thanks_function_thanked_already_end postbit_imicons bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete postbit_attachment postbit_display_complete post_thanks_function_can_thank_this_post_start post_thanks_function_fetch_thanks_bit_start post_thanks_function_show_thanks_date_start post_thanks_function_show_thanks_date_end post_thanks_function_fetch_thanks_bit_end post_thanks_function_fetch_post_thanks_template_start post_thanks_function_fetch_post_thanks_template_end pagenav_page pagenav_complete tag_fetchbit_complete forumrules navbits navbits_complete showthread_complete
Messages:

Благодарность от:
BirdOPrey5

The Arcive of Official vBulletin Modifications Site.

It is not a VB3 engine, just a parsed copy!