JomSocial Documentation - User contributions [en]

Setting up Facebook Connect

2014-06-05T13:01:22Z

Eric: /* One last thing */

{{alert|<center>Before you begin implementing the '''Facebook Connect''' feature on your website, make sure you have read the [https://developers.facebook.com/policy/ '''Facebook Connect Policy''']</center>|alert}}
{{alert|<center>'''Images disclaimer:''' This article contains images from third party sources which we do not have access to. Some configuration screenshots may be different</center>|alert-info}}
===Overview===
Facebook Connect is a system that allows any user with a Facebook account to join your site easily with just one single click. It saves your visitor the hassle of registering to yet another site and maintaining another username and password. With this system, your site can easily verify the identity of your site visitor and log them into your site easily.

==Video tutorial==
{{#ev:vimeo|95505901|800}}

Facebook Connect delivers a number of benefits, including:

*'''Traffic''' - Enable over a billion Facebook users to share your content with their friends on Facebook. Let users publish a story, invite their friends, or send an event. Their friends can then click to visit your site.
*'''Engagement''' - Users can immediately find their friends and engage. More friends leads to more activity and more page views. Connected users create 15-60% more content than users who have not connected with Facebook Connect.
*'''Registration''' - Every website wants registration to be easy. We can offer access to one billion users, simple registration, and robust data. By increasing traffic, user engagement, and registrations, you can grow your revenue and increase your monetization opportunities.

==Creating the Facebook App==
To setup Facebook connect, you will first need to create a new application in Facebook by accessing https://developers.facebook.com/apps. You are required to have a Facebook account.
At the top right, there should be a button called '''Create New App'''; click it.
Give your application a '''name'''. This name will appear as your applications and you are not allowed to use any name. You will have to read through Facebook’s Terms of Service before accepting it. <br/>
Select the '''category''' for your application and click '''Create App'''
:::[[File:Fb1.png]]
If prompted, enter captcha text and submit.
You will then be redirected to your application's '''Dashboard''' page.<br/>
:::[[File:Fbdashboard.png]]
Move to settings page in the left-hand navigation panel and from the right pane click on '''Add Platform'''<br/>
Select '''Website'''<br/>
In the '''Site URL''' and '''Mobile Site URL''' fields enter [http://en.wikipedia.org/wiki/Fully_qualified_domain_name FQDN] of your site and save changes<br>
In the field '''App Domains''' enter just the domain name '''''without''''' http:// or www and save changes
::: [[File:Fbcfinal.png]]

===Using the Keys In JomSocial===

Go to JomSocial Configuration > Facebook Connect and paste the '''App ID''' into the '''Facebook API Key''' and the '''App Secret''' into the '''Facebook Application Secret''' field.<br/>

::: [[File:fbc3.jpg]]

<font color=cornflowerblue>'''Congratulations!'''</font> JomSocial Facebook Connect is now set up on your website!

==One last thing==
With the recent changes in Facebook privacy, your application will have to be reviewed by Facebook in order for all JomSocial features to work. Click on the '''Submit them for review'''. This usually takes only several hours.
::: [[File:Fbcreview.png]]

==See Also==
* [[Facebook Connect on localhost]]

System Requirements

2014-05-16T08:41:09Z

Eric: /* Server Requirements */

{{alert|'''WARNING''' - These system requirements are for '''JomSocial 3'''. To see the requirements for earlier versions, please, [[Jomsocial 2 System Requirements|click here]]|alert-danger}}
==Joomla! Requirements==
{{alert|'''JomSocial is an extension for Joomla. To be able to use JomSocial, you would first need to install Joomla on your web host.'''|alert}}
We recommend using the latest stable version of Joomla (currently 3.1) to enjoy its latest features and security improvements. JomSocial 3 supports the minimum of:
* Joomla! 2.5.6 or above
* Joomla! 3.0 and above
To see full compatibility sheet list, please, visit [[Joomla Versions Compatibility|this page]]

===Video tutorial===
{{#ev:youtube|IriHrkWt2_A|800}}

==Server Requirements==
# PHP 5.3.1 or above
# MySQL 5.0.4 or above
#* '''Temporary Tables''' - Your database user must have the priviledge to create temporary tables.
# JomSocial 3 also requires several PHP extensions, which are available in most webhosting providers:
#* '''GD library''' - at least v1.8 with libjpeg to process images. Alternatively, you can use [http://www.imagemagick.org/script/index.php imagemagick]
#* '''cURL library''' - for [[Linking Video|Video Linking]] and [[Setting up Facebook Connect|Facebook Connect]]
#* '''zip'''
#* '''fsockopen''' - for [[Setting up Facebook Connect|Facebook Connect]]
#* '''mime library'''
# For video uploads, you will need:
#* '''[http://ffmpeg.org/ FFMPEG]''' - to convert uploaded videos. Most shared webhosting providers disable this option because it consumes a lot of memory and processing power. Please consult your webhosting provider regarding the availability of FFMPEG on your server. It is advisable to at least have VPS before you consider allowing video uploading.
#* '''exec/passthru/shell_exec/system access'''
#* '''(Optional) FLVTool2''' -, for adding metadata to your video
# [[Setting up Cron Job|Cron Jobs]].- To trigger emails ready to be send, as well as triggering the FFMPEG to convert videos

{{alert|'''Note in ImageMagick:''' To process images, photo upload relies heavily on the GD Library, which uses a lot of memory. For better performance, use ImageMagick instead, if your server supports it.|alert-info}}
{{alert|If you want to allow big images and video files upload (over 1GB) please, [[Video Linking & Upload Requirements|'''check full requirements here''']]|alert}}

==System Specifications==
===PHP and MySQL Configurations===
<table>
<caption>'''To be able to install JomSocial 3, your server PHP and MySQL environment will have to meet these specifications'''</caption>
<tr>
<th class="span1"><center>'''File'''</center></th>
<th class="span3"><center>'''Value'''</center></th>
<th class="span4 warning"><center>'''Minimum'''</center></th>
<th class="span4 success"><center>'''Recommended'''</center></th>
</tr>

<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|max_execution_time|Maximum Execution Time|Maximum execution time of each script, in seconds.}}</center></td>
<td class="warning"><center>30</center></td>
<td class="success"><center>300</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|max_input_time|Maximum Input Tme|Maximum amount of time each script may spend parsing request data}}</center></td>
<td class="warning"><center>30</center></td>
<td class="success"><center>300</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|memory_limit|PHP Memory Limit|Maximum amount of memory a script may consume}}</center></td>
<td class="warning"><center>128M</center></td>
<td class="success"><center>1024M</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|post_max_size|Maximum Size of POST Data|Maximum size of POST data that PHP will accept}}</center></td>
<td class="warning"><center>8M</center></td>
<td class="success"><center>4096M</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|upload_max_filesize|Maximum Filesize for Upload|Maximum allowed size for uploaded files.}}</center></td>
<td class="warning"><center>8M</center></td>
<td class="success"><center>4096M</center></td>
</tr>


