A HitchHackers guide through WordPress

delete_plugins

February 11, 2011 by Thorsten 0 Comments

Definition:
function delete_plugins($plugins, $redirect = '' ) {}

Remove directory and files of a plugin for a single or list of plugin(s).

If the plugins parameter list is empty, false will be returned. True when completed.

Parameters

array $plugins: List of plugin
string $redirect: Redirect to page when complete.

Source code

function delete_plugins($plugins, $redirect = '' ) {

	global $wp_filesystem;



	if ( empty($plugins) )

		return false;



	$checked = array();

	foreach( $plugins as $plugin )

		$checked[] = 'checked[]=' . $plugin;



	ob_start();

	$url = wp_nonce_url('plugins.php?action=delete-selected&verify-delete=1&' . implode('&', $checked), 'bulk-plugins');

	if ( false === ($credentials = request_filesystem_credentials($url)) ) {

		$data = ob_get_contents();

		ob_end_clean();

		if ( ! empty($data) ){

			include_once( ABSPATH . 'wp-admin/admin-header.php');

			echo $data;

			include( ABSPATH . 'wp-admin/admin-footer.php');

			exit;

		}

		return;

	}



	if ( ! WP_Filesystem($credentials) ) {

		request_filesystem_credentials($url, '', true); //Failed to connect, Error and request again

		$data = ob_get_contents();

		ob_end_clean();

		if ( ! empty($data) ){

			include_once( ABSPATH . 'wp-admin/admin-header.php');

			echo $data;

			include( ABSPATH . 'wp-admin/admin-footer.php');

			exit;

		}

		return;

	}



	if ( ! is_object($wp_filesystem) )

		return new WP_Error('fs_unavailable', __('Could not access filesystem.'));



	if ( is_wp_error($wp_filesystem->errors) && $wp_filesystem->errors->get_error_code() )

		return new WP_Error('fs_error', __('Filesystem error.'), $wp_filesystem->errors);



	//Get the base plugin folder

	$plugins_dir = $wp_filesystem->wp_plugins_dir();

	if ( empty($plugins_dir) )

		return new WP_Error('fs_no_plugins_dir', __('Unable to locate WordPress Plugin directory.'));



	$plugins_dir = trailingslashit( $plugins_dir );



	$errors = array();



	foreach( $plugins as $plugin_file ) {

		// Run Uninstall hook

		if ( is_uninstallable_plugin( $plugin_file ) )

			uninstall_plugin($plugin_file);



		$this_plugin_dir = trailingslashit( dirname($plugins_dir . $plugin_file) );

		// If plugin is in its own directory, recursively delete the directory.

		if ( strpos($plugin_file, '/') && $this_plugin_dir != $plugins_dir ) //base check on if plugin includes directory separator AND that its not the root plugin folder

			$deleted = $wp_filesystem->delete($this_plugin_dir, true);

		else

			$deleted = $wp_filesystem->delete($plugins_dir . $plugin_file);



		if ( ! $deleted )

			$errors[] = $plugin_file;

	}



	if ( ! empty($errors) )

		return new WP_Error('could_not_remove_plugin', sprintf(__('Could not fully remove the plugin(s) %s.'), implode(', ', $errors)) );



	// Force refresh of plugin update information

	if ( $current = get_site_transient('update_plugins') ) {

		unset( $current->response[ $plugin_file ] );

		set_site_transient('update_plugins', $current);

	}



	return true;

}

804

/wp-admin/includes/plugin.php, Documentation, Files, Functions, Functions by letter d

delete_plugins, idad47aa6efceec6eb6f0645d89111a9da

delete_option

February 11, 2011 by Thorsten 0 Comments

Definition:
function delete_option( $option ) {}

Removes option by name. Prevents removal of protected WordPress options.

Parameters

string $option: Name of option to remove. Expected to not be SQL-escaped.

Return values

returns:True, if option is successfully deleted. False on failure.

Defined actions

delete_option
do_action( 'delete_option', $option );
delete_option_$option
do_action( "delete_option_$option", $option );
deleted_option
do_action( 'deleted_option', $option );

Source code

