Added Code comment

Author: vincentlieu

app/controllers/listings_controller.rb

@@ -4,10 +4,9 @@ class ListingsController < ApplicationController
   before_action :set_listing, only: [:show, :favourite]
 
   def index()
-    #Set search condition to only listings that HAVE NOT been purchased
-    @search = Listing.where(purchased: false).search(params[:q])
+    #Set search condition and display all listings to only listings that HAVE NOT been purchased.
 
-    #Show listings that HAVE NOT been purchased
+    @search = Listing.where(purchased: false).search(params[:q])
     @listings = @search.result.paginate(page: params[:page], per_page: 16).order("id DESC")
   end
 
@@ -90,6 +89,7 @@ def destroy()
   end
 
   def favourite()
+    # Add or remove the current user's favourite listing. The listing is either INSERTED or REMOVED from the favourites table.
     type = params[:type]
     if type == "favourite"
       current_user.favourites << @listing

app/controllers/pages_controller.rb

@@ -1,5 +1,6 @@
 class PagesController < ApplicationController
   def home()
+    #Only show the latest listings that have not been purchased.
     @listings = Listing.where(purchased: false).last(4)
   end
 

app/controllers/payments_controller.rb

@@ -2,6 +2,7 @@ class PaymentsController < ApplicationController
   skip_before_action :verify_authenticity_token, only: [:webhook]
 
   def success()
+    #Return the user's latest purchase.
     @purchase = current_user.purchases.last
     @listing = current_user.purchases.last.listing
   end
@@ -14,6 +15,7 @@ def webhook()
 
     @listing = Listing.find_by_id(listing_id).update(purchased: :true)
 
+    #Create a new record in the Purchase table when payment has been made.
     Purchase.create(
       user_id: user_id,
       listing_id: listing_id,

app/controllers/users_controller.rb

@@ -11,10 +11,12 @@ def favourites()
   end
 
   def purchases()
+    # Show user purchases sorted in DESCENDING order.
     @purchases = current_user.purchases.order("id DESC")
   end
 
   def listings()
+    # Show user listings sorted in DESCENDING order.
     @listings = current_user.listings.order("id DESC")
   end
 

app/views/listings/index.html.erb

@@ -11,8 +11,8 @@
                 <%= form.submit "Search", class: " btn btn-primary" %>
             </div>
         </div>
-        
     <% end %>
+    
         <div class="sort-links-container">
             <div class="sort-links">
                 <%= sort_link @search, :title, "Title" %>