home *** CD-ROM | disk | FTP | other *** search
/ Cricao de Sites - 650 Layouts Prontos / WebMasters.iso / CMS / drupal-6.0.exe / drupal-6.0 / modules / aggregator / aggregator.admin.inc < prev    next >
Encoding:
Text File  |  2008-01-11  |  13.7 KB  |  342 lines
  1. <?php
  2. // $Id: aggregator.admin.inc,v 1.7 2008/01/10 22:47:17 goba Exp $
  3.  
  4. /**
  5.  * @file
  6.  * Admin page callbacks for the aggregator module.
  7.  */
  8.  
  9. /**
  10.  * Menu callback; displays the aggregator administration page.
  11.  */
  12. function aggregator_admin_overview() {
  13.   return aggregator_view();
  14. }
  15.  
  16. /**
  17.  * Displays the aggregator administration page.
  18.  *
  19.  * @return
  20.  *   The page HTML.
  21.  */
  22. function aggregator_view() {
  23.   $result = db_query('SELECT f.*, COUNT(i.iid) AS items FROM {aggregator_feed} f LEFT JOIN {aggregator_item} i ON f.fid = i.fid GROUP BY f.fid, f.title, f.url, f.refresh, f.checked, f.link, f.description, f.etag, f.modified, f.image, f.block ORDER BY f.title');
  24.  
  25.   $output = '<h3>'. t('Feed overview') .'</h3>';
  26.  
  27.   $header = array(t('Title'), t('Items'), t('Last update'), t('Next update'), array('data' => t('Operations'), 'colspan' => '3'));
  28.   $rows = array();
  29.   while ($feed = db_fetch_object($result)) {
  30.     $rows[] = array(l($feed->title, "aggregator/sources/$feed->fid"), format_plural($feed->items, '1 item', '@count items'), ($feed->checked ? t('@time ago', array('@time' => format_interval(time() - $feed->checked))) : t('never')), ($feed->checked ? t('%time left', array('%time' => format_interval($feed->checked + $feed->refresh - time()))) : t('never')), l(t('edit'), "admin/content/aggregator/edit/feed/$feed->fid"), l(t('remove items'), "admin/content/aggregator/remove/$feed->fid"), l(t('update items'), "admin/content/aggregator/update/$feed->fid"));
  31.   }
  32.   $output .= theme('table', $header, $rows);
  33.  
  34.   $result = db_query('SELECT c.cid, c.title, count(ci.iid) as items FROM {aggregator_category} c LEFT JOIN {aggregator_category_item} ci ON c.cid = ci.cid GROUP BY c.cid, c.title ORDER BY title');
  35.  
  36.   $output .= '<h3>'. t('Category overview') .'</h3>';
  37.  
  38.   $header = array(t('Title'), t('Items'), t('Operations'));
  39.   $rows = array();
  40.   while ($category = db_fetch_object($result)) {
  41.     $rows[] = array(l($category->title, "aggregator/categories/$category->cid"), format_plural($category->items, '1 item', '@count items'), l(t('edit'), "admin/content/aggregator/edit/category/$category->cid"));
  42.   }
  43.   $output .= theme('table', $header, $rows);
  44.  
  45.   return $output;
  46. }
  47.  
  48. /**
  49.  * Form builder; Generate a form to add/edit feed sources.
  50.  *
  51.  * @ingroup forms
  52.  * @see aggregator_form_feed_validate()
  53.  * @see aggregator_form_feed_submit()
  54.  */
  55. function aggregator_form_feed(&$form_state, $edit = array('refresh' => 900, 'title' => '', 'url' => '', 'fid' => NULL)) {
  56.   $period = drupal_map_assoc(array(900, 1800, 3600, 7200, 10800, 21600, 32400, 43200, 64800, 86400, 172800, 259200, 604800, 1209600, 2419200), 'format_interval');
  57.  
  58.   if ($edit['refresh'] == '') {
  59.     $edit['refresh'] = 3600;
  60.   }
  61.  
  62.   $form['title'] = array('#type' => 'textfield',
  63.     '#title' => t('Title'),
  64.     '#default_value' => $edit['title'],
  65.     '#maxlength' => 255,
  66.     '#description' => t('The name of the feed (or the name of the website providing the feed).'),
  67.     '#required' => TRUE,
  68.   );
  69.   $form['url'] = array('#type' => 'textfield',
  70.     '#title' => t('URL'),
  71.     '#default_value' => $edit['url'],
  72.     '#maxlength' => 255,
  73.     '#description' => t('The fully-qualified URL of the feed.'),
  74.     '#required' => TRUE,
  75.   );
  76.   $form['refresh'] = array('#type' => 'select',
  77.     '#title' => t('Update interval'),
  78.     '#default_value' => $edit['refresh'],
  79.     '#options' => $period,
  80.     '#description' => t('The length of time between feed updates. (Requires a correctly configured <a href="@cron">cron maintenance task</a>.)', array('@cron' => url('admin/reports/status'))),
  81.   );
  82.  
  83.   // Handling of categories:
  84.   $options = array();
  85.   $values = array();
  86.   $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']);
  87.   while ($category = db_fetch_object($categories)) {
  88.     $options[$category->cid] = check_plain($category->title);
  89.     if ($category->fid) $values[] = $category->cid;
  90.   }
  91.   if ($options) {
  92.     $form['category'] = array('#type' => 'checkboxes',
  93.       '#title' => t('Categorize news items'),
  94.       '#default_value' => $values,
  95.       '#options' => $options,
  96.       '#description' => t('New feed items are automatically filed in the checked categories.'),
  97.     );
  98.   }
  99.   $form['submit'] = array('#type' => 'submit', '#value' => t('Save'));
  100.  
  101.   if ($edit['fid']) {
  102.     $form['delete'] = array('#type' => 'submit', '#value' => t('Delete'));
  103.     $form['fid'] = array('#type' => 'hidden', '#value' => $edit['fid']);
  104.   }
  105.  
  106.   return $form;
  107. }
  108.  
  109. /**
  110.  * Validate aggregator_form_feed form submissions.
  111.  */
  112. function aggregator_form_feed_validate($form, &$form_state) {
  113.   if ($form_state['values']['op'] == t('Save')) {
  114.     // Ensure URL is valid.
  115.     if (!valid_url($form_state['values']['url'], TRUE)) {
  116.       form_set_error('url', t('The URL %url is invalid. Please enter a fully-qualified URL, such as http://www.example.com/feed.xml.', array('%url' => $form_state['values']['url'])));
  117.     }
  118.     // Check for duplicate titles.
  119.     if (isset($form_state['values']['fid'])) {
  120.       $result = db_query("SELECT title, url FROM {aggregator_feed} WHERE (title = '%s' OR url='%s') AND fid != %d", $form_state['values']['title'], $form_state['values']['url'], $form_state['values']['fid']);
  121.     }
  122.     else {
  123.       $result = db_query("SELECT title, url FROM {aggregator_feed} WHERE title = '%s' OR url='%s'", $form_state['values']['title'], $form_state['values']['url']);
  124.     }
  125.     while ($feed = db_fetch_object($result)) {
  126.       if (strcasecmp($feed->title, $form_state['values']['title']) == 0) {
  127.         form_set_error('title', t('A feed named %feed already exists. Please enter a unique title.', array('%feed' => $form_state['values']['title'])));
  128.       }
  129.       if (strcasecmp($feed->url, $form_state['values']['url']) == 0) {
  130.         form_set_error('url', t('A feed with this URL %url already exists. Please enter a unique URL.', array('%url' => $form_state['values']['url'])));
  131.       }
  132.     }
  133.   }
  134. }
  135.  
  136. /**
  137.  * Process aggregator_form_feed form submissions.
  138.  *
  139.  * @todo Add delete confirmation dialog.
  140.  */
  141. function aggregator_form_feed_submit($form, &$form_state) {
  142.   if ($form_state['values']['op'] == t('Delete')) {
  143.     $title = $form_state['values']['title'];
  144.     // Unset the title:
  145.     unset($form_state['values']['title']);
  146.   }
  147.   aggregator_save_feed($form_state['values']);
  148.   if (isset($form_state['values']['fid'])) {
  149.     if (isset($form_state['values']['title'])) {
  150.       drupal_set_message(t('The feed %feed has been updated.', array('%feed' => $form_state['values']['title'])));
  151.       if (arg(0) == 'admin') {
  152.         $form_state['redirect'] = 'admin/content/aggregator/';
  153.         return;
  154.       }
  155.       else {
  156.         $form_state['redirect'] = 'aggregator/sources/'. $form_state['values']['fid'];
  157.         return;
  158.       }
  159.     }
  160.     else {
  161.       watchdog('aggregator', 'Feed %feed deleted.', array('%feed' => $title));
  162.       drupal_set_message(t('The feed %feed has been deleted.', array('%feed' => $title)));
  163.       if (arg(0) == 'admin') {
  164.         $form_state['redirect'] = 'admin/content/aggregator/';
  165.         return;
  166.       }
  167.       else {
  168.         $form_state['redirect'] = 'aggregator/sources/';
  169.         return;
  170.       }
  171.     }
  172.   }
  173.   else {
  174.     watchdog('aggregator', 'Feed %feed added.', array('%feed' => $form_state['values']['title']), WATCHDOG_NOTICE, l(t('view'), 'admin/content/aggregator'));
  175.     drupal_set_message(t('The feed %feed has been added.', array('%feed' => $form_state['values']['title'])));
  176.   }
  177. }
  178.  
  179. function aggregator_admin_remove_feed($form_state, $feed) {
  180.   return confirm_form(
  181.     array(
  182.       'feed' => array(
  183.         '#type' => 'value',
  184.         '#value' => $feed,
  185.       ),
  186.     ),
  187.     t('Are you sure you want to remove all items from the feed %feed?', array('%feed' => $feed['title'])),
  188.     'admin/content/aggregator',
  189.     t('This action cannot be undone.'),
  190.     t('Remove items'),
  191.     t('Cancel')
  192.   );
  193. }
  194.  
  195. /**
  196.  * Remove all items from a feed and redirect to the overview page.
  197.  *
  198.  * @param $feed
  199.  *   An associative array describing the feed to be cleared.
  200.  */
  201. function aggregator_admin_remove_feed_submit($form, &$form_state) {
  202.   aggregator_remove($form_state['values']['feed']);
  203.   $form_state['redirect'] = 'admin/content/aggregator';
  204. }
  205.  
  206. /**
  207.  * Menu callback; refreshes a feed, then redirects to the overview page.
  208.  *
  209.  * @param $feed
  210.  *   An associative array describing the feed to be refreshed.
  211.  */
  212. function aggregator_admin_refresh_feed($feed) {
  213.   aggregator_refresh($feed);
  214.   drupal_goto('admin/content/aggregator');
  215. }
  216.  
  217. /**
  218.  * Form builder; Configure the aggregator system.
  219.  *
  220.  * @ingroup forms
  221.  * @see system_settings_form()
  222.  */
  223. function aggregator_admin_settings() {
  224.   $items = array(0 => t('none')) + drupal_map_assoc(array(3, 5, 10, 15, 20, 25), '_aggregator_items');
  225.   $period = drupal_map_assoc(array(3600, 10800, 21600, 32400, 43200, 86400, 172800, 259200, 604800, 1209600, 2419200, 4838400, 9676800), 'format_interval');
  226.  
  227.   $form['aggregator_allowed_html_tags'] = array(
  228.     '#type' => 'textfield', '#title' => t('Allowed HTML tags'), '#size' => 80, '#maxlength' => 255,
  229.     '#default_value' => variable_get('aggregator_allowed_html_tags', '<a> <b> <br> <dd> <dl> <dt> <em> <i> <li> <ol> <p> <strong> <u> <ul>'),
  230.     '#description' => t('A space-separated list of HTML tags allowed in the content of feed items. (Tags in this list are not removed by Drupal.)')
  231.   );
  232.  
  233.   $form['aggregator_summary_items'] = array(
  234.     '#type' => 'select', '#title' => t('Items shown in sources and categories pages') ,
  235.     '#default_value' => variable_get('aggregator_summary_items', 3), '#options' => $items,
  236.     '#description' => t('Number of feed items displayed in feed and category summary pages.')
  237.   );
  238.  
  239.   $form['aggregator_clear'] = array(
  240.     '#type' => 'select', '#title' => t('Discard items older than'),
  241.     '#default_value' => variable_get('aggregator_clear', 9676800), '#options' => $period,
  242.     '#description' => t('The length of time to retain feed items before discarding. (Requires a correctly configured <a href="@cron">cron maintenance task</a>.)', array('@cron' => url('admin/reports/status')))
  243.   );
  244.  
  245.   $form['aggregator_category_selector'] = array(
  246.     '#type' => 'radios', '#title' => t('Category selection type'), '#default_value' => variable_get('aggregator_category_selector', 'checkboxes'),
  247.     '#options' => array('checkboxes' => t('checkboxes'), 'select' => t('multiple selector')),
  248.     '#description' => t('The type of category selection widget displayed on categorization pages. (For a small number of categories, checkboxes are easier to use, while a multiple selector work well with large numbers of categories.)')
  249.   );
  250.  
  251.   return system_settings_form($form);
  252. }
  253.  
  254. /**
  255.  * Form builder; Generate a form to add/edit/delete aggregator categories.
  256.  *
  257.  * @ingroup forms
  258.  * @see aggregator_form_category_validate()
  259.  * @see aggregator_form_category_submit()
  260.  */
  261. function aggregator_form_category(&$form_state, $edit = array('title' => '', 'description' => '', 'cid' => NULL)) {
  262.   $form['title'] = array('#type' => 'textfield',
  263.     '#title' => t('Title'),
  264.     '#default_value' => $edit['title'],
  265.     '#maxlength' => 64,
  266.     '#required' => TRUE,
  267.   );
  268.   $form['description'] = array('#type' => 'textarea',
  269.     '#title' => t('Description'),
  270.     '#default_value' => $edit['description'],
  271.   );
  272.   $form['submit'] = array('#type' => 'submit', '#value' => t('Save'));
  273.  
  274.   if ($edit['cid']) {
  275.     $form['delete'] = array('#type' => 'submit', '#value' => t('Delete'));
  276.     $form['cid'] = array('#type' => 'hidden', '#value' => $edit['cid']);
  277.   }
  278.  
  279.   return $form;
  280. }
  281.  
  282. /**
  283.  * Validate aggregator_form_feed form submissions.
  284.  */
  285. function aggregator_form_category_validate($form, &$form_state) {
  286.   if ($form_state['values']['op'] == t('Save')) {
  287.     // Check for duplicate titles
  288.     if (isset($form_state['values']['cid'])) {
  289.       $category = db_fetch_object(db_query("SELECT cid FROM {aggregator_category} WHERE title = '%s' AND cid != %d", $form_state['values']['title'], $form_state['values']['cid']));
  290.     }
  291.     else {
  292.       $category = db_fetch_object(db_query("SELECT cid FROM {aggregator_category} WHERE title = '%s'", $form_state['values']['title']));
  293.     }
  294.     if ($category) {
  295.       form_set_error('title', t('A category named %category already exists. Please enter a unique title.', array('%category' => $form_state['values']['title'])));
  296.     }
  297.   }
  298. }
  299.  
  300. /**
  301.  * Process aggregator_form_category form submissions.
  302.  *
  303.  * @todo Add delete confirmation dialog.
  304.  */
  305. function aggregator_form_category_submit($form, &$form_state) {
  306.   if ($form_state['values']['op'] == t('Delete')) {
  307.     $title = $form_state['values']['title'];
  308.     // Unset the title:
  309.     unset($form_state['values']['title']);
  310.   }
  311.   aggregator_save_category($form_state['values']);
  312.   if (isset($form_state['values']['cid'])) {
  313.     if (isset($form_state['values']['title'])) {
  314.       drupal_set_message(t('The category %category has been updated.', array('%category' => $form_state['values']['title'])));
  315.       if (arg(0) == 'admin') {
  316.         $form_state['redirect'] = 'admin/content/aggregator/';
  317.         return;
  318.       }
  319.       else {
  320.         $form_state['redirect'] = 'aggregator/categories/'. $form_state['values']['cid'];
  321.         return;
  322.       }
  323.     }
  324.     else {
  325.       watchdog('aggregator', 'Category %category deleted.', array('%category' => $title));
  326.       drupal_set_message(t('The category %category has been deleted.', array('%category' => $title)));
  327.       if (arg(0) == 'admin') {
  328.         $form_state['redirect'] = 'admin/content/aggregator/';
  329.         return;
  330.       }
  331.       else {
  332.         $form_state['redirect'] = 'aggregator/categories/';
  333.         return;
  334.       }
  335.     }
  336.   }
  337.   else {
  338.     watchdog('aggregator', 'Category %category added.', array('%category' => $form_state['values']['title']), WATCHDOG_NOTICE, l(t('view'), 'admin/content/aggregator'));
  339.     drupal_set_message(t('The category %category has been added.', array('%category' => $form_state['values']['title'])));
  340.   }
  341. }
  342.