J1.5

Difference between revisions of "Use Joomla! 1.5 on your own computer"

From Joomla! Documentation
(152 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{RightTOC}}
+
{{version/tutor|1.5}}{{:Getting Started Page Index/1.5}}
−
It may seem a little weird to run a website on a computer by itself which is not seen over the internet. It is, however, very useful to be able to learn and experiment on your own machine - not least because you can view the backend and also the files.
 
  
−
== Background==
+
This is one of a series of documents introducing Joomla! version 1.5.
−
===Experience needed===
+
{{:xampp}}
−
Not everyone using this Manual will have enough experience to feel comfortable doing this. You need to know a little about computing, for example:-
 
−
:*Know where to find files on your computer and be able to create folders
 
−
:*You can download something from a website and save it in an appropriate place
 
−
:*You will not panic if you do not understand a concept!
 
−
Experienced developers and people with programming experience will be fine.
 
−
If in doubt - follow the instructions and try it!
 
  
−
===Links to Joomla!'s Quick Start Guide and an introduction to the sample data===
+
== Download and install Joomla! ==
−
The instructions here make use of the very useful ''Quick Start Guide''. Make sure you look at this as well as this tutorial.
+
 
 +
====Before download and installation ====
 +
:*Create a folder for the Joomla installation with a suitable name
 +
 
 +
Under the XAMPP folder (for example C:\XAMPP\) there is a folder called htdocs (C:\XAMPP\htdocs ). This is the folder under which all content that will be seen on the localhost Web site is located. (There are already files there - such as index.html which displays the logo for XAMPP)
 +
::Open the htdocs folder
 +
::Create a folder under htdocs to contain the Joomla! files. (It can have any name but  Joomla15 is often used for example sites).
 +
 
 +
[[Image:GSfileshtdocs.png|frame|center|'''Some of the files under C:XAMPP. Here the Joomla! instances are called Joomla15 and development''']]
 +
 
 +
====Download files for Joomla! - this is for Joomla! 1.5====
 +
::'''Download sites:''' The main Joomla! site http://www.joomla.org/ Download button links to the latest version 1.6
 +
</br> For Joomla!1.5 you need to click the link to download Joomla! 1.5
 +
::Or - g directly to the Joomla!1.5 download site - http://www.joomla.org/download.html
 +
::Make sure you find the files for version 1.5
 +
::Click on the ZIP for the Full Package for the latest version.
 +
::Save the file to the Download folder on your computer
 +
Quick and painless. (It will be called a Compressed(zipped) Folder in the Details list in Windows Explorer)
 +
 
 +
====Install the files for Joomla! in the correct folder====
 +
::Right-click the downloaded zip file
 +
::Choose Extract All
 +
The Extraction Wizard prompts for where you want the files to be located. This is in the folder created above - for example C:\xampp\htdocs\Joomla15
 +
::Click Browse to find the folder you have created for the installation of Joonmla! 1.5
 +
::Click OK
 +
::Check that the 'Files will be extracted to this Directory' box has the right folder displayed.
 +
::Click Next
 +
 
 +
[[Image:GSinstallJoomla1.png|frame|center|'''The extraction Wizard at work. Make sure the files go to the right folder.''']]
 +
 
 +
Progress is indicated by the blue bar. When completed an Extraction Complete screen displays.
 +
::Click Finish
 +
The files are now in the right place and you are ready to set Joomla! up for use.
 +
 
 +
== Configure Joomla! and install the sample data ==
 +
:*Open the Joomla! site in your browser
 +
If you called the folder for the Joomla! files 'joomla15, then enter the URL in your browser:-
 +
<nowiki>http://localhost//joomla15 </nowiki>
 +
If you called the file something else - then use the name of that file instead of 'joomla15'.
 +
 
 +
The Joomla! Installation screen displays. Here you are stepped through seven choices in order to set up the site, the database and a few other things. Your progress is indicated to the left of the screen.
 +
