Joomla! Documentation - User contributions [en]

Accessing the database using JDatabase

2009-04-24T21:44:22Z

Rfriedel: /* Why should I use the Joomla database class? */

How to find your absolute path

2009-01-15T08:29:20Z

Rfriedel:

== Using Joomla Find Your Absolute Path ==

=== What is the absolute path? ===
The absolute path is the directory location on a server's hard drive where Joomla! is located.

=== Joomla! 1.0.x ===
In Joomla! v.1.0.x the configuration.php file would be something like the following, however, it can vary depending on your server.

<code>$mosConfig_absolute_path = '/home/joomla/public_html';</code>

==== Usage ====
To find out what your absolute path is<ref>[http://www.joomlatutorials.com/faq/view/joomla_beginner/what_is_my_absolute_path?/60.html Finding your absolute path in Joomla! 1.0.x] Joomlatutorials</ref>, copy the following code into a text editor (i.e. Notepad, TextEdit etc), save the file as a .php naming it whatever you want (i.e anyfilename.php.).

Using your FTP software, ftp the file you have just created to your root folder. Open a web browser and type in http://www.yourdomain.com/filename.php.

<?php
$path = getcwd();
echo "Your Absoluthe Path is: ";
echo $path;
?>

'''''IMPORTANT: For security reasons, delete this file as soon as you have ascertained the information you require.'''''

----

=== Joomla! 1.5.x ===
In Joomla! v.1.5.x the absolute path is set in the index.php (<small>line 17</small>) file in the base directory to the constant [[JPATH_BASE]].

<code>define('JPATH_BASE', dirname(__FILE__) );</code>

==== Usage ====
Use the constant [[JPATH_BASE]]. This constant returns the absolute path to your Joomla! installation directory.

<?php
echo JPATH_BASE;
?>

=== See Also ===
[http://forum.joomla.org/viewtopic.php?t=1035 Absolute Path for Joomla! 1.0.x]

=== References ===
<references/>

[[Category:Tips and tricks]]
[[Category:Tips and tricks 1.0]]
[[Category:Tips and tricks 1.5]]

Adding JavaScript

2009-01-15T06:46:37Z

Rfriedel: /* Adding Javascript Files Using JHTML */

{{cookiejar}}
===Adding JavaScript===
----
This chunk should describe in detail how to add JavaScript to the head of
a template using the Joomla! 1.5 API calls. It should be aimed at
people who have only minimal knowledge of PHP, HTML and JavaScript.
----
[[Category:Templates]]
[[Category:Modules]]
[[Category:Components]]
[[Category:Plugins]]

Add the following code to have the javascript library /media/system/js/sample.js included in your template.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

==Explanation==

Ultimately you are trying to have the resulting HTML page have in the <head> ... </head> area have a javascript include:

For Example:
<script type="text/javascript" src="/media/system/js/sample.js"></script>

Ensure that the javascript you want to include is in the directory, from the above example:
/media/system/js/sample.js

When you are able to load both your page and see the <script> tag in the <head> area, and be able to load the javascript from the address

Again, using the example:
<nowiki>http://www.example.com/media/system/js/sample.js</nowiki>

Then the script is integrated into your page, and you can proceed to using javascript in your HTML.

Do not directly add the <script> to your template's index.php.

The code will insert the the <script> line where your index.php has the following line:

<jdoc:include type="head" />

Add this PHP code to your page, in the head, or next to the javascript code you will use, depending on your preference.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

Reload your template and view the page, and ensure that the sample.js is included in the <head>

== Adding Javascript Files Using JHTML ==

You may also use the [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html JHTML] [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html#script script] method to add a javascript file to the head of your document.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename);
?>

There is a second parameter that can be passed to the script method. The parameter is a boolean (true/false). You would set this to true if you wanted MooTools loaded as well.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename, true); // MooTools will load if it is not already loaded
?>

'''Please Note: Joomla 1.6+ may or may not handle MooTools differently than in previous versions.'''<ref>[http://forum.joomla.org/viewtopic.php?f=502&t=273960 Whitepaper] Upgrade to mootools 1.2</ref>

== References ==
<references/>

Adding JavaScript

2009-01-15T06:46:10Z

Rfriedel:

{{cookiejar}}
===Adding JavaScript===
----
This chunk should describe in detail how to add JavaScript to the head of
a template using the Joomla! 1.5 API calls. It should be aimed at
people who have only minimal knowledge of PHP, HTML and JavaScript.
----
[[Category:Templates]]
[[Category:Modules]]
[[Category:Components]]
[[Category:Plugins]]

Add the following code to have the javascript library /media/system/js/sample.js included in your template.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

==Explanation==

Ultimately you are trying to have the resulting HTML page have in the <head> ... </head> area have a javascript include:

For Example:
<script type="text/javascript" src="/media/system/js/sample.js"></script>

Ensure that the javascript you want to include is in the directory, from the above example:
/media/system/js/sample.js

When you are able to load both your page and see the <script> tag in the <head> area, and be able to load the javascript from the address

Again, using the example:
<nowiki>http://www.example.com/media/system/js/sample.js</nowiki>

Then the script is integrated into your page, and you can proceed to using javascript in your HTML.

Do not directly add the <script> to your template's index.php.

The code will insert the the <script> line where your index.php has the following line:

<jdoc:include type="head" />

Add this PHP code to your page, in the head, or next to the javascript code you will use, depending on your preference.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

Reload your template and view the page, and ensure that the sample.js is included in the <head>

== Adding Javascript Files Using JHTML ==

You may also use the [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html JHTML] [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html#script script] method to add a javascript file to the head of your document.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename);
?>

There is a second parameter that can be passed to the script method. The parameter is a boolean (true/false). You would set this to true if you wanted MooTools loaded as well.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename, true); // MooTools will load if it is not already loaded
?>

''''Please Note: Joomla 1.6+ may or may not handle MooTools differently than in previous versions.''''<ref>[http://forum.joomla.org/viewtopic.php?f=502&t=273960 Whitepaper] Upgrade to mootools 1.2</ref>

== References ==
<references/>

Adding JavaScript

2009-01-15T06:44:51Z

Rfriedel:

{{cookiejar}}
===Adding JavaScript===
----
This chunk should describe in detail how to add JavaScript to the head of
a template using the Joomla! 1.5 API calls. It should be aimed at
people who have only minimal knowledge of PHP, HTML and JavaScript.
----
[[Category:Templates]]
[[Category:Modules]]
[[Category:Components]]
[[Category:Plugins]]

Add the following code to have the javascript library /media/system/js/sample.js included in your template.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

==Explanation==

Ultimately you are trying to have the resulting HTML page have in the <head> ... </head> area have a javascript include:

For Example:
<script type="text/javascript" src="/media/system/js/sample.js"></script>

Ensure that the javascript you want to include is in the directory, from the above example:
/media/system/js/sample.js

When you are able to load both your page and see the <script> tag in the <head> area, and be able to load the javascript from the address

Again, using the example:
<nowiki>http://www.example.com/media/system/js/sample.js</nowiki>

Then the script is integrated into your page, and you can proceed to using javascript in your HTML.

Do not directly add the <script> to your template's index.php.

The code will insert the the <script> line where your index.php has the following line:

<jdoc:include type="head" />

Add this PHP code to your page, in the head, or next to the javascript code you will use, depending on your preference.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

Reload your template and view the page, and ensure that the sample.js is included in the <head>

== Adding Javascript Files Using JHTML ==

You may also use the [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html JHTML] [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html#script script] method to add a javascript file to the head of your document.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename);
?>

There is a second parameter that can be passed to the script method. The parameter is a boolean (true/false). You would set this to true if you wanted MooTools loaded as well.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename, true); // MooTools will load if it is not already loaded
?>

'''Please Note: Joomla 1.6+ may or may not handle MooTools differently than in previous versions.'''<ref name="MooToolsUpdate">[http://forum.joomla.org/viewtopic.php?f=502&t=273960 Whitepaper] Upgrade to mootools 1.2 whitepaper

== References ==
<references/>

Adding JavaScript

2009-01-15T06:33:06Z

Rfriedel: /* Adding Javascript Files Using JHTML */

{{cookiejar}}
===Adding JavaScript===
----
This chunk should describe in detail how to add JavaScript to the head of
a template using the Joomla! 1.5 API calls. It should be aimed at
people who have only minimal knowledge of PHP, HTML and JavaScript.
----
[[Category:Templates]]

Add the following code to have the javascript library /media/system/js/sample.js included in your template.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

===Explanation===

----

Ultimately you are trying to have the resulting HTML page have in the <head> ... </head> area have a javascript include:

For Example:
<script type="text/javascript" src="/media/system/js/sample.js"></script>

Ensure that the javascript you want to include is in the directory, from the above example:
/media/system/js/sample.js

When you are able to load both your page and see the <script> tag in the <head> area, and be able to load the javascript from the address

Again, using the example:
<nowiki>http://www.example.com/media/system/js/sample.js</nowiki>

Then the script is integrated into your page, and you can proceed to using javascript in your HTML.

Do not directly add the <script> to your template's index.php.

The code will insert the the <script> line where your index.php has the following line:

<jdoc:include type="head" />

Add this PHP code to your page, in the head, or next to the javascript code you will use, depending on your preference.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

Reload your template and view the page, and ensure that the sample.js is included in the <head>

== Adding Javascript Files Using JHTML ==

You may also use the [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html JHTML] [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html#script script] method to add a javascript file to the head of your document.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename);
?>

There is a second parameter that can be passed to the script method. The parameter is a boolean (true/false). You would set this to true if you wanted MooTools loaded as well.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename, true); // MooTools will load if it is not already loaded
?>

'''Please Note: Joomla 1.6+ may or may not handle MooTools differently than in previous versions.'''<ref name="Whitepaper">[http://forum.joomla.org/viewtopic.php?f=502&t=273960 Whitepaper] Upgrade to mootools 1.2

Adding JavaScript

2009-01-15T05:55:08Z

Rfriedel: Added the JHTML method of loading a js file

{{cookiejar}}
===Adding JavaScript===
----
This chunk should describe in detail how to add JavaScript to the head of
a template using the Joomla! 1.5 API calls. It should be aimed at
people who have only minimal knowledge of PHP, HTML and JavaScript.
----
[[Category:Templates]]

Add the following code to have the javascript library /media/system/js/sample.js included in your template.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

===Explanation===

----

Ultimately you are trying to have the resulting HTML page have in the <head> ... </head> area have a javascript include:

For Example:
<script type="text/javascript" src="/media/system/js/sample.js"></script>

Ensure that the javascript you want to include is in the directory, from the above example:
/media/system/js/sample.js

When you are able to load both your page and see the <script> tag in the <head> area, and be able to load the javascript from the address

Again, using the example:
<nowiki>http://www.example.com/media/system/js/sample.js</nowiki>

Then the script is integrated into your page, and you can proceed to using javascript in your HTML.

Do not directly add the <script> to your template's index.php.

The code will insert the the <script> line where your index.php has the following line:

<jdoc:include type="head" />

Add this PHP code to your page, in the head, or next to the javascript code you will use, depending on your preference.

<?php
$document = &JFactory::getDocument();
$document->addScript( '/media/system/js/sample.js' );
?>

Reload your template and view the page, and ensure that the sample.js is included in the <head>

== Adding Javascript Files Using JHTML ==

You may also use the [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html JHTML] [http://api.joomla.org/Joomla-Framework/HTML/JHTML.html#script script] method to add a javascript file to the head of your document.

<?php
$filename = 'path/to/file/filename.js';
JHTML::script($filename);
?>

Cannot save Global Configuration changes

2008-09-04T14:18:56Z

Rfriedel: Added category FAQ

[[Category:FAQ]]

{{cookiejar}}
{{stub}}
This problem is usually caused by incorrect ownership or permissions on the ''configuration.php'' file which is where the Global Configuration settings are stored. On some Joomla! installations the ''configuration.php'' file is set to read-only as an additional security measure.

Talk:Cannot save Global Configuration changes

2008-09-04T14:17:43Z

Rfriedel: New page: Should this be in the FAQ page?

Should this be in the FAQ page?

Talk:JUser example

2008-09-04T13:14:18Z

Rfriedel: Talk:JUser example moved to Talk:JUser: Should be a subheader under JUser

#REDIRECT [[Talk:JUser]]

Talk:JUser

2008-09-04T13:14:18Z

Rfriedel: Talk:JUser example moved to Talk:JUser: Should be a subheader under JUser

Good start, but this needs to be expanded and improved. I suggest the following:
# Don't use acronyms like "DB" for "database" and so on.
# Code should follow [http://docs.joomla.org/Coding_style_and_standards Coding Standards] as it needs to set a good example.
# Don't introduce functions that are not part of the Joomla! Framework or Joomla! CMS (MRender in this case).
# Do try to explain clearly what the code does (and what problem it solves) without assuming that the reader has extensive understanding of Joomla! itself.
# Do try to use descriptive variable names (eg. maybe "$user" instead of "$NU").
# Do try to include any jimport statements if these are required.
[[User:Chris Davenport|Chris Davenport]] 15:45, 7 April 2008 (EDT)

What's available in the JFactory class

2008-09-04T12:56:52Z

Rfriedel: What's available in the JFactory class moved to JFactory Class: The page as it was should be a subheader under the JFactory page. Renamed it to 'JFactory Class' because I couldn't name it to 'JFactory'

#REDIRECT [[JFactory Class]]