[ABD] Invite A Friend 0.7.0

Any abandoned MODs will be moved to this forum.

WARNING: MODs in this forum are not currently being supported or maintained by the original MOD author. Proceed at your own risk.
Forum rules
IMPORTANT: MOD Development Forum rules

WARNING: MODs in this forum are not currently being supported nor updated by the original MOD author. Proceed at your own risk.
Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

[ABD] Invite A Friend 0.7.0

Postby Bycoja » Fri Oct 03, 2008 10:43 pm

Please read the FAQ before downloading the MOD!

Title: Invite A Friend

Description:
Invite A Friend is a phpBB3 Modification, which adds referral and invitation features to your phpBB board in order to have more control over the user registration process and help the growth of your community.
This can either be accomplished by specifying a referral user or sending out invitations with an invitation code attached. The invitation code cannot only be required to make your board private but also helps to associate new users with their referrer adding a more social component to the phpBB board. Supporting Ultimate Points and Cash Mod.

Version: [Beta] 0.7.0
Target version: phpBB 3.0.10

Suported languages:
  • English (en)
  • German (de)
Supported MODs: Ultimate Points, Cash Mod, MOD Version Check
Supported styles: prosilver, subsilver2

Mod Download: Invite A Friend 0.7.0
Image


Planned features:
  • Import contacts from other social services
  • Send invitations using Jabber / your own e-mail address
  • Report spam
  • Rankings
  • Possibility to cancel pedning invitations
  • Invitation form customization settings
  • Different user states (received invitation, followed the link, registered, active)
  • Additional templates for each user state addressing both the referral and the referrer making
  • Define the criteria for a successful invitation
  • Permission role for invited users
  • Add user to rank/group depending on invitations sent
  • Run actions in ACP (resynch deleted users, delete pending invitations, etc.)
  • Ability to assign invitations manually
  • Support for Reputation System 0.4.2
  • UCP Module: User-specific settings
  • UCP Module: User-specific log
  • UCP Module: Pending registrations
  • MCP Module: Register spam reports
  • MCP Module: Approve invitations
  • ACP Module: Pending registrations


Git repository: http://github.com/Bycoja/invite-a-friend

Screenshots:
Send invitation
User registration
Confirmation message
Profile page
Members
Filter referrals
ACP Overview
ACP Invitation settings
ACP Referral settings
ACP Message templates
ACP Action log


Latest changes:

2012-08-12 - Version 0.7.0 [Beta]
  • [Added] Referral features
  • [Added] Referral template
  • [Added] Multiple recipients
  • [Added] Statistics
  • [Added] Invitation icon
  • [Added] More settings (expiration time, post requirement, etc.)
  • [Added] ACP Module: Referral settings
  • [Added] ACP Module: Overview
  • [Changed] Moved the invitation link
  • [Changed] Disabled the 'prevent abuse' setting by default
  • [Changed] Disabled the options when composing invitations by default
  • [Changed] Key generation
  • [Fixed] UMIL installation
  • [Fixed] Errors when installing with AutoMOD 1.0
  • [Fixed] Apply template changes made in the ACP correctly
  • [Fixed] Special characters in templates
  • [Fixed] Confirmation code display



FAQ:
How about installing the modification on a live board?

Although the modx file states that 'This MOD is development quality. It is not recommended that you install it on a live forum.', installing the modification shouldn't cause any trouble in fact. However, the modification is still tagged as beta, so bear with me if there is a bug or two.

I found a bug!

Cookies? No, seriously - please report it to this topic. Nevertheless do not only post the plain error message, but also describe exactly what you were doing when the error occurred. This will help me reproduce and eventually fix it.

Administration Control Panel: I cannot find the invitation settings and the invitation log.
User Control Panel, Compose Invitation: You are not authorised to access this area.

These problems may occur apart from each other, but more likely at the same time. After making sure that you didn't miss the invitation settings accidentally, access the permissions tab in the Administration Control Panel, choose your user or group and edit the permissions.
As for the invitation form in the User Control Panel you have to search for User permissions->Misc->Can send invitations to friends, the permission to manage invitation settings can be found at Admin permissions->Misc->Can manage invitation settings / Can manage invitation log.

