Categories
English Wordpress

How add options to your WordPress 2.7 dashboard widgets

Well, in this article, I assume you have read the WP Engineer’s excellent post Add WordPress Dashboard Widgets, because his code will be our start point.

So, we have this code:


// Load up the localization file if we're using WordPress in a different language
// Place it in this plugin's folder and name it "MainFunction-[value in wp-config].mo"
load_plugin_textdomain( 'MainFunction', '/wp-content/plugins/MainFunction' );

/**
 * Content of Dashboard-Widget
 */
function MainFunction() {
	echo 'Test Add Dashboard-Widget';
}
 
/**
 * add Dashboard Widget via function wp_add_dashboard_widget()
 */
function MainFunction_Init() {
	wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction' );
}
 
/**
 * use hook, to integrate new widget
 */
add_action('wp_dashboard_setup', 'MainFunction_Init');

OK, now, remenber the wp_add_dashboard_widget function?

function wp_add_dashboard_widget( $widget_id, $widget_name, $callback, $control_callback = null )

The $control_callback parameter (obviously optional) is our main target. It gives the ‘Configure’ option to our spiffy widget.
So, we need to add a 4th parameter to wp_add_dashboard_widget:

wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction', 'MainFunction_Setup');

The MainFunction_Setup function handles two things: the options (set the default options, recolect new values, etc) and the option’s presentation (i.e. the HTML part)

So, here goes the code:


function MainFunction_Options() {
	$defaults = array( 'items' => 5, 'boolean' => 1);
	if ( ( !$options = get_option( 'MainFunction' ) ) || !is_array($options) )
		$options = array();
	return array_merge( $defaults, $options );
}

function MainFunction_Setup() {

	$options = MainFunction_Options();


	if ( 'post' == strtolower($_SERVER['REQUEST_METHOD']) && isset( $_POST['widget_id'] ) && 'MainFunction' == $_POST['widget_id'] ) {
		foreach ( array( 'items', 'boolean' ) as $key )
				$options[$key] = $_POST[$key];
		update_option( 'MainFunction', $options );
	}
		
?>
	

		
	


   

		
	



As you can see, MainFunction_Options puts the default values (if necessary, of course) and MainFunction_Setup show the current values and let change them. You can merge this two, of course...


Now, we have to get the options and use them in our MainFunction function. Change MainFunction like that:


/**
 * Content of Dashboard-Widget
 */
function MainFunction() {

        $widget_options = MainFunction_Options();

	echo 'Test Add Dashboard-Widget
';
	echo "You have selected $widget_options['items'] items
";
	echo "boolean is $widget_options['boolean']
";

}



The complete code here: 


';
	echo "You have selected $widget_options['items'] items
";
	echo "boolean is $widget_options['boolean']
";
}
 
/**
 * add Dashboard Widget via function wp_add_dashboard_widget()
 */
function MainFunction_Init() {
	wp_add_dashboard_widget( 'MainFunction', __( 'MainFunction Widget Title' ), 'MainFunction' , 'MainFunction_Setup' );
}

function MainFunction_Options() {
	$defaults = array( 'items' => 5, 'boolean' => 1);
	if ( ( !$options = get_option( 'MainFunction' ) ) || !is_array($options) )
		$options = array();
	return array_merge( $defaults, $options );
}

