A HitchHackers guide through WordPress

maybe_create_table

February 12, 2011 by Thorsten 0 Comments

Definition:
function maybe_create_table($table_name, $create_ddl) {}

Create database table, if it doesn’t already exist.

Parameters

string $table_name: Database table name.
string $create_ddl: Create database table SQL.

Return values

returns:False on error, true if already exists or success.

Source code

function maybe_create_table($table_name, $create_ddl) {

	global $wpdb;

	foreach ($wpdb->get_col("SHOW TABLES",0) as $table ) {

		if ($table == $table_name) {

			return true;

		}

	}

	//didn't find it try to create it.

	$wpdb->query($create_ddl);

	// we cannot directly tell that whether this succeeded!

	foreach ($wpdb->get_col("SHOW TABLES",0) as $table ) {

		if ($table == $table_name) {

			return true;

		}

	}

	return false;

}

2329

/wp-admin/install-helper.php, Documentation, Files, Functions, Functions by letter m

id69b4adc69e93072f4307929e578a2c32, maybe_create_table

maybe_add_existing_user_to_blog

February 12, 2011 by Thorsten 0 Comments

Definition:
function maybe_add_existing_user_to_blog() {}

Add a new user to a blog by visiting /newbloguser/username/.

This will only work when the user’s details are saved as an option keyed as ‘new_user_x’, where ‘x’ is the username of the user to be added, as when a user is invited through the regular WP Add User interface.

Source code

function maybe_add_existing_user_to_blog() {

	if ( false === strpos( $_SERVER[ 'REQUEST_URI' ], '/newbloguser/' ) )

		return false;



	$parts = explode( '/', $_SERVER[ 'REQUEST_URI' ] );

	$key = array_pop( $parts );



	if ( $key == '' )

		$key = array_pop( $parts );



	$details = get_option( 'new_user_' . $key );

	if ( !empty( $details ) )

		delete_option( 'new_user_' . $key );



	if ( empty( $details ) || is_wp_error( add_existing_user_to_blog( $details ) ) )

		wp_die( sprintf(__('An error occurred adding you to this site. Back to the <a href="%s">homepage</a>.'), site_url() ) );



	wp_die( sprintf(__('You have been added to this site. Please visit the <a href="%s">homepage</a> or <a href="%s">log in</a> using your username and password.'), site_url(), admin_url() ), __('Success') );

}

2327

/wp-includes/ms-functions.php, Documentation, Files, Functions, Functions by letter m

codex, id914eea71f815ea453d1a1aa1385fdfbd, maybe_add_existing_user_to_blog

maybe_add_column

February 12, 2011 by Thorsten 0 Comments

Definition:
function maybe_add_column($table_name, $column_name, $create_ddl) {}

Add column to database table, if column doesn’t already exist in table.

Parameters

string $table_name: Database table name
string $column_name: Table column name
string $create_ddl: SQL to add column to table.

Return values

returns:False on failure. True, if already exists or was successful.

Source code

function maybe_add_column($table_name, $column_name, $create_ddl) {

	global $wpdb, $debug;

	foreach ($wpdb->get_col("DESC $table_name",0) as $column ) {

		if ($debug) echo("checking $column == $column_name<br />");



		if ($column == $column_name) {

			return true;

		}

	}

	//didn't find it try to create it.

	$wpdb->query($create_ddl);

	// we cannot directly tell that whether this succeeded!

	foreach ($wpdb->get_col("DESC $table_name",0) as $column ) {

		if ($column == $column_name) {

			return true;

		}

	}

	return false;

}

2325

/wp-admin/install-helper.php, Documentation, Files, Functions, Functions by letter m

id60fd8cac9938fd845a9de4aadbf8dbf0, maybe_add_column

map_meta_cap

February 12, 2011 by Thorsten 0 Comments

Definition:
function map_meta_cap( $cap, $user_id ) {}

Map meta capabilities to primitive capabilities.

