Change app workflow

[sven]

Background

There are several problems, when activating the content blocker. Therefore, we decided to improve the user workflow.
The workflow changes mainly aim at the following issues:

• When the app is started and ABP isn't activated in the iOS Settings, show a notification, that locks the rest of the app. The notification states, that the user needs to enable ABP in the Settings before he can proceed. "Locking" the app by a notification prevents users from assuming, that ABP works by only starting the app (and not reading the information as currently shown).
• Show a direct link to the iOS Settings in order to make it easier for the user to find where to enable ABP

What to change

The new workflow is put into five steps.

Step 1
The Acceptable Ads introduction will be displayed in a modal dialog.

Headline: You're in control
Text: Annoying ads are always blocked, while nonintrusive ads are displayed by default. You can change this setting at any time in:
Acceptable Ads → Allow some nonintrusive ads

After that, there is a (standard iOS) blue button with the label "Got it". Clicking this button will lead you to step 2.

Step 2
The user will see a notification overlay, which prevents the user to use/see the main app. The notification is a combination of what we currently showing in our second on-boarding slide and the main screen. The headline of the notification overlay, which is designed like a default iOS notification, is:
Headline: "Before you proceed, turn on Adblock Plus in your Safari settings"

Text:

1. Go to Settings → Safari → Content Blockers.
2. Turn on Adblock Plus.

After that there is a visual separator (little 2px dots) and another label which says "Watch how-to video" (color: standard blue). When clicking this label, the how-to video opens and behave like it currently does.

Step 3
The user needs to activate Adblock Plus in the Safari settings. Step 2 will be visible in the app as long as the activation is not done. If Adblock Plus is activated and ABP for iOS is opened again, another screen will appear which tells, that the activation was successfully and that there is some progress to configure the filter lists.

Wording:

Text: “You’ve activated Adblock Plus in Safari”

(dotted separator)

Headline: Configuring filter lists

(spinner/progress indicator)

Text: This can take some second

Step 4
After the configuration is done, there will be one last screen which will tell the user, that Adblock Plus for Safari is now ready to use, or, if there were connection problems, that the user needs to manually update the filterlists.

Wording (if everything went well):

Headline: “Adblock Plus is installed”

Text: “Adblock Plus is activated in Safari and all filter lists are up to date. You can use Safari without annoying ads now.”

Button: “Finish”

Wording (if there was a problem, while updating the filter lists):

Headline: Filter lists are not up to date

Text: “There was no internet connection while trying to update the filter lists. Please update the filter lists manually in the settings. It’s possible, that you still see some ads in Safari, because of the outdated filter lists.”

Button: “Finish”

After clicking “Finish” the main app will appear.

Step 5
The main app is basically the current settings page but with little visual adjustments. Please ignore and omit the "Feedback" menu item as of now. The functionality will be described in a separate issue. The ad for Adblock Browser is not part of the visuals, but it should be part of the main app. The ad should be placed on the bottom of the main app, means that a user needs to scroll to see it, if there are too many menu items.

• Exception: If the user disables ABP for iOS in the Safari Settings afterwards, the modal notification from Step 1 is shown again (if possible).

Screenshots:

• Step 1
• Step 2
• Step 3
• Step 4 good result, Step 4 bad result
• Main app screen

Style Guides

• Style guide notification

