Merge pull request #53 from inpercima/copilot/enhance-extract-method-with-cast-info

Enhance list items with cast, original title, and release date

Author: inpercima

api/rest/list.php

@@ -10,5 +10,5 @@
 $language = $coreService->getParam('language');
 
 $listService = new ListService();
-echo $listService->listAll($listId, $language);
+echo $listService->getListDetails($listId, $language);
 ?>

api/service/list.service.php

@@ -8,25 +8,34 @@ class ListService {
   public function __construct() {}
 
   /**
-   * List all title from a public list in themoviedb.
+   * List all items from a public list from themoviedb with their details.
    */
-  public function listAll($listId, $language) {
+  public function getListDetails($listId, $language) {
     $page = 1;
-    $data = $this->request($listId, $language, $page);
+    $data = $this->getList($listId, $language, $page);
     $items = $this->extract($data);
     $totalPages = $data->total_pages;
     for ($i = $page + 1; $i <= $totalPages; $i++) {
-      $items = array_merge($items, $this->extract($this->request($listId, $language, $i)));
+      $items = array_merge($items, $this->extract($this->getList($listId, $language, $i)));
     }
     return json_encode(array("name" => $data->name, "description" => $data->description, "items" => $items));
   }
 
   /**
-   * Executes one or multiple requests to get all items from a public list in themoviedb.
+   * Fetches a public list from themoviedb with the given list ID, language and page number.
    */
-  private function request($listId, $language, $page) {
+  private function getList($listId, $language, $page) {
     $apiKey = Config::API_KEY;
-    return json_decode(file_get_contents("https://api.themoviedb.org/4/list/$listId?api_key=$apiKey&language=$language&page=$page"));
+    $url = "https://api.themoviedb.org/3/list/$listId?api_key=$apiKey&language=$language&page=$page";
+    $response = @file_get_contents($url);
+    if ($response === false) {
+      return (object) [];
+    }
+    $data = json_decode($response);
+    if ($data === null || !isset($data->items)) {
+      return (object) [];
+    }
+    return $data;
   }
 
   /**
@@ -37,12 +46,42 @@ private function extract($data) {
     foreach($data->results as $key => $value) {
       $mediaType = $value->media_type;
       $title = $mediaType == 'tv' ? $value->name : $value->title;
+      $originalTitle = $mediaType == 'tv' ? $value->original_name : $value->original_title;
+      $releaseDate = $mediaType == 'tv' ? $value->first_air_date : $value->release_date;
       $commentId = "$mediaType:$value->id";
       $comment = $data->comments->$commentId;
       $comment = $comment == null ? '' : $comment;
-      array_push($items, (object) [ 'title' => $title, 'comment' => nl2br($comment) ]);
+      $cast = $this->getCast($value->id, $mediaType);
+      array_push($items, (object) [
+        'title' => $title,
+        'original_title' => $originalTitle,
+        'release_date' => $releaseDate,
+        'cast' => $cast,
+        'comment' => nl2br($comment)
+      ]);
     }
     return $items;
   }
+
+  /**
+   * Fetches the top 5 main actors for a movie or TV show from the TMDB v3 credits endpoint.
+   */
+  private function getCast($movieId, $mediaType) {
+    $apiKey = Config::API_KEY;
+    $endpoint = $mediaType == 'tv' ? 'tv' : 'movie';
+    $url = "https://api.themoviedb.org/3/$endpoint/$movieId/credits?api_key=$apiKey";
+    $response = @file_get_contents($url);
+    if ($response === false) {
+      return [];
+    }
+    $credits = json_decode($response);
+    if ($credits === null || !isset($credits->cast)) {
+      return [];
+    }
+    $mainActors = array_slice($credits->cast, 0, 5);
+    return array_map(function($actor) {
+      return $actor->name;
+    }, $mainActors);
+  }
 }
 ?>

frontend/src/app/features/dashboard/dashboard.html

@@ -52,6 +52,9 @@
       <mat-list-item lines="70">
         <mat-icon aria-hidden="false" matListItemIcon>movie</mat-icon>
         <span matListItemTitle>{{ item.title }}</span>
+        <span aria-label="Original title">{{ item.original_title }}</span>
+        <span aria-label="Release date">{{ item.release_date }}</span>
+        <span aria-label="Cast">{{ item.cast.join(', ') }}</span>
         <span [innerHTML]="item.comment"></span>
       </mat-list-item>
       }

frontend/src/app/features/dashboard/item.model.ts

@@ -1,4 +1,7 @@
 export interface Item {
   title: string;
+  original_title: string;
+  release_date: string;
+  cast: string[];
   comment: string;
 }