Joomla! Documentation - User contributions [en]

JoomlaDays/History

2011-05-21T18:49:38Z

Neriv: /* 2007 */

The Joomla! community has a long history of Joomla!Day events from around the world. Let's document these here, so we can ensure we have a historical timeline of Joomla!Days.

Instructions: please add the name, date, location, and if possible the web address, of any Joomla!Days that have happened in the past. Please use the following format: Name_of_Joomla!Day - Month DD-DD, YYYY - City, Country

== 2006 ==

[[Joomladay Netherlands (1), April 22nd 2006, Location?]]

[[Joomladay Netherlands (2), December 8th and 9th 2006, Den Bosch]]

[[Joomladay Germany 2006]]

== 2007 ==

[[Joomla!Day USA West - September X-Y, 2007 - Mountain View, California, USA]] 
Joomla! Day NYC - October 13, 2007 - New York, New York, USA

== 2008 ==

[[Joomladays Netherlands (3), april 4th and 5th 2008, Location?]]

== 2009 ==

[[Joomladay Germany 2009]]

== 2010 ==

== 2011 ==

JoomlaDays/History

2011-05-21T18:48:30Z

Neriv: /* 2007 */

The Joomla! community has a long history of Joomla!Day events from around the world. Let's document these here, so we can ensure we have a historical timeline of Joomla!Days.

Instructions: please add the name, date, location, and if possible the web address, of any Joomla!Days that have happened in the past. Please use the following format: Name_of_Joomla!Day - Month DD-DD, YYYY - City, Country

== 2006 ==

[[Joomladay Netherlands (1), April 22nd 2006, Location?]]

[[Joomladay Netherlands (2), December 8th and 9th 2006, Den Bosch]]

[[Joomladay Germany 2006]]

== 2007 ==

[[Joomla!Day USA West - September X-Y, 2007 - Mountain View, California, USA]]
[[Joomla! Day NYC - October 13, 2007 - New York, New York, USA]]

== 2008 ==

[[Joomladays Netherlands (3), april 4th and 5th 2008, Location?]]

== 2009 ==

[[Joomladay Germany 2009]]

== 2010 ==

== 2011 ==

JoomlaDays/History

2011-05-21T18:45:00Z

Neriv: /* 2007 */

The Joomla! community has a long history of Joomla!Day events from around the world. Let's document these here, so we can ensure we have a historical timeline of Joomla!Days.

Instructions: please add the name, date, location, and if possible the web address, of any Joomla!Days that have happened in the past. Please use the following format: Name_of_Joomla!Day - Month DD-DD, YYYY - City, Country

== 2006 ==

[[Joomladay Netherlands (1), April 22nd 2006, Location?]]

[[Joomladay Netherlands (2), December 8th and 9th 2006, Den Bosch]]

[[Joomladay Germany 2006]]

== 2007 ==

Joomla!Day USA West - September X-Y, 2007 - Mountain View, California, USA
Joomla! Day NYC - October 13, 2007 - New York, New York, USA

== 2008 ==

[[Joomladays Netherlands (3), april 4th and 5th 2008, Location?]]

== 2009 ==

[[Joomladay Germany 2009]]

== 2010 ==

== 2011 ==

Joomla! Student Outreach Program Project Ideas

2010-04-14T14:46:33Z

Neriv: /* Zen Joomla! template switcher */

==Joomla! Student Outreach Program==
JSOP has been created to provide a structure to allow students to participate in and contribute to the Joomla! project. Students will work with experienced mentors on coding and other projects designed to improve the Joomla! CMS and the general Joomla! ecosystem.

This program will include two separate ways that students can contribute to Joomla! in structured programs with experienced mentors. The first way will be working on larger projects as part of a team. The team will include one or more students and one or more mentors.

===Large Team Projects===

Here is a starting list for possible large team projects. The idea is that these will be larger projects that would be worked on by teams of students and mentors.

If you are interested in participating in one of these projects, please add your name under Interested Mentors or Interested Students. This is not final and does not commit you to anything. It will just help us figure out who is interested in what. You can add your name to more than one project if you like and then we can decide later which project you will work on.

====Improved, automated API documentation presentation====
Figure out a way to read the PHP code documentation into a database and use it to allow access to accurate, up-to-date documentation of the Joomla! API in a way that is usable to developers.

:'''Interested Mentors:''' Louis Landry. Chris Davenport
:'''Interested Students:'''

====Web-based translation of Joomla core language files and 3rd party components====
Currently the process of making translations for Joomla requires manual copying of files and subsequently using a text editor to manually translate. This is labour intensive, hard to keep up to date with the latest Joomla releases and does not promote collaborations. I am proposing to use an automated system to create and distribute translations for Joomla. The translations would be done using Narro a free GPL web-based translation software used by Mozilla. In addition an automation layer with a Joomla components needs to be developer to ensure the system does not need any manual updating and ensures that translations are community driven. Its an important project and will be lots of fun at the same time.

:'''Interested Mentors:''' Marius van Rijnsoever
:'''Interested Students:''' Edvard Ananyan

====Internationalisation of the Joomla! help screens for 1.6====
Improve the process for creating and deploying the help screens in the many languages for which Joomla! is translated.

:'''Interested Mentors:''' Jean-Marie Simonet,Akarawuth Tamrareang
:'''Interested Students:'''

====Multimedia Galleries ====
Develop an component able to create galleries with music, videos, applets, flash-games... it must support medias from different types (youtube, brightcove, .swf, .flv, .rmv, .mov....), be able to create playlists and more... give your ideas.

