====== addCustomHeadTag ======
{#JAPI Joomla.Framework Application JApplication::addCustomHeadTag - IR #}

Adds a custom HTML string to the head block of the current page being processed.

**The method is deprecated** and provided for backwards compatibility with Joomla! 1.0. It is scheduled to be removed in future versions.
Use [[references:joomla.framework:document:JDocumentHTML-addCustomTag|JDocumentHTML::addCustomTag]] instead.

===== Syntax =====
void addCustomHeadTag	( **$html** )

| **$html** | string | the custom html element (tag) to add to the document head. |

===== Examples =====
The following code will insert a head element into the page that will link to the file samplejavascript.js.
<code php|Example>
function insertCustomHeader() {
    global $mainframe;
 
    $customHead = '<script language="JavaScript" '
    . 'src="samplejavascript.js" '
    . 'type="text/javascript"></script>'
    ;
 
    $mainframe->addCustomHeadTag( $customHead );
}

insertCustomHeader();
</code>

----

~~DISCUSSION~~