<tr>
<td><center>my.cnf</center></td>
<td><center>connect_timeout</center></td>
<td class="warning"><center>10</center></td>
<td class="success"><center>120</center></td>
</tr>


<tr>
<td><center>my.cnf</center></td>
<td><center>wait_timeout</center></td>
<td class="warning"><center>10</center></td>
<td class="success"><center>120</center></td>
</tr>

</table>

===How to Check for System Specifications===
You can check most of the requirements below by accessing Joomla's backend via your Administrator Panel and going to System > System Information and PHP Information tab. However, for the most complete overview of your server configuration, contact your webhosting provider.
::: [[File:jsysinfo.png]]
::: [[File:jphpinfo.png]]

==Additional Requirements==
'''Disable safe_mode and open_basedir'''
Some webhosting providers have safe_mode and openbase_dir enabled. In order for the photo/video upload to work, you have to disable them. If your webhosting provier allows you to override the Apache's configuration, you need to override the vhost configuration.
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

If your webhosting provider allows for .htaccess override, locate your .htaccess file in the Joomla root directory and add these lines into it:
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

==A Note on PHP Memory Requirements==
JomSocial is developed to run adequately on a system with just 32MB of memory allocated to PHP. However, please note that the development site uses the default template with no additional third-party modules or plugins enabled. Sites with third-party plugins and modules enabled will consume a lot more memory; thus, we recommend that you increase your memory limit.

That having been said, since all applications will run better with more memory, we recommend that you allocate at least 128MB of memory to PHP. The following tasks will consume a lot of memory:
# resizing uploaded user avatar
# resizing any photos uploaded by user
# converting uploaded videos to .mp4

==See Also==
* [[Jomsocial 2 System Requirements]]
* [[Setting Up Cron Job]]

System Requirements

2014-05-07T07:32:26Z

Eric: /* PHP and MySQL Configurations */

{{alert|'''WARNING''' - These system requirements are for '''JomSocial 3'''. To see the requirements for earlier versions, please, [[Jomsocial 2 System Requirements|click here]]|alert-danger}}
==Joomla! Requirements==
{{alert|'''JomSocial is an extension for Joomla. To be able to use JomSocial, you would first need to install Joomla on your web host.'''|alert}}
We recommend using the latest stable version of Joomla (currently 3.1) to enjoy its latest features and security improvements. JomSocial 3 supports the minimum of:
* Joomla! 2.5.6 or above
* Joomla! 3.0 and above
To see full compatibility sheet list, please, visit [[Joomla Versions Compatibility|this page]]

