Joomla 1.6 Setup Guide [jan-2010], Updated tutorial for Joomla

[lizon]

Jacob - Added complete file for reference
Dan - Added installation edit for zLib

This includes all file edits and so forth. Keep in mind, I'm a complete novice when it comes to Joomla, so my experience in installing it should be about the same as your experience.[/size][/b]

Updated for Joomla 1.6 as of 1/11/11

Now for those who never read my Drupal 6.15 Tutorial here's a recap on the initial Zymic setup part.


Zymic Hosting Account Setup:


Goto the Zymic homepage and click on "Sign-up/Log-in"



Write down your ftp information, you'll need it later on then click on "Login to control panel"



Click on the login button as shown here



Type in your password, don't worry I won't look....



Now to get your database setup, click on "MySQL Database Management"



Create your database name and click on "create DataBase Name"



Now create your database username and password, be sure to confirm it and press "Create Username"



Now assign privileges to your username to the database you want, be sure everythign is checked off and click "Assign Privileges"



Congrats your database is now created. Be sure to write down your database name, database username, and password. You will need that info in a little bit.



Congrats your DONE with the Zymic setup!



Joomla Setup

Now with that out of the way lets get to installing Joomla. First download the install files for Joomla 1.5

Unzip these files someplace where you can find them, I suggest your Desktop.

Now open up the sessions.php file located in the '/libraries/joomla/session' folder.

Locate the following lines of code and add a @ to the front of them to suppress PHP ini_set errors.

CODE

ini_set('session.save_handler', 'files');

CODE

ini_set('session.use_trans_sid', '0');

CODE

if( $trans ) {
      ini_set( 'session.use_trans_sid', 0 );
  }

CODE

ini_set( 'session.use_trans_sid', $trans );

CODE

ini_set('session.gc_maxlifetime', $this->_expire);

So now these lines should look like this:

CODE

@ini_set('session.save_handler', 'files');

CODE

@ini_set('session.use_trans_sid', '0');

CODE

if( $trans ) {
      @ini_set( 'session.use_trans_sid', 0 );
  }

CODE

@ini_set( 'session.use_trans_sid', $trans );

CODE

@ini_set('session.gc_maxlifetime', $this->_expire);

(You can view the full file [here])

Save this file.

Now I want to open up your language.php file located at libraries/joomla/languages and find these 2 lines of code.

CODE

ini_set('track_errors',$track_errors);

CODE

ini_set('track_errors', true);

And edit them to look like this.

CODE

@ini_set('track_errors',$track_errors);

CODE

@ini_set('track_errors', true);

Save this file.

Now you want to go to installation/models/setup.php and look for // Check for zlib support. on line 229 with the folloing code

CODE

        // Check for zlib support.
        $option = new stdClass;
        $option->label  = JText::_('INSTL_ZLIB_COMPRESSION_SUPPORT');
        $option->state  = extension_loaded('zlib');
        $option->notice = null;
        $options[] = $option;

and you want to add // in front so it looks like this.

CODE

        // Check for zlib support.
        //$option = new stdClass;
        //$option->label  = JText::_('INSTL_ZLIB_COMPRESSION_SUPPORT');
        //$option->state  = extension_loaded('zlib');
        //$option->notice = null;
        //$options[] = $option;

Save the file and upload it to your hosting account

The last thing I want you to do is to open up the web editing tool that you've been using (Notepad++, Dreamweaver, Frontpage, ect) and create a new BLANK page with nothing in it and save it as configuration.php and place it into your root folder. This is the same folder where your index.php file is located.

Now upload the entire contents of the Joomla folder onto your website. While normally I use Core-FTP or WS_FTP for this I found I got errors during the upload process for some reason. So in this case I recommend Filezilla which you can get at www.filezilla.com.

Note: I had a few failed uploaded files myself, just re-que them once everything is uploaded, should take a good 15-20m to get everything up.

Once everything is uploaded in filezilla select the configuration file that you just uploaded that's located on your bottom right window and right click and select "File Permissions"



Set the file permissions to 777 and click "Ok"



Now goto your homepage (example: lizontest.zxq.net). Select your language and click on "next" on the right hand side.




Don't worry about the Pre-Install errors. Just click "Next" to continue.



