Amp-wp: Settings callout for "view your site as amp" after initial save

Created on 5 Sep 2018  Â·  10Comments  Â·  Source: ampproject/amp-wp

As a user on first activation of the plugin, I should have a clear call-to-action after deciding my AMP settings for my site to view my site as AMP or to debug errors.

In current form, a user completes the form on the settings page and is presented with a notice that says Settings Saved. - this intends to replace this with new copy and directions. While it's important to notify a user that the tool works as expected, a user also needs a clear throughline from activation of the plugin to engagement with the AMP version of their to understand what the point of this tool is and how it works.

As part of the work in #1006, #1288, #1359 it was clear that a new information design for the settings page was needed. By providing a strong CTA after initial save, a user should engage with the AMP site more readily.

  • [ ] AC1: Write copy that encourages a user to engage with the site given the condition. Suggestions : View the AMP version of your site! or View the Classic AMP version of your site. (We strongly recommend upgrading to Paired Mode.) or View the Native AMP version of your site.
  • [ ] AC2: Based on the outcomes of #1381, implement the ability to surface a call-to-action that would appear after a user "saves" the settings.
  • [ ] AC3: Integrate copy from AC1 into the new CTA feature.
Release

Most helpful comment

Also, there can actually be a direct line from paired/native to “View site as AMP”. If you are logged-in as an admin, which you would be on this screen, you can access your site with /?amp_validate in the URL to see it with AMP enabled, even if you are still in _classic_ paired mode. This gives you the ability to preview your site with your own eyes before you do the switch. You don't even need to look at the validation errors.

All 10 comments

Also, there can actually be a direct line from paired/native to “View site as AMP”. If you are logged-in as an admin, which you would be on this screen, you can access your site with /?amp_validate in the URL to see it with AMP enabled, even if you are still in _classic_ paired mode. This gives you the ability to preview your site with your own eyes before you do the switch. You don't even need to look at the validation errors.

Just a heads up, I've updated the initial post to write out out a full user story for this ticket.

Question About Call To Action

Hi @postphotos,
Thanks for the detailed ACs here.

AC2: Based on the outcomes of #1381, implement the ability to surface a call-to-action that would appear after a user "saves" the settings.

Would this call to action be a notice, like before?

amp-version-site

@kienstra Yep, that's the intent! It'd be leveraging the same space as the "settings saved" screen, but it'd be important to still notify the user that the action was completed.

So with that said, in regard to AC1, I think the language should probably be something like:

  • Paired Mode activated! _View your site as AMP now_ or _Review Errors_
  • Native Mode activated! _View your site as AMP now_ or _Review Errors_
  • Classic Mode activated! _View your site as AMP now_. We recommend upgrading to Native or Paired mode.

Seeking feedback and hoping to iterate here.

Notice Copy Looks Good

Hi @postphotos,
That copy for notices looks good.

The first time someone activates Native or Paired mode, there probably won't be any errors to review. But we could add a condition to only output 'or Review Errors' when there are errors.

I think we can have that error.

@kienstra - I think we'd have that information available to us, if not even more.

I don't quite understand when or how the plugin checks for the initial batch of errors, but I know @westonruter talked about trying to surface the number of errors (or at least the existence of) upon initial activation. (And I'd love clarity there if either of you can help.)

For this notice in particular, I don't want to overwhelm the user, but at least drive them onward through to the error flow and compatibility tool if that should be their next steps.

Thoughts? cc: @westonruter

Reply Regarding Validation

Hi @postphotos,
Sorry for the delay in replying.

...how the plugin checks for the initial batch of errors...

There are only 2 ways I know of that this plugin validates a URL without the user explicitly doing so (like clicking 'Re-validate' in the admin bar or 'Recheck' on the 'Invalid URLs' page):

  1. On updating a post:
    clicking-save-draft

  2. After activating any plugin other than this, it validates a post that is eligible for AMP:
    plugin-notice-amp

Also, there is a WP-CLI script to test for validity in #1183.

Request For Testing

Hi @csossi,
Could you please test this?

  1. Go to the AMP Settings page
  2. Change the 'Template Mode.' For example, if it's currently 'Native,' change it to 'Paired'
  3. Expected: There's a notice that applies to that mode:

paired-save-changes

  1. Repeat step 2, but change it to 'Native' and 'Classic' modes.
  2. Expected: There is a separate message for each. The copy could change, so don't worry too much about that.

Verified in QA

Thanks, @csossi!

Was this page helpful?
0 / 5 - 0 ratings

Related issues

miina picture miina  Â·  3Comments

GitaStreet picture GitaStreet  Â·  4Comments

miina picture miina  Â·  5Comments

swissspidy picture swissspidy  Â·  4Comments

schlessera picture schlessera  Â·  5Comments