User Tools

Site Tools


plugins:tabs_menus

This is an old revision of the document!


Side Menu Creation Function

You can add menu links to any of GetSimple's tabs with the following code

add_action('xxxxxx-sidebar','createSideMenu',array('your-plugin-filename','Menu Text'));

Replace xxxxxx-sidebar with the sidebar you want(e.g.: backups-sidebar, files-sidebar, pages-sidebar, plugins-sidebar, settings-sidebar, support-sidebar or theme-sidebar)

(3.1+) If you want to add multiple links for your plugin, you can use the optional parameter action:

add_action('xxxxxx-sidebar','createSideMenu',array('your-plugin-filename','Menu Text', 'my-action'));

This way a new parameter action=my-action is added to the link and you can determine which link was clicked.

(3.1+) If you want a functionality like the “Edit Page” link which only shows if the function is active, add a 4th parameter false:

add_action('xxxxxx-sidebar','createSideMenu',array('your-plugin-filename','Show list of It', 'list'));
add_action('xxxxxx-sidebar','createSideMenu',array('your-plugin-filename','Edit It', 'edit', false));

When you click the newly created menu link, the function you registered in register_plugin() will be called, and unless you specified the page your new menu link is on in the 7th argument of register_plugin(), the side menu will disappear.

Thus if you add side bar links to two different tabs, you need to change this parameter dynamically, e.g.

$thisfile = basename(__FILE__, ".php");

# register plugin
register_plugin(
	$thisfile, //Plugin id
	'Hello World', 	//Plugin name
	'1.0', 		//Plugin version
	'Chris Cagle',  //Plugin author
	'http://www.cagintranet.com/', //author website
	'Finds email addresses in content and components and "hides" them', //Plugin description
	@$_GET['id'] == $thisfile && @$_GET['action'] == 'setup' ? 'plugins' : 'theme', 
			//page type - on which admin tab to display
	'hello_world_show'  //main function (administration)
);

add_action('plugins-sidebar','createSideMenu',array($thisfile,'Setup Hello World','setup'));
add_action('theme-sidebar','createSideMenu',array($thisfile,'Show Hello World','show'));

Tab Creation Function

(3.1+) You can also add a new tab to the GetSimple administration by using the following code:

add_action('nav-tab','createNavTab',array('tab-name','your-plugin-filename','Menu Text', 'my-action'));

Use a unique name for the tab, e.g. your plugin name like 'newsmanager'. Also use this name for the page type in register_plugin(). The action parameter is again optional. You can then add sidebar links for this tab with

add_action('thetabname-sidebar', ...); // e.g. 'newsmanager-sidebar'

Only use this function, if you need a lot of side bar links for you plugin and want to group them.

plugins/tabs_menus.1327420273.txt.gz · Last modified: 2013/04/19 14:57 (external edit)