Major Additions - vbBux / vbPlaza v1.5.8 (Points + Store System)

vbBux / vbPlaza v1.5.8 by CMX (http://www.cmgsccc.com)
Official Homepage - http://www.vbplaza.com

v1.5.7 AND HIGHER are now compatible with vBulletin v3.5.x and v3.6.x

Welcome to the largest points/store system for vBulletin! READ THE ENTIRE POST AGAIN AS THERE HAVE BEEN CHANGES SINCE THE CONVERSION TO vbBux / vbPlaza!!

Credits: MrZeropage for ibProArcade Support, John for v3 Arcade Support, Caimakale for various additions including ribbons and his other addons for vbPlaza, defi for the addon for Paypal Subscriptions.

New Premium Modification Forum: https://vborg.vbsupport.ru/forumdisplay.php?f=171
If you post a new thread in there, it will be easier to track the answer to your thread folks!

Now with 135 Options for purchasing at your forums and this is still rising folks!

NOTE: As of this version, there is a Template Patcher helper inside the Admin CP. Admin CP -> vbPlaza Maintenance -> Auto Patch Templates, when you run this the first time, it will just list the changes that it has found/not found. If you press Attempt Auto Patches, it will modify the template changes it has found only. It will also modify all styles for your forums. I have tested this on all 3 of my licensed vBulletin production websites and the patches all worked great.

UPDATED MUST READ NOTES:
1) RE-READ THE UPGRADING OR NEW INSTALLATION INSTRUCTIONS AS THEY HAVE CHANGED FROM THE PREVIOUS VERSIONS!!
2) IF UPGRADING FROM A PREVIOUS VERSION OF eBux / eStore. YOU MUST INSTALL THIS ONE FIRST TO SAVE YOUR SETTINGS. (BUT YOU WOULD KNOW THIS IF YOU READ THE UPGRADING INSTRUCTIONS!! DONT SAY I DIDNT WARN YOU!!)

Branding Free Option
If you have donated in the past, you can get the Branding Free Option for Free by sending CMX a PM on the http://www.vbplaza.com/forums Message Board.
Otherwise, you will need to purchase it by signing up for an account at http://www.vbplaza.com/forums/register.php and then going to http://www.vbplaza.com/forums/payments.php

Features List:
This section has been moved due to its length. Look in the file included insize the zip named features.txt.

Release Notes:
This section will only show the most recent changes. For the rest of the changes, look in the file included inside the zip named changes.txt.

NOTE: If you want ibProArcade, v3 Arcade or vBookie integration now, you'll have to install the appropriate Addon included in the download. The reason for these parts being packaged as Addons, is to make the install a little smaller for users who do not have an Arcade, and because both Arcades cant be installed simultaneously as well. So it saves space only installing the one that you currently have.

v1.5.8 Updates:
1) Bugfix: Quick editing a post with BB Codes, modified the post directly instead of modifying a copy.
2) Bugfix: Some phrases fixed.
3) Bugfix: TABLEPREFIX bug has been fixed.
4) Bugfix: Addon Product XML sheets do not have executionorder in them anymore for vB 3.5 compatibility.

Database Backups Recommended!
Although I have upgraded 3 forums with this script already, it IS recommended that you backup your database before installing this product!!

Upgrading Instructions:
NOTE: THESE INSTRUCTIONS ARE FOR UPGRADING IF YOU HAD A PREVIOUS VERSION OF eBux / eStore INSTALLED!!
1) DO NOT UNINSTALL eBux / eStore (UNLESS YOU WANT TO LOSE ANY AND ALL SETTINGS.)
2) Reupload all of the files in the upload folder to your forum's root folder. Make sure that all files are being overwritten. Do not move on to the next step until all files are transferred successfully!
NOTE: It could take a long time to install if you have a lot of registered users, be PATIENT! It should display the messages as it goes along to let you know that it IS working.
3) After finished with step 2!! Reimport the product-vbbuxplaza.xml file via Admin CP -> Plugin System -> Manage Products -> Add/Import Product. Make sure that Allow Overwrite is set to YES.
4) Refresh the Admin CP and you will see all of the vbBux / vbPlaza Admin CP features at the top.
5) UNINSTALL THE OLD eBux / eStore NOW!! Go to Admin CP -> Plugin System -> Manage Products -> eBux / eStore -> Uninstall.
6) You can delete all files/folders that have the word estore or elottery in them from the FTP as well.
7) You will need to redo the template edits listed below as almost all of them have changed since the previous eBux / eStore.

