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.
Note: Samples below don’t always meet all the requirements. Make sure to follow the requirements rather than solely relying on the samples.
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
- 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.
- Create the following new files:
moviedb.htmlfile for all the HTML,
style.cssfile for all CSS, and
- 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.
- 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.
XMLHttpRequestobject 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).
.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
public_htmlfolder. Then upload this assignment HTML file and images to the
assignment5folder. 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.htmlto check that the assignment file has been uploaded correctly.
- One last thing. In your computer, open up
student_page.htmlthat you created in Lab 1. Add a link to this assignment to
student_page.htmlunder the heading “Assignments” so that the TAs can easily access your completed assignment.
- Upload the updated
student_page.htmlto the itpwebdev server via FileZilla inside the
public_htmlfolder. 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.
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.
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.