在弹出菜单中添加条目

<?php
// iTop module definition file
//

SetupWebPage::AddModule(
    __FILE__,
    'sample-add-menu/',
    array(
        // Identification
        'label' => 'Add Menu Sample',
        'category' => 'business',

        // Setup
        'dependencies' => array(),
        'mandatory' => false,
        'visible' => true,

        // Components
        'datamodel' => array(
            'main.sample-add-menu.php',
            'model.sample-add-menu.php'
        ),
        'webservice' => array(),
        'data.struct' => array(),
        'data.sample' => array(),

        // Documentation
        'doc.manual_setup' => '',
        'doc.more_information' => '',

        // Default settings
        'settings' => array(),
    )
);

<?php
/**
 * Sample extension to show how adding menu items in iTop
 * This extension demonstrates three possible types of menu items:
 * - URL 链接到任意网页
 * - JavaScript 函数调用
 * - 分隔线（水平线）
 */
class AddMenuSampleExtension implements iPopupMenuExtension
{
    /**
     * Get the list of items to be added to a menu.
     *
     * This method is called by the framework for each menu.
     * The items will be inserted in the menu in the order of the returned array.
     * @param int $iMenuId The identifier of the type of menu, as listed by the constants MENU_xxx
     * @param mixed $param Depends on $iMenuId, see the constants defined above
     * @return object[] An array of ApplicationPopupMenuItem or an empty array if no action is to be added to the menu
     */
    public static function EnumItems($iMenuId, $param)
    {
        $aResult = array();
        switch($iMenuId) // 要添加菜单项的菜单类型
        {
            /**
             * 在列表的操作菜单中插入条目
             * $param 是包含对象列表的 DBObjectSet
             */
            case iPopupMenuExtension::MENU_OBJLIST_ACTIONS:
                // 添加触发自定义 JS 函数的菜单项
                $sModuleDir = basename(dirname(__FILE__));
                $sJSFileUrl = utils::GetAbsoluteUrlModulesRoot().$sModuleDir.'/js/sample.js';
                $iCount = $param->Count(); // 对象集中的对象数量
                $aResult[] = new JSPopupMenuItem('_Custom_JS_', 'Custom JS Function On List...', "MyCustomJSListFunction($iCount)", array($sJSFileUrl));
                break;

            /**
             * 在列表的工具包菜单中插入条目
             * $param 是包含对象列表的 DBObjectSet
             */
            case iPopupMenuExtension::MENU_OBJLIST_TOOLKIT:
                break;

            /**
             * 在对象详情页的操作菜单中插入条目
             * $param 是当前显示的对象实例（DBObject）
             */
            case iPopupMenuExtension::MENU_OBJDETAILS_ACTIONS:
                // 为任意对象添加 "Google this..." 菜单，在新标签页打开 Google 搜索
                $aResult[] = new URLPopupMenuItem('_Google_this_', 'Google this...', "http://www.google.com?q=".$param->GetName(), '_blank');

                // 仅对 Contact（Team 和 Person）添加额外菜单项
                if ($param instanceof Contact)
                {
                    // 添加分隔线（仅 iTop 2.0.1-beta 及以上版本支持）
                    $aResult[] = new SeparatorPopupMenuItem();

                    // 添加触发自定义 JS 函数的菜单项
                    $sModuleDir = basename(dirname(__FILE__));
                    $sJSFileUrl = utils::GetAbsoluteUrlModulesRoot().$sModuleDir.'/js/sample.js';
                    $aResult[] = new JSPopupMenuItem('_Custom_JS_', 'Custom JS Function...', "MyCustomJSFunction('".addslashes($param->GetName())."')", array($sJSFileUrl));
                }
                break;

            /**
             * 在仪表盘菜单中插入条目
             * $param 是当前显示的仪表盘实例
             */
            case iPopupMenuExtension::MENU_DASHBOARD_ACTIONS:
                break;

            /**
             * 在用户菜单（页面右上角）中插入条目
             * $param 为 null
             */
            case iPopupMenuExtension::MENU_USER_ACTIONS:
                break;
        }
        return $aResult;
    }
}

// 从自定义菜单项调用的示例 JS 函数
function MyCustomJSFunction(sName)
{
    // 简单弹出提示框
    alert(sName);
}

// 从列表菜单项调用的示例 JS 函数
function MyCustomJSListFunction(iCount)
{
    alert('There are '+iCount+' element(s) in this list.');
}