Add a pointer for the new DFW

[azaozz]

Looks like we will have to retire the wp360_revisions pointer as it covers the DFW button. For people upgrading from WordPress < 3.5, there will be two pointers on the Add/Edit Post screen, this one and wp350_media.

[azaozz]

In 30458.patch:

• Retire the 3.6 revisions pointer.
• Add 4.1 DFW pointer.

TO-DO: refine the text and change it if we are shipping new DFW enabled by default.

[azaozz]

Add New Post screen after updating from < 3.5.

[johnbillion]

We can't have two pointers at once on the same screen.

[iseulde]

Did anyone notice the way Slack handles multiple pointers? I really like that. :)

[iseulde]

​https://slack.global.ssl.fastly.net/20646/img/tip_throbber.png

[azaozz]

In 30458.patch the two pointers will be shown only for users upgrading from WordPress <= 3.4 to 4.1+. For everybody else, including new installs, only the DFW pointer will be shown.

In current trunk we still have two pointers on that screen: wp350_media and wp360_revisions, shown for users upgrading from <= 3.4 to 3.6+.

If we are retiring the wp350_media pointer, we can position the DFW pointer to the left of the button, covering the editor toolbar. Would be better on small screens.

[azaozz]

In 30458.2.patch: also remove the wp350_media pointer and position the DFW pointer to the left ob the button.

[azaozz]

In 30574:

Editor: add a pointer for the new DFW button. Remove the wp350_media and wp360_revisions pointers from the same screens. See #30458.

[azaozz]

Leaving this open for now to review the exact pointer text.

[johnbillion]

Text definitely needs updating, especially if we switch to this being disabled by default.

[kpdesign]

A few minor tweaks?

Enable distraction-free writing - everything fades away so you can focus. Move your mouse out of the editor to bring the admin back. Start typing, and the admin fades away again.

[johnbillion]

Even more concise:

Enable distraction-free writing - start typing and everything fades away so you can focus. Move your mouse out of the editor to bring the admin back again.

I'm not keen on the word "admin". Any better suggestions?

[DrewAPicture]

Replying to johnbillion:

I'm not keen on the word "admin". Any better suggestions?

Maybe something like this:

Move your mouse out of the editor to reveal the writing tools again.

Still doesn't read very well. It's probably because we've generalized with "everything" in the first sentence so it's tough to be specific when you're coming back to it.

[azaozz]

In 30641:

Editor: no pointer for DFW v2 when editor-scrolling is not used. Pass $post_type in the wp_editor_expand filter. See #30458.

[DrewAPicture]

In 30643:

Add an entry to the changelog for the wp_editor_expand hook denoting that the $post_type parameter was added in 4.1.0.

See #30458.

[kpdesign]

Replying to DrewAPicture:

Maybe something like this:

Move your mouse out of the editor to reveal the writing tools again.

Still doesn't read very well. It's probably because we've generalized with "everything" in the first sentence so it's tough to be specific when you're coming back to it.

Maybe this?

Enable distraction-free writing - start typing, and other writing tools fade away so you can focus. Move your mouse out of the editor to reveal everything again.

[azaozz]

There is another problem. DFW v2 is only available when editor-expand is on. When it is off the "Fullscreen" button in disabled and greyed out. There is no indication how to enable it/make it work. Perhaps that should be mentioned in the pointer. Also see #30557.

[kpdesign]

@azaozz: What about:

Distraction-free writing - start typing, and the other elements fade away so you can focus. Move your mouse out of the editor to reveal everything again. Enable it with two clicks - one in Screen Options, and another one here.

I left a comment on #30557, along with a patch.

[azaozz]

Thanks @kpdesign. Opened #30568 to hide the DFW button when the user has turned editor-expand off.

[azaozz]

In 30717:

Update the DFW v2 pointer text. Props kpdesign, DrewAPicture, johnbillion. Fixes #30458.

[johnbillion]

The pointer doesn't show up if you've disabled the visual editor from your profile screen, although DFW still functions in this case.

[azaozz]

In 30730:

Editor show the DFW v2 pointer for users that have disabled the visual editor. Fixes #30458.

[johnbillion]

The image above is a screenshot of the post editing screen with the DFW admin pointer. It suggests that starting to type will trigger DFW, but the cursor is currently in the title field so this isn't the case.

Can we delay the admin pointer so it only appears once focus enters the editor?

[azaozz]

Can we delay the admin pointer so it only appears once focus enters the editor?

Not with the current pointers. This would need some more JS and there isn't a good place for it. The only place seems to be in the pointer "registration" functions, but will need to add some logic that would output raw JS. Then we would need to remember to keep it updated as it will depend on other JS APIs.