WordPress 3.5 Codex Updates

If all goes to plan, WordPress 3.5 will be with us in a just over a weeks. This means that the Codex is going to need to be updated in line with the new features. To help keep track of what needs to be updated, I thought it would be a good idea to create a list. I’d love some help creating the list of items that need to be reviewed and/or updated. Just note the item in the comments, with or without a link to the relevant codex page.

Sprint happening on 13th December: see here: https://make.wordpress.org/docs/2012/11/30/this-release-cycle-were-lucky-enough-to-know/

For additional reference, you can check out the 3.5 Beta 1 features workup in Google Docs.

Alright, here goes:

#Version 3.5@DrewAPicture

  • Version 3.5 page https://codex.wordpress.org/Version_3.5 (@DrewAPicture)
  • 3.5 Changelog https://codex.wordpress.org/Changelog/3.5 (@DrewAPicture)


  • Media Add New Screen https://codex.wordpress.org/Media_Add_New_Screen (@JerrySarcastic)
  • Edit Media Screen (new page for 3.5 workflow) https://codex.wordpress.org/Edit_Media (@JerrySarcastic)
  • Inserting Images into Posts and Pages https://codex.wordpress.org/Inserting_Images_into_Posts_and_Pages (@JerrySarcastic)
  • Media Add New SubPanel https://codex.wordpress.org/Media_Add_New_SubPanel (Deleted this duplicate page) (@JerrySarcastic)

#Gallery – @JerrySarcastic

  • The WordPress Gallery https://codex.wordpress.org/The_WordPress_Gallery (@JerrySarcastic)
  • Gallery Shortcode https://codex.wordpress.org/Gallery_Shortcode Gallery should reflect the new system based on (@JerrySarcastic)

with menu_order deprecated.

#Links: @jhoffm34

  • Links Manager https://codex.wordpress.org/Links_Manager (@jhoffm34)
  • Links Link Categories Screen https://codex.wordpress.org/Links_Link_Categories_Screen (@jhoffm34)

#Twenty Twelve: @raggedrobins

  • Using Themes https://codex.wordpress.org/Using_Themes (@raggedrobins)
  • Add to glossary https://codex.wordpress.org/Glossary (@raggedrobins)
  • Child Themes page uses Twenty Eleven as Example: https://codex.wordpress.org/Child_Themes (@raggedrobins)
  • Update reference to default theme: https://codex.wordpress.org/Common_WordPress_Errors (@raggedrobins)
  • Updating WordPress: https://codex.wordpress.org/Updating_WordPress (this page needs totally rewritten – suggest having another sprint for updating out of date pages) (@raggedrobins)
  • Multisite Network Admin: https://codex.wordpress.org/Multisite_Network_Administration (@raggedrobins)
  • First Steps with WordPress: https://codex.wordpress.org/First_Steps_With_WordPress (@raggedrobins)
  • Appearance Menu Screen: https://codex.wordpress.org/Appearance_Menus_Screen (@raggedrobins)
  • Appearance Header Screen: https://codex.wordpress.org/Appearance_Header_Screen (@raggedrobins)
  • Login Trouble: https://codex.wordpress.org/Login_Trouble (@raggedrobins)

#HTMLHTML HTML is an acronym for Hyper Text Markup Language. It is a markup language that is used in the development of web pages and websites. Editor renamed as Text:

  • Writing Posts https://codex.wordpress.org/Writing_Posts (@raggedrobins)
  • TinyMCE https://codex.wordpress.org/TinyMCE (@raggedrobins)
  • TinyMCE Custom Styles https://codex.wordpress.org/TinyMCE_Custom_Styles (@raggedrobins)

Slideshare, Instagram & SoundCloud integration (also turned on by default)

  • Embeds: https://codex.wordpress.org/Embeds (@DrewAPicture)
  • This post on wpbeginner: http://www.wpbeginner.com/wp-themes/how-to-set-oembed-max-width-in-wordpress-3-5-with-content_width/ This could be added to one of the troubleshooting FAQs – “How do I resize my oembeds?” (@DrewAPicture)

#PluginPlugin A plugin is a piece of software containing a group of functions that can be added to a WordPress website. They can extend functionality or add new features to your WordPress websites. WordPress plugins are written in the PHP programming language and integrate seamlessly with WordPress. These can be free in the WordPress.org Plugin Directory https://wordpress.org/plugins/ or can be cost-based plugin from a third-party Favorites: – Philip Erb

  • Managing Plugins: https://codex.wordpress.org/Managing_Plugins (@philerb)
  • Plugins add new subpanel https://codex.wordpress.org/Plugins_Add_New_SubPanel (@philerb)

#Search Engine Visibility@DrewAPicture
(moved from Settings > Privacy -> Settings > Reading )

  • Settings Privacy Screen https://codex.wordpress.org/Settings_Privacy_Screen (@DrewAPicture)
  • Settings Reading https://codex.wordpress.org/Settings_Reading_Screen (also charset option hidden) (@DrewAPicture)
  • Administration Screens https://codex.wordpress.org/Administration_Screens Cleanup Privacy entries (@DrewAPicture)

