Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

[Common APIs handbook] Missing links on Action Reference article #1484

Open
estelaris opened this issue Mar 12, 2024 · 7 comments
Open

[Common APIs handbook] Missing links on Action Reference article #1484

estelaris opened this issue Mar 12, 2024 · 7 comments
Assignees
@flexseth
Labels
APIs Issues for Common APIs Handbook developer documentation (DevHub) Improvements or additions to developer documentation self-assigned [Status] To do Issue marked as Todo

Comments

@estelaris
Copy link
Member

Issue Description

Seems like most of the links in this articles are missing

URL of the Page with the Issue

https://developer.wordpress.org/apis/hooks/action-reference/

Suggested Fix

Add the links
@estelaris estelaris added developer documentation (DevHub) Improvements or additions to developer documentation APIs Issues for Common APIs Handbook [Status] To do Issue marked as Todo labels Mar 12, 2024
@github-actions GitHub Actions
Copy link

Heads up @WordPress/docs-issues-coordinators, we have a new issue open. Time to use 'em labels.
@flexseth
Copy link
Collaborator

/assign
@github-actions GitHub Actions
Copy link

Hey @flexseth, thanks for your interest in this issue! 🍪🍪🍪
If you have any questions, do not hesitate to ask them in our #docs Slack channel.
Enjoy and happy contributing ❤️
@dd32
Copy link
Member

dd32 commented Mar 14, 2024

The links in this document have been broken for 2 years, the content was imported from the Codex without any of the links being updated.

I've done a find-replace on it, https://developer.wordpress.org/wp-admin/revision.php?revision=152737

The https://developer.wordpress.org/apis/hooks/filter-reference/ also has similar issues, and I did a find-replace on that a few weeks ago.

There are a number of links that are still incorrect, the lists below have the list of links that are /... which I know are broken, the urls are duplicated into the 2nd list.
https://developer.wordpress.org/apis/hooks/action-reference/

/Adding_Administration_Menus
/Administration_Menus
/Create_A_Network
/Function_Reference
/Plugin_API/Hooks_2.0.x
/Plugin_Resources
/Post_Status_Transitions
/Posts_Screen
/Query_Overview
/Template_Tags/get_posts
/Template_Tags/query_posts
/Theme_Customization_API
/Version_3.3.1
/Version_3.4
/Writing_a_Plugin

├─BROKEN─ http://scompt.com/archives/2007/10/20/adding-custom-columns-to-the-wordpress-manage-posts-screen (HTTP_403)
├─BROKEN─ https://developer.wordpress.org/Writing_a_Plugin (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Plugin_API/Hooks_2.0.x (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Version_3.3.1 (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Version_3.3.1 (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Posts_Screen (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_print_styles-(hookname)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_print_scripts-(hookname)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_head-(hookname)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/(hookname)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_footer-(hookname)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/category_add_form_fields/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/category_edit_form/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/create_category/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/delete_category/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Post_Status_Transitions (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Post_Status_Transitions (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Post_Status_Transitions (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Post_Status_Transitions (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/status_post_type/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Post_Status_Transitions (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/(status)_(post_type/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/(status)_(post_type/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/publish_post/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/publish_page/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/publish_future_post/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/deleted_$taxonomy/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_term_description/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_category_description/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/activate_(plugin_file_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/add_option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_head_page_hook/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_head-(plugin_page)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_footer-(plugin_page)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_print_scripts-(page_hook)_or_admin_print_scripts-(plugin_page/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_print_styles-(page_hook)_or_admin_print_style-(plugin_page/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/dbx_page_advanced/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/dbx_page_sidebar/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/deactivate_(plugin_file_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/delete_option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Adding_Administration_Menus (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_link_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_posts_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_pages_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_media_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_$post_type_posts_custom_column/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_$post_type_posts_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/plugins/hooks/manage_$post_type_posts_columns (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/simple_edit_form/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/update_option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/wp_upload_tab/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/upload_files_(tab)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/right_now_content_table_end/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/right_now_table_end/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/right_now_table_end/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/right_now_discussion_table_end/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/right_now_end/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Theme_Customization_API (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Theme_Customization_API (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Theme_Customization_API (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Version_3.4 (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Version_3.4 (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Version_3.4 (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Create_A_Network (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Query_Overview (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Administration_Menus (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Query_Overview (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Function_Reference (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Function_Reference (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Writing_a_Plugin (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Plugin_Resources (HTTP_404)

and on the filter reference:
https://developer.wordpress.org/apis/hooks/filter-reference/

