Page MenuHomePhabricator

Share a Wikistory
Closed, ResolvedPublic

Assigned To
Authored By
SGautam_WMF
Mar 4 2022, 6:24 AM
Referenced Files
F37727775: Screenshot 2023-09-15 at 12.50.51 PM.png
Sep 15 2023, 5:52 PM
F37727777: Screenshot 2023-09-15 at 12.50.37 PM.png
Sep 15 2023, 5:52 PM
F37599578: image.png
Aug 21 2023, 9:21 AM
F37519383: Screenshot 2023-08-16 at 4.48.57 PM.png
Aug 16 2023, 10:06 PM
F37497194: IMG_5271.PNG
Aug 16 2023, 10:06 PM
F37497190: IMG_5272.PNG
Aug 16 2023, 10:06 PM
F37497007: IMG_5270.PNG
Aug 16 2023, 10:06 PM
F37497013: IMG_5273.PNG
Aug 16 2023, 10:06 PM

Description

Background

Allow contributors and readers to share a Wiki story.
Reader- are able to share with others across other platforms.
Contributor- are able to share the stories they create across other platforms

Description/User story

As a wikistory editor on idwiki,
I want to share a wiki story that I've created
So that readers can discover content in form of stories available on Wikipedia.

As a wikistory reader on idwiki,
I want to share a wiki story,
So that other readers can discover content in form of stories available on Wikipedia.

As a recipient of a wikistory shared link,
I want to view the link that I have received,
So that I can consume content in form of stories available on Wikipedia.

Design

Story Editor Sharing a Story

01 Publish screen without Confetti.png (780×360 px, 27 KB)
03 Sharing option.png (780×360 px, 36 KB)
  • After the story editor hits the 'Publish' button, existing loading spinner appears while the story is being processed for publishing.
  • Once the publishing process is complete, the spinner disappears and is replaced with a 'Story Published' confirmation screen.
  • Along with the confirmation message, editor will see option of reading a story or sharing a story.
  • Tapping the reading option would take them to the story viewer.
  • Tapping the share button opens a dialog with various sharing options (like social media platforms, copy link, etc.)
  • The editor can select an option to share the story.

Story Reader Sharing a Story

04 Sharing discovery on viewer.png (780×360 px, 438 KB)
05. Sharing viewer popup.png (780×360 px, 182 KB)
  • A visible "Share" icon should be included on each story's page.
  • Tapping the share button opens a dialog with various sharing options (like social media platforms, copy link, etc.)
  • The editor can select an option to share the story.

Story Recipient's Share Flow

04 Sharing discovery on viewer.png (780×360 px, 423 KB)
  • When a recipient clicks on a shared story link, they are directed to the story viewer.
  • A story preview, including the title, lead image, should be generated when the story's link is shared on social media platforms or messaging apps that support link previews.
  • They'll experience a basic version of the story which won't include the following items - 'close icon', 'edit' option inside overflow menu, and 'Read more' page which appears at the end of the story.

Design file

Error handling

Error 01 - story doesn't exist.png (780×360 px, 19 KB)
Error 02 - unknown erorr.png (780×360 px, 19 KB)
  • If a user tries to access a story that doesn't exist or has been deleted, an error message should be displayed stating, "The Wikistory you're trying to access does not exist".
  • Server or connection issues - If there are server-side issues while sharing a story, display a message saying "Something went wrong, please try again later".




Note: Initially, we will be implementing a basic version of the sharing feature that allows the sharing of story links.

Acceptance Criteria
  1. There should be a CTA to share the link. This should invoke the mobile device's share function.
  2. There should be a CTA to copy the link to the story
Test Scenarios
  1. After publishing a story, there should be a section that intuitively shows the Wikistory link, with some text to explain this easily.
  2. The user should see an indication to copy the link.
  3. The user should see an indication to share the link using a mobile's Share function.
  4. If a user is on the desktop view, clicking on the link as a reader should open the Wikipage in mobile browser view.
  5. Anon users should be able to click and view a wiki story
Open questions

a) To what extent do anon readers view a shared story? What will their experience be like:

  • on the story viewer?
  • or on a "vanilla/ plain" viewer?
  • which CTAs should we show or not show? feedback/ edit/ create/ further share

