Major Additions - Point Market System 3.1x

Hack Summary
The Point Market System 3.1 is a stand alone "store" or "shop" hack for vBulletin 4x series. This hack is considered a major addition that allows for you to install one or multiple point systems, activity systems, or currency systems to use points for forum related item enhancements or a virtual/physical store system for your vBulletin forum.

The Point Market is actually four major hacks combined into one. Those five major hacks are a Forum Enhancement Store, A Virtual & Physical Store, a detailed Banking/Payment System, Currency to Point Converter, and a Lottery/Gambling Center. Below is a little bit more about each section.

Forum Item Enhancement Store
The Point Market Forum Item section is what is considered a traditional forum store. You can use a very comprehensive Admin background to be able to sell a variety of forum items that can help enhance a user's enjoyability on the forums. In addition, there are many forum items that a user can purchase for other users. I should also note that a point donation is possible in this section since many point systems do not offer the ability to donate. Below is a listing of the market items & categories:

Forum Items User can Purchase
Market Features (Additional Market Access Features Users Can Purchased)
- Steal Protection
- Gift Market Access
- Stolen Point History
- Donation History
- Gambling Access
- Coupon Access
User Title
- Custom User Title
- User Title Glow
- User Title Color
- Usertitle Strikethrough
Gifts / Awards / Ribbons
- Purchase a Gift
- Create a Gift
User Permissions
- Primary Usergroup Change
- Secondary Usergroup Change
Username Permissions
- Change Username
- Username Color
- Username Glow
- Username Strikethrough
Forum Permissions
- Special Forum Access
- Forum Password Access
- Moderate a Forum
- Change Forum Description
- Create a Forum
Images
- Create Smiley Category
- Upload Smiley
- Upload Avatar
Other Users
- Change Custom User Title
- Gift a Gift
- Donate to Another User
- Steal From a User
- Fire a Moderator
- Change Avatar
Posts
- Post Font Bold
- Post Font Color
- Post Font Face
- Post Font Italics
Threads
- Sticky a Thread
- Delete a Thread
- Color a Thread
- Thread Strikethrough
- Ban a User From a Thread

In addition to these powerful Forum Items, the Point Market has revolutionized the way shop systems can handle charging items. The Point Market allows for all market items above to be charged in two different currencies. That means you could use a combination of any of the supporting point mods to charge for each forum item. Additional features that have been recently been introduced involves the ability to set when these market items expire, allowing for only tempory or permanent purchases. Furthermore, Administrators can choose whether to enable/disable the refund capabilities of these market items as well as individual usergroup permissions that can set individual access, coupon capabilities, and an individual maximum purchase.

Other powerful enhancements to our forum item store system allows for Administrators to set the ability of charging for category access in order to access these market items. This will give the user's one more way to stay active and motivated on accumulating points in order to use them for store purchases. A recently introduced user requested feature also allows for subcategories and the ability to create an unlimited amount of duplicate forum items by using the above market items as a template for a new item. This means you can choose to set different quotos for each market item and can truly personalize your forum item store section.

Bank & Paycheck Center
The Point Market version 3.1x series has done some extreme enhancements to how point banking is now handled. Users have the classic ability to be able to use a bank to store two different point system currencies of the Administrators choosing. These currencies are stored and can accumulate primary usergroup interest that is set during a specified time period by the Administrator. Below is an exact list of Banking features.

Bank Features
- Store Two Currencies that are protected from all steal protection
- Allow for interest to be earned controlled by Administrators on a payout period
- Set minimum/maximum fees (usergroup controlled)
- Set minimum/maximum withdraw and deposit amounts (usergroup controlled)

A main change in the Point Market that makes it so different is the concept of receiving paychecks. Many forums that use point systems want the ability to pay their staff or special usergroups with a paycheck to say thanks as a form of payment. The Point Market gives you the ability to pay users on a specified period by the Administrator. There best part about this paycheck feature is the Admin can choose two different amounts that a user can earn. Admins can choose a set amount that is guarenteed during each pay period OR Administrators can choose for the user to earn a percentage of Point Market Forum Item Sales during a specified period that is defined by their primary usergroup. This allows for staff to become almost salesman like within the Market and can also guarentee a fluxuating paycheck based off of activiity.