function MainFunction_Setup() {


	$options = MainFunction_Options();


	if ( 'post' == strtolower($_SERVER['REQUEST_METHOD']) && isset( $_POST['widget_id'] ) && 'MainFunction' == $_POST['widget_id'] ) {
		foreach ( array( 'items', 'boolean' ) as $key )
				$options[$key] = $_POST[$key];
		update_option( 'MainFunction', $options );
	}
		
?>
	

		
	


   

		
	





You can view a PHPS version (without PHP crippled tags) here.

536 replies on “How add options to your WordPress 2.7 dashboard widgets”

I know this if off topic but I’m looking into starting my
own weblog and was wondering what all is required to get setup?
I’m assuming having a blog like yours would cost a pretty penny?
I’m not very internet savvy so I’m not 100% sure.
Any suggestions or advice would be greatly appreciated.
Thank you

Hi there to every one, for the reason that I am genuinely eager of
reading this web site’s post to be updated daily.

It consists of pleasant material.

I have read a few excellent stuff here. Certainly price bookmarking for revisiting.
I wonder how much effort you put to create any such
magnificent informative site.

What i do not realize is in reality how you are now not actually
a lot more well-appreciated than you might be now.
You are very intelligent. You recognize thus significantly in the
case of this subject, produced me in my opinion consider it from numerous numerous angles.
Its like women and men are not fascinated except it is one thing to do with Woman gaga!
Your own stuffs nice. At all times care for it up!

It’s going to be finish of mine day, however before finish I am
reading this enormous piece of writing to improve my knowledge.

I’m really loving the theme/design of your weblog.
Do you ever run into any browser compatibility problems?
A handful of my blog readers have complained about my site not operating correctly
in Explorer but looks great in Opera. Do you have any
tips to help fix this problem?

Greetings! Very useful advice within this article! It’s the little changes that make the biggest changes.

Thanks a lot for sharing!

If you are going for most excellent contents like myself,
only go to see this web page every day for the reason that it provides quality contents, thanks

whoah this blog is excellent i really like reading your
articles. Keep up the great work! You realize, a lot of persons
are hunting around for this info, you can help them greatly.

You are so cool! I do not think I’ve truly read anything like this before.
So good to discover someone with original thoughts on this topic.

Seriously.. thank you for starting this up.
This site is something that’s needed on the internet, someone with a little originality!

Greate article. Keep writing such kind of information on your page.
Im really impressed by your site.
Hey there, You have done an incredible job. I will definitely digg it and in my view suggest to my friends.
I’m confident they will be benefited from this website.
0mniartist asmr

I’m really enjoying the theme/design of your website.

Do you ever run into any internet browser compatibility issues?

A small number of my blog visitors have complained about my site not working correctly in Explorer but looks great in Chrome.
Do you have any ideas to help fix this issue?

My coder is trying to convince me to move to .net from PHP.
I have always disliked the idea because of the
costs. But he’s tryiong none the less. I’ve been using WordPress on various websites for
about a year and am nervous about switching to another platform.

I have heard good things about blogengine.net.
Is there a way I can transfer all my wordpress content into
it? Any help would be greatly appreciated!

I absolutely love your site.. Very nice colors & theme.
Did you create this amazing site yourself? Please reply back as I’m attempting
to create my own personal blog and would love to know where you got this
from or just what the theme is called. Cheers!

Heⅼlo! Quiⅽk question that’s tߋtally off topіc. Do youu қnoᴡ how to makｅ
your site mobile friendly? My web sitｅ lookms
weird when viewing from my iphone 4. I’m tｒying to find
a theme or plugіn that might be able too fix thіs issue.If you have any
suggestions, pleɑse share. Manny thanks!

I always used to study post in news papers but now as I am a user of web thus from
now I am using net for articles or reviews, thanks to web.

An outstanding share! I have just forwarded this onto a co-worker who has been conducting a
little homework on this. And he actually ordered me breakfast because I discovered it for him…
lol. So allow me to reword this…. Thank YOU for the
meal!! But yeah, thanks for spending the time to discuss this issue here
on your site.

My relatives every time say that I am killing my time here
at web, however I know I am getting familiarity daily by reading thes good articles or reviews.

Hi, i read your blog occasionally and i own a similar one and i was just curious if you get
a lot of spam comments? If so how do you prevent it, any plugin or anything
you can recommend? I get so much lately it’s driving me insane so any assistance is very much appreciated.

I’m gone to convey my little brother, that he should also pay a visit this webpage on regular basis to take updated from most up-to-date news update.

Thank you for sharing your info. I really appreciate your efforts and I
am waiting for your next write ups thank you once again.

It’s actually very complex in this active life to listen news on TV, thus I only use the web for that reason, and take the newest news.

Thanks for your marvelous posting! I quite enjoyed
reading it, you may be a great author.I will make sure to bookmark your blog and definitely will come back from now on. I want to encourage yourself to
continue your great posts, have a nice weekend!

Hey there! Do you know if they make any plugins to help with SEO?
I’m trying to get my blog to rank for some targeted keywords but I’m not
seeing very good gains. If you know of any please share.
Thank you!

Wonderful blog! I found it while surfing around on Yahoo News.
Do you have any tips on how to get listed in Yahoo News?
I’ve been trying for a while but I never seem to get there!
Thank you

I visited multiple web pages except the audio feature for audio
songs existing at this web page is truly wonderful.

Way cool! Some extremely valid points! I appreciate you writing this article and also the rest
of the website is very good.

I’d like to thank you for the efforts you’ve put in writing this website.
I am hoping to check out the same high-grade blog posts from you in the future as well.
In truth, your creative writing abilities has motivated me
to get my own website now 😉

I read this piece of writing fully regarding the
comparison of latest and preceding technologies, it’s awesome article.

This is the right website for anybody who wishes to find out about this topic.

You know so much its almost hard to argue with you (not that I
really will need to…HaHa). You certainly put a new spin on a
topic which has been written about for a long time. Wonderful stuff, just excellent!

It’s hard to find experienced people for this topic,
but you sound like you know what you’re talking about!

Thanks

The other day, while I was at work, my cousin stole my iphone and tested to see if it can survive a twenty five foot drop, just so she can be a youtube sensation.
My apple ipad is now broken and she has 83 views. I know this is completely off topic
but I had to share it with someone!

Wow, incredible blog layout! How long have you been blogging for?
you make blogging look easy. The overall look of your site is wonderful, as well
as the content!

I was very happy to discover this great site. I want to to thank you for ones time for
this particularly wonderful read!! I definitely loved
every bit of it and I have you book-marked to check out new things on your blog.

Hello there! This blog post couldn’t be written much better!
Looking at this article reminds me of my previous roommate!
He always kept talking about this. I’ll send this post to him.
Pretty sure he’s going to have a great read. Thank you for sharing!

Excellent post. Keep writing such kind of info on your page.
Im really impressed by your site.
Hello there, You have performed a fantastic job.
I will certainly digg it and for my part recommend
to my friends. I’m confident they will be benefited from this site.

Hello, i believe that i noticed you visited my site so i got here to go back
the desire?.I’m attempting to to find issues to
enhance my web site!I guess its adequate to make use of some of your ideas!!

Comments are closed.