Author: Michael Simkin
Email: msimkin@gmail.com

Installation/Upgrade/Support Services

Want this plugin professionally installed? For only $25USD this plugin will be installed on your forum for you and it is GUARANTEED to work or your money back! To get started please send a payment of $25USD to paypal@syscue.com via PayPal. In your message include the following information:

• Forum URL
• Admin username & password (you can set a temporary password)
• FTP username & password (or you can upload the files yourself)
• Contact email address (if different from your PayPal address)
• Your Facebook profile URL (so I can add you as a friend and transfer over the facebook appliction to you).

$10 extra for each additional style.
Installation services will be performed from 5pm EST - 8pm EST

INSTALLATION INSTRUCTIONS

Step 0:

BACK UP YOUR DATABASE AND FILES! Turn off your vBulletin board.

Step 1:

Set up a new Facebook Application through which vBulletin and Facebook will be communicating. Set up a new Facebook Application here: http://www.facebook.com/developers/ (no coding skills required)

• Set the Callback URL to your vBulletin url (example: http://www.siteurl.com/forum/)
• Go to the Canvas tab and set the Canvas Page URL (to whatever you want)
• Set the Render Method to IFrame under the Canvas Settings
• Click on the Connect tab and set the Base Domain to your domain (siteurl.com) without the http or www.

Step 2:

Upload the nessesary files.

Step 3:

Import the product XML file and enable it (if not enabled).

Step 4:

Go to FB Connect Options > Settings and set your application API Key and Secret (available from step 1).

Step 5:

Go to FB Connect Options > News-Feed Templates and register default templates. Then Go to FB Connect Options > Settings and save your settings (even if you don't change anything).

Step 6: Edit Templates

REQUIRED

Template: footer

Find:
<script type="text/javascript">
<!--
// Main vBulletin Javascript Initialization
vBulletin_init();
//-->
</script>

Insert After:
<!-- fbconnect -->
$fbconnect_init
<!-- / fbconnect -->

Template: navbar

Find:
<!-- / login form -->

Insert After:
<!-- fbconnect -->
<center>
<span class="fbconnect" style="height:21px">
<img src="http://static.ak.fbcdn.net/images/loaders/indicator_white_small.gif" alt="Connect with Facebook" />
</span>
</center>
<!-- / fbconnect -->

OPTIONAL - Needed for the news-feeds to work.

Template: newreply

Find:
<form action="newreply.php?do=postreply&amp;t=$threadid" name="vbform" method="post"<if condition="!is_browser('webtv')"> onsubmit="return vB_Editor['$editorid'].prepare_submit(0, $vboptions[postminchars])"</if>>

Replace With:
$fb_prepare_submit
<form action="newreply.php?do=postreply&amp;t=$threadid" name="vbform" method="post"<if condition="!is_browser('webtv')"> onsubmit="return fb_prepare_submit(this, 0)"</if>>

Find:
<input type="submit" class="button" name="sbutton" id="{$editorid}_save" value="$vbphrase[submit_reply]" accesskey="s" tabindex="1" />

Replace With:
<input type="submit" class="button" name="sbutton" id="{$editorid}_save" value="$vbphrase[submit_reply]" accesskey="s" tabindex="1" onclick="isPreview = false" />

Find:
<input type="submit" class="button" name="sbutton" value="$vbphrase[submit_reply]" accesskey="s" tabindex="1" />

Replace With:
<input type="submit" class="button" name="sbutton" value="$vbphrase[submit_reply]" accesskey="s" tabindex="1" onclick="isPreview = false" />

Template: newthread

Find:
<form action="newthread.php?do=postthread&amp;f=$forumid" method="post" name="vbform"<if condition="!is_browser('webtv')"> onsubmit="return vB_Editor['$editorid'].prepare_submit(this.subject.value, $vboptions[postminchars])"</if>>

Replace With:
$fb_prepare_submit
<form action="newthread.php?do=postthread&amp;f=$forumid" method="post" name="vbform"<if condition="!is_browser('webtv')"> onsubmit="return fb_prepare_submit(this, this.subject.value)"</if>>

Find:
<input type="submit" class="button" name="sbutton" id="{$editorid}_save" value="$vbphrase[submit_new_thread]" accesskey="s" tabindex="1" />

Replace With:
<input type="submit" class="button" name="sbutton" id="{$editorid}_save" value="$vbphrase[submit_new_thread]" accesskey="s" tabindex="1" onclick="isPreview = false" />

Find:
<input type="submit" class="button" name="sbutton" value="$vbphrase[submit_new_thread]" accesskey="s" tabindex="1" />

Replace With:
<input type="submit" class="button" name="sbutton" value="$vbphrase[submit_new_thread]" accesskey="s" tabindex="1" onclick="isPreview = false" />

Template: SHOWTHREAD

Find:
<form action="newreply.php?do=postreply&amp;t=$threadid" method="post" name="vbform" onsubmit="return qr_prepare_submit(this, $vboptions[postminchars]);" id="qrform">

Replace With:
<form action="newreply.php?do=postreply&amp;t=$threadid" method="post" name="vbform" onsubmit="return fb_qr_prepare_submit(this, $vboptions[postminchars]);" id="qrform">

Find:
<!-- / quick reply -->

Insert Before:
$fb_qr_prepare_submit

OPTIONAL - Allows users to set their facebook email preferences

Template: USERCP_SHELL

Find:
<tr><td class="$navclass[password]" nowrap="nowrap"><a class="smallfont" href="profile.php?$session[sessionurl]do=editpassword">$vbphrase[edit_email_and_password]</a></td></tr>

Replace With:
<if condition="$bbuserinfo[fbemail]">
<tr><td class="$navclass[password]" nowrap="nowrap"><a class="smallfont" href="#" onclick="facebook_prompt_permission('email'); return false;">$vbphrase[fbconnect_email_settings]</a></td></tr>
<else />
<tr><td class="$navclass[password]" nowrap="nowrap"><a class="smallfont" href="profile.php?$session[sessionurl]do=editpassword">$vbphrase[edit_email_and_password]</a></td></tr>
</if>

Template: modifyprofile

Find:
<fieldset class="fieldset">
<legend>$vbphrase[email_and_password]</legend>
<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
<tr>
<td>$vbphrase[click_button_below_edit_email]</td>
</tr>
<tr>
<td>
<!-- don't remove -->
<input type="image" src="$vboptions[cleargifurl]" style="width: 1px; height: 1px;" />
<!-- / don't remove -->
<input type="submit" class="button" style="font-weight:normal" value="$vbphrase[edit_email_and_password]" name="gotopassword" />
</td>
</tr>
</table>
</fieldset>

Replace With:
<fieldset class="fieldset">
<if condition="$bbuserinfo[fbemail]">
<legend>$vbphrase[fbconnect_email_settings]</legend>
<a href="#" onclick="facebook_prompt_permission('email'); return false;">$vbphrase[set_email_notification_settings]</a>
<else />
<legend>$vbphrase[email_and_password]</legend>
<table cellpadding="0" cellspacing="$stylevar[formspacer]" border="0" width="100%">
<tr>
<td>$vbphrase[click_button_below_edit_email]</td>
</tr>
<tr>
<td>
<!-- don't remove -->
<input type="image" src="$vboptions[cleargifurl]" style="width: 1px; height: 1px;" />
<!-- / don't remove -->
<input type="submit" class="button" style="font-weight:normal" value="$vbphrase[edit_email_and_password]" name="gotopassword" />
</td>
</tr>
</table>
</if>
</fieldset>

OPTIONAL - Adds the login button to the Login Required message.

Template: STANDARD_ERROR

Find:
</fieldset>

Insert Before:
<!-- fbconnect -->
$fbconnect_button
<!-- / fbconnect -->

Template: STANDARD_ERROR_LITE

Find:
</fieldset>

Insert Before:
<!-- fbconnect -->
$fbconnect_button
<!-- / fbconnect -->

Template: STANDARD_ERROR_LOGIN

Find:
</fieldset>

Insert Before:
<!-- fbconnect -->
$fbconnect_button
<!-- / fbconnect -->

Step 7:

Check FB Connect Options > Settings for new settings and FB Connect Options >Data Mapping to map Facebook data.