862798 - About:home "Saved for later" panel (reading list)

Status: RESOLVED FIXED

(Firefox for Android Graveyard :: General, defect, P1)

Description

[Ian Barlow (:ibarlow)]

This is the bug to track work on the new "saved for later" panel on about:home, which will first be used to display the user's Reading List.

Note that we will be looking at ways to display the Reading list in a more useful and editorial way, instead of the current title/URL implementation. The new list should display

* Title
* Intro
* Picture, if available
* Length of article, in minutes

Mockups to follow shortly.

Comment 1

[Ian Barlow (:ibarlow)]

Attachment: Mockups of "Reading list" panel

Comment 2

[Ian Barlow (:ibarlow)]

This bug should include work for:

* Displaying a more editorial list of articles (using twitter cards, for example)
* Calculating the length of the article, in minutes

Comment 3

[Mark Finkle (:mfinkle) (use needinfo?)]

(In reply to Ian Barlow (:ibarlow) from comment #2)
> This bug should include work for:
> 
> * Displaying a more editorial list of articles (using twitter cards, for
> example)
> * Calculating the length of the article, in minutes

Open a new bug for any new features. This bug is about feature parity with current "reading list"

Comment 4

[:Margaret Leibovic]

I can take this (implementing feature parity with the current reading list).

Comment 5

[:Margaret Leibovic]

Attachment: patch

I feel like I did a bit too much copy/pasting to get to this patch, but it gets the job done. It's probably not worth factoring some of the copy/pasted stuff out into some shared superclass, since we'll be customizing the views of this page later.

I still don't fully understand how CursorLoaders work, so I very well may have done something wrong :)

One known issue here is that I need to add that "Articles you save for later go here" message when the list is empty, but I figured that could be done in a follow-up.

Comment 6

[:Margaret Leibovic]

Attachment: screenshot

Comment 7

[Sriram Ramasubramanian [:sriram]]

Comment on attachment 770495 [details] [diff] [review]
patch

Review of attachment 770495 [details] [diff] [review]:
-----------------------------------------------------------------

Looks really good. Only thing is the use of SimpleCursorAdapter. I would like to switch that to CursorAdapter, and see a version.
Other than that, everything else is fine. r- just to see a version with CursorAdapter.

::: mobile/android/base/home/ReadingListPage.java
@@ +42,5 @@
> +    // Callbacks used for the reading list and favicon cursor loaders
> +    private CursorLoaderCallbacks mCursorLoaderCallbacks;
> +
> +    // Inflater used by the adapter
> +    private LayoutInflater mInflater;

This is not needed.

@@ +60,5 @@
> +            throw new ClassCastException(activity.toString()
> +                    + " must implement HomePager.OnUrlOpenListener");
> +        }
> +
> +        mInflater = (LayoutInflater) activity.getSystemService(Context.LAYOUT_INFLATER_SERVICE);

Not needed.

@@ +135,5 @@
> +            return BrowserDB.getBookmarksInFolder(getContext().getContentResolver(), Bookmarks.FIXED_READING_LIST_ID);
> +        }
> +    }
> +
> +    private class ReadingListAdapter extends SimpleCursorAdapter {

Please use a CursorAdapter.

@@ +144,5 @@
> +        @Override
> +        public View getView(int position, View convertView, ViewGroup parent) {
> +            final TwoLinePageRow row;
> +            if (convertView == null) {
> +                row = (TwoLinePageRow) mInflater.inflate(R.layout.home_item_row, mList, false);

This could be a direct call like,

row = new TwoLinePageRow(parent.getContext());

Hence you won't need an mInflater. And that part will be in newView(). bindView() will take care of coversion.

@@ +150,5 @@
> +                row = (TwoLinePageRow) convertView;
> +            }
> +
> +            final Cursor c = getCursor();
> +            if (!c.moveToPosition(position)) {

This won't be needed when CursorAdapter is used. Always the cursor is moved to required position.

@@ +160,5 @@
> +            return row;
> +        }
> +    }
> +
> +    private class CursorLoaderCallbacks implements LoaderCallbacks<Cursor> {

A small documentation may be?

Comment 8

[Brian Nicholson (:bnicholson)]

Comment on attachment 770495 [details] [diff] [review]
patch

Review of attachment 770495 [details] [diff] [review]:
-----------------------------------------------------------------

r+ with Sriram's comments addressed.

::: mobile/android/base/home/ReadingListPage.java
@@ +47,5 @@
> +
> +    // On URL open listener
> +    private OnUrlOpenListener mUrlOpenListener;
> +
> +    public ReadingListPage() { }

This is unnecessary since Java automatically creates a default constructor if none are specified.

Comment 9

[:Margaret Leibovic]

Attachment: patch v2

Updated to address comments.

Comment 10

[Sriram Ramasubramanian [:sriram]]

Comment on attachment 770541 [details] [diff] [review]
patch v2

Review of attachment 770541 [details] [diff] [review]:
-----------------------------------------------------------------

Looks good.

::: mobile/android/base/home/ReadingListPage.java
@@ +44,5 @@
> +
> +    // On URL open listener
> +    private OnUrlOpenListener mUrlOpenListener;
> +
> +    public ReadingListPage() { }

Please remove this.

Comment 11

[:Margaret Leibovic]

https://hg.mozilla.org/projects/fig/rev/7f1cfc8c84e8

Comment 12

[:Margaret Leibovic]

Backed out for build failures:
https://hg.mozilla.org/projects/fig/rev/35f62a290d4e

I'll look into fixing and relanding.

Comment 13

[:Margaret Leibovic]

Turned out I botched resolving a conflict in the Makefile. Fixed:
https://hg.mozilla.org/projects/fig/rev/b689792b6fd2

Comment 14

[Ed Morley [:emorley]]

https://hg.mozilla.org/mozilla-central/rev/b689792b6fd2