Android User Manual - bounswe/2021SpringGroup9 GitHub Wiki

Android User Manual

Discover Page

Filter and Explore

On the discover page, users are able to see their own posts, posts of people they follow along with posts from users whose profiles are not private. Posts are denoted with a little red marker on the map, stating their locations. Below is a figure of an examplary discover page. (see Fig1).


Fig1: Discover Page - 1

An example discovery page can be seen above (see Fig1). Users can specify their filters below the map. Here, users can enter tag, date, keyword, user, and area to filter the posts. After specifying the filters of choice, users can see the resulting posts either on the map (i.e., by clicking the Filter and Display on Map button) or on a different page (i.e., by clicking the Show Results button).

An example sequence of filtering is explained below step by step:

  1. Here, the user first enters a tag fun into Enter a tag input space, clicks on Add, and clicks on the Filter and Display on Map button (see red dashed button on Fig2). The resulting markers represent the posts containing the tag fun.


Fig2: Discover Page - 2

  1. Later the user filters the results by specifying an area of choice. Here, the user first puts a blue marker on the map by long clicking on it (see the blue marker on Fig1) which represents the center of the area that is specified. Then the user enters 100 into Enter km2 input space and clicks on Enter.(see Fig3)


Fig3: Discover Page - 3

  1. Finally, the user clicks on the Filter and Display on Map button again and sees the resulting posts on the map. (see Fig4)


Fig4: Discover Page - 4

Users can click on the red markers, representing the posts, and see the brief information about the posts (i.e., its title and author) in a pop-up (see Fig4). They can click on the pop-up to see the full posts on a View Page (see View Post Page)

Users can also clear all the filters, using the red Clear Filters button (see Fig4).

Users are able to see the resulting posts after applying the filters on a different page, in order to see the full posts like in the Home Page (see Home Page), by clicking the Show Results button (see button on Fig4). They will be directed to a page like a Home Page, to see the resulting posts of a filter operation (see Fig5).


Fig5: Discover Page - 5

Related Search

When the users specifies a tag, the app also includes the tags related to the post, by making use of a WikiData based service. This service returns all related tags, and they are included in the search. These can can be seen below the page, when the user clicks on it. (see Fig6)


Fig6: Discover Page - 6

Clear Filters

Users can also clear all the filters, using the red Clear Filters button (see Fig4). The default state of the discovery page is shown when this is done and all the filters are removed.

Profile Page

The profile page is where users can see information (i.e., username, profile picture, number of followers, number of followings, and number of posts) of public users and private users they follow, and their posts. There are differences between the profile page that is seen by the owner and profile page seen by the others.

Profile Page of Other Users


Fig7: Profile Page - 1


Fig8: Profile Page - 2

Users can interact with users (i.e., follow/unfollow) by clicking the Follow button (see button in red square on Fig7). If it is a private profile, a follow request will be sent to that user. If a user already follows another one, when she navigates to that user’s profile, she sees the Unfollow button (see button in red square on Fig8)

The user can also report other users from their profile page. (see Exclamation mark in red square on Fig7)

Profile Page Seen by the Owner

When a user is on her own profile page, she does not see a Follow or Unfollow (see Fig9). The user sees a switch to adjust the privacy option of (see Switch inside red square), which makes their account public/private on click.

There is also a button to see the pending follow requests that are received by the user (see 'Requests button' inside red square), which leads to the follow requests page.


Fig9: Profile Page - 3

View Post Page

In the view post page, users can see more information (location, comments, likes) about the post along with the information they saw on the main page. They can like a post and comment on it or report it (see Fig10, Fig11, Fig12, Fig13,Fig14).


Fig10: View Post Page - 1

Users can see the rest of the body of the post by clicking the Continue Reading button (see Fig10). They can comment on that specific post by entering the comment into the input area and then clicking on the Confirm button (see Fig11, Fig12).


Fig11: View Post Page - Comment




Fig12: View Post Page - Comment - 2

Users can also like a post by clicking the heart shaped button (see Fig13) and see the number of likes increase.


Fig13: View Post Page - Like

One last feature is reporting a post.

An example report action is described below:

  1. A user sees a post he/she doesn't like.
  2. User goes to the View Post Page.
  3. Clicks on the button with the report icon. (see Fig10)
  4. User sees the prompt confirming his/her action was succesful. (see Fig14)


Fig14: View Post Page - Report

Homepage

In the homepage, users are able to see posts from his/her followed users and his/her own. Users can click on the eye button on the right side of the posts to go the View Post page to have a closer look. Users can also click on the profile of the post owner to go to his/her profile page. User can also click on the plus button on top of the page to create a new post, click the world icon to go to the discover page and click the pen icon to edit the post, if they are allowed to do so. (see Fig15)