b) Community feedback: curation and editing burden [office hours topic]

  • Since the last discussion, moderation features on wikistories have been included to mitigate editorial burden
  • The community still feels the feature needs to remain in beta but still be able to share wikistories.

c) Legal, Branding and Communications

d) Stories wouldn't be seen as social media preview is influenced by the independent platforms.

Tech notes

To share some text, or a file, or a URL on mobile, we can use the browser's share api. It opens up the native share dialog. It does nothing on desktop.

Additional notes
  1. Journey of the person sharing

Creator: share option after publishing; while you are viewing(reader) the output of your story
Reader: share option after reading.

  1. Journey of the person receiving

Currently: shows entire article then the user has to click show the story viewer
Option 1: story viewer (loads the article then loads the viewer- slow)
Option 2: story page
Option 3: new page that shows the story preview, then loads the story viewer. At the end of the story,

  • add a link back to the article/ redirect to the article [if there are no other stories to display for this article]
  • options to see other stories in the article.
  • OR special web page for other stories
  • OR create a wiki story
  • visual brand identity showing the origin (wikipedia), link to the article

Event Timeline

There are a very large number of changes, so older changes are hidden. Show Older Changes

@PWaigi-WMF When a user shares a link, will it come with some text like: Here is a story titled ABC shared from Wikipedia: {link}. or will it just be the link?

Change 862291 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/Wikistories@master] SPIKE: share buttons

https://gerrit.wikimedia.org/r/862291

Test wiki created on Patch demo by SBisson (WMF) using patch(es) linked to this task:
https://patchdemo.wmflabs.org/wikis/45d94cff02/w

Change 862291 abandoned by Sbisson:

[mediawiki/extensions/Wikistories@master] SPIKE: share buttons

Reason:

https://gerrit.wikimedia.org/r/862291

Test wiki on Patch demo by SBisson (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmflabs.org/wikis/45d94cff02/w/

Change 927665 had a related patch set uploaded (by Sbisson; author: Sbisson):

[mediawiki/extensions/Wikistories@master] Share story

https://gerrit.wikimedia.org/r/927665

SBisson triaged this task as Medium priority.Jun 8 2023, 2:38 PM
SBisson moved this task from Dev to Code Review on the Inuka-Team (Kanban) board.

Test wiki created on Patch demo by SBisson (WMF) using patch(es) linked to this task:
https://patchdemo.wmflabs.org/wikis/4c1171c7ff/w

Change 927665 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@master] Share story

https://gerrit.wikimedia.org/r/927665