Click on "Next" again (I'm sounding like a broken record here)

Some people may have trouble with this part as in some cases there will be no NEXT button. If this is the case you can get to the page by entering the url manually. For example is my website is lizontest.com my url would be lizontest.com/installation/index.php?view=license



Fill in your database information that I told you to write down earlier. Once your done click "Next".



Don't worry about filling this information, I tried to myself, it doesn't work. Just click "Next" and continue.



Put in your e-mail and password. Because it was my first time installing Joomla I selected "Install Default Sample Data". If your migrating from a previous site select "Load Migration Script" and fill in the necessary boxes.



Remember the admin username is "admin" and the password is the one you imputed earlier.



If you created the configuration file earlier like I told you to and set it's permissions properly you will be able to SKIP this next step as it involves the same file. Simply delete or rename your installation folder as indicated on the page and your DONE!

You need to do 2 things now. First open up your favorite web editor (Dreamweaver, frontpage, notepad, ect.) and copy the code below into it. Save this file as configuration.php and place it somewhere you can find it, your Desktop should suffice.



Next open up Filezilla again and upload this file to your root directory (same place where index.php is at). While your in there right click on the "Installation" folder and click on "Delete". This will remove the folder.

Once these 2 things are done click on "Next".



Done!


Remember to access your admin panel goto http://yourwebsite/administration (example http://lizontest.zxq.net/adminstration).

FAQ

How do I install new templates without zlib?

* Get your zip files from our (or other) website. Unzip the file on your computer.
* Log on with your ftp client on your site.
* Find "Templates" folder on your root site and upload unzipped directory. The structure should look like this: /templates/mody_bluelight/index.php.
* Log on your Joomla administration section. Go to Site --> Template Manager --> Site Templates
* Select your new template from the list and publish it.
* Go to Site --> Preview --> In new window

Source: http://www.joomlatribune.com/joomla-tutori...-templates.html

Note: This took me about 10 seconds to look up myself ^.^



FOLLOW UP TUTORIAL [installing sample data]:

http://www.zymic.com/forum/index.php?showtopic=23327

Reason for edit: Fixed zLIB edit to make it work fo install

[Darman]

Don't worry about the Pre-Install errors. Just click "Next" to continue.

without zlib setting of templates is impossible!
unless to make attempt on a line through ftp

[Dave]

without zlib setting of templates is impossible!
unless to make attempt on a line through ftp

You must install themes manually.

[lizon]

You must install themes manually.

Yeah I'll add that once I figure out how to do that. Like I said I'm a novice to Joomla. I didn't even know you could install the themes through It's control panel. I'm used to doing things manually in Drupal.

[Dave]

Yeah I'll add that once I figure out how to do that. Like I said I'm a novice to Joomla. I didn't even know you could install the themes through It's control panel. I'm used to doing things manually in Drupal.

I believe you can but only if "zlib" compression is supported on the server. We don't have this enabled on Zymic, so it must be done manually.
Once again, thanks for the tutorial.

[lizon]

you might want to update the tutorial sticky ^.^

[IPEST]

Hello men,
Thank you for this tutorial, i'am testing it!
Incidentally, the file "session.php" is now in the "/ Joomla / libraries / joomla / session".
Thank you again!

[lizon]

Hello men,
Thank you for this tutorial, i'am testing it!
Incidentally, the file "session.php" is now in the "/ Joomla / libraries / joomla / session".
Thank you again!

not sure how i made that mistake, fixed it though

[IPEST]

Hello again,
I test this and it works well.
Thank you again for this tutorial!
We can make Joomla configuration work fine if we create an empty file called configuration.php place it in /joomla root directory and make it writable (permission 777 with the ftp client) before ....
So we will not have Pre-install error (configuration.php is not writeable).
Thank you again and sorry for my poor english

[lselbach]

Error Message
I've followed all the steps and still get this error message when I access my joomla installation
http://porfazer.zxq.net/joomla/

Notice: Undefined property: JConfig::$debug in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/includes/framework.php on line 58 Warning: session_start(): Cannot send session cookie - headers already sent by (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 423 Warning: session_start(): Cannot send session cache limiter - headers already sent (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 423 Warning: Cannot modify header information - headers already sent by (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 426 Database Error: Unable to connect to the database:Could not connect to MySQL

I appreciate any help.

Cheers and thanks in advance.

Lucas Selbach

[gabore]

Error Message
I've followed all the steps and still get this error message when I access my joomla installation
http://porfazer.zxq.net/joomla/

Notice: Undefined property: JConfig::$debug in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/includes/framework.php on line 58 Warning: session_start(): Cannot send session cookie - headers already sent by (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 423 Warning: session_start(): Cannot send session cache limiter - headers already sent (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 423 Warning: Cannot modify header information - headers already sent by (output started at /www/zxq.net/p/o/r/porfazer/htdocs/joomla/configuration.php:1) in /www/zxq.net/p/o/r/porfazer/htdocs/joomla/libraries/joomla/session/session.php on line 426 Database Error: Unable to connect to the database:Could not connect to MySQL

I appreciate any help.

Cheers and thanks in advance.

Lucas Selbach

For me it looks like you accidentally left out making a comment from one of the ini_set lines in session.php.

[puya3d]

For me it looks like you accidentally left out making a comment from one of the ini_set lines in session.php.

Yeah, that is not the prol

He have to update the tutoial (very great tutorial) to make the new joomla the ini_set files there are a lot of other not on the tutorial

423 426 were new not on the tutorial

There also, the An error has occurred.:

Cookies do not appear to be enabled on your browser client. You will not be able to install the application with this feature disabled. Alternatively, there could also be a problem with the server's session.save_path. If this is the case, please consult your hosting provider if you don't know how to check or fix this yourself.

[NerdyGurl]

SOLVED DONT WORRY - Blonde moment
Followed each step as above and got this...

CODE

Command:CWD /installation/language/bn-BD
Response:550 Can't change directory to /installation/language/bn-BD: No such file or directory
Error:Failed to retrieve directory listing

Followed each step as above and got this...

CODE

Command:CWD /installation/language/bn-BD
Response:550 Can't change directory to /installation/language/bn-BD: No such file or directory
Error:Failed to retrieve directory listing

Please note this was in file zilla

[milentije]

Yeah, that is not the prol

He have to update the tutoial (very great tutorial) to make the new joomla the ini_set files there are a lot of other not on the tutorial

423 426 were new not on the tutorial

There also, the An error has occurred.:

Cookies do not appear to be enabled on your browser client. You will not be able to install the application with this feature disabled. Alternatively, there could also be a problem with the server's session.save_path. If this is the case, please consult your hosting provider if you don't know how to check or fix this yourself.

It seems that placing // like it is explained in tutorial fixes the problem

[ckkok]

Hi, I'm a newbie for joomla is looking for help.
I ran through the process until finally I uploaded the whole joomla folder to my directory. But I don't know it was the "root directory" or not. The location of the whole joomla folder is at the same level as the index.html, images folder.

You had wrote :
"Once everything is uploaded go ahead and goto your homepage (example: lizontest.zxq.net). Select your language and click on "next" on the right hand side."

When I click on my website : http://lbpgroup.99k.org/
It doesn't appear the Joomla setup page for me to select the language !! ??

Please help!

[lizon]

You uploaded your files to the wrong place.

http://lbpgroup.99k.org/joomla/

Root Directory refers to your top level directory. It is the root, the beginning, the base of all directories for your website. When I goto my joomla test site in my FTP client I see this:



You have all of your files inside a separate /joomla folder. The files should not be inside a folder, they need to be inside the root directory.

Let me try o explain it to you this way:

/ ----root directory
/joomla ------joomla folders

Move all the files from /joomla to / (the root directory).

Coprendo?

[ckkok]

Hi, Lizon

Yes! I got your point! It's completely now done with the joomla upload.
Thanks!

[ckkok]

Need help again!
I create the configuration.php and upload to the root directory and after that I delete the Installation folder.
After that when I click Next, the below appear :

404 Page Not Found!

The address you have entered has not been found. This may be due to an outdated link, typo or a page no longer on our system.

Please help!

[ckkok]

when I type in http://lbpgroup.99k.org/administrator
the below appear :

Parse error: syntax error, unexpected $end, expecting T_FUNCTION in /www/99k.org/l/b/p/lbpgroup/htdocs/configuration.php on line 6

I have checked and confirmed there is no spelling mistake in configuration.php as below :

<?php
class JConfig {
/* Site Settings */
var $offline = '0';
var $offline_message = 'This site is down for
maintenance.<br /> Please check back again soon.';

Please help!

[lizon]

Should be like this:

CODE

var $offline_message = 'This site is down for maintenance.<br /> Please check back again soon.';

NOT this

CODE

var $offline_message = 'This site is down for
maintenance.<br /> Please check back again soon.';

The file is read line by line, to close a line properly you need ;, which is missing on the code that you posted.