src/Controller/UserGroup/PublicGroupController.php line 102

Open in your IDE?
  1. <?php
  3. namespace App\Controller\UserGroup;
  5. use App\Entity\Member;
  6. use App\Entity\UserGroup;
  7. use App\Service\UserGroups\GroupMemberService;
  8. use App\Service\UserGroups\GroupService;
  9. use App\StructSerializer\Main\StructGroup;
  10. use App\StructSerializer\Main\StructOptions;
  11. use App\StructSerializer\Main\StructSerializer;
  12. use Nelmio\ApiDocBundle\Annotation\Model;
  13. use Swagger\Annotations as SWG;
  14. use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
  15. use Symfony\Component\HttpFoundation\JsonResponse;
  16. use Symfony\Component\HttpFoundation\Request;
  17. use Symfony\Component\Routing\Annotation\Route;
  19. /**
  20.  * @Route("/api/public/group")
  21.  */
  22. class PublicGroupController extends AbstractController
  23. {
  24.     protected GroupService $service;
  26.     protected GroupMemberService $groupMemberService;
  28.     protected StructSerializer $structSerializer;
  30.     public function __construct(GroupService $service, GroupMemberService $groupMemberService,
  31.         StructSerializer $structSerializer)
  32.     {
  33.         $this->service = $service;
  34.         $this->structSerializer = $structSerializer;
  35.         $this->groupMemberService = $groupMemberService;
  36.     }
  38.     /**
  39.      * @SWG\Get(tags={"Groups"},
  40.      *
  41.      *    @SWG\Response(response=200, description="Details for a group",
  42.      *
  43.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroup::class, groups={"grouplist", "groupdetails"}))),
  44.      *
  45.      *    @SWG\Parameter(name="group", in="path", type="integer", description="ID of the group entity")
  46.      * )
  47.      *
  48.      * @Route("/{group}", methods={ "GET"}, requirements={"group": "\d+"})
  49.      */
  50.     public function group(UserGroup $group): JsonResponse
  51.     {
  52.         $options = StructOptions::create(StructGroup::SHORT);
  54.         return new JsonResponse($this->structSerializer->toArray($options, $group));
  55.     }
  57.     /**
  58.      * @SWG\Get(tags={"Groups"},
  59.      *
  60.      *    @SWG\Response(response=200, description="Details for a group by its url slug",
  61.      *
  62.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroup::class, groups={"grouplist", "groupdetails"}))),
  63.      *
  64.      *    @SWG\Parameter(name="slug", in="path", type="string", required=true, description="Slug of the group entity")
  65.      * )
  66.      *
  67.      * @Route("/{slug}", methods={"GET"})
  68.      */
  69.     public function slug(string $slug): JsonResponse
  70.     {
  71.         if (!$group = $this->service->findBySlug($slug)) {
  72.             throw $this->createNotFoundException();
  73.         }
  75.         $options = StructOptions::create(StructGroup::SHORT);
  77.         return new JsonResponse($this->structSerializer->toArray($options, $group));
  78.     }
  80.     /**
  81.      * @SWG\Get(tags={"Groups"},
  82.      *
  83.      *    @SWG\Response(response=200, description="Paginated list of public group entities",
  84.      *
  85.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroup::class, groups={"grouplist"}))),
  86.      *
  87.      *    @SWG\Parameter(name="category", in="path", type="integer", required=true, description="Group category, zero for all entities"),
  88.      *    @SWG\Parameter(name="page", in="path", type="integer", required=true, description="Requested page for pagination"),
  89.      *    @SWG\Parameter(name="limit", in="query", type="integer", required=false, default=20, description="Number of items per page for pagination")
  90.      * )
  91.      *
  92.      * @Route("/index/public/{category}/{page}", methods={"GET"}, requirements={"page": "\d+", "category": "\d+"})
  93.      */
  94.     public function publicindex(Request $request, int $category, int $page = 1): JsonResponse
  95.     {
  96.         $limit = $request->query->getInt('limit', 20);
  97.         $paginator = $this->service->getPublicGroupIndex($category, $page, $limit);
  99.         $options = StructOptions::create(StructGroup::SHORT);
  101.         return new JsonResponse([
  102.             'data' => $this->structSerializer->multipleToArray($options, $paginator),
  103.             'total' => $paginator->count(),
  104.         ]);
  105.     }
  107.     /**
  108.      * @SWG\Get(tags={"Groups"},
  109.      *
  110.      *    @SWG\Response(response=200, description="Paginated list of top-rated group entities",
  111.      *
  112.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroup::class, groups={"grouplist"}))),
  113.      *
  114.      *    @SWG\Parameter(name="category", in="path", type="integer", required=true, description="Group category, zero for all entities"),
  115.      *    @SWG\Parameter(name="page", in="path", type="integer", required=true, description="Requested page for pagination"),
  116.      *    @SWG\Parameter(name="limit", in="query", type="integer", required=false, default=20, description="Number of items per page for pagination")
  117.      * )
  118.      *
  119.      * @Route("/index/top/{category}/{page}", methods={"GET"}, requirements={"page": "\d+", "category": "\d+"})
  120.      */
  121.     public function topindex(Request $request, int $category, int $page): JsonResponse
  122.     {
  123.         $limit = $request->query->getInt('limit', 20);
  124.         $paginator = $this->service->getTopRatedGroupIndex($category, $page, $limit);
  126.         $options = StructOptions::create(StructGroup::SHORT);
  128.         return new JsonResponse([
  129.             'data' => $this->structSerializer->multipleToArray($options, $paginator),
  130.             'total' => $paginator->count(),
  131.         ]);
  132.     }
  134.     /**
  135.      * @SWG\Get(tags={"Groups"},
  136.      *
  137.      *    @SWG\Response(response=200, description="Paginated list of invite-only group entities",
  138.      *
  139.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroup::class, groups={"grouplist"}))),
  140.      *
  141.      *    @SWG\Parameter(name="category", in="path", type="integer", required=true, description="Group category, zero for all entities"),
  142.      *    @SWG\Parameter(name="page", in="path", type="integer", required=true, description="Requested page for pagination"),
  143.      *    @SWG\Parameter(name="limit", in="query", type="integer", required=false, default=20, description="Number of items per page for pagination")
  144.      * )
  145.      *
  146.      * @Route("/index/inviteonly/{category}/{page}", methods={"GET"}, requirements={"page": "\d+", "category": "\d+"})
  147.      */
  148.     public function inviteonlyindex(Request $request, int $category, int $page = 1): JsonResponse
  149.     {
  150.         $limit = $request->query->getInt('limit', 20);
  151.         $paginator = $this->service->getInviteOnlyGroupIndex($category, $page, $limit);
  153.         $options = StructOptions::create(StructGroup::SHORT);
  155.         return new JsonResponse([
  156.             'data' => $this->structSerializer->multipleToArray($options, $paginator),
  157.             'total' => $paginator->count(),
  158.         ]);
  159.     }
  161.     /**
  162.      * @SWG\Get(tags={"Groups"},
  163.      *
  164.      *    @SWG\Response(response=200, description="List of public group membership entities for given member",
  165.      *
  166.      *     @SWG\Schema(ref=@Model(type=App\Entity\UserGroupMember::class, groups={"membergrouplist", "groupdetails"}))),
  167.      *
  168.      *    @SWG\Parameter(name="member", in="path", type="integer", required=true, description="Get group memberships of a given member")
  169.      * )
  170.      *
  171.      * @Route("/member/{member}", methods={"GET"}, requirements={"member": "\d+"})
  172.      */
  173.     public function publicGroups(Member $member): JsonResponse
  174.     {
  175.         $paginator = $this->groupMemberService->getGroupMembershipsForMember($member, null, 1, 99);
  177.         $options = StructOptions::create(StructGroup::SHORT);
  179.         return new JsonResponse([
  180.             'data' => $this->structSerializer->multipleToArray($options, $paginator),
  181.             'total' => $paginator->count(),
  182.         ]);
  183.     }
  184. }