function delete_option( $option ) {

	global $wpdb;



	wp_protect_special_option( $option );



	// Get the ID, if no ID then return

	$row = $wpdb->get_row( $wpdb->prepare( "SELECT autoload FROM $wpdb->options WHERE option_name = %s", $option ) );

	if ( is_null( $row ) )

		return false;

	do_action( 'delete_option', $option );

	$result = $wpdb->query( $wpdb->prepare( "DELETE FROM $wpdb->options WHERE option_name = %s", $option) );

	if ( ! defined( 'WP_INSTALLING' ) ) {

		if ( 'yes' == $row->autoload ) {

			$alloptions = wp_load_alloptions();

			if ( is_array( $alloptions ) && isset( $alloptions[$option] ) ) {

				unset( $alloptions[$option] );

				wp_cache_set( 'alloptions', $alloptions, 'options' );

			}

		} else {

			wp_cache_delete( $option, 'options' );

		}

	}

	if ( $result ) {

		do_action( "delete_option_$option", $option );

		do_action( 'deleted_option', $option );

		return true;

	}

	return false;

}

802

/wp-includes/functions.php, Actions, Actions by letter d, Documentation, Files, Functions, Functions by letter d

codex, deleted_option, delete_option, delete_option_$option, id861c2cb283df11664fd819003d97df11

delete_metadata

February 11, 2011 by Thorsten 0 Comments

Definition:
function delete_metadata($meta_type, $object_id, $meta_key, $meta_value = '', $delete_all = false) {}

Delete metadata for the specified object.

Parameters

string $meta_type: Type of object metadata is for (e.g., comment, post, or user)
int $object_id: ID of the object metadata is for
string $meta_key: Metadata key
string $meta_value: Optional. Metadata value. If specified, only delete metadata entries with this value. Otherwise, delete all entries with the specified meta_key.
bool $delete_all: Optional, default is false. If true, delete matching metadata entries for all objects, ignoring the specified object_id. Otherwise, only delete matching metadata entries for the specified object_id.

Return values

returns:True on successful delete, false on failure.

Defined filters

delete_{$meta_type}_metadata
apply_filters( "delete_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $delete_all )

Source code

function delete_metadata($meta_type, $object_id, $meta_key, $meta_value = '', $delete_all = false) {

	if ( !$meta_type || !$meta_key )

		return false;



	if ( (!$object_id = absint($object_id)) && !$delete_all )

		return false;



	if ( ! $table = _get_meta_table($meta_type) )

		return false;



	global $wpdb;



	$type_column = esc_sql($meta_type . '_id');

	$id_column = 'user' == $meta_type ? 'umeta_id' : 'meta_id';

	// expected_slashed ($meta_key)

	$meta_key = stripslashes($meta_key);

	$meta_value = stripslashes_deep($meta_value);



	$check = apply_filters( "delete_{$meta_type}_metadata", null, $object_id, $meta_key, $meta_value, $delete_all );

800

/wp-includes/meta.php, Documentation, Files, Filters, Filters by letter d, Functions, Functions by letter d

delete_metadata, delete_{$meta_type}_metadata, ide7d68489c376e68e01132f1af1926d51

delete_meta

February 11, 2011 by Thorsten 0 Comments

Definition:
function delete_meta( $mid ) {}

Parameters

unknown_type $mid

Defined actions

delete_postmeta
do_action( 'delete_postmeta', $mid );
deleted_postmeta
do_action( 'deleted_postmeta', $mid );

Source code

function delete_meta( $mid ) {

	global $wpdb;

	$mid = (int) $mid;



	$post_id = $wpdb->get_var( $wpdb->prepare("SELECT post_id FROM $wpdb->postmeta WHERE meta_id = %d", $mid) );



	do_action( 'delete_postmeta', $mid );

	wp_cache_delete($post_id, 'post_meta');

	$rval = $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->postmeta WHERE meta_id = %d", $mid) );

	do_action( 'deleted_postmeta', $mid );



	return $rval;

}

798

/wp-admin/includes/post.php, Actions, Actions by letter d, Documentation, Files, Functions, Functions by letter d

deleted_postmeta, delete_meta, delete_postmeta, id344d295b8f3f2d54a406d2a7e1039d6e

delete_get_calendar_cache

February 11, 2011 by Thorsten 0 Comments

Definition:
function delete_get_calendar_cache() {}

Purge the cached results of get_calendar.

Source code

function delete_get_calendar_cache() {

	wp_cache_delete( 'get_calendar', 'calendar' );

}

796

/wp-includes/general-template.php, Documentation, Files, Functions, Functions by letter d

codex, delete_get_calendar_cache, id423f86695378470157e6789bdd396355

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.