:1. Select the language and press the Next button
 +
:2. Look at the Pre-installation check. There should not be any red items, apart from Display Errors, which can read On. Press Next to continue.
 +
:3. Read the GNU General Public License page and press Next
 +
 
 +
[[Image:GSinstalljoomla2.png|frame|center|'''The database configuration screen illustrates the layout of the display and shows the answers for the database configuration here. It also illustrates that there is a fair amount of on-screen help.''']]
 +
 
 +
:4. The database configuration page.
 +
:This sets up and configures the database, where all the content for the site is stored.
 +
:*Enter the details into the form:-
 +
::Leave database Type as mysql
 +
::Host name is localhost
 +
::User Name is root
 +
::Set a password for the user name for the database. Use something you will remember!
 +
::Database name - this is the name of this instance of Joomla! - in the example here use joomla15. If you used a different name - use that here for the database name.
 +
::Press Next when all the entries are done
 +
:5. Skip the FTP configuration - so press Next
 +
:6. Site name and sample data.
 +
:In the form:-
 +
::Give it a name - such as 'Sample'.
 +
::Enter an email
 +
::Enter a password - and remember this as it lets you use the site!
 +
::The rubric explains why you need this.
 +
 
 +
===The sample data===
 +
 
 +
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 80%;">
 +
'''Why install the sample data?'''
 +
 
 +
* It is a useful resource
 +
* It is helpful in showing how a Joomla! site hangs together.
 +
* You can edit articles
 +
* You can observe different ways of doing things.
 +
*It is used in this series of documents
 +
 
 +
There is some documentation about using this data in the Further information at the end of this document.
 +
 
 +
If you want both a site with sample data and a site with no data - you can install another instance of Joomla! on the same computer as explained in the last part of this document.
 +
</div>
 +
 
 +
:*Click the button that says - Install Sample Data.
 +
::The button will then read 'Sample data installed successfullly'. It is slightly confusing as you might expect it to take longer.
 +
 
 +
[[Image:GSinstalljoomla3.png|frame|center|'''The Main configuration page showing some of the choices, including the selection to install the Sample data''']]
 +
 
 +
 
 +
<div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 70%;">
 +
'''Note:'''
 +
 
 +