An error occurred while sending the invitation.

Please check the board´s error log in the Administration Control Panel (ACP->Maintenance->Error log). If you are not able to draw any conclusion from the error message, feel free to post it in this topic or contact your host.

I've submitted the form and the invitation has been sent successfully. However, the recipient doesn't receive any email - is the MOD broken?

No, it's probably not. Invite A Friend is using phpBB's messenger class to send e-mails, so it should be working if the board can send other e-mails like, for instance, mass e-mails. Please make sure that you have enabled board-wide e-mails in the Administration Control Panel (ACP->General->E-mail settings) and entered a valid contact e-mail address.
If the board cannot send any e-mails, please contact your host and find out whether he provides a native (PHP based) e-mail service at all.

When trying to register a new user the modification states 'You must not use registration keys you sent to yourself.'

Inviting yourself in order to test the modification won't work unless you have disabled the settings in the Administration Control Panel (it is enabled by default). To prevent abuse, especially when using reward systems, the IP address of the user-to-be will be compared to the one of the user who invited him. If both IP addresses are identical, this error will be displayed as someone is trying to take the mickey out of us.

Successful invitations?

Invitations leading to the registration of the invited friend.

What is an invitation code?

Each invitation sent to a user´s friend is attached an invitation code, which is a randomly generated string consisting of alphabetic and numeric characters (between 10 and 16). The invitation code generally inheres in two tasks: It not only helps to associate new users with the one who invited them and keeps track of statistical information, but it may also be required to register new users at all - which would be necessary if you set invitation codes to required in Administration Control Panel making your board a private one.
They can be disabled completely, too (in this case the e-mail address of the user-to-be will be compared in order to associate him with the user who invited him). And last but not least you are able to give future users the choice whether they want to enter an invitation code, providing special advantage to those who got invited (and therefore got a key).

What is the answer to life, the universe and everything?

42.
Last edited by Bycoja on Sat Dec 29, 2012 5:15 am, edited 57 times in total.

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sat Oct 04, 2008 8:47 am

Feature requests and feedback are always welcome. :)

User avatar
Dugi
Registered User
Posts: 1385
Joined: Sun May 25, 2008 5:36 pm
Location: Prishtina, Kosovo
Name: Dukagjin Surdulli
Contact:

Re: [Beta] Invite A Friend 0.1.0

Postby Dugi » Sat Oct 04, 2008 3:42 pm

GREAT MODIFICATION OMG :shock:
PM me for custom extension pricing / My validated MODs / My MODs in development
MODs I've created are currently put on hold until I recreate them for 3.1.

User avatar
Kharon
Registered User
Posts: 235
Joined: Thu Oct 26, 2006 5:27 pm

Re: [Beta] Invite A Friend 0.1.0

Postby Kharon » Sat Oct 04, 2008 4:26 pm

wow,very nice mod :D

