Difference between revisions of "Traditional Installation"

Revision as of 06:04, 9 December 2013

IMPORTANT!!! This page explains how to upgrade by using the installation package.
You can also upgrade your site using iJoomla Installer Installation

Upgrading to JomSocial 3.1.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 6MB, and most importantly Joomla is running well, i.e. regular installation of other extensions work flawlessly. Read our system requirement before you proceed.
For Joomla 2.5, go to Administration -> Help > System Info -> Directory Permission and make sure everything is Green

On Joomla 3, you should go to Administration -> System -> System Information -> Directory Permission and make sure everything is Writeable

Starting the Upgrade

Uninstall the older JomSocial version by going to Extensions > Extensions Manager, select Manage, select JomSocial/Community, click Uninstall.
Install the latest JomSocial 3.1

It really is that simple! ;)

Upgrading Official Modules and Plugins

Starting from JomSocial 3.0 onward, all modules and plugins are upgraded automatically

Third Party Modules and Plugins

Please consult the developer for an updated version, if necessary.

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.
You will be able to find them all in the Translations section of this wiki

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

@@ Line 1: / Line 1: @@
 <center>{{alert|<strong>IMPORTANT!!!</strong> This page explains how to <strong>upgrade by using the installation package.</strong><br />
 You can also '''upgrade''' your site using [[Installation|iJoomla Installer Installation]]|alert-error}}</center>
-===Upgrading to JomSocial 3.1.x===
+==Upgrading to JomSocial 3.1.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.
@@ Line 15: / Line 15: @@
 :::[[File:Dirperms.png]]
-===Be assured that===
+==Starting the Upgrade==
-# 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.
-===<font color=red>WARNING</font>===
-* All '''''template customizations''''' which do not follow our [[Customizing Template|template override instructions]] '''will be deleted'''.
-* All '''''template overrides need to be updated'''''; otherwise you will have a crippled JomSocial with limited JomSocial 3.0 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 their plugins.
-===Starting the Upgrade===
 # Uninstall the older JomSocial version by going to Extensions > Extensions Manager, select '''Manage''', select '''JomSocial/Community''', click '''Uninstall'''.
 # Install the latest JomSocial 3.1
@@ Line 32: / Line 21: @@
 It really is ''that'' simple! ;)
-===Upgrading Official Modules and Plugins===
+==Upgrading Official Modules and Plugins==
 Starting from JomSocial 3.0 onward, all modules and plugins are upgraded automatically
-===Third Party Modules and Plugins===
+==Third Party Modules and Plugins==
 Please consult the developer for an updated version, if necessary.
-===Translations===
+==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.
+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.<br />
+You will be able to find them all in the [[Translations|Translations]] section of this wiki
 The '''Frontend''' language file is stored in:
@@ Line 49: / Line 39: @@
 The '''Applications & Plugins''' language file is stored in:
 * /administrator/language/en-Gb
-===<font color=red>Known Upgrade Errors</font>===
-'''There was an error uploading this file to the server.'''<br/>
-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.''' <br/>
-Make sure you have unpacked com_community_pro_unzip_first_(''VERSION'').zip before installing the package. You will see four files:<br/>
-# apps_unzip_first_version.zip
-# '''com_community_pro_version.zip (Use this file to install JomSocial)'''
-# modules_unzip_first_version.zip
-# ReadMe.txt