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

[forumsoup.com]

I still dont understand. If I have this addon, can people join my forum only if they are invited? Or is this to send people invites who dont know about the forum, or if friends want to invite their friends to join?

[IML8RU2]

Hello. I'm still looking for an answer to my previous question:

"We're still getting the message "You must be invited....." even after the person clicks on the link in the invite email. Any suggestions?"

Thanks!

Natalie

[MissKalunji]

Originally Posted by forumsoup.com

I still dont understand. If I have this addon, can people join my forum only if they are invited? Or is this to send people invites who dont know about the forum, or if friends want to invite their friends to join?

you can set option ONLY if they are invited
and also does this

or if friends want to invite their friends to join?[/

[quanvo81]

It doesn't work for me at all
All the users who receive the invitation mails, when they click on the link that take to register, they will see a message like this:
Our records show that you have already registered under the name of "NAME OF THE PERSON WHO SEND THE INVITATIONS". If you have lost your password, click here. If you would like to modify your profile, click here.
It means if a user name FX sent the invitation, it will say
Our records show that you have already registered under the name of FX. If you have lost your password, click here. If you would like to modify your profile, click here.
Click Uninstall.

[IML8RU2]

For anyone who had the same problem as I did - invitees being told that they have to invited to join the forum, even when they click on the link in the invitation - I unistalled and then re-installed Invites and now it works perfectly.

Thanks Psi! I love this hack.

Natalie

[quanvo81]

Originally Posted by quanvo81

It doesn't work for me at all
All the users who receive the invitation mails, when they click on the link that take to register, they will see a message like this:
Our records show that you have already registered under the name of "NAME OF THE PERSON WHO SEND THE INVITATIONS". If you have lost your password, click here. If you would like to modify your profile, click here.
It means if a user name FX sent the invitation, it will say
Our records show that you have already registered under the name of FX. If you have lost your password, click here. If you would like to modify your profile, click here.
Click Uninstall.

I think the reasons because I stayed login, when I logout and try the invitation, it works.
humm, anyway, re - click Install.

[Mr.D]

Can you tell me is it posible for admin to generate say 100 invites and then paste it some where. Will that be posible in next version? Will admin have the ability to generate invites?

[Smiry Kin's]

Originally Posted by Mr.D

Can you tell me is it posible for admin to generate say 100 invites and then paste it some where. Will that be posible in next version? Will admin have the ability to generate invites?

you can't control invites on this?? ya would think it would be in the options or something? if not.... OMG... ROFL

[o0Hubba0o]

Originally Posted by bonjurkes

first of all just want to say that it is a great hack and i was looking for it...

Installed

Also i am not familiar with cron jobs. Is there a chance to add earned invites every night at 11:59 instead of Monday?

Will it cause a big load? If it wont can you tell how must i change the second cron job...

It must of for me because my account got suspended for it:

Okay

You were running cron.php where it overloaded the server and they suspended you.

I will get in touch with tech support and ask them what is going on... I will try to be able to get into your account so that I can look at what happened.

If nothing, a look at your database might help

We translated the dateline and the invites was the cron running at the time, and it was the only hack with a cron I installed earlier that night. This could obviously just be an issue with my server since I don't see anyone else having this problem, and since mines free I'm not going to complain.

However this system itself isn't practical for my forums, it's a great system so I wanted to try it out, but with the server problem I had and not really needed at my site I unistalled it.

I do have this hack bookmarked for a site I plan on starting this summer that I would like to have as an invite only membership....and it will be on a different server.

So while it didn't work for me, great work once again psi, keep it up!

[kofoid]

Has anyone found a work around to this:

Make sure to turn on "Forum View" permission for guests, otherwise they won't be able to register. This won't be necessary in the next vBulletin version after 3.5.2 (a bug which Andreas promised to fix). For now - just do it.