(Please note that the screenshots above don't use the exact same style as described in this style guide. Please apply this style guide to the content for each notification.)

Images

• Dotted separator step 2
• Dotted separator step 3
• Checkmark step 2
• Checkmark step 3

[philll]

The background section does not give enough info about which issues the app had, thus it cannot be evaluated, if the suggested change solved those issues. Please be more explicit.

[lisabielik]

Please see Ticket_3175.png for text changes.

[vojtab]

The "Feedback" menu item is out of scope for now as it is unclear what it should do. Please raise a separate ticket for Feedback feature.

[vojtab]

You want to show blocking "modal" popup (step 1) until ABP is enabled in content blocking settings in Safari. What should happen when user disables it again in Safari settings after some time & then open the Adblock Plus for iOS app? Do you want to fall back to blocking step 1 modal again? Or should normal settings page be shown from this point forward (= blocking modals steps 1 & 2 would be show always only once)?

[vojtab]

In case modal should not be shown again, do you want to display certain status icon etc. on main page (step 4) to indicate that ABP is disabled in Safari Settings?

[mario]

Replying to philll:

The background section does not give enough info about which issues the app had, thus it cannot be evaluated, if the suggested change solved those issues. Please be more explicit.

Last Wednesday we've discussed the most recent user feedback and concluded, that there are issues, that can be avoided by restructuring the app's layout and workflow:

• When the app is started and ABP isn't activated in the iOS Settings, show a notification, that locks the rest of the app. The notification states, that the user needs to enable ABP in the Settings before he can proceed. "Locking" the app by a notification prevents users from assuming, that ABP works by only starting the app (and not reading the information as currently shown).
• Show a confirmation-screen as soon as ABP is enabled and subsequently unlock the app.
• Show a direct link to the iOS Settings in order to make it easier for the user to find where to enable ABP

I'll add this to the background section.

[sven]

Replying to vojtab:

"The "Feedback" menu item is out of scope for now as it is unclear what it should do. Please raise a separate ticket for Feedback feature."

Yes ignore that please.

"You want to show blocking "modal" popup (step 1) until ABP is enabled in content blocking settings in Safari. What should happen when user disables it again in Safari settings after some time & then open the Adblock Plus for iOS app? Do you want to fall back to blocking step 1 modal again? Or should normal settings page be shown from this point forward (= blocking modals steps 1 & 2 would be show always only once)?"

It would be optimal to check if a user disabled the setting, to show the lock screen again, but for a first implementation this is not necessary, but a nice to have.

[mario]

Changed 2015q4-issues to P2

[sven]

1. "The ad should be placed on the bottom of the main app, means that a user needs to scroll to see it, if there are too many menu items.". At the moment it's sticky at the initial screem at the bottom

2. Another thing that i saw is that the app conten is scrolled a bit while you see the overlay in the beginning. So if you see the overlay, which tells you to activate the content blocker first, you see the app content in the background, but a bit scrolled down.

[philll]

Not ready. Most of the what to change section is rather background if at all and does neither give specific changes nor a description of the desired state.
Examples:

• "The new workflow is put into three steps." but there are four steps.
• I don't understand what "Step 4" refers to.
• "What needs to be done: Final wording" is neither a change nor a description and hints to unfinished requirements.
• The attachments are not referred to in the description

I also don't get what the last comment here refers to? If there's something important to the implementation, it should land in the description.

Please provide a clear and precise description of either changes that need to be done or (preferably) a complete description of the desired features. If using attachments, refer to them in the actual description, not as a lose list to be matched to the relevant points by the reader. If texts are required, include them in the description after having gotten approval from tech writing.

[sven]

"What needs to be done: Final wording" is neither a change nor a description and hints to unfinished requirements. -> correct. Don't know how you handle that, but the implementation can start without final wordings. So I'm fine, if the issue isn't set "Ready" as long it does mean that there is something missing, but you can already work on that. Please clarify that with mario.

"The attachments are not referred to in the description" - Not sure what you mean with "The attachments" b/c all relevant attachments are. There are more in the attachments, b/c they were uploaded in a time of a previous version of this ticket.

The last comment was made while we had the meeting today to not forget these two points. There are 3 steps that we implemented but 4 which are necessary for the user to activate adblock plus. Step 3 is just a user interaction. We could write that it's 4 steps, if this is confusing.

[sven]

The workflow lgtm, but there are some minor visual things, which are not implemented such as described in that ticket:

• In step 2 in "Go to Safari settings → Content Blockers." Safari settings and Content Blockers should be displayed in bold.
• The font size is smaller than defined.

[mario]

Notification Styleguide

[mario]

As per step 2:

After that a (standard iOS) blue button with the label "Open iOS Settings".
This button will link to the general iOS settings (we're not able to link to the Safari -> Content Blockers menu. The reasons are iOS restrictions).

This is currently not reflected in the app.

How to reproduce

1. Deactivate ABP in Safari's settings and uninstall ABP
2. Install ABP for iOS 1.2.0
3. Start ABP for iOS
4. Tap the button "Open iOS Settings" when prompted

Observed behavior

Tapping the button "Open iOS Settings" opens ABB's Settings page

Expected behavior

Tapping the button "Open iOS Settings" opens the iOS Settings

[pavelz]

@mario not a bug, unfortunately. The feature of opening iOS settings through custom crafted URL was disabled in iOS10.
​https://gist.github.com/phynet/471089a51b8f940f0fb4
​http://stackoverflow.com/questions/8246070/ios-launching-settings-restrictions-url-scheme
​http://stackoverflow.com/questions/5655674/opening-the-settings-app-from-another-app

The app does as much as it can: when opening that custom URL fails, it opens the only legally and publicly available URL, which is the app's settings itself. Now the question is, how to improve the UX:

1. either do nothing, falling back to the previous waiting on the user to go to the Settings on his own
2. or instruct the user to click "Settings>" in the app's settings page, which will take him to the Settings

[pavelz]

@mario while i was hunting the disappearance of #3241 from devbuild (configurable filter lists), i had a multiple opportunity to activate the filter in safari through both methods and i must say that method 2 is WAY MORE user friendly.

For method 1, one must leave the ABP app to reach settings from the main iOS screen. When Safari is found and settings changed, ABP app has to be found again manually in app listing.

For method 2, Settings "app" is entered directly from ABP app. Now since iOS9, there is a desperate attempt at Android's hardware back button - i.e. navigating to "previous" app. It's covering top left corner where signal strength is normally. It shows "Adblock Plus" all the time being in iOS Settings. So when the user switches the Safari blocker switch, he can appear directly back in the ABP onboarding with a single click!

It's so much better UX that i don't recommend method 1 at all anymore even at expense of needing to make a new tutorial video.

[mario]

@pavelz, Thanks for the feedback. We're currently looking into this.

Other than that, we just found an issue with the current preview:

How to reproduce

1. Install ABP for iOS 1.2.1 preview devbuild
2. Open ABP
3. Navigate to step 3

Observed behaviour

The spinner icon is not displayed

Expected behaviour

The spinner icon is displayed as shown in this screenshot.

[mario]

@pavelz, I've updated "Step 2" to reflect the fact, that we can't deep-link to the Settings app anymore. Please review the following changes:

• The headline of Step 2 has changed
• The text of Step 2 has changed
• We have removed the "Open iOS Settings" button

Our designers have figured, that deep-linking to the ABP settings might cause more confusion than requiring users to open the Settings app themselves. In order to avoid introducing another fail-state we've removed the button altogether instead of giving any choice of confirmation (like a "Go it!" button).

@lisabielik, could you please review the changed strings in "Step 2"?
The strings in question are:

• "Turn on Adblock Plus in your Safari settings first" to "Before you proceed, turn on Adblock Plus in your Safari settings"
• "Go to Safari settings -> Content Blockers." to "Go to Settings -> Safari -> Blockers."

[lisabielik]

@mario:

Before you proceed, turn on Adblock Plus in your Safari settings.

1. Go to Settings -> Safari -> Blockers.
2. Turn on Adblock Plus.

[mario]

@lisabielik, thanks a lot, I modified the description accordingly.
Regarding "Before you proceed, turn on Adblock Plus in your Safari settings.": We did not use punctuation in headlines in the introduction slides so far. Would you rather add punctuation to all headlines? This would concern the following headlines:

• Step 1
• Step 2
• Step 3
• Step 4 good result, Step 4 bad result

[lisabielik]

@mario:

No, sorry for the mistake...no punctuation in the headlines.

Thanks!

[mario]

Thanks, changed.

[jand]

@mario: Can you provide me image from Step 2?

[mario]

@jeen, can you please attach the "(i)" symbol from Step 2 as an image? Alternatively feel free to invite me to Zeplin, if this project is online there.

[jeen]

Alert icon

[pavelz]

​https://github.com/adblockplus/adblockplussafariios/pull/12
waiting for @fhd feedback

[mario]

@pavelz, we're holding back the review until the discussed changes in Slide 2 are implemented. See discussion on slack: Fonts on Slide 2 are too big. Please adjust fonts to match the style guide.

[abpbot]

A commit referencing this issue has landed:
​Issue 3175 - Change app workflow

[mario]

We encountered inconsistencies in the style of the onboarding slides, which need to be addressed.

As per this comparison, numbered accordingly:

1. The icon on slide 1 ("Before you proceed") is too big. Please adjust it to the same size as in slide 3 ("Updating filter list").
2. The headlines on slide 1 ("Before you proceed") and slide 4 ("You're in control") do have a different style compared to slide 2 and 3. Please adjust the two headlines to match the style (size and boldness) of slide 2 and 3.
3. The bottom spacing on slide 1 ("Before you proceed") is bigger than on slide 3 ("Updating filter list"). Please adjust the spacing on slide 1 to match the spacing on slide 3.
4. The paragraph text on slide 1 ("Before you proceed") is bigger compared to slide 2 and 4. The paragraph text on slide 3 ("Updating filter list") is smaller than on slide 2 and 4. Please adjust the paragraph text on slide 1 and 3 to match the style/size of the paragraph text of slide 2 and 4.

Except for 1., the styles of all elements are described in this styleguide. Inconsistencies should be covered by the list above, however, please double check all elements on all onboarding slides to exactly match the style guide.

[mario]

Temporarily marking this issue as not ready as a discussion is going on about whether to introduce additional changes.
Will update asap.

[umairaslam]

spam

[mujji]

spam

[Aaradhana Akshay]

spam

[Saranraj]

spam

[Saranraj]

spam

[onlineplants]

spam

[mdeepali071]

spam

[saleemsaif]

spam

[smleqbank]

spam

[amaria]

spam

[amaria]

spam

[JohnRicky]

spam

[saleemsaif]

spam

[haseebatvital]

spam

[zhongba]

spam

[zhongbachinese]

spam

[shiftcarrental3]

spam

[Elegantitservices]

spam

[Lcx666iixx]

spam

[Niyaz23]

spam

[impulsepp]

spam