Secure Invites for WordPress MU

This plugin stops access to your signup page, except where the visitor has been invited and clicked the link in their invitation email. Your users invite people, and you can see who has sent the most invitations, and how many resulting signups have occurred. Other features:

  • Restrict the ability to invite people to users who have been registered only for a certain number of days or more
  • View the number of invites sent and resulting signups per month
  • View the users who have sent the most invites, and the number of resulting signups
  • Browse all invitations sent (auto paginated)
  • Change the default email text
  • Set after how many days an invitation will expire
  • Works with different locations of signup page (default: /wp-signup.php)
  • Set the message to show if someone tries to sign up with no valid invitation
  • Turn off security on signup form, allowing anyone to sign up (this does not affect the ability to invite people)
  • Show an invitation form on the dashboard
  • Show best inviters on your site with a shortcode
  • Set any number of special codes with which people can sign up without being invited
  • View reports on the number of people who have signed up with each code

This plugin is based on the invitation plugin by kt (Gord) from http://www.ikazoku.com.

There are a few extra features introduced in version 0.9:

Introducer points system

Each time somebody (Person A) invites a friend (Person B), and Person B signs up, Person A is awarded 5 points. If Person B invites someone (Person C) and they sign up, Person A is awarded 2 points. And if Person C invites someone (Person D) and they sign up, Person A is awarded 1 point (and, of course, Person B is awarded 2 points). Using this pyramid-like system you can see who is inviting not just the most people, but the best kind of people.

The introducer points are stored in the users meta table with the key secure_invite_points. You can retrieve a persons points using this function: get_usermeta( [user ID], "secure_invite_points" ) substituting [user ID] for their actual user ID.

Bulk deletion of invites

As an administrator you can now select multiple invitations and delete them. This is much better than the one-at-a-time deletion method in previous versions.

Shortcodes

There are three shortcodes available:

1) By using the [inviteform] shortcode you can place an invitation form on any post or page.

2) Using [bestinviters] will show a list of the top 6 inviters by points, with the points they have currently got.

3) Using [myinviter] will show the diplay name for the person who invited the current user. Using [myinviter id=”123″] will show the display name for the person who invited the user with ID 123.

Automatic BuddyPress theme integration

If your BuddyPress theme is the default theme (for BuddyPress version 1.2 or above), or a child of the default theme, or uses the same template hooks as the default theme, you can put the invitation form in the following places by just ticking the right box in your settings screen:

  • Before any list of members
  • After any list of members
  • At the top of every page
  • Before your site homepage
  • After your site homepage
  • At the top of the default sidebar
  • At the bottom of the default sidebar

The invitation form is hidden by default, and is shown by clicking an “Invite a friend” button which makes the form slide into view.

Preset settings

If you want to quickly set up invitations without messing with lots of settings, there are now four presets you can use:

  • Anyone can join with or without an invitation, and all users can invite as many people as they like
  • Signup is just for invited people, and all users can invite as many people as they like
  • Signup is just for invited people, and all users who have been registered for 30 days or more can invite as many people as they like
  • Signup is just for invited people, and all users who have been registered for 30 days or more can invite up to 10 people

Or you can use your own custom settings just as before.

Overriding of special users

Sometimes you want particular users to be able to invite more friends than the default, or perhaps you want to stop a particular user from inviting anybody at all. Now you can, by searching for the user and changing their own individual settings. You san set whether they are allowed to send invitations at all, and of so how many (either a limited number or unlimited).

To-do

Next on the list for this plugin is the ability to invite multiple people at the same time (with the same message).

