Difference between revisions of "Traditional Installation"

(Upgrading to JomSocial 2.8.x)
(Upgrading to JomSocial 2.8.x)
Line 6: Line 6:
 
* {root}/administrator/components/com_community
 
* {root}/administrator/components/com_community
 
* {root}/templates/mycurrentdirectory/html/com_community
 
* {root}/templates/mycurrentdirectory/html/com_community
* {root}/plugins/community
+
* {root}/plugins/community<br/>
# 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.
+
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.<br/><br/>
# Go to Administration -> Help > System Info -> Directory Permission and make sure everything is Green.
+
Go to Administration -> Help > System Info -> Directory Permission and make sure everything is Green.<br/><br/>
 
[[File:directory.jpg]]
 
[[File:directory.jpg]]
  

Revision as of 02:01, 7 March 2013

IMPORTANT!!! This page explains how to upgrade by using the installation package. If you want to learn how to upgrade using patch files, please click here

Upgrading to JomSocial 2.8.x

Before doing anything major to your site, always create a full site backup (files + database). A few minutes of inconvenience 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: Akeeba Backup. You can learn more about creating a Joomla backup by reading this 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 requirement before you proceed.

Go to Administration -> Help > System Info -> Directory Permission and make sure everything is Green.

Directory.jpg

Be assured that

  • Upgrading JomSocial will never delete community information that are 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

Be wary that

  • All template customizations that do not adhere to our template override instruction will be deleted. Automagically, no doubt about that.
  • All template overrides need to be updated. Otherwise you will have a crippled JomSocial with limited JomSocial 2.8 functionalities. Please consult your template developers for an update.
  • All modifications to any file in /components/com_community and /administrator/components/com_community will get deleted.
  • Third party extensions that rely on hacking JomSocial template/core code to work, would likely to fail after the upgrade. You will have to re-do 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 their plugins.

Starting the upgrade

  1. Uninstall older JomSocial version. To do so, please go to Extensions > Install/Uninstall, and select JomSocial/Community.
  2. Install the latest JomSocial 2.8.x
  3. It is that simple. ;)

Upgrading official modules and plugins

1. Install the latest version of modules/apps on top of the older version.

Third party modules and plugins

1. Please consult the developer for an updated version, if needed.

Translations

With new features and enhancements that are part of new JomSocial releases, we are bound to have a number of new language strings in JomSocial.

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 at a mere 2Mb. JomSocial component exceeds this limit. You will have to increase two php.ini settings to be at least 4Mb. If you are not sure on how to do this, please consult your webhost 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:
1. apps_unzip_first_version.zip
2. com_community_pro_version.zip (Use this file to install JomSocial)
3. modules_unzip_first_version.zip
4. ReadMe.txt.