Docs4dev
Docs
wordpress / latest / functions / wp_slash.html

wp_slash( string|array $value ): string|array

Adds slashes to a string or recursively adds slashes to strings within an array.

Description

This should be used when preparing data for core API that expects slashed data.
This should not be used to escape data going directly into an SQL query.

Parameters

$value string|array Required
String or array of data to slash.

Return

string|array Slashed $value, in the same type as supplied.

Source

File: wp-includes/formatting.php. View all references

function wp_slash( $value ) {
	if ( is_array( $value ) ) {
		$value = array_map( 'wp_slash', $value );
	}

	if ( is_string( $value ) ) {
		return addslashes( $value );
	}

	return $value;
}

Used By

Used By Description
WP_REST_Menu_Items_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

Creates a single post.
WP_REST_Menu_Items_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-menu-items-controller.php

Updates a single nav menu item.
WP_REST_Global_Styles_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-global-styles-controller.php

Updates a single global style config.
WP_REST_Menus_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php

Creates a single term in a taxonomy.
WP_REST_Menus_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-menus-controller.php

Updates a single term from a taxonomy.
wp_filter_global_styles_post() wp-includes/kses.php

Sanitizes global styles user content removing unsafe rules.
WP_REST_Widgets_Controller::save_widget() wp-includes/rest-api/endpoints/class-wp-rest-widgets-controller.php

Saves the widget in the request object.
WP_REST_Templates_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

Updates a single template.
WP_REST_Templates_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-templates-controller.php

Creates a single template.
WP_REST_Application_Passwords_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php

Creates an application password.
WP_REST_Application_Passwords_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php

Updates an application password.
WP_REST_Attachments_Controller::edit_media_item() wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php

Applies edits to a media item and creates a new attachment record.
wp_rel_ugc() wp-includes/formatting.php

Adds rel="nofollow ugc" string to all HTML A elements in content.
WP_REST_Attachments_Controller::insert_attachment() wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php

Inserts the attachment post in the database. Does not update the attachment meta.
WP_REST_Autosaves_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php

Creates, updates or deletes an autosave revision.
WP_REST_Autosaves_Controller::create_post_autosave() wp-includes/rest-api/endpoints/class-wp-rest-autosaves-controller.php

Creates autosave for the specified post.
WP_Customize_Manager::save_changeset_post() wp-includes/class-wp-customize-manager.php

Saves the post for the loaded changeset.
wp_update_custom_css_post() wp-includes/theme.php

Updates the custom_css post for a given theme.
WP_REST_Meta_Fields::delete_meta_value() wp-includes/rest-api/fields/class-wp-rest-meta-fields.php

Deletes a meta value for an object.
WP_REST_Meta_Fields::update_multi_meta_value() wp-includes/rest-api/fields/class-wp-rest-meta-fields.php

Updates multiple meta values for an object.
WP_REST_Meta_Fields::update_meta_value() wp-includes/rest-api/fields/class-wp-rest-meta-fields.php

Updates a meta value for an object.
WP_REST_Users_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

Creates a single user.
WP_REST_Users_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php

Updates a single user.
WP_REST_Terms_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Creates a single term in a taxonomy.
WP_REST_Terms_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php

Updates a single term from a taxonomy.
WP_REST_Posts_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Creates a single post.
WP_REST_Posts_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

Updates a single post.
WP_REST_Comments_Controller::update_item() wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

Updates a comment.
WP_REST_Comments_Controller::create_item() wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php

Creates a comment.
WP_Customize_Nav_Menus::save_nav_menus_created_posts() wp-includes/class-wp-customize-nav-menus.php

Publishes the auto-draft posts that were created for nav menu items.
WP_Customize_Nav_Menus::insert_auto_draft_post() wp-includes/class-wp-customize-nav-menus.php

Adds a new auto-draft post.
wp_handle_comment_submission() wp-includes/comment.php

Handles the submission of a comment, usually posted to wp-comments-post.php via a comment form.
WP_Customize_Nav_Menu_Setting::update() wp-includes/customize/class-wp-customize-nav-menu-setting.php

Create/update the nav_menu term for this setting.
WP_Customize_Nav_Menu_Item_Setting::sanitize() wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

Sanitize an input.
WP_Customize_Nav_Menu_Item_Setting::update() wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

Creates/updates the nav_menu_item post for this setting.
wp_ajax_crop_image() wp-admin/includes/ajax-actions.php

Ajax handler for cropping an image.
wp_update_category() wp-admin/includes/taxonomy.php

Aliases wp_insert_category() with minimal args.
edit_user() wp-admin/includes/user.php

Edit user settings based on contents of $_POST
media_upload_form_handler() wp-admin/includes/media.php

Handles form submissions for the legacy media uploader.
wp_autosave() wp-admin/includes/post.php

Saves a post submitted with XHR.
add_meta() wp-admin/includes/post.php

Adds post meta data defined in the $_POST superglobal for a post with given ID.
edit_post() wp-admin/includes/post.php

Updates an existing post with values provided in $_POST.
wp_ajax_save_attachment() wp-admin/includes/ajax-actions.php

Ajax handler for updating attachment attributes.
wp_ajax_inline_save() wp-admin/includes/ajax-actions.php

Ajax handler for Quick Edit saving a post from a list table.
wp_ajax_replyto_comment() wp-admin/includes/ajax-actions.php

Ajax handler for replying to a comment.
wp_update_link() wp-admin/includes/bookmark.php

Updates a link in the database.
addslashes_gpc() wp-includes/formatting.php

Adds slashes to a string or recursively adds slashes to strings within an array.
wp_rel_nofollow() wp-includes/formatting.php

Adds rel="nofollow" string to all HTML A elements in content.
WP_Embed::shortcode() wp-includes/class-wp-embed.php

The do_shortcode() callback function.
wp_update_term() wp-includes/taxonomy.php

Updates term based on arguments provided.
wp_create_user() wp-includes/user.php

Provides a simpler way of inserting a user into the database.
wp_update_post() wp-includes/post.php

Updates a post with new post data.
_wp_put_post_revision() wp-includes/revision.php

Inserts post data into the posts table as a post revision.
wp_restore_post_revision() wp-includes/revision.php

Restores a post to the specified revision.
wp_xmlrpc_server::escape() wp-includes/class-wp-xmlrpc-server.php

Escape string or array of strings for database.
WP_Customize_Widgets::call_widget_update() wp-includes/class-wp-customize-widgets.php

Finds and invokes the widget update and control callbacks.
wp_update_comment() wp-includes/comment.php

Updates an existing comment in the database.

Changelog

Version Description
5.5.0 Non-string values are left untouched.
3.6.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/wp_slash