If upgrading from a previous version of vbBux / vbPlaza follow these instructions:
1) Reupload all of the files in the upload folder to your forum's root folder. Make sure that all files are being overwritten. Do not move on to the next step until all files are transferred successfully!
2) After finished with step 2!! Reimport the product-vbbuxplaza.xml file via Admin CP -> Manage Products -> Add/Import Product. Make sure that Allow Overwrite is set to YES.
3) Refresh the Admin CP and get to checking your settings!
NOTE: You will be happy know that NO templates have been updated from v1.5.0 to v1.5.2!

New Installation Instructions:
1) Upload all of the files/folders in the UPLOAD folder to your forum's root folder.
2) Import the product-vbbuxplaza.xml via Admin CP -> Manage Products -> Add/Import Product.
NOTE: It could take a long time to install if you have a lot of registered users, be PATIENT! It should display the messages as it goes along to let you know that it IS working.
3) Refresh the Admin CP and start setting up your settings!
4) You will need to do all of the template edits listed below as well.

Template Edits:
A) Inside templates 'postbit' AND 'postbit_legacy':

Find:

<div id="postmenu_$post[postid]">

Replace With:

<!-- vbPlaza start -->
<div id="postmenu_$post[postid]" <if condition="$post['namestyle']">style="$post[namestyle]"</if>>
<!-- vbPlaza end -->

Next Find:

<if condition="$post['usertitle']"><div class="smallfont">$post[usertitle]</div></if>

Replace With:

<!-- vbPlaza start -->
<if condition="$post['usertitle']"><div class="smallfont" <if condition="$post['titlestyle']">style="$post[titlestyle]"</if>>$post[usertitle]</div></if>
<!-- vbPlaza end -->

Then Find:

$vbphrase[posts]: $post[posts]

Replace With:

$vbphrase[posts]: $post[posts]
<!-- vbPlaza start -->
<if condition="$show['pointsinpostbit']"><br />
$vbphrase[vbbux_points]: $post[points]<br />
$vbphrase[vbbux_bank]: $post[bank]<br />
<phrase 1="$vbphrase[vbbux_points]">$vbphrase[vbbux_total_points]</phrase>: $post[totalpoints]<br />
<a href="vbplaza.php?do=donate&amp;userid=$post[userid]">$vbphrase[vbplaza_donate]</a><br />
</if>
<!-- vbPlaza end -->

Then Find:

				<div>$post[icqicon] $post[aimicon] $post[msnicon] $post[yahooicon] $post[skypeicon]</div>

Add Below:

<!-- vbPlaza start -->
				<if condition="$post['giftsdisplay']"><div class="smallfont">$post[giftsdisplay]</div></if>
				<if condition="$post['ribbonsdisplay']"><div class="smallfont">$post[ribbonsdisplay]</div></if>
<!-- vbPlaza end -->

B) Inside template 'navbar':

Find:

		<td class="vbmenu_control"><a href="calendar.php$session[sessionurl_q]">$vbphrase[calendar]</a></td>
		<if condition="$show['popups']">

Add Below:

<!-- vbPlaza start -->
			<if condition="$show['member']">
				<if condition="$vboptions['vbplaza_enabled']"><td id="vbplazamenu" class="vbmenu_control"><a href="$show[nojs_link]#vbplazamenu">$vbphrase[vbplaza_name] $vbphrase[vbplaza_menu]</a> <script type="text/javascript"> vbmenu_register("vbplazamenu"); </script></td></if>
			</if>
<!-- vbPlaza end -->

Then Find:

<!-- / NAVBAR POPUP MENUS -->

Add Above:

