Opened 4 years ago

Last modified 5 weeks ago

#3175 reopened change

Change app workflow — at Version 29

Reported by: sven Assignee:
Priority: P2 Milestone: Adblock-Plus-for-iOS-next
Module: Adblock-Plus-for-iOS/macOS Keywords: salsita 2015q4
Cc: fhd, mario, lisabielik, jeen Blocked By:
Blocking: Platform: iOS
Ready: no Confidential: no
Tester: Unknown Verified working: no
Review URL(s):

https://github.com/adblockplus/adblockplussafariios/pull/12

Description (last modified by 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: " Turn on Adblock Plus in your Safari settings first".

Text:

" 1. Go to Safari settings → Content Blockers.

  1. Enable 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.

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).

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 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:

Style Guides

Images

Change History (50)

Changed 4 years ago by sven

Changed 4 years ago by sven

Changed 4 years ago by sven

comment:1 Changed 4 years ago by sven

  • Description modified (diff)

comment:2 Changed 4 years ago by sven

  • Cc fhd added

comment:3 Changed 4 years ago by sven

  • Description modified (diff)

comment:4 Changed 4 years ago by mario

  • Cc mario added

Changed 4 years ago by sven

comment:5 Changed 4 years ago by sven

  • Description modified (diff)

Changed 4 years ago by sven

Changed 4 years ago by sven

Changed 4 years ago by sven

comment:6 Changed 4 years ago by sven

  • Description modified (diff)

comment:7 follow-up: Changed 4 years ago by 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.

comment:8 Changed 4 years ago by lisabielik

Please see Ticket_3175.png for text changes.

Changed 4 years ago by lisabielik

comment:9 follow-ups: Changed 4 years ago by 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.

comment:10 Changed 4 years ago by 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)?

comment:11 Changed 4 years ago by 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?

comment:12 in reply to: ↑ 7 Changed 4 years ago by 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.

comment:13 Changed 4 years ago by mario

  • Description modified (diff)

comment:14 in reply to: ↑ 9 Changed 4 years ago by 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.

comment:15 in reply to: ↑ 9 Changed 4 years ago by mario

  • Description modified (diff)

comment:16 Changed 4 years ago by mario

  • Keywords needs wording approvement removed

comment:17 Changed 4 years ago by mario

  • Keywords salsita added

Changed 4 years ago by sven

comment:18 Changed 4 years ago by sven

  • Description modified (diff)

comment:19 Changed 4 years ago by mario

  • Keywords 2015q4 added

comment:20 Changed 4 years ago by sven

  • Description modified (diff)

comment:21 Changed 4 years ago by mario

  • Priority changed from Unknown to P2

Changed 2015q4-issues to P2

comment:22 Changed 4 years ago by mario

  • Ready set

comment:23 Changed 4 years ago by 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
  1. 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.

comment:24 Changed 4 years ago by philll

  • Ready unset

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.

comment:25 Changed 4 years ago by 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.


comment:26 Changed 4 years ago by sven

  • Description modified (diff)

comment:27 Changed 4 years ago by sven

  • Description modified (diff)

comment:28 Changed 4 years ago by sven

  • Description modified (diff)

Changed 4 years ago by sven

Changed 4 years ago by sven

Changed 4 years ago by sven

Changed 4 years ago by sven

Changed 4 years ago by sven

comment:29 Changed 4 years ago by sven

  • Description modified (diff)
Note: See TracTickets for help on using tickets.