JomSocial Documentation - User contributions [en]

Migrate Joomla 2.5 With JomSocial 2.8.x to Joomla 3 and JomSocial 3.0.x

2013-07-31T12:55:35Z

Eric Tracz: /* Starting the Migration */

===Preparation===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved. We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg|800}}

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Migration===
# Again, '''make sure the backup of the entire site is done'''.
# Navigate to: Extensions > Extensions Manager, select '''Manage''' and uninstall '''everything''' that is third party and not native Joomla. That means all templates, plugins, modules, components. Of course including JomSocial.
# Make sure there are '''no 3rd party extensions left''' and that you indeed have a '''clean''' Joomla site.
# Open a new tab and go to Joomla.org site and download the update package. The latest Joomla 3 update packages can be found here [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=6674 Joomla 3 Upgrade Packages]
# Right click on the latest Stable Update Package and '''Copy Link Address'''.
# Go back to the tab with your Joomla backend open. Navigate to: Extensions > Extension Manager: Install, in the last field '''Install from URL''' paste the copied URL and click Install.
# '''Wait for your site to get upgraded.''' It should reload and show you the status of the upgrade in '''Joomla 3 backend'''.
# '''Install JomSocial 3'''.
# Install the rest of extensions that you wish to have on your site.

It really is ''that'' simple! ;)

Here you can see a video on Migrating and Upgrading JomSocial:

{{#ev:youtube|t8m8WeMW85o|800}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Migrate Joomla 2.5 With JomSocial 2.8.x to Joomla 3 and JomSocial 3.0.x

2013-07-31T12:54:51Z

Eric Tracz:

===Preparation===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved. We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg|800}}

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Migration===
# Again, '''make sure the backup of the entire site is done'''.
# Navigate to: Extensions > Extensions Manager, select '''Manage''' and uninstall '''everything''' that is third party and not native Joomla. That means all templates, plugins, modules, components. Of course including JomSocial.
# Make sure there are '''no 3rd party extensions left''' and that you indeed have a '''clean''' Joomla site.
# Open a new tab and go to Joomla.org site and download the update package. The latest Joomla 3 update packages can be found here [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=6674 Joomla 3 Upgrade Packages]
# Right click on the latest Stable Update Package and '''Copy Link Address'''.
# Go back to the tab with your Joomla backend open. Navigate to: Extensions > Extension Manager: Install, in the last field '''Install from URL''' paste the copied URL and click Install.
# '''Wait for your site to get upgraded.''' It should reload and show you the status of the upgrade in '''Joomla 3 backend'''.
# '''Install JomSocial 3'''.
# Install the rest of extensions that you wish to have on your site.

It really is ''that'' simple! ;)

Here you can see a video on Migrating and Upgrading JomSocial:

{{#ev:youtube|t8m8WeMW85o}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Migrate Joomla 2.5 With JomSocial 2.8.x to Joomla 3 and JomSocial 3.0.x

2013-07-31T12:54:44Z

Eric Tracz:

===Preparation===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved. We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg|800px}}

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Migration===
# Again, '''make sure the backup of the entire site is done'''.
# Navigate to: Extensions > Extensions Manager, select '''Manage''' and uninstall '''everything''' that is third party and not native Joomla. That means all templates, plugins, modules, components. Of course including JomSocial.
# Make sure there are '''no 3rd party extensions left''' and that you indeed have a '''clean''' Joomla site.
# Open a new tab and go to Joomla.org site and download the update package. The latest Joomla 3 update packages can be found here [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=6674 Joomla 3 Upgrade Packages]
# Right click on the latest Stable Update Package and '''Copy Link Address'''.
# Go back to the tab with your Joomla backend open. Navigate to: Extensions > Extension Manager: Install, in the last field '''Install from URL''' paste the copied URL and click Install.
# '''Wait for your site to get upgraded.''' It should reload and show you the status of the upgrade in '''Joomla 3 backend'''.
# '''Install JomSocial 3'''.
# Install the rest of extensions that you wish to have on your site.

It really is ''that'' simple! ;)

Here you can see a video on Migrating and Upgrading JomSocial:

