Difference between revisions of "Traditional Installation"

Latest revision as of 02:59, 1 October 2018

IMPORTANT Before you proceed with the upgrade, make sure you have a previous JomSocial version installed

For example, in order to upgrade to JomSocial 3.2, it is best if you run version 3.1. To update to latest version 4.5.9 make sure you have a minimum of Jomsocial 4.4

If you don't have previous version currently running at your site, but you want to immediately upgrade to latest JomSocial, please read this Tier Upgrade Guide

IMPORTANT!!! This page explains how to upgrade by using the installation package.
You can not upgrade your site using iJoomla Installer Installation since it no longer supported

Upgrading to Latest JomSocial

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.5.3 + Joomla 3.x or above, the max_upload in php.ini is greater than 8MB, and most importantly Joomla is running well, i.e. regular installation of other extensions work flawlessly. Read our system requirement before you proceed.
On Joomla 3, you should go to Administration -> System -> System Information -> Directory Permission and make sure everything is Writable

File:Joomla-folder-permission.jpeg

Starting the Upgrade to latest version

Download the Latest version from the download page
Create a full Backup your website
Make sure you are running minimum JomSocial 4.4 or JomSocial 4.5 version
Download JomSocial 4.5.9 from new unified download system.
Install the package 4.5.9.zip installer file
To update for latest Jomsocial Make sure you are running minimum JomSocial 4.4 or JomSocial 4.5 version
If you use JomSocial 4.3 or lower - Make the tier upgrade as explained in this doc & update Jomsocial with > 4.3 > 4.4 > 4.5.x

Upgrading Modules and Plugins

Starting from JomSocial 3.0 onward, all modules and plugins are upgraded automatically
For the third-party extensions, please consult the developer for an updated version, if necessary.

First time installation

After downloading the Jomsoicial latest package on your site, You need to Open Joomla admin with superuser access, Extension > Manage > Install > Upload the JomSocial zip file and after this you can proceed with Complete Your Installation steps.

Hit the big green button from the screen above and first JomSocial installation screen will appear. Make sure all the requirements are met and then click Next.

Note: If any of the values are marked in yellow, do not worry, JomSocial will probably still work. If you're concerned that it might not work please make sure your system meets the minimum system requirements.

Wait till the installation is completed and then press Done button. You will be greeted with the JomSocial Backend Control Panel

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

Location	Folder
Back End	ROOT/administrator/language/en-GB/en-GB.com_community.ini
Front End	ROOT/language/en-GB/en-GB.com_community.ini
Modules	ROOT/language/en-GB/en-GB.mod_modulename.ini
Plugins	ROOT/administrator/language/en-GB/en-GB.plg_pluginname.ini

