part_3.md

Part 3: Really remember the sorting and filtering settings (70 points)

OK, so the user can now click on the "Movie Title" or "Release Date" headings and see movies sorted by those columns, and can additionally use the checkboxes to restrict the listing to movies with certain ratings only. And we have preserved RESTfulness, because the URI itself always contains the parameters that will control sorting and filtering. And changing one setting doesn't forget the other settings. We did all this by carefully controlling which parameters get passed in either the form submit button (which uses GET) or the column headers (regular <a> hyperlinks, which also use GET).

But there's one more problem. If you navigate away from the Index view (say, to view the details of a movie) and then click the Back to List button to go back to the Index view, it seems to forget the sorting and filtering settings as well. (Go ahead and verify this.)

Why is the sorting/checkbox-filtering setting "forgotten" when you navigate to a Movie Details page and then click the Back to List button?

The Back to List button is just a link for the RESTful route `GET /movies`, but in parts 1 and 2, we have been adding extra parameters to the route (in both the form submission and the column header links) to encode those settings.

So the last step is to remember these settings even if the user navigates away from and then back to the list of movies.

Fortunately, HTTP-based SaaS has a way to "remember" state across otherwise-stateless requests: cookies. In Rails, the session[] hash provides a nice abstraction for using cookies: anything you put in there will basically be preserved for as long as that user's browser continues to correctly maintain cookies for your app. (In other words, comparing it to something you've seen before, the session is like the flash[], except that once you set something in the session[] it is remembered "forever" until you reset the session with session.clear or selectively delete things from it with session.delete(:some_key).)

A big caveat: Since the default storage for the contents of session is a browser cookie, (a) users who reset or clear their cookies will also reset the session for RottenPotatoes (and many other sites), and (b) the contents of the session, once serialized, cannot exceed the size of an HTTP cookie (4 KiB).

Hints and caveats

Once you have determined the correct sorting and filtering settings, before you render the view, use session[] to hold on to the those settings.

Now modify the index action to detect whether no params[] were passed that indicate sorting or filtering: this would be one way to tell that the user is landing on the home page not having followed one of the special links we made in parts 1 and 2.

What might be some other ways to tell if this is the case?

One possibility is to look at the HTTP `Referer` [sic] header, which tells what page the user just came from when following a link. (Exercise: check the Rails docs to learn how to get access to the headers.) However, to keep things at the same level of abstraction, it's more reliable to use `params`. We could, e.g., add a special value in `params` for the links served on the home page that explicitly marks the links as being on the home page, say `params[:home]=1`. Then the absence of `params[:home]` means the user got to the home page from someplace else.

Be careful: If the user explicitly includes new sorting/filtering settings in params[], the new values of those settings should then be saved.

As before, if a user unchecks all checkboxes, it means "display all ratings."

When you're done with this part

Deploy to Heroku by following the same process as before-- and as before, make sure you have run git add and committed all new or changed files that are part of your project:

$ git commit -am "part 3 complete"
$ git push heroku master

We also strongly recommend that you push your code to your remote repository to permanently save your work somewhere other than your local development environment (whether that's Codio or your own computer):

$ git push origin master