Professional Documents
Culture Documents
User Guide
JomSocial 1.5.x • Updated on 1st October, 2009
2
CONTENTS
System Requirements//03
Installation Guide//04
Alternative Install method & Upgrade
from JomSocial 1.2.x//05
Post installation & Applications//06
Facebook Connect//07
Video FAQ//12
Support Scope//13
3 System Requirements
PHP Version
JomSocial runs strictly on PHP5 and above.
Having said that, any application will run well with more
memory. We recommend that you allocate at least 64Mb
of memory to php. The following tasks will consume a lot of
memory:
MySQL
MySQL 4.1 or above is required. JomSocial is not tested on a system
with MySQL 4.0 or lower.
4 Installation Guide
DOWNLOAD INSTALLATION
1. Please login to your Joomla! Administration area.
2. Go to Help > System Info > Directory Permission and ensure that
all directories listed there are writable by Joomla.
3. Proceed to Extensions > Install / Uninstall.
(1.5.237 as an example):
Before the action starts, you will need to configure JomSocial to your So what is a JomSocial application? It is essentially a Joomla plugin which is
preference first. adapted for JomSocial usage. Thus it is installable via the regular Joomla In-
staller area. By default, plg_wall and plg_deleteuser are installed together with
To do so, head over to Components > JomSocial > Configurations. JomSocial. It can be either one of these types:
Subsequently, please head over to our Documentation site: a. JomSocial standalone applications (Community plugin)
http://www.jomsocial.com/docs.html b. JomSocial Component Integrator application (Community plugin)
for Post-Installation instructions. c. Joomla-based plugins for JomSocial (Non-Community plugin)
The Documentation site will cover ‘Setting up Scheduled Task’, ‘In- JomSocial standalone applications
stalling Applications’, ‘Installing Modules’, and ‘Renaming Applica- These applications can run on their own without the need of any third-party
tions / Plugins’. components. An example of these applications is plg_friendslocation and plg_
feeds.
Important: Do not forget to submit your Video Player License at
the ‘Media’ tab and also configure ‘Facebook Connect’ feature. A JomSocial Component Integrator applications
thorough guide on Facebook Connect feature is laid in the next few In order to better integrate JomSocial with other Joomla components, we need
pages. to install applications which serve as a bridge between JomSocial and the other
component. Examples are plg_jomcomment, plg_myblog, plg_eventlist, plg_
kunena. The actual components are not supplied with JomSocial package.
Read: http://www.jomsocial.com/docs/Installing_Applications
7 Facebook Connect
Facebook Connect is a new feature that allows your users to login via
facebook, thus bypassing the regular JomSocial registration form/in- 1. Browse and Login to Facebook Developer area, http://www.facebook.com/
terface. This makes it quick & easy for your new community members developers/. You are required to have a Facebook account.
to register & sign-in to your JomSocial-powered community.
8 Facebook Connect
Give your application a name, and select Agree to the Facebook Plat-
form Terms of Service.
3. Copy your API Key and Secret. You will need to submit this infor-
mation inside JomSocial Configuration.
Describe your application, change your icon and logo if you already
have them. Remember, your API Key and Secret should not be given
to anyone else.
9 Facebook Connect
ADDITIONAL INFO
1. Not getting correct user emails from Facebook (generate random emails)
This is caused by a restriction inside the Facebook API. Facebook, for security and privacy reasons, will
not allow third-party application developers from fetching user email addresses from its database. Thus,
JomSocial (and all other facebook-connect components, for that matter) will generate a random email for
that user. There is no way for us to know user email addresses (even the one that they submitted via the
facebook connect authentication popup), because it is locked & secured.
This is also a restriction by Facebook. Facebook, as you may know, has no “usernames.” Thus, anyone that
logged in through Facebook will have to readily accept that his/her username is his FULL NAME, and vice
versa.
Depending on each user’s Privacy Settings in Facebook, some of his information might not be properly
imported into JomSocial because it has been restricted.
Reminder: DO NOT link an admin account with a Facebook account. All authentication will be done by
Facebook, thus while a linked Admin is able to login at frontend, he will not be able to login at /adminis-
trator because the login form there has no facebook authentication feature and password is now held by
Facebook.
12 Video Information
Why is the video still in pending status after so long? About the “Unlicensed Copy” Logo
1. If you are using shared hosting service, most probably your hosting We have recently just updated our new downloads area which is accessible at
company don’t have FFmpeg installed. http://www.jomsocial.com/download.html. All you need to do is to provide
2. Probably you did not enter FFmpeg path correctly. your email address and order reference. Once logged in, you should be able to
3. Schedule task/Cron is not running. Read how to setup cron. view all your licenses assigned to you.
http://www.jomsocial.com/docs/Cron_Setup
4. Incorrect folder permissions. FFmpeg couldn’t create new videos or You are required to enter your domain name for the license in order to gener-
thumbnails as result. Please turn on the Joomla FTP layer. ate the video keys. Enter the license key in Jomsocial’s backend configuration.
http://www.jomsocial.com/webforum/viewtopic.
php?f=13&t=6085&start=40#p39214 Tips: Under tab “Media”, the field on right column, “Video Player License
Key”.
Can I skip FFmpeg by uploading FLV format videos?
Sorry, the answer is no for the sake of video size and quality consistency. I’ve got Operation Aborted issue!
Watching video in IE7 will produce error. Don’t panic. Try this hack.
My video thumbnails are not showing up http://www.jomsocial.com/webforum/viewtopic.php?f=3&t=6375&p=35687
1. Make sure you’re running on the latest version of Jomsocial.
2. Make sure the “Videos Root Folder” in the configuration matches the About flowplayer customization
location of the videos If you know what you are doing, you can tweak flowplayer with this file:
Tips: Don’t put the full path. Just the folder name. e.g. videos JOOMLA\components\com_community\templates\default\videos.flowplayer.
php
How do I administrate videos?
Logged in as admin, you will be able to edit/delete videos at the front-end.
Same goes to feature and un-feature videos and also videos in groups.
13 Support Scope
We support For all valid license holders, we provide web-based support for 12-months from the
date of purchase. You will also be entitled to 12-month free update. Should you re-
• Installation issues quire phone or priority support (for guaranteed 12-24 hours response time), please
• Basic configuration contact us with your requirements.
• How-to usage questions
1. Product documentation wiki & FAQ
This documentation will be updated frequently and will contain all the latest and
We do not support most common support issues. 90% of the time, you should be able to resolve any
issue through our wiki. You can visit the wiki by visiting
• Template design and customization
http://www.jomsocial.com/docs
• Anything that require modification to the
core code, such as adding new customized
2. Support forum
feature.
If you have a more specific questions, you can post them in our support forum. Your
• modified JomSocial code
questions might have been asked before, so, please do a quick search before you
• server migration
post any new topic.
• 3rd party integration
• any beta or trial release
Our support team will try to attend support queries within 48 hours, within normal
• installation on localhost
working hours. Please observe that we are at GMT+8. You can access the forum by
• Non JomSocial-related issues
visiting http://www.jomsocial.com/webforum
Assistance for the items above is available through
This forum uses the same credentials as JomSocial.com main site. If you have an ac-
our Professional Services or a Consulting engage-
count with JomSocial.com please use the same username and password to access
ment.
this forum. It helps us identify between paid and unpaid user and help us prioritize
your queries.
3. Email
Email is used primarily for exchanging confidential information. Email support will
only be entertained after you have posted your queries in our forum and that we
requested your confidential site details to be passed to us. Should you require
phone or priority support (for guaranteed 12-24 hours response time), it is avail-
able through our Professional Services or a Consulting engagement. Please contact
us with your requirements. Contact us support@azrul.com.