===Video tutorial===
{{#ev:youtube|IriHrkWt2_A|800}}

==Server Requirements==
# PHP 5.3.1 or above
# MySQL 4.1 or above
#* '''Temporary Tables''' - Your database user must have the priviledge to create temporary tables.
# JomSocial 3 also requires several PHP extensions, which are available in most webhosting providers:
#* '''GD library''' - at least v1.8 with libjpeg to process images. Alternatively, you can use [http://www.imagemagick.org/script/index.php imagemagick]
#* '''cURL library''' - for [[Linking Video|Video Linking]] and [[Setting up Facebook Connect|Facebook Connect]]
#* '''zip'''
#* '''fsockopen''' - for [[Setting up Facebook Connect|Facebook Connect]]
#* '''mime library'''
# For video uploads, you will need:
#* '''[http://ffmpeg.org/ FFMPEG]''' - to convert uploaded videos. Most shared webhosting providers disable this option because it consumes a lot of memory and processing power. Please consult your webhosting provider regarding the availability of FFMPEG on your server. It is advisable to at least have VPS before you consider allowing video uploading.
#* '''exec/passthru/shell_exec/system access'''
#* '''(Optional) FLVTool2''' -, for adding metadata to your video
# [[Setting up Cron Job|Cron Jobs]].- To trigger emails ready to be send, as well as triggering the FFMPEG to convert videos

{{alert|'''Note in ImageMagick:''' To process images, photo upload relies heavily on the GD Library, which uses a lot of memory. For better performance, use ImageMagick instead, if your server supports it.|alert-info}}
{{alert|If you want to allow big images and video files upload (over 1GB) please, [[Video Linking & Upload Requirements|'''check full requirements here''']]|alert}}

==System Specifications==
===PHP and MySQL Configurations===
<table>
<caption>'''To be able to install JomSocial 3, your server PHP and MySQL environment will have to meet these specifications'''</caption>
<tr>
<th class="span1"><center>'''File'''</center></th>
<th class="span3"><center>'''Value'''</center></th>
<th class="span4 warning"><center>'''Minimum'''</center></th>
<th class="span4 success"><center>'''Recommended'''</center></th>
</tr>

<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|max_execution_time|Maximum Execution Time|Maximum execution time of each script, in seconds.}}</center></td>
<td class="warning"><center>30</center></td>
<td class="success"><center>300</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|max_input_time|Maximum Input Tme|Maximum amount of time each script may spend parsing request data}}</center></td>
<td class="warning"><center>30</center></td>
<td class="success"><center>300</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|memory_limit|PHP Memory Limit|Maximum amount of memory a script may consume}}</center></td>
<td class="warning"><center>128M</center></td>
<td class="success"><center>1024M</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|post_max_size|Maximum Size of POST Data|Maximum size of POST data that PHP will accept}}</center></td>
<td class="warning"><center>8M</center></td>
<td class="success"><center>4096M</center></td>
</tr>


<tr>
<td><center>php.ini</center></td>
<td><center>{{pop|upload_max_filesize|Maximum Filesize for Upload|Maximum allowed size for uploaded files.}}</center></td>
<td class="warning"><center>8M</center></td>
<td class="success"><center>4096M</center></td>
</tr>


<tr>
<td><center>my.cnf</center></td>
<td><center>connect_timeout</center></td>
<td class="warning"><center>10</center></td>
<td class="success"><center>120</center></td>
</tr>


<tr>
<td><center>my.cnf</center></td>
<td><center>wait_timeout</center></td>
<td class="warning"><center>10</center></td>
<td class="success"><center>120</center></td>
</tr>

</table>

===How to Check for System Specifications===
You can check most of the requirements below by accessing Joomla's backend via your Administrator Panel and going to System > System Information and PHP Information tab. However, for the most complete overview of your server configuration, contact your webhosting provider.
::: [[File:jsysinfo.png]]
::: [[File:jphpinfo.png]]

==Additional Requirements==
'''Disable safe_mode and open_basedir'''
Some webhosting providers have safe_mode and openbase_dir enabled. In order for the photo/video upload to work, you have to disable them. If your webhosting provier allows you to override the Apache's configuration, you need to override the vhost configuration.
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

If your webhosting provider allows for .htaccess override, locate your .htaccess file in the Joomla root directory and add these lines into it:
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

==A Note on PHP Memory Requirements==
JomSocial is developed to run adequately on a system with just 32MB of memory allocated to PHP. However, please note that the development site uses the default template with no additional third-party modules or plugins enabled. Sites with third-party plugins and modules enabled will consume a lot more memory; thus, we recommend that you increase your memory limit.

That having been said, since all applications will run better with more memory, we recommend that you allocate at least 128MB of memory to PHP. The following tasks will consume a lot of memory:
# resizing uploaded user avatar
# resizing any photos uploaded by user
# converting uploaded videos to .mp4

==See Also==
* [[Jomsocial 2 System Requirements]]
* [[Setting Up Cron Job]]