Virtual & Physical Online Store
Based off of user demands, the Point Market has created a store system that users can create virtual and physical items and sell it on the website with users using points to purchase these items. Administrators can create an unlimited amount of store items. These items have the ability to:

Store Features
- Purchase an unlimited products by the Admin
- Multiple shipping methods (Email, Mail, Downloadable, No Shipping)
- Control shipping costs if by Mail based off a user's Country
- Up to 5 screenshots uploaded by the Administrator that can be viewed
- Give detailed reviews of products purchased
- Rate products 1 to 5
- Control Quantity of available products
- Coupons Enabled

A designated Administrator will immediately be notified via Private Message of a purchase. From there an Admin can enter the Admin Control Panel and choose to ship the product in whatever method the user chose. A log of this purchase is also available for the user who can view it in their User Purchase history as well as the shipping status of the item.

Point Currency Converter
Sometimes you need to generate actual cash revenue. Many users are willing to purchase points for money. So what better way then to introduce a cash transaction center that will allow for the Administrator to set an amount to charge for a set amount of points? This feature is supported via Paypal and allows for a great income method.

Furthermore, some sites like to use more then two currency systems and the Point Market is designed to meet those needs. Users can be able to select from a specified currency list by the Admin and change points from one system to the next at a fee chosen by the Administrator. This is a pretty convinient method to use every point system possible and allow for user's main goal to be as active as possible so that they can adjust their points to their liking.


Lottery & Gambling
Gambling these days are in high demand and the Point Market has set to address it. The Point Market has created 3 seperate games to allow user's to gamble their points on multiplying their points. Those 3 games are:

- Match The Card
- Higher Card
- Lottery

The Lottery has a built in expiration set by the Administrators and can also be used with coupons for discounts. Massive jackpots can be set at a starting amount or at 0 and an adjustable charge price as well. Administrators can also control the odds of the other two games. Finally a powerful Administrative backend will allow for Admins to see information and statistics related to the lottery.


Other Administrative Features
The Point Market has a series of features in addition to the main 5 hacks that creates the Point Market. The author truly believes the reason the Point Market is truly the best shop system is the easy Admin system combined with the powerful feature capabilities. Below are some of the main Administrative features:

- Advanced individual Administrative Access features (controlled by superadmin)
- Detailed Moderator/Supermoderator Control Panel (features controlled by superadmin)
- Informative statistics related to purchases & activity within the market
- History & Transaction log of all Forum Market Items
- Controllable Coupon creation with pages of advanced controls
- Maintenance section used for debugging purposes and serious updates
- Detailed Gift/Ribbon/Award section
- Banking paycheck creation & transaction history


vBulletin.org Mods This Works With
1) vBExperience (Point Market v3.0+)
2) uCash
3) vBookie
4) Kbank
5) vBCredits Deluxe II
6) vBActivity

Integration With Other Mods
This hack has been intended to be integrated with a 3rd party point system. You can choose to either use a hack added on vBulletin.org or write your own point system. The hack is dependent on the user table having a point/credit/cash field within the user control panel. Please note that vBExperience will only work with the Point Market version 3x series.

In addition, if you do not want to integrate this hack directly with another point system. You can still install this hack and use the reputation field, which will allow user's to purchase items based off of their reputation. I suggest if you choose this option that you set all prices to not include any decimals, as it will be useless and cause unwanted errors.

As of the 3.1x series, the Point Market has begun to create individual forum items related to other modifications offered on vBulletin.org. If you would like your hack to have a special feature &/or capability that can be purchased within the Point Market, just let the developer of this modification know. I will gladly work with any developer to create purchaseable forum items within the Point Market that enhances your modification.


