From Joomla! Documentation

< API16:JInstaller

The "API16" namespace is an archived namespace. This page contains information for a Joomla! version which is no longer supported. It exists only as a historical reference, it will not be improved and its content may be incomplete and/or contain broken links.


Method to parse through a media element of the installation manifest and take appropriate action.

<! removed transcluded page call, red link never existed >


parseMedia($element, $cid=0)
Parameter Name Default Value Description
$element $element The xml node to process
$cid 0 $cid Application ID of application to install to


boolean True on success

Defined in



jimport( 'joomla.installer.installer' );

Source Body

public function parseMedia($element, $cid=0)
        if (!($element instanceof JXMLElement) || !count($element->children()))
                // Either the tag does not exist or has no children therefore we return zero files processed.
                return 0;

        // Initialise variables.
        $copyfiles = array ();

        // Get the client info
        $client = &JApplicationHelper::getClientInfo($cid);

         * Here we set the folder we are going to copy the files to.
         *      Default 'media' Files are copied to the JPATH_BASE/media folder
        $folder = ((string)$element->attributes()->destination) ? DS.$element->attributes()->destination : null;
        $destination = JPath::clean(JPATH_ROOT.DS.'media'.$folder);

         * Here we set the folder we are going to copy the files from.
         * Does the element have a folder attribute?
         * If so this indicates that the files are in a subdirectory of the source
         * folder and we should append the folder attribute to the source path when
         * copying files.
        $folder = (string)$element->attributes()->folder;
        if ($folder && file_exists($this->getPath('source').DS.$folder)) {
                $source = $this->getPath('source').DS.$folder;
        else {
                $source = $this->getPath('source');

        // Process each file in the $files array (children of $tagName).
        foreach ($element->children() as $file)
                $path['src']    = $source.DS.$file;
                $path['dest']   = $destination.DS.$file;

                // Is this path a file or folder?
                $path['type']   = ($file->getName() == 'folder') ? 'folder' : 'file';

                 * Before we can add a file to the copyfiles array we need to ensure
                 * that the folder we are copying our file to exits and if it doesn't,
                 * we need to create it.
                if (basename($path['dest']) != $path['dest'])
                        $newdir = dirname($path['dest']);

                        if (!JFolder::create($newdir))
                                JError::raiseWarning(1, 'JInstaller::install: '.JText::_('FAILED_TO_CREATE_DIRECTORY').' "'.$newdir.'"');
                                return false;

                // Add the file to the copyfiles array
                $copyfiles[] = $path;

        return $this->copyFiles($copyfiles);

<! removed transcluded page call, red link never existed >


Code Examples