Fig15: Homepage

Create/Edit Post Page

After entering various inputs, specifying a post photo, a title, a body, tags and geolocations, users can create posts. Below, you can see the initial look of the Create Post page. (see Fig16)


Fig16: Create Post - Initial look


1. When the user wants to add a photo for the post, he/she should click on the placeholder image in the center and choose on the following from the appearing tab to add a photo from the gallery or to take a photo.


Fig17: Create Post - Add Photo


  1. After that if the user wants to add locations to the post, he can click the pin icon, which prompts him/her to a map.(see Fig18) After long clicking a location, a text box appears which the user can write a location name to. (see Fig19) With this, choosing location is done.


Fig18: Create Post - Choose Location




Fig19: Create Post - Name Location


3. User can also choose a timeframe for the post, by clicking the calendar icon. (*see Fig16*). Another fragment shows up and there the user can choose a time interval by specifying the year, month and so on. (*see Fig20*)


Fig20: Create Post - Add Time


  1. After writing a title and a body to the story, user can add tags to the post by writing words to the tags section with one blank space between each of them. (see Fig21) If the user is content with the post, he/she can click the Send Post button (see Fig21) and post it. After the post is succesfully created, he/she will be redirected to the homepage.(see Fig22).


Fig21: Create Post - Final Look




Fig22: Create Post - Post on the homepage

Editing a post

Editing a post can be done by clicking the pen icon on the homepage or the View post page. This functionality uses the same page as the Create Post page but for editing, the features of a post are already displayed. User can edit various features of a post, including the tags, geolocation, the title, the date and the story. Upon changing the desired fields, user can click the Send Post button (see Fig23) so that the post will be updated and the user will be directed to the homepage.


Fig23: Editing a post

Activity Stream Page

Activity stream page lets a user see their own activities and activities of followed people.


Fig24: Activity Stream

  1. Own tab: Show activities committed by the current user. Activities include creating, editing, liking and commenting on posts and following other users.
  2. Followed tab: Shows activities of followed people.

User Search page

User Search page lets users see the results of user search by nickname feature.

In Fig25 below, you can see the result of search with the term "me".


Fig25: User Search

In *Fig25* all the users with nicknames that include "me" are retrieved. The user can navigate to profiles of these users by clicking the "eye button" that is marked inside the red square.

Sign In Page

Sign In page lets user sign in to Postory with their e-mail and password.


Fig26: Sign In page

  1. E-mail field: Lets user enter their e-mail
  2. Password field: Lets user enter their password
  3. Sign In: Lets user submit their sign in with the entered info
  4. Forgot Password button: Prompts user for their e-mail and initiates a password reset request.
  5. Sign Up button: Redirects to Sign Up page

Forgot Password Page

Forgot password page lets user to reset her password via writing her e-mail address. When the user successfully sends a reset request, a link for password reset is sent to her email.


Fig27: Forgot Password Page

  1. E-mail field: Lets user enter her e-mail address
  2. Reset button: Lets user send request for a password reset. After reset request is sent, the user is redirected to Sign In page.
  3. Cancel button: Lets user close this page and redirect back to Sign In page.

Sign Up Page

Sign Up page lets people sign up to Postory with their information. It also checks for validity of the entered input.


Fig28: Sign Up page

  1. Name field: Lets person enter their name for the new account.
  2. Surname field: Lets person enter their surname for the new account.
  3. E-mail field: Lets person enter their e-mail for the new account
  4. Username field: Lets person enter their username for the new account
  5. Password field: Lets person enter their password for the new account.
  6. Repeat password field: Lets person enter their password confirmation.
  7. Sign Up button: Submits the sign up with the entered information.

After the sign up button is pressed, an email is sent to the given mail address for activation. The user can activate her account with that link.

Toolbar

Toolbar becomes visible after the user signs in. It is used for navigation among activities.


Fig29: Toolbar - 1

In Fig29:

  1. Lets user go to Create Post Page.
  2. Lets user go to Discovery Page.
  3. Lets user extend the toolbar.

When the toolbar is extended, new options are visible, which are visible in FigYY


Fig30: Toolbar - 2

In *Fig30:*
  1. Lets user refresh the page.
  2. Lets user go to homepage.
  3. Lets user go to her profile page.
  4. Lets user search for other users.
  5. Lets user go to Activity Streams page.
  6. Lets user sign out.

When '7' is clicked, the toolbar provides a search bar for searching users as it can be seen in Fig31:


Fig31: Toolbar - 3

In Fig31:

  1. Is the field for writing username.
  2. Lets user cancel the search operation.
  3. Lets user complete the search.
⚠️ **GitHub.com Fallback** ⚠️