Sometimes there is a message that the database won't connect. '''The fix''' - Click Previous and remove the password. Check that the other settings are the same as you originally entered and then continue.
  
−
http://help.joomla.org/ghop/feb2008/task048/joomla_15_quickstart.pdf  This has help with installation and creating your own content.
+
</div>
  
−
and
+
:*Press Next to continue when all is done
 +
 
 +
The Finish screen has helpful advice.
 +
 
 +
'''You need to do one more thing - remove the installation directory'''. In this example it is at:-
 +
C:\xampp\htdoc\joomla15\installation
 +
If you try to go on to use the site without doing this, you will be prompted to do it. You are only allowed to continue when it has been deleted.
 +
 
 +
===To use the site and the administration pages ===
 +
There are separate web addresses for the main Site and for the administrator Back-end
 +
Assuming the site is 'Joomla15':-
 +
:*The site (also known as the Front-end)  is  <code><nowiki> http://localhost/joomla15/</nowiki></code>
 +
 
 +
:*The administration page - (known also as the Back-end) is <code><nowiki> http://localhost/joomla15/administrator</nowiki></code>
 +
If you have used a different name - put that in instead of 'Joomla15'
 +
 
 +
==How to install another instance of Joomla! on localhost==
 +
You can install and configure another instance of Joomla! using a different name. You do not need to download it again as it is already in your download folder.
  
−
http://community.joomla.org/august-2008/article/522-introductory-learning-joomla-using-sample-data.html This has details about the sample data and what you can learn from it.
+
:*Create a new folder under htdoc - with a different name from the first installation. For example - development
 +
:*Extract the files from the Joomla! download in exactly the same way - but Browse for the new folder name.
 +
'''Configuring Joomla!'''
  
−
=== Summary ===
+
This time:-  
−
There are three basic stages in doing this:-  
+
:Open the Joomla! site - assuming the folder was called is 'development':-
−
::#Downloading and installing some software that Joomla! needs to use to run locally. This is a web server called Apache, a database called mySQL and a scripting language called PHP. There are a few other things as well - which are downloaded together as one package called XAMPP.
+
:*The site name is  <code><nowiki> http://localhost/development/</nowiki></code>
−
::#Downloading and installing Joomla!
+
:*The administration page is <code><nowiki> http://localhost/development/administration</nowiki></code>
−
::#Configuring Joomla!
+
If you have used a different name - put that in instead of 'development'
  
−
== Download and install XAMPP ==
+
The set up stages are the same - except that the database will need the name of the site. And do not enter a password for mySQL root if there is a database error.
−
To run Joomla! on a Windows desktop or laptop you need to download and install some software. This includes a web server called Apache, a database called mySQL and a scripting language called PHP. The point of this to to configure your own machine to behave as if it were a server with the difference being that the result is not visible over the internet and is thus confined to your own computer. This is very useful for learning new things and even developing a new web site.
 
  
−
[http://www.apachefriends.org/en/xampp.html Download sites for using a Mac or Linux] with documentation.
+
And - of course - do not install the sample data if you want a clean site.
  
−
Warning: If you are not familiar with downloading software - don't be put off by unfamiliar vocabulary on the download website!
+
==How to uninstall Joomla! and XAMPP==
 +
You may want to uninstall Joomla! and XAMPP. If you do this - make sure you have copies of anything you may need, such as configuration files.
  
−
====Before download====
+
There are two possibilities.
−
Make sure you have a separate folder for the download.  
 
−
:Use Windows Explorer
 
−
:#Create a folder (called something meaningful like Downloads) beneath the top level of the directory. (Depending on how your computer is set up - this will be C:\Downloads)
 
−
:#Create a new folder at the top level called XAMPP - this is where the software will eventually be installed. (Depending on how your computer is set up - this will be C:\XAMPP)
 
  
−
====The download====
+
====1. Use the uninstall script ====
−
Click here for [http://www.apachefriends.org/en/xampp-windows.html the site for Windows download with some helpful documentation.]
+
The easy way - you can use the uninstall script.  
  
−
This is a page with links to downloads as well as instructions for installation.
+
:*Find the script:-
−
::Find the heading - ''Jump-off point''
+
::<code>\XAMPP\uninstall_xampp.bat </code>
−
::Under ''Download'' - Click on XAMPP
+
::(It appears on the Details list in Windows Explorer as a MS-DOS Batch File).
−
Choose the Basic Package -  
+
:*Run this script (Double-click on the file name)
−
::Click on EXE for the dowmload
+
This opens a command window and asks if you want the htdocs directory deleted.
−
In the window that opens
+
:*If you choose 'n' - it does not delete the folders \XAMPP\htdocs and \XAMPP\mysql\data - so you will need to do this yourself.
−
::Click Save File
+
:*If you choose 'y' - it deletes these folders as well
−
In the Save In box - find your Download folder
+
The services are then stopped and the control panel removed from the desktop.
−
::Click Save
+
The next message is that it will delete the files. Your response should be y for uninstalling the package.
  
−
====Install XAMPP====
+
==== OR . .</br>2. Manually delete the files====
−
This extracts the software and installs the files. In Explorer the type of file will be Applcation
+
The installation can be uninstalled by deleting all the files under the \XAMPP\ folder, but there may be errors if you do not stop the services and check that nothing is running first.
−
::Run the file - Right Click and choose Open or Double-click the file name
+
:*Stop the services using XAMPP Control Panel
−
::Browse for the folder that you have created (for example C:\XAMPP)
+
:*Untick the Svr button - so that mySQL and Apache are no longer running as services
−
::Click Install
+
:*Ensure that no other file is being used
−
The process gives you a XAMPP Control Panel on the desktop. If this does not open - then double-click it.
+
::Highlight the folder name and press Delete
  
−
Apache and MySQL need to run as services (indicated by Svc in the Comtrol Panle)Make sure the following are set:-
+
There is also [http://www.apachefriends.org/en/xampp-windows.html documentation on the XAMPP site] about uninstalling.
−
:*Apache is Running
 
−
:*Apache Svc is ticked
 
−
:*MySQL is running
 
−
:*MySQL Svc is ticked
 
  
−
'''Now test it'''
+
==Where Next?==
−
:*Type in the site's address in your browser - which is http://localhost/
+
You now have a Joomla! site to work with and some documentation to go with it.
−
:*From the Splash page - choose your language
 
  
−
If you can see a welcome page, then installation has been successful and you can move on to downloading and installing Joomla! itself.
+
Become familiar with Joomla! by altering and adding content.
 +
*[[Hands-on editing an article: Joomla! 1.5|Hands-on how to begin to edit an Article.]]
 +
and
 +
*[[Hands-on adding a new article: Joomla! 1.5|Hands-on how to create a new Article.]]
  
−
== Download and install Joomla! ==
+
==Further information==
 +
:*[http://help.joomla.org/ghop/feb2008/task048/joomla_15_quickstart.pdf Help with installation and creating your own content.] This is the very useful ''Quick Start Guide''. Make sure you look at this alongside this tutorial.
  
 +
:*[http://community.joomla.org/august-2008/article/522-introductory-learning-joomla-using-sample-data.html Using the sample data.] This has details about the sample data and what you can learn from it.
  
−
== Configure Joomla! and install the example data ==
+
:*[http://www.apachefriends.org/en/xampp-windows.html Documentation about installing and using XAMPP]. This is the documentation for XAMPP and also  has links to help about xampp.
  
 
----
 
----
−
--[[User:LornaS|Lorna Scammell]] December 2010
+
[[User:LornaS|Lorna Scammell]] December 2010

Revision as of 07:25, 6 June 2013

The "J1.5" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.

This tutorial is for Joomla! CMS Version(s) Joomla 1.5
Getting Started with Joomla! Joomla 1.5


This is one of a series of documents introducing Joomla! version 1.5.

<translate>

Introduction[edit]

</translate> <translate> XAMPP is an easy-to-install package that bundles the Apache web server, PHP, Xdebug, and the MySQL database. This allows you to create the environment you need to run Joomla! on your local machine. The latest version of XAMPP is available at the Apache Friends website. Downloads are available for Linux, Windows and Mac OS X. Download the package for your platform.</translate>

<translate> Important Note Regarding XAMPP and Skype: Apache and Skype both use port 80 as an alternative for incoming connections. If you use Skype, go into the Tools-Options-Advanced-Connection panel and deselect the Use 80 and 443 as alternatives for incoming connections option. If Apache starts as a service, it will take 80 before Skype starts and you will not see a problem. But, to be safe, disable the option in Skype.</translate>

<translate>

Installation on Windows[edit]

</translate>

<translate> Installation for Windows is very simple. You can use the XAMPP installer executable (for example, xampp-windows-x64-7.4.4-0-VC15-installer.exe). Detailed installation instructions for Windows are available here.

If you are on Windows XP or 2003 they are not supported by the main package but there are compatible versions of XAMPP for these platforms listed on the download page (but you will only be able to run PHP 5.4 or lower - and therefore will only be able to test Joomla 3.x and lower).</translate>

<translate> For Windows, it is recommended that you install XAMPP in c:\xampp (not in c:\program files). If you do this, your Joomla! (and any other local website folders) will go into the folder c:\xampp\htdocs. (By convention, all web content goes under the htdocs folder.)</translate>

<translate> If you have multiple HTTP servers (such as IIS) you can change the XAMPP listening port. In xamppDir\apache\conf\httpd.conf, modify the line Listen 80 to Listen [portnumber] (for example: Listen 8080).</translate>

<translate>

Joomla Community Magazine Tutorial

You can find a detailed tutorial on installing XAMPP on Windows, along with the Joomla 4 Beta, the Joomla Patch Tester and Git in this Joomla Community Magazine article.

</translate>

<translate>

Installation on Linux[edit]

</translate>

<translate>==== Install XAMPP ==== </translate> <translate> Open Terminal and enter:</translate> 

sudo tar xvfz xampp-linux-1.7.7.tar.gz -C /opt

<translate> (replace xampp-linux-1.7.7.tar.gz with the version of xampp you downloaded). It has been reported that the MYSQL database of xampp 1.7.4 does not work with Joomla 1.5.22</translate>

<translate> This installs ... Apache2, MySQL and PHP5 as well as an ftp server.</translate> 

sudo /opt/lampp/lampp start

<translate> and</translate> 

sudo /opt/lampp/lampp stop

<translate> starts/stops all the services</translate>

<translate>

Test Your XAMPP localhost Server[edit]

</translate> <translate> Open your Browser and point it to</translate> 

http://localhost

<translate> The index.php will redirect to</translate> 

http://localhost/xampp

<translate> There you will find instructions on how to change default usernames/passwords. On a PC that does not serve files to the Internet or LAN then changing the defaults is a personal decision.</translate>

<translate>

Get Joomla[edit]

</translate> <translate> Download the latest Joomla instalation zip [1]</translate>

<translate> Unzip to your hard drive</translate>

<translate> Connect to localhost with an FTP client Default</translate> 

nobody
lampp

<translate> Create a folder for your Joomla on the localhost server</translate>

<translate> FTP the unpacked Joomla installation files to the newly created Joomla folder.</translate>

<translate> Important:</translate> <translate>

  • The XAMPP installation sets the correct Ownership of the files and permissions.</translate>

<translate>

  • Using the CHOWN command will cause Ownership problems with XAMPP.</translate>

<translate>

  • Using nautilus to manipulate folders/files on localhost will cause Ownership problems with XAMPP.</translate>

<translate> Database info</translate>

<translate> Host</translate> 

localhost

<translate> Default Database name</translate> 

test

<translate> Default Database user</translate> 

root

<translate> There is no default Password.</translate>

<translate> Administrator password is your choice.</translate>

<translate> Installing Sample Data is recommended for the novice user.</translate>

<translate> After installation delete the installation directory and point your Browser to:</translate> 

http://localhost/yournewjoomlafolder

<translate> or</translate> 

http://localhost/yournewjoomlafolder/administrator

<translate>

Creating a Link in the Ubuntu Menu[edit]

</translate> <translate> To create a GUI for XAMPP connected to your Ubuntu menu</translate>

<translate> Open up the Terminal and type</translate> 

sudo gedit /usr/share/applications/xampp-control-panel.desktop

<translate> Then copy the following into the gedit and save.</translate> 

[Desktop Entry]
Encoding=UTF-8
Name=XAMPP Control Panel
Comment=Start and Stop XAMPP
Exec=gksudo "python /opt/lampp/share/xampp-control-panel/xampp-control-panel.py"
Icon=/usr/share/icons/Tango/scalable/devices/network-wired.svg
Terminal=false
Type=Application
Categories=GNOME;Application;Network;
StartupNotify=true

<translate> If the control panel fails to launch, try running the Exec command directly in the terminal:</translate> 

gksudo "python /opt/lampp/share/xampp-control-panel/xampp-control-panel.py"

<translate> If you receive the error:</translate> 

Error importing pygtk2 and pygtk2-libglade

<translate> Install the missing libraries:</translate> 

sudo apt-get install python-glade2

<translate>

Xdebug PHP Debugger[edit]

</translate>

<translate> The XAMPP package for Linux does not includes the Xdebug PHP debugger. To install Xdebug on Debian or Ubuntu:</translate>

<translate> - Install the build-essential package:</translate> 

sudo apt-get update
sudo apt-get install build-essential
sudo apt-get install autoconf

<translate> - Download the development package for your version of XAMPP and extract it to your existing installation:</translate> 

sudo tar xvfz xampp-linux-devel-1.7.7.tar.gz -C /opt

<translate> - Build Xdebug:</translate> 

wget http://xdebug.org/files/xdebug-2.1.3.tgz
tar xzf xdebug-2.1.3.tgz
cd xdebug-2.1.3/
/opt/lampp/bin/phpize

<translate> After this you will have following output on your console:</translate> 

Configuring for:
PHP Api Version:         20090626
Zend Module Api No:      20090626
Zend Extension Api No:   20090626 
./configure --with-php-config=/opt/lampp/bin/php-config
make
sudo make install

<translate> Then the output will be this.. please monitor the directory specified.</translate> 

Installing shared extensions: /opt/lampp/lib/php/extensions/no-debug-non-zts-20090626/

<translate> Create a folder in your temp folder that will hold the data file generated by Xdebug:</translate> 

sudo mkdir /opt/lampp/tmp/xdebug
sudo chmod a+rwx -R /opt/lampp/tmp/xdebug

<translate> Alternative installations:</translate>

<translate> Install using PHP extensions community library (PECL) bundled with XAMPP:</translate> 

sudo /opt/lampp/bin/pecl install xdebug

<translate> On Ubuntu/Debian you can install using:</translate> 

apt-get install php5-xdebug

<translate> (warning: this will also install Apache and PHP from apt repositories).</translate>

<translate> Warning for 64-bit users</translate>

<translate> When compiling Xdebug or installing via apt-get, you will receive an error when (re)starting xampp:</translate> 

/opt/lampp/lib/php/extensions/no-debug-non-zts-20090626/xdebug.so: wrong ELF class: ELFCLASS64

<translate> This is because XAMPP runs 32-bit but Xdebug is 64-bit. To overcome this problem, either make xdebug.so on a 32-bit machine or download it from</translate> ActiveState

<translate> Download the PHP Remote Debugging Client file for Linux (x86). Extract the contents of the file on your computer. This compressed file contains several folders with version numbers ex: 4.4, 5.0, 5.1... 5.3 and so forth, get in the folder with the higher version number or the one that works for you. Then copy the xdebug.so file to the following location (overwrite if needed):</translate> 

/opt/lampp/lib/php/extensions/no-debug-non-zts-20090626/

<translate> Remember this location could be different on your computer.</translate>

<translate>

Installation on Mac OS X[edit]

</translate> <translate> Mac OS X includes an Apache server out-of-the-box, but most developers will prefer to use the integrated tools and configurability provided by XAMPP.</translate>

<translate> As with most programs on Mac, installation is a breeze. Visit Apache Friends for the universal binary download.</translate>

<translate> Once the file has finished downloading, open the disk image, and drag the XAMPP folder to the Applications folder alias.</translate>

<translate> To start the server, open XAMPP Control.app and press the start button next to Apache.</translate>

<translate>

A Little Troubleshooting[edit]

</translate> <translate> Many Mac users have a little difficulty at this stage when trying to set up another instance of Apache on their machine. If you cannot start XAMPP's Apache, you have two options:</translate>
<translate> Change the listening port of XAMPP. In \Applications\XAMPP\xamppfiles\etc\httpd.conf, modify the Listen 80 line to Listen [portNumber]. For example: </translate>Listen 8080

<translate> Change the listening port of the pre-installed Apache server. In finder, go to /etc (CMD+SHIFT+G). From here you will be able to navigate through the normally hidden Apache files. Find the folder labeled Apache2, and edit the http.conf file. Modify the Listen 80 line to Listen [portNumber]. For example: </translate>Listen 8080

<translate> Note If you choose to change the port of the pre-installed Apache server, you may need to restart your computer for the changes to take effect. You will also have to authenticate as an administrator to change these files.</translate>

<translate>

Test XAMPP Installation[edit]

</translate>

<translate> Once XAMPP is installed and you have started the Apache service with the XAMPP Control Panel tool, you can test it by opening your browser and navigating to http://localhost. You should see the XAMPP welcome screen similar to the one below.</translate>

Phpinfo on xampp.png

<translate> Select the phpinfo() link in the top menu. This will display a long screen of information about the PHP configuration, as shown below.</translate>

Phpinfo.png

<translate> At this point, XAMPP is installed successfully. Notice the Loaded Configuration File. We will be editing this file in the next section to configure Xdebug.</translate>


Download and install Joomla![edit]

Before download and installation[edit]

  • Create a folder for the Joomla installation with a suitable name

Under the XAMPP folder (for example C:\XAMPP\) there is a folder called htdocs (C:\XAMPP\htdocs ). This is the folder under which all content that will be seen on the localhost Web site is located. (There are already files there - such as index.html which displays the logo for XAMPP)

Open the htdocs folder
Create a folder under htdocs to contain the Joomla! files. (It can have any name but Joomla15 is often used for example sites).
Some of the files under C:XAMPP. Here the Joomla! instances are called Joomla15 and development

Download files for Joomla! - this is for Joomla! 1.5[edit]

Download sites: The main Joomla! site http://www.joomla.org/ Download button links to the latest version 1.6


For Joomla!1.5 you need to click the link to download Joomla! 1.5

Or - g directly to the Joomla!1.5 download site - http://www.joomla.org/download.html
Make sure you find the files for version 1.5
Click on the ZIP for the Full Package for the latest version.
Save the file to the Download folder on your computer

Quick and painless. (It will be called a Compressed(zipped) Folder in the Details list in Windows Explorer)

Install the files for Joomla! in the correct folder[edit]

Right-click the downloaded zip file
Choose Extract All

The Extraction Wizard prompts for where you want the files to be located. This is in the folder created above - for example C:\xampp\htdocs\Joomla15

Click Browse to find the folder you have created for the installation of Joonmla! 1.5
Click OK
Check that the 'Files will be extracted to this Directory' box has the right folder displayed.
Click Next
The extraction Wizard at work. Make sure the files go to the right folder.

Progress is indicated by the blue bar. When completed an Extraction Complete screen displays.

Click Finish

The files are now in the right place and you are ready to set Joomla! up for use.

Configure Joomla! and install the sample data[edit]

  • Open the Joomla! site in your browser

If you called the folder for the Joomla! files 'joomla15, then enter the URL in your browser:- 

http://localhost//joomla15

If you called the file something else - then use the name of that file instead of 'joomla15'.

The Joomla! Installation screen displays. Here you are stepped through seven choices in order to set up the site, the database and a few other things. Your progress is indicated to the left of the screen.

1. Select the language and press the Next button
2. Look at the Pre-installation check. There should not be any red items, apart from Display Errors, which can read On. Press Next to continue.
3. Read the GNU General Public License page and press Next
The database configuration screen illustrates the layout of the display and shows the answers for the database configuration here. It also illustrates that there is a fair amount of on-screen help.
4. The database configuration page.
This sets up and configures the database, where all the content for the site is stored.
  • Enter the details into the form:-
Leave database Type as mysql
Host name is localhost
User Name is root
Set a password for the user name for the database. Use something you will remember!
Database name - this is the name of this instance of Joomla! - in the example here use joomla15. If you used a different name - use that here for the database name.
Press Next when all the entries are done
5. Skip the FTP configuration - so press Next
6. Site name and sample data.
In the form:-
Give it a name - such as 'Sample'.
Enter an email
Enter a password - and remember this as it lets you use the site!
The rubric explains why you need this.

The sample data[edit]

Why install the sample data?

  • It is a useful resource
  • It is helpful in showing how a Joomla! site hangs together.
  • You can edit articles
  • You can observe different ways of doing things.
  • It is used in this series of documents

There is some documentation about using this data in the Further information at the end of this document.

If you want both a site with sample data and a site with no data - you can install another instance of Joomla! on the same computer as explained in the last part of this document.

  • Click the button that says - Install Sample Data.
The button will then read 'Sample data installed successfullly'. It is slightly confusing as you might expect it to take longer.
The Main configuration page showing some of the choices, including the selection to install the Sample data


Note:

Sometimes there is a message that the database won't connect. The fix - Click Previous and remove the password. Check that the other settings are the same as you originally entered and then continue.

  • Press Next to continue when all is done

The Finish screen has helpful advice.

You need to do one more thing - remove the installation directory. In this example it is at:- 

C:\xampp\htdoc\joomla15\installation

If you try to go on to use the site without doing this, you will be prompted to do it. You are only allowed to continue when it has been deleted.

To use the site and the administration pages[edit]

There are separate web addresses for the main Site and for the administrator Back-end Assuming the site is 'Joomla15':-

  • The site (also known as the Front-end) is http://localhost/joomla15/
  • The administration page - (known also as the Back-end) is http://localhost/joomla15/administrator

If you have used a different name - put that in instead of 'Joomla15'

How to install another instance of Joomla! on localhost[edit]

You can install and configure another instance of Joomla! using a different name. You do not need to download it again as it is already in your download folder.

  • Create a new folder under htdoc - with a different name from the first installation. For example - development
  • Extract the files from the Joomla! download in exactly the same way - but Browse for the new folder name.

Configuring Joomla!

This time:-

Open the Joomla! site - assuming the folder was called is 'development':-
  • The site name is http://localhost/development/
  • The administration page is http://localhost/development/administration

If you have used a different name - put that in instead of 'development'

The set up stages are the same - except that the database will need the name of the site. And do not enter a password for mySQL root if there is a database error.

And - of course - do not install the sample data if you want a clean site.

How to uninstall Joomla! and XAMPP[edit]

You may want to uninstall Joomla! and XAMPP. If you do this - make sure you have copies of anything you may need, such as configuration files.

There are two possibilities.

1. Use the uninstall script[edit]

The easy way - you can use the uninstall script.

  • Find the script:-
\XAMPP\uninstall_xampp.bat
(It appears on the Details list in Windows Explorer as a MS-DOS Batch File).
  • Run this script (Double-click on the file name)

This opens a command window and asks if you want the htdocs directory deleted.

  • If you choose 'n' - it does not delete the folders \XAMPP\htdocs and \XAMPP\mysql\data - so you will need to do this yourself.
  • If you choose 'y' - it deletes these folders as well

The services are then stopped and the control panel removed from the desktop. The next message is that it will delete the files. Your response should be y for uninstalling the package.

OR . .
2. Manually delete the files[edit]

The installation can be uninstalled by deleting all the files under the \XAMPP\ folder, but there may be errors if you do not stop the services and check that nothing is running first.

  • Stop the services using XAMPP Control Panel
  • Untick the Svr button - so that mySQL and Apache are no longer running as services
  • Ensure that no other file is being used
Highlight the folder name and press Delete

There is also documentation on the XAMPP site about uninstalling.

Where Next?[edit]

You now have a Joomla! site to work with and some documentation to go with it.

Become familiar with Joomla! by altering and adding content.

and

Further information[edit]

Lorna Scammell December 2010

Retrieved from "https://docs.joomla.org/index.php?title=J1.5:Use_Joomla!_1.5_on_your_own_computer&oldid=100023"