@@ Line 1: / Line 1: @@
-===Upgrading to JomSocial 2.8.x===
+<center>{{alert|'''IMPORTANT''' Before you proceed with the upgrade, make sure you have a previous JomSocial version installed<br />
-. Before doing anything major to your site, always create a full site backup (files + database).
+For example, in order to upgrade to JomSocial 3.2, it is best if you run version 3.1. To update to latest version 4.5.9 make sure you have a minimum of Jomsocial 4.4
-We recommend you to use this extension: [https://www.akeebabackup.com Akeeba backup]. You can learn more on creating a Joomla backup by reading this [http://docs.joomla.org/Backup documentation].
+If you don't have previous version currently running at your site, but you want to immediately upgrade to latest JomSocial, please read this [[Updating From Very Old JomSocial Versions|Tier Upgrade Guide]]|alert-error}}
-. If you find it a hassle to do a complete backup of all files, please at the very least have backups of:
+</center>
- Database
- {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, max_upload in php.ini is above 4Mb, and most importantly Joomla is running well (meaning regular installation of other extensions do work flawlessly). Read our [[System requirements|system requirement]] before you proceed.
-. Go to Administration -> Help > System Info -> Directory Permission; make sure everything is Green.
-[[File:directory.jpg]]
-===Be assured that===
+<center>{{alert|<strong>IMPORTANT!!!</strong> This page explains how to <strong>upgrade by using the installation package.</strong><br />
-. Upgrading JomSocial will never delete community information that are stored in the database.
+You can not  '''upgrade''' your site using [[Installation|iJoomla Installer Installation since it no longer supported]]|alert-warning}}</center>
-. It will not interfere with non-JomSocial database tables
-===Be wary that==
+==Upgrading to Latest JomSocial==
-. 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.
+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: [https://www.akeebabackup.com Akeeba Backup]. 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<br/>
+Make sure you are running at least PHP 5.5.3 + Joomla 3.x or above, the max_upload in php.ini is greater than 8MB, 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/>
+On Joomla 3, you should go to Administration -> System -> System Information -> Directory Permission and make sure everything is <font color=green>'''Writable'''</font>
+:::[[File:joomla-folder-permission.jpeg]]
-. All modifications to any file in /components/com_community and /administrator/components/com_community will get deleted.
+==Starting the Upgrade to latest version==
-. 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).
+#Download the Latest version from the download page
+#Create a full Backup your website
+#Make sure you are running minimum JomSocial 4.4 or JomSocial 4.5 version
+#Download JomSocial 4.5.9 from new unified download system.
+#Install the package 4.5.9.zip installer file
+# To update for latest Jomsocial  Make sure you are running minimum JomSocial 4.4 or JomSocial 4.5 version
+# If you use JomSocial 4.3 or lower - Make the tier upgrade as explained in this doc & update Jomsocial with > 4.3 > 4.4 > 4.5.x
-. Always consult third-party developers for updated version of their plugins.
+==Upgrading Modules and Plugins==
+Starting from JomSocial 3.0 onward, all modules and plugins are upgraded automatically<br />
+For the third-party extensions, please consult the developer for an updated version, if necessary.
-===Starting the upgrade===
-. Uninstall older JomSocial version. To do so, please go to Extensions > Install/Uninstall, and select JomSocial/Community.
-. Install the latest JomSocial 2.6.
-. It is that simple. ;)
-===Upgrading official modules and plugins===
-. Install the latest version of modules/apps on top of the older version.
-===Third party modules and plugins===
-. 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:
+==First time installation==
- /language/en-Gb/en-Gb.com_community.ini
+After downloading the Jomsoicial latest package on your site, You need to Open Joomla admin with superuser access, Extension > Manage > Install > Upload the JomSocial zip file and after this you can proceed with '''Complete Your Installation''' steps.
-The backend language file is stored in:
+::: [[File:Completeinstallation.png]]
- /administrator/en-Gb/en-Gb.com_community.ini
+Hit the big green button from the screen above and first JomSocial installation screen will appear. Make sure all the requirements are met and then click '''Next'''.<br/>
-The modules language file is stored in:
+::: [[File:Installationscreen.png]]
- /language/en-Gb
+{{alert|<strong>Note:</strong> If any of the values are marked in yellow, do not worry, JomSocial will probably still work. If you're concerned that it might not work please make sure your system meets the minimum [[System Requirements|system requirements]].|alert-warning}}
-The applications & plugins language file is stored in:
+Wait till the installation is completed and then press '''Done''' button.
- /administrator/en-Gb
+You will be greeted with the '''JomSocial Backend Control Panel'''
+::: [[File:Instdone.png]]
-===Known upgrade errors...===
+==Translations==
-'''There was an error uploading this file to the server.'''
+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 />
-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.
+You will be able to find them all in the [[Translations|Translations]] section of this wiki
- 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"'''
+<table class="table">
-Make sure you have unpacked com_community_pro_unzip_first_2.6.0.zip before installing the package. You will see four files:
+  <tr>
-. apps_unzip_first_version.zip
+<th class="span2"><center>'''Location'''</center></th>
-'''2. com_community_pro_version.zip (Use this file to install JomSocial)'''
+<th class="span10"><center>'''Folder'''</center></th>
-. modules_unzip_first_version.zip
+  </tr>
-. ReadMe.txt.
+  <tr>
+<td><center>Back End</center></td>
+<td>ROOT/administrator/language/en-GB/en-GB.com_community.ini</td>
+  </tr>
+  <tr>
+<td><center>Front End</center></td>
+<td>ROOT/language/en-GB/en-GB.com_community.ini</td>
+  </tr>
+  <tr>
+<td><center>Modules</center></td>
+<td>ROOT/language/en-GB/en-GB.mod_modulename.ini</td>
+  </tr>
+  <tr>
+<td><center>Plugins</center></td>
+<td>ROOT/administrator/language/en-GB/en-GB.plg_pluginname.ini</td>
+  </tr>
+</table>
+==See Also==
+* [[Common Installation Errors]]
+* [[Updating From Very Old JomSocial Versions]]