Invites System

I no longer support my hacks. Please feel free to update them and release new versions elsewhere as long as I get the credit for the original modification.

/*=========================================*\
|| Invites System
||
|| Author : Anton Kanevsky
|| Works on : vBulletin 3.5.0
|| Released : Dec 19, 2005
||
|| Time required to install: 1 minute
|| Difficulty: easy
\*=========================================*/

DESCRIPTION

A complete invites system for your vBulletin board.

STATISTICS

File Uploads: 3
Template Changes: 4
Products to Install: 1


FEATURES

Configuration Options:

• The system can be turned on and off.
• Registration can be set to either require invite code to sign up or to continue allowing regular registrations when the system is on.
• Invite Expiration Period.
• Minimal Posts Required to Receive Changes in Number of Invites.
• Minimal Reputation Required to Receive Changes in Number of Invites.
• Number of Posts Required to Get One (1) Invite.
• Number of Invites Received or Subtracted per Reputation (+ for positive, - for negative).
• Initial Number of Invites Given on Registration (Sign Up).
• Usergroups that May Not Use Invite Manager.
• Usergroups that May Use Invite Manager (Optional Override).
• Initial Registration Usergroup (only pertaining to registration by invites).
• Do or Do Not make users linked by an invite mutual buddies after the completion of registration of the person invited.
• Single / Multiple Address Line Field.
• If Multiple, Number of Fields to Show.

Miscellaneous Features:

• Upon invite-based registration, the person who issued the invite is set up as a referrer of the person invited. Therefore, free specification of a referrer is restricted during such registration.
• Image (GD) Verification.
• Administrator can manually edit any user's invite count.
• If a user is permitted to issue invites (based on both the number of unused invites and the system permissions), that user has a link to invites of usercp home (says "Click here to invite new users!"). When a user has no invites left, the link does not show up. Nevertheless, as long as system permissions allow access to the Invite Manager, the usercp navlink continues to show up, so that the user would have access to his/her invite history, which is available just below the "Issue New Invite" form.
• If registration is set to require invite code to sign up, the navbar register link becomes hidden.
• If registration is set to continue allowing non-invited sign ups, the number of invites available to any single user is unlimited. Therefore, the number of invites left does not show up.
• Invite History in UserCP, on the bottom of the invite manager.
• Single-Line AddressField, with Unlimited # Of Simultaneous Recipients, within the bounds of invite tokens.
• Multiple-Line AddressField, with Limited Configurable # Of Simultaneous Recipients, within the bounds of invite tokens.
• Unregistered Users, Banned Users and Users with No Forumview Permissions cannot use invite manager. Therefore, you do not have to specify those usergroups in the list of usergroups that may not use the invite manager.
• Invite counts are automatically updated once a week, based on the admincp-configured settings.
• Per-user invite usage restriction.
• Inactive users, who do not post anything new, will gradually lose all of their invites.

VERSION HISTORY

1.5.0
A new, commercial release.

1.4.0
[+] Image verification to avoid multiple submits.

1.3.0
[+] New Config Option: Single-Field / Multiple-Field Address Line (Default: Multiple-Field)
[+] New Config Option: Number of fields to show if multiple option is chosen.
[+] User Option, which lets an administrator restrict invite system usage for that single user.
[F] Fixed Bug, which prevented a user from registration if COPPA was enabled.
[F] Fixed Bug, which prevented a user from sending out an invite if he had zero invites and dependency on registration was turned off.
[F] Fixed Bug, which continued to show the invite form after it was submitted, even if there were no more invites left.

1.2.0
[+] New Config Option: Usergroups that May Use Invite Manager (Optional Override).
[+] New Config Option: Initial Registration Usergroup (only pertaining to registration by invites).

1.0.2
[+] Ability to send unlimited simultaneous invites, within the bounds of invite count owned.
[+] Improved invite interface (see screenshot).
[F] A couple of hard-coded forgotten phrases have been moved into the phrase system.

1.0.1
[+] Amount of posts required to get one invite is now configurable
[+] When a user can issue invites, he/she has a link on usercp (which says "Click here to Invite a New User!")
[+] When invites are required to register, there is no direct "Register" link in the navbar
[+] When invites are not required to register, there is no limitation on invites, and therefore the number of invites left is not shown
[+] Administrator can now edit invite counts manually using Admin Manager
[+] Administrator can now specify which usergroups cannot use Invite Manager
[+] More descriptive AdminCP Hack Options
[F] Added TABLE_PREFIX to the Install Code
[F] Fixed a Typo in Registration Code
[F] In the Invite History, invites are now lister in a descending order, rather than ascending. In other words, the latest invites are now on the top.