This does not actually compare whether the user ID has the actual capability, just what the capability or capabilities are. Meta capability list value can be ‘delete_user’, ‘edit_user’, ‘remove_user’, ‘promote_user’, ‘delete_post’, ‘delete_page’, ‘edit_post’, ‘edit_page’, ‘read_post’, or ‘read_page’.

Parameters

string $cap: Capability name.
int $user_id: User ID.

Return values

returns:Actual capabilities for meta capability.

Defined filters

auth_post_meta_{$meta_key}
apply_filters( "auth_post_meta_{$meta_key}", false, $meta_key, $post->ID, $user_id, $cap, $caps )

Source code

function map_meta_cap( $cap, $user_id ) {

	$args = array_slice( func_get_args(), 2 );

	$caps = array();



	switch ( $cap ) {

	case 'remove_user':

		$caps[] = 'remove_users';

		break;

	case 'promote_user':

		$caps[] = 'promote_users';

		break;

	case 'edit_user':

		// Allow user to edit itself

		if ( isset( $args[0] ) && $user_id == $args[0] )

			break;

		// Fall through

	case 'edit_users':

		// If multisite these caps are allowed only for super admins.

		if ( is_multisite() && !is_super_admin( $user_id ) )

			$caps[] = 'do_not_allow';

		else

			$caps[] = 'edit_users'; // Explicit due to primitive fall through

		break;

	case 'delete_post':

	case 'delete_page':

		$author_data = get_userdata( $user_id );

		$post = get_post( $args[0] );



		if ( 'revision' == $post->post_type ) {

			$post = get_post( $post->post_parent );

		}



		$post_type = get_post_type_object( $post->post_type );



		if ( ! $post_type->map_meta_cap ) {

			$caps[] = $post_type->cap->$cap;

			// Prior to 3.1 we would re-call map_meta_cap here.

			if ( 'delete_post' == $cap )

				$cap = $post_type->cap->$cap;

			break;

		}



		if ( '' != $post->post_author ) {

			$post_author_data = get_userdata( $post->post_author );

		} else {

			// No author set yet, so default to current user for cap checks.

			$post_author_data = $author_data;

		}



		// If the user is the author...

		if ( is_object( $post_author_data ) && $user_id == $post_author_data->ID ) {

			// If the post is published...

			if ( 'publish' == $post->post_status ) {

				$caps[] = $post_type->cap->delete_published_posts;

			} elseif ( 'trash' == $post->post_status ) {

				if ('publish' == get_post_meta($post->ID, '_wp_trash_meta_status', true) )

					$caps[] = $post_type->cap->delete_published_posts;

			} else {

				// If the post is draft...

				$caps[] = $post_type->cap->delete_posts;

			}

		} else {

			// The user is trying to edit someone else's post.

			$caps[] = $post_type->cap->delete_others_posts;

			// The post is published, extra cap required.

			if ( 'publish' == $post->post_status )

				$caps[] = $post_type->cap->delete_published_posts;

			elseif ( 'private' == $post->post_status )

				$caps[] = $post_type->cap->delete_private_posts;

		}

		break;

		// edit_post breaks down to edit_posts, edit_published_posts, or

		// edit_others_posts

	case 'edit_post':

	case 'edit_page':

		$author_data = get_userdata( $user_id );

		$post = get_post( $args[0] );



		if ( 'revision' == $post->post_type ) {

			$post = get_post( $post->post_parent );

		}



		$post_type = get_post_type_object( $post->post_type );



		if ( ! $post_type->map_meta_cap ) {

			$caps[] = $post_type->cap->$cap;

			// Prior to 3.1 we would re-call map_meta_cap here.

			if ( 'edit_post' == $cap )

				$cap = $post_type->cap->$cap;

			break;

		}



		if ( '' != $post->post_author ) {

			$post_author_data = get_userdata( $post->post_author );

		} else {

			// No author set yet, so default to current user for cap checks.

			$post_author_data = $author_data;

		}



		//echo "current user id : $user_id, post author id: " . $post_author_data->ID . "<br />";

		// If the user is the author...

		if ( is_object( $post_author_data ) && $user_id == $post_author_data->ID ) {

			// If the post is published...

			if ( 'publish' == $post->post_status ) {

				$caps[] = $post_type->cap->edit_published_posts;

			} elseif ( 'trash' == $post->post_status ) {

				if ('publish' == get_post_meta($post->ID, '_wp_trash_meta_status', true) )

					$caps[] = $post_type->cap->edit_published_posts;

			} else {

				// If the post is draft...

				$caps[] = $post_type->cap->edit_posts;

			}

		} else {

			// The user is trying to edit someone else's post.

			$caps[] = $post_type->cap->edit_others_posts;

			// The post is published, extra cap required.

			if ( 'publish' == $post->post_status )

				$caps[] = $post_type->cap->edit_published_posts;

			elseif ( 'private' == $post->post_status )

				$caps[] = $post_type->cap->edit_private_posts;

		}

		break;

	case 'read_post':

	case 'read_page':

		$author_data = get_userdata( $user_id );

		$post = get_post( $args[0] );



		if ( 'revision' == $post->post_type ) {

			$post = get_post( $post->post_parent );

		}



		$post_type = get_post_type_object( $post->post_type );



		if ( ! $post_type->map_meta_cap ) {

			$caps[] = $post_type->cap->$cap;

			// Prior to 3.1 we would re-call map_meta_cap here.

			if ( 'read_post' == $cap )

				$cap = $post_type->cap->$cap;

			break;

		}



		if ( 'private' != $post->post_status ) {

			$caps[] = $post_type->cap->read;

			break;

		}



		if ( '' != $post->post_author ) {

			$post_author_data = get_userdata( $post->post_author );

		} else {

			// No author set yet, so default to current user for cap checks.

			$post_author_data = $author_data;

		}



		if ( is_object( $post_author_data ) && $user_id == $post_author_data->ID )

			$caps[] = $post_type->cap->read;

		else

			$caps[] = $post_type->cap->read_private_posts;

		break;

	case 'edit_post_meta':

	case 'delete_post_meta':

	case 'add_post_meta':

		$post = get_post( $args[0] );

		$post_type_object = get_post_type_object( $post->post_type );

		$caps = map_meta_cap( $post_type_object->cap->edit_post, $user_id, $post->ID );



		$meta_key = isset( $args[ 1 ] ) ? $args[ 1 ] : false;



		if ( $meta_key && has_filter( "auth_post_meta_{$meta_key}" ) ) {

			$allowed = apply_filters( "auth_post_meta_{$meta_key}", false, $meta_key, $post->ID, $user_id, $cap, $caps );

			if ( ! $allowed )

				$caps[] = $cap;

		} elseif ( $meta_key && is_protected_meta( $meta_key, 'post' ) ) {

2323

/wp-includes/capabilities.php, Documentation, Files, Filters, Filters by letter a, Functions, Functions by letter m

auth_post_meta_{$meta_key}, codex, idfbdc2f297ca119a02d863de26464b5ee, map_meta_cap

manage_columns_prefs

February 12, 2011 by Thorsten 0 Comments

Definition:
function manage_columns_prefs( $page ) {}

Parameters

unknown_type $page

Source code

function manage_columns_prefs( $page ) {

	$columns = get_column_headers( $page );

	$hidden  = get_hidden_columns( $page );

	$special = array('_title', 'cb', 'comment', 'media', 'name', 'title', 'username');



	foreach ( $columns as $column => $title ) {

		// Can't hide these or they are special

		if ( in_array( $column, $special ) )

			continue;

		if ( empty( $title ) )

			continue;



		if ( 'comments' == $column )

			$title = __( 'Comments' );

		$id = "$column-hide";

		echo '<label for="' . $id . '">';

		echo '<input class="hide-column-tog" name="' . $id . '" type="checkbox" id="' . $id . '" value="' . $column . '"' . (! in_array($column, $hidden) ? ' checked="checked"' : '') . ' />';

		echo "$title</label>\n";

	}

}

2321

/wp-admin/includes/template.php, Documentation, Files, Functions, Functions by letter m

id0c0d55e6086d5fa708f68cb06c2b1011, manage_columns_prefs

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.