<?php

defined ('VARIABLE') or die;

/*
** Create a list of required hooks according to current one's dependencies
** $id      : id of current hook in global $gl_hooks array
** $chain   : list of already required hooks to avoid circular references
** $result  : output array containing hooks to be included
*/
function    hookRequire ($id, $chain, &$result)
{
    global  $gl_hooks;

    // Browse hooks required by current one
    $hook = &$gl_hooks[$id];

    foreach ($hook['ref'] as $ref => $needed)
    {
        // Check for circular references
        if (isset ($chain[$ref]))
            showError (tra ('error.internal_hook_circular', array ('source' => $id, 'target' => $ref)));

        // Check for required hook availability and dependencies
        if (isset ($gl_hooks[$ref]))
            hookRequire ($ref, $chain + array ($ref => 0), $result);
        else if ($needed)
            showError (tra ('error.internal_hook_needed', array ('source' => $id, 'target' => $ref)));
    }

    // Check if hook has already been registered
    foreach ($result as $i => $item)
    {
        if ($item['id'] == $id)
            return;
    }

    // Insert hook regarding its weights and already included dependencies
    if (is_file ($hook['path']))
    {
        $min = -1;

        foreach ($hook['ref'] as $ref => $null)
            foreach ($result as $i => $item)
                if ($item['id'] == $ref)
                    $min = max ($min, $i);

        for ($index = count ($result); $index > $min + 1 && $result[$index - 1]['weight'] > $hook['weight']; )
            --$index;

        array_splice ($result, $index, 0, array (array
        (
            'access'    => $hook['access'],
            'id'        => $id,
            'module'    => $hook['module'],
            'path'      => $hook['path'],
            'weight'    => $hook['weight']
        )));
    }
    else
        showError (tra ('error.internal_hook_file', array ('file' => $hook['file'], 'module' => tra ($hook['module'], array (), false))));
}

?>