<!-- vbPlaza start -->
	<if condition="$show['member']">
	<!-- vbplaza tools menu -->
	<div class="vbmenu_popup" id="vbplazamenu_menu" style="display:none">
		<table cellpadding="4" cellspacing="1" border="0">

		<tr><td class="thead"><a href="vbplaza.php?$session[sessionurl]">$vbphrase[vbplaza_name] $vbphrase[vbplaza_main]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=48">$vbphrase[vbplaza_lottery]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=27">$vbphrase[vbplaza_give_gifts]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=118">$vbphrase[vbplaza_give_ribbons]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=13">$vbphrase[vbbux_bank]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=7">$vbphrase[vbplaza_donate]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=16">$vbphrase[vbplaza_thief]</a></td></tr>

		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=richestusers">$vbphrase[vbbux_richest_users]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=userhistory">$vbphrase[vbplaza_history]</a></td></tr>
		<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=mostsold">$vbphrase[vbplaza_most_sold]</a></td></tr>

		<if condition="is_member_of($vbulletin->userinfo, $vboptions['vbplaza_adminusergroups'])">
			<tr><td class="thead">$vbphrase[vbplaza_admin_only]</a></td></tr>
			<tr><td class="vbmenu_option"><a href="vbplaza.php?$session[sessionurl]do=action&amp;itemid=12">$vbphrase[vbplaza_admin_donate]</a></td></tr>
		</if>

		</table>
	</div>
	<!-- / vbplaza tools menu -->
	</if>
<!-- vbPlaza end -->

C) Inside template 'MEMBERINFO':

Find:

				<div class="bigusername">$userinfo[musername] $userinfo[onlinestatus]</div>

Replace With:

<!-- vbPlaza start -->
				<div class="bigusername" <if condition="$userinfo['namestyle']">style="$userinfo[namestyle]"</if>>$userinfo[musername] $userinfo[onlinestatus]</div>
<!-- vbPlaza end -->

Next Find:

				<if condition="$userinfo['usertitle']"><div class="smallfont">$userinfo[usertitle]</div></if>

Replace With:

<!-- vbPlaza start -->
				<if condition="$userinfo['usertitle']"><div class="smallfont" <if condition="$userinfo['titlestyle']">style="$userinfo[titlestyle]"</if>>$userinfo[usertitle]</div></if>
<!-- vbPlaza end -->

Then Find:

			<if condition="$vboptions['usereferrer']">

Add Above:

<!-- vbPlaza start -->
			<if condition="$vboptions['vbbux_enabled']">$show[vbbuxuserinfo]</if>
			<if condition="$show['gifts']">$show[gifts]</if>
			<if condition="$show['ribbons']">$show[ribbons]</if>
<!-- vbPlaza end -->

D) Inside template 'forumrules':

Find:

		<div><phrase 1="$htmlcodeon">$vbphrase[html_code_is_x]</phrase></div>

Add Below:

<!-- vbPlaza start -->
		<if condition="$vboptions['vbbux_enabled']">
			<if condition="!$show['codeonly']">
			<hr />
			<div><phrase 1="$vbphrase[vbbux_points]" 2="$foruminfo[points_perview]">$vbphrase[vbbux_points_perview]</phrase></div>
			<div><phrase 1="$vbphrase[vbbux_points]" 2="$foruminfo[points_perthread]">$vbphrase[vbbux_points_perthread]</phrase></div>
			<div><phrase 1="$vbphrase[vbbux_points]" 2="$foruminfo[points_perreply]">$vbphrase[vbbux_points_perreply]</phrase></div>
			</if>
		</if>
<!-- vbPlaza end -->

E): Inside template 'USERCP_SHELL':

Find:

<if condition="$show['avatarlink']">

Add Above:

<!-- vbPlaza start -->
<if condition="$vboptions['vbplaza_enabled']">
	<tr>
		<td class="$navclass[vbplaza]" nowrap="nowrap"><a class="smallfont" href="vbplaza.php?$session[sessionurl]do=editvbpoptions"><phrase 1="$vbphrase[vbplaza_name]">$vbphrase[edit_vbplaza_options]</phrase></a></td>
	</tr>
</if>
<!-- vbPlaza end -->

F): Inside template 'threadbit':

Find:

		$thread[title_editable]
		<div>

Replace With:

<!-- vbPlaza start -->
		$thread[title_editable]
		<div <if condition="$thread['titlestyle']">style="$thread[titlestyle]"</if>>
<!-- vbPlaza end -->

