include_once(ABSPATH.'/wp-admin/includes/media.php');
	include_once(ABSPATH.'/wp-admin/includes/file.php');
	include_once(ABSPATH.'/wp-admin/includes/image.php');
	
//	$id is the id of the post being inserted
//	$name is actually the name of the form input that uploaded the file so WP can access it using $_FILE[$name]
	media_handle_upload($name,$id);

If you are inserting a new post, it makes sense to have the line $id = wp_insert_post($post_data); before this.

In WordPress 2.5, the code is cleaner, the plugin is more responsive and you can add both “real” sidebar widgets, or add “fake” ones to match the dashboard.

This plugin is currently intended for 2.5, but it also works in WordPress 2.1 – 2.3 and can work in WordPress 2.0.x if you use the Completely Wipe Dashboard option.

Installation is a breeze:

1. Download the zip file for WordPress Dashboard Editor
2. Unzip and upload dashboard.php to your wp-content/plugins/ folder.
3. Go to your dashboard. There will be a new sub-menu item.
4. Select any options you want and add any PHP or HTML code that you want to the textbox.

Code Examples:

To add a sidebar widget to your dashboard (after selecting the option from the Dashboard management page) use the code:
<?php dynamic_sidebar('admin');?>
The Admin sidebar is modified and controlled the exact same way as any other sidebar.

If you use the WP-UserOnline plugin you can use:
<?php echo useronline_page();?>

In WordPress 2.1-2.3 f you find that your new content doesn’t align nicely you can add:

<div style="float:left; width:460px;">
//
//Add all other content here
//
</div>

Any code that can be used in your WordPress Theme can be used in the dashboard. This means that you can have different information appear for the different user roles among other things.

1. It turns out that you can see the effects of trawling for fish from space. Do we need any more evidence against it?
2. Uncertain Principles posts about the backlash from the Virginia Tech shootings: turns out stage plays with fake wooden weapons endanger students…according to some college administrators.
3. Uncertain principles also wonders if there is any realistic nanotechnology in SciFi writing.
4. That encrypted hard drive you might have? Worthless now that the encryption can be broken…easily.

Oh and as a side note, anyone else watch one of my favorite video blogs: http://tv.winelibrary.com/?

image credit: Pulpolux !!!

The Simple Tags has been around for a long time, but now it works perfectly with WordPress tagging. What does it do? Most everything you could want (I could retype the list, but I’m going to borrow it straight from the Simple Tags website):

• type-ahead input tags
• auto suggestion of tags
• tags management (rename, delete, amalgamate, search and add tags, edit tags ID)
• List of non tagged contents
• Edit mass tags
• Possibility to tag pages (not only posts) and include them inside the tags results
• Related content since common tags
• Possibility to add related posts inside RSS
• Dynamic Tag Clouds with colors with Widgets
• Tags inside your header’s blog
• Embedded tags ([tags]tag1, tag2[/tags]) for retro compatibility

I use a lot of Plugins and write a lot of Plugins, so the fact that I even use one usually means it is really well made or very useful, but this one is one of the very few that I thought was good enough to promote. Remember, if you have a favorite Plugin, do the author a favor and mention it once or twice.

Oh and what would be really nice is if it had a feature that would suggest related keywords based on the text (there used to be a Yahoo API that did this.) Wink Wink.

In other news, INAP is in the process of a major overhaul including a complete rewrite of most of its antiquated structure. When this process is complete it will be rebranded to demonstrate the totality of its features (it won’t be called INAP anymore because the name is too restrictive), but will be released as version 3.0

I almost cried. That description fits only the 1.0 version of INAP that was released over a year ago–now it does so much more than that that it is almost like saying Google is just a search engine. Oh well, the traffic generated was good quality.

In other news, version 2.4.25 was released a couple days ago to fix a bug that occurs when submitting a comment using the jQuery library under IE6. I think bugfixes this specific really showcase how mature the plugin has become, so if you have used it in the past, but stopped because of bugs, why not try it again?

If you are upgrading or have ever installed INAP before follow the upgrade instructions here.

Please report bugs as soon as you find them, as I will be making bug-fixing releases as they are fixed.

I am also specifically asking for feature ideas for the next version, so drop a note on the main page if you have any.

