Portal

Difference between revisions of "Developers"

From Joomla! Documentation

m
m (typo)
(111 intermediate revisions by 15 users not shown)
Line 1: Line 1:
{{RightTOC}}
+
<noinclude><languages /></noinclude>
{{Chunk:Developer profile}}
+
__TOC__
 +
{{Portal:Developers/Intro/<translate><!--T:1-->
 +
en</translate>}}
 +
{{section portal heading|icon=book|title=<translate><!--T:2-->
 +
Getting Started!</translate>}}{{Portal:Developers/Resources/<translate><!--T:3-->
 +
en</translate>}}
 +
<translate>==There are four types of extensions development:== <!--T:25--></translate>
 +
<div class="large-6 column">
 +
{{section portal heading|icon=code|title=<translate><!--T:9-->
 +
Components</translate>}}{{Portal:Component_Development/Reading_list/<translate><!--T:11-->
 +
en</translate>}}{{tip|<translate><!--T:12-->
 +
See the [[S:MyLanguage/Portal:Component_Development|Component Development Portal page]].</translate>|title=<translate><!--T:13-->
 +
For more articles and information:</translate>}}
 +
</div>
 +
<div class="large-6 column">
 +
{{section portal heading|icon=plug|title=<translate><!--T:10-->
 +
Plugins</translate>}}{{Portal:Plugin_Development/Reading_list/<translate><!--T:14-->
 +
en</translate>}}{{tip|<translate><!--T:40-->
 +
See the [[S:MyLanguage/Portal:Plugin_Development|Plugin Development Portal page]].</translate>|title=<translate><!--T:41-->
 +
For more articles and information:</translate>}}
 +
</div>
 +
<div class="large-6 column">
 +
{{section portal heading|icon=cubes|title=<translate><!--T:21-->
 +
Modules</translate>}}{{Portal:Module_Development/Reading_list/<translate><!--T:22-->
 +
en</translate>}}{{tip|<translate><!--T:23-->
 +
See the [[S:MyLanguage/Portal:Module_Development|Module Development Portal page]].</translate>|title=<translate><!--T:24-->
 +
For more articles and information:</translate>}}
 +
</div>
 +
<div class="large-6 column">
 +
{{section portal heading|icon=desktop|title=<translate><!--T:17-->
 +
Templates</translate>}}{{Portal:Template_Development/Reading_list/<translate><!--T:18-->
 +
en</translate>}}{{tip|<translate><!--T:19-->
 +
See the [[S:MyLanguage/Portal:Template_Development|Template Development Portal page]].</translate>|title=<translate><!--T:20-->
 +
For more articles and information:</translate>}}
 +
</div>
 +
{{-}}
  
A complete contents list of all pages of interest to developers can be found in the [[:Category:Development|development category]].
+
<translate>==More Development Topics== <!--T:33--></translate>
 
