Emoji in the Codex!

Currently the new emoji in WordPress 4.2 aren’t documented anywhere. I found this very confusing when trying to figure out how to use them. This is a great time to get rid of the old Using Smilies page and have a new user-facing emoji page.

This needs to be done asap so we can include a link to it in the new release.

The page should contain the following:

1. Short intro to emoji
2. Short section on emoji on mobile
3. Short section on emoji on desktop (including the shortcuts on each platform to bring up the emoji popup)
4. List of common emoji/smilies

Anyone interested in volunteering? We need it pretty quickly so we can add a link to it in 4.2.


@kpdesign has been working day and night to…

@kpdesign has been working day and night to get the 4.1 version article filled up leading up to this week’s release. She could really use some help getting it into shape.

In particular, the Under the Hood section could use a bit of work by folks who have more intimate knowledge of coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress.. These would be people like @ipstenu, @sewmyheadon, @dh-shredder, @boonebgorges and others who have helped out in the past.

If you think you know someone from the core team who could lend a hand, please please point them this way.

Some items may also need to simply be reorganized from section to section. Any and all help would be greatly appreciated.

We’re primarily working off of two checklists:

Anything checked off has already been added to the version page in some form, or skipped for brevity.

#codex, #core, #release, #sprint

4.1 Docs Updates

There are a number of updates that need to be made for 4.1 to both the handbooks and the Codex.


There are several posts on Make/CoreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress. about changes in 4.1 that affect the developer handbooks:

Themes: New Template Tags in 4.1

Queries Improvements:

Shared Terms: An Update on Shared Term Splitting

CustomizerCustomizer Tool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings. APIAPI An API or Application Programming Interface is a software intermediary that allows programs to interact with each other and share data in limited, clearly defined ways. Improvements: JS/Underscore-template-rendered Custom Customizer Controls in WordPress 4.1

I still need to add a list of Codex pages here that will need to be updated with the content from these posts.

Codex Updates:

The following are the pages that need updated or created in the Codex.

If you would like to help, please leave a comment indicating which page you would like to work on.

New default theme:

  • Twenty Fifteen page. We can use some of this content. Note: The custom color screenshots are slightly different from the .org version. Takashi Irie provided some screenshots that reflect the default colors available: https://cloudup.com/cNHOeJVOq-k (@kpdesign)

New features:

  • New Distraction-Free Writing and inline image editing toolbar in Post editor – https://codex.wordpress.org/Posts_Add_New_Screen and https://codex.wordpress.org/Pages_Add_New_Screen
  • New sessions logout button on Profile page – https://codex.wordpress.org/Users_Your_Profile_Screen
  • New Recommendations tab on Plugin Install page – https://codex.wordpress.org/Plugins_Add_New_Screen
  • New translation installation setting on General Settings and Network Settings pages – https://codex.wordpress.org/Settings_General_Screen and https://codex.wordpress.org/Network_Admin_Settings_Screen
  • Appearance menu – 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. and Background menu items now link directly to the Customizer.

#4-1, #codex, #handbooks

All Hands on Deck for the 4.0 Version Article

For most of today and part of tomorrow, my efforts will largely be focused on fleshing out the Codex version article for the 4.0 release.

We’ll be combing through some of the (older) This Week in Core posts on make/coreCore Core is the set of software required to run WordPress. The Core Development Team builds WordPress., the About page content, as well as the bug and enhancement/task changesets.

Working on the version article is also an excellent opportunity to start building a Codex sprint list for the coming release.

If you’d like to help out with either effort, we could certainly use you. Even if you only have 30 minutes to spare, every little bit helps. I’ll be hanging in the #wordpress-sfd channel on IRC all day today, so feel free to jump in.

#4-0, #codex

WordPress 3.9 Codex Updates

I’ve made a start on the Codex updates list. Feel free to add to it.

I don’t think we’ll have a huge number of updates this time around.



  • WordPress Widgets: https://codex.wordpress.org/WordPress_Widgets

Uploading Images:

  • Using Images: https://codex.wordpress.org/Using_Images (suggest a complete rewrite)

Media Editing:
(now available in the modal window and with some other tweaks)

  • Edit Media: https://codex.wordpress.org/Edit_Media
  • Inserting Media into Posts and Pages: https://codex.wordpress.org/Inserting_Media_into_Posts_and_Pages (@designsimply)


  • The WordPress Gallery: https://codex.wordpress.org/The_WordPress_Gallery