1.0.0
Initial Release

The installation manual is contained within the attached file.

IF YOU LIKE MY HACK, PLEASE CLICK INSTALL

[akanevsky]

How is it in regards?
Your request is about user management, not about invites themselves.

[HansMuenchen]

Originally Posted by Psionic Vision

How is it in regards?
Your request is about user management, not about invites themselves.

No what I mean see pls screenshot!
That's what a user normaly see into the UserCP if he go to invites!
Yes the delet was made in the user Manager that's right but the problem is not into the user manager the problem or what I mean is into the invite system.

Thnx for have a look!

Greetings
Hans

[The Chief]

I really love your hack, god its really some good job!!!

Really can't wait if you decide to do a little something for MSN...

Good job! and thanks!

[akanevsky]

No what I mean see pls screenshot!
That's what a user normaly see into the UserCP if he go to invites!
Yes the delet was made in the user Manager that's right but the problem is not into the user manager the problem or what I mean is into the invite system.

Thnx for have a look!

That's not a "problem". That's how I designed it.

Really can't wait if you decide to do a little something for MSN...

From now on, anyone who asks me anything about MSN/AIM/ZZZ/XXX/W.E will be void support and added to my ignore list. Because I already answered this a couple of times, and said that this feature is not planned.

[Bubble #5]

Originally Posted by HansMuenchen

it would be nice if there could be an cron job what will be delete (once a day or maybe hour) the deleted users if the forum will be set to moderate users.

Thnx for doing it

What makes you think that Psionic has nothing better to do than to add this? You need to formally request it through the Hack Requests section, and then IF anyone wants to make it, and they have the time to make it, they will post it, but Psionic is very busy working on other things right now I'm sure :nervous: Merry Christmas.

[akanevsky]

Hack Requests section, and then IF anyone wants to make it, and they have the time to make it, they will post it, but Psionic is very busy working on other things right now I'm sure.

Thanks, Bubble #5. Merry Christmas to you too.

[Bubble #5]

No problem Psionic I see people snapping their fingers on these boards all the time and telling coders to do this or to do that, as if coders have nothing better to do than to make custom features that only one person would ever use. It's real simple, if people want a certain feature then they can request it in the proper place, but when they 'assume or demand' that the feature be added just for them then that's crossing the line. They probably need to pick up a book and learn how to code and then the world is their oyster :nervous: That's what I'm doing now, I'm learning how to code. Some of it is hard, but some of it is easier than I ever expected. I do love learning about it though. You are a great inspiration Psionic. Have a safe and happy holiday, and thanks for all of your hard work here, a lot of us truly appreciate it

[Mattikana]

I came across a weird issue today.. a member on my forum invited a friend.. but another member also invited the same guy.. so he received 2 invites.. and gave the 2nd invite away to someone else.. I don't want that.. :ermm:
so could it be possible to check the mailadress entered in the form if it already has been invited? and also check if the mailadress is not on the banlist ?

[MissKalunji]

Originally Posted by Bubble #5

No problem Psionic I see people snapping their fingers on these boards all the time and telling coders to do this or to do that, as if coders have nothing better to do than to make custom features that only one person would ever use. It's real simple, if people want a certain feature then they can request it in the proper place, but when they 'assume or demand' that the feature be added just for them then that's crossing the line. They probably need to pick up a book and learn how to code and then the world is their oyster :nervous: That's what I'm doing now, I'm learning how to code. Some of it is hard, but some of it is easier than I ever expected. I do love learning about it though. You are a great inspiration Psionic. Have a safe and happy holiday, and thanks for all of your hard work here, a lot of us truly appreciate it

uhm.... :ermm: o..k... i dont know y ppl are jumping to his throat...man vb.org changed!

he's not the only one a lot of ppl are asking about it i started got stuck posted about it caz i didnt wanna disturb vision no one replied so who do i turn to? the one who did the mod no? jeeshhhhhhhhhh i dont know if its cause ya'll in a rush for xmas but there is a lot of hostility in the air

[Bubble #5]

Originally Posted by MissKalunji

i dont know y ppl are jumping to his throat

No one is 'jumping' on anyone. As far as the 'feature' is concerned Psionic has stated several times in this thread already that he wasn't going to make it, so why keep bugging him about it? Mmmm... time for more eggnog :nervous: