]>
Commit | Line | Data |
---|---|---|
1 | <?php | |
2 | ||
3 | declare(strict_types=1); | |
4 | ||
5 | namespace Shaarli\Front\Controller\Visitor; | |
6 | ||
7 | use Shaarli\Bookmark\BookmarkFilter; | |
8 | use Shaarli\Container\ShaarliContainer; | |
9 | use Slim\Http\Request; | |
10 | use Slim\Http\Response; | |
11 | ||
12 | /** | |
13 | * Class ShaarliVisitorController | |
14 | * | |
15 | * All controllers accessible by visitors (non logged in users) should extend this abstract class. | |
16 | * Contains a few helper function for template rendering, plugins, etc. | |
17 | * | |
18 | * @package Shaarli\Front\Controller\Visitor | |
19 | */ | |
20 | abstract class ShaarliVisitorController | |
21 | { | |
22 | /** @var ShaarliContainer */ | |
23 | protected $container; | |
24 | ||
25 | /** @param ShaarliContainer $container Slim container (extended for attribute completion). */ | |
26 | public function __construct(ShaarliContainer $container) | |
27 | { | |
28 | $this->container = $container; | |
29 | } | |
30 | ||
31 | /** | |
32 | * Assign variables to RainTPL template through the PageBuilder. | |
33 | * | |
34 | * @param mixed $value Value to assign to the template | |
35 | */ | |
36 | protected function assignView(string $name, $value): self | |
37 | { | |
38 | $this->container->pageBuilder->assign($name, $value); | |
39 | ||
40 | return $this; | |
41 | } | |
42 | ||
43 | /** | |
44 | * Assign variables to RainTPL template through the PageBuilder. | |
45 | * | |
46 | * @param mixed $data Values to assign to the template and their keys | |
47 | */ | |
48 | protected function assignAllView(array $data): self | |
49 | { | |
50 | foreach ($data as $key => $value) { | |
51 | $this->assignView($key, $value); | |
52 | } | |
53 | ||
54 | return $this; | |
55 | } | |
56 | ||
57 | protected function render(string $template): string | |
58 | { | |
59 | $this->assignView('linkcount', $this->container->bookmarkService->count(BookmarkFilter::$ALL)); | |
60 | $this->assignView('privateLinkcount', $this->container->bookmarkService->count(BookmarkFilter::$PRIVATE)); | |
61 | $this->assignView('plugin_errors', $this->container->pluginManager->getErrors()); | |
62 | ||
63 | $this->executeDefaultHooks($template); | |
64 | ||
65 | return $this->container->pageBuilder->render($template); | |
66 | } | |
67 | ||
68 | /** | |
69 | * Call plugin hooks for header, footer and includes, specifying which page will be rendered. | |
70 | * Then assign generated data to RainTPL. | |
71 | */ | |
72 | protected function executeDefaultHooks(string $template): void | |
73 | { | |
74 | $common_hooks = [ | |
75 | 'includes', | |
76 | 'header', | |
77 | 'footer', | |
78 | ]; | |
79 | ||
80 | foreach ($common_hooks as $name) { | |
81 | $pluginData = []; | |
82 | $this->container->pluginManager->executeHooks( | |
83 | 'render_' . $name, | |
84 | $pluginData, | |
85 | [ | |
86 | 'target' => $template, | |
87 | 'loggedin' => $this->container->loginManager->isLoggedIn() | |
88 | ] | |
89 | ); | |
90 | $this->assignView('plugins_' . $name, $pluginData); | |
91 | } | |
92 | } | |
93 | ||
94 | /** | |
95 | * Generates a redirection to the previous page, based on the HTTP_REFERER. | |
96 | * It fails back to the home page. | |
97 | * | |
98 | * @param array $loopTerms Terms to remove from path and query string to prevent direction loop. | |
99 | * @param array $clearParams List of parameter to remove from the query string of the referrer. | |
100 | */ | |
101 | protected function redirectFromReferer( | |
102 | Request $request, | |
103 | Response $response, | |
104 | array $loopTerms = [], | |
105 | array $clearParams = [], | |
106 | string $anchor = null | |
107 | ): Response { | |
108 | $defaultPath = rtrim($request->getUri()->getBasePath(), '/') . '/'; | |
109 | $referer = $this->container->environment['HTTP_REFERER'] ?? null; | |
110 | ||
111 | if (null !== $referer) { | |
112 | $currentUrl = parse_url($referer); | |
113 | parse_str($currentUrl['query'] ?? '', $params); | |
114 | $path = $currentUrl['path'] ?? $defaultPath; | |
115 | } else { | |
116 | $params = []; | |
117 | $path = $defaultPath; | |
118 | } | |
119 | ||
120 | // Prevent redirection loop | |
121 | if (isset($currentUrl)) { | |
122 | foreach ($clearParams as $value) { | |
123 | unset($params[$value]); | |
124 | } | |
125 | ||
126 | $checkQuery = implode('', array_keys($params)); | |
127 | foreach ($loopTerms as $value) { | |
128 | if (strpos($path . $checkQuery, $value) !== false) { | |
129 | $params = []; | |
130 | $path = $defaultPath; | |
131 | break; | |
132 | } | |
133 | } | |
134 | } | |
135 | ||
136 | $queryString = count($params) > 0 ? '?'. http_build_query($params) : ''; | |
137 | $anchor = $anchor ? '#' . $anchor : ''; | |
138 | ||
139 | return $response->withRedirect($path . $queryString . $anchor); | |
140 | } | |
141 | } |