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

[optrex]

I am getting an error on registration - it still works, but the error is coming up

Parse error: parse error in C:\Inetpub\vhosts\XXXXX\XXX\register.php(328) : eval()'d code on line 21

Also could you look at getting the referrer line filled in with the user who sends the invote?

[Snoop-It]

Originally Posted by benj

maybe an option to import your yahoo / hotmail contacts so you can invite them..... that would be cool i think kinda like myspace

It would be cool wouldn't it?? Import Msn Contacts... (must register first to import & member gets referal points to the people they invite - test if you like)

[VaaKo]

I saw the admincp screenshot, so I understand that I can turn the invite system on and still let non-invited users to register right?

[The Chief]

Originally Posted by Don Corleone

I saw the admincp screenshot, so I understand that I can turn the invite system on and still let non-invited users to register right?

yes, this can be set to off...

[akanevsky]

well it says for all the New Registrations? so will it do it for the already registered members also?

No. The AdminCP only specified the value that is inserted into the database during registration. Of course, already registered members have the same default value.
You can fix that by running the following query:
[SQL]UPDATE user SET invites = XX[/SQL]
Make sure to change XX to your number.

New invites are just getting a no permissions page when following the link in mail.. I tested and verified.

Quote:
vBulletin Message
You are not logged in or you do not have permission to access this page. This could be due to one of several reasons:


But when clicking the regular register link they get the must be invited error

Quote:
vBulletin Message
You must be invited in order to be able to register on our board. Have a nice day.

Using VB 3.5.1

This is a great and useful mod for me if this can be worked out.

Any ideas?

What is your current hack configuration? E.g. list values of admincp settings, as you have 'em set up.

The ability to send multiple invites at the same time...when you don't have any invitation limits. As I have recognized that when I have announced this mod on my forums that alot more people were motivated to invite people because it was so easy, but I don't really want to give them a limit...

I will make it a no-limits when the "Registration Dependency" is set to off.

I tried installing it perfectly ... also everything is set on on the admincp but still i see this error:

I'll check that out.
"TABLE_PREFIX is missing from the install code." -> yeah, that. Will fix.

ok how come? ... so how do i go about it?

You wait for the next release. That's why the hack is in "Beta" stage.

If someone registers through the invite system does it add to the amount of user a member has referred?

Yes.

Also could you look at getting the referrer line filled in with the user who sends the invote?

Read the hack features before asking questions.

maybe an option to import your yahoo / hotmail contacts so you can invite them..... that would be cool i think kinda like myspace

Not planned.

[Snake]

Excellent! Truly a great hack.

[Revpolar]

Originally Posted by Aftermath

Quote:
maybe an option to import your yahoo / hotmail contacts so you can invite them..... that would be cool i think kinda like myspace


Not planned.

LOL, I just thought that was a tottaklly different hack.

I havnt had any problems whatsoever withtthis. Just would like to see the addittions added to it. Not IM contacts though LOL.

[Patria]

Great Extension! Thank you for your efforts!

[optrex]

Originally Posted by optrex

I am getting an error on registration - it still works, but the error is coming up

Parse error: parse error in C:\Inetpub\vhosts\XXXXX\XXX\register.php(328) : eval()'d code on line 21

Also could you look at getting the referrer line filled in with the user who sends the invote?

Thanks for the response and I love the hack BTW.

Perhaps that is why I am getting the parse error as the referrer field is not being filled in automatically.

I get the parse error on both invited and non invited registrations. Can you help with this please

[MThornback]

After much editing to correct the table prefix problems installed...and it works great

Idea for another release: a way for Admins to delete requests...any maybe usergroups too?