aggregator.module 56.2 KB
Newer Older
1
<?php
Dries's avatar
Dries committed
2
// $Id$
Dries's avatar
 
Dries committed
3

Dries's avatar
 
Dries committed
4 5
/**
 * @file
6
 * Used to aggregate syndicated content (RSS, RDF, and Atom).
Dries's avatar
 
Dries committed
7 8
 */

Dries's avatar
 
Dries committed
9 10 11
/**
 * Implementation of hook_help().
 */
Dries's avatar
 
Dries committed
12
function aggregator_help($section) {
Dries's avatar
 
Dries committed
13
  switch ($section) {
Kjartan's avatar
Kjartan committed
14
    case 'admin/help#aggregator':
15
      $output = '<p>'. t('The news aggregator is a powerful on-site RSS syndicator/news reader that can gather fresh content from news sites and weblogs around the web.') .'</p>';
16
      $output .= '<p>'. t('Users can view the latest news chronologically in the <a href="@aggregator">main news aggregator display</a> or by <a href="@aggregator-sources">source</a>. Administrators can add, edit and delete feeds and choose how often to check for newly updated news for each individual feed. Administrators can also tag individual feeds with categories, offering selective grouping of some feeds into separate displays. Listings of the latest news for individual sources or categorized sources can be enabled as blocks for display in the sidebar through the <a href="@admin-block">block administration page</a>. The news aggregator requires cron to check for the latest news from the sites to which you have subscribed. Drupal also provides a <a href="@aggregator-opml">machine-readable OPML file</a> of all of your subscribed feeds.', array('@aggregator' => url('aggregator'), '@aggregator-sources' => url('aggregator/sources'), '@admin-block' => url('admin/build/block'), '@aggregator-opml' => url('aggregator/opml'))) .'</p>';
17 18
      $output .= t('<p>You can</p>
<ul>
19 20 21 22 23 24 25
<li>administer your list of news feeds <a href="@admin-aggregator">administer &gt;&gt; content management &gt;&gt; RSS aggregator</a>.</li>
<li>add a new feed <a href="@admin-aggregator-add-feed">administer &gt;&gt; content management &gt;&gt; RSS aggregator &gt;&gt; add feed</a>.</li>
<li>add a new category <a href="@admin-aggregator-add-category">administer &gt;&gt; content management &gt;&gt; RSS aggregator &gt;&gt; add category</a>.</li>
<li>configure global settings for the news aggregator <a href="@admin-settings-aggregator">administer &gt;&gt; content management &gt;&gt; RSS aggregator &gt;&gt; settings</a>.</li>
<li>control access to the aggregator module through access permissions <a href="@admin-access">administer &gt;&gt; user management &gt;&gt; access control</a>.</li>
<li>set permissions to access new feeds for user roles such as anonymous users at <a href="@admin-access">administer &gt;&gt; user management &gt;&gt; access control</a>.</li>
<li>view the <a href="@aggregator">aggregator page</a>.</li>
26
</ul>
27 28
', array('@admin-aggregator' => url('admin/content/aggregator'), '@admin-aggregator-add-feed' => url('admin/content/aggregator/add/feed'), '@admin-aggregator-add-category' => url('admin/content/aggregator/add/category'), '@admin-settings-aggregator' => url('admin/settings/aggregator'), '@admin-access' => url('admin/user/access'), '@aggregator' => url('aggregator')));
      $output .= '<p>'. t('For more information please read the configuration and customization handbook <a href="@aggregator">Aggregator page</a>.', array('@aggregator' => 'http://drupal.org/handbook/modules/aggregator/')) .'</p>';
29
      return $output;
30
    case 'admin/content/aggregator':
31
      return t('<p>Thousands of sites (particularly news sites and weblogs) publish their latest headlines and/or stories in a machine-readable format so that other sites can easily link to them. This content is usually in the form of an <a href="http://blogs.law.harvard.edu/tech/rss">RSS</a> feed (which is an XML-based syndication standard). To display the feed or category in a block you must decide how many items to show by editing the feed or block and turning on the <a href="@block">feed\'s block</a>.</p>', array('@block' => url('admin/build/block')));
32
    case 'admin/content/aggregator/add/feed':
33
      return t('<p>Add a site that has an RSS/RDF/Atom feed. The URL is the full path to the feed file. For the feed to update automatically you must run "cron.php" on a regular basis. If you already have a feed with the URL you are planning to use, the system will not accept another feed with the same URL.</p>');
34
    case 'admin/content/aggregator/add/category':
35
      return t('<p>Categories provide a way to group items from different news feeds together. Each news category has its own feed page and block. For example, you could tag various sport-related feeds as belonging to a category called <em>Sports</em>. News items can be added to a category automatically by setting a feed to automatically place its item into that category, or by using the categorize items link in any listing of news items.</p>');
Dries's avatar
 
Dries committed
36
  }
37 38
}

39 40 41 42 43 44 45 46 47
/**
 * Implementation of hook_menu().
 */
function aggregator_menu($may_cache) {
  $items = array();
  $edit = user_access('administer news feeds');
  $view = user_access('access news feeds');

  if ($may_cache) {
48 49 50
    $items[] = array('path' => 'admin/content/aggregator',
      'title' => t('RSS aggregator'),
      'description' => t('Configure which content your site aggregates from other sites, how often it polls them, and how they\'re categorized.'),
51 52
      'callback' => 'aggregator_admin_overview',
      'access' => $edit);
53
    $items[] = array('path' => 'admin/content/aggregator/add/feed',
54
      'title' => t('add feed'),
55 56
      'callback' => 'drupal_get_form',
      'callback arguments' => array('aggregator_form_feed'),
57 58
      'access' => $edit,
      'type' => MENU_LOCAL_TASK);
59
    $items[] = array('path' => 'admin/content/aggregator/add/category',
60
      'title' => t('add category'),
61 62
      'callback' => 'drupal_get_form',
      'callback arguments' => array('aggregator_form_category'),
63 64
      'access' => $edit,
      'type' => MENU_LOCAL_TASK);
65
    $items[] = array('path' => 'admin/content/aggregator/remove',
66 67 68 69
      'title' => t('remove items'),
      'callback' => 'aggregator_admin_remove_feed',
      'access' => $edit,
      'type' => MENU_CALLBACK);
70
    $items[] = array('path' => 'admin/content/aggregator/update',
71 72 73 74
      'title' => t('update items'),
      'callback' => 'aggregator_admin_refresh_feed',
      'access' => $edit,
      'type' => MENU_CALLBACK);
75
    $items[] = array('path' => 'admin/content/aggregator/list',
76 77 78
      'title' => t('list'),
      'type' => MENU_DEFAULT_LOCAL_TASK,
      'weight' => -10);
79 80
    $items[] = array('path' => 'admin/content/aggregator/settings',
      'title' => t('settings'),
81 82
      'callback' => 'drupal_get_form',
      'callback arguments' => array('aggregator_admin_settings'),
83 84
      'type' => MENU_LOCAL_TASK,
      'weight' => 10,
Dries's avatar
Dries committed
85
      'access' => $edit);
86

87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110
    $items[] = array('path' => 'aggregator',
      'title' => t('news aggregator'),
      'callback' => 'aggregator_page_last',
      'access' => $view,
      'weight' => 5);
    $items[] = array('path' => 'aggregator/sources',
      'title' => t('sources'),
      'callback' => 'aggregator_page_sources',
      'access' => $view);
    $items[] = array('path' => 'aggregator/categories',
      'title' => t('categories'),
      'callback' => 'aggregator_page_categories',
      'access' => $view,
      'type' => MENU_ITEM_GROUPING);
    $items[] = array('path' => 'aggregator/rss',
      'title' => t('RSS feed'),
      'callback' => 'aggregator_page_rss',
      'access' => $view,
      'type' => MENU_CALLBACK);
    $items[] = array('path' => 'aggregator/opml',
      'title' => t('OPML feed'),
      'callback' => 'aggregator_page_opml',
      'access' => $view,
      'type' => MENU_CALLBACK);
111

112 113 114 115 116 117 118
    $result = db_query('SELECT title, cid FROM {aggregator_category} ORDER BY title');
    while ($category = db_fetch_array($result)) {
      $items[] = array('path' => 'aggregator/categories/'. $category['cid'],
        'title' => $category['title'],
        'callback' => 'aggregator_page_category',
        'access' => $view);
    }
119 120
  }
  else {
121 122 123 124
    // Add the CSS for this module
    // We put this in !$may_cache so it's only added once per request
    drupal_add_css(drupal_get_path('module', 'aggregator') .'/aggregator.css');

125 126 127 128 129
    if (arg(0) == 'aggregator' && is_numeric(arg(2))) {
      if (arg(1) == 'sources') {
        $feed = aggregator_get_feed(arg(2));
        if ($feed) {
          $items[] = array('path' => 'aggregator/sources/'. $feed['fid'],
130
            'title' => $feed['title'],
131
            'callback' => 'aggregator_page_source',
132 133
            'access' => $view,
            'type' => MENU_CALLBACK);
134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173
          $items[] = array('path' => 'aggregator/sources/'. $feed['fid'] .'/view',
            'title' => t('view'),
            'type' => MENU_DEFAULT_LOCAL_TASK,
            'weight' => -10);
          $items[] = array('path' => 'aggregator/sources/'. $feed['fid'] .'/categorize',
            'title' => t('categorize'),
            'callback' => 'aggregator_page_source',
            'access' => $edit,
            'type' => MENU_LOCAL_TASK);
          $items[] = array('path' => 'aggregator/sources/'. $feed['fid'] .'/configure',
            'title' => t('configure'),
            'callback' => 'aggregator_form_feed',
            'callback arguments' => array($feed),
            'access' => $edit,
            'type' => MENU_LOCAL_TASK,
            'weight' => 1);
        }
      }
      else if (arg(1) == 'categories') {
        $category = aggregator_get_category(arg(2));
        if ($category) {
          $items[] = array('path' => 'aggregator/categories/'. $category['cid'] .'/view',
            'title' => t('view'),
            'type' => MENU_DEFAULT_LOCAL_TASK,
            'weight' => -10);
          $items[] = array('path' => 'aggregator/categories/'. $category['cid'] .'/categorize',
            'title' => t('categorize'),
            'callback' => 'aggregator_page_category',
            'access' => $edit,
            'type' => MENU_LOCAL_TASK);
          $items[] = array('path' => 'aggregator/categories/'. $category['cid'] .'/configure',
            'title' => t('configure'),
            'callback' => 'aggregator_form_category',
            'callback arguments' => array($category),
            'access' => $edit,
            'type' => MENU_LOCAL_TASK,
            'weight' => 1);
        }
      }
    }
174 175 176
    else if (arg(2) == 'aggregator' && is_numeric(arg(5))) {
      if (arg(4) == 'feed') {
        $feed = aggregator_get_feed(arg(5));
177
        if ($feed) {
178
          $items[] = array('path' => 'admin/content/aggregator/edit/feed/'. $feed['fid'],
179
            'title' => t('edit feed'),
180 181
            'callback' => 'drupal_get_form',
            'callback arguments' => array('aggregator_form_feed', $feed),
182 183 184 185 186
            'access' => $edit,
            'type' => MENU_CALLBACK);
        }
      }
      else {
187
        $category = aggregator_get_category(arg(5));
188
        if ($category) {
189
          $items[] = array('path' => 'admin/content/aggregator/edit/category/'. $category['cid'],
190
            'title' => t('edit category'),
191 192
            'callback' => 'drupal_get_form',
            'callback arguments' => array('aggregator_form_category', $category),
193 194 195 196 197 198 199 200 201 202
            'access' => $edit,
            'type' => MENU_CALLBACK);
        }
      }
    }
  }

  return $items;
}

Dries's avatar
Dries committed
203
function aggregator_admin_settings() {
204
  $items = array(0 => t('none')) + drupal_map_assoc(array(3, 5, 10, 15, 20, 25), '_aggregator_items');
205
  $period = drupal_map_assoc(array(3600, 10800, 21600, 32400, 43200, 86400, 172800, 259200, 604800, 1209600, 2419200, 4838400, 9676800), 'format_interval');
Dries's avatar
 
Dries committed
206

207
  $form['aggregator_allowed_html_tags'] = array(
208 209 210
    '#type' => 'textfield', '#title' => t('Allowed HTML tags'), '#size' => 80, '#maxlength' => 255,
    '#default_value' => variable_get('aggregator_allowed_html_tags', '<a> <b> <br> <dd> <dl> <dt> <em> <i> <li> <ol> <p> <strong> <u> <ul>'),
    '#description' => t('The list of tags which are allowed in feeds, i.e., which will not be removed by Drupal.')
211 212 213
  );

  $form['aggregator_summary_items'] = array(
214 215 216
    '#type' => 'select', '#title' => t('Items shown in sources and categories pages') ,
    '#default_value' => variable_get('aggregator_summary_items', 3), '#options' => $items,
    '#description' =>  t('The number of items which will be shown with each feed or category in the feed and category summary pages.')
217 218 219
  );

  $form['aggregator_clear'] = array(
220 221
    '#type' => 'select', '#title' => t('Discard news items older than'),
    '#default_value' => variable_get('aggregator_clear', 9676800), '#options' => $period,
222
    '#description' => t('Older news items will be automatically discarded. Requires crontab.')
223
  );
224

225
  $form['aggregator_category_selector'] = array(
226
    '#type' => 'radios', '#title' => t('Category selection type'), '#default_value' => variable_get('aggregator_category_selector', 'check'),
227
    '#options' => array('checkboxes' => t('checkboxes'), 'select' => t('multiple selector')),
228
    '#description' => t('The type of category selection widget which is shown on categorization pages. Checkboxes are easier to use; a multiple selector is good for working with large numbers of categories.')
229
  );
Dries's avatar
Dries committed
230

231
  return system_settings_form($form);
Dries's avatar
 
Dries committed
232 233
}

Dries's avatar
 
Dries committed
234 235 236
/**
 * Implementation of hook_perm().
 */
Kjartan's avatar
Kjartan committed
237
function aggregator_perm() {
Dries's avatar
 
Dries committed
238
  return array('administer news feeds', 'access news feeds');
Dries's avatar
 
Dries committed
239 240
}

Dries's avatar
 
Dries committed
241 242 243 244 245
/**
 * Implementation of hook_cron().
 *
 * Checks news feeds for updates once their refresh interval has elapsed.
 */
Dries's avatar
 
Dries committed
246
function aggregator_cron() {
Dries's avatar
 
Dries committed
247
  $result = db_query('SELECT * FROM {aggregator_feed} WHERE checked + refresh < %d', time());
Dries's avatar
 
Dries committed
248 249
  while ($feed = db_fetch_array($result)) {
    aggregator_refresh($feed);
Dries's avatar
 
Dries committed
250 251 252
  }
}

Dries's avatar
 
Dries committed
253 254 255 256 257
/**
 * Implementation of hook_block().
 *
 * Generates blocks for the latest news items in each category and feed.
 */
Dries's avatar
Dries committed
258
function aggregator_block($op, $delta = 0, $edit = array()) {
Dries's avatar
 
Dries committed
259
  if (user_access('access news feeds')) {
Dries's avatar
 
Dries committed
260
    if ($op == 'list') {
Dries's avatar
Dries committed
261
      $result = db_query('SELECT cid, title FROM {aggregator_category} ORDER BY title');
Dries's avatar
 
Dries committed
262
      while ($category = db_fetch_object($result)) {
263
        $block['category-'. $category->cid]['info'] = t('%title category latest items', array('%title' => $category->title));
Kjartan's avatar
Kjartan committed
264
      }
Dries's avatar
Dries committed
265
      $result = db_query('SELECT fid, title FROM {aggregator_feed} ORDER BY fid');
Kjartan's avatar
Kjartan committed
266
      while ($feed = db_fetch_object($result)) {
267
        $block['feed-'. $feed->fid]['info'] = t('%title feed latest items', array('%title' => $feed->title));
Kjartan's avatar
Kjartan committed
268
      }
Dries's avatar
 
Dries committed
269
    }
Dries's avatar
Dries committed
270
    else if ($op == 'configure') {
271
      list($type, $id) = explode('-', $delta);
Dries's avatar
Dries committed
272 273 274 275 276 277
      if ($type == 'category') {
        $value = db_result(db_query('SELECT block FROM {aggregator_category} WHERE cid = %d', $id));
      }
      else {
        $value = db_result(db_query('SELECT block FROM {aggregator_feed} WHERE fid = %d', $id));
      }
278
      $form['block'] = array('#type' => 'select', '#title' => t('Number of news items in block'), '#default_value' => $value, '#options' => drupal_map_assoc(array(2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20)));
279
      return $form;
Dries's avatar
Dries committed
280 281
    }
    else if ($op == 'save') {
282
      list($type, $id) = explode('-', $delta);
Dries's avatar
Dries committed
283 284 285 286 287 288 289
      if ($type == 'category') {
        $value = db_query('UPDATE {aggregator_category} SET block = %d WHERE cid = %d', $edit['block'], $id);
      }
      else {
        $value = db_query('UPDATE {aggregator_feed} SET block = %d WHERE fid = %d', $edit['block'], $id);
      }
    }
290
    else if ($op == 'view') {
291
      list($type, $id) = explode('-', $delta);
Kjartan's avatar
Kjartan committed
292
      switch ($type) {
Dries's avatar
 
Dries committed
293
        case 'feed':
294
          if ($feed = db_fetch_object(db_query('SELECT fid, title, block FROM {aggregator_feed} WHERE fid = %d', $id))) {
295
            $block['subject'] = check_plain($feed->title);
296 297 298
            $result = db_query_range('SELECT * FROM {aggregator_item} WHERE fid = %d ORDER BY timestamp DESC, iid DESC', $feed->fid, 0, $feed->block);
            $block['content'] = '<div class="more-link">'. l(t('more'), 'aggregator/sources/'. $feed->fid, array('title' => t('View this feed\'s recent news.'))) .'</div>';
          }
Kjartan's avatar
Kjartan committed
299
          break;
300

Dries's avatar
 
Dries committed
301
        case 'category':
302
          if ($category = db_fetch_object(db_query('SELECT cid, title, block FROM {aggregator_category} WHERE cid = %d', $id))) {
303
            $block['subject'] = check_plain($category->title);
304 305 306
            $result = db_query_range('SELECT i.* FROM {aggregator_category_item} ci LEFT JOIN {aggregator_item} i ON ci.iid = i.iid WHERE ci.cid = %d ORDER BY i.timestamp DESC, i.iid DESC', $category->cid, 0, $category->block);
            $block['content'] = '<div class="more-link">'. l(t('more'), 'aggregator/categories/'. $category->cid, array('title' => t('View this category\'s recent news.'))) .'</div>';
          }
Kjartan's avatar
Kjartan committed
307 308
          break;
      }
Dries's avatar
 
Dries committed
309 310
      $items = array();
      while ($item = db_fetch_object($result)) {
Dries's avatar
 
Dries committed
311
        $items[] = theme('aggregator_block_item', $item);
Dries's avatar
 
Dries committed
312
      }
Dries's avatar
 
Dries committed
313
      $block['content'] = theme('item_list', $items) . $block['content'];
Dries's avatar
 
Dries committed
314
    }
Dries's avatar
 
Dries committed
315
    return $block;
Dries's avatar
 
Dries committed
316
  }
Dries's avatar
 
Dries committed
317 318
}

319 320 321 322 323 324 325 326 327 328 329 330 331 332
/**
 * Generate a form to add/edit/delete aggregator categories.
 */
 function aggregator_form_category($edit = array()) {
  $form['title'] = array('#type' => 'textfield',
    '#title' => t('Title'),
    '#default_value' => $edit['title'],
    '#maxlength' => 64,
    '#required' => TRUE,
  );
  $form['description'] = array('#type' => 'textarea',
    '#title' => t('Description'),
    '#default_value' => $edit['description'],
  );
333
  $form['submit'] = array('#type' => 'submit', '#value' => t('Submit'));
334 335

  if ($edit['cid']) {
336
    $form['delete'] = array('#type' => 'submit', '#value' => t('Delete'));
337 338 339
    $form['cid'] = array('#type' => 'hidden', '#value' => $edit['cid']);
  }

340
  return $form;
341 342 343 344 345 346 347 348 349 350 351 352 353 354 355
}

/**
 * Validate aggregator_form_feed form submissions.
 */
function aggregator_form_category_validate($form_id, $form_values) {
  if ($_POST['op'] == t('Submit')) {
    // Check for duplicate titles
    if (isset($form_values['cid'])) {
      $category = db_fetch_object(db_query("SELECT cid FROM {aggregator_category} WHERE title = '%s' AND cid != %d", $form_values['title'], $form_values['cid']));
    }
    else {
      $category = db_fetch_object(db_query("SELECT cid FROM {aggregator_category} WHERE title = '%s'", $form_values['title']));
    }
    if ($category) {
356
      form_set_error('title', t('A category named %category already exists. Please enter a unique title.', array('%category' => $form_values['title'])));
357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374
    }
  }
}

/**
 * Process aggregator_form_category form submissions.
 * @todo Add delete confirmation dialog.
 */
function aggregator_form_category_submit($form_id, $form_values) {
  if ($_POST['op'] == t('Delete')) {
    $title = $form_values['title'];
    // Unset the title:
    unset($form_values['title']);
  }
  aggregator_save_category($form_values);
  menu_rebuild();
  if (isset($form_values['cid'])) {
    if (isset($form_values['title'])) {
375
      drupal_set_message(t('The category %category has been updated.', array('%category' => $form_values['title'])));
376
      if (arg(0) == 'admin') {
377
        return 'admin/content/aggregator/';
378 379 380 381 382 383
      }
      else {
        return 'aggregator/categories/'. $form_values['cid'];
      }
    }
    else {
384 385
      watchdog('aggregator', t('Category %category deleted.', array('%category' => $title)));
      drupal_set_message(t('The category %category has been deleted.', array('%category' => $title)));
386
      if (arg(0) == 'admin') {
387
        return 'admin/content/aggregator/';
388 389 390 391 392 393 394
      }
      else {
        return 'aggregator/categories/';
      }
    }
  }
  else {
395 396
    watchdog('aggregator', t('Category %category added.', array('%category' => $form_values['title'])), WATCHDOG_NOTICE, l(t('view'), 'admin/content/aggregator'));
    drupal_set_message(t('The category %category has been added.', array('%category' => $form_values['title'])));
397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452
  }
}

/**
 * Add/edit/delete aggregator categories.
 */
function aggregator_save_category($edit) {
  if ($edit['cid'] && $edit['title']) {
    db_query("UPDATE {aggregator_category} SET title = '%s', description = '%s' WHERE cid = %d", $edit['title'], $edit['description'], $edit['cid']);
  }
  else if ($edit['cid']) {
    db_query('DELETE FROM {aggregator_category} WHERE cid = %d', $edit['cid']);
  }
  else if ($edit['title']) {
    // A single unique id for bundles and feeds, to use in blocks
    $next_id = db_next_id('{aggregator_category}_cid');
    db_query("INSERT INTO {aggregator_category} (cid, title, description, block) VALUES (%d, '%s', '%s', 5)", $next_id, $edit['title'], $edit['description']);
  }
}

/**
 * Generate a form to add/edit feed sources.
 */
function aggregator_form_feed($edit = array()) {
  $period = drupal_map_assoc(array(900, 1800, 3600, 7200, 10800, 21600, 32400, 43200, 64800, 86400, 172800, 259200, 604800, 1209600, 2419200), 'format_interval');

  if ($edit['refresh'] == '') {
    $edit['refresh'] = 3600;
  }

  $form['title'] = array('#type' => 'textfield',
    '#title' => t('Title'),
    '#default_value' => $edit['title'],
    '#maxlength' => 64,
    '#description' => t('The name of the feed; typically the name of the web site you syndicate content from.'),
    '#required' => TRUE,
  );
  $form['url'] = array('#type' => 'textfield',
    '#title' => t('URL'),
    '#default_value' => $edit['url'],
    '#maxlength' => 255,
    '#description' => t('The fully-qualified URL of the feed.'),
    '#required' => TRUE,
  );
  $form['refresh'] = array('#type' => 'select',
    '#title' => t('Update interval'),
    '#default_value' => $edit['refresh'],
    '#options' => $period,
    '#description' => t('The refresh interval indicating how often you want to update this feed. Requires crontab.'),
  );

  // Handling of categories:
  $options = array();
  $values = array();
  $categories = db_query('SELECT c.cid, c.title, f.fid FROM {aggregator_category} c LEFT JOIN {aggregator_category_feed} f ON c.cid = f.cid AND f.fid = %d ORDER BY title', $edit['fid']);
  while ($category = db_fetch_object($categories)) {
453 454
    $options[$category->cid] = check_plain($category->title);
    if ($category->fid) $values[] = $category->cid;
455 456 457 458 459 460 461 462 463
  }
  if ($options) {
    $form['category'] = array('#type' => 'checkboxes',
      '#title' => t('Categorize news items'),
      '#default_value' => $values,
      '#options' => $options,
      '#description' => t('New items in this feed will be automatically filed in the checked categories as they are received.'),
    );
  }
464
  $form['submit'] = array('#type' => 'submit', '#value' => t('Submit'));
465 466

  if ($edit['fid']) {
467
    $form['delete'] = array('#type' => 'submit', '#value' => t('Delete'));
468 469 470
    $form['fid'] = array('#type' => 'hidden', '#value' => $edit['fid']);
  }

471
  return $form;
472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487
}

/**
 * Validate aggregator_form_feed form submissions.
 */
function aggregator_form_feed_validate($form_id, $form_values) {
  if ($_POST['op'] == t('Submit')) {
    // Check for duplicate titles
    if (isset($form_values['fid'])) {
      $result = db_query("SELECT title, url FROM {aggregator_feed} WHERE (title = '%s' OR url='%s') AND fid != %d", $form_values['title'], $form_values['url'], $form_values['fid']);
    }
    else {
      $result = db_query("SELECT title, url FROM {aggregator_feed} WHERE title = '%s' OR url='%s'", $form_values['title'], $form_values['url']);
    }
    while ($feed = db_fetch_object($result)) {
      if (strcasecmp($feed->title, $form_values['title']) == 0) {
488
        form_set_error('title', t('A feed named %feed already exists. Please enter a unique title.', array('%feed' => $form_values['title'])));
489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507
      }
    }
  }
}

/**
 * Process aggregator_form_feed form submissions.
 * @todo Add delete confirmation dialog.
 */
function aggregator_form_feed_submit($form_id, $form_values) {
  if ($_POST['op'] == t('Delete')) {
    $title = $form_values['title'];
    // Unset the title:
    unset($form_values['title']);
  }
  aggregator_save_feed($form_values);
  menu_rebuild();
  if (isset($form_values['fid'])) {
    if (isset($form_values['title'])) {
508
      drupal_set_message(t('The feed %feed has been updated.', array('%feed' => $form_values['title'])));
509
      if (arg(0) == 'admin') {
510
        return 'admin/content/aggregator/';
511 512 513 514 515 516
      }
      else {
        return 'aggregator/sources/'. $form_values['fid'];
      }
    }
    else {
517 518
      watchdog('aggregator', t('Feed %feed deleted.', array('%feed' => $title)));
      drupal_set_message(t('The feed %feed has been deleted.', array('%feed' => $title)));
519
      if (arg(0) == 'admin') {
520
        return 'admin/content/aggregator/';
521 522 523 524 525 526 527
      }
      else {
        return 'aggregator/sources/';
      }
    }
  }
  else {
528 529
    watchdog('aggregator', t('Feed %feed added.', array('%feed' => $form_values['title'])), WATCHDOG_NOTICE, l(t('view'), 'admin/content/aggregator'));
    drupal_set_message(t('The feed %feed has been added.', array('%feed' => $form_values['title'])));
530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571
  }
}

/**
 * Add/edit/delete an aggregator feed.
 */
function aggregator_save_feed($edit) {
  if ($edit['fid']) {
    // An existing feed is being modified, delete the category listings.
    db_query('DELETE FROM {aggregator_category_feed} WHERE fid = %d', $edit['fid']);
  }
  if ($edit['fid'] && $edit['title']) {
    db_query("UPDATE {aggregator_feed} SET title = '%s', url = '%s', refresh = %d WHERE fid = %d", $edit['title'], $edit['url'], $edit['refresh'], $edit['fid']);
  }
  else if ($edit['fid']) {
    $result = db_query('SELECT iid FROM {aggregator_item} WHERE fid = %d', $edit['fid']);
    while ($item = db_fetch_object($result)) {
      $items[] = "iid = $item->iid";
    }
    if ($items) {
      db_query('DELETE FROM {aggregator_category_item} WHERE '. implode(' OR ', $items));
    }
    db_query('DELETE FROM {aggregator_feed} WHERE fid = %d', $edit['fid']);
    db_query('DELETE FROM {aggregator_item} WHERE fid = %d', $edit['fid']);
  }
  else if ($edit['title']) {
    // A single unique id for bundles and feeds, to use in blocks.
    $edit['fid'] = db_next_id('{aggregator_feed}_fid');
    db_query("INSERT INTO {aggregator_feed} (fid, title, url, refresh, block) VALUES (%d, '%s', '%s', %d, 5)", $edit['fid'], $edit['title'], $edit['url'], $edit['refresh']);
  }
  if ($edit['title']) {
    // The feed is being saved, save the categories as well.
    if ($edit['category']) {
      foreach ($edit['category'] as $cid => $value) {
        if ($value) {
          db_query('INSERT INTO {aggregator_category_feed} (fid, cid) VALUES (%d, %d)', $edit['fid'], $cid);
        }
      }
    }
  }
}

Dries's avatar
 
Dries committed
572 573 574 575
function aggregator_remove($feed) {
  $result = db_query('SELECT iid FROM {aggregator_item} WHERE fid = %d', $feed['fid']);
  while ($item = db_fetch_object($result)) {
    $items[] = "iid = $item->iid";
Dries's avatar
 
Dries committed
576
  }
Dries's avatar
 
Dries committed
577 578
  if ($items) {
    db_query('DELETE FROM {aggregator_category_item} WHERE '. implode(' OR ', $items));
Dries's avatar
 
Dries committed
579
  }
Dries's avatar
 
Dries committed
580
  db_query('DELETE FROM {aggregator_item} WHERE fid = %d', $feed['fid']);
Kjartan's avatar
Kjartan committed
581
  db_query("UPDATE {aggregator_feed} SET checked = 0, etag = '', modified = 0 WHERE fid = %d", $feed['fid']);
582
  drupal_set_message(t('The news items from %site have been removed.', array('%site' => $feed['title'])));
Dries's avatar
 
Dries committed
583 584
}

Dries's avatar
 
Dries committed
585 586 587
/**
 * Call-back function used by the XML parser.
 */
Kjartan's avatar
Kjartan committed
588
function aggregator_element_start($parser, $name, $attributes) {
589
  global $item, $element, $tag, $items, $channel;
Dries's avatar
 
Dries committed
590 591

  switch ($name) {
Dries's avatar
 
Dries committed
592 593
    case 'IMAGE':
    case 'TEXTINPUT':
594 595 596 597 598 599
    case 'CONTENT':
    case 'SUMMARY':
    case 'TAGLINE':
    case 'SUBTITLE':
    case 'LOGO':
    case 'INFO':
Dries's avatar
 
Dries committed
600 601
      $element = $name;
      break;
602 603 604 605
    case 'ID':
      if ($element != 'ITEM') {
        $element = $name;
      }
606 607 608 609 610 611 612 613 614 615
    case 'LINK':
      if ($attributes['REL'] == 'alternate') {
        if ($element == 'ITEM') {
          $items[$item]['LINK'] = $attributes['HREF'];
        }
        else {
          $channel['LINK'] = $attributes['HREF'];
        }
      }
      break;
Dries's avatar
 
Dries committed
616
    case 'ITEM':
Dries's avatar
 
Dries committed
617 618
      $element = $name;
      $item += 1;
619 620 621 622 623
      break;
    case 'ENTRY':
      $element = 'ITEM';
      $item += 1;
      break;
624 625 626 627 628
  }

  $tag = $name;
}

Dries's avatar
 
Dries committed
629 630 631
/**
 * Call-back function used by the XML parser.
 */
Kjartan's avatar
Kjartan committed
632
function aggregator_element_end($parser, $name) {
Dries's avatar
 
Dries committed
633 634
  global $element;

Dries's avatar
 
Dries committed
635
  switch ($name) {
Dries's avatar
 
Dries committed
636 637 638
    case 'IMAGE':
    case 'TEXTINPUT':
    case 'ITEM':
639 640 641
    case 'ENTRY':
    case 'CONTENT':
    case 'INFO':
642 643
      $element = '';
      break;
644
    case 'ID':
645
      if ($element == 'ID') {
646 647
        $element = '';
      }
Dries's avatar
 
Dries committed
648
  }
649 650
}

Dries's avatar
 
Dries committed
651 652 653
/**
 * Call-back function used by the XML parser.
 */
Kjartan's avatar
Kjartan committed
654
function aggregator_element_data($parser, $data) {
Dries's avatar
 
Dries committed
655
  global $channel, $element, $items, $item, $image, $tag;
Dries's avatar
 
Dries committed
656 657

  switch ($element) {
Dries's avatar
 
Dries committed
658
    case 'ITEM':
Dries's avatar
 
Dries committed
659 660
      $items[$item][$tag] .= $data;
      break;
Dries's avatar
 
Dries committed
661
    case 'IMAGE':
662
    case 'LOGO':
Dries's avatar
 
Dries committed
663 664
      $image[$tag] .= $data;
      break;
665 666 667 668 669 670
    case 'LINK':
      if ($data) {
        $items[$item][$tag] .= $data;
      }
      break;
    case 'CONTENT':
671
      $items[$item]['CONTENT'] .= $data;
672 673
      break;
    case 'SUMMARY':
674
      $items[$item]['SUMMARY'] .= $data;
675 676 677 678 679 680 681
      break;
    case 'TAGLINE':
    case 'SUBTITLE':
      $channel['DESCRIPTION'] .= $data;
      break;
    case 'INFO':
    case 'ID':
Dries's avatar
 
Dries committed
682 683 684
    case 'TEXTINPUT':
      // The sub-element is not supported. However, we must recognize
      // it or its contents will end up in the item array.
Dries's avatar
 
Dries committed
685 686 687
      break;
    default:
      $channel[$tag] .= $data;
688 689 690
  }
}

Dries's avatar
 
Dries committed
691 692 693
/**
 * Checks a news feed for new items.
 */
Kjartan's avatar
Kjartan committed
694
function aggregator_refresh($feed) {
Dries's avatar
 
Dries committed
695 696
  global $channel, $image;

Dries's avatar
 
Dries committed
697 698 699 700 701 702
  // Generate conditional GET headers.
  $headers = array();
  if ($feed['etag']) {
    $headers['If-None-Match'] = $feed['etag'];
  }
  if ($feed['modified']) {
Dries's avatar
 
Dries committed
703
    $headers['If-Modified-Since'] = gmdate('D, d M Y H:i:s', $feed['modified']) .' GMT';
Dries's avatar
 
Dries committed
704 705 706 707 708
  }

  // Request feed.
  $result = drupal_http_request($feed['url'], $headers);

709
  // Process HTTP response code.
Dries's avatar
 
Dries committed
710 711
  switch ($result->code) {
    case 304:
Dries's avatar
 
Dries committed
712
      db_query('UPDATE {aggregator_feed} SET checked = %d WHERE fid = %d', time(), $feed['fid']);
713
      drupal_set_message(t('There is no new syndicated content from %site.', array('%site' => $feed['title'])));
Dries's avatar
 
Dries committed
714
      break;
Dries's avatar
 
Dries committed
715 716
    case 301:
      $feed['url'] = $result->redirect_url;
717
      watchdog('aggregator', t('Updated URL for feed %title to %url.', array('%title' => $feed['title'], '%url' => $feed['url'])));
718

Dries's avatar
 
Dries committed
719 720 721 722
    case 200:
    case 302:
    case 307:
      // Filter the input data:
723
     if (aggregator_parse_feed($result->data, $feed)) {
724

Dries's avatar
 
Dries committed
725 726 727
        if ($result->headers['Last-Modified']) {
          $modified = strtotime($result->headers['Last-Modified']);
        }
Dries's avatar
Dries committed
728

729 730 731 732 733
        /*
        ** Prepare the channel data:
        */

        foreach ($channel as $key => $value) {
734
          $channel[$key] = trim($value);
735 736
        }

Dries's avatar
 
Dries committed
737 738 739
        /*
        ** Prepare the image data (if any):
        */
Dries's avatar
 
Dries committed
740

Dries's avatar
 
Dries committed
741 742 743
        foreach ($image as $key => $value) {
          $image[$key] = trim($value);
        }
Dries's avatar
 
Dries committed
744

Dries's avatar
 
Dries committed
745
        if ($image['LINK'] && $image['URL'] && $image['TITLE']) {
746 747
          // Note, we should really use theme_image() here but that only works with local images it won't work with images fetched with a URL unless PHP version > 5
          $image = '<a href="'. check_url($image['LINK']) .'" class="feed-image"><img src="'. check_url($image['URL']) .'" alt="'. check_plain($image['TITLE']) .'" /></a>';
Dries's avatar
 
Dries committed
748
        }
Dries's avatar
 
Dries committed
749 750 751
        else {
          $image = NULL;
        }
Dries's avatar
 
Dries committed
752

Dries's avatar
 
Dries committed
753 754 755
        /*
        ** Update the feed data:
        */
Dries's avatar
 
Dries committed
756

757
        db_query("UPDATE {aggregator_feed} SET url = '%s', checked = %d, link = '%s', description = '%s', image = '%s', etag = '%s', modified = %d WHERE fid = %d", $feed['url'], time(), $channel['LINK'], $channel['DESCRIPTION'], $image, $result->headers['ETag'], $modified, $feed['fid']);
Dries's avatar
 
Dries committed
758

Dries's avatar
 
Dries committed
759 760 761
        /*
        ** Clear the cache:
        */
Dries's avatar
 
Dries committed
762

Dries's avatar
 
Dries committed
763
        cache_clear_all();
Dries's avatar
 
Dries committed
764

765 766
        watchdog('aggregator', t('There is new syndicated content from %site.', array('%site' => $feed['title'])));
        drupal_set_message(t('There is new syndicated content from %site.', array('%site' => $feed['title'])));
Dries's avatar
 
Dries committed
767 768
      }
      break;
Dries's avatar
 
Dries committed
769
    default:
770 771
      watchdog('aggregator', t('The RSS-feed from %site seems to be broken, due to "%error".', array('%site' => $feed['title'], '%error' => $result->code .' '. $result->error)), WATCHDOG_WARNING);
      drupal_set_message(t('The RSS-feed from %site seems to be broken, because of error "%error".', array('%site' => $feed['title'], '%error' => $result->code .' '. $result->error)));
Dries's avatar
 
Dries committed
772
  }
Dries's avatar
 
Dries committed
773
}
Dries's avatar
 
Dries committed
774

Dries's avatar
 
Dries committed
775 776 777 778
/**
 * Parse the W3C date/time format, a subset of ISO 8601. PHP date parsing
 * functions do not handle this format.
 * See http://www.w3.org/TR/NOTE-datetime for more information.
779
 * Originally from MagpieRSS (http://magpierss.sourceforge.net/).
Dries's avatar
 
Dries committed
780 781
 *
 * @param $date_str A string with a potentially W3C DTF date.
782
 * @return A timestamp if parsed successfully or -1 if not.
Dries's avatar
 
Dries committed
783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807
 */
function aggregator_parse_w3cdtf($date_str) {
  if (preg_match('/(\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2})(:(\d{2}))?(?:([-+])(\d{2}):?(\d{2})|(Z))?/', $date_str, $match)) {
    list($year, $month, $day, $hours, $minutes, $seconds) = array($match[1], $match[2], $match[3], $match[4], $match[5], $match[6]);
    // calc epoch for current date assuming GMT
    $epoch = gmmktime($hours, $minutes, $seconds, $month, $day, $year);
    if ($match[10] != 'Z') { // Z is zulu time, aka GMT
      list($tz_mod, $tz_hour, $tz_min) = array($match[8], $match[9], $match[10]);
      // zero out the variables
      if (!$tz_hour) {
        $tz_hour = 0;
      }
      if (!$tz_min) {
        $tz_min = 0;
      }
      $offset_secs = (($tz_hour * 60) + $tz_min) * 60;
      // is timezone ahead of GMT?  then subtract offset
      if ($tz_mod == '+') {
        $offset_secs *= -1;
      }
      $epoch += $offset_secs;
    }
    return $epoch;
  }
  else {
808
    return FALSE;
Dries's avatar
 
Dries committed
809 810 811
  }
}

Dries's avatar
 
Dries committed
812
function aggregator_parse_feed(&$data, $feed) {
Dries's avatar
 
Dries committed
813
  global $items, $image, $channel;
Dries's avatar
 
Dries committed
814

Dries's avatar
 
Dries committed
815
  // Unset the global variables before we use them:
Dries's avatar
 
Dries committed
816
  unset($GLOBALS['element'], $GLOBALS['item'], $GLOBALS['tag']);
Dries's avatar
 
Dries committed
817
  $items = array();
Dries's avatar
 
Dries committed
818
  $image = array();
Dries's avatar
 
Dries committed
819
  $channel = array();
820

Dries's avatar
 
Dries committed
821 822
  // parse the data:
  $xml_parser = drupal_xml_parser_create($data);
Dries's avatar
 
Dries committed
823 824
  xml_set_element_handler($xml_parser, 'aggregator_element_start', 'aggregator_element_end');
  xml_set_character_data_handler($xml_parser, 'aggregator_element_data');
Dries's avatar
 
Dries committed
825

Dries's avatar
 
Dries committed
826
  if (!xml_parse($xml_parser, $data, 1)) {
827 828
    watchdog('aggregator', t('The RSS-feed from %site seems to be broken, due to an error "%error" on line %line.', array('%site' => $feed['title'], '%error' => xml_error_string(xml_get_error_code($xml_parser)), '%line' => xml_get_current_line_number($xml_parser))), WATCHDOG_WARNING);
    drupal_set_message(t('The RSS-feed from %site seems to be broken, because of error "%error" on line %line.', array('%site' => $feed['title'], '%error' => xml_error_string(xml_get_error_code($xml_parser)), '%line' => xml_get_current_line_number($xml_parser))), 'error');
Dries's avatar
 
Dries committed
829
    return 0;
Dries's avatar
 
Dries committed
830 831
  }
  xml_parser_free($xml_parser);
Dries's avatar
 
Dries committed
832

Dries's avatar
 
Dries committed
833 834
  /*
  ** We reverse the array such that we store the first item last,
835
  ** and the last item first. In the database, the newest item
Dries's avatar
 
Dries committed
836 837
  ** should be at the top.
  */
Dries's avatar
 
Dries committed
838

Dries's avatar
 
Dries committed
839
  $items = array_reverse($items);
Dries's avatar
 
Dries committed
840

841 842
  // Initialize variables
  $title = $link = $author = $description = $guid = NULL;
Dries's avatar
 
Dries committed
843
  foreach ($items as $item) {
844
    unset($title, $link, $author, $description, $guid);
845

Dries's avatar
 
Dries committed
846 847
    // Prepare the item:
    foreach ($item as $key => $value) {
848
      $item[$key] = trim($value);
Dries's avatar
 
Dries committed
849
    }
Dries's avatar
Dries committed
850

Dries's avatar
 
Dries committed
851
    /*
852
    ** Resolve the item's title. If no title is found, we use
Dries's avatar
 
Dries committed
853 854 855 856
    ** up to 40 characters of the description ending at a word
    ** boundary but not splitting potential entities.
    */

Dries's avatar
 
Dries committed
857 858
    if ($item['TITLE']) {
      $title = $item['TITLE'];
Dries's avatar
 
Dries committed
859 860
    }
    else {
Dries's avatar
 
Dries committed
861
      $title = preg_replace('/^(.*)[^\w;&].*?$/', "\\1", truncate_utf8($item['DESCRIPTION'], 40));
Dries's avatar
 
Dries committed
862
    }
Dries's avatar
 
Dries committed
863

Dries's avatar
 
Dries committed
864 865 866 867
    /*
    ** Resolve the items link.
    */

Dries's avatar
 
Dries committed
868 869
    if ($item['LINK']) {
      $link = $item['LINK'];
Dries's avatar
 
Dries committed
870 871
    }
    else {
Dries's avatar
 
Dries committed
872
      $link = $feed['link'];
Dries's avatar
 
Dries committed
873
    }
874 875 876
    if ($item['GUID']) {
      $guid = $item['GUID'];
    }
877

878 879 880
    /**
     * Atom feeds have a CONTENT and/or SUMMARY tag instead of a DESCRIPTION tag
     */
881 882
    if ($item['CONTENT:ENCODED']) {
      $item['DESCRIPTION'] = $item['CONTENT:ENCODED'];
883 884 885 886 887
    }
    else if ($item['SUMMARY']) {
      $item['DESCRIPTION'] = $item['SUMMARY'];
    }

Dries's avatar
 
Dries committed
888
    /*
889
    ** Try to resolve and parse the item's publication date. If no
Dries's avatar
 
Dries committed
890 891 892 893 894 895 896 897
    ** date is found, we use the current date instead.
    */

    if ($item['PUBDATE']) $date = $item['PUBDATE'];                        // RSS 2.0
    else if ($item['DC:DATE']) $date = $item['DC:DATE'];                   // Dublin core
    else if ($item['DCTERMS:ISSUED']) $date = $item['DCTERMS:ISSUED'];     // Dublin core
    else if ($item['DCTERMS:CREATED']) $date = $item['DCTERMS:CREATED'];   // Dublin core
    else if ($item['DCTERMS:MODIFIED']) $date = $item['DCTERMS:MODIFIED']; // Dublin core
898 899 900
    else if ($item['ISSUED']) $date = $item['ISSUED'];                     // Atom XML
    else if ($item['CREATED']) $date = $item['CREATED'];                   // Atom XML
    else if ($item['MODIFIED']) $date = $item['MODIFIED'];                 // Atom XML
901 902
    else if ($item['PUBLISHED']) $date = $item['PUBLISHED'];               // Atom XML
    else if ($item['UPDATED']) $date = $item['UPDATED'];                   // Atom XML
Dries's avatar
 
Dries committed
903
    else $date = 'now';
Dries's avatar
 
Dries committed
904

905 906 907 908
    $timestamp = strtotime($date); // As of PHP 5.1.0, strtotime returns FALSE on failure instead of -1.
    if ($timestamp <= 0) {
      $timestamp = aggregator_parse_w3cdtf($date); // Returns FALSE on failure
      if (!$timestamp) {
Dries's avatar
 
Dries committed
909 910
        $timestamp = time(); // better than nothing
      }
911
    }
Dries's avatar
 
Dries committed
912 913

    /*
914 915
    ** Save this item. Try to avoid duplicate entries as much as
    ** possible. If we find a duplicate entry, we resolve it and
Dries's avatar
 
Dries committed
916
    ** pass along it's ID such that we can update it if needed.
Dries's avatar
 
Dries committed
917 918
    */

919 920 921 922
    if ($guid) {
      $entry = db_fetch_object(db_query("SELECT iid FROM {aggregator_item} WHERE fid = %d AND guid = '%s'", $feed['fid'], $guid));
    }
    else if ($link && $link != $feed['link'] && $link != $feed['url']) {
Dries's avatar
 
Dries committed
923
      $entry = db_fetch_object(db_query("SELECT iid FROM {aggregator_item} WHERE fid = %d AND link = '%s'", $feed['fid'], $link));
Dries's avatar
 
Dries committed
924 925
    }
    else {
Dries's avatar
 
Dries committed
926
      $entry = db_fetch_object(db_query("SELECT iid FROM {aggregator_item} WHERE fid = %d AND title = '%s'", $feed['fid'], $title));
Dries's avatar
 
Dries committed
927
    }
Dries's avatar
 
Dries committed
928

929
    aggregator_save_item(array('iid' => $entry->iid, 'fid' => $feed['fid'], 'timestamp' => $timestamp, 'title' => $title, 'link' => $link, 'author' => $item['AUTHOR'], 'description' => $item['DESCRIPTION'], 'guid' => $guid));
Dries's avatar
 
Dries committed
930
  }
Dries's avatar
 
Dries committed
931

Dries's avatar
 
Dries committed
932
  /*
933
  ** Remove all items that are older than flush item timer: