View source for Display error messages and notices

{{RightTOC}}
Errors, warnings and notices can be displayed from any component, module, plugin or template using the methods outlined below.
<source lang="php">
// Get a handle to the Joomla! application object
$application = JFactory::getApplication();

// Add a message to the message queue
$application->enqueueMessage(JText::_('SOME_ERROR_OCCURRED'), 'error');

/** Alternatively you may use chaining */
JFactory::getApplication()->enqueueMessage(JText::_('SOME_ERROR_OCCURRED'), 'error');
</source>

The second argument to the [[JApplication/enqueueMessage|enqueueMessage]] function is the type of the message. The default is 'message', but 'error' results in a different style for the message.  The message will be displayed in place of a special <tt>jdoc:include</tt> statement in your template.  Place the following in your template at the location where you want messages to appear.
<source lang="php">
<jdoc:include type="message" />
</source>

== Message ==
<div style="background-color: #c3d2e5; color: #0055bb; border-top: 3px solid #84a7db; border-bottom: 3px solid #84a7db; padding-left: 1em; font-weight: bold;">
Message
</div>
<source lang="php">
JFactory::getApplication()->enqueueMessage('Message');
</source>

== Notice ==

<div style="background-color: #efe7b8; color: #c00; border-top: 3px solid #f0dc7e; border-bottom: 3px solid #f0dc7e; padding-left: 1em; font-weight: bold;">
Notice
</div>
<source lang="php">
JError::raiseNotice( 100, 'Notice' );
</source>

== Warning ==

<div style="background-color: #e6c0c0; color: #c00; border-top: 3px solid #DE7A7B; border-bottom: 3px solid #DE7A7B; padding-left: 1em; font-weight: bold;">
Warning
</div>
<source lang="php">
JError::raiseWarning( 100, 'Warning' );
</source>

== Error ==
<source lang="php">
JError::raiseError( 4711, 'A severe error occurred' );
</source>

== Joomla! 3.x is bootstraped ==
Since Joomla! {{JVer|3.0}} will use bootstraped templates, the messages will use the standard boostrap CSS styles for Alerts.

See: http://twitter.github.com/bootstrap/components.html#alerts

The general syntax remains:

<source lang="php">
JFactory::getApplication()->enqueueMessage('Your Message', 'type');
</source>

Where '''type''' can be one of

* EMPTY - yellow
* 'info' - blue
* 'error' - red
* 'success' - green

=== Success ===
Note the new style in Joomla! 3 using the type '''success''' which is now used instead of the former "Message".

<div style="background-color: #dff0d8; color: #468847; border-top: 3px solid #468847; border-bottom: 3px solid #468847; padding-left: 1em; font-weight: bold;">
Success
</div>

<source lang="php">
JFactory::getApplication()->enqueueMessage('Success');
</source>

== See also ==
* [[JError]]
* [[JApplication]]
*  [http://api.joomla.org/1.5/Joomla-Framework/Application/JApplication.html JApplication on api.joomla.org]

<noinclude>[[Category:Development]]</noinclude>
[[Category:Tutorials]][[Category:Component Development]]