but
The registration-key is invalid - error (your boards register page) :(


oppss Target version: phpBB 3.0.1 ? 3.0.2 ?

thanks

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sat Oct 04, 2008 4:59 pm

oppss Target version: phpBB 3.0.1 ? 3.0.2 ?

It works with 3.0.2, too.

The registration-key is invalid - error (your boards register page) :(

If you send an email to a friend of yours and registration-keys are enabled, a key will be created and inserted into database. You can't register without such a key. Looks like you entered an incorrect key (just copy&paste the key found in the email) ...

drankur
Registered User
Posts: 271
Joined: Sat Dec 22, 2007 4:16 am

Re: [Beta] Invite A Friend 0.1.0

Postby drankur » Sat Oct 04, 2008 8:07 pm

Files to Edit
includes/constants.php,
ucp.php,
functions.php,
includes/ucp/ucp_register.php,
styles/prosilver/template/ucp_register.html,
styles/prosilver/template/overall_header.html,
styles/subsilver2/template/ucp_register.html,
styles/subsilver2/template/overall_header.html


out of these i am confused with
ucp.php,
functions.php,


i am unable to find them

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sat Oct 04, 2008 8:23 pm

drankur wrote:out of these i am confused with
ucp.php,
functions.php,


i am unable to find them

You're right, functions.php (should be includes/functions.php) doesn't exists, thanks. I uploaded the fixed install.xml. ;)

ucp.php:
Image

drankur
Registered User
Posts: 271
Joined: Sat Dec 22, 2007 4:16 am

Re: [Beta] Invite A Friend 0.1.0

Postby drankur » Sat Oct 04, 2008 8:55 pm

thanks, justv one more query...

i which section i have to add the module, can u plz give me the path

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sat Oct 04, 2008 9:05 pm

You can add the module wherever you want. I added it here: Module Management

drankur
Registered User
Posts: 271
Joined: Sat Dec 22, 2007 4:16 am

Re: [Beta] Invite A Friend 0.1.0

Postby drankur » Sat Oct 04, 2008 9:18 pm

i have installed it on my live forum , its excellent !! thanks bro....

but few things i would like to suggest...
1. if we disable the registration keys than no key should be generated in mails....
2. whenever a person registers using a invitation, the member who invited should get a confirmation mail mentioning the username of newly registered member
3. there should be a invitaion count for each member so that we can know how much they have invited...

hope i am not asking too much

User avatar
Kharon
Registered User
Posts: 235
Joined: Thu Oct 26, 2006 5:27 pm

Re: [Beta] Invite A Friend 0.1.0

Postby Kharon » Sun Oct 05, 2008 2:31 pm

I installed a live board

acp modules - no error
invite.php - no error

thanks

Debug mode on

Code: Select all

[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 129: Undefined variable: user
[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 129: Trying to get property of non-object
[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 130: Undefined variable: user
[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 130: Trying to get property of non-object
[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 131: Undefined variable: user
[phpBB Debug] PHP Notice: in file /includes/functions_invite.php on line 131: Trying to get property of non-object


functions_invite.php 129,130,131 lines

Code: Select all

$messenger->headers('X-AntiAbuse: User_id - ' . $user->data['user_id']);
$messenger->headers('X-AntiAbuse: Username - ' . $user->data['username']);
$messenger->headers('X-AntiAbuse: User IP - ' . $user->ip);

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sun Oct 05, 2008 3:45 pm

functions_invite.php 129,130,131 lines

Code: Select all

    $messenger->headers('X-AntiAbuse: User_id - ' . $user->data['user_id']);
    $messenger->headers('X-AntiAbuse: Username - ' . $user->data['username']);
    $messenger->headers('X-AntiAbuse: User IP - ' . $user->ip);

Forgot to register $user as global in send_email, thank you. :)

I will release a new version including some bugfixes and new features soon.

xxxgamer
Registered User
Posts: 574
Joined: Mon Jul 16, 2007 11:25 pm

Re: [Beta] Invite A Friend 0.1.0

Postby xxxgamer » Sun Oct 05, 2008 4:13 pm

Great mod. Does this work with 3.00?

User avatar
Kharon
Registered User
Posts: 235
Joined: Thu Oct 26, 2006 5:27 pm

Re: [Beta] Invite A Friend 0.1.0

Postby Kharon » Sun Oct 05, 2008 4:28 pm

Bycoja wrote:Forgot to register $user as global in send_email, thank you. :)

I will release a new version including some bugfixes and new features soon.


okay,I am waiting new version :)

thanks

Bycoja
Registered User
Posts: 127
Joined: Tue Apr 29, 2008 7:55 pm
Location: Germany

Re: [Beta] Invite A Friend 0.1.0

Postby Bycoja » Sun Oct 05, 2008 4:34 pm

xxxgamer wrote:Great mod. Does this work with 3.00?

Didn't check it, but should also work with 3.0.0 ...

okay,I am waiting new version :)


You can fix the debug error by doing the following:

--------------------------------------------------------------------------------
Open: includes/functions_invite.php

Find (Line 109):

Code: Select all

global $phpEx, $phpbb_root_path, $config;

Replace with:

Code: Select all

global $phpEx, $phpbb_root_path, $config, $user;


Return to “[3.0.x] Abandoned MODs”

Who is online

Users browsing this forum: No registered users and 8 guests