Actions

API15

JHelp/createURL

From Joomla! Documentation

< API15:JHelp
Revision as of 17:23, 22 March 2010 by Doxiki (Talk | contribs)

(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Replacement filing cabinet.png
This Namespace has been archived - Please Do Not Edit or Create Pages in this namespace. Pages contain information for a Joomla! version which is no longer supported. It exists only as a historical reference, will not be improved and its content may be incomplete.

Contents

Description

Create an URL for a giving help file reference

[Edit Descripton]

Description:JHelp/createURL

Syntax

createURL($ref, $useComponent=false)
Parameter Name Default Value Description
$ref The name of the popup file (excluding the file extension for an xml file)
$useComponent false Use the help file in the component directory

Defined in

libraries/joomla/language/help.php

Importing

jimport( 'joomla.language.help' );

Source Body

function createURL($ref, $useComponent = false)
{
        global $mainframe, $option;
 
        $user                   =& JFactory::getUser();
        $userHelpUrl    = $user->getParam( 'helpsite' );
        $globalHelpUrl  = $mainframe->getCfg('helpurl');
        $lang                   =& JFactory::getLanguage();
 
        if ($useComponent)
        {
                if (!preg_match( '#\.html$#i', $ref )) {
                        $ref = $ref . '.html';
                }
 
                $url = 'components/' . $option. '/help';
                $tag =  $lang->getTag();
 
                // Check if the file exists within a different language!
                if( $lang->getTag() != 'en-GB' ) {
                        $localeURL = JPATH_BASE.DS.$url.DS.$tag.DS.$ref;
                        jimport( 'joomla.filesystem.file' );
                        if( !JFile::exists( $localeURL ) ) {
                                $tag = 'en-GB';
                        }
                }
                return $url.'/'.$tag.'/'.$ref;
        }
 
 
        if ( $userHelpUrl )
        {
                // Online help site as defined in GC
                $version = new JVersion();
                $ref .= $version->getHelpVersion();
                $url = $userHelpUrl . '/index2.php?option=com_content&amp;task=findkey&amp;tmpl=component&amp;keyref=' . urlencode( $ref );
        }
        else if ( $globalHelpUrl )
        {
                // Online help site as defined in GC
                $version = new JVersion();
                $ref .= $version->getHelpVersion();
                $url = $globalHelpUrl . '/index2.php?option=com_content&amp;task=findkey&amp;tmpl=component;1&amp;keyref=' . urlencode( $ref );
        }
        else
        {
                // Included html help files
                $helpURL = 'help/' .$lang->getTag() .'/';
 
                if (!preg_match( '#\.html$#i', $ref )) {
                        $ref = $ref . '.html';
                }
 
                // Check if the file exists within a different language!
                if( $lang->getTag() != 'en-GB' ) {
                        $localeURL = JPATH_BASE . $helpURL .$ref;
                        jimport( 'joomla.filesystem.file' );
                        if( !JFile::exists( $localeURL ) ) {
                                $helpURL = 'help/en-GB/';
                        }
                }
                $url = $helpURL . $ref;
        }
 
        return $url;
}

[Edit See Also] SeeAlso:JHelp/createURL

Examples

<CodeExamplesForm />