Difference between revisions of "Display error messages and notices"
From Joomla! Documentation
(Add "Success") |
m (→Joomla! 3.x is bootstraped: fixing link to bootstrap for alerts) |
||
(7 intermediate revisions by 4 users not shown) | |||
Line 6: | Line 6: | ||
// Add a message to the message queue | // Add a message to the message queue | ||
− | $application->enqueueMessage(JText::_(' | + | $application->enqueueMessage(JText::_('SOME_ERROR_OCCURRED'), 'error'); |
/** Alternatively you may use chaining */ | /** Alternatively you may use chaining */ | ||
− | JFactory::getApplication()->enqueueMessage(JText::_(' | + | JFactory::getApplication()->enqueueMessage(JText::_('SOME_ERROR_OCCURRED'), 'error'); |
</source> | </source> | ||
− | The second argument to the [ | + | The second argument to the [http://api.joomla.org/11.4/Joomla-Platform/Application/JApplication.html#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"> | <source lang="php"> | ||
<jdoc:include type="message" /> | <jdoc:include type="message" /> | ||
Line 49: | Line 49: | ||
== Joomla! 3.x is bootstraped == | == Joomla! 3.x is bootstraped == | ||
− | Since Joomla! {{JVer|3. | + | Since Joomla! {{JVer|3.x}} uses bootstraped templates, the messages will use the standard bootstrap CSS styles for Alerts. |
− | See: http:// | + | See: http://getbootstrap.com/2.3.2/components.html#alerts |
The general syntax remains: | The general syntax remains: | ||
<source lang="php"> | <source lang="php"> | ||
− | JFactory::getApplication()->enqueueMessage('Your Message', 'type); | + | JFactory::getApplication()->enqueueMessage('Your Message', 'type'); |
</source> | </source> | ||
Where '''type''' can be one of | Where '''type''' can be one of | ||
− | * | + | * 'warning' - yellow |
− | * ' | + | * 'notice' - blue |
* 'error' - red | * 'error' - red | ||
− | * ' | + | * 'message' (or empty) - green |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== See also == | == See also == | ||
− | * [ | + | * [http://api.joomla.org/11.4/Joomla-Platform/Error/JError.html JError on api.joomla.org] |
− | + | * [http://api.joomla.org/11.4/Joomla-Platform/Application/JApplication.html JApplication on api.joomla.org] | |
− | * [http://api.joomla.org/ | ||
<noinclude>[[Category:Development]]</noinclude> | <noinclude>[[Category:Development]]</noinclude> | ||
[[Category:Tutorials]][[Category:Component Development]] | [[Category:Tutorials]][[Category:Component Development]] |
Revision as of 21:06, 6 October 2013
Errors, warnings and notices can be displayed from any component, module, plugin or template using the methods outlined below.
// 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');
The second argument to the 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 jdoc:include statement in your template. Place the following in your template at the location where you want messages to appear.
<jdoc:include type="message" />
Message[edit]
Message
JFactory::getApplication()->enqueueMessage('Message');
Notice[edit]
Notice
JError::raiseNotice( 100, 'Notice' );
Warning[edit]
Warning
JError::raiseWarning( 100, 'Warning' );
Error[edit]
JError::raiseError( 4711, 'A severe error occurred' );
Joomla! 3.x is bootstraped[edit]
Since Joomla! uses bootstraped templates, the messages will use the standard bootstrap CSS styles for Alerts.
See: http://getbootstrap.com/2.3.2/components.html#alerts
The general syntax remains:
JFactory::getApplication()->enqueueMessage('Your Message', 'type');
Where type can be one of
- 'warning' - yellow
- 'notice' - blue
- 'error' - red
- 'message' (or empty) - green