Joomla! Documentation - User contributions [en]

Working with git and github

2011-05-20T01:27:04Z

Dukeofgaming:

This document will provide a brief overview of working with the Joomla Platform repository on github.com for people who are interested in making code contributions and using eclipse as an IDE. Much will also apply for people who just want to follow development, but that is much simpler.

Some preliminary information.

== What is Git? ==

Git is distributed version control software. Such software (another example is Mercurial while subversion and CVS are non distributed version control systems) allow many people to contribute code to a single project and also allow for well defined tracking of code changes and provide mechanisms for recording commit by commit records of changes.

== What is Github? ==

Github is a host for git repositories. It is located at [https://github.com github.com]

== What is the Joomla! Platform? ==

The Joomla! Platform also known as the Joomla! Framework is the set of libraries that are used to build the Joomla! CMS and other applications.

The platform is managed separately from the CMS and has its own release cycle; each release of the CMS uses one specific version of the platform.

The platform repository is located at: [https://github.com/joomla/joomla-platform github.com/joomla/joomla-platform]

== First steps: Github account ==

First, you will need to register at git hub.

Once registered, you will probably want to go to [https://github.com/joomla/joomla-platform github.com/joomla/joomla-platform ] and click follow. Then whenever you log in you will see the latest things that have happened in the repository.

If you are going to code, you will also want to click on fork. This will give you your own copy of the platform to work with. You'll probably want to follow that too.

== Second steps: Install git ==

Now you will want to install git on your local workstation. Github provides excellent instructions on how to do this that will detect your operating system. Simply click on the Set Up Git button.

You will need to set up SSH. As it says on the Github instructions " Setting them up is fairly easy, but does involve a number of steps." Some will be specific to your operating system, so follow the instructions at github.

You will also need to tell Git your user name and password so that it can connect to your repositories on github.

== Third steps ==

=== Command Line ===
If you like using the command line, git by itself provides commands to create a local copy of your fork at github. There are a number of tutorials and reference sites for git including:
* [http://git-scm.com/documentation git-scm.com/documentation]
* [http://gitimmersion.com/ gitimmersion]

Github itself has many documents about how to use git on its help site
*[http://help.github.com/ help.github.com/]

=== Eclipse ===

Git can also be used with Eclipse, a popular integrated development environment (IDE).

Setting up Eclipse to work with git and github involves a number of steps.

Important references are:
[http://wiki.eclipse.org/EGit/User_Guide wiki.eclipse.org/EGit/User_Guide]
and
[http://wiki.eclipse.org/EGit/GitHub/UserGuide wiki.eclipse.org/EGit/GitHub/UserGuide]

First, you will need to install eGit and Mylyn. Mylyn is probably not really necessary but it will let you access other features of github. Note that Mylyn has dependencies and you will need to install them first (see the user's guide).

To install eGit from eclipse, go to Help>Eclipse Marketplace. Search for git and click install.

Follow the instructions to fill in your github account information to identify yourself, defaults and other settings.

Once installed, if you click File>Import you should see Git listed as an option and projects from Git as a sub option.

Note the following owes a lot to a number of sites including [http://blog.opsb.co.uk/getting-started-with-git-github-and-eclipse-p http://blog.opsb.co.uk/getting-started-with-git-github-and-eclipse-p].

One important thing to note before starting is that we will be working with the fork you made in Step 1 (If you didn't make a fork then, do it now). Thus we will not be making a new repository. When reading help materials make sure not to follow instructions to create a new remote repository.

Your fork on github will have a set of three links (ssh, http, git read-only) . You will need the http link.

Click File>Import.
Choose Projects from Git, click next.
On the next screen, click Clone and add your http link. The other fields except your password will autofill. (If you haven't st up your username previously you will need this too).

Click Next, select master (that is all you will have if this is your first time).
Set a directory.
Click finish and the files from git will be cloned which means they will be downloaded to your folder.

Next Eclipse will want to create a project. Do not do it!! Instead, in a way that works for your operating system create a hidden file called .project.

In the file put:
<syntaxhighlight lang="xml">
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>joomla-platform</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
<buildCommand>
<name>org.eclipse.wst.validation.validationbuilder</name>
<arguments>
</arguments>
</buildCommand>
</buildSpec>
<natures>
<nature>org.eclipse.php.core.PHPNature</nature>
</natures>
</projectDescription>
</syntaxhighlight>

But change test to the name of your folder.

Now your folder should appear on the list of projects. Select it and finish.

You should now have a git local repository.

== Getting to Work ==

Once you have your repository you are ready to start working on code.
Whenever you have some code that you are happy with, you should commit it locally. Note that unless you commit, your local changes will not enter into version control.
To commit, you click Team>commit.

To be continued ...

== Reference ==

* [http://progit.org/book/ Pro Git]
* [http://www.ndpsoftware.com/git-cheatsheet.html Git Cheatsheet]

Changing the site favicon

2010-04-18T03:35:52Z

Dukeofgaming:

# '''Create a 16x16 pixel image.''' You may use graphic software such as [[wikipedia:Photoshop|Photoshop]], [[wikipedia:Gimp|Gimp]] or [[wikipedia:Windows_Paint|Windows Paint]] or an online tool such as http://antifavicon.com/
# '''Convert to ico format''' using free online sites such as:
#* http://converticon.com/
#* http://www.favicongenerator.com/
#* http://www.htmlkit.com/services/favicon/
#* http://tools.dynamicdrive.com/favicon/
#* http://www.favicon.cc/
# The file you created in this way will have the extension .ico. '''Copy the file''' to the /joomla/templates/<your template> directory and '''name it''' favicon.ico.
# Open a browser. Do you see your new icon? If so, congratulations. If not, that doesn't necessarily mean you did anything wrong. Browsers are designed to minimize data traffic, so they don't refresh the favicon every time they show a page. Even refreshing the page (F5) wont help. So you need to refresh more thoroughly:
#* ''Mozilla / Firefox / Safari'': hold down Shift while clicking Reload, or press Ctrl-Shift-R (Cmd-Shift-R on Apple Mac);
#* ''IE'': hold Ctrl while clicking Refresh, or press Ctrl-F5;
#* ''Konqueror'': simply click the Reload button, or press F5;
#* ''Opera'' users may need to completely clear their cache in Tools→Preferences.
#* ''Chrome'': Shift-F5
If this doesn't work you will need to delete the temporary internet files and the history and then open your page again.

Some templates contain code that redirects the browser to another directory or another icon file. To determine where your new favicon should be, examine http://yoursite.com/templates/your_template/index.php and look for code that contains the text <link rel="shortcut icon". There you will find the directory and the name of the icon file. Copy your icon to that place and give it the the name that link is pointing to (you might want to backup the old file). Make sure you set the security correctly such that you webserver has access to that file. Look at the example below. <source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/favicon.ico" /></source>

If you don't want to just change the '''favicon.ico''' file in its respective template directory you can find the reference to the '''favicon.ico''' file in the '''html.php''' document. The path is '''"........\libraries\joomla\document\html\html.php"'''. This should prevent the icon from toggling if you use
<source lang="html4strict"><link rel="shortcut icon" href="http://yoursite.com/templates/your_template/icon/youricon.ico" /></source>
in the template html and you don't remove the favicon.ico file. (why call the icon twice?)

From the html.php
<source lang="php">
// Try to find a favicon by checking the template and root folder
$path = $directory . DS;
$dirs = array( $path, JPATH_BASE . DS );
foreach ($dirs as $dir )
{
$icon = $dir . 'favicon.ico';
if (file_exists( $icon ))
{
$path = str_replace( JPATH_BASE . DS, '', $dir );
$path = str_replace( '\\', '/', $path );
$this->addFavicon( JURI::base(true).'/'.$path . 'favicon.ico' );
break;''

</source>
<noinclude>[[Category:Templates]]</noinclude>

Archived:Database schema standards

2009-11-04T00:31:44Z

Dukeofgaming: /* Table Naming Conventions */

== Table Naming Conventions ==

* Table names should always go in plural form, e.g.: users, sessions, usergroups, etc.
* Cross referencing table names should always reflect multiplicity, e.g.: 1 to N: user_sessions, M to N: users_usergroups

== Field Naming Conventions ==

== Field Type Recommendations ==