Test wiki on Patch demo by SBisson (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmflabs.org/wikis/4c1171c7ff/w/

Test wiki on Patch demo by SBisson (WMF) using patch(es) linked to this task was deleted:

https://patchdemo.wmflabs.org/wikis/3e41665bc0/w/

Hello, here are a few testing notes from while I was going through this share functionality.


⛔ from the AC If a user is on the desktop view, clicking on the link as a reader should open the Wikipage in mobile browser view

Clicking on the link as a reader does not currently open it in a mobile browser view, and the link is not sent as the mobile browser view.
For example, this is one of the pages that was sent https://id.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Barat&action=storyview instead of the mobile view of https://id.m.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Barat&action=storyview


⛔ When a reader opens a shared link to a wikistory (desktop chrome, mobile chrome) and clicks the link to change the text size, the <ul> should have list-style-type: none or some other styling that does not display the decoration for the ul - right now it is list-style-disc. And also the font is not loading correctly - it is a different font than what is seen by the Story Reader Sharing a Story. See below:

Chrome, desktop:

Screenshot 2023-08-15 at 4.19.17 PM.png (1×3 px, 1 MB)

Story reader sharing a story (Chrome, iPhoneSE):

IMG_5273.PNG (1×750 px, 1 MB)
IMG_5270.PNG (1×750 px, 636 KB)

Recipient of a wikistory shared link (Chrome, iPhoneSE):

IMG_5272.PNG (1×750 px, 1 MB)
IMG_5271.PNG (1×750 px, 607 KB)

Note that the fonts are different in the Change text size / Share your feedback dropdown and also the Text size dialog.


⛔ There is a bug in error handling if a user attempts to view a story that does not exist. For example, this https://en.m.wikipedia.beta.wmflabs.org/w/index.php?title=Story:CRS_in_Pariss,_2022&action=storyview

This is what should be shown, per the task description:

Error 01 - story doesn't exist.png (780×360 px, 19 KB)

But this is what displays (chrome desktop, but same error testing on mobile):

Screenshot 2023-08-16 at 4.48.57 PM.png (1×1 px, 381 KB)

This will also cause an error in prod, for example: https://id.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Baratt&action=storyview will throw a 500 error with the text [51291c5c-87d5-49bf-bf28-66d63e00852d] 2023-08-16 21:57:35: Kekecualian fatal tipe "Error" shown in the UI.


❓ One additional thought, it might be a good idea to also include some context when an email is sent, for example. "Here is a wikistory I thought you might be interested in" or something along those lines. Right now all that is shared is the link, but some descriptive copy would be helpful as well.


❓ Also, is there a reason that in desktop there is no share button? Is this intentional?

hueitan subscribed.

⛔ If a user is on the desktop view, clicking on the link as a reader should open the Wikipage in mobile browser view

@SGautam_WMF I don't know whether this is necessary, because the view has no difference when i visit both links here
https://en.m.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview
https://en.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview

❓ One additional thought, it might be a good idea to also include some context when an email is sent, for example. "Here is a wikistory I thought you might be interested in" or something along those lines. Right now all that is shared is the link, but some descriptive copy would be helpful as well.

This is a good suggestion; @PWaigi-WMF @SGautam_WMF we can use another ticket if this requires more thinking

❓ Also, is there a reason that in desktop there is no share button? Is this intentional?

we use the native share feature (navigator.share) on mobile; therefore desktop doesn't have the share button;
maybe we can do "Copy link" on desktop so they can share it?

image.png (490×505 px, 52 KB)

⛔ change text size dialog bullet ul li on storyview
⛔ There is a bug in error handling if a user attempts to view a story that does not exist.

@vaughnwalters Thanks for these, i will bring this back to dev for the update.

Hello, here are a few testing notes from while I was going through this share functionality.


⛔ from the AC If a user is on the desktop view, clicking on the link as a reader should open the Wikipage in mobile browser view

Clicking on the link as a reader does not currently open it in a mobile browser view, and the link is not sent as the mobile browser view.
For example, this is one of the pages that was sent https://id.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Barat&action=storyview instead of the mobile view of https://id.m.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Barat&action=storyview


⛔ When a reader opens a shared link to a wikistory (desktop chrome, mobile chrome) and clicks the link to change the text size, the <ul> should have list-style-type: none or some other styling that does not display the decoration for the ul - right now it is list-style-disc. And also the font is not loading correctly - it is a different font than what is seen by the Story Reader Sharing a Story. See below:

Chrome, desktop:

Screenshot 2023-08-15 at 4.19.17 PM.png (1×3 px, 1 MB)

Story reader sharing a story (Chrome, iPhoneSE):

IMG_5273.PNG (1×750 px, 1 MB)
IMG_5270.PNG (1×750 px, 636 KB)

Recipient of a wikistory shared link (Chrome, iPhoneSE):

IMG_5272.PNG (1×750 px, 1 MB)
IMG_5271.PNG (1×750 px, 607 KB)

Note that the fonts are different in the Change text size / Share your feedback dropdown and also the Text size dialog.

Thanks for pointing this out. @hueitan I am assuming we are going to take care of this as well?

⛔ There is a bug in error handling if a user attempts to view a story that does not exist. For example, this https://en.m.wikipedia.beta.wmflabs.org/w/index.php?title=Story:CRS_in_Pariss,_2022&action=storyview

This is what should be shown, per the task description:

Error 01 - story doesn't exist.png (780×360 px, 19 KB)

But this is what displays (chrome desktop, but same error testing on mobile):

Screenshot 2023-08-16 at 4.48.57 PM.png (1×1 px, 381 KB)

This will also cause an error in prod, for example: https://id.wikipedia.org/w/index.php?title=Story:10_Museum_di_Sumatera_Baratt&action=storyview will throw a 500 error with the text [51291c5c-87d5-49bf-bf28-66d63e00852d] 2023-08-16 21:57:35: Kekecualian fatal tipe "Error" shown in the UI.

Agreed. @hueitan shall we create a new task for it or are we planning to address it in this task itself?

❓ One additional thought, it might be a good idea to also include some context when an email is sent, for example. "Here is a wikistory I thought you might be interested in" or something along those lines. Right now all that is shared is the link, but some descriptive copy would be helpful as well.

That's a good point. We can discuss more on it and decide about it.

❓ Also, is there a reason that in desktop there is no share button? Is this intentional?

⛔ If a user is on the desktop view, clicking on the link as a reader should open the Wikipage in mobile browser view

@SGautam_WMF I don't know whether this is necessary, because the view has no difference when i visit both links here
https://en.m.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview
https://en.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview

Ok, if both the views are identical then I think we can skip it also assuming we are not going to show the share icon for desktop users? Btw, I also noticed when I click on this url(https://en.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview) on mobile browser then it converts into mobile compatible version(https://en.m.wikipedia.beta.wmflabs.org/w/index.php?title=Story:Universal_Studios&action=storyview) of it, just to make sure it's the expected behavior.

❓ Also, is there a reason that in desktop there is no share button? Is this intentional?

@hueitan @SGautam_WMF @vaughnwalters We intentionally prioritised this for mobile and not desktop; at least for now unless we get a request for this.

Change 952360 had a related patch set uploaded (by Huei Tan; author: Huei Tan):

[mediawiki/extensions/Wikistories@master] ul style for the text size confirm dialog

https://gerrit.wikimedia.org/r/952360

⛔ change text size dialog bullet ul li on storyview

Done in the latest patch

⛔ There is a bug in error handling if a user attempts to view a story that does not exist.

This requires more dev effort, moving it to another ticket T344990: Error handling for the storyview action page

Change 952360 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@master] ul style for the text size confirm dialog

https://gerrit.wikimedia.org/r/952360


⛔ When a reader opens a shared link to a wikistory (desktop chrome, mobile chrome) and clicks the link to change the text size, the <ul> should have list-style-type: none or some other styling that does not display the decoration for the ul - right now it is list-style-disc. And also the font is not loading correctly - it is a different font than what is seen by the Story Reader Sharing a Story. See below:

Chrome, desktop:

Screenshot 2023-08-15 at 4.19.17 PM.png (1×3 px, 1 MB)

Story reader sharing a story (Chrome, iPhoneSE):

IMG_5273.PNG (1×750 px, 1 MB)
IMG_5270.PNG (1×750 px, 636 KB)

Recipient of a wikistory shared link (Chrome, iPhoneSE):

IMG_5272.PNG (1×750 px, 1 MB)
IMG_5271.PNG (1×750 px, 607 KB)

Note that the fonts are different in the Change text size / Share your feedback dropdown and also the Text size dialog.

The <ul> does correctly have list-style-type: none now to not display the text decoration, but the font for the recipient of a wikistory shared link is still incorrect as shown above Example

Change 955981 had a related patch set uploaded (by Eamedina; author: Eamedina):

[mediawiki/extensions/Wikistories@master] Story viewer font

https://gerrit.wikimedia.org/r/955981

Change 955981 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@master] Story viewer font