The most powerful part of this plugin is the Unicode converter. I was able to go back to one of my older posts that had many Japanese and Chinese characters and convert the entire post to valid Unicode in one click. Go view the post and try switching Character encodings in your browser. Nothing changes if you do. ☺☻ before I converted it if it was viewed in anything other than UTF-8 it was all gobbledy-gook.

Download:

Character Map (with Unicode Encoder) Plugin Version 0.1 or you can download the Unicode Encoder as a separate plugin.

Installation:

1. Save the plugin with the extension .php
2. Upload it to your ‘wp-content/plugins’ directory
3. Activate the plugin named “Character Map” or if you downloaded just the Character Encoder activate it.

Character Map Usage:

• The character map appears directly under content box on your new/edit post page.
• On the right side is a list of the character groups (and the options panel) clicking one of these will update the character map shown.
• It is best to save your posts with entities rather than characters because of the way Unicode and character encodings work. For example, let’s say I have the word Areté if I use an entity it will display correctly on all browsers and web servers (unless they are unable to display the character itself); however, if I were to use the actual character ‘é’ and saved it using my websites default character encoding, it would “lock in” the character to that one encoding. If a user from another country, whose browser used a different encoding, visited they would just see some random characters–specifically: é. However, if I had saved the ‘é’ as an entity it would always display the same way.
• Checking the Safe Mode option will make it so you automatically add the entities to the posts rather than characters. You can easily switch the entities to characters by clicking “Char- > Ent” button. When you are done editing you can switch them back by clicking “Ent -> Chars”
• Under the options panel you can add special characters that will always show by default when you load the edit post/page panel. You can add characters to this as either the actual character σ, as Unicode entities &#963; or as an HTML entity &sigma;, or as just its name (sigma) or number (963). The plugin will automatically convert them to the correct format.
• Sometimes the special characters &, >, and < will not display like entities or characters like the rest of custom charecters in the options panel. You may ignore this because this is done intentionally. No matter the form, the characters will work correctly.

Character Encoder Usage:

• If you use the non-rich text editor you will see two new buttons in your toolbar. These buttons are pretty self explanatory. (“ent” means entity and “char” means character)
• Normal characters (a,%,8,”) will not be converted to entities, and HTML special charecters (&gt;,&lt;,&amp;, >,<,&) will never be converted from one form to another.

Include pages with posts in your stats.

1. Open stattraq.php
2. Find:
   global $doing_rss, $p
   Replace With:
   global $doing_rss, $p, $page_id, $pagename,
3. Find:
   

   if (($p != '')){
   	$p = intval($p);
   	$article_id = $p;
   }

   
   Replace with:
   

   if (($p != '')){
   	$p = intval($p);
   	$article_id = $p;
   }elseif (($page_id != '')){
   	$page_id = intval($page_id);
   	$article_id = $page_id;
   }elseif (($pagename != '')){
    $reqpage = get_page_by_path($pagename);
   	if ( !empty($reqpage) )
   		$article_id = $reqpage->ID;
   }

To add a list of all Pages that link to your site grouped by Website (excluding Google):
Open “wp-stattraq/reporter/summary.php”

Find:

<?php echo PrintTimestamp();?>
			</div>
			<div id="queryTerms">

<table id="referrersTable">
					<thead>
						<tr>
							<th>#</th>
							<th>Referrer</th>
							<th>Pages</th>
						</tr>
					</thead>
					<tfoot>
						<tr>
							<th>#</th>
							<th>Referrer</th>
							<th>Pages</th>
						</tr>
					</tfoot>		
					<tbody>
<?php
if($results){
	$i=0;
	foreach($results as $row){
		preg_match('/(http.*?\:\/\/.*?)(\/.*)/', htmlentities($row->ref), $matches);
		$ref_array[$matches[1]][] = $matches[2];
	}

				
	while( list($site, $pages) = @each($ref_array) ){
		if(strpos($site,'google') ==false && $site != ''){?>

			<tr class="<?php echo ($i % 2 == 0 ? 'even' : 'odd' );?>"><td><?php echo ++$i;?></td>
			<td>
			<a href="<?php echo $site;?>"><?php echo substr($site,0,50);?></a></td>
			<td class="right">

		<?php foreach($pages as $page){?>

			<a href="<?php echo $site.$page;?>"><?php echo substr($page,0,50);?></a><br/>

		<?php}?>


		</td>
		</tr>
<?php 	}
	}
}?>
					</tbody>
				</table>