+
<div class="large-4 column">
== Reference Material ==
+
{{section portal heading|icon=database|title=<translate><!--T:27-->
 
+
Database</translate>}}{{Portal:Developers/Database/<translate><!--T:28-->
* [[Framework|Joomla Framework]].
+
en</translate>}}
* [http://api.joomla.org API documentation] automatically generated using phpDocumentor.
+
</div>
 
+
<div class="large-4 column">
== Articles and Tutorials ==
+
{{section portal heading|icon=language|title=<translate><!--T:29-->
 
+
Localisation</translate>}}{{Portal:Developers/Localisation/<translate><!--T:31-->
=== General ===
+
en</translate>}}
* [[Setting up your workstation for Joomla! development]].  A step-by-step guide to installing the Eclipse IDE on your local workstation for Joomla! development.
+
</div>
* [[Setting up your workstation for extension development]] A guide to Joomla Extension development
+
<div class="large-4 column">
* [http://community.joomla.org/blogs/community/828-webinar-using-eclipse-for-joomla-development.html Using Eclipse for Joomla! Development] Video webinar demonstrating overview of Eclipse features for Joomla! development
+
{{section portal heading|icon=users|title=<translate><!--T:30-->
* [[Running Automated Tests for Version 1.6]] {{JVer|1.6}}
+
ACL Topics</translate>}}{{Portal:Developers/Access Control/<translate><!--T:32-->
* [[How to debug your code]] ([[Do not use die to debug]]!)
+
en</translate>}}
* [[Joomla Beginning Developer Course]]
+
</div>
* [[Secure coding guidelines]]
+
{{-}}
* [[Development Best Practices]]
+
<div class="large-6 column">
 
+
{{section portal heading|icon=edit|title=<translate><!--T:34-->
=== Migration ===
+
Forms</translate>}}{{Portal:Developers/Forms/<translate><!--T:35-->
* [[Adapting a Joomla 1.0 extension to Joomla 1.5]]
+
en</translate>}}
* [[Adapting a Joomla 1.5 extension to Joomla 1.6]]
+
</div>
* [[Version 1.6 Developer Notes]]
+
<div class="large-6 column">
* [[Making single installation packages for Joomla! 1.5, 1.6 and 1.7]]
+
{{section portal heading|icon=lock|title=<translate><!--T:36-->
 
+
Security</translate>}}{{Portal:Developers/Security/<translate><!--T:37-->
=== Components ===
+
en</translate>}}{{tip|<translate><!--T:42-->
{{RecReading|Component|dev|topic}}
+
See the [[S:MyLanguage/Security|Security Portal page]].</translate>|title=<translate><!--T:43-->
=== Modules ===
+
For more articles and information:</translate>}}
{{RecReading|Module|dev|topic}}
+
</div>
=== Plugins ===
+
{{-}}
{{RecReading|Plugin|dev|topic}}
+
{{section portal heading|icon=user-plus|title=<translate><!--T:38-->
=== Templates ===
+
Contributing to Documentation</translate>}}
{{RecReading|Template|dev|topic}}
+
{{Portal:Developers/Developer_Documentation/<translate><!--T:44-->
===Parameters===
+
en</translate>}}
* [[Standard parameter types]]
 
* [[Custom parameter types]]
 
* [[Component parameters]]
 
* [[Creating custom template parameter types]]
 
See also: [[:Category:Parameters]]
 
 
 
=== Core extensions summary ===
 
* [[Banner component]] {{JVer|1.6}}
 
 
 
=== Security ===
 
* [[How to add CSRF anti-spoofing to forms]]
 
* [http://developer.joomla.org/tutorials/181-preventing-sql-injections.html Preventing SQL Injections]
 
* [[Securing Joomla extensions]]
 
 
 
=== Database ===
 
* [[How to use the database classes in your script]]
 
* [[How to use the JTable class]]
 
* [[How to connect to an external database]]
 
 
 
=== Localisation ===
 
* [http://community.joomla.org/magazine/article/508-developer-localization-advancements-in-joomla-15.html Localization Advancements in Joomla! 1.5]
 
* [[Adding multi-language support]]
 
* [[Language Guidelines for 3rd Party Extensions]]
 
* [[Adding Joomfish functionality to custom components]]
 
* [[Specification of language files]] {{JVer|1.6}}
 
* [[Language Metadata]] {{JVer|1.6}}
 
 
 
=== Access Control ===
 
* [[Access Control System In Joomla 1.6]] {{JVer|1.6}}
 
 
 
=== Miscellaneous ===
 
* [[How to use the filesystem package]]
 
* [[API Execution Order]]
 
* [[Accessing the current user object]]
 
* [[Adding JavaScript and CSS to the page]]
 
* [[Constants]] used in the Joomla [[Framework]].
 
* [[Client-side form validation]]
 
* [[How to create a custom button]]
 
* [[How to create a stand-alone application using the Joomla! Framework]]
 
* [[How to use user state variables]]
 
* [[Adding template overridable images in your extension]]
 
* [[Retrieving data from GET and POST requests]]
 
* [[Cache]] and [[Using caching to speed up your code]]
 
* [[Using the installer API to support package installation]]
 
* [[How to add tooltips to your Joomla! website]]
 
* [[Display error messages and notices]].
 
* [[Errors]]
 
* [[Creating a custom form field type]] {{JVer|1.6}}
 
 
 
== Contributing to Joomla Development ==
 
The development of Joomla itself is carried out by the [[Development Working Group]] and third party developers.
 
 
 
* [[Participating in the community]]: a brief description of how people can get involved.
 
* [[Developer Email lists]]: a list of email lists for developers, including third party developers.
 
* [[Coding style and standards]] (To be reviewed).
 
* [[Setting up your workstation for Joomla! development]].  A step-by-step guide to installing the Eclipse IDE on your local workstation for Joomla! development.
 
* [http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development_--_Part_2#Check_Out_Joomla.21_Source_Code How to check out SVN Code]
 
* [[Patch submission guidelines]].
 
* [[Filing bugs and issues]].
 
* [[How to release a distribution tarball]].
 
* [[How to create a continuous integration]].
 
 
 
== Contributing to Joomla Developer Documentation ==
 
The development of Joomla developer documentation is carried out primarily by the [[Documentation Working Group]]. There are currently two sub-projects of interest to developers:
 
* [[Joomla! 1.5 Template Tutorials Project]]
 
* [[API Reference Project]]
 
 
 
When creating a new page, ensure you place the following marker at the bottom of the page so it is included in the category list:
 
 
 
<pre><nowiki>[[Category:Development]]
 
</nowiki></pre>
 
 
 
If you locate other articles you think are relevant to developers, please add this marker to those pages.
 
 
 
=== Suggested topics ===
 
This is a short list of articles that might be written to support developers.  Please feel free to add further topic ideas.
 
 
 
* [[Adding configuration objects to modules and plugins]].
 
* [[Storing data in the session between page loads]].
 
* [[Suppressing output of extra HTML]].
 
* [[How to use the filter package]].
 
*: Describe how and when to use the Filter package and explain what needs to be filtered for various situations (for queries, for URLs, etc)
 
* [[How to use the registry package]]
 
* [[How to use JSimpleXML]].
 
*: How to load and store XML files and how to work with them
 
* [[How to create component feeds]] (RSS/ATOM)
 
* [[How to create PDF views]]
 
* [[How to generate paths for client side and server side]]
 
* [[How to access information from the request]]
 
*: This focuses on using the JBrowser class to retrieve information about the features available in the user's browser.
 
* [[How to create an editor plugin]]
 
* [[What can be done with a user plugin]]
 
* [[How to work with parameters]]
 
* [[How to cloak email addresses]]
 
* [[Using the caching system in your component]]. This might be enough (for now?) -> [[Cache]]
 
* [[Extending Joomla's MVC Architecture]]
 
 
 
==Joomla Security Guide==
 
Developers should also be aware of security issues.
 
{{Security Guide}}
 
  
 +
__NOTOC__
 +
<noinclude>
 +
<translate>
 +
<!--T:39-->
 
[[Category:Development]]
 
[[Category:Development]]
 
[[Category:JED]]
 
[[Category:JED]]
 
[[Category:Joomla! user profiles]]
 
[[Category:Joomla! user profiles]]
 +
</translate>
 +
</noinclude>

Revision as of 08:36, 30 May 2015

Other languages:
Bahasa Indonesia • ‎Deutsch • ‎English • ‎Nederlands • ‎Türkçe • ‎eesti • ‎español • ‎français • ‎italiano • ‎português • ‎português do Brasil • ‎русский • ‎українська • ‎فارسی • ‎বাংলা • ‎ไทย • ‎中文(中国大陆)‎ • ‎中文(台灣)‎

The development of Joomla! itself is carried out by the Production Department and third party developers. This page is a starting point for developers interested in the development of components, modules, plugins and templates.

Have an Interest in Core Contributions?

The development of Joomla itself is carried out by Production Department and third party developers. For more information about Joomla! core development, how to contribute to code to core, or becoming more involved with the core code, you should go to Joomla! Code Contributors.


Getting Started!

There are several ways of setting up your workstation in for Joomla! development. Some suggestions can be found at Setting up your workstation for Joomla development.

Next, you should familiarise yourself with Joomla! Secure coding guidelines and the short article on Joomla! Development Best Practices.

Documentation on the Joomla! API can assist with becoming familiar with the foundations of the Joomla! code base.

Finally, Joomla! has many resources for developers. Our Joomla! Resources page will get you pointed in the right direction if you need help and solutions.


There are four types of extensions development:[edit]

Components

There are many articles, tutorials, references and FAQs which focus on component development. If this is your first time developing a component for Joomla, you should start with the Absolute Basics of How a Component Functions. If needed, you can visualise the control flow of a component with these diagrams.

Next, you will want to read our  Joomla 3.x MVC tutorial    Developing a Model-View-Controller Component. Remember to familiarise yourself with Joomla! Secure coding guidelines and Development Best Practices.

Once you have read the tutorial and/or tried the example component, you can focus more on the specifics of your component with additional articles. These are listed on the Component Development Portal or any of the supporting Portals for Development(Plugins, Modules or Templates).

For more articles and information:

See the Component Development Portal page.

Plugins

The following articles will help familiarise you with Joomla! plugins. They are a good starting point to understanding and then developing plugins.

Beginner[edit]

To understand how to install and use a plugin in Joomla it is recommended to read Administration of a Plugin in Joomla!

Intermediate[edit]

To understand plugins better it is advised that you create a basic plugin for Joomla!.

To read on how to run a basic content plugin in a custom module or component you may have already developed it is recommended to read Triggering content plugins in your extension.

Advanced[edit]

To understand the principles on which the Plugin system works Plugin Developer Overview. To then implement this in a component you have designed it is recommended to read Supporting plugins in your component.

For more articles and information:

See the Plugin Development Portal page.

Modules


For more articles and information:

See the Module Development Portal page.

More Development Topics[edit]

Contributing to Documentation


The development of Joomla developer documentation is carried out primarily by the Documentation Working Group. There is currently one sub-projects of interest to developers:

When creating a new page, ensure you place the following marker at the bottom of the page so it is included in the category list:

[[Category:Development]]

If you locate other articles you think are relevant to developers, please add this marker to those pages.