This project can reuse code from denvideo (http://extensions.joomla.org/extensions/multimedia/video-players-a-gallery/4053) and jmultimedia (http://extensions.joomla.org/extensions/external-contents/multimedia-channels/video-channels/5659)

:'''Interested Mentors:''' Marcelo Eden
:'''Interested Students:'''

====Version 1.5 to 1.6 migration script====
We need to allow 1.5 users to easily migrate their sites to version 1.6. Work on this has been started, but it is a big job. Also, this could include hooks to make it easier for third-party developers to build migration tools for their extensions.

:'''Interested Mentors:''' Mark Dexter, Rob Clayburn
:'''Interested Students:'''

====Project Management Tools====

This project could include:

* Develop a component with project collaboration features (like BaseCamp: http://basecamphq.com/).
* ProgressBar views based on completed task based on sprints, milestones, project...
* Different front-end views for Clients, Team, Managers...
* A module to show the active projects and is respective ProgressBars.
* Allow Comments and discussions on tasks
* Allow manager/team to set the function points value of each task (eq: planing poker)

:'''Skills needed:''' Joomla CMS framework, MVC, PHP, MySQL, Javascript, MooTools
:'''Interested Mentors:''' Marcelo Eden, Mike Carson
:'''Interested Students:'''

==== Joomla Dev Tools ====
This is a project which automatically generate codes for you to help when developing Extensions. This will help,
* New comers to decrease the learning curve of Joomla! Development
* Professionals to automate their Joomla! tasks

more details: http://docs.google.com/View?id=dhdpnvnz_59g6n3rsc8

samples : http://code.google.com/p/arunoda/source/browse/#svn/trunk/kadira%3Fstate%3Dclosed

:'''Interested Mentors:''' Oleg Nesterov, Will Mavis
:'''Interested Students:''' Arunoda Susiripala

===Small Task Projects===

These projects will be broken down into segments that can be completed within 30 days.

====Zen Joomla! template switcher====
This would be capable of efficiently allowing selection from a few hundred templates. Also maybe a component for submission and processing?

:'''Interested Mentors:''' Toni Marie, Flavia Tarzwell, Neri Valentin-Macias
:'''Interested Students:'''

====Usability testing====

:'''Interested Mentors:''' Elin Waring, Will Mavis, Neri Valentin-Macias
:'''Interested Students:'''

====System Testing====
Create automated system tests to allow testing of the CMS from a user perspective.

:'''Interested Mentors:''' Mark Dexter, Will Mavis
:'''Skills Needed:''' PHP, HTML
:'''Interested Students:'''

====Improve Unit Test Coverage====
Work has been started on this with the goal of a continuous build model, but test coverage is incomplete. We need to add many more unit tests. Proposals should specify an area of concentration. Several projects for different areas would be welcome.

:'''Interested Mentors:''' Alessandro Nadalin, Mark Dexter, Will Mavis
:'''Consultant:''' Ian MacLennon
:'''Skills Needed:''' PHP, PHPUnit, Joomla! Framework
:'''Difficulty:''' Medium

===Program Structure===

In both cases, students would be working on a volunteer basis.
However, we will figure out some fun rewards, like awarding t-shirts or other Joomla! stuff. Also, we will issue official certificates to students who successfully contribute to either program.

As with GSoC, the primary benefits to students are (a) real-world experience; (b) working with world-class mentors; and (c) the satisfaction of contributing to a great project and being part of a
great community.

====Application Process====
Since JSOP is a volunteer program, we do not have a fixed limit on the number of students who can participate. However, we need to make sure we have mentors for each project or task. Also, we still want students to formally apply to the program so that we have information about each student and can make sure they are assigned to projects. We will have more information about the details of the application process shortly.

Joomla! Student Outreach Program Project Ideas

2010-04-14T14:45:42Z

Neriv: /* Usability testing */

==Joomla! Student Outreach Program==
JSOP has been created to provide a structure to allow students to participate in and contribute to the Joomla! project. Students will work with experienced mentors on coding and other projects designed to improve the Joomla! CMS and the general Joomla! ecosystem.

This program will include two separate ways that students can contribute to Joomla! in structured programs with experienced mentors. The first way will be working on larger projects as part of a team. The team will include one or more students and one or more mentors.

===Large Team Projects===

Here is a starting list for possible large team projects. The idea is that these will be larger projects that would be worked on by teams of students and mentors.

If you are interested in participating in one of these projects, please add your name under Interested Mentors or Interested Students. This is not final and does not commit you to anything. It will just help us figure out who is interested in what. You can add your name to more than one project if you like and then we can decide later which project you will work on.

====Improved, automated API documentation presentation====
Figure out a way to read the PHP code documentation into a database and use it to allow access to accurate, up-to-date documentation of the Joomla! API in a way that is usable to developers.

:'''Interested Mentors:''' Louis Landry. Chris Davenport
:'''Interested Students:'''

====Web-based translation of Joomla core language files and 3rd party components====
Currently the process of making translations for Joomla requires manual copying of files and subsequently using a text editor to manually translate. This is labour intensive, hard to keep up to date with the latest Joomla releases and does not promote collaborations. I am proposing to use an automated system to create and distribute translations for Joomla. The translations would be done using Narro a free GPL web-based translation software used by Mozilla. In addition an automation layer with a Joomla components needs to be developer to ensure the system does not need any manual updating and ensures that translations are community driven. Its an important project and will be lots of fun at the same time.

:'''Interested Mentors:''' Marius van Rijnsoever
:'''Interested Students:''' Edvard Ananyan

====Internationalisation of the Joomla! help screens for 1.6====
Improve the process for creating and deploying the help screens in the many languages for which Joomla! is translated.

:'''Interested Mentors:''' Jean-Marie Simonet,Akarawuth Tamrareang
:'''Interested Students:'''

====Multimedia Galleries ====
Develop an component able to create galleries with music, videos, applets, flash-games... it must support medias from different types (youtube, brightcove, .swf, .flv, .rmv, .mov....), be able to create playlists and more... give your ideas.

This project can reuse code from denvideo (http://extensions.joomla.org/extensions/multimedia/video-players-a-gallery/4053) and jmultimedia (http://extensions.joomla.org/extensions/external-contents/multimedia-channels/video-channels/5659)

:'''Interested Mentors:''' Marcelo Eden
:'''Interested Students:'''

====Version 1.5 to 1.6 migration script====
We need to allow 1.5 users to easily migrate their sites to version 1.6. Work on this has been started, but it is a big job. Also, this could include hooks to make it easier for third-party developers to build migration tools for their extensions.

:'''Interested Mentors:''' Mark Dexter, Rob Clayburn
:'''Interested Students:'''

====Project Management Tools====

This project could include:

* Develop a component with project collaboration features (like BaseCamp: http://basecamphq.com/).
* ProgressBar views based on completed task based on sprints, milestones, project...
* Different front-end views for Clients, Team, Managers...
* A module to show the active projects and is respective ProgressBars.
* Allow Comments and discussions on tasks
* Allow manager/team to set the function points value of each task (eq: planing poker)

:'''Skills needed:''' Joomla CMS framework, MVC, PHP, MySQL, Javascript, MooTools
:'''Interested Mentors:''' Marcelo Eden, Mike Carson
:'''Interested Students:'''

==== Joomla Dev Tools ====
This is a project which automatically generate codes for you to help when developing Extensions. This will help,
* New comers to decrease the learning curve of Joomla! Development
* Professionals to automate their Joomla! tasks

more details: http://docs.google.com/View?id=dhdpnvnz_59g6n3rsc8

samples : http://code.google.com/p/arunoda/source/browse/#svn/trunk/kadira%3Fstate%3Dclosed

:'''Interested Mentors:''' Oleg Nesterov, Will Mavis
:'''Interested Students:''' Arunoda Susiripala

===Small Task Projects===

These projects will be broken down into segments that can be completed within 30 days.

====Zen Joomla! template switcher====
This would be capable of efficiently allowing selection from a few hundred templates. Also maybe a component for submission and processing?

:'''Interested Mentors:''' Toni Marie, Flavia Tarzwell
:'''Interested Students:'''

====Usability testing====

:'''Interested Mentors:''' Elin Waring, Will Mavis, Neri Valentin-Macias
:'''Interested Students:'''

====System Testing====
Create automated system tests to allow testing of the CMS from a user perspective.

:'''Interested Mentors:''' Mark Dexter, Will Mavis
:'''Skills Needed:''' PHP, HTML
:'''Interested Students:'''

====Improve Unit Test Coverage====
Work has been started on this with the goal of a continuous build model, but test coverage is incomplete. We need to add many more unit tests. Proposals should specify an area of concentration. Several projects for different areas would be welcome.

:'''Interested Mentors:''' Alessandro Nadalin, Mark Dexter, Will Mavis
:'''Consultant:''' Ian MacLennon
:'''Skills Needed:''' PHP, PHPUnit, Joomla! Framework
:'''Difficulty:''' Medium

===Program Structure===

In both cases, students would be working on a volunteer basis.
However, we will figure out some fun rewards, like awarding t-shirts or other Joomla! stuff. Also, we will issue official certificates to students who successfully contribute to either program.

As with GSoC, the primary benefits to students are (a) real-world experience; (b) working with world-class mentors; and (c) the satisfaction of contributing to a great project and being part of a
great community.

====Application Process====
Since JSOP is a volunteer program, we do not have a fixed limit on the number of students who can participate. However, we need to make sure we have mentors for each project or task. Also, we still want students to formally apply to the program so that we have information about each student and can make sure they are assigned to projects. We will have more information about the details of the application process shortly.

What is the purpose of the templateDetails.xml file?

2009-04-26T18:06:56Z

Neriv: /* File Structure */

{{RightTOC}}
The templateDetails.xml file holds a variety of meta-data used by the [[Screen.templates.15|Template Manager]] in installation and maintenance. It is helpful to recognize the different sections of the file. Typically, each section of data is indented to make the file more readable, but this indentation is not necessary.

===Basic Details===
The initial display of the Template Manager shows a list of available templates and basic details relating to the template. Each of these bits of information is gathered from the templateDetails.xml file.

[[Image:template_details_basic.png]]

<pre>
<install version="1.5" type="template">
<name>rhuk_milkyway</name>
<creationDate>11/20/06</creationDate>
<author>Andy Miller</author>
<authorEmail>rhuk@rockettheme.com.com</authorEmail>
<authorUrl>http://www.rockettheme.com</authorUrl>
<copyright></copyright>
<license>GNU/GPL</license>
<version>1.0.2</version>
<description>TPL_RHUK_MILKYWAY</description>
</pre>

===File Structure===
All files related to the template are listed. Each filename contains full path information starting at the template root. The Administrator's Installer uses this information when storing the files during installation.

A small portion of the files listed in the rhuk_milkyway template is given below.

<pre>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<filename>template_thumbnail.png</filename>
<filename>params.ini</filename>
<filename>images/arrow.png</filename>
<filename>images/indent1.png</filename>
</files>
</pre>

Optional and highly recommended file structure --

<pre>
<files>
<filename>index.php</filename>
<filename>templateDetails.xml</filename>
<filename>template_thumbnail.png</filename>
<filename>params.ini</filename>
<folder>images/</folder>
<folder>css/</folder>
</files>
</pre>

===Languages===
Some templates may include language files to allow translation of static text in the template. Notice that two language files are shown below. The first holds the language file for text that will be viewed by the User. The second, placed within <administration> tags, is for text that will be viewed by the Administrator.

<pre>
<languages>
<language tag="en-GB">en-GB.tpl_beez.ini</language>
</languages>
<administration>
<languages folder="admin">
<language tag="en-GB">en-GB.tpl_beez.ini</language>
</languages>
</administration>
</pre>

===Module Positions===
The available [[module_positions|Module Positions]] that can be used in the template are defined.

<pre>
<positions>
<position>breadcrumb</position>
<position>left</position>
<position>right</position>
<position>top</position>
<position>user1</position>
<position>user2</position>
<position>user3</position>
<position>user4</position>
<position>footer</position>
<position>debug</position>
<position>syndicate</position>
</positions>
</pre>

===Parameters===
A template may offer display options that can be chosen by the Administrator in the Template Manager. For instance, the rhuk_milkyway template allows the Administrator to change the border colors, change the background color, and define the display width.

[[Image:template_details_params.png]]

An example of adding a parameter and its values is shown below.

<pre>
<params>
<param name="colorVariation" type="list" default="white" label="Color Variation" description="Color variation to use">
<option value="blue">Blue</option>
<option value="red">Red</option>
<option value="green">Green</option>
<option value="orange">Orange</option>
<option value="black">Black</option>
<option value="white">White</option>
</param>
</params>
</pre>

For more information about working with Parameters, see:

: [[Defining a parameter in templateDetails.xml]]
: [[Retrieving parameter data in a template file]]

<noinclude>[[Category:Templates]][[Category:Topics]][[Category:Beginners]]
[[Category:Parameters]]
[[Category:Template FAQ]]
</noinclude>

Scheduling an Article to be available only between certain dates

2008-06-28T15:31:56Z

Neriv:

{{cookiejar}}
To publish an Article within a specific time frame you do as follows:
#Login Administrator Panel
#Create or Select an Article in Content -> Article Manager
#While editing article contents you will see the options as shown in the figure below:
[[Image:Timedpub.jpg | Article Scheduling]]

Scheduling an Article should produce a file icon as seen below:

[[Image:Timedpub1.jpg | Article Scheduling Final View]]

**Scheduling articles is NOT limited to the back-end administrator panel, it can also be completed in the front-end administration**

Scheduling an Article to be available only between certain dates

2008-06-28T15:31:22Z

Neriv:

{{cookiejar}}
To publish an Article within a specific time frame you do as follows:
#Login Administrator Panel
#Create or Select an Article in Content -> Article Manager
#While editing article contents you will see the options as shown in the figure below:
[[Image:Timedpub.jpg | Article Scheduling]]
Scheduling an Article should produce a file icon as seen below:
[[Image:Timedpub1.jpg | Article Scheduling Final View]]

**Scheduling articles is NOT limited to the back-end administrator panel, it can also be completed in the front-end administration**

Scheduling an Article to be available only between certain dates

2008-06-28T15:27:39Z

Neriv:

{{cookiejar}}
To publish an Article within a specific time frame you do as follows:
#Login Administrator Panel
#Create or Select an Article in Content -> Article Manager
#While editing article contents you will see the options as shown in the figure below:
[[Image:Timedpub.jpg | Article Scheduling]]
[[Image:Timedpub1.jpg | Article Scheduling Final View]]

**Scheduling articles is NOT limited to the back-end administrator panel, it can also be completed in the front-end administration**

File:Timedpub1.jpg

2008-06-28T15:26:43Z

Neriv:

File:Timedpub.jpg

2008-06-28T15:19:54Z

Neriv: uploaded a new version of "Image:Timedpub.jpg"

Timed publishing example.

Scheduling an Article to be available only between certain dates

2008-06-28T15:15:42Z

Neriv:

{{cookiejar}}
To publish an Article within a specific time frame you do as follows:
#Login Administrator Panel
#Create or Select an Article in Content -> Article Manager
#While editing article contents you will see the options as shown in the figure below:
[[Image:Timedpub.jpg | Article Scheduling]]

**Scheduling articles is NOT limited to the back-end administrator panel, it can also be completed in the front-end administration**

File:Timedpub.jpg

2008-06-28T15:09:09Z

Neriv: Timed publishing example.

Timed publishing example.

Scheduling an Article to be available only between certain dates

2008-06-28T15:07:13Z

Neriv:

{{cookiejar}}
{{inuse}}
To publish an Article within a specific time frame you do as follows:
#Login Administrator Panel
#Create or Select an Article in Content -> Article Manager
#While editing article contents you will see the options as shown below

Scheduling an Article to be available only between certain dates

2008-06-28T14:54:16Z

Neriv:

Where can you learn about PHP

2008-06-28T14:52:04Z

Neriv:

{{cookiejar}}
Hypertext Preprocessor or PHP is a computer scripting language designed for creating dynamic web pages. PHP is widely-used for web development and can be embedded into HTML. It generally runs on a web server, taking PHP code as its input and creating web pages as output.

#[http://www.php.net/tut.php Introductory Tutorial]
#[http://en.wikipedia.org/wiki/PHP Php Wiki]
#[http://www.php-mysql-tutorial.com/ Php-MYSQL Tutorial]

Where can you learn about PHP

2008-06-28T14:49:44Z

Neriv:

Where can you learn about PHP

2008-06-28T14:45:09Z

Neriv:

AJAX

2008-06-28T14:31:02Z

Neriv:

{{cookiejar}}
Asynchronous JavaScript and XML or AJAX, is a term for a group of interrelated web development techniques used for creating interactive web applications or commonly known as web 2.0. Ajax allows web applications to retrieve data from the server asynchronously in the background without interfering with the display and behavior of the existing website page. Data is retrieved using the XMLHttpRequest object or through the use of Remote Scripting in browsers that do not support it.

Ajax Resources:
#[http://ajaxphp.packtpub.com/index.htm Packt Publishing Book Free Online Edition]
#[http://mootools.net MooTools]
#[http://www.prototypejs.org/ Prototype]
#[http://script.aculo.us/ Script.aculo.us]
#[http://jquery.com/ Jquery]
#[http://blog.mootools.net/2007/6/5/help-i-dont-know-javascript Help I Don't JavaScript Blog]

AJAX

2008-06-28T14:25:40Z

Neriv:

J1.5:Database structure

2008-06-22T13:23:48Z

Neriv: /* Structure */

{{stub}}
{{inuse}}
==Structure==
The J! 1.5.x database structure includes 36 Tables
Tables listing w/out prefix_
#banner
#bannerclient
#bannertrack
#categories
#components
#contact_details
#content
#content_frontpage
#content_rating
#core_acl_aro
#core_acl_aro_groups
#core_acl_aro_map
#core_acl_aro_sections
#core_acl_aro_groups_aro_map
#core_log_items
#core_log_searches
#groups
#menu
#menu_types
#messages
#messages_cfg
#migration_backlinks
#modules
#modules_menu
#newsfeeds
#plugins
#polls
#poll_data
#poll_date
#poll_menu
#sections
#sessions
#stats_agents
#templates_menu
#users
#weblinks

'''API table Relationships joomla 1.5'''

Lien : http://www.torkiljohnsen.com/wp-content/uploads/2006/04/joomla_15_database_schema.png

J1.5:Database structure

2008-06-21T23:36:25Z

Neriv: /* Structure */

{{stub}}
==Structure==
The J! 1.5.x database structure includes 36 Tables
Tables listing w/out prefix_
#banner
#bannerclient
#bannertrack
#categories
#components
#contact_details
#content
#content_frontpage
#content_rating
#core_acl_aro
#core_acl_aro_groups
#core_acl_aro_map
#core_acl_aro_sections
#core_acl_aro_groups_aro_map
#core_log_items
#core_log_searches
#groups
#menu
#menu_types
#messages
#messages_cfg
#migration_backlinks
#modules
#modules_menu
#newsfeeds
#plugins
#polls
#poll_data
#poll_date
#poll_menu
#sections
#sessions
#stats_agents
#templates_menu
#users
#weblinks

'''API table Relationships joomla 1.5'''

Lien : http://www.torkiljohnsen.com/wp-content/uploads/2006/04/joomla_15_database_schema.png

J1.5:Database structure

2008-06-21T23:35:26Z

Neriv: /* Structure */

{{stub}}
==Structure==
{{inuse}}
The J! 1.5.x database structure includes 36 Tables
Tables listing w/out prefix_
#banner
#bannerclient
#bannertrack
#categories
#components
#contact_details
#content
#content_frontpage
#content_rating
#core_acl_aro
#core_acl_aro_groups
#core_acl_aro_map
#core_acl_aro_sections
#core_acl_aro_groups_aro_map
#core_log_items
#core_log_searches
#groups
#menu
#menu_types
#messages
#messages_cfg
#migration_backlinks
#modules
#modules_menu
#newsfeeds
#plugins
#polls
#poll_data
#poll_date
#poll_menu
#sections
#sessions
#stats_agents
#templates_menu
#users
#weblinks

'''API table Relationships joomla 1.5'''

Lien : http://www.torkiljohnsen.com/wp-content/uploads/2006/04/joomla_15_database_schema.png

J1.5:Database structure

2008-06-21T23:17:53Z

Neriv: /* Structure */

{{stub}}
==Structure==
{{inuse}}
*Tables listing
**banner
**bannerclient

to be continued !

'''API table Relationships joomla 1.5'''

Lien : http://www.torkiljohnsen.com/wp-content/uploads/2006/04/joomla_15_database_schema.png

Help15:Screen.modules.15

2008-06-21T21:31:14Z

Neriv: /* Description */

{{review}}
==How to Access==
Select '''Extensions → Module Manager''' from the drop-down menu on the back-end of your Joomla! installation. Or click the "Site" link from the Module Manager / Administrator screen.

==Description==
The Module Manager is where you add and edit Joomla! Modules. In Joomla!, Modules are used to display content and/or media around the main content.

Module Facts:
#All Joomla! websites require at least 1 Menu Module
#All Other Module Types are Optional. (Examples: News, Banner, Latest News, Polls)
#Every Menu is accompanied by a menu module. (Example mod_mainmenu)
#Multiple occurrences of similar module types.
#Some Modules are linked to components. For example, each Menu Module is related to one Menu component. To define a Menu in Joomla!, you need to create the Menu and Menu Items using the Menus screens and then create the Module for the Menu using this screen. Other Modules, such as Custom HTML and Breadcrumbs, do not depend on any other content. See [[screen.modules.edit.15|Module Manager - New/Edit]] for information about the different Module Types.

The Joomla! installation is accompanied with 20 module types, additional 3rd party modules can be located at the [http://extensions.joomla.org/ JED].

==Screenshot==
[[Image:Screen_module_manager_15.png |center|thumb|800x539px]]

==Column Headers==
Click on the column heading to sort the list by that column's value.
{{colheader|Number}}
{{colheader|Checkbox}}
*'''Module Name.''' The name of the Module. You can click on the name to open the Module for editing.
{{colheader|Enabled}}
*'''Order.''' The order to display modules within a Position. If the list is sorted by this column, you can change the display order of modules within a Position by selecting a Position in the "Select Position" filter and then clicking the arrows or by entering the sequential order and clicking 'Save Order'.
{{colheader|Access Level}}
{{colheader|Position}}
{{colheader|Pages}}
{{colheader|Type}}
{{colheader|Id}}
{{colheader|Display #}}

==Toolbar==
At the top right you will see the toolbar:

[[Image:Module_manager_toolbar.png]]

The functions are:
{{toolbaricon|Enable}}
{{toolbaricon|Disable}}
{{toolbaricon|Copy Module}}
{{toolbaricon|Delete}}
{{toolbaricon|Edit}}
{{toolbaricon|New Module}}
{{toolbaricon|Help}}

'''Site and Administrator Links'''
At the top left, above the Filter, you will see the following two links:[[Image:Module_manager_links.png|frame|center]]
*'''Site.''' Opens the Site tab. This is the default tab and allows you to manage the Modules for the front end of the web site.
*'''Administrator.''' This tab allows you to manage the Modules for the back end administration of the web site. If you do not need to change the Joomla! administrator menus, no modifications are required here.

==List Filters==
'''Filter by Partial Title'''

You can filter the list of items by typing part of the title or the ID number. Or, you can select a combination of Category and Published State.
{{colheader|List Filter}}

'''Filter by Category and Published State'''
In the upper right area, above the column headings, are 2 drop-down list boxes as shown below:[[Image:Module_manager_filters.png|center]] The selections may be combined. Only items matching both selections will display in the list.
{{colheader|Select Template}}
{{colheader|Select Position}}
{{colheader|Select Type}}
{{colheader|Select Enabled State}}

==Quick Tips==
*You can change the order of Modules within a Module Position as follows:
**Select the desired Position using the Position Filter. This will limit the list to Modules that are assigned to this Position.
**Change the order using the Up or Down arrows or by typing the order number and pressing the Save Order icon. The Modules will display in the new order within the Position.
*You can open a Module for editing by clicking on the Module Name. This opens the [[screen.modules.edit.15|Module Manager - New/Edit]] screen.

==Related Information==
*To create or edit Modules: [[screen.modules.edit.15|Module Manager - New/Edit]]
*To see the function and Parameters for all available front-end Modules: [[screen.modulessite.edit.15|Modules Site]]
*To see the function and Parameters for all available back-end (administrator) Modules: [[screen.modulesadministrator.edit.15|Modules Administrator]]
*To view a list of all installed Modules and install or uninstall Modules: [[screen.installer.15|Extension Manager]]
*To work with Menus: [[screen.menumanager.15|Menu Manager]]
*To work with Banners: [[screen.banners.15|Banner Manager]]
<noinclude>{{cathelp|1.5|Module Manager|Extensions}}</noinclude>

Help15:Screen.installer.15

2008-06-21T21:13:49Z

Neriv: /* Description */

{{review}}

==Description==
You can extend your Joomla! based website functions by installing different types of extensions (components, modules, plugins, templates). All extension installations and uninstallations occur from the back-end administrator panel of your Joomla! install. Extensions can be installed from your local hard drive (installation package), from an install directory on your website, or from an URL.

[[Image:Screen_extension_manager_install_15.png]]

==Version Changes==
In Joomla! 1.0 the components, modules, mambots (called plugins in Joomla! 1.5), templates and languages could be installed separately via their appropriate screens from the menu items of the Installers menu.

It's much more simple in Joomla! 1.5 as the installer can detect the extension type and continue the appropriate installation process.

It was not possible to install a remote file from a specified URL in Joomla! 1.0.

In Joomla! 1.0.x the available extensions were listed on their installation screens. In Joomla! 1.5 it was changed to a multi-tabbed interface, providing an easier and simpler solution for managing your installed extensions.

==Column Headers==

=== Components ===
{{colheader|Number}}
{{colheader|Component name}}
{{colheader|Enabled}}
{{colheader|Version}}
{{colheader|Date}}
{{colheader|Author}}

=== Modules ===
{{colheader|Number}}
{{colheader|Module name}}
{{colheader|Module client}}
{{colheader|Version}}
{{colheader|Date}}
{{colheader|Author}}

=== Plugins ===
{{colheader|Number}}
{{colheader|Plugin name}}
{{colheader|Plugin type}}
{{colheader|Version}}
{{colheader|Date}}
{{colheader|Author}}

=== Languages ===
{{colheader|Number}}
{{colheader|Language name}}
{{colheader|Language client}}
{{colheader|Version}}
{{colheader|Date}}
{{colheader|Author}}

=== Templates ===
{{colheader|Number}}
{{colheader|Template name}}
{{colheader|Template client}}
{{colheader|Version}}
{{colheader|Date}}
{{colheader|Author}}

==Typical Usage==
The Installer can be opened from '''Extensions -> Install/Uninstall''' menu item. You can choose the mode of the installation. The mode used most frequently is the Upload Package File.

'''Upload Package File'''

In the upload field named ''Package file'' you can specify the package of the extension to install. If GZip support is enabled with PHP on your server, the installer can extract the contents of a zipped or gzipped archive. You can browse your local hard drive and search for the package to upload with the ''Browse...'' button. After you find the package on your local drive, select it in the ''Upload File'' window and click on the ''Open'' button, so the specified package name with the path appears in the ''Package file'' field. Click on the ''Upload File & Install'' button. Joomla! uploads the package and automatically installs it. You can read a message about the success of the procedure. If you get an error message, read it thoughtfully and make any required correction.

'''Install from Directory'''

Create a temporary directory on your hard drive and decompress the compressed package into it, then with FTP you can upload the files and directories of the package into a directory on the server. Then in the ''Install Directory'' field specify the directory where you have uploaded the files and directories of the package. After that click on the ''Install'' button and Joomla! automatically installs the content of the given directory. You can read a message about the success of the procedure. If you get an error message, read it thoughtfully and make any required correction.

'''Install from URL'''

In the Install URL field specify the URL of the package to upload and click on the Install button and Joomla! automatically installs it. You can read a message about the success of the procedure. If you get an error message, read it thoughtfully and make any required correction.

'''Uninstalling extensions'''

Click on one of the tabs depending on which type of extension you want to uninstall. In the list select the extension and click on the Uninstall icon on the upper-right side of the screen. Joomla! automatically uninstalls the specified extension.

You can uninstall multiple modules, plugins, languages and templates in one step but you can uninstall only one component at a time.

==Quick Tips==

Think twice if you want to uninstall a Joomla addon. For example sometimes it is a good idea to unpublish the modules you don't want to show on frontend. Generally the bundled Joomla modules cannot be reinstalled without a hitch.

'''Disable a component'''

If you do not want to use a component, then switch to the ''Components'' tab and click the green tick in the ''Enabled'' column. The green tick will be replaced with a red X. The disabled component will disappear in the ''Components'' menu.

'''Support old extensions in Legacy Mode'''

Some old 1.0.x extensions support Joomla! 1.5 in ''Legacy Mode''. To be able to install such extensions please open the [[screen.plugins.15|Plugin Manager]] screen from the ''Extensions'' menu and enable plugin ''System - Legacy'' as it is disabled by the default.

==Points to Watch==
Some Core or System addons (Component, Module, Plugin) cannot be uninstalled so cannot be selected for uninstallation. Also the Default Template and Language are disabled for selection.

'''Important''': Do not delete the Default Template and Languege files using FTP because it generates errors in error both front-end and back-end.

When you want to install a 3rd party developed module or plugin which belongs to a component, please keep in mind that you cannot use it unless you first install the related component.

When you uninstall a 3rd party developed component having its own module(s) or plugin(s), these modules cannot be used any more, so please uninstall them as well.

Some components coded by 3rd party developers may have their own modules and/or plugins included in the installer, so make sure the module/plugin directories are writable otherwise the extension will not work properly.

'''SECURITY WARNING:''' Please use only those 3rd party extensions on your site which you really need. Do not use your live site for testing purposes because it may compromise your site and server.

Please do not install Joomla! extensions downloaded from warez sites because they may be infected by a virus or malware that cause damage on the server and can contaminate the computer of your visitors! Installing from remote URL can be dangerous as well.


==Dependencies==

An installed component will be registered and listed in the ''Components'' menu.

You can assign a menu item to an installed component in the [[screen.menus.15|Menu Item Manager]] by clicking the ''New'' toolbar button. You can select it in the ''Internal Link'' branch.

An installed module will be added to the list of the [[screen.modules.15|Module Manager]] where you can enable/disable it or [[screen.modules.edit.15|customize its parameters]].

An installed plugin will be added to the list of the [[screen.plugins.15|Plugin Manager]] where you can enable/disable it or [[screen.plugins.edit.15|customize its parameters]].

An installed template will be added to the Site or Administrator list of the [[screen.templates.15|Template Manager]] where you can assign it to all of the pages or to the selected ones and customize its parameters, edit the HTML or CSS source or preview the available module positions.

An installed language will be added to the Site or Administrator list of the [[screen.languages.15|Language Manager]] depending on the client attribute where you can set it as the default language.

System - Legacy plugin should be enabled to be able to install the prepared Joomla! 1.0.x extensions.
<noinclude>{{cathelp|1.5|Extension Manager|Extensions}}</noinclude>

Filing bugs and issues

2008-06-21T20:45:29Z

Neriv: /* Reporting bugs */

{{review}}

== Reporting bugs ==

To report a bug in the Joomla! bug trackers, one has to create an "artifact". Once this artifact is created, the developers will check the validity of it and act accordingly.

=== Register an Account at joomlacode.org ===
[http://joomlacode.org/gf/account/?action=UserAdd Register]

=== Access the Joomla! development bug tracker. ===

*[http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemBrowse&tracker_id=32 Joomla! 1.5 Bug Tracker]
*[http://joomlacode.org/gf/project/joomla/tracker/?action=TrackerItemBrowse&tracker_id=5782 Joomla! 1.0 Bug Tracker]

=== Check to see if the bug you want to report is already reported. ===

A series of filters display the artifacts. Make sure Priority is set to "Any", Assignee to "Any" and Status to "Any", other filters to nothing. Mouse over the title of the artefacts to check their contents. If the issue you are experiencing is not already reported, click on the bottom-right Button "Add new Tracker Item".

A new screen will display and there, the more information you give, the easier it is for the developers.

Fill as many fields as you can.

* [[Priority]] : Use the default "Medium" except if you know the code enough to make another choice.
* PHP : Choose the version you are testing on. You can find this information by clicking the Menu "Help"->"System Info" in the Administrator back-end of Joomla!.
* Estimated Time : Leave this blank.
* Build : Type here the #SVN number if you know it, or Nightly Build date, or Version used if using a Released version.
* Browser : Self-explanatory.
* Database : The version of MySQL is also available in "Help" -> "System Info".
* Status : Leave this to "Open".
* Percent Complete : Leave this blank.
* Category : This one is more tricky. Use "Administration" if you do not know better.
* Customer : Use "User" if the issue is in front-end, "Developer" if the issue concerns an extension you are developing, "Administrator" in other cases.
* Web Server : The version/server type is also available in "Help" -> "System Info".

=== Provide a summary ===

Describe in a few words the issues you are having. It is generally a good idea to use existing artefacts as examples if this is your first time reporting a bug.

Examples:

* Front-end: Warning such and such.
* Back-end: Unable to save article when "nameofplugin" is published.

Note: Take care to be descriptive in your summary as this is the first thing the developers will see when they are perusing the tracker for something to fix.

=== Provide details about the bug ===

This is the most important part of reporting the bug. Describe here step by step how you got the error you are noticing.

The more details, the better.

Examples:

A. When I enabled "nameofplugin", no article can be saved. These are the plugins enabled at the same time. SEF is on (or Off). My site is in a sub-folder. I also remark that... etc. Files such and such are the issues IMHO (if you know what you are talking about).

B. Back-end. Clicking on "menu_name" Menu. Page opened is blank. Any other menu works OK. etc.

C. Back-end. Content -> Article Manager (The -> means you click on a submenu). Editing a non-categorized Article. Section dropdown does not display the sections available (or Editor is going over the right column for parameters, or Can't save article after changing a parameter [describe parameter], etc.

D. I have such an such issue when doing this and that. By changing this code [code proposed] in file [name and hierarchy of file], line(s) #, the issue looks solved on my settings.

=== Add an attachment to your report ===

To better describe the issue or/and propose a fix, you can add attachments to the artifact you are creating by using the "Browse" buttons at the bottom of the screen.
A screen capture of the page(s) concerned helps a lot. If you can, try to optimize the size of the image through an image editor.
If you know what part(s) of the code base to change, a patch [patches] or a full file where your changes are WELL shown will help the developers to solve the problem quicker.

=== Finish and send in the report ===

You will receive an e-mail confirming that you posted the artifact. When someone comments or asks for supplementary details or solves the issue, you will receive a notification e-mail and may reply if needed.

=== Extra tips and tricks ===

Well-written bug reports are incredibly helpful. However, there's a certain amount of overhead involved in working with any bug tracking system, so your help in keeping our ticket tracker as useful as possible is appreciated. In particular:

* Do read the [http://docs.joomla.org/FAQs FAQ] to see if your issue might be a well-known question.
* Do search [http://joomlacode.org/gf/project/joomla/tracker/ the tracker] to see if your issue has already been filed.
* Do ask on [http://forum.joomla.org/index.php/board,199.0.html testing forums] first if you're not sure if what you're seeing is a bug.
* Do write complete, reproducible, specific bug reports. Include as much information as you possibly can, complete with code snippets, test cases, etc. A minimal example that illustrates the bug in a nice small test case is the best possible bug report.
* Don't use the tracker system to ask support questions. Use the [http://forum.joomla.org/ joomla forums], or the [irc://irc.freenode.net/joomla #joomla] IRC channel on freenode for that.
* Don't use the trackers to make large-scale feature requests. We like to discuss any big changes to Joomla's core on the [http://forum.joomla.org/index.php#6 developers forums] before actually working on them.
* Don't reopen issues that have been marked "not a bug". This mark means that the decision has been made that we can't or won't fix this particular issue. If you're not sure why, please ask on developer forums.
* Don't use the tracker for lengthy discussions, because they're likely to get lost. If a particular artifact is controversial, please move discussion to [http://forum.joomla.org/index.php#6 developer forums].

== Reporting security issues ==

Report security issues to security [at] joomla [dot] org. This is a private list only open to long-time, highly trusted Joomla developers, and its archives are not publicly readable.

In the event of a confirmed vulnerability in Joomla itself, we will take the following actions:

* Acknowledge to the reporter that we've received the report and that a fix is forthcoming. We'll give a rough timeline and ask the reporter to keep the issue confidential until we announce it.
* Halt all other development as long as is needed to develop a fix, including patches against the current and two previous releases.
* Determine a go-public date for announcing the vulnerability and the fix. To try to mitigate a possible "arms race" between those applying the patch and those trying to exploit the hole, we will not announce security problems immediately.
* Publicly announce the vulnerability and the fix on the pre-determined go-public date. This will probably mean a new release of Joomla! but in some cases it may simply be patches against current releases.

Installation FAQs Version 1.0

2008-06-21T20:12:53Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
**Apply Xampp Post Installation Security Settings Utilizing the Security Option on the Left Menu.**
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local xampp development environment this file is located in c:\xampp\php. To make all necessary changes you must do the following:
#Locate and open php.ini with any text editor.
#Locate max_execution_time as seen in figure below.
#Modify the settings according to your needs.
#Save Changes.
#Restart Xampp for new settings to take effect.

[[Image:Php-max-exec.jpg|Php-max-exec.jpg]]

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T20:10:38Z

Neriv: /* How do I fix the "Max Execution Time Exceeded" error? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local xampp development environment this file is located in c:\xampp\php. To make all necessary changes you must do the following:
#Locate and open php.ini with any text editor.
#Locate max_execution_time as seen in figure below.
#Modify the settings according to your needs.
#Save Changes.
#Restart Xampp for new settings to take effect.

[[Image:Php-max-exec.jpg|Php-max-exec.jpg]]

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T20:03:06Z

Neriv: /* How do I fix the "Max Execution Time Exceeded" error? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local a xampp development environment this file is located in c:\xampp\php. Open php.ini with any text editor and locate option as seen in the image below.

[[Image:Php-max-exec.jpg|Php-max-exec.jpg]]

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T20:02:43Z

Neriv: /* How do I fix the "Max Execution Time Exceeded" error? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local a xampp development environment this file is located in c:\xampp\php. Open php.ini with any text editor and locate option as seen in the image below.
[[Image:Php-max-exec.jpg|Php-max-exec.jpg]]
{{inuse}}

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T20:01:51Z

Neriv: /* How do I fix the "Max Execution Time Exceeded" error? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local a xampp development environment this file is located in c:\xampp\php. Open php.ini with any text editor and locate option as seen in the image below.
[[Php-max-exec.jpg]]
{{inuse}}

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

File:Php-max-exec.jpg

2008-06-21T20:01:04Z

Neriv:

Installation FAQs Version 1.0

2008-06-21T19:58:35Z

Neriv: /* How do I fix the "Max Execution Time Exceeded" error? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Max execution time exceeded is an error produced by Php. To resolve this error you have to modify the php server configuration or php.ini file. On a local a xampp development environment this file is located in c:\xampp\php. Open php.ini with any text editor and locate option as seen in the image below.
{{inuse}}

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:52:14Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]
#Click on Apache Admin button to view local web server main page
[[Image:Xampp-success.jpg|Xampp after successful local Installation]]

**Apply Xampp Post Installation Security Recommendations provided by apache friends
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:41:35Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute xampp control panel.
#Select services that you would like to start
#Click Start
[[Image:Xampp-control-view.jpg|Xampp Control Panel View]]

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:37:50Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute.
[[Image:Xampp-control-view.jpg|Xampp-Control Menu]]

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:29:21Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html Apache Friends].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute.
#

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:26:50Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

XAMPP
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute.

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:26:27Z

Neriv:

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:26:01Z

Neriv:

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

<h2>XAMPP</h2>
#Download latest version of Xampp for windows from [http://www.apachefriends.org/en/xampp-windows.html].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute.

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:24:41Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local development and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

<h2>XAMPP</h2>
#Download latest Xampp version from [http://apachefriends.org].
#Create an xampp directory at the root of C:\
#Extract downloaded xampp zip file into newly created xampp directory
#Locate extracted file xampp-control within the xampp directory and double click to execute.

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:15:15Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

There are multiple methods available for creating a local installation and testing environment for Joomla! on Win XP including:

*[http://www.apachefriends.org/en/xampp.html Xampp]
*[http://bitnami.org/stack/joomla Bitnami Stack]
*[http://www.wampserver.com/index.php WampServer]

{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:07:41Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

waiting for licensing info

Setting up a virtual machine on your Win XP workstation, using the free VMWARE player, and a free Ubuntu VM package, is a good way to build a local testbed.
{{inuse}}

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Installation FAQs Version 1.0

2008-06-21T19:06:47Z

Neriv: /* How can I set up/install Joomla! on Win XP for local testing? */

{{review}}

==Should I install the 1.0.x or 1.5 version of Joomla!?==

Your needs and experience should determine which version you install. Factors you might wish to consider include:

* the importance of specific features or extensions for your site
* the expected life span of your site
* you and your user's familiarity with Joomla!
* A new release will always have more issues than a mature product. You and your user's tolerance for this is something to consider

==How much webspace do I need to install Joomla!?==

15 megabytes (mb) of disk space should be enough for a default installation without additional component, images, and other media. The database will be small when starting, and will grow when adding more content.

==How do I install Joomla! 1.0?==

Detailed instructions are available from the Joomla! help site, http://help.joomla.org/content/category/15/99/132/.

How to install Joomla! will depend on what kind of webserver you have, what the settings of the server are, and what permissions you have.

If you have a hosted site, you may have access to fantastico or a similar product via your control panel. This can be an easy way to install Joomla! However, double check to make sure that the current version of Joomla! will be installled.

==How do I install Joomla! 1.5?==

Instructions for installation can be found here. Installation Guide http://help.joomla.org/content/category/48/268/302/

==How can I avoid having to upload configuration.php in a manual install?==

===Joomla! 1.0===

If you manually install Joomla you will get a message during installation that the configuration.php is not writable and the installation process provides you with the entire configuration.php which you have to copy/paste to an editor and upload and name configuration.php to complete installation.

# upload your core files to the directory of the server where you want to install Joomla
# create an empty configuration.php (either using your filemenager or editing locally and uploading) in the same folder as the Joomla! root.
# do the Joomla! installation.

The configuration.php is now written directly in the file system. Make sure the configuration.php is afterwards set to 444 or 644 (not writable) to protect your system.

==How do you pre-install extensions?==

You may want to create an installation file that includes specific extensions in addition to the core Joomla!. You might want to do this if you have or plan to create many sites that all use the same basic suite of extensions.

# Install Joomla! as normal.
# RENAME instead of delete installation folder (you will need to add it to the zip).
# Install all extentions as per instructions for each.
# Backup the database and name the file joomla.sql and place into the sql folder of the installation folder you renamed.
# Rename the installation folder to installation from whatever you renamed it.
# Zip all files and folders (making sure to maintain file and folder structure in the zip) but do not zip the configuration.php that was created during install.
# Upload that zip and extract all the files to the webroot of the target site.
# Install as normal.
# Check to see if there are any patches since the time you made this package and patch accordingly.
# Note that file permissions will not be retained by the zip so you will have to go through all the permission steps during install and patch as usual. And you will most likely have to edit the userlist and remove one of the Administrators.

Please note that if you intend to distribute (as opposed to simply using this yourself) a version of Joomla! that has any extensions released under non-GPL compliant licenses pre-installed there are important licensing issues that you need to review.

{{inuse}}
==How can I set up/install Joomla! on Win XP for local testing?==

waiting for licensing info

Setting up a virtual machine on your Win XP workstation, using the free VMWARE player, and a free Ubuntu VM package, is a good way to build a local testbed.

==How do I fix the "Max Execution Time Exceeded" error?==

Waiting for Licensing info

==How do I upgrade 1.0.x versions?==

In general, you can update following the instructions below. However, it is recommended that you check the upgrading forum for special instructions for a given release.

; What is a patch?
: A patch in Joomla! is a bunch of bug fixes, and might or might not include security issues. The patch announcement will always tell if a patch has fixed security issues. A patch is a minor upgrade. From Joomla! 1.0.0 to Joomla! 1.0.7 is considered a patch. Going from Joomla! 1.0,x to Joomla! 1.5 (which will be released later this year) will be a major upgrade and should be treated differently.

; How do I know which version I use?
: Go to the administrator backend, and check the second line from the bottom, it will look something like this: 'Joomla! 1.0.x Stable [ Sunny ] 15-Jan-2006 20:00 UTC'. The information that is available here, is pulled from /includes/version.php Question: should I patch or not? It is always advised to update to the latest version, especially if a patch has security fixes in it. When you experience no problems with Joomla!, and a patch doesn't contain security fixes, you do not have to patch to the latest version. Take care that if you jump more then one step to take a look at all the announcements. A patch for Joomla! 1.0.7, for example, doesn't contain the announcement for Joomla! 1.0.6. Whenever you experience problems, please search the forums first and try to patch your installation to the latest version.

; Is this also the way to upgrade Joomla! 1.0.x to 1.5.x?
: There is a separate [[Migration|migration procedure]] to upgrade from Joomla 1.0.x to Joomla 1.5.x. This consists of more than just copying over the patched files.

; Do I need to install one or more patches to go to the latest version?
: When going from Joomla! 1.0.1 to Joomla! 1.0.x for example, you only need to install one patch. This patch will have a name like 'Joomla 1.0.1 to 1.0.x-Stable-Patch Package.zip'. Make sure that you current Joomla! version is the first number and that the version you are going to is the second number. Patches can be obtained here.

; Why do patch files have different extensions like .zip, .tar.gz, and .tar.bz?
: You only need one of those patches, the different extensions are for different operating systems. People using Windows will probably want to get the .zip files.

; Does a patch overwrite my configuration?
: No, the patch only overwrites files that are available in an official download. It doesn't overwrite configuration.php for example. There are a few things that you need to know. A patch can overwrite the default language file /language/english.php. You only need to take care if you made changes to the default english.php. A Joomla! patch doesn't overwrite other language files you have put there yourself. A patch can also overwrite /images/favicon.ico, for the people who use a favicon.ico and have overwritten this file. A patch can overwrite files in the default templates that are available with a default Joomla installation. If you want to use a default template, please make sure that it is better to copy the default template to another folder under the /templates directory. If this is not possible, please remove the /templates directory out of the patch files.

; When do I need to update my language file?
: You basically only need to update your language file if you are using a language other than English. It is possible that patch contains a few additions in the default language file (/includes/english.php). If this is the case /includes/english.php will be available in the patch. Check your local international forum or the language forum for any updates that have taken place.

; What about the configuration.php-dist file?
: This file is only needed if the installation wizard doesn't work when Joomla! is installed for the first time. This file can be found in a patch, as sometimes there are new configuration settings. This file can be totally ignored when patching Joomla!. The new configuration settings will be automatically added to your current configuration.php file.

; How do I patch Joomla! for a local installation?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* Select all files and folders in the patch, and copy them over the root directory of your local installation. This is the location where your configuration.php is available. After the copying is finished, the patch is finished.
* Set your site online again, your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed.

; How do I patch for a Joomla! installation at a hoster?
* Create a back-up of both data and database before starting!
* Check the forum if any problems have been found.
* Download the patch in question.
* Unpack the patch in an empty folder. If your operating system doesn't contain an application that can unzip/untar your patch, you can download the open source application 7-zip from http://www.7-zip.org/.
* It is highly advised to set your site offline for the duration of the patch. You can do this in the administrator backend, go to Global Configuration, and set 'Site offline' to 'Yes'.
* You need a FTP program. An example of an FTP program is FileZilla. This is an open source client that is available from http://filezilla-project.org.
* Another FTP program will work as well. For this application to work, you need an FTP account, with a corresponding password (obtained from your hoster). Open your FTP client, and make sure that you change the configuration so that 'Passive Mode' is on. Most FTP clients will have this option in its configuration.
* Select all files and folders in the FTP program, and copy them over the root directory of your installation at your host. This is the location where the configuration.php file is available. After the copying is finished, you are done. Check that all files have copied correctly. There are quite a few reports that files can get corrupted during transfer.
* Set your site online again. Your Joomla! installation should be patched to the latest version.
* Check the version in the administrator backend. The version should be changed. http://forum.joomla.org/index.php/topic,33226.0.html

<noinclude>[[Category:FAQ]]</noinclude>

Pizza Bugs and Fun 2/Contributors List

2008-06-02T13:37:53Z

Neriv: /* Contributors */

<noinclude>If you made a contribution to the documentation held on this site, please feel free to add your name below. Please consider adding your real name in addition to your nickname. You may, optionally, include a link to your website.</noinclude>

== Contributors ==

* Chris Davenport ([[Special:Contributions/Chris_Davenport|contributions]])
* Kevin Devine ([[Special:Contributions/Kevin_Devine|contributions]])
* Anthony Ferrara ([[Special:Contributions/ircmaxell|contributions]])
* Jerry Hilburn ([[Special:Contributions/Jerry_Hilburn|contributions]])
* Wilco Jansen ([[Special:Contributions/willebil|contributions]])
* Jennifer Marriot ([[Special:Contributions/Jennifer_Marriot|contributions]])
* Amy Stephen ([[Special:Contributions/AmyStephen|contributions]])
* Elin Waring ([[Special:Contributions/Elin|contributions]])
* Nereyda Valentin-Macias ([[Special:Contributions/Neriv|contributions]])

Pizza Bugs and Fun 2/Contributors List

2008-06-02T13:37:07Z

Neriv: /* Contributors */

Joomla!

2008-01-21T05:01:45Z

Neriv:

Joomla! is a powerful Content Management System (CMS) used to power simple to corporate websites all over the world. The benefits and features of the Joomla content management system include:

* Easy Installation
* Simple website maintenance
* Joomla! has lots of built-in features: Mass Mailing, Banner Management, SEF (Search Engine Friendly urls), and much more...
* Thousands of FREE and commercial extensions available on http://extensions.joomla.org/
* Many free and commercial templates are available to make your website attractive

'''Main Joomla! website:''' http://www.joomla.org

'''Joomla Support forums:''' http://forum.joomla.org/

Joomla!

2008-01-21T04:59:34Z

Neriv:

Joomla! is a powerful Content Management System (CMS) used to power simple to corporate website all over the world. The benefits and features of the Joomla content management system include:

* Easy Installation
* Easy website maintenance
* Joomla! has lots of built-in features: Mass Mailing, Banner Management, SEF (Search Engine Friendly urls), and much more...
* Thousands of FREE and commercial extensions available on http://extensions.joomla.org/
* Many free and commercial templates are available to make your website attractive

'''Main Joomla! website:''' http://www.joomla.org

'''Joomla Support forums:''' http://forum.joomla.org/

Copying a Joomla website

2008-01-19T18:07:16Z

Neriv: /* Copying the database */

{{underconstruction}}
Copying a Joomla! website is a two-part process: you must copy the files and you must copy the database (which is where the content is stored). Copying the files and copying the database are separate operations. Which you carry out first will depend on your particular circumstances but in most cases it does not really matter. If your website is being updated frequently and you need to take your website offline while the copy takes place then you will probably want to perform the database copy last so as to minimize downtime.

==Copying the files==

'''FTP Download and Upload Method'''

One method of copying the files from one Joomla! installation to another is to use standard desktop FTP software to first download all of the files comprising your Web site from their location on your Web server, then upload these files to the location of the new Joomla! installation. Depending on where you're placing the copy of your Joomla! site, the new location could be a different directory on the same Web server, or it could be a new location on a completely different Web server.

It is important to maintain the same directory structure for all of your folders and files as you move them from one location to another. Fortunately, desktop FTP software will handle this automatically as you upload and download sets of files and folders. (Your FTP software should contain Help documentation which explains FTP and how to use the FTP software interface.)

Note that after you move the files from one location to another, you may still need to edit Joomla! configuration files to get your copy of Joomla! working at the new location; you may also need to change settings for aspects of your Web server in order to get the copy of your Joomla! site working.

In rare instances, a file may become corrupted during an FTP transfer, where only part of the file is successfully transmitted. If you encounter strange or unexpected errors with your new Joomla! installation after you copy over the files, you may want to try re-uploading your files in case of corruption during transfer.

==Copying the database==
There are multiple methods to copying your Joomla database and moving it to a live server environment.

'''MySQL COMMAND LINE METHOD'''

Usually you run mysqldump to create database copy:
$ mysqldump -u user -p db-name > db-name.out

Copy db-name.out file using sftp/ssh to remote MySQL server:
$ scp db-name.out user@remote.box.com:/backup

Restore database at remote server (login over ssh):
$ mysql -u user -p db-name < db-name.out

'''PHPMYADMIN METHOD'''

The phpMyAdmin tool can be used to export and import a database, providing a simple way to duplicate a copy of a database using a different name on our servers.

'''Exporting a copy of the database to your computer'''

1. Login to the database that you want to duplicate using phpMyAdmin
2. Click the database name on the left-hand side of the page.
3. Select the Export tab
4. Select the Save as file option
5. Click Go

You'll then be prompted to save the database file on your personal computer.

'''Importing the copy into a new database'''

You'll first need to create the new, empty database on our servers using the account control panel. After the new database has been created:

1. Login to the new database using phpMyAdmin
2. Click the database name on the left-hand side of the page
3. Select the Import tab
4. Click the Browse button under "File to import", then select the database file from your computer
5. Click Go to import the database

(Hint: If you see a "No database selected" error, it's probably because you forgot to first click on the database name in the left-hand column.)