Actions

Difference between revisions of "Setting up your workstation for Joomla! development"

From Joomla! Documentation

(Working With Patches - documentation has been created elsewhere, removed old process and linked to new)
m (merge, two article same name only missing ! in Joomla!)
 
(6 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{RightTOC}}
+
{{merge|Setting up your workstation for Joomla development|date=15 Sep 2013}}
 +
This article provides detailed instructions for setting up your workstation for Joomla! development with Apache, PHP, xdebug, Git. Please refer to the following links for other development tools and environments: [[Setting up your workstation for Joomla development]]
  
== Introduction ==
+
The article more specifically let's you contribute to the official Joomla! Github code repository.
This article provides detailed instructions for setting up your workstation for Joomla! development with Apache, PHP, xdebug, Subversion. Please refer to the following links for other development tools and environments: [[Setting up your workstation for joomla development]]
+
 
+
The article more specifically let's you contribute to the official SVN Joomla! code.
+
 
+
The examples used and screenshots are for Windows XP, but the basic steps are the same for Linux.
+
  
 
== Install & configure XAMPP, php, Eclipse ==
 
== Install & configure XAMPP, php, Eclipse ==
Line 12: Line 8:
 
# [[Edit PHP.INI File for XDebug]]
 
# [[Edit PHP.INI File for XDebug]]
 
# [[Configuring Eclipse for joomla development]]
 
# [[Configuring Eclipse for joomla development]]
# [[Git for Testers and Trackers]]
 
# [[Working with git and github/My first pull request]]
 
  
 
== Check Out and modify Joomla! Source Code ==
 
== Check Out and modify Joomla! Source Code ==
Line 20: Line 14:
 
To do so, please see [[Working with git and github/My first pull request]]
 
To do so, please see [[Working with git and github/My first pull request]]
  
== Working With Patches ==
+
== Working With Git and Github ==
 
+
The CMS project uses the Git version control system and the CMS repository is stored on Github here: [https://github.com/joomla/joomla-cms https://github.com/joomla/joomla-cms]. Bugs are fixed in the master branch of this repository, and normally there are bug fixes and changes in the master branch that are more recent than the latest released Joomla version. For this reason, when we test and code bug fixes, we normally use the latest code from the master branch on Github, not the latest released version. Therefore, Bug Squad testers and coders need to understand how to use Git and the Github repository.
For testing and tracking changes, please refer to [[http://docs.joomla.org/Git_for_Testers_and_Trackers]]
+
 
+
==Troubleshooting==
+
=== Error When Doing Team->Commit===
+
: When doing a commit, you get the message "svn: Server sent unexpected return value (501 Method Not Implemented)". This error can be caused by doing an anonymous checkout on a project that requires credentials to commit. The anonymous credentials are cached and so the commit is not authorized. To fix this, you need to clear the SVN cache. This can be done by removing the cache file. For XP, the file is <code>c:\Documents and Settings\[username]\Application Data\subversion\auth\svn.simple</code>. For Vista, it is <code>c:\Users\[username]\AppData\Roaming\subversion\auth\svn.simple</code>.  
+
  
:If you use Tortoise, you can right-click and select SVN->Settings->Saved Data and press the Clear button next to Authentication Data.
+
For testing and tracking changes, please refer to [[Git for Testers and Trackers]]. For coding changes, please see [[Git for Coders]].
  
 
==Extension Development==
 
==Extension Development==

Latest revision as of 00:34, 15 September 2013

Merge-icon.png
Merge Notice

It has been suggested that this article or section be merged with Setting up your workstation for Joomla development. (Discuss). Proposed since 15 Sep 2013.

This article provides detailed instructions for setting up your workstation for Joomla! development with Apache, PHP, xdebug, Git. Please refer to the following links for other development tools and environments: Setting up your workstation for Joomla development

The article more specifically let's you contribute to the official Joomla! Github code repository.

Contents

Install & configure XAMPP, php, Eclipse

  1. Configuring a XAMPP server for joomla development
  2. Edit PHP.INI File for XDebug
  3. Configuring Eclipse for joomla development

Check Out and modify Joomla! Source Code

Now we are going to create a new PHP project that will contain all of the source code files for Joomla!. We can import the source code and create our PHP project at the same time.

To do so, please see Working with git and github/My first pull request

Working With Git and Github

The CMS project uses the Git version control system and the CMS repository is stored on Github here: https://github.com/joomla/joomla-cms. Bugs are fixed in the master branch of this repository, and normally there are bug fixes and changes in the master branch that are more recent than the latest released Joomla version. For this reason, when we test and code bug fixes, we normally use the latest code from the master branch on Github, not the latest released version. Therefore, Bug Squad testers and coders need to understand how to use Git and the Github repository.

For testing and tracking changes, please refer to Git for Testers and Trackers. For coding changes, please see Git for Coders.

Extension Development

For Eclipse setup information related to Joomla! extension development, see Setting up your workstation for extension development.