Audio and Video Playlists:

  • Inserting Media into Posts and Pages: https://codex.wordpress.org/Inserting_Media_into_Posts_and_Pages


  • Writing Posts: https://codex.wordpress.org/Writing_Posts

New page needed:

  • WordPress Theme CustomizerCustomizer Tool built into WordPress core that hooks into most modern themes. You can use it to preview and modify many of your site’s appearance settings. (user-facing)



  • TinyMCE https://codex.wordpress.org/TinyMCE

Theme Customizer:


  • New arguments added to paginate_links() in r27600 (#24709): https://codex.wordpress.org/Function_Reference/paginate_links (@grahamarmfield)

Deprecated Stuff:


Need a volunteer to help prepare for Codex updates

WordPress 3.9 is arriving next week, which means that we need to get the codex updated. It helps to have a master list of pages in the codex that need to be updated, like this one here. We’re looking for a volunteer (or volunteers) to compile this list.This involves:

1. Listing all of the new features, functions, etc in a P2P2 P2 or O2 is the term people use to refer to the Make WordPress blog. It can be found at https://make.wordpress.org/. post. The 3.9 Codex page has many of them.
2. Finding all of the pages in the Codex that need to be updated to reflect the changes in WordPress and listing them. (You can create a checklist by putting a o at the start of a link in P2.)

This helps a lot with keeping track of what’s done and what needs to be done.

Anyone interested?


Looking for a volunteer to add a …

Looking for a volunteer to add a “Stopwords” section to Translating WordPress > Types of Messages in the Codex.

Relevant information can be found in the ticket description for #26670.


Codex: Editing wp-config.php Page Reorganization

mrmist posted the following to the wp-docs mailing list earlier this AM:

The Codex page https://codex.wordpress.org/Editing_wp-config.php is really long.

I wonder if it should be broken out into basic wp-config and more advanced stuff. Where “basic” would just include things that your average user might need.

Currently the “Advanced” stuff occupies the mass of this page, and makes it much longer and more daunting looking than it needs to be.

Also, if we restrict the main bulk of the page to the very basics, it could have edit protect enforced on it and prevent people posting their database credentials to it.

Thoughts, etc…


I agree with him – the whole page should be reorganized and updated. Thoughts on splitting it into 2 pages – original with the basic information, and a second page for the advanced information?


Codex Spam

Per @mrmist, we seem to have a glut of spammers on the Codex, creating fake user profile pages with mini biographies containing spam links at the bottom. Each fake profile is then creating a spam page, or editing an existing page to introduce spam links.

Please be on the look out and either delete if you can, or replace the page with {{rfd}} otherwise.


The Codex survey is closed and the next…

The Codex survey is closed and the next stage is to go through the responses. We’re going to do this by user type:

  • Drew – Advanced Users
  • Eric – WP Builder & novice dev
  • Siobhan – Intermediate dev
  • Jerry – WP User

Please post your results here by Friday 14th June. We’ll be using the results along with other research that’s been going on to do a workshop on the first morning of the docs sprint.

A few notes for the reviewers:

  • Use the 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. at the top to filter by your assigned user group I’ve edited your access so you just get the results for the user group you’re looking at.
  • Remember that if a respondent provides a particularly insightful answer you can click on the report number to the left of their answer and read through that person’s individual report.

If there’s any other questions you feel should be added to the report, let me know in the comments.

Outline for Report

User Type:

Learning preferences (please list in descending order, noting the percentage):

Notable answers listed under other:

Top three places to look for an answer to a question (list in descending order, noting the percentage):

Are there any other places that these users are regularly looking for answers (make sure you check through the “Option option” answers)?

How useful is the Codex to this user group?

What sections of the Codex do these users find most useful?

What are the main problems these users face with the Codex?

What documentation would these users like to see more of?

Based on your review of this survey, do you have any general observations about how this user group is making use of the Codex and documentation more generally?

Based on your review of the survey, what recommendations would you make specifically about the WordPress CodexWordPress Codex Living online manual to WordPress.org https://codex.wordpress.org/ that would help these users?

Based on your review of this survey, make three recommendations for improved documentation that would serve these users:

Contributing to WordPress Docs

What percentage of these users have contributed to WordPress Docs?

What percentage are aware that they can use their WordPress.orgWordPress.org The community site where WordPress code is created and shared by the users. This is where you can download the source code for WordPress core, plugins and themes as well as the central location for community conversations and organization. https://wordpress.org/ login to edit the Codex?

How can we make it easier for these users to contribute to WordPress docs?

#codex, #survey