#Media Settings

  • Uploads folder hidden: https://core.trac.wordpress.org/ticket/21720 (@raggedrobins)
  • Settings Media Screen: https://codex.wordpress.org/Settings_Media_Screen (@DrewAPicture)
  • oEmbed now enabled by default https://codex.wordpress.org/Settings_Media_Screen (@raggedrobins)

(now enabled by default)

  • XML-RPC Support: https://codex.wordpress.org/XML-RPC_Support (@raggedrobins)


  • turned off by default: https://codex.wordpress.org/AtomPub Can re-enable with a plugin: https://wordpress.org/extend/plugins/atom-publishing-protocol/ (@raggedrobins)

#MultisiteMultisite Multisite is a WordPress feature which allows users to create a network of sites on a single WordPress installation. Available since WordPress version 3.0, Multisite is a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser project was discontinued and its features were included into WordPress core.https://codex.wordpress.org/Create_A_Network.

  • Multisite installs now work with WordPress in a subdirectory (@Ipstenu)
  • Rockstar: Turn off ms-files.php by default (@Ipstenu)
  • File quotas disabled by default on new installs


  • Widgets menu hidden if no sidebar is active (maybe add an FAQ to the troubleshooting guide?) https://codex.wordpress.org/WordPress_Widgets (@raggedrobins)
  • Display name defaults to first name and last name for new users https://codex.wordpress.org/Users_Screen also: https://codex.wordpress.org/Users_Your_Profile_Screen#Your_Profile_and_Personal_Options (@raggedrobins)
  • Force the user to explicitly choose between content deletion and reassignment when deleting users https://codex.wordpress.org/Users_Screen#Delete_Users (@raggedrobins)
  • changes to custom headerHeader The header of your site is typically the first thing people will experience. The masthead or header art located across the top of your page is part of the look and feel of your website. It can influence a visitor’s opinion about your content and you/ your organization’s brand. It may also look different on different screen sizes. screen (@raggedrobins)
  • Easier Expression of Time constants (new!) https://codex.wordpress.org/Transients_API#Using_Time_Constants (@DrewAPicture)


General Developer

  • Bump default memory limit from 32MB to 40MB (@raggedrobins)
  • Add easier expression of time constants, for example DAY_IN_SECONDS vs 86400 (@DrewAPicture)
  • Add flexible-header to allowed theme tags
  • Add ‘publish_post’ metaMeta Meta is a term that refers to the inside workings of a group. For us, this is the team that works on internal WordPress sites like WordCamp Central and Make WordPress. capability (@DrewAPicture)
  • No Class Reference: Add ‘term_taxonomy_id’ field handling to WP_Tax_Query::transform_query(), resulting in fewer database queries
  • Add two hooksHooks In WordPress theme and development, hooks are functions that can be applied to an action or a Filter in WordPress. Actions are functions performed when a certain event occurs in WordPress. Filters allow you to modify certain functions. Arguments used to hook both filters and actions look the same. to Post Editing screen, ‘edit_form_after_title’ and ‘edit_form_after_editor’ [more info] (@DrewAPicture)
  • Rockstar: Allow ordering posts by IDs passed to ‘post__in’
  • Check a post type’s ‘show_in_admin_bar’ property for ‘View’ and ‘Edit’ object Toolbar links


  • Multisite: Allow home page of sub-directory sites to resolve regardless of capitalization (@DrewAPicture)
  • Multisite: Introduce get_space_used() and upload_is_user_over_quota() for more gauging more accurate quotas (@Curtismchale)
  • Multisite: Make it easy to replace or augment the over-quota message


  • Rockstar: WP_Image_Editor needs starter info https://codex.wordpress.org/Class_Reference/WP_Image_Editor
  • Fix tax query returning all results when empty (@DrewAPicture)
  • Rockstar: Add get() and set() methods to WP_User_Query for modifying query variables the way you might with WP_Query

#New Functions:

#Functions – Needs Example

