aboutsummaryrefslogtreecommitdiffhomepage
path: root/application/feed/FeedBuilder.php
diff options
context:
space:
mode:
Diffstat (limited to 'application/feed/FeedBuilder.php')
-rw-r--r--application/feed/FeedBuilder.php299
1 files changed, 299 insertions, 0 deletions
diff --git a/application/feed/FeedBuilder.php b/application/feed/FeedBuilder.php
new file mode 100644
index 00000000..b66f2f91
--- /dev/null
+++ b/application/feed/FeedBuilder.php
@@ -0,0 +1,299 @@
1<?php
2namespace Shaarli\Feed;
3
4use DateTime;
5
6/**
7 * FeedBuilder class.
8 *
9 * Used to build ATOM and RSS feeds data.
10 */
11class FeedBuilder
12{
13 /**
14 * @var string Constant: RSS feed type.
15 */
16 public static $FEED_RSS = 'rss';
17
18 /**
19 * @var string Constant: ATOM feed type.
20 */
21 public static $FEED_ATOM = 'atom';
22
23 /**
24 * @var string Default language if the locale isn't set.
25 */
26 public static $DEFAULT_LANGUAGE = 'en-en';
27
28 /**
29 * @var int Number of links to display in a feed by default.
30 */
31 public static $DEFAULT_NB_LINKS = 50;
32
33 /**
34 * @var \Shaarli\Bookmark\LinkDB instance.
35 */
36 protected $linkDB;
37
38 /**
39 * @var string RSS or ATOM feed.
40 */
41 protected $feedType;
42
43 /**
44 * @var array $_SERVER
45 */
46 protected $serverInfo;
47
48 /**
49 * @var array $_GET
50 */
51 protected $userInput;
52
53 /**
54 * @var boolean True if the user is currently logged in, false otherwise.
55 */
56 protected $isLoggedIn;
57
58 /**
59 * @var boolean Use permalinks instead of direct links if true.
60 */
61 protected $usePermalinks;
62
63 /**
64 * @var boolean true to hide dates in feeds.
65 */
66 protected $hideDates;
67
68 /**
69 * @var string server locale.
70 */
71 protected $locale;
72
73 /**
74 * @var DateTime Latest item date.
75 */
76 protected $latestDate;
77
78 /**
79 * Feed constructor.
80 *
81 * @param \Shaarli\Bookmark\LinkDB $linkDB LinkDB instance.
82 * @param string $feedType Type of feed.
83 * @param array $serverInfo $_SERVER.
84 * @param array $userInput $_GET.
85 * @param boolean $isLoggedIn True if the user is currently logged in,
86 * false otherwise.
87 */
88 public function __construct($linkDB, $feedType, $serverInfo, $userInput, $isLoggedIn)
89 {
90 $this->linkDB = $linkDB;
91 $this->feedType = $feedType;
92 $this->serverInfo = $serverInfo;
93 $this->userInput = $userInput;
94 $this->isLoggedIn = $isLoggedIn;
95 }
96
97 /**
98 * Build data for feed templates.
99 *
100 * @return array Formatted data for feeds templates.
101 */
102 public function buildData()
103 {
104 // Search for untagged links
105 if (isset($this->userInput['searchtags']) && empty($this->userInput['searchtags'])) {
106 $this->userInput['searchtags'] = false;
107 }
108
109 // Optionally filter the results:
110 $linksToDisplay = $this->linkDB->filterSearch($this->userInput);
111
112 $nblinksToDisplay = $this->getNbLinks(count($linksToDisplay));
113
114 // Can't use array_keys() because $link is a LinkDB instance and not a real array.
115 $keys = array();
116 foreach ($linksToDisplay as $key => $value) {
117 $keys[] = $key;
118 }
119
120 $pageaddr = escape(index_url($this->serverInfo));
121 $linkDisplayed = array();
122 for ($i = 0; $i < $nblinksToDisplay && $i < count($keys); $i++) {
123 $linkDisplayed[$keys[$i]] = $this->buildItem($linksToDisplay[$keys[$i]], $pageaddr);
124 }
125
126 $data['language'] = $this->getTypeLanguage();
127 $data['last_update'] = $this->getLatestDateFormatted();
128 $data['show_dates'] = !$this->hideDates || $this->isLoggedIn;
129 // Remove leading slash from REQUEST_URI.
130 $data['self_link'] = escape(server_url($this->serverInfo))
131 . escape($this->serverInfo['REQUEST_URI']);
132 $data['index_url'] = $pageaddr;
133 $data['usepermalinks'] = $this->usePermalinks === true;
134 $data['links'] = $linkDisplayed;
135
136 return $data;
137 }
138
139 /**
140 * Build a feed item (one per shaare).
141 *
142 * @param array $link Single link array extracted from LinkDB.
143 * @param string $pageaddr Index URL.
144 *
145 * @return array Link array with feed attributes.
146 */
147 protected function buildItem($link, $pageaddr)
148 {
149 $link['guid'] = $pageaddr . '?' . $link['shorturl'];
150 // Check for both signs of a note: starting with ? and 7 chars long.
151 if ($link['url'][0] === '?' && strlen($link['url']) === 7) {
152 $link['url'] = $pageaddr . $link['url'];
153 }
154 if ($this->usePermalinks === true) {
155 $permalink = '<a href="' . $link['url'] . '" title="' . t('Direct link') . '">' . t('Direct link') . '</a>';
156 } else {
157 $permalink = '<a href="' . $link['guid'] . '" title="' . t('Permalink') . '">' . t('Permalink') . '</a>';
158 }
159 $link['description'] = format_description($link['description'], '', false, $pageaddr);
160 $link['description'] .= PHP_EOL . '<br>&#8212; ' . $permalink;
161
162 $pubDate = $link['created'];
163 $link['pub_iso_date'] = $this->getIsoDate($pubDate);
164
165 // atom:entry elements MUST contain exactly one atom:updated element.
166 if (!empty($link['updated'])) {
167 $upDate = $link['updated'];
168 $link['up_iso_date'] = $this->getIsoDate($upDate, DateTime::ATOM);
169 } else {
170 $link['up_iso_date'] = $this->getIsoDate($pubDate, DateTime::ATOM);
171 }
172
173 // Save the more recent item.
174 if (empty($this->latestDate) || $this->latestDate < $pubDate) {
175 $this->latestDate = $pubDate;
176 }
177 if (!empty($upDate) && $this->latestDate < $upDate) {
178 $this->latestDate = $upDate;
179 }
180
181 $taglist = array_filter(explode(' ', $link['tags']), 'strlen');
182 uasort($taglist, 'strcasecmp');
183 $link['taglist'] = $taglist;
184
185 return $link;
186 }
187
188 /**
189 * Set this to true to use permalinks instead of direct links.
190 *
191 * @param boolean $usePermalinks true to force permalinks.
192 */
193 public function setUsePermalinks($usePermalinks)
194 {
195 $this->usePermalinks = $usePermalinks;
196 }
197
198 /**
199 * Set this to true to hide timestamps in feeds.
200 *
201 * @param boolean $hideDates true to enable.
202 */
203 public function setHideDates($hideDates)
204 {
205 $this->hideDates = $hideDates;
206 }
207
208 /**
209 * Set the locale. Used to show feed language.
210 *
211 * @param string $locale The locale (eg. 'fr_FR.UTF8').
212 */
213 public function setLocale($locale)
214 {
215 $this->locale = strtolower($locale);
216 }
217
218 /**
219 * Get the language according to the feed type, based on the locale:
220 *
221 * - RSS format: en-us (default: 'en-en').
222 * - ATOM format: fr (default: 'en').
223 *
224 * @return string The language.
225 */
226 public function getTypeLanguage()
227 {
228 // Use the locale do define the language, if available.
229 if (!empty($this->locale) && preg_match('/^\w{2}[_\-]\w{2}/', $this->locale)) {
230 $length = ($this->feedType === self::$FEED_RSS) ? 5 : 2;
231 return str_replace('_', '-', substr($this->locale, 0, $length));
232 }
233 return ($this->feedType === self::$FEED_RSS) ? 'en-en' : 'en';
234 }
235
236 /**
237 * Format the latest item date found according to the feed type.
238 *
239 * Return an empty string if invalid DateTime is passed.
240 *
241 * @return string Formatted date.
242 */
243 protected function getLatestDateFormatted()
244 {
245 if (empty($this->latestDate) || !$this->latestDate instanceof DateTime) {
246 return '';
247 }
248
249 $type = ($this->feedType == self::$FEED_RSS) ? DateTime::RSS : DateTime::ATOM;
250 return $this->latestDate->format($type);
251 }
252
253 /**
254 * Get ISO date from DateTime according to feed type.
255 *
256 * @param DateTime $date Date to format.
257 * @param string|bool $format Force format.
258 *
259 * @return string Formatted date.
260 */
261 protected function getIsoDate(DateTime $date, $format = false)
262 {
263 if ($format !== false) {
264 return $date->format($format);
265 }
266 if ($this->feedType == self::$FEED_RSS) {
267 return $date->format(DateTime::RSS);
268 }
269 return $date->format(DateTime::ATOM);
270 }
271
272 /**
273 * Returns the number of link to display according to 'nb' user input parameter.
274 *
275 * If 'nb' not set or invalid, default value: $DEFAULT_NB_LINKS.
276 * If 'nb' is set to 'all', display all filtered links (max parameter).
277 *
278 * @param int $max maximum number of links to display.
279 *
280 * @return int number of links to display.
281 */
282 public function getNbLinks($max)
283 {
284 if (empty($this->userInput['nb'])) {
285 return self::$DEFAULT_NB_LINKS;
286 }
287
288 if ($this->userInput['nb'] == 'all') {
289 return $max;
290 }
291
292 $intNb = intval($this->userInput['nb']);
293 if (!is_int($intNb) || $intNb == 0) {
294 return self::$DEFAULT_NB_LINKS;
295 }
296
297 return $intNb;
298 }
299}