src/Controller/DocsController.php line 47

Open in your IDE?
  1. <?php
  3. namespace App\Controller;
  5. use App\DataProvider\PageItemDataProvider;
  6. use App\Entity\PageOutput;
  7. use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
  8. use Symfony\Component\HttpFoundation\Response;
  9. use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
  10. use Symfony\Component\Routing\Annotation\Route;
  12. class DocsController extends AbstractController
  13. {
  14.     private $pageItemDataProvider;
  16.     /**
  17.      * DocsController constructor.
  18.      * @param PageItemDataProvider $pageItemDataProvider
  19.      */
  20.     public function __construct(
  21.         PageItemDataProvider $pageItemDataProvider
  22.     ) {
  23.         $this->pageItemDataProvider = $pageItemDataProvider;
  24.     }
  26.     /**
  27.      * @return Response
  28.      *
  29.      * @Route("/services", name="services_redirect")
  30.      */
  31.     public function redirectServices(): Response
  32.     {
  33.         return $this->redirectToRoute("docs", [], Response::HTTP_MOVED_PERMANENTLY);
  34.     }
  36.     /**
  37.      * @Route("/docs", name="docs")
  38.      * @Route("/docs/{category}", name="docs_page")
  39.      * @Route("/docs/{category}/{section}", name="docs_page")
  40.      * @Route("/docs/{category}/{section}/{old}", name="docs_page_old")
  41.      *
  42.      * @param string $category
  43.      * @param string $section
  44.      * @param string|null $old
  45.      * @return Response
  46.      */
  47.     public function getPage(
  48.         string $category = "getting-started",
  49.         string $section = "introduction",
  50.         string $old = null
  51.     ): Response {
  52.         $slug = $this->pageItemDataProvider->translatePathToSlug($category, $section);
  53.         /** @var PageOutput $page */
  54.         $page = $this->pageItemDataProvider->getPage($slug);
  56.         // This should clean up the remaining pages we removed from search engines
  57.         if (null === $page) {
  58.             return new Response('', Response::HTTP_GONE);
  59.         }
  61.         return $this->render('docs/page.html.twig', [
  62.             'page' => $page,
  63.         ]);
  64.     }
  66.     /**
  67.      * @Route("/account/docs", name="account_docs")
  68.      * @Route("/account/docs/{category}", name="account_docs_page")
  69.      * @Route("/account/docs/{category}/{section}", name="account_docs_page")
  70.      *
  71.      * @param string $category
  72.      * @param string|null $section
  73.      * @return Response
  74.      */
  75.     public function docsPage(string $category = "getting-started", string $section = null): Response
  76.     {
  77.         $slug = $this->pageItemDataProvider->translatePathToSlug($category, $section);
  79.         /** @var PageOutput $page */
  80.         $page = $this->pageItemDataProvider->getPage($slug);
  82.         if (null === $page) {
  83.             throw new NotFoundHttpException(sprintf('Page "%s" was not found', $category));
  84.         }
  86.         return $this->render('account/docs_page.html.twig', [
  87.             'page' => $page,
  88.         ]);
  89.     }
  90. }