Facebook Connect Module

**Yankidank** · 01-20-2010, 10:24 AM

Installation Instructions:
-----------------------------------------------------------------------------

For Facebook

1. Go to https://developers.facebook.com/apps to register a new Facebook Application.
2. Enter an Application Name for your website to use. Agree to the terms, and click on the "Create Application" button.
3. Click on the "Connect" tab on the left side of the page.
4. Enter a "Connect URL" value. This would be the URL used for your Pligg homepage. For example the site http://www.pligg.com/demo/ would use the value "http://www.pligg.com/demo/" (without the quotes of course).
5. Enter a "Base Domain" value. This is root domain for your website. For the example site http://www.pligg.com/demo/ I have set it to "pligg.com". You can also use the value "www.pligg.com" if you want the connect module to only work on "www." URLs on your site.
6. Click on the "Save Changes" button.
7. Your site registration on Facebook.com is now complete. Navigate back to the "Basic" tab on the left and copy down the API Key and Secret values. You will be using these values in a minute to configure the Pligg module.

-----------------------------------------------------------------------------

For Pligg

8. Upload the Facebook module (located in the "fb" folder) to your Pligg /modules directory.
9. Navigate to your Pligg module management page from the Pligg Admin Panel. Find the Facebook module and install it.
10. Click on the Settings link for the Facebook module, or click on the "Facebook Module" tab near the top of the Pligg Admin Panel.
11. Insert your Facebook API and Facebook Secret keys into the appropriate fields.
12. Add the following template hook where you would like the Facebook connect button to appear. This is required for sites using templates designed for Pligg 1.0.3 and below. If you do not manually place this in a .tpl file the module will not know where to insert the Facebook Connect button. I suggest that you place it immediately after <a href='{$URL_login}'>{#PLIGG_Visual_Login_Title#}</a> in header.tpl.

Code:

{checkActionsTpl location="tpl_pligg_login_link"}

12. Optional Fix for IE7. Open your pligg.tpl template file and find:

Code:

<html dir="ltr" xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">

Replace it with:

Code:

<html dir="ltr" xmlns="http://www.w3.org/1999/xhtml" xmlns:fb="http://www.facebook.com/2008/fbml" xml:lang="en" lang="en">

-----------------------------------------------------------------------------
Changelog:
-----------------------------------------------------------------------------

4.4 February 28, 2013
- Bug fixes

4.3 February 12, 2013
- Updated for Facebook API changes.

4.2
- Added feature to submit story to Facebook wall through a story tools link.
- Changed javascript to work with Pligg 2.0.

4.0
- Update required to match new Facebook API.

3.8
- Fix related to when users disconnect their accounts. Allows them to generate a password via email.

3.7
- Openend PHP file with longer <?php tag in fb.php.

3.6
- Added missing disconnect language line so that the button displays correctly on the modify profile page.

3.5
- Allow users to disconnect from Facebook account.

3.3
- Logging out of site no longer logs you out of Facebook.

3.2
- Removed CAPTCHA and email validation options from admin panel, since we no longer make use of those options. Module now imports user email addresses from Facebook.

3.0
- Complete rewrite and update to new Facebook API version. Changed the required information during user registration to make things a lot easier to create a new account.

2.3
- Changed language item for step 3 submission checkbox. Fixed module, because it stopped working a week ago for no apparent reason.

2.0
- Removed the "Post to my Facebook Wall" checkbox for users who are not logged in to a Facebook-associated account.

1.9
- Fixed a bug related to the language file location.
- Fixed directions to the readme file.

1.8
- Fixed a bug that was stopping the module from being able to publish to a Facebook wall on PHP4 servers.

1.7
- Fixed a problem with module not working in conjunction with the vBulletin login module.

1.6
-Fixed a bug where other modules that are loaded on the Facebook login page would show an error message that their language file could not be opened.

1.5
- Fixed a bug from previous version caused by other modules interfering with a module hook, causing the Facebook Connect button to not appear.
- Removed the Facebook information from "Submit Step 1" for users who are not connected to a Facebook account.

1.4
- Fixed CAPTCHA disable option
- Fixed Email Validation disable option
- Fix for Firefox not showing the login button on some browsers.

1.3
- This version should only be used with Pligg 1.0.4 and above.

1.2
- Fix for longer user Facebook IDs. If you are upgrading, please change the varchar value for the user_fb field (under pligg_users) to 255 characters.

1.1
- Added checkbox to the admin panel that lets you enable/disable CAPTCHA requirement for Facebook users
- Added checkbox to the admin panel that lets you enable/disable email verification requirement for FB users
- Changed save message style in admin panel

1.0
- First public release

**kevin4uguys** · 01-20-2010, 12:55 PM

cool module i will buy 4 sure

**kevin4uguys** · 01-20-2010, 01:07 PM

is dis comfortable with pligg 1.0.2

**jonnydep** · 01-20-2010, 02:39 PM

thank you much you are the best ! will use it for 1.0.3

**keg01** · 01-20-2010, 05:48 PM

Hosanna in the Highest! For the love of Pete, approve my purchase before I wet my pants. Thank you Pligg Team - now it gets really interesting! Can't wait to install and announce to user base.

**janpatat** · 01-20-2010, 07:25 PM

1.What is this diverent to add to. (login to facebook and place a story)?
2. What can users do whit it.
3. is it like retweet?
4. Have facebook a live search like twitter.
JP

**nellaitamil** · 01-20-2010, 07:40 PM

nice module.

**Yankidank** · 01-21-2010, 09:12 AM

Originally Posted by kevin4uguys

is dis comfortable with pligg 1.0.2

I can't confirm that it will work with 1.0.2 because we made some big security changes with 1.0.3 that might effect the login process. Either way, I want to encourage users to make the upgrade to 1.0.3 so please don't buy it expecting it to work on earlier versions.

@janpatat
1. The module is used primarily to let users register an account after logging in to Facebook, or connecting an existing Pligg account to their Facebook account. Once they have established a Pligg account to connect to their Facebook account they can login to the site using their Facebook credentials. The module also has the added feature of submitting stories to the logged in user's Facebook Wall. This means that if they want to, they can check a box when submitting a story which will result in the story being published to their wall with a link back to the story.
2. See answer #1.
3. This module does not share anything in common with the Retweet module. It does not get any story information from Facebook or integrate voting in any way to Facebook.
4. Live search for Facebook doesn't make sense to me, since Facebook isn't designed to be used that way. It's also not a feature that I could see being useful for most Pligg sites

I suggest that everyone check out the video demonstration or try the demo site before asking questions about what features this module provides.