Then, adding the ability for site admins to only allow hand-picked users to send invitations (thanks to Tuomas for that suggestion here: https://www.stillbreathing.co.uk/blog/2009/01/14/wordpress-mu-plugin-secure-invites/#comment-24240).

Download

Latest version: Download Secure Invites for WordPress MU v1.2.5 [zip]
downloads

Installation

For standard WordPress: just install the plugin as normal from the plugin repository.

For WordPress MU and WordPress MultiSite: there are two options. Either place the plugin in your /wp-content/mu-plugins/ directory (not /wp-content/plugins/), this method requires no activation. Or install the plugin as normal from the plugin repository and enable it for all sites in your network.

To enable the template form in your template page you should call the secure_invite_form() function like this:

<php? secure_invite_form(); ?>

There are three optional parameters in this function, they are:

  1. The CSS class to be applied to the form
  2. The message to be shown when the invitation has been successfully sent (by default this is ‘<p class="success">Thanks, your invitation has been sent</p>’)
  3. The message to be shown when the invitation could not be sent (by default this is ‘<p class="error">Sorry, your invitation could not be sent</p>’)

So to set the CSS class of the form to ‘inviteform’, and the success message to ‘Yay!’ and the error message to ‘Oops!’ you would use this:

<php? secure_invite_form( ‘inviteform’, ‘Yay!’, ‘Oops!’ ); ?>

In addition, you can now automatically show the invitation form in your BuddyPress theme (if it is a child of the 1.2 or greater default theme, or it has all the same template hooks). Just tick the right boxes in the admin settings screen for where you want the invitation form to appear in your theme.

FAQ

Q. Why did you write this plugin?
A. To scratch my own itch when developing Wibsite.com. Hopefully this plugin helps other developers too.

Q. Does this plugin work with BuddyPress?
A. Yes, several users have reported it works fine. You just need to change the URL of the signup form from the default (wp-signup.php) to the BuddyPress page so the plugin knows which URL to secure. In addition, you can now automatically show the invitation form in your BuddyPress theme (if it is a child of the 1.2 or greater default theme, or it has all the same template hooks). Just tick the right boxes in the admin settings screen for where you want the invitation form to appear in your theme.
An invitation form can be easily put into your template page, look at the Installation details for more information.

Changelog

1.2.5 (2013/05/29)

  • Fixed incorrect use of $wpdb->prepare() method (thanks to @maximinime for reporting this: https://wordpress.org/support/topic/missing-argument-2-for-wpdb)
  • Fixed incorrect casing of $current_user->id – changed to $current_user->ID

1.2.4 (2011/09/13)

  • Fixed incorrect response code (https://wordpress.org/support/topic/plugin-secure-invites-plugin-generates-false-500-errors)
  • Fixed bug with custom registration URL (https://wordpress.org/support/topic/plugin-secure-invites-invitation-link-does-not-honor-https-setting)

1.2.3 (2011/09/13)

  • Fixed bug with pagination links (https://wordpress.org/support/topic/invitation-list-pages-not-found)

1.2.2 (2011/08/17)

  • Fixed bug with deleting multiple invites

1.2.1 (2011/06/03)

  • Fixed bug with best inviters invite rate

1.2 (2011/04/12)

  • Fixed bug with secure_invite_user_invites_remaining() function

1.1.5 (2011/04/03)

  • Fixed bug where users could still send invites after they had run out of invites to send
  • Added function to reset a users invite settings to the global default
  • System now shows reason why a user cannot send invites

1.1.4.1 (2011/03/02)

  • Fixed session_start() bug

1.1.4 (2011/03/02)

  • Added ability to increase number of available invites for all users who have had an invite limit set
  • Put reason for invite button not showing on the main settings page (this was a regularly-reported bug)
  • Fixed bug which showed invite reports to non-admin users
  • Fixed divide by zero bug when viewing an individual users invite report

1.1.3 (2010/12/27)

  • Added [bestinviters] shortcode
  • Added [myinviter] shortcode
  • Fixed bugs with database collation which led to empty reports
  • Made support for different versions of WordPress more robust
  • Added support for invitation codes, so people can register without being invited as long as they have a valid code
  • Added reports for invitation codes

1.1.2 (2010/11/02)

  • Allowed site administrators to invite no matter what the other settings are
  • Added new preset for only allowing administrators to invite people
  • Fixed bug with is_user_logged_in() function
  • Added facility for administrators to send bulk invites

1.1.1 (2010/10/10)

1.1 (2010/10/08)

1.0.6 (2010/09/08)

1.0.5 (2010/09/03)

1.0.4 (2010/09/02)

1.0.3 (2010/08/10)

1.0.2 (2010/07/31)

1.0.1

1.0

0.9.9 (2010/07/11)

0.9.8 (2010/07/04)

0.9.7

0.9.6

0.9.5

0.9.4

0.9.3

0.9.2

0.9.1

0.9

0.8.5

0.8.4

0.8.3

0.8.1

0.8

0.7

0.6

One thought on “Secure Invites for WordPress MU

Leave a Reply