Please note that these same general techniques work outside of WordPress also; the only thing that you would need to do is to change the way options are actually set. Also, I assume you already know HTML; this is not a basic HTML tutorial, but rather is a way to do a specific task. Some basics are explained, but if you don’t already know the difference between a checkbox and radiobox this isn’t the best place for you to start.

There are rules for the easiest Admin panel.

1. Always name your variables the same ways in the form and the database– there is absolutely no reason to have to change the name’s assign to variables individually. Especially seeing as this tutorial shows you the easiest ways to set all variables, and it requires the names to be the same.
2. Always use arrays for your variables in both the form and database–you don’t want to spend a lot of time in your code pulling individual items from the database and assigning them to names, nor do you want to fill the users database up with a lot of individual options. You can, however, assign individual options to some variable such as $background inside the functions, but it is easiest just to leave all the options in a single array ($my_plugin['background']) that doesn’t change from function to function.
3. Always make your variable names sensible. If you can’t figure out what it does just by looking at the variable name it is useless. EX. If I want to set an option for the background color any of the following would be good names: background_color, back_color, bkgrnd_clr, backgroundcolor. backcolor etc. These names all make sense however if you were to use back, color, bc, monkeys, x, gqyjkl it is difficult to understand or remmeber exactly what it does. Furthermore, obvious meanings in your options make it easier to update the plugin later with more options. For example, if I set the background color with the option named color what will happen when I decide to give a new option for foreground color, border color, and text color? Not only can you net tell immediately which option color sets, but in CSS color means text color not background color. Why not ‘bc’ you may ask, well it is nice to save the shortest abbreviations for other things (as demonstrated in the radio and checkboxes settings), or for inside the actual code.
4. Never use words as the values for individual checkboxes- individual checkboxes are useful for on or off statements, so it is perfectly simple to use the values 1 and 0 for checked and unchecked respectively.
5. Try to use numbers as values for radio boxes whenever possible– sometimes it is too confusing to remember what the difference between 4 and 2 is when it comes to the actual code, so when you have to use strings as the values make them short (use the rules above) but descriptive (ex ‘student’,'teacher’,'admin’,'gen_staff’).
6. Text boxes are for text — don’t expect your user to only input the options you suggest. If you require that one of a few option is selected use a checkbox, radiobox, list or dropdown list, otherwise you will have to perform a check every single time a user inputs a value.
7. Administrative panels are for administrators; because of this, you don’t have to worry about abuse usually. If you give a radio box with the options 1, 2, and 3, you don’t have to check to make sure that only one of those options was selected. However, when using any sort of checks always check for all but one of the possible values (see radio boxes section) and then just use an else statement to default to one.
8. Unless the option with the value 0 is meant as false, don’t start radio boxes from 0– doing this doesn’t make any sense.
9. If your Administration panel is more than a few options long, separate it from the rest of the plugin. Otherwise, the entire thing has to be read into memory every time a page is loaded.

There are a few basic rules that we use in this Admin panel (and our plugin).

1. Globals are our friend. By using global variables we make it very easy to access information from any part of WordPress, and can even allow other plugins to interact with our variables. Globals also allow us to get the information only a single time from the database and then reuse it over and over
   again. Just as a reminder globals should be named uniquely. It may make sense for your plugin to use the global $post, but if you do so neither WordPress or your plugin will work as expected.
2. This Admin panel uses one global array to store all of the options ($mypluginall) and one array for for the options when submitted (myplugin).

Of course we need to tell the plugin that there is an Admin panel. The following is just an example, if you would like to learn what it all means, then please visit the WordPress Codex page dedicated to it.

add_action('admin_menu', 'myplguin_menu');

function myplugin_menu() {
	// Add a submenu to the Dashboard:
	add_submenu_page('post.php', 'My Plugin Managment', 'My Plugin Managment', 8, 'myplugin/myplugin_admin.php');
}

Before we create any options we should create the function that sets them (this way we can test it as we go along). The following function I developed makes it very easy to update the options. There really isn’t much to explain, but by taking advantage of the rules above, it takes an array of values and their names (keys), and translates it into the options for the plugin. We could have this as part of the admin panel, but ti is much clearner if we seperate it. I’m not going to go to in depth into how it actually works, but it goes throug hall of the values ($options) we passed to it (the new options) finds the name of the option ($option) and its corresponding value ($value). it then adds these same names and values to our global array of variables. This is the reason why we have the same names in our form and our database. If we didn’t, we would have to specifically set map each form option to the database option (cat to dog, background_color to back_color etc). The entire array is a global so it automatically updates the options before they go into the database.

function myplugin_update_options($options){
global $mypluginall;
//This is the section where we add individual rules to single options (see checkbox part.)

// End that section.
	while (list($option, $value) = each($options)) {
// this line here just fixes individual server bugs.
// If our user has magic quotes turned on and then wordpress tries to add slashes to it we will have everything double slashed.
		if( get_magic_quotes_gpc() ) { 
		$value = stripslashes($value);
		}
		$mypluginall[$option] =$value;
	}
return $mypluginall;
}

This part goes at the top of our administration page. It checks if we just set some options (line 1), then passes the new options on to our function above for processing (line 2), and finally updates the options in the database. Because we were smart and used a global array for our values, we can continue loading the form without pulling the new values out of the database again.

if ($_POST["action"] == "saveconfiguration") {
			$mypluginall = myplugin_update_options($_REQUEST['myplugin']);
			update_option('myplugin',$mypluginall);
			$message .= 'My Plugin Options have Been Updated.<br/>';

		//$mypluginall doesn't need to be updated because it has the new values added to it immediately

	echo '<div class="updated"><p><strong> Updated <br/> '.$message;
	echo '</strong></p></div>';
}

Now for some things we will need to set default values, or process the values in some way before the form sees them. In these cases we would add them before the form, but after the update option function.

This section is the panel itself. It doesn’t require much explanation because it is just a basic form, but this is where we will put the actual inputs.

echo <<<block
	echo '<div class="wrap"><fieldset class="manage" style="width:100%; text-align:center;">';
	echo '<form method="post">';
	echo '<table width="90%">';
	<tr>
		<td colspan="2"><strong>Edit My Plugin Configutarion</strong></td>
	</tr>

	<tr>
		<td colspan="2"><p><strong>Post Options</strong></p></td>
	</tr>
block;

// Inside this block add all of your options.
echo <<<block



block;
	
	echo '	</table>
			<input type="hidden" name="action" value="saveconfiguration">
			<input type="submit" value="Save">
		</form>
	</fieldset>';

Setting Default Options

Code to use for checkboxes, radioboxes, textareas, selectboxes and text boxes.

To add a TextBox:

1. The text box is the easiest of all the HTML inputs: (this one is named ‘title_text’)
   

   <tr>
   	<td>My plugins title text:</td>
   	<td><input type="text" value="$mypluginall[title_text]" name="myplugin[title_text]"></td>
   </tr>

2. Because a user might use a quote (‘) or double quote(“) we need to add the following text to the ‘set options’ portion of the admin panel. This code makes whatever the default value be valid HTMl that won’t break our plugin by encoding HTML special characters like &, <, $gt; etc.
   $mypluginall['title_text'] = stripslashes(htmlspecialchars($mypluginall['title_text'],ENT_QUOTES));

To add a single checkbox: (best for on or off options)

1. We first add a checkbox to the admin panel table with the name “say_yes”.
   

   <tr>
   		<td>Would you like me to say yes?:</td>
   		<td><input type="checkbox" value="1" $sy name="myplugin[say_yes]"></td>
   	</tr>

   
   Did you notice the $sy inside the input? In basic HTML to check a checkbox we have to add the attribute checked=’checked’, but if we don’t want it checked we can’t add this input. If we were to leave the attribute checked=”checked” out the cjkebox would always be blank no matter what option was selected, but this is bad for usability. So to set the default option we do the following:.
2. Because the initial value of the checkbox isn’t as simple to set a textbox, we then add the following in the ‘set options’ section of the admin panel. Notice that we set the variable $sy to be ‘checked=”checked”‘. As said above this is how we tell the browser that this option should be selected by default. The best thing about this is if the option isn’t checked (does not evaluate to 1) the $sy is just empty which means the checkbox isn’t checked . The name $sy does not mean anything it could just as easily be named $the_monkey, but t makes it a lot easier because it is just an abbreviation of the option name “say_yes’.
   

   if($mypluginall['say_yes'] == 1){ $sy = 'checked="checked"'; }

3. The checkbox is unique because of the way it sends its data. If the checkbox is selected it sends data, but if it isn’t selected it doesn’t send anything. This can cause a problem when we are updating the options if you don’t check if the option is set first. To fix this behavior we just add the following to the update options function.
   

   if(!$options['say_yes']){$options['say_yes'] = 0; }

To add multiple radioboxes:

1. We first add the radioboxes to the admin panel table with the name “fav_num”.
   

   <tr>
   		<td>Which of these is your favorite Number </td>
   		<td>
   <label>My Favorite Number is one :<input type="radio" value="1" $fn1 name="inap[fav_num]"/></label><br/> 
   <label>My Favorite Number is two :<input type="radio" value ="2" $fn2 name="inap[fav_num]"/></label> <br/>
   <label>My Favorite Number is three :<input type="radio" value ="3" $fn3 name="inapfav_num]"/></label>
                </td>
   	</tr>

   
   Did you notice the $fn1,$fn2, $fn3 inside the input? This is done for the same reason as $sy is done above. As with checkboxes the In basic HTML the attribute checked=’checked’ means that that raadio box is the defaut. So to set the default option we do the following:.
2. Because there is are more than one possible initial value for this radiobox (1, 2 or 3) , we have to use a larger statement to decide which one is set. As above we then assign the attribute checked=”checked” to one of the three variables and leave the other two blank.
   

   if($mypluginall['fav_num'] == '3'){
   		$fn3 = 'checked="checked"'; 
   	}elseif($mypluginall['fav_num'] == '2'){
   		$fn2 = 'checked="checked"'; 
   	}else{
   		$fn = 'checked="checked"'; 
   	}

   
   You will notice two things about the above example: the numbers count down and option one is the default. Both are by personal taste. I always have option one be the default so it makes more sense to look for the others first (and coujnting 3,2,1 makes more sense then 2,3,1), so that way if the other values are not found it defaults to one automatically. However, it doesn’t matter which order you do it it in as long as the default value comes last and is not specifically checked for.
3. Because we always set a default value there is always some value sent with a radio box (unless the user specifically tries not to), so we don’t need to add a check as we did in step three of the checkbox.

The Text Area

1. The text are is basically the same as the textbox, but it allows multiple lines of data (this one is named list)
   

   <tr>
   	<td>List of my favorite things:</td>
   	<td><textarea  name="myplugin[favthings]>$mypluginall[favthings]</textarea></td>
   </tr>

   
   Notice that the textarea uses a different format for its input. Specifically, it does not start with input and its default value goes between two tags rather than in a attribute named value.
2. For the same reasons as the textbox we add the following in the set options section of the Admin panel.
   $mypluginall['title_text'] = stripslashes(htmlspecialchars($mypluginall['title_text'],ENT_QUOTES));

The Select Box

1. The select or drop down box is the single best argument for using descriptive names. This is because we can either just add an extra option to it to set the current value, or we can do a loop, and check each option individually before we set them. The latter is a complete waste of coding time and memory and you will have to define an array of possible values etc etc, so I prefer to just add a default option. This is named ‘fav_color’
   

   <tr>
   	<td>What is your Favorite Color:</td>
   	<td><select name="myplugin[fav_color]">
   		 $fc
   		<option value="red">Red</option>
   		<option value="orange_red">Orange Red</option>
   		<option value="orange">Orange</option>
   		</select></td>
   </tr>

   
   as you can see the values are fairly attractive, with a little manipulation the values can also be used as the displayed text. $fav_color will be our default value.
2. You get the drill, the following is added to the set options section of the Admin panel. However, we do a few manipulations to the name to make it look good.
   

   if($mypluginall['fav_color'] != ''){
   	$fc = '<option selected="selected" value="'.$mypluginall['fav_color'].'">'.ucwords(str_replace('-',' ',$mypluginall[fav_color])).'</option>';
   }

   
   No matter what value is set we a re going to have a duplicate value, so the least we can do is make it look nice, but this part is optional. The str_replace removes any underscores in the values and males it a space and then the ucwords makes the first letter of each word uppercase to make it match the preset values–we could also use ucfirst to make only the first letter an uppercase.

That is pretty much it. As a final note this administration panel isn’t perfect, but ti will make your life a lot easier. Before developing this system it was extremely irritating to add even a single option. I wouldn’t do it unless I had no other choice, but now it literally takes a few seconds to add 3 or 4 new options by using the same templates and just changing their names and descriptions.