{{#ev:youtube|t8m8WeMW85o}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Uploading Video

2013-07-31T11:34:38Z

Eric Tracz:

===Overview===

To upload videos, you will first have to [[Setting Up Video Galleries|enable]] Video Galleries and have at least one [[Creating Video Categories|category created]]. Also, make sure that your server meets all [[Video Linking & Upload Requirements|requirements]] needed for video uploading.

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

===Starting the Video Upload===

Go to the any '''Video'''-related page and click '''Add''': 

::: [[File:Videoadd.png]] 

The popup window will appear, giving you the option to link or upload a video. Please select '''Upload Video''': 

::: [[File:Videoadd1.png]] 

# '''Select video file''' - Navigate to the physical file on your computer and input it here. Alternatively, click '''Browse''' and an additional popup window to search for file will appear.
# '''Title''' - This field is also mandatory and will be used as a Video Title.
# '''Description''' - Description of video that will be uploaded.
# '''Location''' - If enabled, Video Location field will be displayed.
# '''Category''' - You must select the category where video will be stored.
# '''Who can see''' - Privacy setting for the video.

After the fields are filled properly, click '''Upload Video''' and wait for the video to upload. Depending on the video size and your Internet connection, the upload can take anywhere from several seconds to several hours. 

::: [[File:Videoadd2.png]]

===After Uploading===

Once the upload is finished, the video is stored in the '''Pending Videos''' list waiting for the [[Setting up Cron Job|cron job]] to trigger the FFMPEG conversion: 

::: [[File:Videoadd3.png]] 

Once the '''Video''' is converted, it will be available to watch on your JomSocial-powered website: 

::: [[File:Videoadd4.png]]

How to change default cover for events / groups / male / female / unidentified users

2013-07-26T16:21:43Z

Eric Tracz:

{{alert|<center>NOTE: The following instructions show how to change core JomSocial files. All changes you make to JomSocial core files will be overwritten with your next upgrade so you'll need to at least re-apply the modifications to core JomSocial files.</center>|alert}}

If you're wondering how to change the default covers for events, groups, male, female and unidentified users (gender), look no further. The whole operation may take between 30seconds to 5 minutes. Mostly depending on how well you know your computer.

Prepare your versions of covers. The dimensions should be: '''1140px × 428px''' - '''each''' cover/file.

Once your files are ready. Connect via FTP to the server and go to this directory: '''/components/com_community/templates/default/images/cover/'''

In that directory you have the following files:

[[File:cover_files.png]]

* event-default.png
* group-default.png
* female-default.png
* male-default.png
* undefined-default.png

Make sure that your versions of the files (or file) are named exactly as their original counterparts. After that, rename the original files on the server in the following (or similar) manner:

* '''bak_'''event-default.png
* '''bak_'''group-default.png
* '''bak_'''female-default.png
* '''bak_'''male-default.png
* '''bak_'''undefined-default.png

Next, upload your files to the directory, clear your browser's cache, site cache and check the frontend. Done.

{{alert|'''Hint:''' It's always a good idea to have a list of all modifications / personalizations done to JomSocial core files and their backups. That way after an upgrade it's easier to re-apply your mods.}}

File:Cover files.png

2013-07-26T16:19:28Z

Eric Tracz:

How to change default cover for events / groups / male / female / unidentified users

2013-07-26T16:19:16Z

Eric Tracz:

{{alert|<center>NOTE: The following instructions show how to change core JomSocial files. All changes you make to JomSocial core files will be overwritten with your next upgrade so you'll need to at least re-apply the modifications to core JomSocial files.</center>|alert}}

If you're wondering how to change the default covers for events, groups, male, female and unidentified users (gender), look no further. The whole operation may take between 30seconds to 5 minutes. Mostly depending on how well you know your computer.

Prepare your versions of covers. The dimensions should be: '''1140px × 428px''' - '''each''' cover/file.

Once your files are ready. Connect via FTP to the server and go to this directory: /components/com_community/templates/default/images/cover/

In that directory you have the following files:

[[File:cover_files.png]]

* event-default.png
* group-default.png
* female-default.png
* male-default.png
* undefined-default.png

Make sure that your versions of the files (or file) are named exactly as their original counterparts. After that, rename the original files on the server in the following (or similar) manner:

* '''bak_'''event-default.png
* '''bak_'''group-default.png
* '''bak_'''female-default.png
* '''bak_'''male-default.png
* '''bak_'''undefined-default.png

Next, upload your files to the directory, clear your browser's cache, site cache and check the frontend. Done :)

I hope that helps you guys make your community more 'personal'.

How to change default cover for events / groups / male / female / unidentified users

2013-07-26T16:18:12Z

Eric Tracz: Created page with "{{alert|<center>NOTE: The following instructions show how to change core JomSocial files. All changes you make to JomSocial core files will be overwritten wit..."

{{alert|<center>NOTE: The following instructions show how to change core JomSocial files. All changes you make to JomSocial core files will be overwritten with your next upgrade so you'll need to at least re-apply the modifications to core JomSocial files.</center>|alert}}

If you're wondering how to change the default covers for events, groups, male, female and unidentified users (gender), look no further. The whole operation may take between 30seconds to 5 minutes. Mostly depending on how well you know your computer.

Prepare your versions of covers. The dimensions should be: '''1140px × 428px''' - '''each''' cover/file.

Once your files are ready. Connect via FTP to the server and go to this directory: /components/com_community/templates/default/images/cover/

In that directory you have the following files:

* event-default.png
* group-default.png
* female-default.png
* male-default.png
* undefined-default.png

Make sure that your versions of the files (or file) are named exactly as their original counterparts. After that, rename the original files on the server in the following (or similar) manner:

* '''bak_'''event-default.png
* '''bak_'''group-default.png
* '''bak_'''female-default.png
* '''bak_'''male-default.png
* '''bak_'''undefined-default.png

Next, upload your files to the directory, clear your browser's cache, site cache and check the frontend. Done :)

I hope that helps you guys make your community more 'personal'.

Setting Up Cron Job

2013-07-23T09:28:48Z

Eric Tracz:

{{alert|<center>NOTE!!! This page contains images which show settings examples for resources that are outside of our scope. If your settings are not same as the ones presented here, please contact your webhosting provider for further instructions </center>|alert}}
===Overview of Cron Jobs===
For JomSocial to run properly, you will need to set up a Cron job to run periodically. By unloading a processing task to a scheduled job, JomSocial will be able to run faster and smoother.

===Video tutorial===
{{#ev:youtube|cRddvh-R6xY|800}}

The Cron job is required to:
# Avoid excessive processing to send out system emails during a normal page load.
# Archive old activity stream logs that are no longer relevant.
# Convert uploaded videos to standardized .swf files.
# Perform optional administrative jobs such as remove old, unused photo album, which doesn't have any photos

===Built-In Cron Job Option===
::: [[File:cron.jpg]] 
Use this option if you are not using JomSocial video upload feature. By enabling this, JomSocial will process Cron on every page load, with an interval of five (5) minutes in between.

# This option will only process email-related Crons. It will not run any maintenance script, Amazon S3 transfer, or video conversion.
# Avoid this option if your site is heavy with concurrent users (10+ users at one time) because it may have effect on performance.
# Avoid this option if you enable video upload feature and rely on other Cronjob methods instead.

===Cron on Linux Systems===
On most Linux systems, you can simply run the commands below. We would recommend running the Cron every thirty (30) minutes or less. On a busy site, you might want to run it every ten (10) minutes. The more frequently you run it, the less load there will be on the server. 
* lynx -source "http://www.domain.com/index.php?option=com_community&task=cron" > /dev/null
Lynx is a text-based browser that is installed in most hosting environments. If you do not have Lynx installed, you can use other alternatives such as wget, shown below:
* wget -O /dev/null "http://www.domain.com/index.php?option=com_community&task=cron" > /dev/null
Don't worry, this operation actually runs very fast and has very little impact on the server, equivalent to a normal single page load.

{{alert|Note: When setting up this command, make sure you put in your full, valid domain name; 'localhost' will not suffice.|alert-info}}

===Setting Up Cron Job in cPanel 11===
To add a new CronJob in cPanel 11, login to your cPanel and click '''Cronjobs''' under the '''Advanced''' section as the screenshot below. 
::: [[File:cronjob1.jpg]]

After clicking '''Cronjobs''', you will be directed to a page similar to the one below. In this example, click '''Standard''' to proceed. 
::: [[File:cronjob2.jpg]]

Enter the following command in the '''Command to run''' field on the screen shown below it: 
* lynx -source "http://www.yoursite.com/index.php?option=com_community&task=cron" > /dev/null
Select '''Every Five Minutes''', '''Every Hour''', '''Every Day''', '''Every Month''', and '''Every Week Day''' so that the action above will be executed every five (5) minutes perpetually. 
::: [[File:cronjob3.jpg]]

{{alert|Note: In order for the emails to be sent and videos to be converted, the scheduled task ''must be'' executed correctly.|alert-info}}

===Cron Jobs at GoDaddy===
GoDaddy doesn't support cronjobs from the panel. Using an online cron scheduler (look below) should solve the problem.

===Free Online Cron Scheduler===
If you are still having trouble with the above options, use any free online Cronjob scheduler service available on the web.
Do not worry on security because what these sites do is merely accessing index.php?option=com_community&task=cron at certain interval, which is open to anyone.

'''Popular services include:''' 
* [http://www.setcronjob.com Set CronJob]
* [http://www.cronless.com/ Cronless]
* [http://www.joomlarefinery.com/extensions/jr-jcron.html Joomla Rafinery]

Video Linking & Upload Requirements

2013-07-23T09:20:13Z

Eric Tracz:

===Video Upload Requirements===

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

====Video Linking====

Linking from external websites such as YouTube, Metacafe, and Vimeo only requires cURL to be installed, which is available in most webhosting providers' cURL library.

====Video Uploading====

# Video upload uses FFMPEG to convert videos. Most shared webhosting providers disable this option because it consumes a lot of memory and processing power. Please contact your webhosting provider regarding the availability of FFMPEG on your server. It is advisable to have at least VPS before you consider allowing video uploads.
# Minimum: FFMPEG; to get it running, it also requires exec/passthru/shell_exec/system access.
# Optional: FLVTool2, for adding metadata to your video.

Unlike other extensions, the path to FFMPEG and FLVTool2 need to be specified on your JomSocial Backend. Go to Site > Configuration and look for the "Videos" section. There you will find the fields to set both paths. 

::: [[File:ffmpegsettings.png]]

One last thing that JomSocial needs to process the video is a Cronjob (scheduled task). Make sure your Cronjob is configured properly by referring to [[Setting up Cron Job|this documentation]].

====Large Photo/video Uploading====

When it comes to large photo/video uploads, there are a few server configurations that you can tweak to get the most out of JomSocial:

'''php.ini'''
# max_execution_time = 9000; Maximum execution time of each script, in seconds.
# max_input_time = 9000; Maximum amount of time each script may spend parsing request data.
# memory_limit = 1024M; Maximum amount of memory a script may consume.
# post_max_size = 1024M; Maximum size of POST data that PHP will accept.
# upload_max_filesize = 1024M; Maximum allowed size for uploaded files.

'''my.cnf'''
# wait_timeout = 120
# connect_timeout = 120

'''Disable safe_mode and open_basedir'''
# Some hosting 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 provider 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 webhost allows for .htaccess override, locate your .htaccess file in the root Joomla directory and add these lines into it:
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

ZenCoder and Amazon S3 Integration

2013-07-23T09:19:43Z

Eric Tracz:

{{alert|<center>NOTE!!! This page contains images from sources that are outside of our scope. If they are not same as presented here, please refer to the original source documentation.</center>|alert}}

===Introduction===

ZenCoder makes it easy for a community that has no FFMPEG access on its server to upload and convert videos using a Third-Party video conversion service. Recently, there are some updates on Amazon's AWS service that would require you to setup a special "bucket policy" to allow an external service to add and retrieve files.

After inputting ZenCoder credentials in JomSocial Configuration, you will need to configure Amazon S3 to allow file uploading and downloading from the S3 Bucket.

===Video tutorial===
The video shows how to setup video uploads and also features setting up Amazon S3 and Zencoder integration. Amazon S3 and Zencoder integration start at 4:18 in the video.

{{#ev:youtube|SklUestiz2M|800}}

===Setting It Up===

# To get started, please login to the [http://aws.amazon.com/console/ Amazon AWS Console]:
#;:: [[File:Amazon5.jpg]]
# Once you have logged in, please select the '''correct bucket''' that you will use for ZenCoder video files:
#;:: [[File:Amazon1.jpg]]
# Then click '''Properties''':
#;:: [[File:Amazon2.jpg]]
# A bar will appear at the bottom; click '''Add bucket policy''':
#;:: [[File:Amazon3.jpg]]
# In the popup window, '''Copy and Paste this Policy''':

<syntaxhighlight lang="php">
{
"Id": "ZencoderBucketPolicy",
"Statement": [
{
"Sid": "Stmt1295042087538",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::395540211253:root"
},
"Action": ["s3:PutObject", "s3:GetObject", "s3:PutObjectAcl", "s3:GetBucketLocation", "s3:ListBucketMultipartUploads", "s3:ListMultipartUploadParts"],
"Resource": "arn:aws:s3:::MY-BUCKET/*"
}
]
}
</syntaxhighlight>
 
::: [[File:Amazon4.jpg]] 

You are '''''almost''''' ready, but '''first''', you will need to change the '''MY-BUCKET''' text in the above code. 

# Replace 'MY-BUCKET' with your own bucket name.
# Do not delete the /* that appears after the bucket name. This is important to ensure that all files within the bucket will have the preconfigured access privilege.

Save and you are now ready to go!

[https://app.zencoder.com/docs/guides/getting-started/working-with-s3 Reference]

ZenCoder and Amazon S3 Integration

2013-07-23T09:19:30Z

Eric Tracz:

{{alert|<center>NOTE!!! This page contains images from sources that are outside of our scope. If they are not same as presented here, please refer to the original source documentation.</center>|alert}}

===Introduction===

ZenCoder makes it easy for a community that has no FFMPEG access on its server to upload and convert videos using a Third-Party video conversion service. Recently, there are some updates on Amazon's AWS service that would require you to setup a special "bucket policy" to allow an external service to add and retrieve files.

After inputting ZenCoder credentials in JomSocial Configuration, you will need to configure Amazon S3 to allow file uploading and downloading from the S3 Bucket.

===Video tutorial===
The video shows how to setup video uploads and also features setting up Amazon S3 and Zencoder integration. Amazon S3 and Zencoder integration start at 4:18 in the video.
{{#ev:youtube|SklUestiz2M|800}}

===Setting It Up===

# To get started, please login to the [http://aws.amazon.com/console/ Amazon AWS Console]:
#;:: [[File:Amazon5.jpg]]
# Once you have logged in, please select the '''correct bucket''' that you will use for ZenCoder video files:
#;:: [[File:Amazon1.jpg]]
# Then click '''Properties''':
#;:: [[File:Amazon2.jpg]]
# A bar will appear at the bottom; click '''Add bucket policy''':
#;:: [[File:Amazon3.jpg]]
# In the popup window, '''Copy and Paste this Policy''':

<syntaxhighlight lang="php">
{
"Id": "ZencoderBucketPolicy",
"Statement": [
{
"Sid": "Stmt1295042087538",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::395540211253:root"
},
"Action": ["s3:PutObject", "s3:GetObject", "s3:PutObjectAcl", "s3:GetBucketLocation", "s3:ListBucketMultipartUploads", "s3:ListMultipartUploadParts"],
"Resource": "arn:aws:s3:::MY-BUCKET/*"
}
]
}
</syntaxhighlight>
 
::: [[File:Amazon4.jpg]] 

You are '''''almost''''' ready, but '''first''', you will need to change the '''MY-BUCKET''' text in the above code. 

# Replace 'MY-BUCKET' with your own bucket name.
# Do not delete the /* that appears after the bucket name. This is important to ensure that all files within the bucket will have the preconfigured access privilege.

Save and you are now ready to go!

[https://app.zencoder.com/docs/guides/getting-started/working-with-s3 Reference]

System Requirements

2013-07-23T09:15:34Z

Eric Tracz:

{{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]]
# 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>6M</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>6M</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 Help > System Info > 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]]

Setting up Facebook Connect

2013-07-23T09:14:34Z

Eric Tracz:

{{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}}
===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:youtube|VxQBh6bZSzo|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===
::: [[File:fbc1.jpg]]

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 restricted to use any name. You will have to read through Facebook’s Terms of Service before accepting it.

You will then be redirected to your application's '''Basic Info''' page. Please be sure to fill in every detail shown in the picture below that is marked with an asterisk (*). 

::: [[File:fbc2.jpg]]

Do not leave the '''App Domain''' field empty. Enter the '''domain name''' as shown in the image above.
Please be certain that the '''Site URL''' is in the full format, i.e: http://www.mysitedomain.com.
Save the changes.

===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. 

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

'''Congratulations!''' JomSocial Facebook Connect is now set up on your website! 

{{alert|Note: It may take from a few minutes to an hour for your application to be active on all Facebook servers.|alert-info}}

Setting up Amazon S3

2013-07-23T09:14:08Z

Eric Tracz:

===Overview===

In JomSocial, we provide a way to store your JomSocial data remotely on Amazon S3, the online storage service by Amazon Web Services. For more information regarding '''Amazon S3''', please [http://aws.amazon.com/s3/ click here].

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

===Setting Up===

::: [[File:Amazon config0.jpg]]

# In JomSocial's Backend, click '''Configuration'''.
# From there, click '''Remote Storage''' found at the top-left of the configuration bar.
# Under '''Storage Method'''s, choose whether you want to store the data locally, via '''Local Server''', or in the '''Amazon S3''' cloud.
# For Amazon S3, fill in the required fields with your Amazon S3 details.
# The '''Bucket Path''' here refers to the name of the bucket that you want to store the data. For example, if the URL of your Amazon S3 looks like this: http://bucket-name.s3.amazonaws.com/images/avatar/****.jpg, then the '''Bucket Name''' is '''bucket-name'''.
# If you're opting for Amazon S3's '''Reduced Redundancy Storage''', change the '''Amazon Storage Class''' from '''Standard''' to '''Reduced Redundancy'''. For more information regarding '''Reduced Redundancy Storage''', please [http://aws.amazon.com/about-aws/whats-new/2010/05/19/announcing-amazon-s3-reduced-redundancy-storage/ click here].

{{alert|Note: The '''Bucket Name''' should only contain lower case letters, no special characters, no numbers, and no capital letters.|alert-info}}

Setting up Amazon S3

2013-07-23T09:13:59Z

Eric Tracz:

===Overview===

In JomSocial, we provide a way to store your JomSocial data remotely on Amazon S3, the online storage service by Amazon Web Services. For more information regarding '''Amazon S3''', please [http://aws.amazon.com/s3/ click here].

===Video tutorial===
{{#ev:youtube|QnsrK0qrqmM|400}}

===Setting Up===

::: [[File:Amazon config0.jpg]]

# In JomSocial's Backend, click '''Configuration'''.
# From there, click '''Remote Storage''' found at the top-left of the configuration bar.
# Under '''Storage Method'''s, choose whether you want to store the data locally, via '''Local Server''', or in the '''Amazon S3''' cloud.
# For Amazon S3, fill in the required fields with your Amazon S3 details.
# The '''Bucket Path''' here refers to the name of the bucket that you want to store the data. For example, if the URL of your Amazon S3 looks like this: http://bucket-name.s3.amazonaws.com/images/avatar/****.jpg, then the '''Bucket Name''' is '''bucket-name'''.
# If you're opting for Amazon S3's '''Reduced Redundancy Storage''', change the '''Amazon Storage Class''' from '''Standard''' to '''Reduced Redundancy'''. For more information regarding '''Reduced Redundancy Storage''', please [http://aws.amazon.com/about-aws/whats-new/2010/05/19/announcing-amazon-s3-reduced-redundancy-storage/ click here].

{{alert|Note: The '''Bucket Name''' should only contain lower case letters, no special characters, no numbers, and no capital letters.|alert-info}}

Setting up Amazon S3

2013-07-23T09:13:40Z

Eric Tracz:

===Overview===

In JomSocial, we provide a way to store your JomSocial data remotely on Amazon S3, the online storage service by Amazon Web Services. For more information regarding '''Amazon S3''', please [http://aws.amazon.com/s3/ click here].

===Video tutorial===
{{#ev:youtube|QnsrK0qrqmM|400px}}

===Setting Up===

::: [[File:Amazon config0.jpg]]

# In JomSocial's Backend, click '''Configuration'''.
# From there, click '''Remote Storage''' found at the top-left of the configuration bar.
# Under '''Storage Method'''s, choose whether you want to store the data locally, via '''Local Server''', or in the '''Amazon S3''' cloud.
# For Amazon S3, fill in the required fields with your Amazon S3 details.
# The '''Bucket Path''' here refers to the name of the bucket that you want to store the data. For example, if the URL of your Amazon S3 looks like this: http://bucket-name.s3.amazonaws.com/images/avatar/****.jpg, then the '''Bucket Name''' is '''bucket-name'''.
# If you're opting for Amazon S3's '''Reduced Redundancy Storage''', change the '''Amazon Storage Class''' from '''Standard''' to '''Reduced Redundancy'''. For more information regarding '''Reduced Redundancy Storage''', please [http://aws.amazon.com/about-aws/whats-new/2010/05/19/announcing-amazon-s3-reduced-redundancy-storage/ click here].

{{alert|Note: The '''Bucket Name''' should only contain lower case letters, no special characters, no numbers, and no capital letters.|alert-info}}

Uploading Video

2013-06-26T10:24:05Z

Eric Tracz:

===Overview===

To upload videos, you will first have to [[Setting Up Video Galleries|enable]] Video Galleries and have at least one [[Creating Video Categories|category created]]. Also, make sure that your server meets all [[Video Linking & Upload Requirements|requirements]] needed for video uploading.

===Video tutorial===
{{#ev:youtube|SklUestiz2M}}

===Starting the Video Upload===

Go to the any '''Video'''-related page and click '''Add''': 

::: [[File:Videoadd.png]] 

The popup window will appear, giving you the option to link or upload a video. Please select '''Upload Video''': 

::: [[File:Videoadd1.png]] 

# '''Select video file''' - Navigate to the physical file on your computer and input it here. Alternatively, click '''Browse''' and an additional popup window to search for file will appear.
# '''Title''' - This field is also mandatory and will be used as a Video Title.
# '''Description''' - Description of video that will be uploaded.
# '''Location''' - If enabled, Video Location field will be displayed.
# '''Category''' - You must select the category where video will be stored.
# '''Who can see''' - Privacy setting for the video.

After the fields are filled properly, click '''Upload Video''' and wait for the video to upload. Depending on the video size and your Internet connection, the upload can take anywhere from several seconds to several hours. 

::: [[File:Videoadd2.png]]

===After Uploading===

Once the upload is finished, the video is stored in the '''Pending Videos''' list waiting for the [[Setting up Cron Job|cron job]] to trigger the FFMPEG conversion: 

::: [[File:Videoadd3.png]] 

Once the '''Video''' is converted, it will be available to watch on your JomSocial-powered website: 

::: [[File:Videoadd4.png]]

What are Events

2013-06-25T15:01:04Z

Eric Tracz:

{{alert|<center>NOTE!!! This page is not complete. Please, treat it as work in progress.</center>|alert}}

===Overview===

Events is a built-in core feature which allows community members to announce and promote new events on the site. It is designed to fit most communities and allows users to quickly and easily promote their events while providing easy moderation for community Administrators. Events are not mandatory and can be completely disabled at any time.

===Event Features===

# '''Create public events''' - Public events can be attended by anyone. The Event&squo;s information and details can also be viewed by anyone.
# '''Private events''' - Unlike public events, users’ invitations have to be approved by the Event Administrator in order for the requester to attend the event. The event information and details can be seen by anyone. Only the recent activities will be hidden. Events created in private groups can only be viewed and attended by private group members.
# '''Start Group Events''' - If enabled, users will be able to create Events in Groups.
# '''Invite your friends''' - Every Event Admin can invite friends to join the event (There is a limitation on this feature in Group Events).

{{alert|Note:
* You '''cannot''' force people to participate.
* You '''cannot''' sell tickets for events.
* You '''cannot''' use granular privacy like the kind found in the photo and video galleries.|alert-info}}

Installation - Old

2013-06-20T13:58:00Z

Eric Tracz:

{{alert| <center>NOTE!!! This page covers the installation process for JomSocial 2.6 and bellow. If you're looking for the JomSocial 2.8 installation guide, please, [[Installation|click here]] </center>|alert}}

===Before you begin===
If you are upgrading JomSocial, please refer to this [[Upgrading|upgrading]] documentation

===Video tutorial===
{{#ev:youtube|72Qe6ZBWB8M}}

===Installing the Component===
Installing JomSocial is really straightforward. After downloading the file, make sure you extract it first.
[[File:extractall.png]]

You will be using 'com_community_[version].zip' for the installation
[[File:installation2.png]]

'''Lets get started:'''

1. Login to your Joomla administration area and go to Site > System Information > Directory Permission. Make sure all directories listed are writable.
[[File:installation3.png]]
[[File:installation4.png]]

2. Go to Extensions > Extension Manager. At Upload Package File, browse for the 'com_community_[version].zip' file and choose it. Then, click on "Complete your installation" to begin.
[[File:installation5.png]]
[[File:installation6.png]]
[[File:installation7.png]]

3. The JomSocial Installer screen appears. Make sure all the requirements are checked as 'Yes'. Click on 'Next' and wait until the installation finishes.
[[File:installation8.png]]

4. You will be greeted with the Installation Completed screen. Congratulations!
[[File:installation9.png]]

===Alternative installation method===
You can also install JomSocial by manually uploading all the files to your web host via FTP. Follow the steps below:

1. Extract the 'com_community_[version].zip' file. 
[[File:installation10.png]]

2. Upload the extracted folder to your joomla/tmp directory using your FTP client.
[[File:installation11.png]]

3. Go to Extensions > Extension Manager. At the "Install from Directory" section, point to the folder that you have uploaded just now. Then click on Install.
[[File:installation12.png]]

===What's next?===
Go to your Joomla front page, and you will notice a new menu item called "JomSocial". Users are now able to register, add friends and share photos in your community!
[[File:installation13.png]]

Setting up Amazon S3

2013-06-20T13:54:08Z

Eric Tracz:

===Overview===

In JomSocial, we provide a way to store your JomSocial data remotely on Amazon S3, the online storage service by Amazon Web Services. For more information regarding '''Amazon S3''', please [http://aws.amazon.com/s3/ click here].

===Video tutorial===
{{#ev:youtube|QnsrK0qrqmM}}

===Setting Up===

::: [[File:Amazon config0.jpg]]

# In JomSocial's Backend, click '''Configuration'''.
# From there, click '''Remote Storage''' found at the top-left of the configuration bar.
# Under '''Storage Method'''s, choose whether you want to store the data locally, via '''Local Server''', or in the '''Amazon S3''' cloud.
# For Amazon S3, fill in the required fields with your Amazon S3 details.
# The '''Bucket Path''' here refers to the name of the bucket that you want to store the data. For example, if the URL of your Amazon S3 looks like this: http://bucket-name.s3.amazonaws.com/images/avatar/****.jpg, then the '''Bucket Name''' is '''bucket-name'''.
# If you're opting for Amazon S3's '''Reduced Redundancy Storage''', change the '''Amazon Storage Class''' from '''Standard''' to '''Reduced Redundancy'''. For more information regarding '''Reduced Redundancy Storage''', please [http://aws.amazon.com/about-aws/whats-new/2010/05/19/announcing-amazon-s3-reduced-redundancy-storage/ click here].

{{alert|Note: The '''Bucket Name''' should only contain lower case letters, no special characters, no numbers, and no capital letters.|alert-info}}

Custom Profile Fields

2013-06-20T13:51:12Z

Eric Tracz:

==Overview==
Custom '''Profile Fields''' allow the site Administrator to configure any combination of custom information fields that will be shown in the user profiles.

===Video tutorial===
{{#ev:youtube|4F_9MEJc5TQ}}

===Accessing the Field Configuration===

# From the '''Components''' dropdown menu at the site Backend, select '''JomSocial'''.
# Then, select '''Custom Profiles'''.

::: [[File:Jsconfigcustomprofiles.png]] 

The page with all of the '''Custom Profile Fields''' in the site will appear. 

::: [[File:Customprofilefieldsdefault.png]] 

{{alert|Note: During the initial installation, JomSocial adds the default custom profile fields, as shown on the image above. You are not limited to those fields. You can delete them, change them, or even add your own.|alert-info}}

===Manipulating with Fields===

====Available Field Types====

* '''Textbox''' - Creates the textbox field.
* '''Textarea''' - Makes the textarea field.
* '''Select''' - Allows you to create a dropdown list of options where only one of the available options can be selected.
* '''Select List''' - Same as '''Select''' field but not in dropdown format. The list is expanded by default.
* '''Multiple Select''' - Expanded list of options where more then one value can be selected by holding the CTRL button.
* '''Radio Buttons''' - Creates the list of radio buttons. Only one of the available options can be selected.
* '''Checkbox''' - Creates a list of checkboxes.
* '''Country''' - Makes a dropdown of all the countries available for selection.
* '''Gender''' - A gender field simply allows users to select their gender.
* '''Email''' - Cloaked email field.
* '''Time''' - Time field creates the dropdowns for HH MM SS.
* '''Date''' - Creates the date field.
* '''URL''' - Allows creation of the weblink field.
* '''Label''' - Creates the label field.
* '''Birthdate''' - Allows creation of birthdate field.

===Available Options===

* '''Name''' - Name of the field (please, see [[Translate Elements|this page]] if you want to make fields multilingual.
* '''Field Code''' - An unique field code - can later be used in API.
* '''Type''' - Type of field.
* '''Published''' - Enables the individual profile field.
* '''Searchable''' - If enabled, the field will be searchable in the advanced search list.
* '''Visible''' - If enabled, field will be visible on users profile page.
* '''Required''' - Makes field required. Profile can not be saved or created if the field with '''Required''' tag is not properly populated.
* '''Registration''' - Field is available on registration page.

Video Linking & Upload Requirements

2013-06-20T13:49:01Z

Eric Tracz:

===Video Upload Requirements===

===Video tutorial===
{{#ev:youtube|SklUestiz2M}}

====Video Linking====

Linking from external websites such as YouTube, Metacafe, and Vimeo only requires cURL to be installed, which is available in most webhosting providers' cURL library.

====Video Uploading====

# Video upload uses FFMPEG to convert videos. Most shared webhosting providers disable this option because it consumes a lot of memory and processing power. Please contact your webhosting provider regarding the availability of FFMPEG on your server. It is advisable to have at least VPS before you consider allowing video uploads.
# Minimum: FFMPEG; to get it running, it also requires exec/passthru/shell_exec/system access.
# Optional: FLVTool2, for adding metadata to your video.

Unlike other extensions, the path to FFMPEG and FLVTool2 need to be specified on your JomSocial Backend. Go to Site > Configuration and look for the "Videos" section. There you will find the fields to set both paths. 

::: [[File:ffmpegsettings.png]]

One last thing that JomSocial needs to process the video is a Cronjob (scheduled task). Make sure your Cronjob is configured properly by referring to [[Setting up Cron Job|this documentation]].

====Large Photo/video Uploading====

When it comes to large photo/video uploads, there are a few server configurations that you can tweak to get the most out of JomSocial:

'''php.ini'''
# max_execution_time = 9000; Maximum execution time of each script, in seconds.
# max_input_time = 9000; Maximum amount of time each script may spend parsing request data.
# memory_limit = 1024M; Maximum amount of memory a script may consume.
# post_max_size = 1024M; Maximum size of POST data that PHP will accept.
# upload_max_filesize = 1024M; Maximum allowed size for uploaded files.

'''my.cnf'''
# wait_timeout = 120
# connect_timeout = 120

'''Disable safe_mode and open_basedir'''
# Some hosting 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 provider 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 webhost allows for .htaccess override, locate your .htaccess file in the root Joomla directory and add these lines into it:
# php_admin_flag safe_mode off
# php_admin_value open_basedir none

Setting Up Cron Job

2013-06-20T13:46:37Z

Eric Tracz:

{{alert|<center>NOTE!!! This page contains images which show settings examples for resources that are outside of our scope. If your settings are not same as the ones presented here, please contact your webhosting provider for further instructions </center>|alert}}
===Overview of Cron Jobs===
For JomSocial to run properly, you will need to set up a Cron job to run periodically. By unloading a processing task to a scheduled job, JomSocial will be able to run faster and smoother.

===Video tutorial===
{{#ev:youtube|cRddvh-R6xY}}

The Cron job is required to:
# Avoid excessive processing to send out system emails during a normal page load.
# Archive old activity stream logs that are no longer relevant.
# Convert uploaded videos to standardized .swf files.
# Perform optional administrative jobs such as remove old, unused photo album, which doesn't have any photos

===Built-In Cron Job Option===
::: [[File:cron.jpg]] 
Use this option if you are not using JomSocial video upload feature. By enabling this, JomSocial will process Cron on every page load, with an interval of five (5) minutes in between.

# This option will only process email-related Crons. It will not run any maintenance script, Amazon S3 transfer, or video conversion.
# Avoid this option if your site is heavy with concurrent users (10+ users at one time) because it may have effect on performance.
# Avoid this option if you enable video upload feature and rely on other Cronjob methods instead.

===Cron on Linux Systems===
On most Linux systems, you can simply run the commands below. We would recommend running the Cron every thirty (30) minutes or less. On a busy site, you might want to run it every ten (10) minutes. The more frequently you run it, the less load there will be on the server. 
* lynx -source "http://www.domain.com/index.php?option=com_community&task=cron" > /dev/null
Lynx is a text-based browser that is installed in most hosting environments. If you do not have Lynx installed, you can use other alternatives such as wget, shown below:
* wget -O /dev/null "http://www.domain.com/index.php?option=com_community&task=cron" > /dev/null
Don't worry, this operation actually runs very fast and has very little impact on the server, equivalent to a normal single page load.

{{alert|Note: When setting up this command, make sure you put in your full, valid domain name; 'localhost' will not suffice.|alert-info}}

===Setting Up Cron Job in cPanel 11===
To add a new CronJob in cPanel 11, login to your cPanel and click '''Cronjobs''' under the '''Advanced''' section as the screenshot below. 
::: [[File:cronjob1.jpg]]

After clicking '''Cronjobs''', you will be directed to a page similar to the one below. In this example, click '''Standard''' to proceed. 
::: [[File:cronjob2.jpg]]

Enter the following command in the '''Command to run''' field on the screen shown below it: 
* lynx -source "http://www.yoursite.com/index.php?option=com_community&task=cron" > /dev/null
Select '''Every Five Minutes''', '''Every Hour''', '''Every Day''', '''Every Month''', and '''Every Week Day''' so that the action above will be executed every five (5) minutes perpetually. 
::: [[File:cronjob3.jpg]]

{{alert|Note: In order for the emails to be sent and videos to be converted, the scheduled task ''must be'' executed correctly.|alert-info}}

===Cron Jobs at GoDaddy===
GoDaddy doesn't support cronjobs from the panel. Using an online cron scheduler (look below) should solve the problem.

===Free Online Cron Scheduler===
If you are still having trouble with the above options, use any free online Cronjob scheduler service available on the web.
Do not worry on security because what these sites do is merely accessing index.php?option=com_community&task=cron at certain interval, which is open to anyone.

'''Popular services include:''' 
* [http://www.setcronjob.com Set CronJob]
* [http://www.cronless.com/ Cronless]
* [http://www.joomlarefinery.com/extensions/jr-jcron.html Joomla Rafinery]

Setting up Facebook Connect

2013-06-20T13:45:47Z

Eric Tracz:

{{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}}
===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:youtube|VxQBh6bZSzo}}

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===
::: [[File:fbc1.jpg]]

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 restricted to use any name. You will have to read through Facebook’s Terms of Service before accepting it.

You will then be redirected to your application's '''Basic Info''' page. Please be sure to fill in every detail shown in the picture below that is marked with an asterisk (*). 

::: [[File:fbc2.jpg]]

Do not leave the '''App Domain''' field empty. Enter the '''domain name''' as shown in the image above.
Please be certain that the '''Site URL''' is in the full format, i.e: http://www.mysitedomain.com.
Save the changes.

===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. 

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

'''Congratulations!''' JomSocial Facebook Connect is now set up on your website! 

{{alert|Note: It may take from a few minutes to an hour for your application to be active on all Facebook servers.|alert-info}}

Upgrade From JomSocial 2.8.x to JomSocial 3.0.x on Joomla 2.5

2013-06-20T13:41:31Z

Eric Tracz:

{{alert|<center>IMPORTANT!!! This page explains how to upgrade by using the installation package. If you want to learn how to upgrade using patch files, please [[Updating|click here]] 
'''Note:''' You can not upgrade from version to version using patch files. Patch files are used only for updating within the branch</center>|alert-error}}
===Upgrading to JomSocial 3===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved.
We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg}}

You can learn more about creating a Joomla backup by reading this [http://docs.joomla.org/Backup documentation]. If you find it too inconvenient to do a complete backup of all your files, at the very least, please have backups of:
* {root}/components/com_community
* {root}/administrator/components/com_community
* {root}/templates/mycurrentdirectory/html/com_community
* {root}/plugins/community 
Make sure you are running at least PHP 5.3 Joomla 2.5.6 or above, the max_upload in php.ini is greater than 4MB, and most importantly Joomla! is running well, i.e. regular installation of other extensions work flawlessly. Read our [[System Requirements|system requirement]] before you proceed. 
Go to Administration -> Help > System Info -> Directory Permission and make sure everything is '''Green'''. 
::: [[File:directory.jpg]]

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Upgrade===
# Uninstall the older JomSocial version by going to Extensions > Extensions Manager, select '''Manage''', select '''JomSocial/Community''', click '''Uninstall'''. Make sure that '''all''' JomSocial related modules, plugins, extensions are uninstalled.
# Go back to 'Install', upload the JomSocial installation package and follow the onscreen instructions (press 'next' a lot).

It really is ''that'' simple! ;)

Here's a video of the upgrade process:

{{#ev:youtube|fBzNlXp6uvE}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Migrate Joomla 2.5 With JomSocial 2.8.x to Joomla 3 and JomSocial 3.0.x

2013-06-20T13:39:28Z

Eric Tracz: /* Starting the Migration */

===Preparation===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved. Here's a short video (under 6 minutes)
We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg}}

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Migration===
# Again, '''make sure the backup of the entire site is done'''.
# Navigate to: Extensions > Extensions Manager, select '''Manage''' and uninstall '''everything''' that is third party and not native Joomla. That means all templates, plugins, modules, components. Of course including JomSocial.
# Make sure there are '''no 3rd party extensions left''' and that you indeed have a '''clean''' Joomla site.
# Open a new tab and go to Joomla.org site and download the update package. The latest Joomla 3 update packages can be found here [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=6674 Joomla 3 Upgrade Packages]
# Right click on the latest Stable Update Package and '''Copy Link Address'''.
# Go back to the tab with your Joomla backend open. Navigate to: Extensions > Extension Manager: Install, in the last field '''Install from URL''' paste the copied URL and click Install.
# '''Wait for your site to get upgraded.''' It should reload and show you the status of the upgrade in '''Joomla 3 backend'''.
# '''Install JomSocial 3'''.
# Install the rest of extensions that you wish to have on your site.

It really is ''that'' simple! ;)

Here you can see a video on Migrating and Upgrading JomSocial:

{{#ev:youtube|t8m8WeMW85o}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Migrate Joomla 2.5 With JomSocial 2.8.x to Joomla 3 and JomSocial 3.0.x

2013-06-20T13:37:28Z

Eric Tracz:

===Preparation===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved. Here's a short video (under 6 minutes)
We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg}}

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Migration===
# Again, make sure the backup of the entire site is done.
# Navigate to: Extensions > Extensions Manager, select '''Manage''' and uninstall '''everything''' that is third party and not native Joomla. That means all templates, plugins, modules, components. Of course including JomSocial.
# Make sure there are no 3rd party extensions left and that you indeed have a 'clean' Joomla site.
# Open a new tab and go to Joomla.org site and download the update package. The latest Joomla 3 update packages can be found here [http://joomlacode.org/gf/project/joomla/frs/?action=FrsReleaseBrowse&frs_package_id=6674 Joomla 3 Upgrade Packages]
# Right click on the latest Stable Update Package and 'Copy Link Address'.
# Go back to the tab with your Joomla backend open. Navigate to: Extensions > Extension Manager: Install, in the last field 'Install from URL' paste the copied URL and click Install.
# Wait for your site to get upgraded. It should reload and show you the status of the upgrade in Joomla 3 backend.
# Install JomSocial.
# Install the rest of extensions that you wish to have on your site.

It really is ''that'' simple! ;)

Here you can see a video on Migrating and Upgrading JomSocial:

{{#ev:youtube|t8m8WeMW85o}}

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 6MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 6M ; Maximum allowed size for uploaded files.
# post_max_size = 6M ; Maximum size of POST data that PHP will accept.

Upgrade From JomSocial 2.8.x to JomSocial 3.0.x on Joomla 2.5

2013-06-19T16:36:45Z

Eric Tracz:

{{alert|<center>IMPORTANT!!! This page explains how to upgrade by using the installation package. If you want to learn how to upgrade using patch files, please [[Updating|click here]] </center>|alert-error}}
===Upgrading to JomSocial 3===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved.
We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg}}

You can learn more about creating a Joomla backup by reading this [http://docs.joomla.org/Backup documentation]. If you find it too inconvenient to do a complete backup of all your files, at the very least, please have backups of:
* {root}/components/com_community
* {root}/administrator/components/com_community
* {root}/templates/mycurrentdirectory/html/com_community
* {root}/plugins/community 
Make sure you are running at least PHP 5.3 Joomla 2.5.6 or above, the max_upload in php.ini is greater than 4MB, and most importantly Joomla! is running well, i.e. regular installation of other extensions work flawlessly. Read our [[System Requirements|system requirement]] before you proceed. 
Go to Administration -> Help > System Info -> Directory Permission and make sure everything is '''Green'''. 
::: [[File:directory.jpg]]

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Upgrade===
# Uninstall the older JomSocial version by going to Extensions > Extensions Manager, select '''Manage''', select '''JomSocial/Community''', click '''Uninstall'''. Make sure that '''all''' JomSocial related modules, plugins, extensions are uninstalled.
# Go back to 'Install', upload the JomSocial installation package and follow the onscreen instructions (press 'next' a lot).

It really is ''that'' simple! ;)

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 4MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 4M ; Maximum allowed size for uploaded files.
# post_max_size = 4M ; Maximum size of POST data that PHP will accept.

'''ERROR: Could not find an XML setup file in the package.''' 
Make sure you have unpacked com_community_pro_unzip_first_(''VERSION'').zip before installing the package. You will see four files: 
# apps_unzip_first_version.zip
# '''com_community_pro_version.zip (Use this file to install JomSocial)'''
# modules_unzip_first_version.zip
# ReadMe.txt

Upgrade From JomSocial 2.8.x to JomSocial 3.0.x on Joomla 2.5

2013-06-19T16:33:33Z

Eric Tracz: Created page with "{{alert|<center>IMPORTANT!!! This page explains how to upgrade by using the installation package. If you want to learn how to upgrade..."

{{alert|<center>IMPORTANT!!! This page explains how to upgrade by using the installation package. If you want to learn how to upgrade using patch files, please [[Updating|click here]] </center>|alert-error}}
===Upgrading to JomSocial 2.8.x===

Before doing '''''anything''''' major to your site, '''''always''''' create a full site backup (files + database). A few minutes (literarily) can potentially save you hours of headaches and a poorly- or non-functioning site until the issues have been resolved.
We recommend that you use this extension for maintaining backups: [https://www.akeebabackup.com Akeeba Backup]. We have prepared a short tutorial video (under 6 minutes) showing how to backup your site and restore it in case of emergency.

{{#ev:youtube|rgCXWCiKSDg}}

You can learn more about creating a Joomla backup by reading this [http://docs.joomla.org/Backup documentation]. If you find it too inconvenient to do a complete backup of all your files, at the very least, please have backups of:
* {root}/components/com_community
* {root}/administrator/components/com_community
* {root}/templates/mycurrentdirectory/html/com_community
* {root}/plugins/community 
Make sure you are running at least PHP 5.3 Joomla 2.5.6 or above, the max_upload in php.ini is greater than 4MB, and most importantly Joomla! is running well, i.e. regular installation of other extensions work flawlessly. Read our [[System Requirements|system requirement]] before you proceed. 
Go to Administration -> Help > System Info -> Directory Permission and make sure everything is '''Green'''. 
::: [[File:directory.jpg]]

===Be assured that===
# Upgrading JomSocial will never delete community information that is stored in the database, such as profile fields, friends, avatars, images, videos, etc. In other words, everything on your community will stay as is.
# It will not interfere with non-JomSocial database tables.

===WARNING===
* All '''''template customizations''''' which do not follow our template override instructions '''will be deleted'''.
* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 2.8 functionality. Please consult your template developer(s) for updates.
* All '''''modifications''''' to any file in ''/components/com_community and /administrator/components/com_community'' '''will be deleted'''.
* '''''Third party extensions that rely on hacking''''' JomSocial template/core code to work, will likely fail after the upgrade. You will have to redo the hacks (documenting your hacks for personal reference would always help you greatly in the future).
* Always consult third-party developers for updated version of the plugins that are designed to work with JomSocial.

===Starting the Upgrade===
# Uninstall the older JomSocial version by going to Extensions > Extensions Manager, select '''Manage''', select '''JomSocial/Community''', click '''Uninstall'''. Make sure that '''all''' JomSocial related modules, plugins, extensions are uninstalled.
# Go back to 'Install', upload the JomSocial installation package and follow the onscreen instructions (press 'next' a lot).

It really is ''that'' simple! ;)

===Third Party Modules and Plugins===

Please consult the developer for an updated version, if necessary. Always good practice to check whether there are updated versions available.

===Translations===

With the new features and enhancements which are part of the new JomSocial releases, there will be a number of new language strings in JomSocial and perhaps changes to the already existing strings.

The '''Frontend''' language file is stored in:
* /language/en-Gb/en-Gb.com_community.ini
The '''Backend''' language file is stored in:
* /administrator/language/en-Gb/en-Gb.com_community.ini
The '''Modules''' language file is stored in:
* /language/en-Gb
The '''Applications & Plugins''' language file is stored in:
* /administrator/language/en-Gb

===Known Upgrade Errors===

'''There was an error uploading this file to the server.''' 
Some shared servers limit the size of uploaded files to a mere 2MB. The JomSocial component exceeds this limit so you will have to increase two (2) php.ini settings to be at least 4MB. If you are not sure on how to do this, please consult your webhosting provider for assistance.
# upload_max_filesize = 4M ; Maximum allowed size for uploaded files.
# post_max_size = 4M ; Maximum size of POST data that PHP will accept.

'''ERROR: Could not find an XML setup file in the package.''' 
Make sure you have unpacked com_community_pro_unzip_first_(''VERSION'').zip before installing the package. You will see four files: 
# apps_unzip_first_version.zip
# '''com_community_pro_version.zip (Use this file to install JomSocial)'''
# modules_unzip_first_version.zip
# ReadMe.txt