External function (extaction)

extaction — a mechanism that allows embedding external links into the main menu. You can specify via COREmanager configuration file a URL for a specific function name. This URL will be used to generate a link in the main menu if no function with that name is registered in the panel.

The following macros can be used in this URL:

  • $site — the name of the site to which the request was sent (without port number);
  • $manager — the panel URL to which the request was sent.

Example

For example, you need to add an external link to BILLmanager that will point to yandex.com. To do this:

  1. Create a file with the function description:
    Example file with description
    #cat /usr/local/mgr5/etc/xml/billmgr_mod_menu.xml 
    
    <mgrdata>
    <mainmenu level="admin+">
    <node name="mainmenuaccount">
    <node name="myfunc" />
    </node>
    </mainmenu>
    <handler name="myaddon" type="xml">
    <func name="myfunc" />
    </handler>
    <lang name="en">
    <messages name="desktop">
    <msg name="menu_myfunc">Yandex</msg>
    </messages>
    </lang>
    </mgrdata>
    

    Explanations:

      • <node name="account"> — means that the menu item will be added to the Accounts menu subsection;
      • <node name="myfunc" /> — declares your own function. For the panel to start displaying the new menu item, a function with the corresponding name must exist in the panel.
  2. Declare the function via an add-on:
    Example function
    <handler name="myaddon" type="xml">
    <func name="myfunc" />
    </handler>
    
  3. In the BILLmanager or Clouden configuration file /usr/local/mgr5/etc/billmgr.conf add a link for the menu item described above:
    extaction myfunc http://yandex.com|http://yandex.com