/#Administrative_Filters
/#Advanced_WordPress_Filters
/#Author_and_User_Filters
/#Blogroll_Filters
/#Category_and_Term_Filters
/#Date_and_Time_Filters
/#Link_Filters
/Glossary#Nonce
/Plugin_API
/Plugin_API/Action_Reference
/Plugin_API/Hooks_2.0.x
/Writing_a_Plugin

├─BROKEN─ http://scompt.com/archives/2007/10/20/adding-custom-columns-to-the-wordpress-manage-posts-screen (HTTP_403)
├─BROKEN─ https://developer.wordpress.org/Plugin_API/Action_Reference (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Plugin_API (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Writing_a_Plugin (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/Plugin_API/Hooks_2.0.x (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/author_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/content_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/content_filtered_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/date_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/excerpt_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/date_gmt_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/mime_type_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/modified_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/modified_gmt_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/parent_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/password_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/status_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/title_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/type_edit_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/category_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/comment_status_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/content_filtered_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/content_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/excerpt_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/image_editor_sav_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/name_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/ping_status_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/post_mime_type_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/status_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/thumbnail_filename/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/title_save_pre/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/wp_thumbnail_creation_size_limit/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/wp_thumbnail_max_side_length/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_category/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/list_cats_exclusions/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_category_description/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_category_name/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/contactmethods/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/the_author_email/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/link_description/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/link_rating/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_description/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_image/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_name/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_notes/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_rel/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_rss/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_url/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_link_target/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/all_options/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/pre_update_option_(option_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/admin_user_info_links/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/autosave_interval/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/cat_rows/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/format_to_post/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_edit-post_type_columns/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_link-manager_columns/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_post_type_posts_custom_column/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_users_columns/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/manage_users_sortable_columns/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/preview_page_link/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/wp_upload_tabs/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/plugin_action_links_(plugin_file_name)/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/views_edit-post/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/mce_spellchecker_languages/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/mce_buttons,_mce_buttons_2,_mce_buttons_3,_mce_buttons_4/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/404_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/attachment_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/archive_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/author_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/category_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/comments_popup_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/date_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/home_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/page_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/paged_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/search_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/single_template/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/kubrick_header_color/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/kubrick_header_display/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/kubrick_header_image/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/category_rewrite_rules/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/create_user_query/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_next_post_join/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_next_post_where/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_next_post_sort/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_previous_post_join/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_previous_post_sort/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/get_previous_post_where/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/functions/_2/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/update_user_query/ (HTTP_404)
├─BROKEN─ https://developer.wordpress.org/reference/hooks/uploading_iframe_src/ (HTTP_404)
@flexseth
Copy link
Collaborator

flexseth commented Mar 14, 2024 •
edited
Loading

Worked on this some last night. Using the existing spreadsheet and the URLs @dd32 found, here was the strategy so far:

  • find the new dev docs and add redirects to a copy of the previous workbook
  • started removing duplicates
  • find pages that have links, but no more info: Link to inline docs

Link to workbook - My changes are on the Copy of Copy of Hooks sheet https://docs.google.com/spreadsheets/d/1QoQjRICWbJ5BntW10O9wb4U-QHo3rUIp0DD5qLMWUPs/edit?usp=sharing
@flexseth
Copy link
Collaborator

Just for an update @estelaris - I'm about half way through the spreadsheet with editing the URLs that need to be re-directed, and can work with @dd32 to get this imported ASAP
This was referenced Mar 22, 2024
Open
Open
@flexseth
Copy link
Collaborator

Update as of March 23, 2024

Description ~% complete
Updated to new DevHub canonical 30%
Codex pages that still need content ported 10%
URLs need links to inline docs 20%
need discussion 20%
Pages that are obsolete 5%
Todo 20%

Yes, this does not add up to 100% :)

Observations

There are still significant Codex pages that provide value (if at a bare minimum, copy), still out in the wild.

👆 TLDR; Goal: Provide as much support as possible legacy code

Slack automation of old Codex links

👋 @annezazu mentioned being able to automate stuff in Slack.

IF codex.wordpress.org is mentioned in various channels
THEN ping @flexseth 🥷🏻

Progress report

Making good progress

Update to @estelaris, @dd32, @Otto42, @zzap, @jennimckinnon

Looping in @justintadlock - Some links are Theme Handbook territory so may need review, please!

Finalization of the spreadsheet

When close enough: Determine the best way to move forward with the old canonicals.

We provide LTS to developers!!! ⚔️
@flexseth flexseth mentioned this issue May 14, 2024
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
APIs Issues for Common APIs Handbook developer documentation (DevHub) Improvements or additions to developer documentation self-assigned [Status] To do Issue marked as Todo
3 participants
@dd32 @flexseth @estelaris