#Deprecated Functions & Filters:

  • user_pass_ok() https://codex.wordpress.org/Function_Reference/user_pass_ok (@raggedrobins)
  • wp_get_single_post() https://codex.wordpress.org/Function_Reference/wp_get_single_post (@raggedrobins)
  • Deprecate image_resize() https://codex.wordpress.org/Function_Reference/image_resize (@raggedrobins)
  • Deprecate image_resize filterFilter Filters are one of the two types of Hooks https://codex.wordpress.org/Plugin_API/Hooks. They provide a way for functions to modify data of other functions. They are the counterpart to Actions. Unlike Actions, filters are meant to work in an isolated manner, and should never have side effects such as affecting global variables and output. (@sirjonathan)
  • wp_cache_reset() (@DrewAPicture)
  • Deprecate sticky_class() in favor of post_class() https://codex.wordpress.org/Function_Reference/sticky_class (@raggedrobins)
  • Deprecate wp_create_thumbnail() (@DrewAPicture)
  • Deprecate wp_create_thumbnail filter (@sirjonathan)
  • Deprecate image_save_pre filter, which filters a GD Resource, for image_editor_save_pre, which filters a WP_Image_Editor object (@sirjonathan)
  • Deprecate wp_save_image_file filter, which filters a GD Resource, for wp_save_image_editor_file, which filters a WP_Image_Editor object (@sirjonathan)
  • Deprecate image_edit_before_change filter, which filters a GD Resource, for image_edit_before_change, which filters a WP_Image_Editor object (@DrewAPicture)
  • Deprecate jpeg_quality filter for wp_editor_set_quality, or WP_Image_Editor::set_quality() on an individual image, which sets compression quality for any supported format (@sirjonathan)
  • Deprecate wp_load_image() in favor of wp_get_image_editor() https://codex.wordpress.org/Function_Reference/wp_load_image (@raggedrobins)
  • Deprecate image_resize in favor of WP_Image_Editor::resize() (@raggedrobins)
  • Deprecate gd_edit_image_support() in favor of wp_image_editor_supports() (@raggedrobins)

#Function Changes:

  • register_taxonomy page needs to be updated with the new ‘show_admin_column’ parameter that allows automatic creation of taxonomyTaxonomy A taxonomy is a way to group things together. In WordPress, some common taxonomies are category, link, tag, or post format. https://codex.wordpress.org/Taxonomies#Default_Taxonomies. columns on associated post-types. (@Ramly)
  • Add ‘order’ parameter to wp_get_archives() https://codex.wordpress.org/Function_Reference/wp_get_archives (@DrewAPicture)
  • Allow count_many_users_posts() to count only public posts (@jhoffm34)
  • Add ‘order’ to wp_get_archives() (@DrewAPicture)
  • Allow passing stdClass and WP_User to wp_insert_user() and wp_update_user() (@DrewAPicture)
  • Fix the matching in is_email_address_unsafe(), which was too aggressive (@DrewAPicture)
  • Give System temporary directories preference in get_temp_dir() for better Windows compatibility (@DrewAPicture)
  • Hide UIUI UI is an acronym for User Interface - the layout of the page the user interacts with. Think ‘how are they doing that’ and less about what they are doing. for attachment taxonomies if ‘show_ui’ is ‘false’ for that taxonomy (@DrewAPicture)
  • Make get_home_path() work in more cases by being case insensitive and sanitzing Windows paths (@DrewAPicture)
  • No markup is output if wp_nav_menu() has no menu items (@DrewAPicture)
  • Return WP_Error object if the database insert in wp_set_object_terms() fails (@DrewAPicture)
  • Simplify protocol stripping in add_query_arg() by avoiding a regular expression (@DrewAPicture)
  • supports => false can be passed to register_post_type() to disable default title and editor (@DrewAPicture)
  • Welcome Panel and accompanying screen option removable via the welcome_panel hook (@DrewAPicture)
  • When reassigning posts and links during user deletion, clear the post and link caches
  • Rockstar: XML-RPC: Add the ‘home’ option to wp.getOptons https://codex.wordpress.org/XML-RPC_WordPress_API/Options
  • Rockstar: XML-RPC: Don’t use switch_to_blog() in wp.getUsersBlogs, improves performance and memory footprint https://codex.wordpress.org/XML-RPC_wp

#New Filters

  • Add cron_request for filtering the cron_url passed to wp_remote_post() in spawn_cron() (@DrewAPicture)
  • Add login_body_class filter to login_header() (@DrewAPicture)
  • Add media_view_strings and media_view_settings filters. Use media_view_strings to filter ‘Insert into post’ button text
  • Add post_type_labels_{$post_type} to filter get_post_type_labels()
  • Add restrict_manage_comments hook to comments list table for better filtering capability
  • Add validate_password_reset filter, making it possible for plugins to enforce password rules
  • Add domain_exists filter for domain_exists()
  • Add wp_get_update_data filter making it easier for plugins to modify update count
  • Rockstar: Add wp_image_editors filter to allow adding to or modifying order of WP_Image_Editor engines
  • XML-RPC: Add xmlrpc_login_error filter to customize the IXR_Error returned when login() fails

#Scripts, External Libraries

  • Add jQuery Masonry for better custom header listings (@raggedrobins)
  • Farbtastic color picker replaced with Iris color picker [more info] (@raggedrobins)
  • Switch to .min for compressed JS and CSSCSS CSS is an acronym for cascading style sheets. This is what controls the design or look and feel of a site. files, e.g. .js becomes .min.js, .dev.js becomes .js (@DrewAPicture)
  • Allow protocol-relative URLs when registering/enqueueing scripts and styles (@georgestephanis)
  • Prototype and Script.aculo.us local libraries unbundled from core, latest versions enqueued via ajax.googleapis.com (@raggedrobins)

Please, add more!