Overview
For this assignment, you will create a web page that allows users to search for movies and display some basic information about the movie. You will use AJAX to access two (2) different endpoints of The Movie DB API (version 3). You will need to read through this API’s documentation to understand how to work with this endpoint.
Sample
Note: Samples below don’t always meet all the requirements. Make sure to follow the requirements rather than solely relying on the samples.
Requirements
Utilizing the Movie DB API
- Go to the Movie DB API documentation at https://developers.themoviedb.org/3/getting-started.
- Read the “Introduction” section. You will learn that you need to create an API key to authenticate your API calls. Create an account and obtain an API key as instructed.
- The first API request you will need to make is to get the movies that are currently playing in theaters. Click through some of the bolded links on the left sidebar of the documentation (Account, Authentication, Credits, etc). You will see that there are numerous endpoints available. Clicking on any endpoint gives you details about the endpoint such as parameters, responses, etc. Look for the one that sounds like you can call to get movies that are currently playing in theaters.
- Once you find the endpoint you need, Movie DB API has a nifty tool that allows you to test out the endpoint with your API key and show the results you would get when calling this endpoint. To access this tool, click on the endpoint then click on the Try it out tab. Enter your API key in the
api_key
field.
- Click on SEND REQUEST button and you should see results in JSON format. Get familiar with the JSON keys that are returned because you will need them. Any errors will be displayed if something is wrong.
- Next to the SEND REQUEST button, you will also see the full endpoint (with recommended parameters included). This is the endpoint you want to call.
Layout
- Create the following new files:
moviedb.html
file for all the HTML,
style.css
file for all CSS, and
main.js
file for all the JavaScript.
- Title at the top of the page.
- Search box and submit button.
- Text that shows how many movies are displayed and how many movies there are in total.
- Ex: Showing 20 of 878 result(s).
- A layout that displays the movie’s poster image, title, and release date.
- Do NOT use tables.
- Mobile (0-767px): show 2 columns per row
- Tablet (768px-991px): show 3 columns per row
- Desktop (991px and above): show 4 columns per row
- When a user hovers over the specific movie, show the movie’s rating, number of voters, and synopsis on top of the movie’s poster image.
- If the movie does NOT have a poster image, show an image that says “Not available” or similar.
- If the movie’s synopsis is over 200 characters, append “…” at the end.
- Rating and synopsis must fit on the top of the movie image. Do not let the text go outside the movie image.
- Page and text need to be readable. Ensure colors complement each other.
- You may use Bootstrap, but it is not required.
JavaScript
- Create a separate function named
ajax()
that will make a request to the API.
- Allow the function to take in two parameters – the endpoint and the function that will be called when results are returned.
- You will find having this function is useful because you will need to make two AJAX calls for this assignment.
- Do not use jQuery’s ajax function if you know what that is. You must use native JavaScript’s
XMLHttpRequest
object like shown in lecture.
- Upon the first load of the page, display movies that are currently playing in theaters.
- When user submits a search term, display movies that match the search query.
- If no results are found, display an appropriate message.
- Do not worry about implementing pagination. You can just display the first page of results.
- Number of results shown vs returned must be updated when page first loads and every time a new search term is submitted.
- Ex: Showing 20 of 878 result(s).
- When displaying movies, must use JavaScript’s
.createElement()
method to create elements.
Submission/Upload to the server
Please follow the submission requirements below carefully. You will be deducted points for not following submission requirements to the teeth.
- Open FileZilla and connect to the itpwebdev server as you have done in Lab 1 (click File -> Site Manager). If you forgot how to connect, follow this guide on how to connect and upload files to the itpwebdev web server.
- After you have successfully connected to the itpwebdev server, created a folder (aka directory) named
assignment5
inside the public_html
folder. Then upload this assignment HTML file and images to the assignment5
folder. Refer to the guide if you’re not sure how to upload the assignment file.
- In your browser, go to
http://303.itpwebdev.com/~yourusername/assignment5/moviedb.html
to check that the assignment file has been uploaded correctly.
- One last thing. In your computer, open up
student_page.html
that you created in Lab 1. Add a link to this assignment to student_page.html
under the heading “Assignments” so that the TAs can easily access your completed assignment.
- Upload the updated
student_page.html
to the itpwebdev server via FileZilla inside the public_html
folder. If it asks you want to overwrite the previous file, click Yes.
- (Optional) If you are having trouble uploading to the server and cannot upload on time, add all files for this assignment in a folder, compress it as a .zip file and upload it to Blackboard. On Blackboard, go to Assignments -> Assignment 5: Movie DB API Search. You will get some points deducted for not uploading correctly but at least you will not get a zero.
Suggested Workflow
There are many ways to implement this assignment. If you don’t know where to start, here’s a suggested workflow:
- Register for Movie DB API key, find the first endpoint you need and Try it out to make sure your API key is working.
- Create a brand new HTML file. Set up the
ajax()
function and make a request to the API. Log out the results to ensure you successfully received a response back.
- If you get back a successful response, pause on working on the JavaScript for now. Start laying out the page with HTML/CSS. While Bootstrap is not required, it may be helpful in creating the responsive layout.
- Although you will need to create movie elements using JavaScript, write out HTML to create a few movies first. Hardcode the title, image, rating, synopsis, etc to ensure the layout meets all the requirements first.
- Back to JavaScript! Write JavaScript to create the movie elements. Use
console.log()
to see which keys you need to use to get the movie’s title, image, rating, etc. Start with creating outer elements first and make your way in. Test incrementally. Don’t try to create everything at once. Use the Inspect Element tool to ensure that you are building elements as you want them to be.
- Once all the movies currently in theaters are displayed, the code to display search results is very similar.