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:@JerrySarcastic

  • 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)

#HTML 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)

#oEmbeds:
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)

#Plugin 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)

#XML-RPC:
(now enabled by default)

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

#AtomPub

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

#Multisite

  • 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

#Miscellaneous:

  • 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 header screen (@raggedrobins)
  • Easier Expression of Time constants (new!) https://codex.wordpress.org/Transients_API#Using_Time_Constants (@DrewAPicture)

Developer

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’ meta capability (@DrewAPicture)
  • No Class Reference: Add ‘term_taxonomy_id’ field handling to WP_Tax_Query::transform_query(), resulting in fewer database queries
  • Add two hooks 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

  • 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

#Classes

  • 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:

    <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='e7bc87660366cde7623f9f7a5b957806' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/clean_blog_cache">clean_blog_cache()</a> – #18387 (@Curtismchale)' >clean_blog_cache()#18387 (@Curtismchale) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='a8fa971d5dc6df5091b2a2ba8129ab9e' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_checkdate">wp_checkdate()</a> – #17180 (@Curtismchale)' >wp_checkdate()#17180 (@Curtismchale) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='57f6dc5564c8371598b3e242865a2461' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_kses_allowed_html">wp_kses_allowed_html()</a> – #17977 (@Curtismchale)' >wp_kses_allowed_html()#17977 (@Curtismchale) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='147c2528e8c961ce063a97814b32b6eb' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_prepare_attachment_for_js">wp_prepare_attachment_for_js()</a> – #21390 (@Bananastalktome)' >wp_prepare_attachment_for_js()#21390 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='30b5fcb5a400c0d8b36e70d7d7f80b9f' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_send_json">wp_send_json()</a> – #21390 (@Bananastalktome)' >wp_send_json()#21390 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='91f167701d853d84658d68fd4425d1b2' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_send_json_success">wp_send_json_success()</a> – #21390 (@Bananastalktome)' >wp_send_json_success()#21390 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='177bb784ce0b728351c1a81ef5910a92' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_send_json_error">wp_send_json_error()</a> – #21390 (@Bananastalktome)' >wp_send_json_error()#21390 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='1e2ff102cf8b5678b94472238c81c2ac' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/ms_is_switched">ms_is_switched()</a> – #21459 (@Bananastalktome)' >ms_is_switched()#21459 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='77b50c71c86df9efb81cdc49bf59f6ea' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_get_mime_types">wp_get_mime_types()</a> – #21299 (@Bananastalktome)' >wp_get_mime_types()#21299 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='6f372681793d0b51ada38ecc2eb69c0a' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/get_space_used">get_space_used()</a> – #21181 (@Curtismchale)' >get_space_used()#21181 (@Curtismchale) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='8d26e042a11977eb8e24b79fa2db2936' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/get_edit_user_link">get_edit_user_link()</a> – #14787 (@Curtismchale)' >get_edit_user_link()#14787 (@Curtismchale) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='d21f2dd6f3197fff2e130534957505bd' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_oembed_remove_provider">wp_oembed_remove_provider()</a> – #16327 (@DrewAPicture)' >wp_oembed_remove_provider()#16327 (@DrewAPicture) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='9829916aa460df1d7429c57d20dd7cee' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/wp_clean_themes_cache">wp_clean_themes_cache()</a> – #20954 (@Bananastalktome)' >wp_clean_themes_cache()#20954 (@Bananastalktome) <li class='o2-task-item o2-task-sortable o2-task-completed' data-item-hash='cd1845c8b92f9c815a1f9a9178ea37d9' data-hash-instance='0' data-item-text='<a href="https://codex.wordpress.org/Function_Reference/set_url_scheme">set_url_scheme()</a> – #18017 (@Bananastalktome)' >set_url_scheme()#18017 (@Bananastalktome)
  • Rockstar: Introduce wp_cache_switch_to_blog() and WP_Object_Cache::switch_to_blog() to more efficiently switch the cache to a new blog id
  • Rockstar: Introduce WP_Image_Editor class, abstracting GD from core, and introducing Imagick support
  • wp_get_image_editor() (@DrewAPicture)

#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 filter (@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 taxonomy 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 UI 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 CSS 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!

#codex