Adding your scripts within WHM

[jhyland87]

Hey guys, so I have looked around for a bit. I found out how to add an icon and function into cpanel, but how do I add one for the administrators into WHM? Any help would be appriceated! THanks!

Justin

 

[sunil001]

Hi,

Are you looking to add more options for your reseller customer WHM ? or server WHM?

Sunil
http://ehostpros.com

 

[jhyland87]

Server WHM.

I am making a PHP script that will protect the server against high CPU usage.

http://phprotect.com/index.php?option=com_content&view=article&id=22&Itemid=34

Its all PHP CLI, it would be nice to have an interface via WHM

 

[Infopro]

This may be what you seek.
http://www.cpanel.net/support/docs/modules/whm_create.html

 

[nickp666]

To make it show up in the 'Plugins' Panel of WHM, the frontend needs to be a CGI script, named: addon_YOURSCRIPTNAME.cgi and it must contain on the second line:

#WHMADDON:someaddon:Plugin Name

The last part of that line can have basic html formatting in it, bold text etc but note this is output between <a> tags for the link to the addon.

Perl seems to be the best language to use for WHM front ends given that there are perl modules for checking permissions, safely opening files, adding WHM interface parts etc

Hope that helps

 

[nickp666]

Here is a hello world example of a WHM plugin:

#!/usr/bin/perl
#WHMADDON:helloworld:Hello World <b>Example</b>
###############################################################################
#	This is an example hello world WHM plugin feel free to modify it as you see fit
###############################################################################
# Load general use case perl modules
use lib '/usr/local/cpanel';
use Cpanel::cPanelFunctions ();
use Cpanel::Form            ();
use Cpanel::Config          ();
use Whostmgr::HTMLInterface ();
use Whostmgr::ACLS          ();
###############################################################################

print "Content-type: text/html\r\n\r\n";

# Check user has root permissions
Whostmgr::ACLS::init_acls();
if ( !Whostmgr::ACLS::hasroot() ) {
	# User is not root, tell them where to go
	print "You need to be root to see the hello world example.\n";
	exit();
}

# Parse input parameters from GET and POST into $FORM{} for later use
my %FORM     = Cpanel::Form::parseform();

# Print a WHM Header
Whostmgr::HTMLInterface::defheader( "Hello World Example Plugin",'/path/to/logo.gif', '/cgi/addon_helloworld.cgi' );

# Print General Output
print "<p>Hello world indeed...</p>";

# End Example

1;

 

[jhyland87]

Thanks guys!

I tried the hellow world example, Here is the error log

open3: exec of /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi failed at cpsrvd-ssl.pl line 5369
Internal Error: "GET /cgi/hello.cgi HTTP/1.1" Premature end of script headers: /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi: Please check /usr/local/cpanel/logs/error_log for the exact error.
open3: exec of /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi failed at cpsrvd-ssl.pl line 5369
Internal Error: "GET /cgi/hello.cgi HTTP/1.1" Premature end of script headers: /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi: Please check /usr/local/cpanel/logs/error_log for the exact error.
open3: exec of /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi failed at cpsrvd-ssl.pl line 5369
Internal Error: "GET /cgi/hello.cgi HTTP/1.1" Premature end of script headers: /usr/local/cpanel/whostmgr/docroot/cgi/hello.cgi: Please check /usr/local/cpanel/logs/error_log for the exact error.

 

[jhyland87]

Nevermind..

Main
Hello World Example Plugin

Hello world indeed...

Chown/Chmod issues

How do I add it to the left menu?

 

[nickp666]

if you name the script prefixed with addon_ it will show in the menu, e.g.
addon_helloworld.cgi

 

[jhyland87]

if you name the script prefixed with addon_ it will show in the menu, e.g.
addon_helloworld.cgi

How can I add PHP to it?

My script is all PHP.

THANKS!

 

[jhyland87]

Nevermind, I just made the CGI Forward to a PHP script, and made the PHP chown to admin and chmod to 755 !