vBulletin 3.5.x Only Edit:

Next Find:

			<if condition="$show['gotonewpost']">
				<strong><a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]">$thread[threadtitle]</a></strong>
			<else />
				<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]">$thread[threadtitle]</a>
			</if>

Replace With:

<!-- vbPlaza start -->
			<if condition="$show['gotonewpost']">
				<strong><a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]" <if condition="$thread['titlestyle']">style="$thread[titlestyle]"</if>>$thread[threadtitle]</a></strong>
			<else />
				<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]" <if condition="$thread['titlestyle']">style="$thread[titlestyle]"</if>>$thread[threadtitle]</a>
			</if>
<!-- vbPlaza end -->

vBulletin 3.6.x Only Edit:

Next Find:

			<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]"<if condition="$show['gotonewpost']"> style="font-weight:bold"</if>>$thread[threadtitle]</a>

Replace With:

			<a href="showthread.php?$session[sessionurl]t=$thread[threadid]$thread[highlight]" id="thread_title_$thread[realthreadid]"<if condition="$thread['titlestyle']">style="$thread[titlestyle]"</if>>$thread[threadtitle]</a>

G): Inside template 'memberlist_resultsbit':

Find:

		<a href="member.php?$session[sessionurl]u=$userinfo[userid]">$userinfo[musername]</a>
		<if condition="$show['usertitlecol']"><div class="smallfont">$userinfo[usertitle]</div></if>

Replace With:

<!-- vbPlaza start -->
		<div <if condition="$userinfo['namestyle']">style="$userinfo[namestyle]"</if>><a href="member.php?$session[sessionurl]u=$userinfo[userid]" <if condition="$userinfo['namestyle']">style="$userinfo[namestyle]"</if>>$userinfo[musername]</a></div>
		<if condition="$show['usertitlecol']"><div class="smallfont" <if condition="$userinfo['titlestyle']">style="$userinfo[titlestyle]"</if>>$userinfo[usertitle]</div></if>
<!-- vbPlaza end -->

-CMX

[amykhar]

Sooner's problem with the userid is fixed. To fix it, I had to go in as another admin - I registered a new account and then made it an admin by changing the database since it was his admin account that was hosed.

As the other admin, I cleared the estore history. Then, I set his admin account back to the correct usergroup, and he was good to go.

[Sooner95]

Originally Posted by amykhar

Sooner's problem with the userid is fixed. To fix it, I had to go in as another admin - I registered a new account and then made it an admin by changing the database since it was his admin account that was hosed.

As the other admin, I cleared the estore history. Then, I set his admin account back to the correct usergroup, and he was good to go.

Big time thx Amy. Noted for future issues as well.

[MustangLisa]

Originally Posted by WolfsongNevan

Thank you SO much for all your AWESOME support, seriously.

Just one quick thing (but a big thing to our members) that I didn't see answered .... will the "hover" over gifts (which will show the gift giver's name and message) be added?

Also, you said in reply to my question about missing gifts (in the threads, not in the profile like you mentioned) that it will not show 2 of the same gifts ... would it be possible to make this an option in a future update? We have a board full of ladies that are VERY into the gifts and are disappointed that their gifts aren't showing up in the threads ... especially since there is a only a small selection of gifts at this time (working on adding more ). The rose and bouquet are popular gifts in our forum and because of this, members are getting multiples of them from different members, but can't see them.

Off to donate to PayPal because I am just so completely impressed with your dedication to this project. (no kissing up intended)

Ditto ... my members would love that and I'll donate for it. Thanks for all your hard work on this!!

[Frugal]

Originally Posted by kylek

Frugal - maybe you could include the functions_vbookie.php file in your post, a lot easier for people who are not too sure of what to do.

Yes I thought about that last night but as it was something like 3am when I made the post and I had to get up for work at 7am and lordofgun had already attached the file I decided to make sure the instructions were adequate then hit the sack. I'll drop a pm to the author of vbookie and ask him for permission to post an edited version and once I have his ok I'll attach the file.

Frugal

[Frugal]

Originally Posted by caimakale

If I made a hack calling the ebux field from the user table it wouldn't find it because you have it renamed to ucash. It would have to be a pretty big hack to do that as most hacks will use the functions CMX has built in, but nonetheless it is a possibility.

