GetSimple CMS Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
===== Side Menu Creation Function =====

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

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

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 add an optional 3rd parameter in the params array:

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

This way a new parameter **//my-action//** is added to the link so 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 in the params array as ''false'':

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

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. (setup on the plugins tab, other functionality on theme tab):

<code>
$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' ) );
</code>

If you have multiple sidebar items like above, your main function (here //hello_world_show//) would look like this:
<code>
function hello_world_show() {
  if ( isset ( $_GET['setup'] ) {
    ...
  } elseif ( isset ( $_GET['show'] ) {
    ...
  }
}
</code>

===== Tab Creation Function =====

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

<code>
add_action('nav-tab','createNavTab',array('thetabname','your-plugin-filename','Tab Text', 'my-action'));
</code>

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

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


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

User Tools

Site Tools

Page Tools
