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

Latest revision as of 12:12, 4 April 2020

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)

This is one of a series of documents introducing Joomla! version 1.5. J1.5:Xampp

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.

Hands-on how to begin to edit an Article.

and

Hands-on how to create a new Article.

Further information[edit]

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.

Using the sample data. This has details about the sample data and what you can learn from it.

Documentation about installing and using XAMPP. This is the documentation for XAMPP and also has links to help about xampp.

Lorna Scammell December 2010

J1.5

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

From Joomla! Documentation

Latest revision as of 12:12, 4 April 2020

Contents

Download and install Joomla![edit]

Before download and installation[edit]

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

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

Configure Joomla! and install the sample data[edit]

The sample data[edit]

To use the site and the administration pages[edit]

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

How to uninstall Joomla! and XAMPP[edit]

1. Use the uninstall script[edit]

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

Where Next?[edit]

Further information[edit]

@@ Line 1: / Line 1: @@
-{{incomplete}}
+{{version/tutor|1.5}}{{:Getting Started Page Index/1.5}}
-<div style="border:thin solid black; background: #f5f5f5;" >
-{{RightTOC}}
-</div>
-<div  style="border:thin solid black; background: #f5f5f5; left: 50px; width: 50%; ">
-===Index to the other documents in this series===
-{{:Page Index}}
-</div>
-== Background==
-It is very useful to be able to learn and experiment on your own machine. This is about downloading a sample Joomla! site to your own computer, known as a 'localhost' installation. It has some helpful sample content that allows you to become familiar with the way that a Joomla! site is put together.
-===Experience needed===
-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 Web site 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!
-=== Summary ===
-There are three basic stages in doing this:-
-:#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.
-:#Downloading and installing Joomla!
-:#Configuring Joomla!
-== Download and install XAMPP ==
-To run Joomla! on a Windows desktop or laptop you need to download and install some software needed by Joomla!. 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.
-Warning: If you are not familiar with downloading software - don't be put off by unfamiliar vocabulary on the download Web site!
-====Before download====
+This is one of a series of documents introducing Joomla! version 1.5.
-Make sure you have a separate folder for downloads.
+{{:J1.5:xampp}}
-: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)
-====Download XAMPP====
-[http://www.apachefriends.org/en/xampp-windows.html The site for Windows download]. This is a page with links to downloads as well as instructions for installation.
-This is what you do:-
-:Find the heading - ''Jump-off point''
-:Under ''Download''
-::Click on XAMPP
-:Choose the Basic Package -
-::Click on EXE for the dowmload
-:In the window that opens
-::Click Save File
-:In the Save In box - find the Download folder on your conmputer
-::Click Save
-A file with the XAMPP logo is saved to the Download folder. In Windows Explorer Details view, the file type will be Application.
-====Install XAMPP====
-Extract the software and install the files.
-:*Run the file
-::Double-click the file name
-:::You may be asked to confirm that you want to run the file - if so - Click Run.
-The next window gives on-screen instructions.
-[[Image:GSxamppInstall3.png|frame|center]]
-::Use the top level of the C: drive - so leave the C: as it is. (If you want it elsewhere, Browse for the folder where you want it)
-::Click Install
-Installation Progress is indicated on the screen.
-When the files are extracted, a Windows command screen asks a few questions to configure the installation.
-::Respond to these with the defaults.
-[[Image:GSxamppinstall4.png|frame|center]]
-The files are placed in the correct locations and you are then prompted to press <Return> to continue and to confirm the timezone.
-Finally the screen presents 7 choices.
-::Choose 1 to start the Control Panel and press Return
-::Choose x to Exit the install process
-You should see a XAMPP Control Panel on the desktop. To open it is it is not already open:-
-::Double-click the Control Panel icon on the desktop.
-This is the Control panel with the services running.
-[[Image:xamppControlPanel.png|frame|center]]
-Apache and MySQL need to run as services (indicated by a tick against Svc in the Control Panel). Make sure the following are set:-
-:*Apache Svc is ticked
-:*Apache is Running (Click Start to run it)
-:*MySQL Svc is ticked
-:*MySQL is Running (Click Start to run it)
-'''Now test it'''
-:*Type in the site's address in your browser - which is <nowiki>http://localhost/</nowiki>
-If it has not been successful - you will get a message saying 'Unable to Connect'. The most likely cause is that Apache or mySQL are not running.
-:*Use the Control Panel to check these.
-If it has been successful - there will be a splash page with a choice of languages.
-:*Choose your language
-You now see a Welcome page which says 'You have successfully installed XAMPP on this system!'. There are also various links to documentation and other things to the left.
-You can move on to downloading and installing Joomla! itself.
 == Download and install Joomla! ==
@@ Line 108: / Line 9: @@
 :*Create a folder for the Joomla installation with a suitable name
-Under the XAMPP folder (for example C:\XAMPP\) there is a folder called htdoc (C:\XAMPP\htdoc ). 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)
+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 htdoc folder
+::Open the htdocs folder
-::Create a folder under htdoc to contain the Joomla! files. (It can have any name but  Joomla15 is often used for example sites).
+::Create a folder under htdocs to contain the Joomla! files. (It can have any name but  Joomla15 is often used for example sites).
-====Download files for Joomla!====
+[[Image:GSfileshtdocs.png|frame|center|'''Some of the files under C:XAMPP. Here the Joomla! instances are called Joomla15 and development''']]
-::Go to the Joomla! download site - http://www.joomla.org/download.html
+====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 right folder====
+====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\htdoc\Joomla15
+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 and find the right directory
+::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
-GSinstallJoomla1
-<div style="border:thin solid red; margin-left:50px;  width: 50%;">
-place marker for screen
-</div>
+[[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 in the right place and you are ready to set Joomla! up for use.
+The files are now in the right place and you are ready to set Joomla! up for use.
-== Configure Joomla! and install the example data ==
+== Configure Joomla! and install the sample data ==
-:*Open the Jooma! site:
-If you called the folder for the Joomla! files 'joomla15 - then the go to <nowiki>http://localhost//joomla15 </nowiki> . If you called the file something else - then use the name of that file instead of 'joomla15'.
 :*Open the Joomla! site in your browser
-The screen is the start of Joomla! Installation which steps through seven choices.
+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
-GSinstalljoomla2
+[[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.''']]
-<div style="border:thin solid red; margin-left:50px;  width: 50%;">
+:4. The database configuration page.
-screen here of the config page with the right settings
+:This sets up and configures the database, where all the content for the site is stored.
+:*Enter the details into the form:-
-</div>
+::Leave database Type as mysql
-:5. The database configuration page. 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.
+::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.
-:6. Skip the FTP configuration - so press Next
+::Press Next when all the entries are done
-:7. Site name and sample data. In the form:-
+:5. Skip the FTP configuration - so press Next
-::Give it a name - such as 'Sample'
+:6. Site name and sample data.
-::Enter and email
+: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.
-:'''To load the sample data.'''
-::Click the button that says - Install Sample Data.
-:::The button will then read ' Sample data installed successfullly'.
-<div style="border:thin solid red; margin-left:50px;  width: 50%;">
+===The sample data===
-screen here of this - it is slightly confusing
-GSinstalljoomla3
-</div>
 <div style="border:thin solid green; margin-left:50px; background: #f5f5f5;  width: 80%;">
-'''Why do this?''' To give you some data so that you can see how a Joomla! site hangs together and also you can edit articles and observe different ways of doing things. There is a separate documentation about using this data - so it is a useful resource. 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.
+'''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>
-::If you want a clean installation, install Joomla! without the data.
-:*Press Next to continue when all is done
+:*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 those above and then continue.
+'''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.
 </div>
+:*Press Next to continue when all is done
 The Finish screen has helpful advice.
-'''You need to do one more thing -'''
+'''You need to do one more thing - remove the installation directory'''. In this example it is at:-
-:*Remove the installation directory - in this example it is at C:\xampp\htdoc\joomla15\installation
+ C:\xampp\htdoc\joomla15\installation
-If you try to go on to use the site - you will be prompted to do this. You are then allowed to continue.
+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 is  <nowiki> http://localhost/joomla15/</nowiki>
+:*The site (also known as the Front-end)  is  <code><nowiki> http://localhost/joomla15/</nowiki></code>
-:*The administration page is <nowiki> http://localhost/joomla15/administration</nowiki>
+:*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'
@@ Line 202: / Line 123: @@
 This time:-
 :Open the Joomla! site - assuming the folder was called is 'development':-
-:*The site is  <nowiki> http://localhost/development/</nowiki>
+:*The site name is  <code><nowiki> http://localhost/development/</nowiki></code>
-:*The administration page is <nowiki> http://localhost/development/administration</nowiki>
+:*The administration page is <code><nowiki> http://localhost/development/administration</nowiki></code>
 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.
+And - of course - do not install the sample data if you want a clean site.
 ==How to uninstall Joomla! and XAMPP==
@@ Line 218: / Line 139: @@
 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).
+:*Find the script:-
-::Run this script (Double-click on the file name)
+::<code>\XAMPP\uninstall_xampp.bat </code>
+::(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.
@@ Line 235: / Line 158: @@
 There is also [http://www.apachefriends.org/en/xampp-windows.html documentation on the XAMPP site] about uninstalling.
-----
+==Where Next?==
+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.
+*[[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.]]
-==Links==
+==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 as well as this tutorial.
+:*[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.
-:*[http://www.apachefriends.org/en/xampp-windows.html Documentation about installing and using XAMPP]. This also has links to help about xampp.
+:*[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

J1.5

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

From Joomla! Documentation

Latest revision as of 12:12, 4 April 2020

Download and install Joomla![edit]

Before download and installation[edit]

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

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

Configure Joomla! and install the sample data[edit]

The sample data[edit]

To use the site and the administration pages[edit]

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

How to uninstall Joomla! and XAMPP[edit]

1. Use the uninstall script[edit]

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

Where Next?[edit]

Further information[edit]

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