[1.6.20] Common Friends (Hook) - phpFox User-User Support Forum

Raymond Benc · #1 04-25-2008, 01:59 AM

Plugin Version: 1.3

I was browsing Facebook earlier and wanted to create a quick mod for us. Thought the "Common Friends" feature would be handy. Browsed our forums and found there was already a mod similar to this which can be found here.

With this version of that mod it uses the hook system introduced with v1.6.20 so in order to use this plug-in you will need that version installed. Decided to use that method to create the plug-in instead of creating it as a module so we can release an example of how to use the hook system.
However if you don't have v1.6.20 installed and you are still using an older build or even v1.5.1 there is a hack to get this working on those versions as well. To view this hack check out the "Extra Hacks" section below.

The "Common Friends" block will look similar to the "My Friends" block found on a users profile. For a better idea of how the mod looks check out the screen shot attached with this thread. The plug-in also includes a "View All" page where the user can view all the friends they have in common with the user they are viewing.

I ran a few tests and all is working fine on my end, but I tested it locally and the best way to test this sort of plug-in is on a live community where users have a lot of different friends. So if you do install this plug-in let me know how it goes.

Okay lets get to the good stuff.

To install/upgrade the plug-in...

1) Download the ZIP "CommonFriends.zip" attached with this thread.

2) Unzip it and you should find the following folders:

Code:

Content visible to registered users only.

Upload those folders to your sites root directory.

3) Rename the file

Code:

Content visible to registered users only.

to

Code:

Content visible to registered users only.

4) Login into your Admin CP and navigate to:

Code:

Content visible to registered users only.

Then make sure the setting:

Code:

Content visible to registered users only.

is set to: Yes

Next make sure the setting:

Code:

Content visible to registered users only.

is set to: No

Next make sure the setting:

Code:

Content visible to registered users only.

is set to: No

That's it. Visit a user you know you are friends with and might already have friends in common to test out the plug-in.

By default the plug-in will list 6 common friends. To change this open the file:

Code:

Content visible to registered users only.

Then look for:

Code:

Content visible to registered users only.

Change the 6 to any number you want. Good idea would be either 9, 12, 15 etc...

In that file you will also notice:

Code:

Content visible to registered users only.

These are the phrases used for the plug-in. By default the header of this block is "COMMON FRIENDS". Feel free to change that to anything you want. If anyone is interested to use this on multilingual sites let me know and I can write up a quick guide on how to add the phrases into a language package.

More tests need to be done so if you do install the plug-in let me know if you run into any problems.

Extra Hacks

Here are some extra hacks you can do to improve or change the functionality of the plug-in.

Get this plug-in working on v1.5.1 or any v1.6.x build.

Follow the install steps above. When getting to step 4 just skip that step and instead open the file: /design/templates/default/public/user/index.html

Look for:

Code:

Content visible to registered users only.

Above that add:

Code:

Content visible to registered users only.

You should then be good to go.

Add the Common Friends Block under My Friends

By default I have added the Common Friends block above the My Friends block. If you would like to add it under the My Friends block instead rename the file:

Code:

Content visible to registered users only.

to

Code:

Content visible to registered users only.

Multilingual Support

If your site has more then one language package installed you can do the following to make sure this plug-in can work on all language packages.

1) Open the file

Code:

Content visible to registered users only.

Then look for something similar to:

Code:

Content visible to registered users only.

With this example I will just work with the phrase "COMMON FRIENDS" which is the header of the block for this plug-in. So the part we are going to be working with is:

Code:

Content visible to registered users only.

2) Login into your Admin CP and navigate to the "Phrase Manager"

3) Click on "Add New Phrase"

4) For the "Varname" insert:

Code:

Content visible to registered users only.

The reason I used "common_friends" is because the phrase being used is

Code:

Content visible to registered users only.

5) For the "Text" of each language package you have installed simply insert

Code:

Content visible to registered users only.

This will work for the default English language package so for the other language packages you will need to translate it. Once you have done that click on save.

6) Once you have added the phrase you should get a message simliar to this:

Code:

Content visible to registered users only.

The part we will be using is:

Code:

Content visible to registered users only.

7) Now go back to the file

Code:

Content visible to registered users only.

and look for

Code:

Content visible to registered users only.

and replace that with

Code:

Content visible to registered users only.

As you may have noticed the part we added is:

Code:

Content visible to registered users only.

all we need to do is add the variable for each phrase which in this case 'common_friends' was created. That's it, you should then have a phrase created for each language package. Follow the same steps for the other phrases and change only the actual "varname" and "text".

coolwurkz · #2 04-25-2008, 02:05 AM

testing now

coolwurkz · #3 04-25-2008, 02:19 AM

hook system nice :) just tested this works great so far.

knowzdamnwell · #4 04-25-2008, 03:33 AM

I just installed your plugin and so far working perfectly :D

alexdale · #5 04-25-2008, 05:09 AM

thos mod works great, but is it possible to show a "[view all common friends]" link? i got a friend and we have like 200+ friends in common. Wanted it to have a separate page for viewing all commong friends just like "[view all my friends]".

parmenti · #6 04-25-2008, 06:41 AM

yes, agreed... the other post on the forums already has this feature which I have implemented on my site already.. does this hook version allow for this? thanks

myfuecom · #7 04-25-2008, 07:24 AM

looking forward to more use of the hook system, thanks natio. hopefully soon installing a mod will be as easy as the plugin system on vbulletin

way to go :)

webmasterx · #8 04-25-2008, 07:33 AM

how can i make it appear below the friends list on profiles?

p.s. a view all feature would be great

boostedtofu · #9 04-25-2008, 03:26 PM

A view all friends in common would rock!

ajmboy · #10 04-25-2008, 10:41 PM

I guess the hook system is only build 20..right? Still using build 19 on one of my sites...

NATIO, did you see the badge option in facebook when you were browsing there?

http://forums.phpfox.com/showthread....facebook+badge

Would make a great mod to promote communities on other sites!

Thanks for the FREE Mod!

Thread Tools
Show Printable Version Email this Page
Display Modes
Linear Mode Switch to Hybrid Mode Switch to Threaded Mode

The Following 34 Users Say Thank You to Raymond Benc For This Useful Post:
ajmboy (04-25-2008), Altan (06-28-2008), azjr247 (04-25-2008), borosound (10-05-2008), c2play4cam (01-24-2009), Cfriskme (01-19-2009), chemosi (12-14-2008), chodhry (04-25-2008), coolwurkz (04-25-2008), dude (04-29-2008), forestclown (05-22-2008), JANEMARCIA26 (07-23-2008), knowzdamnwell (04-28-2008), kraze2007 (04-29-2008), Kribba (04-25-2008), Matrix (05-20-2008), metro (04-27-2008), Mindsplitter (11-16-2008), myfuecom (04-25-2008), myonit (05-10-2008), nemo (04-28-2008), ourlordsfriends.com (08-12-2008), Pdog89gt (01-19-2009), profilebooth (07-11-2008), RainbowWarrior (11-20-2009), robit (08-18-2008), rossmilne (01-03-2009), SlideRiceFC (04-28-2008), tenaki (01-24-2009), thunder88 (01-24-2009), tresavon (01-28-2010), Vincent_C (04-25-2008), waleric2 (04-28-2008), zaidey (06-10-2008)

The Following User Says Thank You to ajmboy For This Useful Post:
borosound (10-05-2008)