Custom error pages - Revision history

Chris Davenport: Reverted edits by Ilmuini (talk) to last revision by Elin

2012-06-16T08:02:23Z

Reverted edits by Ilmuini (talk) to last revision by Elin

Ilmuini: /* HTTP Status Code */

2012-06-16T04:29:24Z

‎HTTP Status Code

Elin at 11:18, 30 March 2012

2012-03-30T11:18:02Z

Oc666: add warning for method working only on 1.5

2011-07-16T09:43:08Z

add warning for method working only on 1.5

Batch1211 at 12:32, 19 September 2010

2010-09-19T12:32:18Z

Cmb: Corrected grammar.

2010-02-07T22:58:49Z

Corrected grammar.

Nettroll at 12:45, 15 October 2009

2009-10-15T12:45:51Z

Stu-goblue!: /* HTTP status code */

2009-10-13T03:20:46Z

‎HTTP status code

Stu-goblue!: /* Customizing Error Messages */

2009-10-13T03:20:34Z

‎Customizing Error Messages

Holdencreative at 14:35, 27 July 2009

2009-07-27T14:35:59Z

@@ Line 32: / Line 32: @@
 ====HTTP Status Code====
-When a request is made for a page on your site, the server returns an HTTP status code in response to the request. Joomla! returns a '200 - the server successfully returned the page' for error pages. This is problematic for those working with [http://google-removal-tool.blogspot.com/ Google] Webmaster Services and trying to get a sitemap resolved.
+When a request is made for a page on your site, the server returns an HTTP status code in response to the request. Joomla! returns a '200 - the server successfully returned the page' for error pages. This is problematic for those working with Google Webmaster Services and trying to get a sitemap resolved.
 If you want Joomla! to return a status code for the error, you can do so by adding logic before the DOCTYPE line, as follows:

@@ Line 32: / Line 32: @@
 ====HTTP Status Code====
-When a request is made for a page on your site, the server returns an HTTP status code in response to the request. Joomla! returns a '200 - the server successfully returned the page' for error pages. This is problematic for those working with Google Webmaster Services and trying to get a sitemap resolved.
+When a request is made for a page on your site, the server returns an HTTP status code in response to the request. Joomla! returns a '200 - the server successfully returned the page' for error pages. This is problematic for those working with [http://google-removal-tool.blogspot.com/ Google] Webmaster Services and trying to get a sitemap resolved.
 If you want Joomla! to return a status code for the error, you can do so by adding logic before the DOCTYPE line, as follows:

@@ Line 1: / Line 1: @@
 Joomla! uses the ''templates/system/error.php'' file to handle several HTTP Status errors, including "403 Forbidden", "404 Not Found", and "500 Internal Server" errors. You can style the error results, if desired.
-It is important to understand that ''error.php'' is an independent file from Joomla!. Plugins do not run on the file. You cannot include modules or use  ''<jdoc:include>'' statements.
+It is important to understand that ''error.php'' is an independent file from the Joomla! CMS but dependent on the Joomla! Platform. Plugins do not run on the file. You cannot include modules or use  ''<jdoc:include>'' statements.
 ====Overriding the System Error Results====

← Older revision		Revision as of 09:43, 16 July 2011
Line 49:		Line 49:

	====Using Theme Header and Footer on Standard Error Page====		====Using Theme Header and Footer on Standard Error Page====
		+	{{JVer\|1.5}}
	If you want to see the error page in theme design and don't like redirecting to error page URL or duplicating HTML in the error page template, here is a way to apply your theme template to the error page.		If you want to see the error page in theme design and don't like redirecting to error page URL or duplicating HTML in the error page template, here is a way to apply your theme template to the error page.

← Older revision		Revision as of 12:32, 19 September 2010
Line 117:		Line 117:

	'''Note:''' Module includes in template will not work on error page created by this method (but will work on other pages).		'''Note:''' Module includes in template will not work on error page created by this method (but will work on other pages).
		+
		+	[[Category:Tutorials]][[Category:Template Development]]

@@ Line 1: / Line 1: @@
-=== Custom error pages ===
+Joomla! uses the ''templates/system/error.php'' file to handle several HTTP Status errors, including "403 Forbidden", "404 Not Found", and "500 Internal Server" errors. You can style the error results, if desired.
-Joomla! uses the templates/system/error.php file to handle several HTTP Status errors, including "403 Forbidden", "404 Not Found", and "500 Internal Server" Errors. You can style the error results, if desired.
+It is important to understand that ''error.php'' is an independent file from Joomla!. Plugins do not run on the file. You cannot include modules or use  ''<jdoc:include>'' statements.
-−
-It is important to understand that the error.php is an independent file from Joomla!. Plugins do not run on the file. You cannot include modules or use  ''<jdoc:include>'' statements.
-−
-==== Overriding the System Error Results ====
 To override the system error results, copy the ''templates/system/error.php'' file into your ''templates/<template-name>'' directory.
@@ Line 13: / Line 10: @@
 You can format the page, as desired, to match your template.
-==== Overriding the System Styling ====
+====Overriding the System Styling====
-−
 If you want to change the styling, copy the ''templates/system/css/error.css'' file into your ''templates/<template-name>/css'' directory.
-Next, update the your ''templates/<template-name>/error.php'' file to reference the new location of the stylesheet by changing this line, accordingly:
+Next, update your ''templates/<template-name>/error.php'' file to reference the new location of the stylesheet by changing this line, accordingly:
 <source lang="css"><link rel="stylesheet" href="<?php echo $this->baseurl; ?>/templates/system/css/error.css" type="text/css" /></source>
-Then, simply change the error.css, as desired, for your styling requirements.
+Then, simply change the ''error.css'', as desired, for your styling requirements.
-−
-==== Customizing Error Messages ====
 You can add conditional logic to vary the message returned, dependent upon the specific error code.
@@ Line 36: / Line 31: @@
 </source>
-==== HTTP status code ====
+====HTTP Status Code====
-−
 When a request is made for a page on your site, the server returns an HTTP status code in response to the request. Joomla! returns a '200 - the server successfully returned the page' for error pages. This is problematic for those working with Google Webmaster Services and trying to get a sitemap resolved.
@@ Line 48: / Line 42: @@
 </source>
-'''More HTTP status code information:'''
+====More HTTP Status Code Information====
 * [http://docs.joomla.org/Tutorial:Create_a_Custom_404_Error_Page Joomla! Documentation: Create a Custom 404 Error Page]
@@ Line 55: / Line 49: @@
 ====Using Theme Header and Footer on Standard Error Page====
-If you want to see error page in theme design and don't like redirecting to error page url or duplicating html in error page template, there is a way how to apply theme template to error page too.
+First, put the following code in ''templates/<template-name>/error.php'':
-−
-First, you need to put following code to ''templates/<template-name>/error.php'':
 <source lang="php">
@@ Line 70: / Line 63: @@
 </source>
-Then need to make following edits to ''templates/<template-name>/index.php''::
+Then make the following edits to ''templates/<template-name>/index.php''::
-−
-. Find following code in ''index.php''
+. Find the following code in ''index.php''
 <source lang="php">
@@ Line 79: / Line 71: @@
 </source>
-and replace it with following
+and replace it with the following
 <source lang="php">
@@ Line 89: / Line 81: @@
 </source>
-. Find following code in ''index.php''
+. Find the following code in ''index.php''
 <source lang="php">
@@ Line 95: / Line 87: @@
 </source>
-and replace it with following
+and replace it with the following
 <source lang="php">
@@ Line 122: / Line 114: @@
 </source>
-Now theme template applied to error pages too.
+Now your theme template is applied to error pages too.
-'''Note:''' Module includes in template will not work on error page created by this method (but will work on other pages)
+'''Note:''' Module includes in template will not work on error page created by this method (but will work on other pages).

← Older revision		Revision as of 12:45, 15 October 2009
Line 53:		Line 53:
	* [http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html HTTP/1.1 Status Code Definitions]		* [http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html HTTP/1.1 Status Code Definitions]
	* [http://www.google.com/support/webmasters/bin/answer.py?answer=83040&topic=8474 Google Webmaster - Analyzing Crawl Errors]		* [http://www.google.com/support/webmasters/bin/answer.py?answer=83040&topic=8474 Google Webmaster - Analyzing Crawl Errors]
		+
		+	====Using Theme Header and Footer on Standard Error Page====
		+
		+	If you want to see error page in theme design and don't like redirecting to error page url or duplicating html in error page template, there is a way how to apply theme template to error page too.
		+
		+	First, you need to put following code to ''templates/<template-name>/error.php'':
		+
		+	<source lang="php">
		+	<?php
		+	// no direct access
		+	defined( '_JEXEC' ) or die( 'Restricted access' );
		+
		+	include dirname(__FILE__) . "/index.php";
		+	?>
		+
		+	</source>
		+
		+	Then need to make following edits to ''templates/<template-name>/index.php''::
		+
		+
		+	1. Find following code in ''index.php''
		+
		+	<source lang="php">
		+	<jdoc:include type="head" />
		+	</source>
		+
		+	and replace it with following
		+
		+	<source lang="php">
		+	<?php if (!$this->error->code) : ?>
		+	<jdoc:include type="head" />
		+	<?php else : ?>
		+	<title><?php echo $this->error->code ?> - <?php echo $this->title; ?></title>
		+	<?php endif; ?>
		+	</source>
		+
		+	2. Find following code in ''index.php''
		+
		+	<source lang="php">
		+	<jdoc:include type="component" />
		+	</source>
		+
		+	and replace it with following
		+
		+	<source lang="php">
		+	<?php if ($this->error->code) : /* check if we are on error page, if yes - display error message */ ?>
		+	<p><strong><?php echo $this->error->code ?> - <?php echo $this->error->message ?></strong></p>
		+
		+	<p><strong><?php echo JText::_('You may not be able to visit this page because of:'); ?></strong></p>
		+	<ol>
		+	<li><?php echo JText::_('An out-of-date bookmark/favourite'); ?></li>
		+	<li><?php echo JText::_('A search engine that has an out-of-date listing for this site'); ?></li>
		+	<li><?php echo JText::_('A mis-typed address'); ?></li>
		+	<li><?php echo JText::_('You have no access to this page'); ?></li>
		+	<li><?php echo JText::_('The requested resource was not found'); ?></li>
		+	<li><?php echo JText::_('An error has occurred while processing your request.'); ?></li>
		+	</ol>
		+	<p><strong><?php echo JText::_('Please try one of the following pages:'); ?></strong></p>
		+	<p>
		+	<ul>
		+	<li><a href="<?php echo $this->baseurl; ?>/index.php" title="<?php echo JText::_('Go to the home page'); ?>"><?php echo JText::_('Home Page'); ?></a></li>
		+	</ul>
		+	</p>
		+	<p><?php echo JText::_('If difficulties persist, please contact the system administrator of this site.'); ?></p>
		+	<?php else : ?>
		+	<jdoc:include type="component" />
		+	<?php endif; ?>
		+	</source>
		+
		+	Now theme template applied to error pages too.
		+
		+	'''Note:''' Module includes in template will not work on error page created by this method (but will work on other pages)

@@ Line 43: / Line 43: @@
 <source lang="php">
 <?php
-if ($this->error->code = '404') {
+if ($this->error->code == '404') {
 	header("HTTP/1.0 404 Not Found");
 } ?>

@@ Line 28: / Line 28: @@
 Here is an example of how to trap a 404 error and provide a custom message.
 <source lang="php">
-<?php if ($this->error->code = '404') { ?>
+<?php if ($this->error->code == '404') { ?>
 	<div id="errorboxheader">Page not found</div>
 		<div id="errorboxbody"><p>Sorry! That page cannot be found.</p>

@@ Line 50: / Line 50: @@
 '''More HTTP status code information:'''
 * [http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html HTTP/1.1 Status Code Definitions]
 * [http://www.google.com/support/webmasters/bin/answer.py?answer=83040&topic=8474 Google Webmaster - Analyzing Crawl Errors]