Hehe anything is possible, but as you say the points field is a user configurable variable, it is not hard coded so one would hope any hacker worth his salt would use the built in functions rather than hard coding it when CMX designed it to be user configurable. However in the event of a fantastic but hard coded hack being released it is just 1 query and the field is again called eBux. Of course until that day I can use several hacks with ebux that were designed for ucash, as well as vbookie I also use the league system that uses the ucash points field.

Mind you, I never really intended to get into a debate on the merits of file editing vs sql queries, which is best is down to the needs and preferences of the individual forum owner. I originally suggested the file edit method on page 24 and when the guy had no success I posted the sql query on page 25 which got him up and running, as lots of others have reported success with those instructions I continued to favour the sql method. My only motivation was to help those wanting to integrate vbookie and eBux and now that there is a comprehensive post giving both options we should find less people having difficulty in this area.

Thanks for your input though, it is always good to have the pro's and cons from many sources so that people can make an informed choice about which method suits them best.

Frugal

[caimakale]

Originally Posted by MustangLisa

Ditto ... my members would love that and I'll donate for it. Thanks for all your hard work on this!!

It's actually not very hard to do, but as CMX said, it does run more queries on every page load.

Right now the ribbons hack does that and I am looking into (as is CMX) a way to serialize the ribbons hack into the user table. I will have to clear the estore_ribbons in the users table, and then read and serialize the data in the current ribbons table and then store it in estore_ribbons that I initially cleared. After that I want to then re-use the ribbons table to store the ribbon color and cause, so that they can be edited/deleted/added via the admincp. The current method has everything hard coded in the files.

As I have never serialized anything before, I did start reading up on it last night. But who knows when I will actually finish everything.

[Frugal]

Originally Posted by chairman miaow

Frugal - thanks for this - it was getting confusing with all the different stuff being quoted about vBookie....mine works perfectly with ebux now.

Glad I could be of help, as you can see by my 50 odd posts in 4 and a bit years (most of which are in this thread) I'm not a big poster but I was inspired by the level of support that CMX has given in this thread and figured that if I could do my little bit I should.

Frugal

[EasyTarget]

is anyone else having the issue that the users' status icon is being moved to a new line?

also earlier today I was being redirected to a do=expireoptions url but I would get the message no input file specified. I upgraded from 1.1.1.1 to 1.1.2 and I don't seem to have that issue now.

[bashy]

Hi Frugal

I have followed your instuctions....
I did have the vbookie edit in there, now removed and added what you said

I have a : on its own...see below

This is copied from my postbit

Points: 26,759.00
Bank: 721.14
: <<<<<<<<<<there
Thanks: 9

What is the : any ideas please?

Originally Posted by Frugal

You also need to make sure your template edit is for ebux not vbookie, the vbookie postbit template edit only shows vbookies own money vCash.

In the postbit after

$vbphrase[posts]: $post[posts]

You should have

<br />
<a href="estore.php?do=donate&amp;userid=$post[userid]">$vbphrase[ebux_points]</a>: $post[points]<br />
$vbphrase[ebux_bank]: $post[bank]<br />
$vbphrase[ebux_total_points]: $post[totalpoints]<br />

You should not have

<if condition="$vboptions['vbookiecashon']">
						<br />vCash: $post[vbookie_cash]
						</if>

Providing ebux is set to use the field ucash, the query has been run to change the ebux field to ucash, vbookie has been set to use ucash, and the postbit has the ebux changes and not the vbookie changes, all should work.

Frugal

[Frugal]

Originally Posted by bashy

Hi Frugal

I have followed your instuctions....
I did have the vbookie edit in there, now removed and added what you said

I have a : on its own...see below

This is copied from my postbit

Points: 26,759.00
Bank: 721.14
: <<<<<<<<<<there
Thanks: 9

What is the : any ideas please?

At a guess it looks like you are using a version of eBux earlier than 1.1.2

The total points field and phrase was added in 1.1.2 which is why it shows as just : on your forum. You can either upgrade to 1.1.2 or remove this line from your postbit until you upgrade.

$vbphrase[ebux_total_points]: $post[totalpoints]<br />

Frugal