https://gerrit.wikimedia.org/r/955981


⛔ When a reader opens a shared link to a wikistory (desktop chrome, mobile chrome) and clicks the link to change the text size, the <ul> should have list-style-type: none or some other styling that does not display the decoration for the ul - right now it is list-style-disc. And also the font is not loading correctly - it is a different font than what is seen by the Story Reader Sharing a Story. See below:

Chrome, desktop:

Screenshot 2023-08-15 at 4.19.17 PM.png (1×3 px, 1 MB)

Story reader sharing a story (Chrome, iPhoneSE):

IMG_5273.PNG (1×750 px, 1 MB)
IMG_5270.PNG (1×750 px, 636 KB)

Recipient of a wikistory shared link (Chrome, iPhoneSE):

IMG_5272.PNG (1×750 px, 1 MB)
IMG_5271.PNG (1×750 px, 607 KB)

Note that the fonts are different in the Change text size / Share your feedback dropdown and also the Text size dialog.

The <ul> does correctly have list-style-type: none now to not display the text decoration, but the font for the recipient of a wikistory shared link is still incorrect as shown above Example

This is fixed now now, sending to design sign off

Example

Screenshot 2023-09-15 at 12.50.37 PM.png (162×340 px, 39 KB)
Screenshot 2023-09-15 at 12.50.51 PM.png (1×1 px, 1 MB)