Support Policy
The only available modification that can be downloaded now is the 3.1x alpha/beta series. The reason why I have it marked in such titles is because the bugs that are remaining seem to be very minimal and the product is pretty stable. That being said their are still a few features that have not been scripted and are marked in a lime green color above in my post. Those features still might not correctly function once they are introduced into the beta series of the 3.1x series and users should use some caution. That being said, I will do my best to offer support in this thread. In order to gain support, you must have downloaded the Point Market product and be listed as installed with the latest available version. PLEASE NOTE: if you are having an issue, please provide the following information
- URL to the page you are experiencing problems or a database error
- Primary Point Field name (What point system are you using)
- Secondary Point Field name (What point system are you using
I need to know these in order to fix the majority of problems I need to know this information as there are so many combinations and point systems that can cause different problems, this is the only way I can help replicate an error in order to fix it


IMPORTANT UPGRADE INFORMATION: After you have upgraded from version 1.0.4 to version 2x, please visit the Maintenance section of the Admin CP. Please update the transaction counter and refund counter so that user's information is displayed accurately. Do not use the User Title updater unless you have recently run vBulletin's User Title and Rank Updater in the maintenance section of vBulletin's Admin CP. Please note that only purchases after 2.0.1 is installed can be fixed on the User Title Updater within the Market Admin CP. If you are upgrading to the 3.1x series for the first time, please run the update Maintenance scrippted called Forum Expirations to deal with expired forum items.

Screenshot and release information: To view specific information about the historical releases of the Point Market, please visit this post:
https://vborg.vbsupport.ru/showpost....14&postcount=2
This includes a changelog summary and screenshots of the latest version of the Point Market.

Lastly, I ask all users who install it to kindly click the install button and please rate my product as it is my motivation for future versions of this product.

3.1.0 Gold Release Information
Visit https://vborg.vbsupport.ru/showpost....postcount=1861 for 3.1.0 Gold Release. This Upgrade IS REQUIRED!

The following directories must be chmodded to 777
/customavatars/
/images/smilies/
/images/pointmarket/store/
/pointmarket/downloads/

[bluegoblin7]

Sorry for the double-post, a users just been telling me of some more problems.

He's bought 6 items today, but it's only showing up as two on the Market homepage. One of those is also coloured thread.

Any ideas?

Sorry if I'm not describing myself well enough!

[Centrix]

I think I've asked this twice already and I'd still like to know if this is something you will or would like to implement in the mod.

This is a very interesting mod and I use it too, but I think it would be even better with this implemented.

If you'll consider putting this in I'd be very happy.

Originally Posted by Centrix

Will there be a version where the admin can select which individual items can be purchased by certain usergroups?

I want my normal users to use this too, but I don't want them to have all the features, such as change username color. I only want my VIP members to be able to change their username color (and some other things).

[Magz]

Me agian

When a gift is purchased, a notification is sent, telling user to look in the Gift Market section for more details. Nothing is shown there though, am I missing a setting somewhere?

[bluegoblin7]

And me again, feeling slightly stupid.

Found out what the coloured thread one does now - not what the user expected! It's also applied the change forum wide and seemingly irrevocably - the result being that all my threads are coloured orange.

Please help revert this!

[AtomicAcidbath]

Posting this for the developer.

Buying "Title Change" with two funding sources required (Points & Cash, aka- method 4) throws this database error:

Database error in vBulletin 4.0.4:

Invalid SQL:
update lc_user set  `market_xperience`=1027.00-, market_purchases=market_purchases+1, customtitle='2', usertitle ='MyNewTitle' where userid='1';

MySQL Error   : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ' market_purchases=market_purchases+1, customtitle='2', usertitle ='MyNewTitle' where u' at line 1
Error Number  : 1064
Request Date  : Sunday, July 25th 2010 @ 06:12:38 PM
Error Date    : Sunday, July 25th 2010 @ 06:12:38 PM
Script        : http://76.121.10.37/forum/market.php?do=purchase
Referrer      : http://76.121.10.37/forum/market.php?do=item&id=2
IP Address    : 76.121.10.37
Username      : --------
Classname     : vB_Database
MySQL Version : 5.1.47-community

Check file 'market.php'
Change section:

        // User Edits Own User Title
        if ($itembuy[marketid] != 6) {
            if (!$method != 4) {

To:

        // User Edits Own User Title
        if ($itembuy[marketid] != 6) {
            if ($method != 4) {

Problem is resolved.

[TheMayhem]

Okay I am now home from my plane ride With that being said I see you guys have been doing a lot of little bug finding, which is good. RC 3 will be released this week, sometime during the mid week. I gotta split my programming time between this and vBcredits for Pixel so it's kind of half and half right now. Below are my answers.

Originally Posted by bluegoblin7

Sorry for the double-post, a users just been telling me of some more problems.

He's bought 6 items today, but it's only showing up as two on the Market homepage. One of those is also coloured thread.

Any ideas?

Sorry if I'm not describing myself well enough!

Which six items did he purchase? I believe the Admin CP has a user transaction purchase updater under the maintenance section which recalculates for situations like this. I will definately look into it though after I see your reply and fix whatever is occurying on RC 3 but letting me know which forum items &/or store items (need to know which) will help me.

Originally Posted by Centrix

I think I've asked this twice already and I'd still like to know if this is something you will or would like to implement in the mod.

This is a very interesting mod and I use it too, but I think it would be even better with this implemented.

If you'll consider putting this in I'd be very happy.

I believe your talking about usergroup permissions, the answer is YES I will be implementing that. Possibly before I dub 3.0 a gold release.

Originally Posted by Magz

Me agian

When a gift is purchased, a notification is sent, telling user to look in the Gift Market section for more details. Nothing is shown there though, am I missing a setting somewhere

The gift section is supposed to tell you what gifts you have purchased as well as who has purchased you gifts, and any
?

That's a poor written phrase on my part telling the user to purchase the gift section for more information. I am going to update it on RC 3 to tell them the correct info related to the gift donation to clear up the confusion.

Originally Posted by bluegoblin7

And me again, feeling slightly stupid.

Found out what the coloured thread one does now - not what the user expected! It's also applied the change forum wide and seemingly irrevocably - the result being that all my threads are coloured orange.

Please help revert this!

I made a poor mistake when releasing 3x on how I named the Color thread option, I will add something in the maintenance section to revert thread colors on the next release and change the forum item name to Color Threads instead of Color a Thread. It's only supposed to color the threads of that user that they post and not color all threads or just one thread. It'll be corrected in RC 3.

Originally Posted by AtomicAcidbath

Posting this for the developer.

Buying "Title Change" with two funding sources required (Points & Cash, aka- method 4) throws this database error:

Database error in vBulletin 4.0.4:

Invalid SQL:
update lc_user set  `market_xperience`=1027.00-, market_purchases=market_purchases+1, customtitle='2', usertitle ='MyNewTitle' where userid='1';

MySQL Error   : You have an error in your SQL syntax; check the manual that corresponds to your MySQL server version for the right syntax to use near ' market_purchases=market_purchases+1, customtitle='2', usertitle ='MyNewTitle' where u' at line 1
Error Number  : 1064
Request Date  : Sunday, July 25th 2010 @ 06:12:38 PM
Error Date    : Sunday, July 25th 2010 @ 06:12:38 PM
Script        : http://76.121.10.37/forum/market.php?do=purchase
Referrer      : http://76.121.10.37/forum/market.php?do=item&id=2
IP Address    : 76.121.10.37
Username      : --------
Classname     : vB_Database
MySQL Version : 5.1.47-community

Check file 'market.php'
Change section:

        // User Edits Own User Title
        if ($itembuy[marketid] != 6) {
            if (!$method != 4) {

To:

        // User Edits Own User Title
        if ($itembuy[marketid] != 6) {
            if ($method != 4) {

Problem is resolved.

Good find, I'll be sure to correct it. Sorry about any issues.






Hopefully that helps you guys. Like I said my time is split and I just got back tonight from California. I'm sunburned but in a very good mood. I'll try and get something out later this week. Keep up the bug searching

[bluegoblin7]

Thanks for getting back to me Mayhem!

Regarding the first quote, the six items have dropped to five as I have removed manually the purchase of colour threads in the hope of fixing the problem, but it didn't work. So the five forum items are Gift Market Access, Gambling Access, Custom User Title, Purchase a Gift and Username Glow. There are no store iteams. I've run both the transaction and refund maintenane scripts and it has made no differences. Also, Gambling Access is showing up as the most expensive item (Which is it) but is saying it's not been purchased when it has been purchased twice.

Regarding the second one, any ideas when that will be released? Just that it looks a bit awful at the moment! Thanks for the fix, though.

Cheers for being proactive!

Jack

[RollaJedi]

just re-bumping my question about the 'shipping' dropdown. Could you possibly make a 'no shipping' option or something so members dont have to fill out an email or fill out their address and such. I'm just selling virtual items, so both of those things are irrelevant

[Magz]

Thank you for the update TheMayhem,

Much appreciated

[RollaJedi]

I have not been able to buy anything yet because when i do, it gives me a database error. What i'd like to know though, is where do your store items you buy show up at? Is there a screenshot maybe of this? I was hoping maybe a page that acts as a gallery maybe with each item side by side or something, and maybe something in the postbit. Can someone help me see a screenshot please? Thanks!