]>
git.immae.eu Git - github/shaarli/Shaarli.git/blob - FeedBuilder.php
ddefe6ce93a83ed8f6869d1eee57941264731e72
6 * Used to build ATOM and RSS feeds data.
11 * @var string Constant: RSS feed type.
13 public static $FEED_RSS = 'rss';
16 * @var string Constant: ATOM feed type.
18 public static $FEED_ATOM = 'atom';
21 * @var string Default language if the locale isn't set.
23 public static $DEFAULT_LANGUAGE = 'en-en';
26 * @var int Number of links to display in a feed by default.
28 public static $DEFAULT_NB_LINKS = 50;
31 * @var LinkDB instance.
36 * @var string RSS or ATOM feed.
41 * @var array $_SERVER.
43 protected $serverInfo;
51 * @var boolean True if the user is currently logged in, false otherwise.
53 protected $isLoggedIn;
56 * @var boolean Use permalinks instead of direct links if true.
58 protected $usePermalinks;
61 * @var boolean true to hide dates in feeds.
66 * @var string PubSub hub URL.
68 protected $pubsubhubUrl;
71 * @var string server locale.
76 * @var DateTime Latest item date.
78 protected $latestDate;
83 * @param LinkDB $linkDB LinkDB instance.
84 * @param string $feedType Type of feed.
85 * @param array $serverInfo $_SERVER.
86 * @param array $userInput $_GET.
87 * @param boolean $isLoggedIn True if the user is currently logged in, false otherwise.
89 public function __construct($linkDB, $feedType, $serverInfo, $userInput, $isLoggedIn)
91 $this->linkDB
= $linkDB;
92 $this->feedType
= $feedType;
93 $this->serverInfo
= $serverInfo;
94 $this->userInput
= $userInput;
95 $this->isLoggedIn
= $isLoggedIn;
99 * Build data for feed templates.
101 * @return array Formatted data for feeds templates.
103 public function buildData()
105 // Optionally filter the results:
106 $linksToDisplay = $this->linkDB
->filterSearch($this->userInput
);
108 $nblinksToDisplay = $this->getNbLinks(count($linksToDisplay));
110 // Can't use array_keys() because $link is a LinkDB instance and not a real array.
112 foreach ($linksToDisplay as $key => $value) {
116 $pageaddr = escape(index_url($this->serverInfo
));
117 $linkDisplayed = array();
118 for ($i = 0; $i < $nblinksToDisplay && $i < count($keys); $i++
) {
119 $linkDisplayed[$keys[$i]] = $this->buildItem($linksToDisplay[$keys[$i]], $pageaddr);
122 $data['language'] = $this->getTypeLanguage();
123 $data['pubsubhub_url'] = $this->pubsubhubUrl
;
124 $data['last_update'] = $this->getLatestDateFormatted();
125 $data['show_dates'] = !$this->hideDates
|| $this->isLoggedIn
;
126 // Remove leading slash from REQUEST_URI.
127 $data['self_link'] = $pageaddr . escape(ltrim($this->serverInfo
['REQUEST_URI'], '/'));
128 $data['index_url'] = $pageaddr;
129 $data['usepermalinks'] = $this->usePermalinks
=== true;
130 $data['links'] = $linkDisplayed;
136 * Build a feed item (one per shaare).
138 * @param array $link Single link array extracted from LinkDB.
139 * @param string $pageaddr Index URL.
141 * @return array Link array with feed attributes.
143 protected function buildItem($link, $pageaddr)
145 $link['guid'] = $pageaddr .'?'. smallHash($link['linkdate']);
146 // Check for both signs of a note: starting with ? and 7 chars long.
147 if ($link['url'][0] === '?' && strlen($link['url']) === 7) {
148 $link['url'] = $pageaddr . $link['url'];
150 if ($this->usePermalinks
=== true) {
151 $permalink = '<a href="'. $link['url'] .'" title="Direct link">Direct link</a>';
153 $permalink = '<a href="'. $link['guid'] .'" title="Permalink">Permalink</a>';
155 $link['description'] = format_description($link['description']) . PHP_EOL
.'<br>— '. $permalink;
157 $date = DateTime
::createFromFormat(LinkDB
::LINK_DATE_FORMAT
, $link['linkdate']);
159 if ($this->feedType
== self
::$FEED_RSS) {
160 $link['iso_date'] = $date->format(DateTime
::RSS
);
162 $link['iso_date'] = $date->format(DateTime
::ATOM
);
165 // Save the more recent item.
166 if (empty($this->latestDate
) || $this->latestDate
< $date) {
167 $this->latestDate
= $date;
170 $taglist = array_filter(explode(' ', $link['tags']), 'strlen');
171 uasort($taglist, 'strcasecmp');
172 $link['taglist'] = $taglist;
178 * Assign PubSub hub URL.
180 * @param string $pubsubhubUrl PubSub hub url.
182 public function setPubsubhubUrl($pubsubhubUrl)
184 $this->pubsubhubUrl
= $pubsubhubUrl;
188 * Set this to true to use permalinks instead of direct links.
190 * @param boolean $usePermalinks true to force permalinks.
192 public function setUsePermalinks($usePermalinks)
194 $this->usePermalinks
= $usePermalinks;
198 * Set this to true to hide timestamps in feeds.
200 * @param boolean $hideDates true to enable.
202 public function setHideDates($hideDates)
204 $this->hideDates
= $hideDates;
208 * Set the locale. Used to show feed language.
210 * @param string $locale The locale (eg. 'fr_FR.UTF8').
212 public function setLocale($locale)
214 $this->locale
= strtolower($locale);
218 * Get the language according to the feed type, based on the locale:
220 * - RSS format: en-us (default: 'en-en').
221 * - ATOM format: fr (default: 'en').
223 * @return string The language.
225 public function getTypeLanguage()
227 // Use the locale do define the language, if available.
228 if (! empty($this->locale
) && preg_match('/^\w{2}[_\-]\w{2}/', $this->locale
)) {
229 $length = ($this->feedType
== self
::$FEED_RSS) ? 5 : 2;
230 return str_replace('_', '-', substr($this->locale
, 0, $length));
232 return ($this->feedType
== self
::$FEED_RSS) ? 'en-en' : 'en';
236 * Format the latest item date found according to the feed type.
238 * Return an empty string if invalid DateTime is passed.
240 * @return string Formatted date.
242 protected function getLatestDateFormatted()
244 if (empty($this->latestDate
) || !$this->latestDate
instanceof DateTime
) {
248 $type = ($this->feedType
== self
::$FEED_RSS) ? DateTime
::RSS
: DateTime
::ATOM
;
249 return $this->latestDate
->format($type);
253 * Returns the number of link to display according to 'nb' user input parameter.
255 * If 'nb' not set or invalid, default value: $DEFAULT_NB_LINKS.
256 * If 'nb' is set to 'all', display all filtered links (max parameter).
258 * @param int $max maximum number of links to display.
260 * @return int number of links to display.
262 public function getNbLinks($max)
264 if (empty($this->userInput
['nb'])) {
265 return self
::$DEFAULT_NB_LINKS;
268 if ($this->userInput
['nb'] == 'all') {
272 $intNb = intval($this->userInput
['nb']);
273 if (! is_int($intNb) || $intNb == 0) {
274 return self
::$DEFAULT_NB_LINKS;