3 static function calculate_article_hash($article, $pluginhost) {
6 foreach ($article as $k => $v) {
7 if ($k != "feed" && isset($v)) {
8 $x = strip_tags(is_array($v) ?
implode(",", $v) : $v);
10 //_debug("$k:" . sha1($x) . ":" . htmlspecialchars($x), true);
12 $tmp .= sha1("$k:" . sha1($x));
16 return sha1(implode(",", $pluginhost->get_plugin_names()) . $tmp);
19 static function update_feedbrowser_cache() {
21 $result = db_query("SELECT feed_url, site_url, title, COUNT(id) AS subscribers
22 FROM ttrss_feeds WHERE feed_url NOT IN (SELECT feed_url FROM ttrss_feeds
23 WHERE private IS true OR auth_login != '' OR auth_pass != '' OR feed_url LIKE '%:%@%/%')
24 GROUP BY feed_url, site_url, title ORDER BY subscribers DESC LIMIT 1000");
28 db_query("DELETE FROM ttrss_feedbrowser_cache");
32 while ($line = db_fetch_assoc($result)) {
33 $subscribers = db_escape_string($line["subscribers"]);
34 $feed_url = db_escape_string($line["feed_url"]);
35 $title = db_escape_string($line["title"]);
36 $site_url = db_escape_string($line["site_url"]);
38 $tmp_result = db_query("SELECT subscribers FROM
39 ttrss_feedbrowser_cache WHERE feed_url = '$feed_url'");
41 if (db_num_rows($tmp_result) == 0) {
43 db_query("INSERT INTO ttrss_feedbrowser_cache
44 (feed_url, site_url, title, subscribers) VALUES ('$feed_url',
45 '$site_url', '$title', '$subscribers')");
59 static function update_daemon_common($limit = DAEMON_FEED_LIMIT
, $debug = true) {
60 $schema_version = get_schema_version();
62 if ($schema_version != SCHEMA_VERSION
) {
63 die("Schema version is wrong, please upgrade the database.\n");
66 if (!SINGLE_USER_MODE
&& DAEMON_UPDATE_LOGIN_LIMIT
> 0) {
67 if (DB_TYPE
== "pgsql") {
68 $login_thresh_qpart = "AND ttrss_users.last_login >= NOW() - INTERVAL '".DAEMON_UPDATE_LOGIN_LIMIT
." days'";
70 $login_thresh_qpart = "AND ttrss_users.last_login >= DATE_SUB(NOW(), INTERVAL ".DAEMON_UPDATE_LOGIN_LIMIT
." DAY)";
73 $login_thresh_qpart = "";
76 if (DB_TYPE
== "pgsql") {
77 $update_limit_qpart = "AND ((
78 ttrss_feeds.update_interval = 0
79 AND ttrss_user_prefs.value != '-1'
80 AND ttrss_feeds.last_updated < NOW() - CAST((ttrss_user_prefs.value || ' minutes') AS INTERVAL)
82 ttrss_feeds.update_interval > 0
83 AND ttrss_feeds.last_updated < NOW() - CAST((ttrss_feeds.update_interval || ' minutes') AS INTERVAL)
84 ) OR (ttrss_feeds.last_updated IS NULL
85 AND ttrss_user_prefs.value != '-1')
86 OR (last_updated = '1970-01-01 00:00:00'
87 AND ttrss_user_prefs.value != '-1'))";
89 $update_limit_qpart = "AND ((
90 ttrss_feeds.update_interval = 0
91 AND ttrss_user_prefs.value != '-1'
92 AND ttrss_feeds.last_updated < DATE_SUB(NOW(), INTERVAL CONVERT(ttrss_user_prefs.value, SIGNED INTEGER) MINUTE)
94 ttrss_feeds.update_interval > 0
95 AND ttrss_feeds.last_updated < DATE_SUB(NOW(), INTERVAL ttrss_feeds.update_interval MINUTE)
96 ) OR (ttrss_feeds.last_updated IS NULL
97 AND ttrss_user_prefs.value != '-1')
98 OR (last_updated = '1970-01-01 00:00:00'
99 AND ttrss_user_prefs.value != '-1'))";
102 // Test if feed is currently being updated by another process.
103 if (DB_TYPE
== "pgsql") {
104 $updstart_thresh_qpart = "AND (ttrss_feeds.last_update_started IS NULL OR ttrss_feeds.last_update_started < NOW() - INTERVAL '10 minutes')";
106 $updstart_thresh_qpart = "AND (ttrss_feeds.last_update_started IS NULL OR ttrss_feeds.last_update_started < DATE_SUB(NOW(), INTERVAL 10 MINUTE))";
109 $query_limit = $limit ?
sprintf("LIMIT %d", $limit) : "";
111 // Update the least recently updated feeds first
112 $query_order = "ORDER BY last_updated";
113 if (DB_TYPE
== "pgsql") $query_order .= " NULLS FIRST";
115 $query = "SELECT DISTINCT ttrss_feeds.feed_url, ttrss_feeds.last_updated
117 ttrss_feeds, ttrss_users, ttrss_user_prefs
119 ttrss_feeds.owner_uid = ttrss_users.id
120 AND ttrss_user_prefs.profile IS NULL
121 AND ttrss_users.id = ttrss_user_prefs.owner_uid
122 AND ttrss_user_prefs.pref_name = 'DEFAULT_UPDATE_INTERVAL'
123 $login_thresh_qpart $update_limit_qpart
124 $updstart_thresh_qpart
125 $query_order $query_limit";
127 $result = db_query($query);
129 if ($debug) _debug(sprintf("Scheduled %d feeds to update...", db_num_rows($result)));
131 $feeds_to_update = array();
132 while ($line = db_fetch_assoc($result)) {
133 array_push($feeds_to_update, $line['feed_url']);
136 // Update last_update_started before actually starting the batch
137 // in order to minimize collision risk for parallel daemon tasks
138 if (count($feeds_to_update) > 0) {
139 $feeds_quoted = array_map(function ($s) { return "'" . db_escape_string($s) . "'"; }, $feeds_to_update);
141 db_query(sprintf("UPDATE ttrss_feeds SET last_update_started = NOW()
142 WHERE feed_url IN (%s)", implode(',', $feeds_quoted)));
146 $bstarted = microtime(true);
148 $batch_owners = array();
150 foreach ($feeds_to_update as $feed) {
151 if($debug) _debug("Base feed: $feed");
153 //update_rss_feed($line["id"], true);
155 // since we have the data cached, we can deal with other feeds with the same url
156 $tmp_result = db_query("SELECT DISTINCT ttrss_feeds.id,last_updated,ttrss_feeds.owner_uid
157 FROM ttrss_feeds, ttrss_users, ttrss_user_prefs WHERE
158 ttrss_user_prefs.owner_uid = ttrss_feeds.owner_uid AND
159 ttrss_users.id = ttrss_user_prefs.owner_uid AND
160 ttrss_user_prefs.pref_name = 'DEFAULT_UPDATE_INTERVAL' AND
161 ttrss_user_prefs.profile IS NULL AND
162 feed_url = '".db_escape_string($feed)."'
165 ORDER BY ttrss_feeds.id $query_limit");
167 if (db_num_rows($tmp_result) > 0) {
168 while ($tline = db_fetch_assoc($tmp_result)) {
169 if ($debug) _debug(" => " . $tline["last_updated"] . ", " . $tline["id"] . " " . $tline["owner_uid"]);
171 if (array_search($tline["owner_uid"], $batch_owners) === FALSE)
172 array_push($batch_owners, $tline["owner_uid"]);
174 $fstarted = microtime(true);
175 RSSUtils
::update_rss_feed($tline["id"], true, false);
176 _debug_suppress(false);
178 _debug(sprintf(" %.4f (sec)", microtime(true) - $fstarted));
186 _debug(sprintf("Processed %d feeds in %.4f (sec), %.4f (sec/feed avg)", $nf,
187 microtime(true) - $bstarted, (microtime(true) - $bstarted) / $nf));
190 foreach ($batch_owners as $owner_uid) {
191 _debug("Running housekeeping tasks for user $owner_uid...");
193 RSSUtils
::housekeeping_user($owner_uid);
196 // Send feed digests by email if needed.
197 Digest
::send_headlines_digests($debug);
203 // this is used when subscribing
204 static function set_basic_feed_info($feed) {
206 $feed = db_escape_string($feed);
208 $result = db_query("SELECT owner_uid,feed_url,auth_pass,auth_login,auth_pass_encrypted
209 FROM ttrss_feeds WHERE id = '$feed'");
211 $owner_uid = db_fetch_result($result, 0, "owner_uid");
213 $auth_pass_encrypted = sql_bool_to_bool(db_fetch_result($result,
214 0, "auth_pass_encrypted"));
216 $auth_login = db_fetch_result($result, 0, "auth_login");
217 $auth_pass = db_fetch_result($result, 0, "auth_pass");
219 if ($auth_pass_encrypted && function_exists("mcrypt_decrypt")) {
220 require_once "crypt.php";
221 $auth_pass = decrypt_string($auth_pass);
224 $fetch_url = db_fetch_result($result, 0, "feed_url");
228 $pluginhost = new PluginHost();
229 $user_plugins = get_pref("_ENABLED_PLUGINS", $owner_uid);
231 $pluginhost->load(PLUGINS
, PluginHost
::KIND_ALL
);
232 $pluginhost->load($user_plugins, PluginHost
::KIND_USER
, $owner_uid);
233 $pluginhost->load_data();
235 foreach ($pluginhost->get_hooks(PluginHost
::HOOK_FEED_BASIC_INFO
) as $plugin) {
236 $feed_data = $plugin->hook_feed_basic_info($fetch_url, $owner_uid, $feed, $auth_login, $auth_pass);
243 $feed_data = fetch_file_contents($fetch_url, false,
244 $auth_login, $auth_pass, false,
248 global $fetch_curl_used;
250 if (!$fetch_curl_used) {
251 $tmp = @gzdecode
($feed_data);
253 if ($tmp) $feed_data = $tmp;
257 $feed_data = trim($feed_data);
259 $rss = new FeedParser($feed_data);
262 if (!$rss->error()) {
264 $result = db_query("SELECT title, site_url FROM ttrss_feeds WHERE id = '$feed'");
266 $registered_title = db_fetch_result($result, 0, "title");
267 $orig_site_url = db_fetch_result($result, 0, "site_url");
269 $site_url = db_escape_string(mb_substr(rewrite_relative_url($fetch_url, $rss->get_link()), 0, 245));
270 $feed_title = db_escape_string(mb_substr($rss->get_title(), 0, 199));
272 if ($feed_title && (!$registered_title ||
$registered_title == "[Unknown]")) {
273 db_query("UPDATE ttrss_feeds SET
274 title = '$feed_title' WHERE id = '$feed'");
277 if ($site_url && $orig_site_url != $site_url) {
278 db_query("UPDATE ttrss_feeds SET
279 site_url = '$site_url' WHERE id = '$feed'");
285 * @SuppressWarnings(PHPMD.UnusedFormalParameter)
287 static function update_rss_feed($feed, $no_cache = false) {
289 $debug_enabled = defined('DAEMON_EXTENDED_DEBUG') ||
$_REQUEST['xdebug'];
291 _debug_suppress(!$debug_enabled);
292 _debug("start", $debug_enabled);
294 $result = db_query("SELECT title FROM ttrss_feeds
295 WHERE id = '$feed'");
297 if (db_num_rows($result) == 0) {
298 _debug("feed $feed NOT FOUND/SKIPPED", $debug_enabled);
299 user_error("Attempt to update unknown/invalid feed $feed", E_USER_WARNING
);
303 $title = db_fetch_result($result, 0, "title");
305 // feed was batch-subscribed or something, we need to get basic info
306 // this is not optimal currently as it fetches stuff separately TODO: optimize
307 if ($title == "[Unknown]") {
308 _debug("setting basic feed info for $feed...");
309 RSSUtils
::set_basic_feed_info($feed);
312 $result = db_query("SELECT id,update_interval,auth_login,
313 feed_url,auth_pass,cache_images,
314 mark_unread_on_update, owner_uid,
315 auth_pass_encrypted, feed_language,
317 FROM ttrss_feeds WHERE id = '$feed'");
319 $owner_uid = db_fetch_result($result, 0, "owner_uid");
320 $mark_unread_on_update = sql_bool_to_bool(db_fetch_result($result,
321 0, "mark_unread_on_update"));
322 $auth_pass_encrypted = sql_bool_to_bool(db_fetch_result($result,
323 0, "auth_pass_encrypted"));
325 db_query("UPDATE ttrss_feeds SET last_update_started = NOW()
326 WHERE id = '$feed'");
328 $auth_login = db_fetch_result($result, 0, "auth_login");
329 $auth_pass = db_fetch_result($result, 0, "auth_pass");
331 if ($auth_pass_encrypted && function_exists("mcrypt_decrypt")) {
332 require_once "crypt.php";
333 $auth_pass = decrypt_string($auth_pass);
336 $stored_last_modified = db_fetch_result($result, 0, "last_modified");
337 $cache_images = sql_bool_to_bool(db_fetch_result($result, 0, "cache_images"));
338 $fetch_url = db_fetch_result($result, 0, "feed_url");
339 $feed_language = db_escape_string(mb_strtolower(db_fetch_result($result, 0, "feed_language")));
340 if (!$feed_language) $feed_language = 'english';
342 $feed = db_escape_string($feed);
344 $date_feed_processed = date('Y-m-d H:i');
346 $cache_filename = CACHE_DIR
. "/simplepie/" . sha1($fetch_url) . ".xml";
348 $pluginhost = new PluginHost();
349 $pluginhost->set_debug($debug_enabled);
350 $user_plugins = get_pref("_ENABLED_PLUGINS", $owner_uid);
352 $pluginhost->load(PLUGINS
, PluginHost
::KIND_ALL
);
353 $pluginhost->load($user_plugins, PluginHost
::KIND_USER
, $owner_uid);
354 $pluginhost->load_data();
358 $force_refetch = isset($_REQUEST["force_refetch"]);
361 foreach ($pluginhost->get_hooks(PluginHost
::HOOK_FETCH_FEED
) as $plugin) {
362 $feed_data = $plugin->hook_fetch_feed($feed_data, $fetch_url, $owner_uid, $feed, 0, $auth_login, $auth_pass);
367 file_exists($cache_filename) &&
368 is_readable($cache_filename) &&
369 !$auth_login && !$auth_pass &&
370 filemtime($cache_filename) > time() - 30) {
372 _debug("using local cache [$cache_filename].", $debug_enabled);
374 @$feed_data = file_get_contents($cache_filename);
377 $rss_hash = sha1($feed_data);
381 _debug("local cache will not be used for this feed", $debug_enabled);
384 global $fetch_last_modified;
386 // fetch feed from source
388 _debug("stored last modified: $stored_last_modified", $debug_enabled);
389 _debug("fetching [$fetch_url]...", $debug_enabled);
391 if (ini_get("open_basedir") && function_exists("curl_init")) {
392 _debug("not using CURL due to open_basedir restrictions");
395 /*$feed_data = fetch_file_contents($fetch_url, false,
396 $auth_login, $auth_pass, false,
397 $no_cache ? FEED_FETCH_NO_CACHE_TIMEOUT : FEED_FETCH_TIMEOUT,
400 // TODO: last_modified should be limited, if the feed has not been updated for a while
401 // we probably should force one update without the header
402 // unfortunately last_updated gets bumped on http 304 so that daemon would work properly
404 $feed_data = fetch_file_contents([
406 "login" => $auth_login,
407 "pass" => $auth_pass,
408 "timeout" => $no_cache ? FEED_FETCH_NO_CACHE_TIMEOUT
: FEED_FETCH_TIMEOUT
,
409 "last_modified" => $force_refetch ?
"" : $stored_last_modified
412 global $fetch_curl_used;
414 if (!$fetch_curl_used) {
415 $tmp = @gzdecode
($feed_data);
417 if ($tmp) $feed_data = $tmp;
420 $feed_data = trim($feed_data);
422 _debug("fetch done.", $debug_enabled);
423 _debug("source last modified: " . $fetch_last_modified);
425 if ($feed_data && $fetch_last_modified != $stored_last_modified) {
426 $last_modified_escaped = db_escape_string(substr($fetch_last_modified, 0, 245));
428 db_query("UPDATE ttrss_feeds SET last_modified = '$last_modified_escaped' WHERE id = '$feed'");
432 // cache vanilla feed data for re-use
433 if ($feed_data && !$auth_pass && !$auth_login && is_writable(CACHE_DIR
. "/simplepie")) {
434 $new_rss_hash = sha1($feed_data);
436 if ($new_rss_hash != $rss_hash) {
437 _debug("saving $cache_filename", $debug_enabled);
438 @file_put_contents
($cache_filename, $feed_data);
444 global $fetch_last_error;
445 global $fetch_last_error_code;
447 _debug("unable to fetch: $fetch_last_error [$fetch_last_error_code]", $debug_enabled);
452 if ($fetch_last_error_code != 304) {
453 $error_escaped = db_escape_string($fetch_last_error);
455 _debug("source claims data not modified, nothing to do.", $debug_enabled);
459 "UPDATE ttrss_feeds SET last_error = '$error_escaped',
460 last_updated = NOW() WHERE id = '$feed'");
465 foreach ($pluginhost->get_hooks(PluginHost
::HOOK_FEED_FETCHED
) as $plugin) {
466 $feed_data = $plugin->hook_feed_fetched($feed_data, $fetch_url, $owner_uid, $feed);
469 $rss = new FeedParser($feed_data);
472 $feed = db_escape_string($feed);
474 if (!$rss->error()) {
476 // We use local pluginhost here because we need to load different per-user feed plugins
477 $pluginhost->run_hooks(PluginHost
::HOOK_FEED_PARSED
, "hook_feed_parsed", $rss);
479 _debug("language: $feed_language", $debug_enabled);
480 _debug("processing feed data...", $debug_enabled);
482 // db_query("BEGIN");
484 if (DB_TYPE
== "pgsql") {
485 $favicon_interval_qpart = "favicon_last_checked < NOW() - INTERVAL '12 hour'";
487 $favicon_interval_qpart = "favicon_last_checked < DATE_SUB(NOW(), INTERVAL 12 HOUR)";
490 $result = db_query("SELECT owner_uid,favicon_avg_color,
491 (favicon_last_checked IS NULL OR $favicon_interval_qpart) AS
493 FROM ttrss_feeds WHERE id = '$feed'");
495 $favicon_needs_check = sql_bool_to_bool(db_fetch_result($result, 0,
496 "favicon_needs_check"));
497 $favicon_avg_color = db_fetch_result($result, 0, "favicon_avg_color");
499 $owner_uid = db_fetch_result($result, 0, "owner_uid");
501 $site_url = db_escape_string(mb_substr(rewrite_relative_url($fetch_url, $rss->get_link()), 0, 245));
503 _debug("site_url: $site_url", $debug_enabled);
504 _debug("feed_title: " . $rss->get_title(), $debug_enabled);
506 if ($favicon_needs_check ||
$force_refetch) {
508 /* terrible hack: if we crash on floicon shit here, we won't check
509 * the icon avgcolor again (unless the icon got updated) */
511 $favicon_file = ICONS_DIR
. "/$feed.ico";
512 $favicon_modified = @filemtime
($favicon_file);
514 _debug("checking favicon...", $debug_enabled);
516 RSSUtils
::check_feed_favicon($site_url, $feed);
517 $favicon_modified_new = @filemtime
($favicon_file);
519 if ($favicon_modified_new > $favicon_modified)
520 $favicon_avg_color = '';
522 if (file_exists($favicon_file) && function_exists("imagecreatefromstring") && $favicon_avg_color == '') {
523 require_once "colors.php";
525 db_query("UPDATE ttrss_feeds SET favicon_avg_color = 'fail' WHERE
528 $favicon_color = db_escape_string(
529 calculate_avg_color($favicon_file));
531 $favicon_colorstring = ",favicon_avg_color = '".$favicon_color."'";
532 } else if ($favicon_avg_color == 'fail') {
533 _debug("floicon failed on this file, not trying to recalculate avg color", $debug_enabled);
536 db_query("UPDATE ttrss_feeds SET favicon_last_checked = NOW()
538 WHERE id = '$feed'");
541 _debug("loading filters & labels...", $debug_enabled);
543 $filters = load_filters($feed, $owner_uid);
545 if ($debug_enabled) {
549 _debug("" . count($filters) . " filters loaded.", $debug_enabled);
551 $items = $rss->get_items();
553 if (!is_array($items)) {
554 _debug("no articles found.", $debug_enabled);
556 db_query("UPDATE ttrss_feeds
557 SET last_updated = NOW(), last_error = '' WHERE id = '$feed'");
559 return; // no articles
562 _debug("processing articles...", $debug_enabled);
566 foreach ($items as $item) {
567 if ($_REQUEST['xdebug'] == 3) {
571 if (ini_get("max_execution_time") > 0 && time() - $tstart >= ini_get("max_execution_time") * 0.7) {
572 _debug("looks like there's too many articles to process at once, breaking out", $debug_enabled);
576 $entry_guid = $item->get_id();
577 if (!$entry_guid) $entry_guid = $item->get_link();
578 if (!$entry_guid) $entry_guid = RSSUtils
::make_guid_from_title($item->get_title());
579 if (!$entry_guid) continue;
581 $entry_guid = "$owner_uid,$entry_guid";
583 $entry_guid_hashed = db_escape_string('SHA1:' . sha1($entry_guid));
585 _debug("guid $entry_guid / $entry_guid_hashed", $debug_enabled);
587 $entry_timestamp = "";
589 $entry_timestamp = $item->get_date();
591 _debug("orig date: " . $item->get_date(), $debug_enabled);
593 if ($entry_timestamp == -1 ||
!$entry_timestamp ||
$entry_timestamp > time()) {
594 $entry_timestamp = time();
597 $entry_timestamp_fmt = strftime("%Y/%m/%d %H:%M:%S", $entry_timestamp);
599 _debug("date $entry_timestamp [$entry_timestamp_fmt]", $debug_enabled);
601 // $entry_title = html_entity_decode($item->get_title(), ENT_COMPAT, 'UTF-8');
602 // $entry_title = decode_numeric_entities($entry_title);
603 $entry_title = $item->get_title();
605 $entry_link = rewrite_relative_url($site_url, $item->get_link());
607 _debug("title $entry_title", $debug_enabled);
608 _debug("link $entry_link", $debug_enabled);
610 if (!$entry_title) $entry_title = date("Y-m-d H:i:s", $entry_timestamp);;
612 $entry_content = $item->get_content();
613 if (!$entry_content) $entry_content = $item->get_description();
615 if ($_REQUEST["xdebug"] == 2) {
617 print htmlspecialchars($entry_content);
621 $entry_comments = db_escape_string(mb_substr($item->get_comments_url(), 0, 245));
622 $num_comments = (int) $item->get_comments_count();
624 $entry_author = $item->get_author(); // escaped later
625 $entry_guid = db_escape_string(mb_substr($entry_guid, 0, 245));
627 _debug("author $entry_author", $debug_enabled);
628 _debug("num_comments: $num_comments", $debug_enabled);
629 _debug("looking for tags...", $debug_enabled);
631 // parse <category> entries into tags
633 $additional_tags = array();
635 $additional_tags_src = $item->get_categories();
637 if (is_array($additional_tags_src)) {
638 foreach ($additional_tags_src as $tobj) {
639 array_push($additional_tags, $tobj);
643 $entry_tags = array_unique($additional_tags);
645 for ($i = 0; $i < count($entry_tags); $i++
)
646 $entry_tags[$i] = mb_strtolower($entry_tags[$i], 'utf-8');
648 _debug("tags found: " . join(",", $entry_tags), $debug_enabled);
650 _debug("done collecting data.", $debug_enabled);
652 $result = db_query("SELECT id, content_hash, lang FROM ttrss_entries
653 WHERE guid = '".db_escape_string($entry_guid)."' OR guid = '$entry_guid_hashed'");
655 if (db_num_rows($result) != 0) {
656 $base_entry_id = db_fetch_result($result, 0, "id");
657 $entry_stored_hash = db_fetch_result($result, 0, "content_hash");
658 $article_labels = Article
::get_article_labels($base_entry_id, $owner_uid);
659 $entry_language = db_fetch_result($result, 0, "lang");
661 $existing_tags = Article
::get_article_tags($base_entry_id, $owner_uid);
662 $entry_tags = array_unique(array_merge($entry_tags, $existing_tags));
665 $base_entry_id = false;
666 $entry_stored_hash = "";
667 $article_labels = array();
668 $entry_language = "";
671 $article = array("owner_uid" => $owner_uid, // read only
672 "guid" => $entry_guid, // read only
673 "guid_hashed" => $entry_guid_hashed, // read only
674 "title" => $entry_title,
675 "content" => $entry_content,
676 "link" => $entry_link,
677 "labels" => $article_labels, // current limitation: can add labels to article, can't remove them
678 "tags" => $entry_tags,
679 "author" => $entry_author,
680 "force_catchup" => false, // ugly hack for the time being
681 "score_modifier" => 0, // no previous value, plugin should recalculate score modifier based on content if needed
682 "language" => $entry_language,
683 "num_comments" => $num_comments, // read only
684 "feed" => array("id" => $feed,
685 "fetch_url" => $fetch_url,
686 "site_url" => $site_url,
687 "cache_images" => $cache_images)
690 $entry_plugin_data = "";
691 $entry_current_hash = RSSUtils
::calculate_article_hash($article, $pluginhost);
693 _debug("article hash: $entry_current_hash [stored=$entry_stored_hash]", $debug_enabled);
695 if ($entry_current_hash == $entry_stored_hash && !isset($_REQUEST["force_rehash"])) {
696 _debug("stored article seems up to date [IID: $base_entry_id], updating timestamp only", $debug_enabled);
698 // we keep encountering the entry in feeds, so we need to
699 // update date_updated column so that we don't get horrible
700 // dupes when the entry gets purged and reinserted again e.g.
701 // in the case of SLOW SLOW OMG SLOW updating feeds
703 $base_entry_id = db_fetch_result($result, 0, "id");
705 db_query("UPDATE ttrss_entries SET date_updated = NOW()
706 WHERE id = '$base_entry_id'");
711 _debug("hash differs, applying plugin filters:", $debug_enabled);
713 foreach ($pluginhost->get_hooks(PluginHost
::HOOK_ARTICLE_FILTER
) as $plugin) {
714 _debug("... " . get_class($plugin), $debug_enabled);
716 $start = microtime(true);
717 $article = $plugin->hook_article_filter($article);
719 _debug("=== " . sprintf("%.4f (sec)", microtime(true) - $start), $debug_enabled);
721 $entry_plugin_data .= mb_strtolower(get_class($plugin)) . ",";
724 if ($_REQUEST["xdebug"] == 2) {
725 print "processed content: ";
726 print htmlspecialchars($article["content"]);
730 $entry_plugin_data = db_escape_string($entry_plugin_data);
732 _debug("plugin data: $entry_plugin_data", $debug_enabled);
734 // Workaround: 4-byte unicode requires utf8mb4 in MySQL. See https://tt-rss.org/forum/viewtopic.php?f=1&t=3377&p=20077#p20077
735 if (DB_TYPE
== "mysql") {
736 foreach ($article as $k => $v) {
738 // i guess we'll have to take the risk of 4byte unicode labels & tags here
739 if (is_string($article[$k])) {
740 $article[$k] = preg_replace('/[\x{10000}-\x{10FFFF}]/u', "\xEF\xBF\xBD", $v);
745 /* Collect article tags here so we could filter by them: */
747 $matched_rules = array();
749 $article_filters = RSSUtils
::get_article_filters($filters, $article["title"],
750 $article["content"], $article["link"], $article["author"],
751 $article["tags"], $matched_rules);
753 if ($debug_enabled) {
754 _debug("matched filter rules: ", $debug_enabled);
756 if (count($matched_rules) != 0) {
757 print_r($matched_rules);
760 _debug("filter actions: ", $debug_enabled);
762 if (count($article_filters) != 0) {
763 print_r($article_filters);
767 $plugin_filter_names = RSSUtils
::find_article_filters($article_filters, "plugin");
768 $plugin_filter_actions = $pluginhost->get_filter_actions();
770 if (count($plugin_filter_names) > 0) {
771 _debug("applying plugin filter actions...", $debug_enabled);
773 foreach ($plugin_filter_names as $pfn) {
774 list($pfclass,$pfaction) = explode(":", $pfn["param"]);
776 if (isset($plugin_filter_actions[$pfclass])) {
777 $plugin = $pluginhost->get_plugin($pfclass);
779 _debug("... $pfclass: $pfaction", $debug_enabled);
782 $start = microtime(true);
783 $article = $plugin->hook_article_filter_action($article, $pfaction);
785 _debug("=== " . sprintf("%.4f (sec)", microtime(true) - $start), $debug_enabled);
787 _debug("??? $pfclass: plugin object not found.");
790 _debug("??? $pfclass: filter plugin not registered.");
795 $entry_tags = $article["tags"];
796 $entry_guid = db_escape_string($entry_guid);
797 $entry_title = db_escape_string($article["title"]);
798 $entry_author = db_escape_string(mb_substr($article["author"], 0, 245));
799 $entry_link = db_escape_string($article["link"]);
800 $entry_content = $article["content"]; // escaped below
801 $entry_force_catchup = $article["force_catchup"];
802 $article_labels = $article["labels"];
803 $entry_score_modifier = (int) $article["score_modifier"];
804 $entry_language = db_escape_string($article["language"]);
806 if ($debug_enabled) {
807 _debug("article labels:", $debug_enabled);
809 if (count($article_labels) != 0) {
810 print_r($article_labels);
814 _debug("force catchup: $entry_force_catchup");
816 if ($cache_images && is_writable(CACHE_DIR
. '/images'))
817 RSSUtils
::cache_media($entry_content, $site_url, $debug_enabled);
819 $entry_content = db_escape_string($entry_content, false);
823 $result = db_query("SELECT id FROM ttrss_entries
824 WHERE (guid = '$entry_guid' OR guid = '$entry_guid_hashed')");
826 if (db_num_rows($result) == 0) {
828 _debug("base guid [$entry_guid or $entry_guid_hashed] not found, creating...", $debug_enabled);
830 // base post entry does not exist, create it
833 "INSERT INTO ttrss_entries
850 '$entry_guid_hashed',
852 '$entry_timestamp_fmt',
854 '$entry_current_hash',
857 '$date_feed_processed',
860 '$entry_plugin_data',
866 // now it should exist, if not - bad luck then
868 $result = db_query("SELECT id FROM ttrss_entries
869 WHERE guid = '$entry_guid' OR guid = '$entry_guid_hashed'");
874 if (db_num_rows($result) == 1) {
876 _debug("base guid found, checking for user record", $debug_enabled);
878 $ref_id = db_fetch_result($result, 0, "id");
879 $entry_ref_id = $ref_id;
881 /* $stored_guid = db_fetch_result($result, 0, "guid");
882 if ($stored_guid != $entry_guid_hashed) {
883 if ($debug_enabled) _debug("upgrading compat guid to hashed one", $debug_enabled);
885 db_query("UPDATE ttrss_entries SET guid = '$entry_guid_hashed' WHERE
889 if (RSSUtils
::find_article_filter($article_filters, "filter")) {
890 //db_query("COMMIT"); // close transaction in progress
894 $score = RSSUtils
::calculate_article_score($article_filters) +
$entry_score_modifier;
896 _debug("initial score: $score [including plugin modifier: $entry_score_modifier]", $debug_enabled);
898 // check for user post link to main table
900 $query = "SELECT ref_id, int_id FROM ttrss_user_entries WHERE
901 ref_id = '$ref_id' AND owner_uid = '$owner_uid'";
903 // if ($_REQUEST["xdebug"]) print "$query\n";
905 $result = db_query($query);
907 // okay it doesn't exist - create user entry
908 if (db_num_rows($result) == 0) {
910 _debug("user record not found, creating...", $debug_enabled);
912 if ($score >= -500 && !RSSUtils
::find_article_filter($article_filters, 'catchup') && !$entry_force_catchup) {
914 $last_read_qpart = 'NULL';
917 $last_read_qpart = 'NOW()';
920 if (RSSUtils
::find_article_filter($article_filters, 'mark') ||
$score > 1000) {
926 if (RSSUtils
::find_article_filter($article_filters, 'publish')) {
929 $published = 'false';
932 $last_marked = ($marked == 'true') ?
'NOW()' : 'NULL';
933 $last_published = ($published == 'true') ?
'NOW()' : 'NULL';
936 "INSERT INTO ttrss_user_entries
937 (ref_id, owner_uid, feed_id, unread, last_read, marked,
938 published, score, tag_cache, label_cache, uuid,
939 last_marked, last_published)
940 VALUES ('$ref_id', '$owner_uid', '$feed', $unread,
941 $last_read_qpart, $marked, $published, '$score', '', '',
942 '', $last_marked, $last_published)");
945 "SELECT int_id FROM ttrss_user_entries WHERE
946 ref_id = '$ref_id' AND owner_uid = '$owner_uid' AND
947 feed_id = '$feed' LIMIT 1");
949 if (db_num_rows($result) == 1) {
950 $entry_int_id = db_fetch_result($result, 0, "int_id");
953 _debug("user record FOUND", $debug_enabled);
955 $entry_ref_id = db_fetch_result($result, 0, "ref_id");
956 $entry_int_id = db_fetch_result($result, 0, "int_id");
959 _debug("RID: $entry_ref_id, IID: $entry_int_id", $debug_enabled);
961 if (DB_TYPE
== "pgsql") {
962 $tsvector_combined = db_escape_string(mb_substr($entry_title . ' ' . strip_tags(str_replace('<', ' <', $entry_content)),
965 $tsvector_qpart = "tsvector_combined = to_tsvector('$feed_language', '$tsvector_combined'),";
968 $tsvector_qpart = "";
971 db_query("UPDATE ttrss_entries
972 SET title = '$entry_title',
973 content = '$entry_content',
974 content_hash = '$entry_current_hash',
975 updated = '$entry_timestamp_fmt',
977 num_comments = '$num_comments',
978 plugin_data = '$entry_plugin_data',
979 author = '$entry_author',
980 lang = '$entry_language'
981 WHERE id = '$ref_id'");
984 db_query("UPDATE ttrss_user_entries
985 SET score = '$score' WHERE ref_id = '$ref_id'");
987 if ($mark_unread_on_update) {
988 _debug("article updated, marking unread as requested.", $debug_enabled);
990 db_query("UPDATE ttrss_user_entries
991 SET last_read = null, unread = true WHERE ref_id = '$ref_id'");
995 //db_query("COMMIT");
997 _debug("assigning labels [other]...", $debug_enabled);
999 foreach ($article_labels as $label) {
1000 Labels
::add_article($entry_ref_id, $label[1], $owner_uid);
1003 _debug("assigning labels [filters]...", $debug_enabled);
1005 RSSUtils
::assign_article_to_label_filters($entry_ref_id, $article_filters,
1006 $owner_uid, $article_labels);
1008 _debug("looking for enclosures...", $debug_enabled);
1012 $enclosures = array();
1014 $encs = $item->get_enclosures();
1016 if (is_array($encs)) {
1017 foreach ($encs as $e) {
1019 rewrite_relative_url($site_url, $e->link
),
1020 $e->type
, $e->length
, $e->title
, $e->width
, $e->height
);
1021 array_push($enclosures, $e_item);
1025 if ($cache_images && is_writable(CACHE_DIR
. '/images'))
1026 RSSUtils
::cache_enclosures($enclosures, $site_url, $debug_enabled);
1028 if ($debug_enabled) {
1029 _debug("article enclosures:", $debug_enabled);
1030 print_r($enclosures);
1033 //db_query("BEGIN");
1036 // db_query("DELETE FROM ttrss_enclosures WHERE post_id = '$entry_ref_id'");
1038 foreach ($enclosures as $enc) {
1039 $enc_url = db_escape_string($enc[0]);
1040 $enc_type = db_escape_string($enc[1]);
1041 $enc_dur = db_escape_string($enc[2]);
1042 $enc_title = db_escape_string($enc[3]);
1043 $enc_width = intval($enc[4]);
1044 $enc_height = intval($enc[5]);
1046 $result = db_query("SELECT id FROM ttrss_enclosures
1047 WHERE content_url = '$enc_url' AND post_id = '$entry_ref_id'");
1049 if (db_num_rows($result) == 0) {
1050 db_query("INSERT INTO ttrss_enclosures
1051 (content_url, content_type, title, duration, post_id, width, height) VALUES
1052 ('$enc_url', '$enc_type', '$enc_title', '$enc_dur', '$entry_ref_id', $enc_width, $enc_height)");
1056 //db_query("COMMIT");
1058 // check for manual tags (we have to do it here since they're loaded from filters)
1060 foreach ($article_filters as $f) {
1061 if ($f["type"] == "tag") {
1063 $manual_tags = trim_array(explode(",", $f["param"]));
1065 foreach ($manual_tags as $tag) {
1066 if (tag_is_valid($tag)) {
1067 array_push($entry_tags, $tag);
1075 $boring_tags = trim_array(explode(",", mb_strtolower(get_pref(
1076 'BLACKLISTED_TAGS', $owner_uid, ''), 'utf-8')));
1078 $filtered_tags = array();
1079 $tags_to_cache = array();
1081 if ($entry_tags && is_array($entry_tags)) {
1082 foreach ($entry_tags as $tag) {
1083 if (array_search($tag, $boring_tags) === false) {
1084 array_push($filtered_tags, $tag);
1089 $filtered_tags = array_unique($filtered_tags);
1091 if ($debug_enabled) {
1092 _debug("filtered article tags:", $debug_enabled);
1093 print_r($filtered_tags);
1096 // Save article tags in the database
1098 if (count($filtered_tags) > 0) {
1100 //db_query("BEGIN");
1102 foreach ($filtered_tags as $tag) {
1104 $tag = sanitize_tag($tag);
1105 $tag = db_escape_string($tag);
1107 if (!tag_is_valid($tag)) continue;
1109 $result = db_query("SELECT id FROM ttrss_tags
1110 WHERE tag_name = '$tag' AND post_int_id = '$entry_int_id' AND
1111 owner_uid = '$owner_uid' LIMIT 1");
1113 if ($result && db_num_rows($result) == 0) {
1115 db_query("INSERT INTO ttrss_tags
1116 (owner_uid,tag_name,post_int_id)
1117 VALUES ('$owner_uid','$tag', '$entry_int_id')");
1120 array_push($tags_to_cache, $tag);
1123 /* update the cache */
1125 $tags_to_cache = array_unique($tags_to_cache);
1127 $tags_str = db_escape_string(join(",", $tags_to_cache));
1129 db_query("UPDATE ttrss_user_entries
1130 SET tag_cache = '$tags_str' WHERE ref_id = '$entry_ref_id'
1131 AND owner_uid = $owner_uid");
1133 //db_query("COMMIT");
1136 _debug("article processed", $debug_enabled);
1139 _debug("purging feed...", $debug_enabled);
1141 purge_feed($feed, 0, $debug_enabled);
1143 db_query("UPDATE ttrss_feeds
1144 SET last_updated = NOW(), last_error = '' WHERE id = '$feed'");
1146 // db_query("COMMIT");
1150 $error_msg = db_escape_string(mb_substr($rss->error(), 0, 245));
1152 _debug("fetch error: $error_msg", $debug_enabled);
1154 if (count($rss->errors()) > 1) {
1155 foreach ($rss->errors() as $error) {
1161 "UPDATE ttrss_feeds SET last_error = '$error_msg',
1162 last_updated = NOW() WHERE id = '$feed'");
1168 _debug("done", $debug_enabled);
1173 static function cache_enclosures($enclosures, $site_url, $debug) {
1174 foreach ($enclosures as $enc) {
1176 if (preg_match("/(image|audio|video)/", $enc[1])) {
1178 $src = rewrite_relative_url($site_url, $enc[0]);
1180 $local_filename = CACHE_DIR
. "/images/" . sha1($src);
1182 if ($debug) _debug("cache_enclosures: downloading: $src to $local_filename");
1184 if (!file_exists($local_filename)) {
1185 $file_content = fetch_file_contents($src);
1187 if ($file_content && strlen($file_content) > MIN_CACHE_FILE_SIZE
) {
1188 file_put_contents($local_filename, $file_content);
1191 touch($local_filename);
1197 static function cache_media($html, $site_url, $debug) {
1198 libxml_use_internal_errors(true);
1200 $charset_hack = '<head>
1201 <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
1204 $doc = new DOMDocument();
1205 $doc->loadHTML($charset_hack . $html);
1206 $xpath = new DOMXPath($doc);
1208 $entries = $xpath->query('(//img[@src])|(//video/source[@src])|(//audio/source[@src])');
1210 foreach ($entries as $entry) {
1211 if ($entry->hasAttribute('src') && strpos($entry->getAttribute('src'), "data:") !== 0) {
1212 $src = rewrite_relative_url($site_url, $entry->getAttribute('src'));
1214 $local_filename = CACHE_DIR
. "/images/" . sha1($src);
1216 if ($debug) _debug("cache_media: downloading: $src to $local_filename");
1218 if (!file_exists($local_filename)) {
1219 $file_content = fetch_file_contents($src);
1221 if ($file_content && strlen($file_content) > MIN_CACHE_FILE_SIZE
) {
1222 file_put_contents($local_filename, $file_content);
1225 touch($local_filename);
1231 static function expire_error_log($debug) {
1232 if ($debug) _debug("Removing old error log entries...");
1234 if (DB_TYPE
== "pgsql") {
1235 db_query("DELETE FROM ttrss_error_log
1236 WHERE created_at < NOW() - INTERVAL '7 days'");
1238 db_query("DELETE FROM ttrss_error_log
1239 WHERE created_at < DATE_SUB(NOW(), INTERVAL 7 DAY)");
1244 static function expire_lock_files($debug) {
1245 //if ($debug) _debug("Removing old lock files...");
1249 if (is_writable(LOCK_DIRECTORY
)) {
1250 $files = glob(LOCK_DIRECTORY
. "/*.lock");
1253 foreach ($files as $file) {
1254 if (!file_is_locked(basename($file)) && time() - filemtime($file) > 86400*2) {
1262 if ($debug) _debug("Removed $num_deleted old lock files.");
1265 static function expire_cached_files($debug) {
1266 foreach (array("simplepie", "images", "export", "upload") as $dir) {
1267 $cache_dir = CACHE_DIR
. "/$dir";
1269 // if ($debug) _debug("Expiring $cache_dir");
1273 if (is_writable($cache_dir)) {
1274 $files = glob("$cache_dir/*");
1277 foreach ($files as $file) {
1278 if (time() - filemtime($file) > 86400*CACHE_MAX_DAYS
) {
1287 if ($debug) _debug("$cache_dir: removed $num_deleted files.");
1292 * Source: http://www.php.net/manual/en/function.parse-url.php#104527
1293 * Returns the url query as associative array
1295 * @param string query
1296 * @return array params
1298 static function convertUrlQuery($query) {
1299 $queryParts = explode('&', $query);
1303 foreach ($queryParts as $param) {
1304 $item = explode('=', $param);
1305 $params[$item[0]] = $item[1];
1311 static function get_article_filters($filters, $title, $content, $link, $author, $tags, &$matched_rules = false) {
1314 foreach ($filters as $filter) {
1315 $match_any_rule = $filter["match_any_rule"];
1316 $inverse = $filter["inverse"];
1317 $filter_match = false;
1319 foreach ($filter["rules"] as $rule) {
1321 $reg_exp = str_replace('/', '\/', $rule["reg_exp"]);
1322 $rule_inverse = $rule["inverse"];
1327 switch ($rule["type"]) {
1329 $match = @preg_match
("/$reg_exp/iu", $title);
1332 // we don't need to deal with multiline regexps
1333 $content = preg_replace("/[\r\n\t]/", "", $content);
1335 $match = @preg_match
("/$reg_exp/iu", $content);
1338 // we don't need to deal with multiline regexps
1339 $content = preg_replace("/[\r\n\t]/", "", $content);
1341 $match = (@preg_match
("/$reg_exp/iu", $title) || @preg_match
("/$reg_exp/iu", $content));
1344 $match = @preg_match
("/$reg_exp/iu", $link);
1347 $match = @preg_match
("/$reg_exp/iu", $author);
1350 foreach ($tags as $tag) {
1351 if (@preg_match
("/$reg_exp/iu", $tag)) {
1359 if ($rule_inverse) $match = !$match;
1361 if ($match_any_rule) {
1363 $filter_match = true;
1367 $filter_match = $match;
1374 if ($inverse) $filter_match = !$filter_match;
1376 if ($filter_match) {
1377 if (is_array($matched_rules)) array_push($matched_rules, $rule);
1379 foreach ($filter["actions"] AS $action) {
1380 array_push($matches, $action);
1382 // if Stop action encountered, perform no further processing
1383 if (isset($action["type"]) && $action["type"] == "stop") return $matches;
1391 static function find_article_filter($filters, $filter_name) {
1392 foreach ($filters as $f) {
1393 if ($f["type"] == $filter_name) {
1400 static function find_article_filters($filters, $filter_name) {
1403 foreach ($filters as $f) {
1404 if ($f["type"] == $filter_name) {
1405 array_push($results, $f);
1411 static function calculate_article_score($filters) {
1414 foreach ($filters as $f) {
1415 if ($f["type"] == "score") {
1416 $score +
= $f["param"];
1422 static function labels_contains_caption($labels, $caption) {
1423 foreach ($labels as $label) {
1424 if ($label[1] == $caption) {
1432 static function assign_article_to_label_filters($id, $filters, $owner_uid, $article_labels) {
1433 foreach ($filters as $f) {
1434 if ($f["type"] == "label") {
1435 if (!RSSUtils
::labels_contains_caption($article_labels, $f["param"])) {
1436 Labels
::add_article($id, $f["param"], $owner_uid);
1442 static function make_guid_from_title($title) {
1443 return preg_replace("/[ \"\',.:;]/", "-",
1444 mb_strtolower(strip_tags($title), 'utf-8'));
1447 static function cleanup_counters_cache($debug) {
1448 $result = db_query("DELETE FROM ttrss_counters_cache
1449 WHERE feed_id > 0 AND
1450 (SELECT COUNT(id) FROM ttrss_feeds WHERE
1452 ttrss_counters_cache.owner_uid = ttrss_feeds.owner_uid) = 0");
1453 $frows = db_affected_rows($result);
1455 $result = db_query("DELETE FROM ttrss_cat_counters_cache
1456 WHERE feed_id > 0 AND
1457 (SELECT COUNT(id) FROM ttrss_feed_categories WHERE
1459 ttrss_cat_counters_cache.owner_uid = ttrss_feed_categories.owner_uid) = 0");
1460 $crows = db_affected_rows($result);
1462 if ($debug) _debug("Removed $frows (feeds) $crows (cats) orphaned counter cache entries.");
1465 static function housekeeping_user($owner_uid) {
1466 $tmph = new PluginHost();
1468 load_user_plugins($owner_uid, $tmph);
1470 $tmph->run_hooks(PluginHost
::HOOK_HOUSE_KEEPING
, "hook_house_keeping", "");
1473 static function housekeeping_common($debug) {
1474 RSSUtils
::expire_cached_files($debug);
1475 RSSUtils
::expire_lock_files($debug);
1476 RSSUtils
::expire_error_log($debug);
1478 $count = RSSUtils
::update_feedbrowser_cache();
1479 _debug("Feedbrowser updated, $count feeds processed.");
1481 Article
::purge_orphans( true);
1482 RSSUtils
::cleanup_counters_cache($debug);
1484 //$rc = cleanup_tags( 14, 50000);
1485 //_debug("Cleaned $rc cached tags.");
1487 PluginHost
::getInstance()->run_hooks(PluginHost
::HOOK_HOUSE_KEEPING
, "hook_house_keeping", "");
1490 static function check_feed_favicon($site_url, $feed) {
1491 # print "FAVICON [$site_url]: $favicon_url\n";
1493 $icon_file = ICONS_DIR
. "/$feed.ico";
1495 if (!file_exists($icon_file)) {
1496 $favicon_url = get_favicon_url($site_url);
1499 // Limiting to "image" type misses those served with text/plain
1500 $contents = fetch_file_contents($favicon_url); // , "image");
1503 // Crude image type matching.
1504 // Patterns gleaned from the file(1) source code.
1505 if (preg_match('/^\x00\x00\x01\x00/', $contents)) {
1506 // 0 string \000\000\001\000 MS Windows icon resource
1507 //error_log("check_feed_favicon: favicon_url=$favicon_url isa MS Windows icon resource");
1509 elseif (preg_match('/^GIF8/', $contents)) {
1510 // 0 string GIF8 GIF image data
1511 //error_log("check_feed_favicon: favicon_url=$favicon_url isa GIF image");
1513 elseif (preg_match('/^\x89PNG\x0d\x0a\x1a\x0a/', $contents)) {
1514 // 0 string \x89PNG\x0d\x0a\x1a\x0a PNG image data
1515 //error_log("check_feed_favicon: favicon_url=$favicon_url isa PNG image");
1517 elseif (preg_match('/^\xff\xd8/', $contents)) {
1518 // 0 beshort 0xffd8 JPEG image data
1519 //error_log("check_feed_favicon: favicon_url=$favicon_url isa JPG image");
1522 //error_log("check_feed_favicon: favicon_url=$favicon_url isa UNKNOWN type");
1528 $fp = @fopen
($icon_file, "w");
1531 fwrite($fp, $contents);
1533 chmod($icon_file, 0644);