Customising the dynamic page title - Revision history

Mvangeest: Fixed mistake, hopefully

2011-05-20T11:56:12Z

Fixed mistake, hopefully

Mvangeest: Fixed mistake

2011-05-20T11:55:27Z

Fixed mistake

Mvangeest: Adjusted category

2011-05-20T11:15:51Z

Adjusted category

Mvangeest: moved Customise the dynamic page title to Customising the dynamic page title: Adapted page title to the continuous tense used in most tutorial titles.

2011-05-20T10:54:44Z

moved Customise the dynamic page title to Customising the dynamic page title: Adapted page title to the continuous tense used in most tutorial titles.

Chris Davenport: Customize the dynamic page title moved to Customise the dynamic page title: British English spelling.

2011-03-08T15:48:00Z

Customize the dynamic page title moved to Customise the dynamic page title: British English spelling.

Chris Davenport: Updated for current guidelines. Removed erroneous statement about where the PHP code is to be inserted.

2011-03-08T15:47:36Z

Updated for current guidelines. Removed erroneous statement about where the PHP code is to be inserted.

Iarp: Updated with more info.

2011-03-07T05:29:14Z

Updated with more info.

Batch1211 at 13:03, 20 September 2010

2010-09-20T13:03:56Z

Ksookocheff at 17:02, 19 November 2008

2008-11-19T17:02:34Z

Ksookocheff: New page: '''Customize the dynamic page title''' To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using. For ex...

2008-11-19T17:02:00Z

New page: '''Customize the dynamic page title''' To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using. For ex...

New page

'''Customize the dynamic page title'''
To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using. For example, directly after the <head> tag add the following to show "Site Name - Page Name" as the browser's page title:

<?php
$document =& JFactory::getDocument();
$document->setTitle($mainframe->getCfg('sitename') . " - " . $document->title);
?>

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

@@ Line 37: / Line 37: @@
 .... rest of template file.
-</source>
+</source><noinclude>[[Category:Tips and tricks]][[Category:Tips and tricks 1.5]][[Category:Tutorials]][[Category:Template Development]]</noinclude>
 <noinclude>[[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]
 [[Category:Tutorials]]
 [[Category:Template Development]]</noinclude>

@@ Line 38: / Line 38: @@
 </source>
-<noinclude>
+<noinclude>[[Category:Tips and tricks]]
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]
 [[Category:Tutorials]]
-[[Category:Template Development]]
+[[Category:Template Development]]</noinclude>
 </noinclude>

@@ Line 38: / Line 38: @@
 </source>
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]
-[[Category:Tutorials]][[Category:Template Development]]
+[[Category:Tutorials]]

@@ Line 1: / Line 1: @@
-This will allow you to change the global page title across the entire site. You may customize it to your own liking within your own templates files.
+A common requirement is to customise the way in which the page title is displayed, For example, including the site name as part of the page title.  The code on this page will allow you to change the global page title across the entire site. You may customise it to your own liking within your own template files.  The code can be placed anywhere in your <strong>template</strong> index.php, although most people tend to insert it near the top or within the <nowiki><head></nowiki> element.
-The code needs to go just after the opening <nowiki><head></nowiki> element and before <nowiki><jdoc:include type="head" /></nowiki> element.
+To get the current page title:
-Document title: <strong><nowiki>$document->title</nowiki></strong>
+Combining these two pieces of code together, you can do this:
-−
-Sitename: <strong><nowiki>$mainframe->getCfg('sitename')</nowiki></strong>
-−
-−
-How it would look(currently set to "Document title - Sitename"):
 <source lang="php">
- <?php
+<?php
- $document =& JFactory::getDocument();
+$app = JFactory::getApplication();
- $document->setTitle($document->title . " - " . $mainframe->getCfg('sitename'));
+$this->setTitle( $this->getTitle() . ' - ' . $app->getCfg( 'sitename' ) );
- ?>
+?>
 </source>
+Here's a more complete example of what a template would look like with this code embedded in it:
-Example (template coding may vary):
 <source lang="php">
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml">
 <head>
- <?php
+<?php
- $document =& JFactory::getDocument();
+$app = JFactory::getApplication();
- $document->setTitle($document->title . " - " . $mainframe->getCfg('sitename'));
+$this->setTitle( $this->getTitle() . ' - ' . $app->getCfg( 'sitename' ) );
- ?>
+?>
 <jdoc:include type="head" />
 .... rest of template file.
 </source>
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]
-[[Category:Tutorials]][[Category:Component Development]]
+[[Category:Tutorials]][[Category:Template Development]]

@@ Line 1: / Line 1: @@
-To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using.  For example, directly after the <head> tag add the following to show "Site Name - Page Name" as the browser's page title:
+This will allow you to change the global page title across the entire site. You may customize it to your own liking within your own templates files.
 <source lang="php">
   <?php
   $document =& JFactory::getDocument();
-  $document->setTitle($mainframe->getCfg('sitename') . " - " . $document->title);
+  $document->setTitle($document->title . " - " . $mainframe->getCfg('sitename'));
   ?>
 </source>
 [[Category:Tips and tricks]]
 [[Category:Tips and tricks 1.5]]
 [[Category:Tutorials]][[Category:Component Development]]

← Older revision		Revision as of 17:02, 19 November 2008
Line 1:		Line 1:
−	~~'''Customize the dynamic page title'''~~
	To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using. For example, directly after the <head> tag add the following to show "Site Name - Page Name" as the browser's page title:		To customize the page title to add the site name followed by the document title, edit index.php in the template that you are currently using. For example, directly after the <head> tag add the following to show "Site Name - Page Name" as the browser's page title: