** BETA NOTES **

• SEE END OF DESCRIPTION FOR CHANGES!
• This version of Omni Inviter is not compatible with the latest SVN of Elgg.
• You MUST disable the Open Inviter method's Twitter plugin or the Open Inviter method WILL NOT WORK.
• This is a beta release.  Not all features will work as expected! 
• Upgrading users *MUST* visit the tools administration page to trigger an upgrade before the stats will work.  This page may take a while to load if (against suggestions!) you've used this on a live site!
  
• Messages are *NOT* sent immediately--They are queued and sent in batches to keep server congestion down.  This means that you must have a working cron installation!
• Check out the new, in progress stats!  Comments and suggestions are requested!
  
• This version includes easier viewing of invitations.
• See CHANGES section at bottom for more changes.

** END BETA NOTES **

Omni Inviter creates and sends custom invitations to friends.  It is easily
extendible with plugins.  Default plugins include:

    * Friends -- Invite friends with email address.  After registration,
      the inviter and the invited users are marked as each others' friends.
     
    * Secret -- Invite friends with email addresses secretly.  This method
      requires the invited user to sign up before it will reveal who
      sent the invitation.
     
    * OpenInviter.com -- Invite friends from other social networks and
      email accounts.  This uses OpenInviter <http://openinviter.com&gt;
      technology to log in to 3rd party websites and send mass
      invitations.  *See note in README file.

Once installed, activated, and configured, you will find the link to
invite users on the left side of the friends list page.  You can also
go directly to it at http://yourelggsite.org/pg/omni_inviter/invite

** LICENSE INFORMATION **

This software is governed under rights, privileges, and restrictions in
addition to those provided by the GPL v2.  Please carefully read the
LICENSE file for more information.

** TODO **
        * Open Inviter's "Check all/none" is pretty dodgy.  Functional, but
          needs to be rewritten.
       
        * Sorting in admin listing.
               
        * Secret method: option during invitation creation to have custom
          notifications sent to the invited user.  (Is this important at all?)
         
        * On very (moderately?) large sites the stats will run into OOM errors
       
        * Add invitation expiration using expiration date.
       
        * Separate the awful pagehandler function into bit-sized chunks.
       
        * Revamp stats to give additional information such as time
          between creating and new user joining, etc.
         
        * Pull the mass iterating functionality out into a real function.
   
   
** CHANGES **

v1.0b3 (2009-05-29)
        * Changed get_entities_from_metadata_by_value() to
          oi_get_entities_from_metadata_by_value() to avoid function name
          collisons with other plugins.  (Better solution forthcoming.)
        * Added config option for max attempted sends.
        * Added config option to disable cron (and enable manual send).
        * Open Inviter method's link to http://openinviter.com opens in a new
          window.
        * Adjusted the rate limit defaults and upped the time to 5 minutes
          minimum since users can set the max_send_attempts to 10.
        * Code cleanup for cron.

v1.0b2.1 (2009-05-28)
        * Removed call to debug log function that was breaking everything.

v1.0b2 (2009-05-26)
        * Updated README.
        * Corrected bug with JS and i10n (Thanks Colin Tate <@colintate>!).
        * Non-success and empty method content will return an error on AJAX
          loading.  (Thanks Ash <http://www.emediadrop.com/&gt;!).
        * The enter key now works as expected when adding users, logging in to
          Open Inviter sites, etc.
        * Added "Check all/none" for Open Inviter method.
        * Prettied up some formatting issues and made errors more noticable.
        * Added user settings for receiving a notification when an invite is
          used.  Metaplugins can extend user settings can be extended the same
          as site settings.
        * Added transparent support for the PHPMailer plugin by Cash Costello.
        * Fixed saving settings for metaplugins.
        * Fixed occasional problem in setting when the language file wasn't
          loaded and default email subject and body were language stubs.
        * Interface for admins shows basic stats on invitations allows
          invitations to be resent.

v1.0b1 (2009-05-12)
    * Initial release.