A HitchHackers guide through WordPress

wp_import_upload_form

February 12, 2011 by Thorsten 0 Comments

Definition:
function wp_import_upload_form( $action ) {}

Outputs the form used by the importers to accept the data to be imported

Parameters

string $action: The action attribute for the form.

Defined filters

import_upload_size_limit
apply_filters( 'import_upload_size_limit', wp_max_upload_size()

Source code

function wp_import_upload_form( $action ) {

	$bytes = apply_filters( 'import_upload_size_limit', wp_max_upload_size() );

	$size = wp_convert_bytes_to_hr( $bytes );

	$upload_dir = wp_upload_dir();

	if ( ! empty( $upload_dir['error'] ) ) :

		?><div class="error"><p><?php _e('Before you can upload your import file, you will need to fix the following error:'); ?></p>

		<p><strong><?php echo $upload_dir['error']; ?></strong></p></div><?php

	else :

?>

<form enctype="multipart/form-data" id="import-upload-form" method="post" action="<?php echo esc_attr(wp_nonce_url($action, 'import-upload')); ?>">

<p>

<label for="upload"><?php _e( 'Choose a file from your computer:' ); ?></label> (<?php printf( __('Maximum size: %s' ), $size ); ?>)

<input type="file" id="upload" name="import" size="25" />

<input type="hidden" name="action" value="save" />

<input type="hidden" name="max_file_size" value="<?php echo $bytes; ?>" />

</p>

<?php submit_button( __('Upload file and import'), 'button' ); ?>

</form>

<?php

	endif;

}

3779

/wp-admin/includes/template.php, Documentation, Files, Filters, Filters by letter i, Functions, Functions by letter w

id257eec3efe6bb0f47cfdfab81d9ad1b3, import_upload_size_limit, wp_import_upload_form

wp_import_handle_upload

February 12, 2011 by Thorsten 0 Comments

Definition:
function wp_import_handle_upload() {}

Handle importer uploading and add attachment.

Return values

returns:Uploaded file’s details on success, error message on failure

Source code

function wp_import_handle_upload() {

	if ( !isset($_FILES['import']) ) {

		$file['error'] = __( 'File is empty. Please upload something more substantial. This error could also be caused by uploads being disabled in your php.ini or by post_max_size being defined as smaller than upload_max_filesize in php.ini.' );

		return $file;

	}



	$overrides = array( 'test_form' => false, 'test_type' => false );

	$_FILES['import']['name'] .= '.txt';

	$file = wp_handle_upload( $_FILES['import'], $overrides );



	if ( isset( $file['error'] ) )

		return $file;



	$url = $file['url'];

	$type = $file['type'];

	$file = $file['file'];

	$filename = basename( $file );



	// Construct the object array

	$object = array( 'post_title' => $filename,

		'post_content' => $url,

		'post_mime_type' => $type,

		'guid' => $url,

		'context' => 'import',

		'post_status' => 'private'

	);



	// Save the data

	$id = wp_insert_attachment( $object, $file );



	// schedule a cleanup for one day from now in case of failed import or missing wp_import_cleanup() call

	wp_schedule_single_event( time() + 86400, 'importer_scheduled_cleanup', array( $id ) );



	return array( 'file' => $file, 'id' => $id );

}

3777

/wp-admin/includes/import.php, Documentation, Files, Functions, Functions by letter w

idcb1b74b1c3ec5d2436415b5a0f4f6195, wp_import_handle_upload

wp_import_cleanup

February 12, 2011 by Thorsten 0 Comments

Definition:
function wp_import_cleanup( $id ) {}

Cleanup importer.

Removes attachment based on ID.

Parameters

string $id: Importer ID.

Source code

function wp_import_cleanup( $id ) {

	wp_delete_attachment( $id );

}

3775

/wp-admin/includes/import.php, Documentation, Files, Functions, Functions by letter w

idca4a1907650ab6b5a9956a0109b37112, wp_import_cleanup

wp_image_editor

February 12, 2011 by Thorsten 0 Comments

Definition:
function wp_image_editor($post_id, $msg = false) {}

WordPress Image Editor

Parameters

$post_id
$msg

Source code

function wp_image_editor($post_id, $msg = false) {

	$nonce = wp_create_nonce("image_editor-$post_id");

	$meta = wp_get_attachment_metadata($post_id);

	$thumb = image_get_intermediate_size($post_id, 'thumbnail');

	$sub_sizes = isset($meta['sizes']) && is_array($meta['sizes']);

	$note = '';



	if ( is_array($meta) && isset($meta['width']) )

		$big = max( $meta['width'], $meta['height'] );

	else

		die( __('Image data does not exist. Please re-upload the image.') );



	$sizer = $big > 400 ? 400 / $big : 1;



	$backup_sizes = get_post_meta( $post_id, '_wp_attachment_backup_sizes', true );

	$can_restore = !empty($backup_sizes) && isset($backup_sizes['full-orig'])

		&& $backup_sizes['full-orig']['file'] != basename($meta['file']);



	if ( $msg ) {

		if ( isset($msg->error) )

			$note = "<div class='error'><p>$msg->error</p></div>";

		elseif ( isset($msg->msg) )

			$note = "<div class='updated'><p>$msg->msg</p></div>";

	}



	?>

	<div class="imgedit-wrap">

	<?php echo $note; ?>

	<table id="imgedit-panel-<?php echo $post_id; ?>"><tbody>

	<tr><td>

	<div class="imgedit-menu">

		<div onclick="imageEdit.crop(<?php echo "$post_id, '$nonce'"; ?>, this)" class="imgedit-crop disabled" title="<?php esc_attr_e( 'Crop' ); ?>"></div><?php



	// On some setups GD library does not provide imagerotate() - Ticket #11536

	if ( function_exists('imagerotate') ) { ?>

		<div class="imgedit-rleft"  onclick="imageEdit.rotate( 90, <?php echo "$post_id, '$nonce'"; ?>, this)" title="<?php esc_attr_e( 'Rotate counter-clockwise' ); ?>"></div>

		<div class="imgedit-rright" onclick="imageEdit.rotate(-90, <?php echo "$post_id, '$nonce'"; ?>, this)" title="<?php esc_attr_e( 'Rotate clockwise' ); ?>"></div>

<?php } else {

		$note_gdlib = esc_attr__('Image rotation is not supported by your web host (function imagerotate() is missing)');

?>

	    <div class="imgedit-rleft disabled"  title="<?php echo $note_gdlib; ?>"></div>

	    <div class="imgedit-rright disabled" title="<?php echo $note_gdlib; ?>"></div>

<?php } ?>



		<div onclick="imageEdit.flip(1, <?php echo "$post_id, '$nonce'"; ?>, this)" class="imgedit-flipv" title="<?php esc_attr_e( 'Flip vertically' ); ?>"></div>

		<div onclick="imageEdit.flip(2, <?php echo "$post_id, '$nonce'"; ?>, this)" class="imgedit-fliph" title="<?php esc_attr_e( 'Flip horizontally' ); ?>"></div>



		<div id="image-undo-<?php echo $post_id; ?>" onclick="imageEdit.undo(<?php echo "$post_id, '$nonce'"; ?>, this)" class="imgedit-undo disabled" title="<?php esc_attr_e( 'Undo' ); ?>"></div>

		<div id="image-redo-<?php echo $post_id; ?>" onclick="imageEdit.redo(<?php echo "$post_id, '$nonce'"; ?>, this)" class="imgedit-redo disabled" title="<?php esc_attr_e( 'Redo' ); ?>"></div>

		<br class="clear" />

	</div>



	<input type="hidden" id="imgedit-sizer-<?php echo $post_id; ?>" value="<?php echo $sizer; ?>" />

	<input type="hidden" id="imgedit-minthumb-<?php echo $post_id; ?>" value="<?php echo ( get_option('thumbnail_size_w') . ':' . get_option('thumbnail_size_h') ); ?>" />

	<input type="hidden" id="imgedit-history-<?php echo $post_id; ?>" value="" />

	<input type="hidden" id="imgedit-undone-<?php echo $post_id; ?>" value="0" />

	<input type="hidden" id="imgedit-selection-<?php echo $post_id; ?>" value="" />

	<input type="hidden" id="imgedit-x-<?php echo $post_id; ?>" value="<?php echo $meta['width']; ?>" />

	<input type="hidden" id="imgedit-y-<?php echo $post_id; ?>" value="<?php echo $meta['height']; ?>" />



	<div id="imgedit-crop-<?php echo $post_id; ?>" class="imgedit-crop-wrap">

	<img id="image-preview-<?php echo $post_id; ?>" onload="imageEdit.imgLoaded('<?php echo $post_id; ?>')" src="<?php echo admin_url('admin-ajax.php'); ?>?action=imgedit-preview&amp;_ajax_nonce=<?php echo $nonce; ?>&amp;postid=<?php echo $post_id; ?>&amp;rand=<?php echo rand(1, 99999); ?>" />

	</div>



	<div class="imgedit-submit">

		<input type="button" onclick="imageEdit.close(<?php echo $post_id; ?>, 1)" class="button" value="<?php esc_attr_e( 'Cancel' ); ?>" />

		<input type="button" onclick="imageEdit.save(<?php echo "$post_id, '$nonce'"; ?>)" disabled="disabled" class="button-primary imgedit-submit-btn" value="<?php esc_attr_e( 'Save' ); ?>" />

	</div>

	</td>



	<td class="imgedit-settings">

	<div class="imgedit-group">

	<div class="imgedit-group-top">

		<a class="imgedit-help-toggle" onclick="imageEdit.toggleHelp(this);return false;" href="#"><strong><?php _e('Scale Image'); ?></strong></a>

		<div class="imgedit-help">

		<p><?php _e('You can proportionally scale the original image. For best results the scaling should be done before performing any other operations on it like crop, rotate, etc. Note that if you make the image larger it may become fuzzy.'); ?></p>

		<p><?php printf( __('Original dimensions %s'), $meta['width'] . '&times;' . $meta['height'] ); ?></p>

		<div class="imgedit-submit">

		<span class="nowrap"><input type="text" id="imgedit-scale-width-<?php echo $post_id; ?>" onkeyup="imageEdit.scaleChanged(<?php echo $post_id; ?>, 1)" onblur="imageEdit.scaleChanged(<?php echo $post_id; ?>, 1)" style="width:4em;" value="<?php echo $meta['width']; ?>" />&times;<input type="text" id="imgedit-scale-height-<?php echo $post_id; ?>" onkeyup="imageEdit.scaleChanged(<?php echo $post_id; ?>, 0)" onblur="imageEdit.scaleChanged(<?php echo $post_id; ?>, 0)" style="width:4em;" value="<?php echo $meta['height']; ?>" />

		<span class="imgedit-scale-warn" id="imgedit-scale-warn-<?php echo $post_id; ?>">!</span></span>

		<input type="button" onclick="imageEdit.action(<?php echo "$post_id, '$nonce'"; ?>, 'scale')" class="button-primary" value="<?php esc_attr_e( 'Scale' ); ?>" />

		</div>

		</div>

	</div>



<?php if ( $can_restore ) { ?>



	<div class="imgedit-group-top">

		<a class="imgedit-help-toggle" onclick="imageEdit.toggleHelp(this);return false;" href="#"><strong><?php _e('Restore Original Image'); ?></strong></a>

		<div class="imgedit-help">

		<p><?php _e('Discard any changes and restore the original image.');



		if ( !defined('IMAGE_EDIT_OVERWRITE') || !IMAGE_EDIT_OVERWRITE )

			echo ' '.__('Previously edited copies of the image will not be deleted.');



		?></p>

		<div class="imgedit-submit">

		<input type="button" onclick="imageEdit.action(<?php echo "$post_id, '$nonce'"; ?>, 'restore')" class="button-primary" value="<?php esc_attr_e( 'Restore image' ); ?>" <?php echo $can_restore; ?> />

		</div>

		</div>

	</div>



<?php } ?>



	</div>



	<div class="imgedit-group">

	<div class="imgedit-group-top">

		<strong><?php _e('Image Crop'); ?></strong>

		<a class="imgedit-help-toggle" onclick="imageEdit.toggleHelp(this);return false;" href="#"><?php _e('(help)'); ?></a>

		<div class="imgedit-help">

		<p><?php _e('The image can be cropped by clicking on it and dragging to select the desired part. While dragging the dimensions of the selection are displayed below.'); ?></p>

		<strong><?php _e('Keyboard Shortcuts'); ?></strong>

		<ul>

		<li><?php _e('Arrow: move by 10px'); ?></li>

		<li><?php _e('Shift + arrow: move by 1px'); ?></li>

		<li><?php _e('Ctrl + arrow: resize by 10px'); ?></li>

		<li><?php _e('Ctrl + Shift + arrow: resize by 1px'); ?></li>

		<li><?php _e('Shift + drag: lock aspect ratio'); ?></li>

		</ul>



		<p><strong><?php _e('Crop Aspect Ratio'); ?></strong><br />

		<?php _e('You can specify the crop selection aspect ratio then hold down the Shift key while dragging to lock it. The values can be 1:1 (square), 4:3, 16:9, etc. If there is a selection, specifying aspect ratio will set it immediately.'); ?></p>



		<p><strong><?php _e('Crop Selection'); ?></strong><br />

		<?php _e('Once started, the selection can be adjusted by entering new values (in pixels). Note that these values are scaled to approximately match the original image dimensions. The minimum selection size equals the thumbnail size as set in the Media settings.'); ?></p>

		</div>

	</div>



	<p>

		<?php _e('Aspect ratio:'); ?>

		<span  class="nowrap">

		<input type="text" id="imgedit-crop-width-<?php echo $post_id; ?>" onkeyup="imageEdit.setRatioSelection(<?php echo $post_id; ?>, 0, this)" style="width:3em;" />

		:

		<input type="text" id="imgedit-crop-height-<?php echo $post_id; ?>" onkeyup="imageEdit.setRatioSelection(<?php echo $post_id; ?>, 1, this)" style="width:3em;" />

		</span>

	</p>



	<p id="imgedit-crop-sel-<?php echo $post_id; ?>">

		<?php _e('Selection:'); ?>

		<span  class="nowrap">

		<input type="text" id="imgedit-sel-width-<?php echo $post_id; ?>" onkeyup="imageEdit.setNumSelection(<?php echo $post_id; ?>)" style="width:4em;" />

		:

		<input type="text" id="imgedit-sel-height-<?php echo $post_id; ?>" onkeyup="imageEdit.setNumSelection(<?php echo $post_id; ?>)" style="width:4em;" />

		</span>

	</p>

	</div>



	<?php if ( $thumb && $sub_sizes ) {

		$thumb_img = wp_constrain_dimensions( $thumb['width'], $thumb['height'], 160, 120 );

	?>



	<div class="imgedit-group imgedit-applyto">

	<div class="imgedit-group-top">

		<strong><?php _e('Thumbnail Settings'); ?></strong>

		<a class="imgedit-help-toggle" onclick="imageEdit.toggleHelp(this);return false;" href="#"><?php _e('(help)'); ?></a>

		<p class="imgedit-help"><?php _e('The thumbnail image can be cropped differently. For example it can be square or contain only a portion of the original image to showcase it better. Here you can select whether to apply changes to all image sizes or make the thumbnail different.'); ?></p>

	</div>



	<p>

		<img src="<?php echo $thumb['url']; ?>" width="<?php echo $thumb_img[0]; ?>" height="<?php echo $thumb_img[1]; ?>" class="imgedit-size-preview" alt="" /><br /><?php _e('Current thumbnail'); ?>

	</p>



	<p id="imgedit-save-target-<?php echo $post_id; ?>">

		<strong><?php _e('Apply changes to:'); ?></strong><br />



		<label class="imgedit-label">

		<input type="radio" name="imgedit-target-<?php echo $post_id; ?>" value="all" checked="checked" />

		<?php _e('All image sizes'); ?></label>



		<label class="imgedit-label">

		<input type="radio" name="imgedit-target-<?php echo $post_id; ?>" value="thumbnail" />

		<?php _e('Thumbnail'); ?></label>



		<label class="imgedit-label">

		<input type="radio" name="imgedit-target-<?php echo $post_id; ?>" value="nothumb" />

		<?php _e('All sizes except thumbnail'); ?></label>

	</p>

	</div>



	<?php } ?>



	</td></tr>

	</tbody></table>

	<div class="imgedit-wait" id="imgedit-wait-<?php echo $post_id; ?>"></div>

	<script type="text/javascript">imageEdit.init(<?php echo $post_id; ?>);</script>

	<div class="hidden" id="imgedit-leaving-<?php echo $post_id; ?>"><?php _e("There are unsaved changes that will be lost.  'OK' to continue, 'Cancel' to return to the Image Editor."); ?></div>

	</div>

<?php

}

3773

/wp-admin/includes/image-edit.php, Documentation, Files, Functions, Functions by letter w

id7982106d941c10a9b413fd34f13b62dc, wp_image_editor

wp_imagecreatetruecolor

February 12, 2011 by Thorsten 0 Comments

Definition:
function wp_imagecreatetruecolor($width, $height) {}

Create new GD image resource with transparency support

Parameters

int $width: Image width
int $height: Image height

Return values

returns:resource

Source code

function wp_imagecreatetruecolor($width, $height) {

	$img = imagecreatetruecolor($width, $height);

	if ( is_resource($img) && function_exists('imagealphablending') && function_exists('imagesavealpha') ) {

		imagealphablending($img, false);

		imagesavealpha($img, true);

	}

	return $img;

}

3771

/wp-includes/media.php, Documentation, Files, Functions, Functions by letter w

id363d45cdae6319edb0116a8b1f43ea00, wp_imagecreatetruecolor

Newer Entries

Older Entries

Ouch, we don’t have this here!

It seems that we do not have anything about this topic here, but you might want to do one of the following. If you were searching for a php function head over to the php manual and use one of their entry points

If you were searching for a WordPress related topic and did not find it here try one of the following options.

Use the search form in the navigation bar above
Use the WordPress search

If nothing like this helps try using Google or an other search engine

Google
Bing

Golden Q&A rules

Search first

Be sure that you first search in Google, the WordPress forums, Codex or this site ( using the form in the menu ). Sharing your previous results helps narrowing down the problem if you also tell us what you found and why it didn’t serve your needs.

Be specific

Give as much details about your problem as possible. Make sure to include examples, links and context related to your problem.

Be WordPress related

This site focuses on WordPress and related topics. Please make sure that your question is related to WordPress code, functionality or other related topics.

Be nice

Please keep in mind that this is a voluntary service. Answers might not always be correct or what you expect. Please be nice and let us know if any inappropriate answers come to your attention.