-
-
-
- view your archive by day. -
- enable the browse archives block at administer >> block. -
'; - $output .= '- '), -1, PREG_SPLIT_NO_EMPTY));
-}
-
-/**
- * Helper function for drupal_map_assoc.
- */
-function _aggregator_items($count) {
- return format_plural($count, '1 item', '%count items');
-}
diff --git a/modules/archive/archive.module b/modules/archive/archive.module
deleted file mode 100644
index 46f49953db6191ed9f879569ec433961d88e1c5c..0000000000000000000000000000000000000000
--- a/modules/archive/archive.module
+++ /dev/null
@@ -1,291 +0,0 @@
-'. t('The archive page allows content to be viewed by date. It also provides a monthly calendar view that users can use to navigate through content.') .'
'. t('To view the archive by date, select the date in the calendar. Administrators can enable the browse archives block in block administration to allow users to browse by calendar. Clicking on a date in the monthly calendar view shows the content for that date. Users can navigate to different months using arrows beside the month\'s name in the calendar display. The current date will be highlighted in the calendar.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Archive page.', array('%archive' => 'http://drupal.org/handbook/modules/archive/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Displays a calendar for navigating older content.'); - } -} - -/** - * Implementation of hook_menu(). - */ -function archive_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'archive', - 'title' => t('archives'), - 'access' => user_access('access content'), - 'callback' => 'archive_page', - 'type' => MENU_SUGGESTED_ITEM); - } - return $items; -} - -/** - * Implementation of hook_block(). - * - * Generates a calendar for the current month, with links to the archives - * for each day. - */ -function archive_block($op = 'list', $delta = 0) { - if ($op == 'list') { - $blocks[0]['info'] = t('Calendar to browse archives'); - return $blocks; - } - else if ($op == 'view' && user_access('access content')) { - $block['subject'] = t('Browse archives'); - $block['content'] = archive_calendar(); - return $block; - } -} - -/** - * Generates a monthly calendar, for display in the archive block. - */ -function archive_calendar() { - global $user; - - // Extract today's date: - $start_of_today = mktime(0, 0, 0, date('n', time()), date('d', time()), date('Y', time())) + $user->timezone; - $end_of_today = mktime(23, 59, 59, date('n', time()), date('d', time()), date('Y', time())) + $user->timezone; - - // Extract the requested date: - if (arg(0) == 'archive' && arg(3)) { - $year = arg(1); - $month = arg(2); - $day = arg(3); - - $requested = mktime(0, 0, 0, $month, $day, $year) + $user->timezone; - } - else { - $year = date('Y', time()); - $month = date('n', time()); - $day = date('d', time()); - - $requested = $end_of_today + $user->timezone; - } - - $start_of_month = mktime(0, 0, 0, $month, 1, $year); - - // Extract first day of the month: - $first = date('w', $start_of_month); - - // Extract last day of the month: - $last = date('t', $start_of_month); - - $end_of_month = mktime(23, 59, 59, $month, $last, $year); - - $cache = cache_get("archive:calendar:$day-$month-$year"); - - if (!empty($cache)) { - return $cache->data; - } - - // Calculate previous and next months dates and check for shorter months (28/30 days) - $prevmonth = mktime(23, 59, 59, $month - 1, 1, $year); - $prev = mktime(23, 59, 59, $month - 1, min(date('t', $prevmonth), $day), $year); - $nextmonth = mktime(23, 59, 59, $month + 1, 1, $year); - $next = mktime(23, 59, 59, $month + 1, min(date('t', $nextmonth), $day), $year); - - $sql = 'SELECT n.nid, n.created FROM {node} n WHERE n.status = 1 AND n.created > %d AND n.created < %d ORDER BY n.created'; - $sql = db_rewrite_sql($sql); - $result = db_query($sql, $start_of_month, $end_of_month); - - $days_with_posts = array(); - while ($day_with_post = db_fetch_object($result)) { - $daynum = date('j', $day_with_post->created + $user->timezone); - if (isset($days_with_posts[$daynum])) { - $days_with_posts[$daynum]++; - } - else { - $days_with_posts[$daynum] = 1; - } - } - - // Generate calendar header: - $output .= "\n\n"; - $output .= ''; - $output .= '\n\n"; - - cache_set("archive:calendar:$day-$month-$year", $output, CACHE_TEMPORARY); - - return $output; -} - -/** - * Menu callback; lists all nodes posted on a given date. - */ -function archive_page($year = 0, $month = 0, $day = 0) { - global $user; - - $date = mktime(0, 0, 0, $month, $day, $year) - $user->timezone; - $date_end = mktime(0, 0, 0, $month, $day + 1, $year) - $user->timezone; - - // Display form. - $output = archive_browse_form($year, $month, $day); - - if ($year && $month && $day) { - // Fetch nodes for the selected date, if one was specified. - $sql = 'SELECT n.nid, n.created FROM {node} n WHERE n.status = 1 AND n.created > %d AND n.created < %d ORDER BY n.created'; - $sql = db_rewrite_sql($sql); - $result = db_query_range($sql, $date, $date_end, 0, 20); - if (db_num_rows($result) > 0) { - while ($nid = db_fetch_object($result)) { - $output .= node_view(node_load($nid->nid), 1); - } - } - else { - $output .= theme('box', t('No posts found.'), ''); - } - } - else { - $output .= theme('box', t('No posts found.'), ''); - } - - return $output; -} - -/** - * Generate a form that retrieves archives for a certain date. - */ -function archive_browse_form($year, $month, $day) { - // Prepare the values of the form fields. - $years = drupal_map_assoc(range(2000, 2010)); - $months = array(1 => t('January'), 2 => t('February'), 3 => t('March'), 4 => t('April'), 5 => t('May'), 6 => t('June'), 7 => t('July'), 8 => t('August'), 9 => t('September'), 10 => t('October'), 11 => t('November'), 12 => t('December')); - $days = drupal_map_assoc(range(1, 31)); - - $form['year'] = array('#type' => 'select', - '#default_value' => ($year ? $year : date('Y')), - '#options' => $years, - ); - $form['month'] = array('#type' => 'select', - '#default_value' => ($month ? $month : date('m')), - '#options' => $months, - ); - $form['day'] = array('#type' => 'select', - '#default_value' => ($day ? $day : date('d')), - '#options' => $days, - ); - $form['show'] = array('#type' => 'submit', - '#value' => t('Show'), - ); - - return drupal_get_form('archive_browse_form', $form); -} - -/** - * Process archive browse form submission. - */ -function archive_browse_form_submit($form_id, $form_values) { - return('archive/'. $form_values['year'] .'/'. $form_values['month'] .'/'. $form_values['day']); -} - -/** - * Form theme function; displays the archive date navigation form inline. - */ -function theme_archive_browse_form($form) { - $output = '\n"; - $output .= '
'. l('«', 'archive/'. date('Y/m/d', $prev), array('title' => t('Previous month'))) .' '. format_date($requested, 'custom', 'F') . date(' Y', $requested) .' '. ($nextmonth <= time() ? l('»', 'archive/'. date('Y/m/d', $next), array('title' => t('Next month'))) : ' ') ." \n"; - - // First day of week (0 => Sunday, 1 => Monday, ...) - $weekstart = variable_get('date_first_day', 0); - - // Last day of week - ($weekstart - 1 == -1) ? $lastday = 6 : $lastday = $weekstart - 1; - - // Generate the days of the week: - $firstcolumn = mktime(0, 0, 0, 3, 20 + $weekstart, 1994); - - $output .= "\n"; - $days = array(t('Sunday') => t('Su'), t('Monday') => t('Mo'), t('Tuesday') => t('Tu'), t('Wednesday') => t('We'), t('Thursday') => t('Th'), t('Friday') => t('Fr'), t('Saturday') => t('Sa')); - if ($weekstart) { - $days = array_merge(array_slice($days, $weekstart), array_slice($days, 0, $weekstart)); - } - - foreach ($days as $fullname => $name) { - $output .= ' \n"; - - // Initialize temporary variables: - $nday = 1; - $sday = $first; - - // Loop through all the days of the month: - while ($nday <= $last) { - // Set up blank days for first week of the month (allowing individual blank day styling): - if ($first != $weekstart) { - $blankdays = ($first - $weekstart + 7) % 7; - $output .= "'. $name . " \n"; - } - $output .= "" . str_repeat(" \n"; - } - - // Print one cell: - $date = mktime(0, 0, 0, $month, $nday, $year) + $user->timezone; - if (isset($days_with_posts[$nday])) { - $daytext = l($nday, "archive/$year/$month/$nday", array("title" => format_plural($days_with_posts[$nday], "1 post", "%count posts"))); - $dayclass = 'day-link'; - } - else { - $daytext = $nday; - $dayclass = 'day-normal'; - } - if ($date == $requested) { - $output .= " \n"; - } - - // Update temporary variables: - $sday++; - $sday = $sday % 7; - $nday++; - } - - // Complete the calendar (allowing individual blank day styling): - if ($sday != $weekstart) { - $end = (7 - $sday + $weekstart) % 7; - $output .= str_repeat("$daytext \n"; - } - else if ($date == $start_of_today) { - $output .= "$daytext \n"; - } - else if ($date > $end_of_today) { - $output .= "$daytext \n"; - } - else { - $output .= "$daytext \n"; - } - - // Start every week on a new line: - if ($sday == $lastday) { - $output .= "
-
- Its enabled checkbox. Disabled blocks are never shown. -
- Its throttle checkbox. Throttled blocks are hidden during high server loads. -
- Its path options. Blocks can be configured to only show/hide on certain pages. -
- User settings. Administrators can choose to let your users decide whether to show/hide certain blocks. -
- Its function. Dynamic blocks (such as those defined by modules) may be empty on certain pages and will not be shown. -
- enable throttle and configure blocks at administer >> blocks. -
- add a block at administer >> blocks >> add block. -
- read your blog via your user profile at my account. -
- post a blog at create content >> personal blog entry. -
- administer blog at administer >> content >> configure >> content types >> personal blog entry. -
- administer blog api at administer >> settings >> blogapi. -
- enable the "recent blog posts" block at administer >> blocks to show the 10 most recent blog posts. -
- '. l(t('Post new blog entry.'), "node/add/blog") .' '; - } - else if ($account->uid == $user->uid) { - $output = '
- '. t('You are not allowed to post a new blog entry.') .' '; - } - - if ($output) { - $output = '
- view the XML-RPC page on your site at >> xmlrpc.php. -
- administer >> settings >> blog api. -
- '. l($node->title, 'node/'. $node->nid) .' '; - } - } - else { - if ($tree = book_tree_recurse($node->nid, 1, $children)) { - $output .= '
- '. l($node->title, 'node/'. $node->nid) .' '; - } - else { - $output .= '
- '. l($node->title, 'node/'. $node->nid) .' '; - } - } - } - } - } - - return $output; -} - -/** - * Returns an HTML nested list (wrapped in a menu-class div) representing the book nodes - * as a tree. - */ -function book_tree($parent = 0, $depth = 3, $unfold = array()) { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND n.moderate = 0 ORDER BY b.weight, n.title')); - - while ($node = db_fetch_object($result)) { - $list = $children[$node->parent] ? $children[$node->parent] : array(); - $list[] = $node; - $children[$node->parent] = $list; - } - - if ($tree = book_tree_recurse($parent, $depth, $children, $unfold)) { - return ''; - } -} - -/** - * Menu callback; prints a listing of all books. - */ -function book_render() { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = 0 AND n.status = 1 AND n.moderate = 0 ORDER BY b.weight, n.title')); - - $books = array(); - while ($node = db_fetch_object($result)) { - $books[] = l($node->title, 'node/'. $node->nid); - } - - return theme('item_list', $books); -} - -/** - * Menu callback; Generates various representation of a book page with - * all descendants and prints the requested representation to output. - * - * The function delegates the generation of output to helper functions. - * The function name is derived by prepending 'book_export_' to the - * given output type. So, e.g., a type of 'html' results in a call to - * the function book_export_html(). - * - * @param type - * - a string encoding the type of output requested. - * The following types are currently supported in book module - * html: HTML (printer friendly output) - * Other types are supported in contributed modules. - * @param nid - * - an integer representing the node id (nid) of the node to export - * - */ -function book_export($type = 'html', $nid = 0) { - $type = drupal_strtolower($type); - $node_result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), $nid); - if (db_num_rows($node_result) > 0) { - $node = db_fetch_object($node_result); - } - $depth = count(book_location($node)) + 1; - $export_function = 'book_export_' . $type; - - if (function_exists($export_function)) { - print call_user_func($export_function, $nid, $depth); - } - else { - drupal_set_message('Unknown export format'); - drupal_not_found(); - } -} - -/** - * This function is called by book_export() to generate HTML for export. - * - * The given node is /embedded to its absolute depth in a top level - * section/. For example, a child node with depth 2 in the hierarchy - * is contained in (otherwise empty) <div> elements - * corresponding to depth 0 and depth 1. This is intended to support - * WYSIWYG output - e.g., level 3 sections always look like level 3 - * sections, no matter their depth relative to the node selected to be - * exported as printer-friendly HTML. - * - * @param nid - * - an integer representing the node id (nid) of the node to export - * @param depth - * - an integer giving the depth in the book hierarchy of the node - which is to be exported - * @return - * - string containing HTML representing the node and its children in - the book hierarchy -*/ -function book_export_html($nid, $depth) { - if (user_access('see printer-friendly version')) { - global $base_url; - for ($i = 1; $i < $depth; $i++) { - $output .= "
- create new book pages: create content >> book page. -
- administer individual books (choose a book from list): administer >> content >> books. -
- set workflow and other global book settings on the book configuration page: administer >> settings >> content types >> configure book page. -
- enable the book navigation block: administer >> blocks. -
- control who can create, edit, and outline posts in books by setting access permissions: administer >> access control. -
- control access for various comment module functions through access permissions administer >> access control. -
- administer comments administer >> comments >> configure. -
- ', '#suffix' => check_plain($subject) .' '); - } - $form['operation'] = array('#type' => 'hidden', '#value' => 'delete'); - - return confirm_form('comment_multiple_delete_confirm', $form, - t('Are you sure you want to delete these comments and all their children?'), - 'admin/comment', t('This action cannot be undone.'), - t('Delete comments'), t('Cancel')); -} - -/** - * Perform the actual comment deletion. - */ -function comment_multiple_delete_confirm_submit($form_id, $edit) { - if ($edit['confirm']) { - foreach ($edit['comments'] as $cid => $value) { - $comment = _comment_load($cid); - _comment_delete_thread($comment); - _comment_update_node_statistics($comment->nid); - cache_clear_all(); - } - drupal_set_message(t('The comments have been deleted.')); - } - drupal_goto('admin/comment'); -} - -/** -*** misc functions: helpers, privates, history -**/ - -/** - * Load the entire comment by cid. - */ -function _comment_load($cid) { - return db_fetch_object(db_query('SELECT * FROM {comments} WHERE cid = %d', $cid)); -} - -function comment_num_all($nid) { - static $cache; - - if (!isset($cache[$nid])) { - $cache[$nid] = db_result(db_query('SELECT comment_count FROM {node_comment_statistics} WHERE nid = %d', $nid)); - } - return $cache[$nid]; -} - -function comment_num_replies($pid) { - static $cache; - - if (!isset($cache[$pid])) { - $cache[$pid] = db_result(db_query('SELECT COUNT(cid) FROM {comments} WHERE pid = %d AND status = %d', $pid, COMMENT_PUBLISHED)); - } - - return $cache[$pid]; -} - -/** - * get number of new comments for current user and specified node - * - * @param $nid node-id to count comments for - * @param $timestamp time to count from (defaults to time of last user access - * to node) - */ -function comment_num_new($nid, $timestamp = 0) { - global $user; - - if ($user->uid) { - // Retrieve the timestamp at which the current user last viewed the - // specified node. - if (!$timestamp) { - $timestamp = node_last_viewed($nid); - } - $timestamp = ($timestamp > NODE_NEW_LIMIT ? $timestamp : NODE_NEW_LIMIT); - - // Use the timestamp to retrieve the number of new comments. - $result = db_result(db_query('SELECT COUNT(c.cid) FROM {node} n INNER JOIN {comments} c ON n.nid = c.nid WHERE n.nid = %d AND timestamp > %d AND c.status = %d', $nid, $timestamp, COMMENT_PUBLISHED)); - - return $result; - } - else { - return 0; - } - -} - -function comment_validate($edit) { - global $user; - - // Invoke other validation handlers - comment_invoke_comment($edit, 'validate'); - - if (isset($edit['date'])) { - // As of PHP 5.1.0, strtotime returns FALSE upon failure instead of -1. - if (strtotime($edit['date']) <= 0) { - form_set_error('date', t('You have to specify a valid date.')); - } - } - if (isset($edit['author']) && !$account = user_load(array('name' => $edit['author']))) { - form_set_error('author', t('You have to specify a valid author.')); - } - - // Validate the comment's body. - if (trim($edit['comment']) == '') { - form_set_error('comment', t('The body of your comment is empty.')); - } - - // Check validity of name, mail and homepage (if given) - if (!$user->uid || isset($edit['is_anonymous'])) { - if (variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT) > COMMENT_ANONYMOUS_MAYNOT_CONTACT) { - if ($edit['name']) { - $taken = db_result(db_query("SELECT COUNT(uid) FROM {users} WHERE LOWER(name) = '%s'", $edit['name']), 0); - - if ($taken != 0) { - form_set_error('name', t('The name you used belongs to a registered user.')); - } - - } - else if (variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT) == COMMENT_ANONYMOUS_MUST_CONTACT) { - form_set_error('name', t('You have to leave your name.')); - } - - if ($edit['mail']) { - if (!valid_email_address($edit['mail'])) { - form_set_error('mail', t('The e-mail address you specified is not valid.')); - } - } - else if (variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT) == COMMENT_ANONYMOUS_MUST_CONTACT) { - form_set_error('mail', t('You have to leave an e-mail address.')); - } - - if ($edit['homepage']) { - if (!valid_url($edit['homepage'], TRUE)) { - form_set_error('homepage', t('The URL of your homepage is not valid. Remember that it must be fully qualified, i.e. of the form
- '. t('Default site-wide contact page.', array('%contact-page' => url('contact'))) .' '; - $output .= '
- '. t('Site-wide contact form category configuration.', array('%configuration-page' => url('admin/contact'))) .' '; - $output .= '
- '. t('Site-wide contact form general settings.', array('%additional-settings' => url('admin/contact/settings'))) .' '; - $output .= '
- '. t('Site-wide contact form menu configuration.', array('%menu-configuration' => url('admin/menu'))) .'
- register your site with a server, including (optionally) posting information on your installed modules and themes and summary statistics on your number of posts and users, information that can help rank Drupal modules and themes -
- enable other sites to register with your site -
- allow members on all sites using the Drupal module to log in to your site without registering using their distributed identification -
- allow members to log in to any other site that uses the Drupal module, using a login name that looks much like an e-mail address: username@example.com -
- run your cron job at your site\'s cron page -
- view your XML-RPC page. -
- administer Drupal administer >> settings >> drupal. -
- Enable the page module. Select create content >> page. -
- For input format, select PHP code. -
- Give the page a title. For body, put:
-
-<?php -print drupal_client_page(); -?> -
- - Save the page. -
- ' . check_plain($client->name) . ' - ' . check_plain($client->slogan) . " \n"; - $output .= '
- ' . strip_tags($client->mission) . " \n"; - } - $output .= "
- administer input format permissions and settings at administer >> input formats. -
- configure the filters for each input format at administer >> input formats >> configure. -
-
- ')) {
- switch ($long) {
- case 0:
- return t('Allowed HTML tags') .': '. check_plain($allowed_html);
- case 1:
- $output = '
'. t('Allowed HTML tags') .': '. check_plain($allowed_html) .'
'; - if (!variable_get("filter_html_help_$format", 1)) { - return $output; - } - - $output .= t(' -This site allows HTML content. While learning all of HTML may feel intimidating, learning how to use a very small number of the most basic HTML "tags" is very easy. This table provides examples for each tag that is enabled on this site.
-For more information see W3C\'s HTML Specifications or use your favorite search engine to find other sites that explain HTML.
'); - $tips = array( - 'a' => array( t('Anchors are used to make links to other pages.'), ''. variable_get('site_name', 'drupal') .''), - 'br' => array( t('By default line break tags are automatically added, so use this tag to add additional ones. Use of this tag is different because it is not used with an open/close pair like all the others. Use the extra " /" inside the tag to maintain XHTML 1.0 compatibility'), t('Text with
line break')), - 'p' => array( t('By default paragraph tags are automatically added, so use this tag to add additional ones.'), ''. t('Paragraph one.') .'
'. t('Paragraph two.') .'
'), - 'strong' => array( t('Strong'), ''. t('Strong'). ''), - 'em' => array( t('Emphasized'), ''. t('Emphasized') .''), - 'cite' => array( t('Cited'), ''. t('Cited') .''), - 'code' => array( t('Coded text used to show programming source code'), ''. t('Coded') .''), - 'b' => array( t('Bolded'), ''. t('Bolded') .''), - 'u' => array( t('Underlined'), ''. t('Underlined') .''), - 'i' => array( t('Italicized'), ''. t('Italicized') .''), - 'sup' => array( t('Superscripted'), t('Superscripted')), - 'sub' => array( t('Subscripted'), t('Subscripted')), - 'pre' => array( t('Preformatted'), ''. t('Preformatted') .''), - 'blockquote' => array( t('Block quoted'), ''. t('Block quoted') .'
'), - 'q' => array( t('Quoted inline'), ''. t('Quoted inline') .'
'), - // Assumes and describes tr, td, th. - 'table' => array( t('Table'), '
'), - 'tr' => NULL, 'td' => NULL, 'th' => NULL, - 'del' => array( t('Deleted'), ''. t('Table header') .' '. t('Table cell') .' '. t('Deleted') .''), - 'ins' => array( t('Inserted'), ''. t('Inserted') .''), - // Assumes and describes li. - 'ol' => array( t('Ordered list - use the <li> to begin each list item'), '- '. t('First item') .'
- '. t('Second item') .'
- '. t('First item') .'
- '. t('Second item') .'
- '. t('First term') .'
- '. t('First definition') .'
- '. t('Second term') .'
- '. t('Second definition') .'
'. t('Title') .'
'), - 'h2' => array( t('Header'), ''. t('Subtitle') .'
'), - 'h3' => array( t('Header'), ''. t('Subtitle three') .'
'), - 'h4' => array( t('Header'), ''. t('Subtitle four') .'
'), - 'h5' => array( t('Header'), ''. t('Subtitle five') .'
'), - 'h6' => array( t('Header'), ''. t('Subtitle six') .'
') - ); - $header = array(t('Tag Description'), t('You Type'), t('You Get')); - preg_match_all('/<([a-z0-9]+)[^a-z0-9]/i', $allowed_html, $out); - foreach ($out[1] as $tag) { - if (array_key_exists($tag, $tips)) { - if ($tips[$tag]) { - $rows[] = array( - array('data' => $tips[$tag][0], 'class' => 'description'), - array('data' => ''. check_plain($tips[$tag][1]) .'', 'class' => 'type'), - array('data' => $tips[$tag][1], 'class' => 'get') - ); - } - } - else { - $rows[] = array( - array('data' => t('No help provided for tag %tag.', array('%tag' => check_plain($tag))), 'class' => 'description', 'colspan' => 3), - ); - } - } - $output .= theme('table', $header, $rows); - - $output .= t(' -Most unusual characters can be directly entered without any problems.
-If you do encounter problems, try using HTML character entities. A common example looks like & for an ampersand & character. For a full list of entities see HTML\'s entities page. Some of the available characters include:
'); - $entities = array( - array( t('Ampersand'), '&'), - array( t('Greater than'), '>'), - array( t('Less than'), '<'), - array( t('Quotation mark'), '"'), - ); - $header = array(t('Character Description'), t('You Type'), t('You Get')); - unset($rows); - foreach ($entities as $entity) { - $rows[] = array( - array('data' => $entity[0], 'class' => 'description'), - array('data' => ''. check_plain($entity[1]) .'', 'class' => 'type'), - array('data' => $entity[1], 'class' => 'get') - ); - } - $output .= theme('table', $header, $rows); - return $output; - } - } - else { - return t('No HTML tags allowed'); - } - } - break; - - case 1: - switch ($long) { - case 0: - return t('You may post PHP code. You should include <?php ?> tags.'); - case 1: - return t(' -Using custom PHP code
-If you know how to script in PHP, Drupal gives you the power to embed any script you like. It will be executed when the page is viewed and dynamically embedded into the page. This gives you amazing flexibility and power, but of course with that comes danger and insecurity if you don\'t write good code. If you are not familiar with PHP, SQL or with the site engine, avoid experimenting with PHP because you can corrupt your database or render your site insecure or even unusable! If you don\'t plan to do fancy stuff with your content then you\'re probably better off with straight HTML.
-Remember that the code within each PHP item must be valid PHP code - including things like correctly terminating statements with a semicolon. It is highly recommended that you develop your code separately using a simple test script on top of a test database before migrating to your production environment.
-Notes:
- You can use global variables, such as configuration parameters, within the scope of your PHP code but remember that global variables which have been given values in your code will retain these values in the engine afterwards.
- register_globals is now set to off by default. If you need form information you need to get it from the "superglobals" $_POST, $_GET, etc.
- You can either use the
printorreturnstatement to output the actual content for your item.
A basic example:
-
-You want to have a box with the title "Welcome" that you use to greet your visitors. The content for this box could be created by going:
-- print t("Welcome visitor, ... welcome message goes here ..."); --If we are however dealing with a registered user, we can customize the message by using:
-- global $user; - if ($user->uid) { - print t("Welcome $user->name, ... welcome message goes here ..."); - } - else { - print t("Welcome visitor, ... welcome message goes here ..."); - } -For more in-depth examples, we recommend that you check the existing Drupal code and use it as a starting point, especially for sidebar boxes.
'); - } - - case 2: - switch ($long) { - case 0: - return t('Lines and paragraphs break automatically.'); - case 1: - return t('Lines and paragraphs are automatically recognized. The <br /> line break, <p> paragraph and </p> close paragraph tags are inserted automatically. If paragraphs are not recognized simply add a couple blank lines.'); - } - } -} - -/** - * Displays a list of all input formats and which one is the default - */ -function filter_admin_overview() { - - // Overview of all formats. - $formats = filter_formats(); - $error = false; - - $rows = array(); - foreach ($formats as $id => $format) { - $roles = array(); - foreach (user_roles() as $rid => $name) { - // Prepare a roles array with roles that may access the filter - if (strstr($format->roles, ",$rid,")) { - $roles[] = $name; - } - } - $row = array(); - $default = ($id == variable_get('filter_default_format', 1)); - $options[$id] = ''; - $form[$format->name]['id'] = array('#value' => $id); - $form[$format->name]['roles'] = array('#value' => $default ? t('All roles may use default format') : ($roles ? implode(', ',$roles) : t('No roles may use this format'))); - $form[$format->name]['configure'] = array('#value' => l(t('configure'), 'admin/filters/'. $id)); - $form[$format->name]['delete'] = array('#value' => $default ? '' : l(t('delete'), 'admin/filters/delete/'. $id)); - } - $form['default'] = array('#type' => 'radios', '#options' => $options, '#default_value' => variable_get('filter_default_format', 1)); - $form['submit'] = array('#type' => 'submit', '#value' => t('Set default format')); - return drupal_get_form('filter_admin_overview', $form); -} - -function filter_admin_overview_submit($form_id, $form_values) { - // Process form submission to set the default format - if (is_numeric($form_values['default'])) { - drupal_set_message(t('Default format updated.')); - variable_set('filter_default_format', $form_values['default']); - } -} - -function theme_filter_admin_overview($form) { - foreach ($form as $name => $element) { - if (isset($element['roles']) && is_array($element['roles'])) { - $rows[] = array( - form_render($form['default'][$element['id']['#value']]), - check_plain($name), - form_render($element['roles']), - form_render($element['configure']), - form_render($element['delete']) - ); - unset($form[$name]); - } - } - $header = array(t('Default'), t('Name'), t('Roles'), array('data' => t('Operations'), 'colspan' => 2)); - $output = theme('table', $header, $rows); - $output .= form_render($form); - - return $output; -} - -/** - * Menu callback; confirm deletion of a format. - */ -function filter_admin_delete() { - $format = arg(3); - $format = db_fetch_object(db_query('SELECT * FROM {filter_formats} WHERE format = %d', $format)); - - if ($format) { - if ($format->format != variable_get('filter_default_format', 1)) { - $form['format'] = array('#type' => 'hidden', '#value' => $format->format); - $form['name'] = array('#type' => 'hidden', '#value' => $format->name); - - return confirm_form('filter_admin_delete', $form, t('Are you sure you want to delete the input format %format?', array('%format' => theme('placeholder', $format->name))), 'admin/filters', t('If you have any content left in this input format, it will be switched to the default input format. This action cannot be undone.'), t('Delete'), t('Cancel')); - } - else { - drupal_set_message('The default format cannot be deleted.'); - drupal_goto('admin/filters'); - } - } - else { - drupal_not_found(); - } -} - -/** - * Process filter delete form submission. - */ -function filter_admin_delete_submit($form_id, $form_values) { - db_query("DELETE FROM {filter_formats} WHERE format = %d", $form_values['format']); - db_query("DELETE FROM {filters} WHERE format = %d", $form_values['format']); - - $default = variable_get('filter_default_format', 1); - // Replace existing instances of the deleted format with the default format. - db_query("UPDATE {node_revisions} SET format = %d WHERE format = %d", $default, $form_values['format']); - db_query("UPDATE {comments} SET format = %d WHERE format = %d", $default, $form_values['format']); - db_query("UPDATE {boxes} SET format = %d WHERE format = %d", $default, $form_values['format']); - - cache_clear_all('filter:'. $form_values['format'], true); - drupal_set_message(t('Deleted input format %format.', array('%format' => theme('placeholder', $form_values['name'])))); - - return 'admin/filters'; -} - -/** - * Generate a filter format form. - */ -function filter_admin_format_form($format = NULL) { - $default = ($format->format == variable_get('filter_default_format', 1)); - if ($default) { - $help = t('All roles for the default format must be enabled and cannot be changed.'); - $form['default_format'] = array('#type' => 'hidden', '#value' => 1); - } - - $form['name'] = array('#type' => 'textfield', - '#title' => 'Name', - '#default_value' => $format->name, - '#description' => t('Specify a unique name for this filter format.'), - '#required' => TRUE, - ); - - // Add a row of checkboxes for form group. - $form['roles'] = array('#type' => 'fieldset', - '#title' => t('Roles'), - '#description' => $default ? $help : t('Choose which roles may use this filter format. Note that roles with the "administer filters" permission can always use all the filter formats.'), - '#tree' => TRUE, - ); - - foreach (user_roles() as $rid => $name) { - $checked = strstr($format->roles, ",$rid,"); - $form['roles'][$rid] = array('#type' => 'checkbox', - '#title' => $name, - '#default_value' => ($default || $checked), - ); - if ($default) { - $form['roles'][$rid]['#attributes'] = array('disabled' => 'disabled'); - } - } - // Table with filters - $all = filter_list_all(); - $enabled = filter_list_format($format->format); - - $form['filters'] = array('#type' => 'fieldset', - '#title' => t('Filters'), - '#description' => t('Choose the filters that will be used in this filter format.'), - '#tree' => TRUE, - ); - foreach ($all as $id => $filter) { - $form['filters'][$id] = array('#type' => 'checkbox', - '#title' => $filter->name, - '#default_value' => isset($enabled[$id]), - '#description' => module_invoke($filter->module, 'filter', 'description', $filter->delta), - ); - } - $form['submit'] = array('#type' => 'submit', '#value' => t('Save configuration')); - - if (isset($format)) { - $form['format'] = array('#type' => 'hidden', '#value' => $format->format); - - // Composition tips (guidelines) - $tips = _filter_tips($format->format, false); - $extra = l(t('More information about formatting options'), 'filter/tips'); - $tiplist = theme('filter_tips', $tips, false, $extra); - if (!$tiplist) { - $tiplist = t('No guidelines available.
'); - } - $group = t('These are the guidelines that users will see for posting in this input format. They are automatically generated from the filter settings.
'); - $group .= $tiplist; - $output = ''. t('Formatting guidelines') .'
'. $group; - } - $output = drupal_get_form('filter_admin_format_form', $form) . $output; - - return $output; -} - -/** - * Validate filter format form submissions. - */ -function filter_admin_format_form_validate($form_id, $form_values) { - if (!isset($form_values['format'])) { - $name = trim($form_values['name']); - $result = db_fetch_object(db_query("SELECT format FROM {filter_formats} WHERE name='%s'", $name)); - if ($result) { - form_set_error('name', t('Filter format names need to be unique. A format named %name already exists.', array('%name' => theme('placeholder', $name)))); - } - } -} - -/** - * Process filter format form submissions. - */ -function filter_admin_format_form_submit($form_id, $form_values) { - $format = isset($form_values['format']) ? $form_values['format'] : NULL; - $current = filter_list_format($format); - $name = trim($form_values['name']); - $cache = TRUE; - - // Add a new filter format. - if (!$format) { - $new = TRUE; - db_query("INSERT INTO {filter_formats} (name) VALUES ('%s')", $name); - $result = db_fetch_object(db_query("SELECT MAX(format) AS format FROM {filter_formats}")); - $format = $result->format; - drupal_set_message(t('Added input format %format.', array('%format' => theme('placeholder', $name)))); - } - else { - drupal_set_message(t('The input format settings have been updated.')); - } - - db_query("DELETE FROM {filters} WHERE format = %d", $format); - foreach ($form_values['filters'] as $id => $checked) { - if ($checked) { - list($module, $delta) = explode('/', $id); - // Add new filters to the bottom. - $weight = isset($current[$id]->weight) ? $current[$id]->weight : 10; - db_query("INSERT INTO {filters} (format, module, delta, weight) VALUES (%d, '%s', %d, %d)", $format, $module, $delta, $weight); - - // Check if there are any 'no cache' filters. - $cache &= !module_invoke($module, 'filter', 'no cache', $delta); - } - } - - // We store the roles as a string for ease of use. - // We should always set all roles to true when saving a default role. - // We use leading and trailing comma's to allow easy substring matching. - $roles = array(); - if (isset($form_values['roles'])) { - foreach ($form_values['roles'] as $id => $checked) { - if ($checked) { - $roles[] = $id; - } - } - } - $roles = ','. implode(',', ($form_values['default_format'] ? user_roles() : $roles)) .','; - - db_query("UPDATE {filter_formats} SET cache = %d, name='%s', roles = '%s' WHERE format = %d", $cache, $name, $roles, $format); - - cache_clear_all('filter:'. $format, true); - - // If a new filter was added, return to the main list of filters. Otherwise, stay on edit filter page to show new changes. - if ($new) { - return 'admin/filters/'; - } - else { - return 'admin/filters/'. $format; - } -} - -/** - * Menu callback; display form for ordering filters for a format. - */ -function filter_admin_order($format = NULL) { - // Get list (with forced refresh) - $filters = filter_list_format($format->format); - - $form['weights'] = array('#tree' => TRUE); - foreach ($filters as $id => $filter) { - $form['names'][$id] = array('#value' => $filter->name); - $form['weights'][$id] = array('#type' => 'weight', '#default_value' => $filter->weight); - } - $form['format'] = array('#type' => 'hidden', '#value' => $format->format); - $form['submit'] = array('#type' => 'submit', '#value' => t('Save configuration')); - - return drupal_get_form('filter_admin_order', $form); -} - -/** - * Theme filter order configuration form. - */ -function theme_filter_admin_order($form) { - $header = array(t('Name'), t('Weight')); - $rows = array(); - foreach (element_children($form['names']) as $id) { - // Don't take form control structures - if (is_array($form['names'][$id])) { - $rows[] = array(form_render($form['names'][$id]), form_render($form['weights'][$id])); - } - } - - $output = theme('table', $header, $rows); - $output .= form_render($form); - - return $output; -} - -/** - * Process filter order configuration form submission. - */ -function filter_admin_order_submit($form_id, $form_values) { - foreach ($form_values['weights'] as $id => $weight) { - list($module, $delta) = explode('/', $id); - db_query("UPDATE {filters} SET weight = %d WHERE format = %d AND module = '%s' AND delta = %d", $weight, $form_values['format'], $module, $delta); - } - drupal_set_message(t('The filter ordering has been saved.')); - - cache_clear_all('filter:'. $form_values['format'], true); -} - -/** - * Menu callback; display settings defined by filters. - */ -function filter_admin_configure() { - $format = arg(2); - - $list = filter_list_format($format); - $form = array(); - foreach ($list as $filter) { - $form_module = module_invoke($filter->module, 'filter', 'settings', $filter->delta, $format); - if (isset($form_module) && is_array($form_module)) { - $form = array_merge($form, $form_module); - } - } - - if (!empty($form)) { - $output = system_settings_form('filter_admin_configure', $form); - } - else { - $output = t('No settings are available.'); - } - - return $output; -} - -/** - * Retrieve a list of input formats. - */ -function filter_formats() { - global $user; - static $formats; - - // Administrators can always use all input formats. - $all = user_access('administer filters'); - - if (!isset($formats)) { - $formats = array(); - - $query = 'SELECT * FROM {filter_formats}'; - - // Build query for selecting the format(s) based on the user's roles. - if (!$all) { - $where = array(); - foreach ($user->roles as $rid => $role) { - $where[] = "roles LIKE '%%,%d,%%'"; - $args[] = $rid; - } - $query .= ' WHERE '. implode(' OR ', $where) . ' OR format = %d'; - $args[] = variable_get('filter_default_format', 1); - } - - $result = db_query($query, $args); - while ($format = db_fetch_object($result)) { - $formats[$format->format] = $format; - } - } - return $formats; -} - -/** - * Build a list of all filters. - */ -function filter_list_all() { - $filters = array(); - - foreach (module_list() as $module) { - $list = module_invoke($module, 'filter', 'list'); - if (isset($list) && is_array($list)) { - foreach ($list as $delta => $name) { - $filters[$module .'/'. $delta] = (object)array('module' => $module, 'delta' => $delta, 'name' => $name); - } - } - } - - uasort($filters, '_filter_list_cmp'); - - return $filters; -} - -/** - * Helper function for sorting the filter list by filter name. - */ -function _filter_list_cmp($a, $b) { - return strcmp($a->name, $b->name); -} - -/** - * Check if text in a certain input format is allowed to be cached. - */ -function filter_format_allowcache($format) { - static $cache = array(); - - if (!isset($cache[$format])) { - $cache[$format] = db_result(db_query('SELECT cache FROM {filter_formats} WHERE format = %d', $format)); - } - return $cache[$format]; -} - -/** - * Retrieve a list of filters for a certain format. - */ -function filter_list_format($format) { - static $filters = array(); - - if (!isset($filters[$format])) { - $filters[$format] = array(); - $result = db_query("SELECT * FROM {filters} WHERE format = %d ORDER BY weight ASC", $format); - while ($filter = db_fetch_object($result)) { - $list = module_invoke($filter->module, 'filter', 'list'); - if (isset($list) && is_array($list) && isset($list[$filter->delta])) { - $filter->name = $list[$filter->delta]; - $filters[$format][$filter->module .'/'. $filter->delta] = $filter; - } - } - } - - return $filters[$format]; -} - -/** - * @name Filtering functions - * @{ - * Modules which need to have content filtered can use these functions to - * interact with the filter system. - * - * For more info, see the hook_filter() documentation. - * - * Note: because filters can inject JavaScript or execute PHP code, security is - * vital here. When a user supplies a $format, you should validate it with - * filter_access($format) before accepting/using it. This is normally done in - * the validation stage of the node system. You should for example never make a - * preview of content in a disallowed format. - */ - -/** - * Run all the enabled filters on a piece of text. - * - * @param $text - * The text to be filtered. - * @param $format - * The format of the text to be filtered. Specify FILTER_FORMAT_DEFAULT for - * the default format. - * @param $check - * Whether to check the $format with filter_access() first. Defaults to TRUE. - * Note that this will check the permissions of the current user, so you - * should specify $check = FALSE when viewing other people's content. When - * showing content that is not (yet) stored in the database (eg. upon preview), - * set to TRUE so the user's permissions are checked. - */ -function check_markup($text, $format = FILTER_FORMAT_DEFAULT, $check = TRUE) { - // When $check = true, do an access check on $format. - if (isset($text) && (!$check || filter_access($format))) { - if ($format == FILTER_FORMAT_DEFAULT) { - $format = variable_get('filter_default_format', 1); - } - - // Check for a cached version of this piece of text. - $id = 'filter:'. $format .':'. md5($text); - if ($cached = cache_get($id)) { - return $cached->data; - } - - // See if caching is allowed for this format. - $cache = filter_format_allowcache($format); - - // Convert all Windows and Mac newlines to a single newline, - // so filters only need to deal with one possibility. - $text = str_replace(array("\r\n", "\r"), "\n", $text); - - // Get a complete list of filters, ordered properly. - $filters = filter_list_format($format); - - // Give filters the chance to escape HTML-like data such as code or formulas. - foreach ($filters as $filter) { - $text = module_invoke($filter->module, 'filter', 'prepare', $filter->delta, $format, $text); - } - - // Perform filtering. - foreach ($filters as $filter) { - $text = module_invoke($filter->module, 'filter', 'process', $filter->delta, $format, $text); - } - - // Store in cache with a minimum expiration time of 1 day. - if ($cache) { - cache_set($id, $text, time() + (60 * 60 * 24)); - } - } - else { - $text = message_na(); - } - - return $text; -} - -/** - * Generate a selector for choosing a format in a form. - * - * @param $value - * The ID of the format that is currently selected. - * @param $weight - * The weight of the input format. - * @param $parents - * Required when defining multiple input formats on a single node or having a different parent than 'format'. - * @return - * HTML for the form element. - */ -function filter_form($value = FILTER_FORMAT_DEFAULT, $weight = NULL, $parents = array('format')) { - if ($value == FILTER_FORMAT_DEFAULT) { - $value = variable_get('filter_default_format', 1); - } - $formats = filter_formats(); - - $extra = l(t('More information about formatting options'), 'filter/tips'); - - if (count($formats) > 1) { - $form = array( - '#type' => 'fieldset', - '#title' => t('Input format'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - '#weight' => $weight, - '#validate' => array('filter_form_validate' => array()), - ); - // Multiple formats available: display radio buttons with tips. - foreach ($formats as $format) { - $form[$format->format] = array( - '#type' => 'radio', - '#title' => $format->name, - '#default_value' => $value, - '#return_value' => $format->format, - '#parents' => $parents, - '#description' => theme('filter_tips', _filter_tips($format->format, false)), - ); - } - } - else { - // Only one format available: use a hidden form item and only show tips. - $format = array_shift($formats); - $form['format'][$format->name] = array('#type' => 'value', '#value' => $format->format); - $tips = _filter_tips(variable_get('filter_default_format', 1), false); - $form['format']['guidelines'] = array( - '#type' => 'markup', - '#title' => t('Formatting guidelines'), - '#value' => theme('filter_tips', $tips, false, $extra), - ); - } - return $form; -} - -function filter_form_validate($form) { - foreach (element_children($form) as $key) { - if ($form[$key]['#value'] == $form[$key]['#return_value']) { - return; - } - } - form_error($form, t('An illegal choice has been detected. Please contact the site administrator.')); - watchdog('form', t('Illegal choice %choice in %name element.', array('%choice' => theme('placeholder', check_plain($v)), '%name' => theme('placeholder', empty($form['#title']) ? $form['#parents'][0] : $form['#title'])), WATCHDOG_ERROR)); -} - -/** - * Returns true if the user is allowed to access this format. - */ -function filter_access($format) { - if (user_access('administer filters') || ($format == FILTER_FORMAT_DEFAULT) || ($format == variable_get('filter_default_format', 1))) { - return true; - } - else { - $formats = filter_formats(); - return isset($formats[$format]); - } -} -/** - * @} End of "Filtering functions". - */ - -/** - * Menu callback; show a page with long filter tips. - */ -function filter_tips_long() { - $format = arg(2); - if ($format) { - $output = theme('filter_tips', _filter_tips($format, true), true); - } - else { - $output = theme('filter_tips', _filter_tips(-1, true), true); - } - return $output; -} - -/** - * Helper function for fetching filter tips. - */ -function _filter_tips($format, $long = false) { - if ($format == -1) { - $formats = filter_formats(); - } - else { - $formats = array(db_fetch_object(db_query("SELECT * FROM {filter_formats} WHERE format = %d", $format))); - } - - $tips = array(); - - foreach ($formats as $format) { - $filters = filter_list_format($format->format); - - $tips[$format->name] = array(); - foreach ($filters as $id => $filter) { - if ($tip = module_invoke($filter->module, 'filter_tips', $filter->delta, $format->format, $long)) { - $tips[$format->name][] = array('tip' => $tip, 'id' => $id); - } - } - } - - return $tips; -} - -/** - * Format a set of filter tips. - * - * @ingroup themeable - */ -function theme_filter_tips($tips, $long = false, $extra = '') { - $output = ''; - - $multiple = count($tips) > 1; - if ($multiple) { - $output = t('input formats') .':'; - } - - if (count($tips)) { - if ($multiple) { - $output .= '- ';
- }
- foreach ($tips as $name => $tiplist) {
- if ($multiple) {
- $output .= '
- ';
- $output .= ''. $name .':
'; - } - - $tips = ''; - foreach ($tiplist as $tip) { - $tips .= ' ';
- }
-
- if ($tips) {
- $output .= "
- $tips
';
- }
- }
- if ($multiple) {
- $output .= ' -
- '), '#size' => 64, '#maxlength' => 255, '#description' => t('If "Strip disallowed tags" is selected, optionally specify tags which should not be stripped. JavaScript event attributes are always stripped.'));
- $form['filter_html']["filter_html_help_$format"] = array('#type' => 'checkbox', '#title' => t('Display HTML help'), '#default_value' => variable_get("filter_html_help_$format", 1), '#description' => t('If enabled, Drupal will display some basic HTML help in the long filter tips.'));
- $form['filter_html']["filter_html_nofollow_$format"] = array('#type' => 'checkbox', '#title' => t('Spam link deterrent'), '#default_value' => variable_get("filter_html_nofollow_$format", FALSE), '#description' => t('If enabled, Drupal will add rel="nofollow" to all links, as a measure to reduce the effectiveness of spam links. Note: this will also prevent valid links from being followed by search engines, therefore it is likely most effective when enabled for anonymous users.'));
- return $form;
-}
-
-/**
- * HTML filter. Provides filtering of input into accepted HTML.
- */
-function _filter_html($text, $format) {
- if (variable_get("filter_html_$format", FILTER_HTML_STRIP) == FILTER_HTML_STRIP) {
- $allowed_tags = preg_split('/\s+|<|>/', variable_get("allowed_html_$format", '
-
- '), -1, PREG_SPLIT_NO_EMPTY);
- $text = filter_xss($text, $allowed_tags);
- }
-
- if (variable_get("filter_html_$format", FILTER_HTML_STRIP) == FILTER_HTML_ESCAPE) {
- // Escape HTML
- $text = check_plain($text);
- }
-
- if (variable_get("filter_html_nofollow_$format", FALSE)) {
- $text = preg_replace('/
and
in an intelligent fashion. - * Based on: http://photomatt.net/scripts/autop - */ -function _filter_autop($text) { - // Split at, , tags. - // We don't apply any processing to the contents of these tags to avoid messing - // up code. We look for matched pairs and allow basic nesting. For example: - // "processed
ignored ignored
processed" - $chunks = preg_split('@(]*>)@i', $text, -1, PREG_SPLIT_DELIM_CAPTURE); - // Note: PHP ensures the array consists of alternating delimiters and literals - // and begins and ends with a literal (inserting NULL as required). - $ignore = false; - $ignoretag = ''; - $output = ''; - foreach ($chunks as $i => $chunk) { - if ($i % 2) { - // Opening or closing tag? - $open = ($chunk[1] != '/'); - list($tag) = split('[ >]', substr($chunk, 2 - $open), 2); - if (!$ignore) { - if ($open) { - $ignore = true; - $ignoretag = $tag; - } - } - // Only allow a matching tag to close it. - else if (!$open && $ignoretag == $tag) { - $ignore = false; - $ignoretag = ''; - } - } - else if (!$ignore) { - $chunk = preg_replace('|\n*$|', '', $chunk) ."\n\n"; // just to make things a little easier, pad the end - $chunk = preg_replace('|
\s*
|', "\n\n", $chunk); - $chunk = preg_replace('!(<(?:table|ul|ol|li|pre|form|blockquote|h[1-6])[^>]*>)!', "\n$1", $chunk); // Space things out a little - $chunk = preg_replace('!()!', "$1\n", $chunk); // Space things out a little - $chunk = preg_replace("/\n\n+/", "\n\n", $chunk); // take care of duplicates - $chunk = preg_replace('/\n?(.+?)(?:\n\s*\n|\z)/s', "$1
\n", $chunk); // make paragraphs, including one at the end - $chunk = preg_replace('|\s*?
|', '', $chunk); // under certain strange conditions it could create a P of entirely whitespace - $chunk = preg_replace("|(
'; - $output .= '
', $chunk); - $chunk = preg_replace('!", $chunk); - $chunk = str_replace('
', '\s*(]*>)!', "$1", $chunk); - $chunk = preg_replace('!(]*>)\s*
!', "$1", $chunk); - $chunk = preg_replace('|(?)\s*\n|', "
\n", $chunk); // make line breaks - $chunk = preg_replace('!(]*>)\s*
!', "$1", $chunk); - $chunk = preg_replace('!
(\s*)!', '$1', $chunk); - $chunk = preg_replace('/&([^#])(?![A-Za-z0-9]{1,8};)/', '&$1', $chunk); - } - $output .= $chunk; - } - return $output; -} - -/** - * Filters XSS. Based on kses by Ulf Harnhammar, see - * http://sourceforge.net/projects/kses - * - * For examples of various XSS attacks, see: - * http://ha.ckers.org/xss.html - * - * This code does four things: - * - Removes characters and constructs that can trick browsers - * - Makes sure all HTML entities are well-formed - * - Makes sure all HTML tags and attributes are well-formed - * - Makes sure no HTML tags contain URLs with a disallowed protocol (e.g. javascript:) - * - * @param $string - * The string with raw HTML in it. It will be stripped of everything that can cause - * an XSS attack. - * @param $allowed_tags - * An array of allowed tags. - * @param $format - * The format to use. - */ -function filter_xss($string, $allowed_tags = array('a', 'em', 'strong', 'cite', 'code', 'ul', 'ol', 'li', 'dl', 'dt', 'dd')) { - // Store the input format - _filter_xss_split($allowed_tags, TRUE); - // Remove NUL characters (ignored by some browsers) - $string = str_replace(chr(0), '', $string); - // Remove Netscape 4 JS entities - $string = preg_replace('%&\s*\{[^}]*(\}\s*;?|$)%', '', $string); - - // Defuse all HTML entities - $string = str_replace('&', '&', $string); - // Change back only well-formed entities in our whitelist - // Named entities - $string = preg_replace('/&([A-Za-z][A-Za-z0-9]*;)/', '&\1', $string); - // Decimal numeric entities - $string = preg_replace('/&#([0-9]+;)/', '&#\1', $string); - // Hexadecimal numeric entities - $string = preg_replace('/&#[Xx]0*((?:[0-9A-Fa-f]{2})+;)/', '&#x\1', $string); - - return preg_replace_callback('% - ( - <[^>]*.(>|$) # a string that starts with a <, up until the > or the end of the string - | # or - > # just a > - )%x', '_filter_xss_split', $string); -} - -/** - * Processes an HTML tag. - * - * @param @m - * An array with various meaning depending on the value of $store. - * If $store is TRUE then the array contains the allowed tags. - * If $store is FALSE then the array has one element, the HTML tag to process. - * @param $store - * Whether to store $m. - * @return - * If the element isn't allowed, an empty string. Otherwise, the cleaned up - * version of the HTML element. - */ -function _filter_xss_split($m, $store = FALSE) { - static $allowed_html; - - if ($store) { - $allowed_html = array_flip($m); - return; - } - - $string = $m[1]; - - if (substr($string, 0, 1) != '<') { - // We matched a lone ">" character - return '>'; - } - - if (!preg_match('%^<\s*(/\s*)?([a-zA-Z0-9]+)([^>]*)>?$%', $string, $matches)) { - // Seriously malformed - return ''; - } - - $slash = trim($matches[1]); - $elem = &$matches[2]; - $attrlist = &$matches[3]; - - if (!isset($allowed_html[strtolower($elem)])) { - // Disallowed HTML element - return ''; - } - - if ($slash != '') { - return ""; - } - - // Is there a closing XHTML slash at the end of the attributes? - // In PHP 5.1.0+ we could count the changes, currently we need a separate match - $xhtml_slash = preg_match('%\s?/\s*$%', $attrlist) ? ' /' : ''; - $attrlist = preg_replace('%(\s?)/\s*$%', '\1', $attrlist); - - // Clean up attributes - $attr2 = implode(' ', _filter_xss_attributes($attrlist)); - $attr2 = preg_replace('/[<>]/', '', $attr2); - $attr2 = strlen($attr2) ? ' '. $attr2 : ''; - - return "<$elem$attr2$xhtml_slash>"; -} - -/** - * Processes a string of HTML attributes. - * - * @return - * Cleaned up version of the HTML attributes. - */ -function _filter_xss_attributes($attr) { - $attrarr = array(); - $mode = 0; - $attrname = ''; - - while (strlen($attr) != 0) { - // Was the last operation successful? - $working = 0; - - switch ($mode) { - case 0: - // Attribute name, href for instance - if (preg_match('/^([-a-zA-Z]+)/', $attr, $match)) { - $attrname = strtolower($match[1]); - $skip = ($attrname == 'style' || substr($attrname, 0, 2) == 'on'); - $working = $mode = 1; - $attr = preg_replace('/^[-a-zA-Z]+/', '', $attr); - } - - break; - - case 1: - // Equals sign or valueless ("selected") - if (preg_match('/^\s*=\s*/', $attr)) { - $working = 1; $mode = 2; - $attr = preg_replace('/^\s*=\s*/', '', $attr); - break; - } - - if (preg_match('/^\s+/', $attr)) { - $working = 1; $mode = 0; - if (!$skip) { - $attrarr[] = $attrname; - } - $attr = preg_replace('/^\s+/', '', $attr); - } - - break; - - case 2: - // Attribute value, a URL after href= for instance - if (preg_match('/^"([^"]*)"(\s+|$)/', $attr, $match)) { - $thisval = filter_xss_bad_protocol($match[1]); - - if (!$skip) { - $attrarr[] = "$attrname=\"$thisval\""; - } - $working = 1; - $mode = 0; - $attr = preg_replace('/^"[^"]*"(\s+|$)/', '', $attr); - break; - } - - if (preg_match("/^'([^']*)'(\s+|$)/", $attr, $match)) { - $thisval = filter_xss_bad_protocol($match[1]); - - if (!$skip) { - $attrarr[] = "$attrname='$thisval'";; - } - $working = 1; $mode = 0; - $attr = preg_replace("/^'[^']*'(\s+|$)/", '', $attr); - break; - } - - if (preg_match("%^([^\s\"']+)(\s+|$)%", $attr, $match)) { - $thisval = filter_xss_bad_protocol($match[1]); - - if (!$skip) { - $attrarr[] = "$attrname=\"$thisval\""; - } - $working = 1; $mode = 0; - $attr = preg_replace("%^[^\s\"']+(\s+|$)%", '', $attr); - } - - break; - } - - if ($working == 0) { - // not well formed, remove and try again - $attr = preg_replace('/ - ^ - ( - "[^"]*("|$) # - a string that starts with a double quote, up until the next double quote or the end of the string - | # or - \'[^\']*(\'|$)| # - a string that starts with a quote, up until the next quote or the end of the string - | # or - \S # - a non-whitespace character - )* # any number of the above three - \s* # any number of whitespaces - /x', '', $attr); - $mode = 0; - } - } - - // the attribute list ends with a valueless attribute like "selected" - if ($mode == 1) { - $attrarr[] = $attrname; - } - return $attrarr; -} - -/** - * Processes an HTML attribute value and ensures it does not contain an URL - * with a disallowed protocol (e.g. javascript:) - * - * @param $string - * The string with the attribute value. - * @param $decode - * Whether to decode entities in the $string. Set to FALSE if the $string - * is in plain text, TRUE otherwise. Defaults to TRUE. - * @return - * Cleaned up and HTML-escaped version of $string. - */ -function filter_xss_bad_protocol($string, $decode = TRUE) { - static $allowed_protocols; - if (!isset($allowed_protocols)) { - $allowed_protocols = array_flip(variable_get('filter_allowed_protocols', array('http', 'https', 'ftp', 'news', 'nntp', 'telnet', 'mailto', 'irc', 'ssh', 'sftp', 'webcal'))); - } - - // Get the plain text representation of the attribute value (i.e. its meaning) - if ($decode) { - $string = decode_entities($string); - } - // Remove soft hyphen - $string = str_replace(chr(194) . chr(173), '', $string); - // Strip protocols - - do { - $before = $string; - $colonpos = strpos($string, ':'); - if ($colonpos > 0) { - $protocol = substr($string, 0, $colonpos); - if (!isset($allowed_protocols[$protocol])) { - $string = substr($string, $colonpos + 1); - } - } - } while ($before != $string); - return check_plain($string); -} - -/** - * @} End of "Standard filters". - */ - diff --git a/modules/forum/forum.module b/modules/forum/forum.module deleted file mode 100644 index 267d3e120f18b9019e0c847d252232ab6de7a9be..0000000000000000000000000000000000000000 --- a/modules/forum/forum.module +++ /dev/null @@ -1,1120 +0,0 @@ -'. t('The forum module lets you create threaded discussion forums for a particular topic on your site. This is similar to a message board system such as phpBB. Forums are very useful because they allow community members to discuss topics with one another, and they are archived for future reference.') .''. t('Forums can be organized under what are called containers. Containers hold forums and, in turn, forums hold threaded discussions. Both containers and forums can be placed inside other containers and forums. By planning the structure of your containers and forums well, you make it easier for users to find a topic area of interest to them. Forum topics can be moved by selecting a different forum and can be left in the existing forum by selecting leave a shadow copy. Forum topics can also have their own URL.') .'
'; - $output .= ''. t('Forums module requires Taxonomy and Comments module be enabled.') .'
'; - $output .= t('You can
--
-
- administer forums at administer >> forums. -
- enable the required comment and taxonomy modules at administer >> modules. -
- read about the comment module at administer >> help >> comment. -
- read about the taxonomy module at administer >> help >> taxonomy. -
'. t('For more information please read the configuration and customization handbook Forum page.', array('%forum' => 'http://drupal.org/handbook/modules/forum/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables threaded discussions about general topics.'); - case 'admin/forum': - return t('This is a list of existing containers and forums that you can edit. Containers hold forums and, in turn, forums hold threaded discussions. Both containers and forums can be placed inside other containers and forums. By planning the structure of your containers and forums well, you make it easier for users to find a topic area of interest to them.
'); - case 'admin/forum/add/container': - return t('Containers help you organize your forums. The job of a container is to hold, or contain, other forums that are related. For example, a container named "Food" might hold two forums named "Fruit" and "Vegetables".
'); - case 'admin/forum/add/forum': - return t('A forum holds discussion topics that are related. For example, a forum named "Fruit" might contain topics titled "Apples" and "Bananas".
'); - case 'admin/forum/configure': - return t('This is where you can configure system-wide options for how your forums act and display.'); - case 'node/add#forum': - return t('Create a new topic for discussion in the forums.'); - } -} - -/** - * Implementation of hook_menu(). - */ -function forum_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'node/add/forum', - 'title' => t('forum topic'), - 'access' => user_access('create forum topics')); - $items[] = array('path' => 'forum', - 'title' => t('forums'), - 'callback' => 'forum_page', - 'access' => user_access('access content'), - 'type' => MENU_SUGGESTED_ITEM); - $items[] = array('path' => 'admin/forum', - 'title' => t('forums'), - 'callback' => 'forum_overview', - 'access' => user_access('administer forums'), - 'type' => MENU_NORMAL_ITEM); - $items[] = array('path' => 'admin/forum/list', - 'title' => t('list'), - 'access' => user_access('administer forums'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'weight' => -10); - $items[] = array('path' => 'admin/forum/add/container', - 'title' => t('add container'), - 'callback' => 'forum_form_container', - 'access' => user_access('administer forums'), - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/forum/add/forum', - 'title' => t('add forum'), - 'callback' => 'forum_form_forum', - 'access' => user_access('administer forums'), - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/forum/configure', - 'title' => t('configure'), - 'callback' => 'forum_admin_configure', - 'access' => user_access('administer forums'), - 'type' => MENU_LOCAL_TASK); - } - elseif (is_numeric(arg(4))) { - $term = taxonomy_get_term(arg(4)); - // Check if this is a valid term. - if ($term) { - $items[] = array('path' => 'admin/forum/edit/container', - 'title' => t('edit container'), - 'callback' => 'forum_form_container', - 'callback arguments' => array((array)$term), - 'access' => user_access('administer forums'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/forum/edit/forum', - 'title' => t('edit forum'), - 'callback' => 'forum_form_forum', - 'callback arguments' => array((array)$term), - 'access' => user_access('administer forums'), - 'type' => MENU_CALLBACK); - } - } - - return $items; -} - -/** - * Implementation of hook_node_info(). - */ -function forum_node_info() { - return array('forum' => array('name' => t('forum topic'), 'base' => 'forum')); -} - -/** - * Implementation of hook_access(). - */ -function forum_access($op, $node) { - global $user; - - if ($op == 'create') { - return user_access('create forum topics'); - } - - if ($op == 'update' || $op == 'delete') { - if (user_access('edit own forum topics') && ($user->uid == $node->uid)) { - return TRUE; - } - } -} - -/** - * Implementation of hook_perm(). - */ -function forum_perm() { - return array('create forum topics', 'edit own forum topics', 'administer forums'); -} - -/** - * Implementation of hook_nodeapi(). - */ -function forum_nodeapi(&$node, $op, $teaser, $page) { - switch ($op) { - case 'delete revision': - db_query('DELETE FROM {forum} WHERE vid = %d', $node->vid); - break; - } -} - -/** - * Implementation of hook_taxonomy(). - */ -function forum_taxonomy($op, $type, $term = NULL) { - if ($op == 'delete' && $term->vid == _forum_get_vid()) { - switch ($type) { - case 'term': - $results = db_query('SELECT f.nid FROM {forum} f WHERE f.tid = %d', $term->tid); - while ($node = db_fetch_object($results)) { - // node_delete will also remove any association with non-forum vocabularies. - node_delete($node->nid); - } - - // For containers, remove the tid from the forum_containers variable. - $containers = variable_get('forum_containers', array()); - if ($key = array_search($term->tid, $containers)) { - unset($containers[$key]); - } - variable_set('forum_containers', $containers); - break; - case 'vocabulary': - variable_del('forum_nav_vocabulary'); - } - } -} - -/** - * Implementation of hook_settings - */ -function forum_admin_configure() { - - $form = array(); - $number = drupal_map_assoc(array(5, 10, 15, 20, 25, 30, 35, 40, 50, 60, 80, 100, 10000)); - $form['forum_hot_topic'] = array('#type' => 'select', - '#title' => t('Hot topic threshold'), - '#default_value' => variable_get('forum_hot_topic', 15), - '#options' => $number, - '#description' => t('The number of posts a topic must have to be considered hot.'), - ); - $number = drupal_map_assoc(array(10, 25, 50, 75, 100)); - $form['forum_per_page'] = array('#type' => 'select', - '#title' => t('Topics per page'), - '#default_value' => variable_get('forum_per_page', 25), - '#options' => $number, - '#description' => t('The default number of topics displayed per page; links to browse older messages are automatically being displayed.'), - ); - $forder = array(1 => t('Date - newest first'), 2 => t('Date - oldest first'), 3 => t('Posts - most active first'), 4=> t('Posts - least active first')); - $form['forum_order'] = array('#type' => 'radios', - '#title' => t('Default order'), - '#default_value' => variable_get('forum_order', '1'), - '#options' => $forder, - '#description' => t('The default display order for topics.'), - ); - - return system_settings_form('forum_admin_configure', $form); -} - -/** - * Implementation of hook_form_alter(). - */ -function forum_form_alter($form_id, &$form) { - // hide critical options from forum vocabulary - if ($form_id == 'taxonomy_form_vocabulary') { - if ($form['vid']['#value'] == _forum_get_vid()) { - $form['help_forum_vocab'] = array( - '#value' => t('This is the designated forum vocabulary. Some of the normal vocabulary options have been removed.'), - '#weight' => -1, - ); - $form['nodes']['forum'] = array('#type' => 'checkbox', '#value' => 1, '#title' => t('forum topic'), '#attributes' => array('disabled' => '' ), '#description' => t('forum topic is affixed to the forum vocabulary.')); - $form['hierarchy'] = array('#type' => 'value', '#value' => 1); - unset($form['relations']); - unset($form['tags']); - unset($form['multiple']); - $form['required'] = array('#type' => 'value', '#value' => 1); - } - else { - unset($form['nodes']['forum']); - } - } -} - -/** - * Implementation of hook_load(). - */ -function forum_load($node) { - $forum = db_fetch_object(db_query('SELECT * FROM {forum} WHERE vid = %d', $node->vid)); - - return $forum; -} - -/** - * Implementation of hook_block(). - * - * Generates a block containing the currently active forum topics and the - * most recently added forum topics. - */ -function forum_block($op = 'list', $delta = 0, $edit = array()) { - switch ($op) { - case 'list': - $blocks[0]['info'] = t('Active forum topics'); - $blocks[1]['info'] = t('New forum topics'); - return $blocks; - - case 'configure': - $form['forum_block_num_'. $delta] = array('#type' => 'select', '#title' => t('Number of topics'), '#default_value' => variable_get('forum_block_num_'. $delta, '5'), '#options' => drupal_map_assoc(array(2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20))); - return $form; - - case 'save': - variable_set('forum_block_num_'. $delta, $edit['forum_block_num_'. $delta]); - break; - - case 'view': - if (user_access('access content')) { - switch ($delta) { - case 0: - $title = t('Active forum topics'); - $sql = db_rewrite_sql("SELECT n.nid, n.title, l.comment_count FROM {node} n INNER JOIN {node_comment_statistics} l ON n.nid = l.nid WHERE n.status = 1 AND n.type = 'forum' ORDER BY l.last_comment_timestamp DESC"); - $result = db_query_range($sql, 0, variable_get('forum_block_num_0', '5')); - if (db_num_rows($result)) { - $content = node_title_list($result); - } - break; - - case 1: - $title = t('New forum topics'); - $sql = db_rewrite_sql("SELECT n.nid, n.title, l.comment_count FROM {node} n INNER JOIN {node_comment_statistics} l ON n.nid = l.nid WHERE n.type = 'forum' AND n.status = 1 ORDER BY n.nid DESC"); - $result = db_query_range($sql, 0, variable_get('forum_block_num_1', '5')); - if (db_num_rows($result)) { - $content = node_title_list($result); - } - break; - } - - if ($content) { - $content .= ''. l(t('more'), 'forum', array('title' => t('Read the latest forum topics.'))) .''; - } - - $block['subject'] = $title; - $block['content'] = $content; - - return $block; - } - } -} - -/** - * Implementation of hook_view(). - */ -function forum_view(&$node, $teaser = FALSE, $page = FALSE) { - if ($page) { - $vocabulary = taxonomy_get_vocabulary(variable_get('forum_nav_vocabulary', '')); - // Breadcrumb navigation - $breadcrumb = array(); - $breadcrumb[] = array('path' => 'forum', 'title' => $vocabulary->name); - if ($parents = taxonomy_get_parents_all($node->tid)) { - $parents = array_reverse($parents); - foreach ($parents as $p) { - $breadcrumb[] = array('path' => 'forum/'. $p->tid, 'title' => $p->name); - } - } - $breadcrumb[] = array('path' => 'node/'. $node->nid); - menu_set_location($breadcrumb); - } - - $node = node_prepare($node, $teaser); - - $node->body .= theme('forum_topic_navigation', $node); -} - -/** - * Implementation of hook_submit(). - * - * Check in particular that only a "leaf" term in the associated taxonomy - * vocabulary is selected, not a "container" term. - */ -function forum_submit(&$node) { - // Make sure all fields are set properly: - $node->icon = $node->icon ? $node->icon : ''; - - if ($node->taxonomy) { - // Extract the node's proper topic ID. - $vocabulary = variable_get('forum_nav_vocabulary', ''); - foreach ($node->taxonomy as $term) { - if (db_result(db_query('SELECT COUNT(*) FROM {term_data} WHERE tid = %d AND vid = %d', $term, $vocabulary))) { - $node->tid = $term; - } - } - if ($node->tid && $node->shadow) { - // A shadow copy needs to be created. Retain existing term and add new term. - $terms = array_keys(taxonomy_node_get_terms($node->nid)); - if (!in_array($node->tid, $terms)) { - $terms[] = $node->tid; - } - $node->taxonomy = $terms; - } - } -} - -/** - * Implementation of hook_validate(). - * - * Check in particular that only a "leaf" term in the associated taxonomy - * vocabulary is selected, not a "container" term. - */ -function forum_validate($node) { - if ($node->taxonomy) { - // Extract the node's proper topic ID. - $vocabulary = variable_get('forum_nav_vocabulary', ''); - $containers = variable_get('forum_containers', array()); - foreach ($node->taxonomy as $term) { - if (db_result(db_query('SELECT COUNT(*) FROM {term_data} WHERE tid = %d AND vid = %d', $term, $vocabulary))) { - if (in_array($term, $containers)) { - $term = taxonomy_get_term($term); - form_set_error('taxonomy', t('The item %forum is only a container for forums. Please select one of the forums below it.', array('%forum' => theme('placeholder', $term->name)))); - } - } - } - } -} - -/** - * Implementation of hook_update(). - */ -function forum_update($node) { - if ($node->is_new || $node->revision) { - db_query("INSERT INTO {forum} (nid, vid, tid) VALUES (%d, %d, %d)", $node->nid, $node->vid, $node->tid); - } - else { - db_query('UPDATE {forum} SET tid = %d WHERE vid = %d', $node->tid, $node->vid); - } -} - -/** - * Implementation of hook_form(). - */ -function forum_form(&$node) { - $form['title'] = array('#type' => 'textfield', '#title' => t('Subject'), '#default_value' => $node->title, '#required' => TRUE, '#weight' => -5); - - if ($node->nid) { - $forum_terms = taxonomy_node_get_terms_by_vocabulary(_forum_get_vid(), $node->nid); - // if editing, give option to leave shadows - $shadow = (count($forum_terms) > 1); - $form['shadow'] = array('#type' => 'checkbox', '#title' => t('Leave shadow copy'), '#default_value' => $shadow, '#description' => t('If you move this topic, you can leave a link in the old forum to the new forum.')); - } - - $form['body_filter']['body'] = array('#type' => 'textarea', '#title' => t('Body'), '#default_value' => $node->body, '#rows' => 20, '#required' => TRUE); - $form['body_filter']['format'] = filter_form($node->format); - - return $form; -} - -/** - * Implementation of hook_prepare; assign forum taxonomy when adding a topic from within a forum. - */ -function forum_prepare(&$node) { - if (!$node->nid) { - // new topic - $node->taxonomy[arg(3)] = 1; - } -} - -/** - * Implementation of hook_insert(). - */ -function forum_insert($node) { - db_query('INSERT INTO {forum} (nid, vid, tid) VALUES (%d, %d, %d)', $node->nid, $node->vid, $node->tid); -} - -/** - * Implementation of hook_delete(). - */ -function forum_delete(&$node) { - db_query('DELETE FROM {forum} WHERE nid = %d', $node->nid); -} - -/** - * Returns a form for adding a container to the forum vocabulary - * - * @param $edit Associative array containing a container term to be added or edited. - */ -function forum_form_container($edit = array()) { - // Handle a delete operation. - if ($_POST['op'] == t('Delete') || $_POST['edit']['confirm']) { - return _forum_confirm_delete($edit['tid']); - } - - $form['name'] = array( - '#title' => t('Container name'), - '#type' => 'textfield', - '#default_value' => $edit['name'], - '#maxlength' => 64, - '#description' => t('The container name is used to identify related forums.'), - '#required' => TRUE - ); - - $form['description'] = array( - '#type' => 'textarea', - '#title' => t('Description'), - '#default_value' => $edit['description'], - '#description' => t('The container description can give users more information about the forums it contains.') - ); - $form['parent']['#tree'] = TRUE; - $form['parent'][0] = _forum_parent_select($edit['tid'], t('Parent'), 'container'); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $edit['weight'], - '#description' => t('When listing containers, those with with light (small) weights get listed before containers with heavier (larger) weights. Containers with equal weights are sorted alphabetically.') - ); - - $form['vid'] = array('#type' => 'hidden', - '#value' => _forum_get_vid()); - $form['submit'] = array( - '#type' => 'submit', - '#value' => t('Submit') - ); - if ($edit['tid']) { - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete')); - $form['tid'] = array('#type' => 'value', '#value' => $edit['tid']); - } - - return drupal_get_form('forum_form_container', $form, 'forum_form'); -} - -/** - * Returns a form for adding a forum to the forum vocabulary - * - * @param $edit Associative array containing a forum term to be added or edited. - */ -function forum_form_forum($edit = array()) { - // Handle a delete operation. - if ($_POST['op'] == t('Delete') || $_POST['edit']['confirm']) { - return _forum_confirm_delete($edit['tid']); - } - - $form['name'] = array('#type' => 'textfield', - '#title' => t('Forum name'), - '#default_value' => $edit['name'], - '#maxlength' => 64, - '#description' => t('The forum name is used to identify related discussions.'), - '#required' => TRUE, - ); - $form['description'] = array('#type' => 'textarea', - '#title' => t('Description'), - '#default_value' => $edit['description'], - '#description' => t('The forum description can give users more information about the discussion topics it contains.'), - ); - $form['parent']['#tree'] = TRUE; - $form['parent'][0] = _forum_parent_select($edit['tid'], t('Parent'), 'forum'); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $edit['weight'], - '#description' => t('When listing forums, those with lighter (smaller) weights get listed before containers with heavier (larger) weights. Forums with equal weights are sorted alphabetically.'), - ); - - $form['vid'] = array('#type' => 'hidden', '#value' => _forum_get_vid()); - $form['submit' ] = array('#type' => 'submit', '#value' => t('Submit')); - if ($edit['tid']) { - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete')); - $form['tid'] = array('#type' => 'hidden', '#value' => $edit['tid']); - } - - return drupal_get_form('forum_form_forum', $form, 'forum_form'); -} - -/** - * Process forum form and container form submissions. - */ -function forum_form_submit($form_id, $form_values) { - if ($form_id == 'forum_form_container') { - $container = TRUE; - $type = t('forum container'); - } - else { - $container = false; - $type = t('forum'); - } - - $status = taxonomy_save_term($form_values); - switch ($status) { - case SAVED_NEW: - if ($container) { - $containers = variable_get('forum_containers', array()); - $containers[] = $form_values['tid']; - variable_set('forum_containers', $containers); - } - drupal_set_message(t('Created new %type %term.', array('%term' => theme('placeholder', $form_values['name']), '%type' => $type))); - break; - case SAVED_UPDATED: - drupal_set_message(t('The %type %term has been updated.', array('%term' => theme('placeholder', $form_values['name']), '%type' => $type))); - break; - } - return 'admin/forum'; -} - -/** - * Returns a confirmation page for deleting a forum taxonomy term. - * - * @param $tid ID of the term to be deleted - */ -function _forum_confirm_delete($tid) { - $term = taxonomy_get_term($tid); - - $form['tid'] = array('#type' => 'value', '#value' => $tid); - $form['name'] = array('#type' => 'value', '#value' => $term->name); - - return confirm_form('forum_confirm_delete', $form, t('Are you sure you want to delete the forum %name?', array('%name' => theme('placeholder', $term->name))), 'admin/forums', t('Deleting a forum or container will delete all sub-forums and associated posts as well. This action cannot be undone.'), t('Delete'), t('Cancel')); -} - -/** - * Implementation of forms api _submit call. Deletes a forum after confirmation. - */ -function forum_confirm_delete_submit($form_id, $form_values) { - taxonomy_del_term($form_values['tid']); - drupal_set_message(t('The forum %term and all sub-forums and associated posts have been deleted.', array('%term' => theme('placeholder', $form_values['name'])))); - watchdog('content', t('forum: deleted %term and all its sub-forums and associated posts.', array('%term' => theme('placeholder', $form_values['name'])))); - - return 'admin/forum'; -} - -/** - * Returns an overview list of existing forums and containers - */ -function forum_overview() { - $header = array(t('Name'), t('Operations')); - - $tree = taxonomy_get_tree(_forum_get_vid()); - if ($tree) { - foreach ($tree as $term) { - if (in_array($term->tid, variable_get('forum_containers', array()))) { - $rows[] = array(_taxonomy_depth($term->depth) .' '. check_plain($term->name), l(t('edit container'), "admin/forum/edit/container/$term->tid")); - } - else { - $rows[] = array(_taxonomy_depth($term->depth) .' '. check_plain($term->name), l(t('edit forum'), "admin/forum/edit/forum/$term->tid")); - } - - } - } - else { - $rows[] = array(array('data' => '' . t('There are no existing containers or forums. You may add some on the add container or add forum pages.', array('%container' => url('admin/forum/add/container'), '%forum' => url('admin/forum/add/forum'))) . '', 'colspan' => 2)); - } - return theme('table', $header, $rows); -} - -/** - * Returns a select box for available parent terms - * - * @param $tid ID of the term which is being added or edited - * @param $title Title to display the select box with - * @param $child_type Whether the child is forum or container - */ -function _forum_parent_select($tid, $title, $child_type) { - - $parents = taxonomy_get_parents($tid); - if ($parents) { - $parent = array_shift($parents); - $parent = $parent->tid; - } - else { - $parent = 0; - } - - $children = taxonomy_get_tree(_forum_get_vid(), $tid); - - // A term can't be the child of itself, nor of its children. - foreach ($children as $child) { - $exclude[] = $child->tid; - } - $exclude[] = $tid; - - $tree = taxonomy_get_tree(_forum_get_vid()); - $options[0] = '<'. t('root') .'>'; - if ($tree) { - foreach ($tree as $term) { - if (!in_array($term->tid, $exclude)) { - $options[$term->tid] = _taxonomy_depth($term->depth) . $term->name; - } - } - } - if ($child_type == 'container') { - $description = t('Containers are usually placed at the top (root) level of your forum but you can also place a container inside a parent container or forum.'); - } - else if ($child_type == 'forum') { - $description = t('You may place your forum inside a parent container or forum, or at the top (root) level of your forum.'); - } - - return array('#type' => 'select', '#title' => $title, '#default_value' => $parent, '#options' => $options, '#description' => $description, '#required' => TRUE); -} - -function forum_term_path($term) { - return 'forum/'. $term->tid; -} - -/** - * Returns the vocabulary id for forum navigation. - */ -function _forum_get_vid() { - $vid = variable_get('forum_nav_vocabulary', ''); - if (empty($vid)) { - // Check to see if a forum vocabulary exists - $vid = db_result(db_query("SELECT vid FROM {vocabulary} WHERE module = '%s'", 'forum')); - if (!$vid) { - $edit = array('name' => 'Forums', 'multiple' => 0, 'required' => 1, 'hierarchy' => 1, 'relations' => 0, 'module' => 'forum', 'nodes' => array('forum' => 1)); - taxonomy_save_vocabulary($edit); - $vid = $edit['vid']; - } - variable_set('forum_nav_vocabulary', $vid); - } - - return $vid; -} - -/** - * Formats a topic for display - * - * @TODO Give a better description. Not sure where this function is used yet. - */ -function _forum_format($topic) { - if ($topic && $topic->timestamp) { - return t('%time ago
by %author', array('%time' => format_interval(time() - $topic->timestamp), '%author' => theme('username', $topic))); - } - else { - return message_na(); - } -} - -/** - * Returns a list of all forums for a given taxonomy id - * - * Forum objects contain the following fields - * -num_topics Number of topics in the forum - * -num_posts Total number of posts in all topics - * -last_post Most recent post for the forum - * - * @param $tid - * Taxonomy ID of the vocabulary that holds the forum list. - * @return - * Array of object containing the forum information. - */ -function forum_get_forums($tid = 0) { - - $forums = array(); - $_forums = taxonomy_get_tree(variable_get('forum_nav_vocabulary', ''), $tid); - - if (count($_forums)) { - - $counts = array(); - - $sql = "SELECT r.tid, COUNT(n.nid) AS topic_count, SUM(l.comment_count) AS comment_count FROM {node} n INNER JOIN {node_comment_statistics} l ON n.nid = l.nid INNER JOIN {term_node} r ON n.nid = r.nid WHERE n.status = 1 AND n.type = 'forum' GROUP BY r.tid"; - $sql = db_rewrite_sql($sql); - $_counts = db_query($sql, $forum->tid); - while ($count = db_fetch_object($_counts)) { - $counts[$count->tid] = $count; - } - } - - foreach ($_forums as $forum) { - if (in_array($forum->tid, variable_get('forum_containers', array()))) { - $forum->container = 1; - } - - if ($counts[$forum->tid]) { - $forum->num_topics = $counts[$forum->tid]->topic_count; - $forum->num_posts = $counts[$forum->tid]->topic_count + $counts[$forum->tid]->comment_count; - } - else { - $forum->num_topics = 0; - $forum->num_posts = 0; - } - - // This query does not use full ANSI syntax since MySQL 3.x does not support - // table1 INNER JOIN table2 INNER JOIN table3 ON table2_criteria ON table3_criteria - // used to join node_comment_statistics to users. - $sql = "SELECT ncs.last_comment_timestamp, IF (ncs.last_comment_uid != 0, u2.name, ncs.last_comment_name) AS last_comment_name, ncs.last_comment_uid FROM {node} n INNER JOIN {users} u1 ON n.uid = u1.uid INNER JOIN {term_node} tn ON n.nid = tn.nid INNER JOIN {node_comment_statistics} ncs ON n.nid = ncs.nid INNER JOIN {users} u2 ON ncs.last_comment_uid=u2.uid WHERE n.status = 1 AND tn.tid = %d ORDER BY ncs.last_comment_timestamp DESC"; - $sql = db_rewrite_sql($sql); - $topic = db_fetch_object(db_query_range($sql, $forum->tid, 0, 1)); - - $last_post = new StdClass(); - $last_post->timestamp = $topic->last_comment_timestamp; - $last_post->name = $topic->last_comment_name; - $last_post->uid = $topic->last_comment_uid; - $forum->last_post = $last_post; - - $forums[$forum->tid] = $forum; - } - - return $forums; -} - -/** - * Calculate the number of nodes the user has not yet read and are newer - * than NODE_NEW_LIMIT. - */ -function _forum_topics_unread($term, $uid) { - $sql = "SELECT COUNT(n.nid) FROM {node} n INNER JOIN {term_node} tn ON n.nid = tn.nid AND tn.tid = %d LEFT JOIN {history} h ON n.nid = h.nid AND h.uid = %d WHERE n.status = 1 AND n.type = 'forum' AND n.created > %d AND h.nid IS NULL"; - $sql = db_rewrite_sql($sql); - return db_result(db_query($sql, $term, $uid, NODE_NEW_LIMIT)); -} - -function forum_get_topics($tid, $sortby, $forum_per_page) { - global $user, $forum_topic_list_header; - - $forum_topic_list_header = array( - array('data' => ' '), - array('data' => t('Topic'), 'field' => 'n.title'), - array('data' => t('Replies'), 'field' => 'l.comment_count'), - array('data' => t('Created'), 'field' => 'n.created'), - array('data' => t('Last reply'), 'field' => 'l.last_comment_timestamp'), - ); - - $order = _forum_get_topic_order($sortby); - for ($i = 0; $i < count($forum_topic_list_header); $i++) { - if ($forum_topic_list_header[$i]['field'] == $order['field']) { - $forum_topic_list_header[$i]['sort'] = $order['sort']; - } - } - - $term = taxonomy_get_term($tid); - - $sql = db_rewrite_sql("SELECT n.nid, f.tid, n.title, n.sticky, u.name, u.uid, n.created AS timestamp, n.comment AS comment_mode, l.last_comment_timestamp, IF(l.last_comment_uid != 0, cu.name, l.last_comment_name) AS last_comment_name, l.last_comment_uid, l.comment_count AS num_comments FROM {node_comment_statistics} l, {users} cu, {term_node} r, {users} u, {forum} f, {node} n WHERE n.status = 1 AND l.last_comment_uid = cu.uid AND n.nid = l.nid AND n.nid = r.nid AND r.tid = %d AND n.uid = u.uid AND n.vid = f.vid"); - $sql .= tablesort_sql($forum_topic_list_header, 'n.sticky DESC,'); - $sql .= ', n.created DESC'; // Always add a secondary sort order so that the news forum topics are on top. - - $sql_count = db_rewrite_sql("SELECT COUNT(n.nid) FROM {node} n INNER JOIN {term_node} r ON n.nid = r.nid AND r.tid = %d WHERE n.status = 1 AND n.type = 'forum'"); - - $result = pager_query($sql, $forum_per_page, 0, $sql_count, $tid); - - while ($topic = db_fetch_object($result)) { - if ($user->uid) { - // folder is new if topic is new or there are new comments since last visit - if ($topic->tid != $tid) { - $topic->new = 0; - } - else { - $history = _forum_user_last_visit($topic->nid); - $topic->new_replies = comment_num_new($topic->nid, $history); - $topic->new = $topic->new_replies || ($topic->timestamp > $history); - } - } - else { - // Do not track "new replies" status for topics if the user is anonymous. - $topic->new_replies = 0; - $topic->new = 0; - } - - if ($topic->num_comments > 0) { - $last_reply = new StdClass(); - $last_reply->timestamp = $topic->last_comment_timestamp; - $last_reply->name = $topic->last_comment_name; - $last_reply->uid = $topic->last_comment_uid; - $topic->last_reply = $last_reply; - } - $topics[] = $topic; - } - - return $topics; -} - -/** - * Finds the first unread node for a given forum. - */ -function _forum_new($tid) { - global $user; - - $sql = "SELECT n.nid FROM {node} n LEFT JOIN {history} h ON n.nid = h.nid AND h.uid = %d INNER JOIN {term_node} r ON n.nid = r.nid AND r.tid = %d WHERE n.status = 1 AND n.type = 'forum' AND h.nid IS NULL AND n.created > %d ORDER BY created"; - $sql = db_rewrite_sql($sql); - $nid = db_result(db_query_range($sql, $user->uid, $tid, NODE_NEW_LIMIT, 0, 1)); - - return $nid ? $nid : 0; -} - -/** - * Menu callback; prints a forum listing. - */ -function forum_page($tid = 0) { - if (module_exist('taxonomy') && module_exist('comment')) { - $forum_per_page = variable_get('forum_per_page', 25); - $sortby = variable_get('forum_order', 1); - - $forums = forum_get_forums($tid); - $parents = taxonomy_get_parents_all($tid); - if ($tid && !in_array($tid, variable_get('forum_containers', array()))) { - $topics = forum_get_topics($tid, $sortby, $forum_per_page); - } - - return theme('forum_display', $forums, $topics, $parents, $tid, $sortby, $forum_per_page); - } - else { - drupal_set_message(t('The forum module requires both the taxonomy module and the comment module to be enabled and configured.'), 'error'); - return ' '; - } -} - -/** - * Format the forum body. - * - * @ingroup themeable - */ -function theme_forum_display($forums, $topics, $parents, $tid, $sortby, $forum_per_page) { - global $user; - // forum list, topics list, topic browser and 'add new topic' link - - $vocabulary = taxonomy_get_vocabulary(variable_get('forum_nav_vocabulary', '')); - $title = $vocabulary->name; - - // Breadcrumb navigation: - $breadcrumb = array(); - if ($tid) { - $breadcrumb[] = array('path' => 'forum', 'title' => $title); - } - - if ($parents) { - $parents = array_reverse($parents); - foreach ($parents as $p) { - if ($p->tid == $tid) { - $title = $p->name; - } - else { - $breadcrumb[] = array('path' => 'forum/'. $p->tid, 'title' => $p->name); - } - } - } - - drupal_set_title($title); - - $breadcrumb[] = array('path' => $_GET['q']); - menu_set_location($breadcrumb); - - if (count($forums) || count($parents)) { - $output = ''; - $output .= ''; - } - else { - drupal_set_title(t('No forums defined')); - $output = ''; - } - - return $output; -} - -/** - * Format the forum listing. - * - * @ingroup themeable - */ -function theme_forum_list($forums, $parents, $tid) { - global $user; - - if ($forums) { - - $header = array(t('Forum'), t('Topics'), t('Posts'), t('Last post')); - - foreach ($forums as $forum) { - if ($forum->container) { - $description = '- ';
-
- if (module_exist('tracker')) {
- if ($user->uid) {
- $output .= '
- '. l(t('My discussions.'), "tracker/$user->uid") .' '; - } - - $output .= '
- '. l(t('Active discussions.'), 'tracker') .' '; - } - - if (user_access('create forum topics')) { - $output .= '
- '. l(t('Post new forum topic.'), "node/add/forum/$tid") .' '; - } - else if ($user->uid) { - $output .= '
- '. t('You are not allowed to post a new forum topic.') .' '; - } - else { - $output .= '
- '. t('Login to post a new forum topic.', array('%login' => url('user/login'))) .' '; - } - $output .= '
\n"; - $description .= '\n"; - - $rows[] = array(array('data' => $description, 'class' => 'container', 'colspan' => '4')); - } - else { - $new_topics = _forum_topics_unread($forum->tid, $user->uid); - $forum->old_topics = $forum->num_topics - $new_topics; - if (!$user->uid) { - $new_topics = 0; - } - - $description = ''. l($forum->name, "forum/$forum->tid") ."\n"; - - if ($forum->description) { - $description .= ''. check_plain($forum->description) ."\n"; - } - $description .= "\n"; - $description .= '\n"; - - $rows[] = array( - array('data' => $description, 'class' => 'forum'), - array('data' => $forum->num_topics . ($new_topics ? ''. l($forum->name, "forum/$forum->tid") ."\n"; - - if ($forum->description) { - $description .= ''. check_plain($forum->description) ."\n"; - } - $description .= "
'. l(format_plural($new_topics, '1 new', '%count new'), "forum/$forum->tid", NULL, NULL, 'new') : ''), 'class' => 'topics'), - array('data' => $forum->num_posts, 'class' => 'posts'), - array('data' => _forum_format($forum->last_post), 'class' => 'last-reply')); - } - } - - return theme('table', $header, $rows); - - } - -} - -/** - * Format the topic listing. - * - * @ingroup themeable - */ -function theme_forum_topic_list($tid, $topics, $sortby, $forum_per_page) { - global $forum_topic_list_header; - - if ($topics) { - - foreach ($topics as $topic) { - // folder is new if topic is new or there are new comments since last visit - if ($topic->tid != $tid) { - $rows[] = array( - array('data' => theme('forum_icon', $topic->new, $topic->num_comments, $topic->comment_mode, $topic->sticky), 'class' => 'icon'), - array('data' => check_plain($topic->title), 'class' => 'title'), - array('data' => l(t('This topic has been moved'), "forum/$topic->tid"), 'colspan' => '3') - ); - } - else { - $rows[] = array( - array('data' => theme('forum_icon', $topic->new, $topic->num_comments, $topic->comment_mode, $topic->sticky), 'class' => 'icon'), - array('data' => l($topic->title, "node/$topic->nid"), 'class' => 'topic'), - array('data' => $topic->num_comments . ($topic->new_replies ? '
'. l(format_plural($topic->new_replies, '1 new', '%count new'), "node/$topic->nid", NULL, NULL, 'new') : ''), 'class' => 'replies'), - array('data' => _forum_format($topic), 'class' => 'created'), - array('data' => _forum_format($topic->last_reply), 'class' => 'last-reply') - ); - } - } - } - - $output .= theme('table', $forum_topic_list_header, $rows); - $output .= theme('pager', NULL, $forum_per_page, 0, tablesort_pager()); - - return $output; -} - -/** - * Format the icon for each individual topic. - * - * @ingroup themeable - */ -function theme_forum_icon($new_posts, $num_posts = 0, $comment_mode = 0, $sticky = 0) { - - if ($num_posts > variable_get('forum_hot_topic', 15)) { - $icon = $new_posts ? 'hot-new' : 'hot'; - } - else { - $icon = $new_posts ? 'new' : 'default'; - } - - if ($comment_mode == COMMENT_NODE_READ_ONLY || $comment_mode == COMMENT_NODE_DISABLED) { - $icon = 'closed'; - } - - if ($sticky == 1) { - $icon = 'sticky'; - } - - $output = theme('image', "misc/forum-$icon.png"); - - if ($new_posts) { - $output = "$output"; - } - - return $output; -} - -/** - * Format the next/previous forum topic navigation links. - * - * @ingroup themeable - */ -function theme_forum_topic_navigation($node) { - $output = ''; - - // get previous and next topic - $sql = "SELECT n.nid, n.title, n.sticky, l.comment_count, l.last_comment_timestamp FROM {node} n INNER JOIN {node_comment_statistics} l ON n.nid = l.nid INNER JOIN {term_node} r ON n.nid = r.nid AND r.tid = %d WHERE n.status = 1 AND n.type = 'forum' ORDER BY n.sticky DESC, ". _forum_get_topic_order_sql(variable_get('forum_order', 1)); - $result = db_query(db_rewrite_sql($sql), $node->tid); - - while ($topic = db_fetch_object($result)) { - if ($stop == 1) { - $next = new StdClass(); - $next->nid = $topic->nid; - $next->title = $topic->title; - break; - } - if ($topic->nid == $node->nid) { - $stop = 1; - } - else { - $prev = new StdClass(); - $prev->nid = $topic->nid; - $prev->title = $topic->title; - } - } - - if ($prev || $next) { - $output .= ''; - } - - return $output; -} - -function _forum_user_last_visit($nid) { - global $user; - static $history = array(); - - if (empty($history)) { - $result = db_query('SELECT nid, timestamp FROM {history} WHERE uid = %d', $user->uid); - while ($t = db_fetch_object($result)) { - $history[$t->nid] = $t->timestamp > NODE_NEW_LIMIT ? $t->timestamp : NODE_NEW_LIMIT; - } - } - return $history[$nid] ? $history[$nid] : NODE_NEW_LIMIT; -} - -function _forum_get_topic_order($sortby) { - switch ($sortby) { - case 1: - return array('field' => 'l.last_comment_timestamp', 'sort' => 'desc'); - break; - case 2: - return array('field' => 'l.last_comment_timestamp', 'sort' => 'asc'); - break; - case 3: - return array('field' => 'l.comment_count', 'sort' => 'desc'); - break; - case 4: - return array('field' => 'l.comment_count', 'sort' => 'asc'); - break; - } -} - -function _forum_get_topic_order_sql($sortby) { - $order = _forum_get_topic_order($sortby); - return $order['field'] .' '. $order['sort']; -} - - diff --git a/modules/help/help.module b/modules/help/help.module deleted file mode 100644 index 4f52411a68843c6efdcd41c0660ec1cf88d82ae8..0000000000000000000000000000000000000000 --- a/modules/help/help.module +++ /dev/null @@ -1,135 +0,0 @@ - 'admin/help', 'title' => t('help'), - 'callback' => 'help_main', - 'access' => $admin_access, - 'weight' => 9); - - foreach (module_implements('help', TRUE) as $module) { - $items[] = array('path' => 'admin/help/' . $module, - 'title' => t($module), - 'callback' => 'help_page', - 'type' => MENU_CALLBACK, - 'access' => $admin_access); - } - } - - return $items; -} - -/** - * Menu callback; prints a page listing a glossary of Drupal terminology. - */ -function help_main() { - $output = t(" -Help topics
-Help is available on the following items:
- %help_pages -Glossary of Drupal terminology
--
-
- Block
- A small box containing information or content placed in the left-hand or right-hand sidebar of a web page. -
- Comment
- A note attached to a node. Usually intended to clarify, explain, criticize, or express an opinion on the original material. -
- Moderation -
- The activity of making sure a post to a Drupal site fits in with what is expected for that Drupal site.
-
-
-
- Approved
- A moderated post which has been accepted by the moderators for publication. (See published). -
- Waiting
- A moderated post which is still being voted on to be accepted for publication. (See published.) -
- - Node
- The basic data unit in Drupal. Everything is a node or an extension of a node. -
- Public
- See published. -
- Published
- A node that is viewable by everyone. (See unpublished.) -
- Role
- A classification users are placed into for the purpose of setting users' permissions. -
- Taxonomy
- A division of a collection of things into ordered, classified groups. (See taxonomy help.) -
- Unpublished
- A node that is only viewable by administrators and moderators. -
- User
- A person who has an account at your Drupal site, and is logged in with that account. -
- Visitor
- A person who does not have an account at your Drupal site or a person who has an account at your Drupal site but is not logged in with that account. Also termed \"anonymous user\". -
- ';
- foreach ($modules as $i => $module) {
- $output .= '
- '. l(t($module), 'admin/help/'. $module) .' '; - if (($i + 1) % $break == 0) { - $output .= '
- ';
- }
- }
- $output .= '
'; - - return $output; -} - -/** - * Implementation of hook_help(). - */ -function help_help($section) { - switch ($section) { - case 'admin/help': - $output = t('This guide explains what the various modules in Drupal do and how to configure them.
-It is not a substitute for the Drupal handbook available online and should be used in conjunction with it. The online reference handbook might be more up-to-date and has helpful user-contributed comments. It is your definitive reference point for all Drupal documentation.
-', array('%Drupal' => 'http://drupal.org', '%handbook' => 'http://drupal.org/handbook')); - return $output; - case 'admin/help#help': - $output = ''. t('The help module displays context sensitive help information. Users can learn how to use modules and accomplish tasks quicker with less errors by clicking on links in provided by the help module.') .'
'; - $output .= t('Modules can make documentation available to other modules with this module. All user help should be presented using this module. Some examples of help:
--
-
- The name of a module (unused, but there). -
- The description found on the admin/system/modules page. -
- The module\'s help text, displayed on the admin/help page and through the module\'s individual help link. -
- The help for a distributed authorization module (if applicable). -
- The description of a post type (if applicable). -
'. t('You can not administer the help system.') .'
'; - $output .= ''. t('For more information please read the configuration and customization handbook Help page.', array('%help' => 'http://drupal.org/handbook/modules/help/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Manages the display of online help.'); - } -} - -/** - * Menu callback; prints a page listing general help for all modules. - */ -function help_page() { - $name = arg(2); - $output = ''; - if (module_hook($name, 'help')) { - $temp = module_invoke($name, 'help', "admin/help#$name"); - if (empty($temp)) { - $output .= t("No help is available for module %module.", array('%module' => $name)); - } - else { - $output .= $temp; - } - } - return $output; -} diff --git a/modules/legacy/legacy.module b/modules/legacy/legacy.module deleted file mode 100644 index f03db2eb193ec0d2385266eeab7f620307bb1ba1..0000000000000000000000000000000000000000 --- a/modules/legacy/legacy.module +++ /dev/null @@ -1,202 +0,0 @@ -'. t('The legacy module provides legacy handlers for upgrades from older installations. These handlers help automatically redirect references to pages from old installations and prevent page not found errors for your site.') .''; - $output .= ''. t('The legacy module handles legacy style taxonomy page, taxonomy feed, and blog feed paths. It also handles URL upgrades from Drupal 4.1. It rewrites old-style URLs to new-style URLs (clean URLs). ') .'
'; - $output .= t('Example Mappings:
--
-
- taxonomy/page/or/52,97 to taxonomy/term/52+97. -
- taxonomy/feed/or/52,97 to taxonomy/term/52+97/0/feed. -
- blog/feed/52 to blog/52/feed. -
- node/view/52 to node/52. -
- book/view/52 to node/52. -
- user/view/52 to user/52. -
'. t('Legacy module has no configurable options.') .'
'; - $output .= ''. t('For more information please read the configuration and customization handbook Legacy page.', array('%legacy' => 'http://drupal.org/handbook/modules/legacy/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Provides legacy handlers for upgrades from older Drupal installations.'); - } -} - -/** - * Implementation of hook_menu(). - * - * Registers menu paths used in earlier Drupal versions. - */ -function legacy_menu($may_cache) { - $items = array(); - - if ($may_cache) { - // Map "taxonomy/page/or/52,97" to "taxonomy/term/52+97". - $items[] = array('path' => 'taxonomy/page', 'title' => t('taxonomy'), - 'callback' => 'legacy_taxonomy_page', - 'access' => TRUE, 'type' => MENU_CALLBACK); - - // Map "taxonomy/feed/or/52,97" to "taxonomy/term/52+97/0/feed". - $items[] = array('path' => 'taxonomy/feed', 'title' => t('taxonomy'), - 'callback' => 'legacy_taxonomy_feed', - 'access' => TRUE, 'type' => MENU_CALLBACK); - - // Map "blog/feed/52" to "blog/52/feed". - $items[] = array('path' => 'blog/feed', 'title' => t('blog'), - 'callback' => 'legacy_blog_feed', - 'access' => TRUE, 'type' => MENU_CALLBACK); - } - else { - // Map "node/view/52" to "node/52". - $items[] = array('path' => 'node/view', 'title' => t('view'), - 'callback' => 'drupal_goto', - 'callback arguments' => array('node/'. arg(2), NULL, NULL), - 'access' => TRUE, 'type' => MENU_CALLBACK); - - // Map "book/view/52" to "node/52". - $items[] = array('path' => 'book/view', 'title' => t('view'), - 'callback' => 'drupal_goto', - 'callback arguments' => array('node/'. arg(2), NULL, NULL), - 'access' => TRUE, 'type' => MENU_CALLBACK); - - // Map "user/view/52" to "user/52". - $items[] = array('path' => 'user/view', 'title' => t('view'), - 'callback' => 'drupal_goto', - 'callback arguments' => array('user/'. arg(2), NULL, NULL), - 'access' => TRUE, 'type' => MENU_CALLBACK); - } - - return $items; -} - -/** - * Menu callback; redirects users to new taxonomy page paths. - */ -function legacy_taxonomy_page($operation = 'or', $str_tids = '') { - if ($operation == 'or') { - $str_tids = str_replace(',', '+', $str_tids); - } - drupal_goto('taxonomy/term/'. $str_tids); -} - -/** - * Menu callback; redirects users to new taxonomy feed paths. - */ -function legacy_taxonomy_feed($operation = 'or', $str_tids = '') { - if ($operation == 'or') { - $str_tids = str_replace(',', '+', $str_tids); - } - drupal_goto('taxonomy/term/'. $str_tids .'/0/feed'); -} - -/** - * Menu callback; redirects users to new blog feed paths. - */ -function legacy_blog_feed($str_uid = '') { - // if URL is of form blog/feed/52 redirect - // if URL is of form blog/feed we have to call blog_feed_last(). - if (is_numeric($str_uid)) { - drupal_goto('blog/'. $str_uid .'/feed'); - } - else { - module_invoke('blog', 'feed_last'); - } -} - -/** - * Implementation of hook_filter(). Handles URL upgrades from Drupal 4.1. - */ -function legacy_filter($op, $delta = 0, $format = -1, $text = '') { - switch ($op) { - case 'list': - return array(t('Legacy filter')); - - case 'description': - return t('Replaces URLs from Drupal 4.1 (and lower) with updated equivalents.'); - - case 'process': - return _legacy_filter_old_urls($text, $format); - - case 'settings': - return; - - default: - return $text; - } -} - -/** - * Rewrite legacy URLs. - * - * This is a *temporary* filter to rewrite old-style URLs to new-style - * URLs (clean URLs). Currently, URLs are being rewritten dynamically - * (ie. "on output"), however when these rewrite rules have been tested - * enough, we will use them to permanently rewrite the links in node - * and comment bodies. - */ -function _legacy_filter_old_urls($text) { - if (!variable_get('rewrite_old_urls', 0)) { - return $text; - } - - global $base_url; - - $end = substr($base_url, 12); - - if (variable_get('clean_url', '0') == '0') { - // Relative URLs: - - // rewrite 'node.php?id=[&cid= ]' style URLs: - $text = eregi_replace("\"(node)\.php\?id=([[:digit:]]+)(&cid=)?([[:digit:]]*)", "\"?q=\\1/view/\\2/\\4", $text); - - // rewrite 'module.php?mod= {& = }' style URLs: - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "\"?q=\\2/\\4/\\6" , $text); - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "\"?q=\\2/\\4", $text); - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))", "\"?q=\\2", $text); - - // Absolute URLs: - - // rewrite 'node.php?id= [&cid= ]' style URLs: - $text = eregi_replace("$end/(node)\.php\?id=([[:digit:]]+)(&cid=)?([[:digit:]]*)", "$end/?q=\\1/view/\\2/\\4", $text); - - // rewrite 'module.php?mod= {& = }' style URLs: - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "$end/?q=\\2/\\4/\\6" , $text); - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "$end/?q=\\2/\\4", $text); - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))", "\"$end/?q=\\2", $text); - } - else { - // Relative URLs: - - // Rewrite 'node.php?id= [&cid= ]' style URLs: - $text = eregi_replace("\"(node)\.php\?id=([[:digit:]]+)(&cid=)?([[:digit:]]*)", "\"\\1/view/\\2/\\4", $text); - - // Rewrite 'module.php?mod= {& = }' style URLs: - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "\"\\2/\\4/\\6", $text); - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "\"\\2/\\4", $text); - $text = ereg_replace("\"module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))", "\"\\2", $text); - - // Absolute URLs: - - // Rewrite 'node.php?id= [&cid= ]' style URLs: - $text = eregi_replace("$end/(node)\.php\?id=([[:digit:]]+)(&cid=)?([[:digit:]]*)", "$end/\\1/view/\\2/\\4", $text); - - // Rewrite 'module.php?mod= {& = }' style URLs: - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "$end/\\2/\\4/\\6", $text); - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))(&?[[:alpha:]]+=([[:alnum:]]+))", "$end/\\2/\\4", $text); - $text = ereg_replace("$end/module\.php\?(&?[[:alpha:]]+=([[:alnum:]]+))", "$end/\\2", $text); - } - - return $text; -} - - diff --git a/modules/locale/locale.module b/modules/locale/locale.module deleted file mode 100644 index e124f98d26d03173abb10c15b63aeb6de26a76ad..0000000000000000000000000000000000000000 --- a/modules/locale/locale.module +++ /dev/null @@ -1,417 +0,0 @@ -'. t('The locale module allows you to present your Drupal site in a language other than the default English. You can use it to set up a multi-lingual web site or replace given built-in text with text which has been customized for your site. Whenever the locale module encounters text which needs to be displayed, it tries to translate it into the currently selected language. If a translation is not available, then the string is remembered, so you can look up untranslated strings easily.') .''; - $output .= ' '. t('The locale module provides two options for providing translations. The first is the integrated web interface, via which you can search for untranslated strings, and specify their translations. An easier and less time-consuming method is to import existing translations for your language. These translations are available as GNU gettext Portable Object files (.po files for short). Translations for many languages are available for download from the translation page.') .'
'; - $output .= ''. t('If an existing translation does not meet your needs, the .po files are easily edited with special editing tools. The locale module\'s import feature allows you to add strings from such files into your site\'s database. The export functionality enables you to share your translations with others, generating Portable Object files from your site strings.') .'
'; - $output .= t('You can
--
-
- administer localization at administer >> localization. -
- manage strings for the localization: administer >> localization >> manage strings. -
- add a locale language: administer >> localization >> add language. -
- download translation files from the Drupal translations page. - -
'. t('For more information please read the configuration and customization handbook Locale page.', array('%locale' => 'http://drupal.org/handbook/modules/locale/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables the translation of the user interface to languages other than English.'); - case 'admin/locale': - case 'admin/locale/language/overview': - return t("Drupal provides support for the translation of its interface text into different languages. This page provides an overview of the installed languages. You can add a language on the add language page, or directly by importing a translation. If multiple languages are enabled, registered users will be able to set their preferred language. The site default will be used for anonymous visitors and for users without their own settings.
Drupal interface translations may be added or extended by several courses: by importing an existing translation, by translating everything from scratch, or by a combination of these approaches.
", array("%search" => url("admin/locale/string/search"), "%import" => url("admin/locale/language/import"), "%add-language" => url("admin/locale/language/add"))); - case 'admin/locale/language/add': - return t("You need to add all languages in which you would like to display the site interface. If you can't find the desired language in the quick-add dropdown, then you will need to provide the proper language code yourself. The language code may be used to negotiate with browsers and to present flags, etc., so it is important to pick a code that is standardised for the desired language. You can also add a language by importing a translation.
", array("%import" => url("admin/locale/language/import"))); - case 'admin/locale/language/import': - return t("This page allows you to import a translation provided in the gettext Portable Object (.po) format. The easiest way to get your site translated is to obtain an existing Drupal translation and to import it. You can find existing translations on the Drupal translation page. Note that importing a translation file might take a while.
", array('%url' => 'http://drupal.org/project/translations')); - case 'admin/locale/language/export': - return t("This page allows you to export Drupal strings. The first option is to export a translation so it can be shared. The second option generates a translation template, which contains all Drupal strings, but without their translations. You can use this template to start a new translation using various software packages designed for this task.
"); - case 'admin/locale/string/search': - return t("It is often convenient to get the strings from your setup on the export page, and use a desktop Gettext translation editor to edit the translations. On this page you can search in the translated and untranslated strings, and the default English texts provided by Drupal.
", array("%export" => url("admin/locale/language/export"))); - } -} - -/** - * Implementation of hook_menu(). - */ -function locale_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $access = user_access('administer locales'); - - // Main admin menu item - $items[] = array('path' => 'admin/locale', - 'title' => t('localization'), - 'callback' => 'locale_admin_manage', - 'access' => $access); - - // Top level tabs - $items[] = array('path' => 'admin/locale/language', - 'title' => t('manage languages'), - 'access' => $access, - 'weight' => -10, - 'type' => MENU_DEFAULT_LOCAL_TASK); - $items[] = array('path' => 'admin/locale/string/search', - 'title' => t('manage strings'), - 'callback' => 'locale_string_search', - 'access' => $access, - 'weight' => 10, - 'type' => MENU_LOCAL_TASK); - - // Manage languages subtabs - $items[] = array('path' => 'admin/locale/language/overview', - 'title' => t('list'), - 'callback' => 'locale_admin_manage', - 'access' => $access, - 'weight' => 0, - 'type' => MENU_DEFAULT_LOCAL_TASK); - $items[] = array('path' => 'admin/locale/language/add', - 'title' => t('add language'), - 'callback' => 'locale_admin_manage_add', - 'access' => $access, - 'weight' => 5, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/locale/language/import', - 'title' => t('import'), - 'callback' => 'locale_admin_import', - 'access' => $access, - 'weight' => 10, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/locale/language/export', - 'title' => t('export'), - 'callback' => 'locale_admin_export', - 'access' => $access, - 'weight' => 20, - 'type' => MENU_LOCAL_TASK); - - // Language related callbacks - $items[] = array('path' => 'admin/locale/language/delete', - 'title' => t('confirm'), - 'callback' => 'locale_admin_manage_delete_form', - 'access' => $access, - 'type' => MENU_CALLBACK); - } - else { - if (is_numeric(arg(4))) { - // String related callbacks - $items[] = array('path' => 'admin/locale/string/edit/'. arg(4), - 'title' => t('edit string'), - 'callback' => 'locale_admin_string_edit', - 'callback arguments' => arg(4), - 'access' => $access, - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/locale/string/delete/'. arg(4), - 'title' => t('delete string'), - 'callback' => 'locale_admin_string_delete', - 'callback arguments' => arg(4), - 'access' => $access, - 'type' => MENU_CALLBACK); - } - } - - return $items; -} - -/** - * Implementation of hook_perm(). - */ -function locale_perm() { - return array('administer locales'); -} - -/** - * Implementation of hook_user(). - */ -function locale_user($type, $edit, &$user, $category = NULL) { - $languages = locale_supported_languages(); - if ($type == 'form' && $category == 'account' && count($languages['name']) > 1) { - if ($user->language == '') { - $user->language = key($languages['name']); - } - $languages['name'] = array_map('check_plain', $languages['name']); - $form['locale'] = array('#type' => 'fieldset', - '#title' => t('Interface language settings'), - '#weight' => 1, - ); - $form['locale']['language'] = array('#type' => 'radios', - '#title' => t('Language'), - '#default_value' => $user->language, - '#options' => $languages['name'], - '#description' => t('Selecting a different locale will change the interface language of the site.'), - ); - return $form; - } -} - -// --------------------------------------------------------------------------------- -// Locale core functionality (needed on all page loads) - -/** - * Provides interface translation services. - * - * This function is called from t() to translate a string if needed. - */ -function locale($string) { - global $locale; - static $locale_t; - - // Store database cached translations in a static var. - if (!isset($locale_t)) { - $cache = cache_get("locale:$locale"); - - if ($cache == 0) { - locale_refresh_cache(); - $cache = cache_get("locale:$locale"); - } - $locale_t = unserialize($cache->data); - } - - // We have the translation cached (if it is TRUE, then there is no - // translation, so there is no point in checking the database) - if (isset($locale_t[$string])) { - $string = ($locale_t[$string] === TRUE ? $string : $locale_t[$string]); - } - - // We do not have this translation cached, so get it from the DB. - else { - $result = db_query("SELECT s.lid, t.translation FROM {locales_source} s INNER JOIN {locales_target} t ON s.lid = t.lid WHERE s.source = '%s' AND t.locale = '%s'", $string, $locale); - // Translation found - if ($trans = db_fetch_object($result)) { - if (!empty($trans->translation)) { - $locale_t[$string] = $trans->translation; - $string = $trans->translation; - } - } - - // Either we have no such source string, or no translation - else { - $result = db_query("SELECT lid, source FROM {locales_source} WHERE source = '%s'", $string); - // We have no such translation - if ($obj = db_fetch_object($result)) { - if ($locale) { - db_query("INSERT INTO {locales_target} (lid, locale, translation) VALUES (%d, '%s', '')", $obj->lid, $locale); - } - } - // We have no such source string - else { - db_query("INSERT INTO {locales_source} (location, source) VALUES ('%s', '%s')", request_uri(), $string); - if ($locale) { - $lid = db_fetch_object(db_query("SELECT lid FROM {locales_source} WHERE source = '%s'", $string)); - db_query("INSERT INTO {locales_target} (lid, locale, translation) VALUES (%d, '%s', '')", $lid->lid, $locale); - } - } - // Clear locale cache in DB - cache_clear_all("locale:$locale"); - } - } - - return $string; -} - -/** - * Refreshes database stored cache of translations. - * - * We only store short strings to improve performance and consume less memory. - */ -function locale_refresh_cache() { - $languages = locale_supported_languages(); - - foreach (array_keys($languages['name']) as $locale) { - $result = db_query("SELECT s.source, t.translation, t.locale FROM {locales_source} s INNER JOIN {locales_target} t ON s.lid = t.lid WHERE t.locale = '%s' AND LENGTH(s.source) < 75", $locale); - $t = array(); - while ($data = db_fetch_object($result)) { - $t[$data->source] = (empty($data->translation) ? TRUE : $data->translation); - } - cache_set("locale:$locale", serialize($t)); - } -} - -/** - * Returns list of languages supported on this site. - * - * @param $reset Refresh cached language list. - * @param $getall Return all languages (even disabled ones) - */ -function locale_supported_languages($reset = FALSE, $getall = FALSE) { - static $enabled = NULL; - static $all = NULL; - - if ($reset) { - unset($enabled); unset($all); - } - - if (is_null($enabled)) { - $enabled = $all = array(); - $all['name'] = $all['formula'] = $enabled['name'] = $enabled['formula'] = array(); - $result = db_query('SELECT locale, name, formula, enabled FROM {locales_meta} ORDER BY isdefault DESC, enabled DESC, name ASC'); - while ($row = db_fetch_object($result)) { - $all['name'][$row->locale] = $row->name; - $all['formula'][$row->locale] = $row->formula; - if ($row->enabled) { - $enabled['name'][$row->locale] = $row->name; - $enabled['formula'][$row->locale] = $row->formula; - } - } - } - return $getall ? $all : $enabled; -} - -/** - * Returns plural form index for a specific number. - * - * The index is computed from the formula of this language. - */ -function locale_get_plural($count) { - global $locale; - static $locale_formula, $plurals = array(); - - if (!isset($plurals[$count])) { - if (!isset($locale_formula)) { - $languages = locale_supported_languages(); - $locale_formula = $languages['formula'][$locale]; - } - if ($locale_formula) { - $n = $count; - $plurals[$count] = @eval("return intval($locale_formula);"); - return $plurals[$count]; - } - else { - $plurals[$count] = -1; - return -1; - } - } - return $plurals[$count]; -} - -// --------------------------------------------------------------------------------- -// Language management functionality (administration only) - -/** - * Page handler for the language management screen. - */ -function locale_admin_manage() { - include_once './includes/locale.inc'; - return _locale_admin_manage_screen(); -} - -/** - * User interface for the language deletion confirmation screen. - */ -function locale_admin_manage_delete_form() { - include_once './includes/locale.inc'; - $langcode = arg(4); - - // Do not allow deletion of English locale. - if ($langcode == 'en') { - drupal_set_message(t('The English locale cannot be deleted.')); - drupal_goto('admin/locale/language/overview'); - } - - // For other locales, warn user that data loss is ahead. - $languages = locale_supported_languages(FALSE, TRUE); - - if (!isset($languages['name'][$langcode])) { - drupal_not_found(); - } - else { - $form['langcode'] = array('#type' => 'value', '#value' => $langcode); - return confirm_form('locale_admin_manage_delete_form', $form, t('Are you sure you want to delete the language %name?', array('%name' => theme('placeholder', t($languages['name'][$langcode])))), 'admin/locale/language/overview', t('Deleting a language will remove all data associated with it. This action cannot be undone.'), t('Delete'), t('Cancel')); - } -} - -/** - * Process language deletion submissions. - */ -function locale_admin_manage_delete_form_submit($form_id, $form_values) { - $languages = locale_supported_languages(FALSE, TRUE); - if (isset($languages['name'][$form_values['langcode']])) { - db_query("DELETE FROM {locales_meta} WHERE locale = '%s'", $form_values['langcode']); - db_query("DELETE FROM {locales_target} WHERE locale = '%s'", $form_values['langcode']); - $message = t('The language %locale has been removed.', array('%locale' => theme('placeholder', t($languages['name'][$form_values['langcode']])))); - drupal_set_message($message); - watchdog('locale', $message); - } - - // Changing the locale settings impacts the interface: - cache_clear_all(); - - return 'admin/locale/language/overview'; -} - -/** - * Page handler for the language addition screen - */ -function locale_admin_manage_add() { - include_once './includes/locale.inc'; - return _locale_admin_manage_add_screen(); -} - -// --------------------------------------------------------------------------------- -// Gettext Portable Object import functionality (administration only) - -/** - * Page handler for the translation import screen - */ -function locale_admin_import() { - include_once './includes/locale.inc'; - return _locale_admin_import_screen(); -} - -// --------------------------------------------------------------------------------- -// Gettext Portable Object export functionality (administration only) - -/** - * Page handler for the translation export screen - */ -function locale_admin_export() { - include_once './includes/locale.inc'; - return _locale_admin_export_screen(); -} - -// --------------------------------------------------------------------------------- -// String search and editing functionality (administration only) - -/** - * Page handler for the string search. - */ -function locale_string_search() { - include_once './includes/locale.inc'; - $output = _locale_string_seek(); - $output .= _locale_string_seek_form(); - return $output; -} - -/** - * Display the string edit form. - */ -function locale_admin_string_edit($lid) { - include_once './includes/locale.inc'; - return _locale_string_edit($lid); -} - -/** - * Delete a string. - */ -function locale_admin_string_delete($lid) { - include_once './includes/locale.inc'; - _locale_string_delete($lid); -} diff --git a/modules/menu/menu.module b/modules/menu/menu.module deleted file mode 100644 index e176e7faaa478cf9aeaeeccf3b9aa433ba6d229d..0000000000000000000000000000000000000000 --- a/modules/menu/menu.module +++ /dev/null @@ -1,763 +0,0 @@ -The menu module allows for customization of the menus. Menus are useful for providing navigation in your site. The main menu for navigation is called the "navigation" menu. Menus appear in blocks on your site. -There is a special case for the display of "primary links" and "secondary links" (which are implemented as menus). These are sets of links which are usually displayed in the header of each page (depending on the currently active theme). Any menu can serve as the primary or secondary links, by modifying the settings for the menu module.
--
-
- On the administer menu page administrators can "edit" to change the title, description, parent or weight of the menu item. Under the "operations" column, click on "enable/disable" to toggle the menu item on or off. Menu items which are disabled are not deleted; they are merely not available for navigating the site in the sidebar menu block. Note that the default menu items generated by the menu module cannot be deleted, only disabled. -
- Using the "add menu" tab submit a title for a new custom menu. Once submitted, the new menu will appear in a list toward the bottom of the administer menu page underneath the main navigation menu. -
- Use the "add menu item" tab to create new links in either the navigation or a custom menu. Select the parent item to place the new link within an existing menu structure. For top level menu items, choose the name of the menu in which the link is to be added. This tab is also the way to define primary or secondary links for your site (by adding items to whatever menu is selected as your primary links menu). -
You can
--
-
- administer menus at administer >> menus. -
- turn menus blocks on and off in the administer >> blocks. -
- add a menu at administer >> menus >> add menu. -
- add a menu item at administer >> menus >> add menu item. -
- modify menu settings (in particular, to specify a menu to use for primary or secondary links) at administer >> settings >> menus. -
'. t('For more information please read the configuration and customization handbook Menu page.', array('%menu' => 'http://drupal.org/handbook/modules/menu/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows administrators to customize the site navigation menu.'); - case 'admin/menu': - return t('Select an operation from the list to move, change, or delete a menu item.
'); - case 'admin/menu/menu/add': - return t('Enter the name for your new menu. Remember to enable the newly created block in the blocks administration page.
', array('%blocks' => url('admin/block'))); - case 'admin/menu/item/add': - return t('Enter the title, path, position and the weight for your new menu item.
'); - case 'admin/settings/menu': - return t('Customize the menu settings.
'); - } -} - -/** - * Implementation of hook_menu(). - */ -function menu_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/menu', - 'title' => t('menus'), - 'callback' => 'menu_overview', - 'access' => user_access('administer menu')); - $items[] = array('path' => 'admin/menu/list', - 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'weight' => -10); - - $items[] = array('path' => 'admin/menu/item/add', - 'title' => t('add menu item'), - 'callback' => 'menu_edit_item_form', - 'access' => user_access('administer menu'), - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/menu/item/edit', - 'title' => t('edit menu item'), - 'callback' => 'menu_edit_item_form', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/menu/item/reset', - 'title' => t('reset menu item'), - 'callback' => 'menu_reset_item', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/menu/item/disable', - 'title' => t('disable menu item'), - 'callback' => 'menu_disable_item', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/menu/item/delete', - 'title' => t('delete menu item'), - 'callback' => 'menu_item_delete_form', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'admin/menu/menu/add', - 'title' => t('add menu'), - 'callback' => 'menu_edit_menu_form', - 'access' => user_access('administer menu'), - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/menu/menu/edit', - 'title' => t('edit menu'), - 'callback' => 'menu_edit_menu_form', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/menu/menu/delete', - 'title' => t('delete menu'), - 'callback' => 'menu_item_delete_form', - 'access' => user_access('administer menu'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'admin/settings/menu', - 'title' => t('menus'), - 'callback' => 'menu_configure'); - } - - return $items; -} - -/** - * Implementation of hook_block(). - */ -function menu_block($op = 'list', $delta = 0) { - if ($op == 'list') { - $blocks = array(); - $root_menus = menu_get_root_menus(); - foreach ($root_menus as $mid => $title) { - // Default "Navigation" block is handled by user.module. - if ($mid != 1) { - $blocks[$mid]['info'] = $title; - } - } - return $blocks; - } - else if ($op == 'view') { - $item = menu_get_item($delta); - $data['subject'] = $item['title']; - $data['content'] = theme('menu_tree', $delta); - return $data; - } -} - -/** - * Implementation of hook_nodeapi(). - */ -function menu_nodeapi(&$node, $op) { - - if (user_access('administer menu')) { - switch ($op) { - case 'insert': - case 'update': - if ($node->menu['delete']) { - menu_node_form_delete($node); - menu_rebuild(); - } - elseif ($node->menu['title']) { - $node->menu['path'] = ($node->menu['path']) ? $node->menu['path'] : "node/$node->nid"; - menu_edit_item_save($node->menu); - menu_rebuild(); - } - break; - - case 'delete': - menu_node_form_delete($node); - menu_rebuild(); - break; - } - } -} - -/** - * Implementation of hook_perm(). - */ -function menu_perm() { - return array('administer menu'); -} - -/** - * Implementation of hook_form_alter(). - * Add menu item fields to the node form. - */ -function menu_form_alter($form_id, &$form) { - if (user_access('administer menu') && isset($form['type']) && $form['type']['#value'] .'_node_form' == $form_id) { - $edit = isset($_POST['edit']) ? $_POST['edit'] : ''; - $edit['nid'] = $form['nid']['#value']; - - $item = array(); - if ($edit['nid'] > 0) { - $item = db_fetch_array(db_query("SELECT * FROM {menu} WHERE path = 'node/%d'", $edit['nid'])); - if (is_array($edit['menu'])) { - $item = !is_array($item) ? $edit['menu'] : (($_POST['op'] == t('Preview')) ? array_merge($item, $edit['menu']) : array_merge($edit['menu'], $item)); - } - } - - $form['menu'] = array('#type' => 'fieldset', - '#title' => t('Menu settings'), - '#collapsible' => TRUE, - '#collapsed' => empty($item['title']), - '#tree' => TRUE, - '#weight' => 30, - ); - - $form['menu']['title'] = array('#type' => 'textfield', - '#title' => t('Title'), - '#default_value' => $item['title'], - '#description' => t('The name to display for this link.'), - ); - - $form['menu']['description'] = array('#type' => 'textfield', - '#title' => t('Description'), - '#default_value' => $item['description'], - '#description' => t('The description displayed when hovering over a menu item.'), - ); - - // Generate a list of possible parents. - $options = menu_parent_options($item['mid'], variable_get('menu_parent_items', 0)); - - $form['menu']['pid'] = array('#type' => 'select', - '#title' => t('Parent item'), - '#default_value' => $item['pid'], - '#options' => $options, - ); - - $form['menu']['path'] = array('#type' => 'hidden', - '#value' => $item['path'], - ); - - $form['menu']['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $item['weight'], - '#delta' => 10, - '#description' => t('Optional. In the menu, the heavier items will sink and the lighter items will be positioned nearer the top.'), - ); - - $form['menu']['mid'] = array('#type' => 'hidden', - '#value' => $item['mid'] ? $item['mid'] : 0, - ); - - $form['menu']['type'] = array('#type' => 'hidden', - '#value' => $item['type'] ? $item['type'] : MENU_CUSTOM_ITEM, - ); - - if ($item['mid'] > 0) { - $form['menu']['delete'] = array('#type' => 'checkbox', - '#title' => t('Check to delete this menu item.'), - '#default_value' => $item['delete'], - ); - - $form['menu']['advanced'] = array('#type' => 'item', - '#value' => t('You may also edit the advanced settings for this menu item.', array('%edit' => url("admin/menu/item/edit/{$item['mid']}"))), - ); - } - } -} - -/** - * Menu callback; presents menu configuration options. - */ -function menu_configure() { - $menu = menu_get_menu(); - $root_menus = menu_get_root_menus(); - - $primary_options = $root_menus; - $primary_options[0] = t('No primary links'); - - $form['settings_links'] = array('#type' => 'fieldset', - '#title' => t('Primary and secondary links settings'), - ); - - $form['settings_links']['intro'] = array('#type' => 'item', - '#value' => t('Primary and secondary links provide a navigational menu system which usually (depending on your theme) appears at the top-right of the browser window. The links displayed can be generated either from a custom list created via the menu administration page or from a built-in list of menu items such as the navigation menu links.', array('%menu' => url('admin/menu'))), - ); - - $form['settings_links']['menu_primary_menu'] = array('#type' => 'select', - '#title' => t('Menu containing primary links'), - '#default_value' => variable_get('menu_primary_menu', 0), - '#options' => $primary_options, - ); - - $secondary_options = $root_menus; - $secondary_options[0] = t('No secondary links'); - - $form['settings_links']['menu_secondary_menu'] = array('#type' => 'select', - '#title' => t('Menu containing secondary links'), - '#default_value' => variable_get('menu_secondary_menu', 0), - '#options' => $secondary_options, - '#description' => t('If you select the same menu as primary links then secondary links will display the appropriate second level of your navigation hierarchy.'), - ); - - $form['settings_authoring'] = array('#type' => 'fieldset', - '#title' => t('Post authoring form settings'), - ); - - $form['settings_authoring']['intro'] = array('#type' => 'item', - '#value' => t('The menu module allows on-the-fly creation of menu links in the post authoring forms. The following option limits the menus in which a new link may be added. For e.g. this can be used to force new menu items to be created in the primary links menu or to hide admin menu items.'), - ); - - $authoring_options = $root_menus; - $authoring_options[0] = t('Show all menus'); - - $form['settings_authoring']['menu_parent_items'] = array('#type' => 'select', - '#title' => t('Restrict parent items to'), - '#default_value' => variable_get('menu_parent_items', 0), - '#options' => $authoring_options, - '#description' => t('Choose the menu to be made available in the post authoring form. Only this menu item and its children will be shown.'), - ); - - return system_settings_form('menu_configure', $form); -} - -/** - * Menu callback; handle the adding/editing of a new menu. - */ -function menu_edit_menu_form($mid = 0) { - if (arg(3) == 'edit') { - if (!($item = db_fetch_array(db_query('SELECT * FROM {menu} WHERE mid = %d', $mid)))) { - drupal_not_found(); - return; - } - } - else { - $item = array('mid' => 0, 'pid' => 0, 'path' => '', 'weight' => 0, 'type' => MENU_CUSTOM_MENU); - } - $form['title'] = array('#type' => 'textfield', - '#title' => t('Title'), - '#default_value' => $item['title'], - '#description' => t('The name of the menu.'), - '#required' => TRUE, - ); - $form['mid'] = array('#type' => 'value', '#value' => $item['mid']); - $form['pid'] = array('#type' => 'value', '#value' => $item['pid']); - $form['path'] = array('#type' => 'value', '#value' => $item['path']); - $form['weight'] = array('#type' => 'value', '#value' => $item['weight']); - $form['type'] = array('#type' => 'value', '#value' => $item['type']); - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit')); - - // Reuse the submit function of menu_edit_item_form. - return drupal_get_form('menu_edit_menu_form', $form, 'menu_edit_item_form'); -} - -/** - * Present the menu item editing form. - */ -function menu_edit_item_form($mid = 0) { - if (arg(3) == 'edit') { - if (!($item = db_fetch_array(db_query('SELECT * FROM {menu} WHERE mid = %d', $mid)))) { - drupal_not_found(); - return; - } - } - else { - // This is an add form. - $item = array('mid' => 0, 'pid' => 1, 'weight' => 0, 'type' => MENU_CUSTOM_ITEM); - } - - $form['title'] = array('#type' => 'textfield', - '#title' => t('Title'), - '#default_value' => $item['title'], - '#description' => t('The name of the menu item.'), - '#required' => TRUE, - ); - $form['description'] = array('#type' => 'textfield', - '#title' => t('Description'), - '#default_value' => $item['description'], - '#description' => t('The description displayed when hovering over a menu item.'), - ); - - if ($item['type'] & MENU_CREATED_BY_ADMIN) { - $form['path'] = array('#type' => 'textfield', - '#title' => t('Path'), - '#default_value' => $item['path'], - '#description' => t('The path this menu item links to. This can be an internal Drupal path such as %add-node or an external URL such as %drupal. Enter %front to link to the front page.', array('%front' => theme('placeholder', ''), '%add-node' => theme('placeholder', 'node/add'), '%drupal' => theme('placeholder', 'http://drupal.org'))), - '#required' => TRUE, - ); - } - else { - $form['_path'] = array('#type' => 'item', - '#title' => t('Path'), - '#description' => l($item['path'], $item['path']), - ); - $form['path'] = array('#type' => 'value', '#value' => $item['path']); - } - - $expanded = $item['type'] & MENU_EXPANDED ? 1 : 0; - $form['expanded'] = array('#type' => 'checkbox', - '#title' => t('Expanded'), - '#default_value' => $expanded, - '#description' => t('If selected and this menu item has children, the menu will always appear expanded.'), - ); - - // Generate a list of possible parents (not including this item or descendants). - // Default to "Navigation" menu for new items. - $options = menu_parent_options($item['mid']); - $form['pid'] = array('#type' => 'select', - '#title' => t('Parent item'), - '#default_value' => $item['pid'], - '#options' => $options, - ); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $item['weight'], - '#description' => t('Optional. In the menu, the heavier items will sink and the lighter items will be positioned nearer the top.'), - ); - - // Always enable menu items (but not menus) when editing them. - if (!($item['type'] & MENU_IS_ROOT)) { - $item['type'] |= MENU_VISIBLE_IN_TREE | MENU_VISIBLE_IN_BREADCRUMB; - } - - $form['type'] = array('#type' => 'value', '#value' => $item['type']); - $form['mid'] = array('#type' => 'value', '#value' => $item['mid']); - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit')); - - return drupal_get_form('menu_edit_item_form', $form); -} - -/** - * Process menu and menu item add/edit form submissions. - */ -function menu_edit_item_form_submit($form_id, $form_values) { - menu_edit_item_save($form_values); - return 'admin/menu'; -} - -/** - * Menu callback; delete a single custom item. - */ -function menu_item_delete_form($mid) { - if (!($menu = db_fetch_object(db_query('SELECT type, title FROM {menu} WHERE mid = %d', $mid)))) { - drupal_not_found(); - return; - } - - $form['mid'] = array('#type' => 'value', '#value' => $mid); - $form['type'] = array('#type' => 'value', '#value' => $menu->type); - $form['title'] = array('#type' => 'value', '#value' => $menu->title); - - if ($menu->type & MENU_IS_ROOT) { - $message = t('Are you sure you want to delete the menu %item?', array('%item' => theme('placeholder', $menu->title))); - } - else { - $message = t('Are you sure you want to delete the custom menu item %item?', array('%item' => theme('placeholder', $menu->title))); - } - - return confirm_form('menu_confirm_delete_form', $form, $message, 'admin/menu', t('This action cannot be undone.'), t('Delete')); -} - -/** - * Process menu delete form submissions. - */ -function menu_confirm_delete_form_submit($form_id, $form_values) { - menu_delete_item($form_values['mid']); - - $t_args = array('%title' => theme('placeholder', $form_values['title'])); - if ($form_values['type'] & MENU_IS_ROOT) { - drupal_set_message(t('The menu %title has been deleted.', $t_args)); - watchdog('menu', t('Deleted menu %title.', $t_args), WATCHDOG_NOTICE); - } - else { - drupal_set_message(t('The menu item %title has been deleted.', $t_args)); - watchdog('menu', t('Deleted menu item %title.', $t_args), WATCHDOG_NOTICE); - } - - return 'admin/menu'; -} - -/** - * Menu callback; reset a single modified item. - */ -function menu_reset_item($mid) { - if (isset($mid) && $title = db_result(db_query('SELECT title FROM {menu} WHERE mid = %d', $mid))) { - $form['mid'] = array('#type' => 'value', '#value' => $mid); - return confirm_form('menu_reset_item_form', $form, t('Are you sure you want to reset the item %item to its default values?', array('%item' => theme('placeholder', $title))), 'admin/menu', t('Any customizations will be lost. This action cannot be undone.'), t('Reset')); - } - else { - drupal_not_found(); - } -} - -/** - * Process menu reset item form submissions. - */ -function menu_reset_item_form_submit($form_id, $form_values) { - menu_delete_item($form_values['mid']); - drupal_set_message(t('The menu item was reset to its default settings.')); - - return 'admin/menu'; -} - -/** - * Menu callback; hide a menu item. - */ -function menu_disable_item($mid) { - $item = menu_get_item($mid); - $type = $item['type']; - $type &= ~MENU_VISIBLE_IN_TREE; - $type &= ~MENU_VISIBLE_IN_BREADCRUMB; - $type |= MENU_MODIFIED_BY_ADMIN; - db_query('UPDATE {menu} SET type = %d WHERE mid = %d', $type, $mid); - drupal_set_message(t('The menu item has been disabled.')); - drupal_goto('admin/menu'); -} - -/** - * Menu callback; present the main menu management page. - */ -function menu_overview() { - menu_rebuild(); - - return menu_overview_tree(); -} - -/** - * Save changes to a menu item into the database. - * - * @return mid - */ -function menu_edit_item_save($edit) { - if ($edit['expanded']) { - $edit['type'] |= MENU_EXPANDED; - } - else { - $edit['type'] &= ~MENU_EXPANDED; - } - - $edit['type'] = $edit['type'] | MENU_MODIFIED_BY_ADMIN; - - $status = menu_save_item($edit); - - $t_args = array('%title' => theme('placeholder', $edit['title'])); - if ($status == SAVED_UPDATED) { - drupal_set_message(t('The menu item %title has been updated.', $t_args)); - } - elseif ($status == SAVED_NEW) { - drupal_set_message(t('The menu item %title has been added.', $t_args)); - watchdog('menu', t('Added menu item %title.', $t_args), WATCHDOG_NOTICE, l(t('view'), 'admin/menu')); - } - return $edit['mid']; -} - -/** - * Save a menu item to the database. - * - * @param $item - * The menu item to be saved. This is passed by reference, so that the newly - * generated $item['mid'] can be accessed after an insert takes place. - * - * @return $status - * The operation that was performed in saving. Either SAVED_NEW (if a new - * menu item was created), or SAVED_UPDATED (if an existing menu item was - * updated). - */ -function menu_save_item(&$item) { - $existing_item = NULL; - - // Check that the item already exists in the menu tree, if $item['mid'] is - // specified. - if (isset($item['mid'])) { - $existing_item = menu_get_item($item['mid']); - } - - if ($item['mid'] && !empty($existing_item)) { - db_query("UPDATE {menu} SET pid = %d, path = '%s', title = '%s', description = '%s', weight = %d, type = %d WHERE mid = %d", $item['pid'], $item['path'], $item['title'], $item['description'], $item['weight'], $item['type'], $item['mid']); - return SAVED_UPDATED; - } - else { - $item['mid'] = db_next_id('{menu}_mid'); - // Check explicitly for mid <= 2. If the database was improperly prefixed, - // this would cause a nasty infinite loop or duplicate mid errors. - // TODO: have automatic prefixing through an installer to prevent this. - while ($item['mid'] <= 2) { - $item['mid'] = db_next_id('{menu}_mid'); - } - db_query("INSERT INTO {menu} (mid, pid, path, title, description, weight, type) VALUES (%d, %d, '%s', '%s', '%s', %d, %d)", $item['mid'], $item['pid'], $item['path'], $item['title'], $item['description'], $item['weight'], $item['type']); - return SAVED_NEW; - } -} - -/** - * Delete a menu item from the database. If $item['mid'] is specified, then - * this is used to find the existing item; otherwise, $item['path'] is used. - * - * @param $item - * The menu item to be deleted. - */ -function menu_delete_item($item) { - if (!is_array($item)) { - $item = array('mid' => $item); - } - - if ($item['mid']) { - db_query('DELETE FROM {menu} WHERE mid = %d', $item['mid']); - } - elseif ($item['path']) { - db_query("DELETE FROM {menu} WHERE path = '%s'", $item['path']); - } -} - -/** - * Present the menu tree, rendered along with links to edit menu items. - */ -function menu_overview_tree() { - $menu = menu_get_menu(); - $root_menus = menu_get_root_menus(); - $header = array(t('Menu item'), t('Expanded'), array('data' => t('Operations'), 'colspan' => '3')); - $output = ''; - - foreach ($root_menus as $mid => $title) { - $operations = array(); - if ($menu['items'][$mid]['type'] & MENU_MODIFIABLE_BY_ADMIN) { - $operations[] = l(t('edit'), 'admin/menu/menu/edit/'. $mid); - } - if ($menu['items'][$mid]['type'] & MENU_CREATED_BY_ADMIN) { - $operations[] = l(t('delete'), 'admin/menu/menu/delete/'. $mid); - } - $table = theme('item_list', $operations); - $table .= theme('table', $header, menu_overview_tree_rows($mid)); - $output .= theme('box', $title, $table); - } - return $output; -} - -function menu_overview_tree_rows($pid = 0, $depth = 0) { - $parent_item = menu_get_item($pid); - $rows = array(); - - if (isset($parent_item) && isset($parent_item['children'])) { - usort($parent_item['children'], '_menu_sort'); - foreach ($parent_item['children'] as $mid) { - $item = menu_get_item($mid); - // Populate the title field. - $title = ''; - if ($pid == 0) { - // Top-level items are menu names, and don't have an associated path. - $title .= $item['title']; - } - else { - $title .= l($item['title'], $item['path']); - } - if ($depth > 0) { - $title = '- '. $title; - } - for ($i = 1; $i < $depth; $i++) { - $title = ' '. $title; - } - - // Populate the operations field. - $operations = array(); - if (!($item['type'] & MENU_MODIFIABLE_BY_ADMIN)) { - $operations[] = array('data' => t('locked'), 'colspan' => '3', 'align' => 'center'); - } - else { - // Set the edit column. - if ($item['type'] & (MENU_VISIBLE_IN_TREE | MENU_VISIBLE_IF_HAS_CHILDREN)) { - $operations[] = array('data' => l(t('edit'), 'admin/menu/item/edit/'. $mid)); - } - else { - $operations[] = array('data' => ''); - } - - // Set the disable column. - if ($item['type'] & (MENU_IS_ROOT | MENU_VISIBLE_IF_HAS_CHILDREN)) { - // Disabling entire menus is done from block admin page. - // MENU_VISIBLE_IF_HAS_CHILDREN menus are always enabled so hide this operation. - $operations[] = array('data' => ''); - } - else if ($item['type'] & MENU_VISIBLE_IN_TREE) { - $operations[] = array('data' => l(t('disable'), 'admin/menu/item/disable/'. $mid)); - } - else { - $operations[] = array('data' => l(t('enable'), 'admin/menu/item/edit/'. $mid)); - } - - // Set the reset column. - if ($item['type'] & MENU_CREATED_BY_ADMIN) { - $operations[] = array('data' => l(t('delete'), 'admin/menu/item/delete/'. $mid)); - } - else if ($item['type'] & MENU_MODIFIED_BY_ADMIN) { - $operations[] = array('data' => l(t('reset'), 'admin/menu/item/reset/'. $mid)); - } - else { - $operations[] = array('data' => ''); - } - } - - // Call out disabled items. - if ($item['type'] & (MENU_VISIBLE_IN_TREE | MENU_VISIBLE_IF_HAS_CHILDREN)) { - $class = 'menu-enabled'; - } - else { - $title .= ' ('. t('disabled') .')'; - $class = 'menu-disabled'; - } - - if ($item['type'] & (MENU_MODIFIABLE_BY_ADMIN | MENU_VISIBLE_IN_TREE)) { - $row = array(array('data' => $title, 'class' => $class), array('data' => ($item['children'] ? (($item['type'] & MENU_EXPANDED) ? t('Yes') : t('No')) : ''), 'class' => $class)); - foreach ($operations as $operation) { - $operation['class'] = $class; - $row[] = $operation; - } - $rows[] = $row; - $rows = array_merge($rows, menu_overview_tree_rows($mid, $depth + 1)); - } - else { - // Skip items that are hidden and locked; admins will never care about them. - $rows = array_merge($rows, menu_overview_tree_rows($mid, $depth)); - } - } - } - - return $rows; -} - -/** - * Return a list of menu items that are valid possible parents for the - * given menu item. The list excludes the given item and its children. - * - * @param $mid - * The menu item id for which to generate a list of parents. - * If $mid == 0 then the complete tree is returned. - * @param $pid - * The menu item id of the menu item at which to start the tree. - * If $pid > 0 then this item will be included in the tree. - * @param $depth - * The current depth in the tree - used when recursing to indent the tree. - * @return - * An array of menu titles keyed on the mid. - */ -function menu_parent_options($mid, $pid = 0, $depth = 0) { - $options = array(); - - if (!($parent_item = menu_get_item($pid))) { - return $options; - } - - // Exclude $mid and its children from the list unless $mid is 0. - if ($mid && $mid == $pid) { - return $options; - } - - // Add the current $pid to the list. - if ($pid > 0 && ($parent_item['type'] & (MENU_MODIFIABLE_BY_ADMIN | MENU_IS_ROOT))) { - $title = ' '. $parent_item['title']; - for ($i = 0; $i < $depth; $i++) { - $title = '--'. $title; - } - if (!($parent_item['type'] & MENU_VISIBLE_IN_TREE)) { - $title .= ' ('. t('disabled') .')'; - } - $options[$pid] = $title; - $depth ++; - } - - // Add children of $pid to the list recursively. - if ($parent_item['children']) { - usort($parent_item['children'], '_menu_sort'); - foreach ($parent_item['children'] as $child) { - $options += menu_parent_options($mid, $child, $depth); - } - } - - return $options; -} - -/** - * Remove the menu item. - */ -function menu_node_form_delete($node) { - menu_delete_item(array('path' => 'node/'. $node->nid)); -} diff --git a/modules/node/node.module b/modules/node/node.module deleted file mode 100644 index 092523f1b30a5cb4a8af0eb2a9e321e646b6f775..0000000000000000000000000000000000000000 --- a/modules/node/node.module +++ /dev/null @@ -1,2421 +0,0 @@ -'. t('All content in a website is stored and treated as nodes. Therefore nodes are any postings such as blogs, stories, polls and forums. The node module manages these content types and is one of the strengths of Drupal over other content management systems.') .''; - $output .= ' '. t('Treating all content as nodes allows the flexibility of creating new types of content. It also allows you to painlessly apply new features or changes to all content. Comments are not stored as nodes but are always associated with a node.') .'
'; - $output .= t('Node module features
--
-
- The list tab provides an interface to search and sort all content on your site. -
- The configure settings tab has basic settings for content on your site. -
- The configure content types tab lists all content types for your site and lets you configure their default workflow. -
- The search tab lets you search all content on your site -
You can
--
-
- search for content at search. -
- administer nodes at administer >> settings >> content types. -
'. t('For more information please read the configuration and customization handbook Node page.', array('%node' => 'http://drupal.org/handbook/modules/node/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows content to be submitted to the site and displayed on pages.'); - case 'admin/node/configure': - case 'admin/node/configure/settings': - return t('Settings for the core of Drupal. Almost everything is a node so these settings will affect most of the site.
'); - case 'admin/node': - return t('Below is a list of all of the posts on your site. Other forms of content are listed elsewhere (e.g. comments).
Clicking a title views the post, while clicking an author\'s name views their user information.
', array('%comments' => url('admin/comment'))); - case 'admin/node/search': - return t('Enter a simple pattern to search for a post. This can include the wildcard character *.
'); - } - - if (arg(0) == 'node' && is_numeric(arg(1)) && arg(2) == 'revisions') { - return t('The revisions let you track differences between multiple versions of a post.'); - } - - if (arg(0) == 'node' && arg(1) == 'add' && $type = arg(2)) { - return variable_get($type .'_help', ''); - } -} - -/** - * Implementation of hook_cron(). - */ -function node_cron() { - db_query('DELETE FROM {history} WHERE timestamp < %d', NODE_NEW_LIMIT); -} - -/** - * Gather a listing of links to nodes. - * - * @param $result - * A DB result object from a query to fetch node objects. If your query joins the
For example, a search for "br*" might return "bread bakers", "our daily bread" and "brenda".node_comment_statisticstable so that thecomment_countfield is available, a title attribute will be added to show the number of comments. - * @param $title - * A heading for the resulting list. - * - * @return - * An HTML list suitable as content for a block. - */ -function node_title_list($result, $title = NULL) { - while ($node = db_fetch_object($result)) { - $items[] = l($node->title, 'node/'. $node->nid, $node->comment_count ? array('title' => format_plural($node->comment_count, '1 comment', '%count comments')) : ''); - } - - return theme('node_list', $items, $title); -} - -/** - * Format a listing of links to nodes. - */ -function theme_node_list($items, $title = NULL) { - return theme('item_list', $items, $title); -} - -/** - * Update the 'last viewed' timestamp of the specified node for current user. - */ -function node_tag_new($nid) { - global $user; - - if ($user->uid) { - if (node_last_viewed($nid)) { - db_query('UPDATE {history} SET timestamp = %d WHERE uid = %d AND nid = %d', time(), $user->uid, $nid); - } - else { - @db_query('INSERT INTO {history} (uid, nid, timestamp) VALUES (%d, %d, %d)', $user->uid, $nid, time()); - } - } -} - -/** - * Retrieves the timestamp at which the current user last viewed the - * specified node. - */ -function node_last_viewed($nid) { - global $user; - static $history; - - if (!isset($history[$nid])) { - $history[$nid] = db_fetch_object(db_query("SELECT timestamp FROM {history} WHERE uid = '$user->uid' AND nid = %d", $nid)); - } - - return (isset($history[$nid]->timestamp) ? $history[$nid]->timestamp : 0); -} - -/** - * Decide on the type of marker to be displayed for a given node. - * - * @param $nid - * Node ID whose history supplies the "last viewed" timestamp. - * @param $timestamp - * Time which is compared against node's "last viewed" timestamp. - * @return - * One of the MARK constants. - */ -function node_mark($nid, $timestamp) { - global $user; - static $cache; - - if (!$user->uid) { - return MARK_READ; - } - if (!isset($cache[$nid])) { - $cache[$nid] = node_last_viewed($nid); - } - if ($cache[$nid] == 0 && $timestamp > NODE_NEW_LIMIT) { - return MARK_NEW; - } - elseif ($timestamp > $cache[$nid] && $timestamp > NODE_NEW_LIMIT) { - return MARK_UPDATED; - } - return MARK_READ; -} - -/** - * Automatically generate a teaser for a node body in a given format. - */ -function node_teaser($body, $format = NULL) { - - $size = variable_get('teaser_length', 600); - - // find where the delimiter is in the body - $delimiter = strpos($body, ''); - - // If the size is zero, and there is no delimiter, the entire body is the teaser. - if ($size == 0 && $delimiter === FALSE) { - return $body; - } - - // We check for the presence of the PHP evaluator filter in the current - // format. If the body contains PHP code, we do not split it up to prevent - // parse errors. - if (isset($format)) { - $filters = filter_list_format($format); - if (isset($filters['filter/1']) && strpos($body, '' => 4, '
' => 0, '
' => 0, "\n" => 0, '. ' => 1, '! ' => 1, '? ' => 1, '。' => 1, '؟ ' => 1); - foreach ($breakpoints as $point => $charnum) { - if ($length = strpos($body, $point, $size)) { - return substr($body, 0, $length + $charnum); - } - } - - // If all else fails, we simply truncate the string. - return truncate_utf8($body, $size); -} - -function _node_names($op = '', $node = NULL) { - static $node_names = array(); - static $node_list = array(); - - if (empty($node_names)) { - $node_names = module_invoke_all('node_info'); - foreach ($node_names as $type => $value) { - $node_list[$type] = $value['name']; - } - } - if ($node) { - if (is_array($node)) { - $type = $node['type']; - } - elseif (is_object($node)) { - $type = $node->type; - } - elseif (is_string($node)) { - $type = $node; - } - if (!isset($node_names[$type])) { - return FALSE; - } - } - switch ($op) { - case 'base': - return $node_names[$type]['base']; - case 'list': - return $node_list; - case 'name': - return $node_list[$type]; - } -} - -/** - * Determine the basename for hook_load etc. - * - * @param $node - * Either a node object, a node array, or a string containing the node type. - * @return - * The basename for hook_load, hook_nodeapi etc. - */ -function node_get_base($node) { - return _node_names('base', $node); -} - -/** - * Determine the human readable name for a given type. - * - * @param $node - * Either a node object, a node array, or a string containing the node type. - * @return - * The human readable name of the node type. - */ -function node_get_name($node) { - return _node_names('name', $node); -} - -/** - * Return the list of available node types. - * - * @param $node - * Either a node object, a node array, or a string containing the node type. - * @return - * An array consisting ('#type' => name) pairs. - */ -function node_get_types() { - return _node_names('list'); -} - -/** - * Determine whether a node hook exists. - * - * @param &$node - * Either a node object, node array, or a string containing the node type. - * @param $hook - * A string containing the name of the hook. - * @return - * TRUE iff the $hook exists in the node type of $node. - */ -function node_hook(&$node, $hook) { - return module_hook(node_get_base($node), $hook); -} - -/** - * Invoke a node hook. - * - * @param &$node - * Either a node object, node array, or a string containing the node type. - * @param $hook - * A string containing the name of the hook. - * @param $a2, $a3, $a4 - * Arguments to pass on to the hook, after the $node argument. - * @return - * The returned value of the invoked hook. - */ -function node_invoke(&$node, $hook, $a2 = NULL, $a3 = NULL, $a4 = NULL) { - if (node_hook($node, $hook)) { - $function = node_get_base($node) ."_$hook"; - return ($function($node, $a2, $a3, $a4)); - } -} - -/** - * Invoke a hook_nodeapi() operation in all modules. - * - * @param &$node - * A node object. - * @param $op - * A string containing the name of the nodeapi operation. - * @param $a3, $a4 - * Arguments to pass on to the hook, after the $node and $op arguments. - * @return - * The returned value of the invoked hooks. - */ -function node_invoke_nodeapi(&$node, $op, $a3 = NULL, $a4 = NULL) { - $return = array(); - foreach (module_implements('nodeapi') as $name) { - $function = $name .'_nodeapi'; - $result = $function($node, $op, $a3, $a4); - if (isset($result) && is_array($result)) { - $return = array_merge($return, $result); - } - else if (isset($result)) { - $return[] = $result; - } - } - return $return; -} - -/** - * Load a node object from the database. - * - * @param $param - * Either the nid of the node or an array of conditions to match against in the database query - * @param $revision - * Which numbered revision to load. Defaults to the current version. - * @param $reset - * Whether to reset the internal node_load cache. - * - * @return - * A fully-populated node object. - */ -function node_load($param = array(), $revision = NULL, $reset = NULL) { - static $nodes = array(); - - if ($reset) { - $nodes = array(); - } - - $arguments = array(); - if (is_numeric($param)) { - $cachable = $revision == NULL; - if ($cachable && isset($nodes[$param])) { - return $nodes[$param]; - } - $cond = 'n.nid = %d'; - $arguments[] = $param; - } - else { - // Turn the conditions into a query. - foreach ($param as $key => $value) { - $cond[] = 'n.'. db_escape_string($key) ." = '%s'"; - $arguments[] = $value; - } - $cond = implode(' AND ', $cond); - } - - // Retrieve the node. - if ($revision) { - array_unshift($arguments, $revision); - $node = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, r.vid, n.type, n.status, n.created, n.changed, n.comment, n.promote, n.moderate, n.sticky, r.timestamp AS revision_timestamp, r.title, r.body, r.teaser, r.log, r.format, u.uid, u.name, u.picture, u.data FROM {node} n INNER JOIN {users} u ON u.uid = n.uid INNER JOIN {node_revisions} r ON r.nid = n.nid AND r.vid = %d WHERE '. $cond), $arguments)); - } - else { - $node = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.vid, n.type, n.status, n.created, n.changed, n.comment, n.promote, n.moderate, n.sticky, r.timestamp AS revision_timestamp, r.title, r.body, r.teaser, r.log, r.format, u.uid, u.name, u.picture, u.data FROM {node} n INNER JOIN {users} u ON u.uid = n.uid INNER JOIN {node_revisions} r ON r.vid = n.vid WHERE '. $cond), $arguments)); - } - - if ($node->nid) { - // Call the node specific callback (if any) and piggy-back the - // results to the node or overwrite some values. - if ($extra = node_invoke($node, 'load')) { - foreach ($extra as $key => $value) { - $node->$key = $value; - } - } - - if ($extra = node_invoke_nodeapi($node, 'load')) { - foreach ($extra as $key => $value) { - $node->$key = $value; - } - } - } - - if ($cachable) { - $nodes[$param] = $node; - } - - return $node; -} - -/** - * Save a node object into the database. - */ -function node_save(&$node) { - global $user; - - $node->is_new = false; - - // Apply filters to some default node fields: - if (empty($node->nid)) { - // Insert a new node. - $node->is_new = true; - - // Set some required fields: - if (!$node->created) { - $node->created = time(); - } - $node->nid = db_next_id('{node}_nid'); - $node->vid = db_next_id('{node_revisions}_vid');; - } - else { - // We need to ensure that all node fields are filled. - $node_current = node_load($node->nid); - foreach ($node as $field => $data) { - $node_current->$field = $data; - } - $node = $node_current; - - if ($node->revision) { - $node->old_vid = $node->vid; - $node->vid = db_next_id('{node_revisions}_vid'); - } - } - - // If node has never changed, set $node->changed to $node->created - // If we set $node->created to time(), then 'changed' and 'created' will be - // different for new nodes which were previewed before submission - // The changed timestamp is always updated for bookkeeping purposes (revisions, searching, ...) - $node->changed = $node->changed ? time() : $node->created; - - // Split off revisions data to another structure - $revisions_table_values = array('nid' => $node->nid, 'vid' => $node->vid, - 'title' => $node->title, 'body' => $node->body, - 'teaser' => $node->teaser, 'log' => $node->log, 'timestamp' => $node->changed, - 'uid' => $user->uid, 'format' => $node->format); - $revisions_table_types = array('nid' => '%d', 'vid' => '%d', - 'title' => "'%s'", 'body' => "'%s'", - 'teaser' => "'%s'", 'log' => "'%s'", 'timestamp' => '%d', - 'uid' => '%d', 'format' => '%d'); - $node_table_values = array('nid' => $node->nid, 'vid' => $node->vid, - 'title' => $node->title, 'type' => $node->type, 'uid' => $node->uid, - 'status' => $node->status, 'created' => $node->created, - 'changed' => $node->changed, 'comment' => $node->comment, - 'promote' => $node->promote, 'moderate' => $node->moderate, - 'sticky' => $node->sticky); - $node_table_types = array('nid' => '%d', 'vid' => '%d', - 'title' => "'%s'", 'type' => "'%s'", 'uid' => '%d', - 'status' => '%d', 'created' => '%d', - 'changed' => '%d', 'comment' => '%d', - 'promote' => '%d', 'moderate' => '%d', - 'sticky' => '%d'); - - //Generate the node table query and the - //the node_revisions table query - if ($node->is_new) { - $node_query = 'INSERT INTO {node} ('. implode(', ', array_keys($node_table_types)) .') VALUES ('. implode(', ', $node_table_types) .')'; - $revisions_query = 'INSERT INTO {node_revisions} ('. implode(', ', array_keys($revisions_table_types)) .') VALUES ('. implode(', ', $revisions_table_types) .')'; - } - else { - $arr = array(); - foreach ($node_table_types as $key => $value) { - $arr[] = $key .' = '. $value; - } - $node_table_values[] = $node->nid; - $node_query = 'UPDATE {node} SET '. implode(', ', $arr) .' WHERE nid = %d'; - if ($node->revision) { - $revisions_query = 'INSERT INTO {node_revisions} ('. implode(', ', array_keys($revisions_table_types)) .') VALUES ('. implode(', ', $revisions_table_types) .')'; - } - else { - $arr = array(); - foreach ($revisions_table_types as $key => $value) { - $arr[] = $key .' = '. $value; - } - $revisions_table_values[] = $node->vid; - $revisions_query = 'UPDATE {node_revisions} SET '. implode(', ', $arr) .' WHERE vid = %d'; - } - } - - // Insert the node into the database: - db_query($node_query, $node_table_values); - db_query($revisions_query, $revisions_table_values); - - // Call the node specific callback (if any): - if ($node->is_new) { - node_invoke($node, 'insert'); - node_invoke_nodeapi($node, 'insert'); - } - else { - node_invoke($node, 'update'); - node_invoke_nodeapi($node, 'update'); - } - - // Clear the cache so an anonymous poster can see the node being added or updated. - cache_clear_all(); -} - -/** - * Generate a display of the given node. - * - * @param $node - * A node array or node object. - * @param $teaser - * Whether to display the teaser only, as on the main page. - * @param $page - * Whether the node is being displayed by itself as a page. - * @param $links - * Whether or not to display node links. Links are omitted for node previews. - * - * @return - * An HTML representation of the themed node. - */ -function node_view($node, $teaser = FALSE, $page = FALSE, $links = TRUE) { - $node = (object)$node; - - // Remove the delimiter (if any) that separates the teaser from the body. - // TODO: this strips legitimate uses of '' also. - $node->body = str_replace('', '', $node->body); - - if ($node->log != '' && !$teaser && $node->moderate) { - $node->body .= ''; - } - - // The 'view' hook can be implemented to overwrite the default function - // to display nodes. - if (node_hook($node, 'view')) { - node_invoke($node, 'view', $teaser, $page); - } - else { - $node = node_prepare($node, $teaser); - } - // Allow modules to change $node->body before viewing. - node_invoke_nodeapi($node, 'view', $teaser, $page); - if ($links) { - $node->links = module_invoke_all('link', 'node', $node, !$page); - } - // unset unused $node part so that a bad theme can not open a security hole - if ($teaser) { - unset($node->body); - } - else { - unset($node->teaser); - } - - return theme('node', $node, $teaser, $page); -} - -/** - * Apply filters to a node in preparation for theming. - */ -function node_prepare($node, $teaser = FALSE) { - $node->readmore = (strlen($node->teaser) < strlen($node->body)); - if ($teaser == FALSE) { - $node->body = check_markup($node->body, $node->format, FALSE); - } - else { - $node->teaser = check_markup($node->teaser, $node->format, FALSE); - } - return $node; -} - -/** - * Generate a page displaying a single node, along with its comments. - */ -function node_show($node, $cid) { - $output = node_view($node, FALSE, TRUE); - - if (function_exists('comment_render') && $node->comment) { - $output .= comment_render($node, $cid); - } - - // Update the history table, stating that this user viewed this node. - node_tag_new($node->nid); - - return $output; -} - -/** - * Implementation of hook_perm(). - */ -function node_perm() { - return array('administer nodes', 'access content', 'view revisions', 'revert revisions'); -} - -/** - * Implementation of hook_search(). - */ -function node_search($op = 'search', $keys = null) { - switch ($op) { - case 'name': - return t('content'); - - case 'reset': - variable_del('node_cron_last'); - variable_del('node_cron_last_nid'); - return; - - case 'status': - $last = variable_get('node_cron_last', 0); - $last_nid = variable_get('node_cron_last_nid', 0); - $total = db_result(db_query('SELECT COUNT(*) FROM {node} WHERE status = 1')); - $remaining = db_result(db_query('SELECT COUNT(*) FROM {node} n LEFT JOIN {node_comment_statistics} c ON n.nid = c.nid WHERE n.status = 1 AND ((GREATEST(n.created, n.changed, c.last_comment_timestamp) = %d AND n.nid > %d ) OR (n.created > %d OR n.changed > %d OR c.last_comment_timestamp > %d))', $last, $last_nid, $last, $last, $last)); - return array('remaining' => $remaining, 'total' => $total); - - case 'admin': - $form = array(); - // Output form for defining rank factor weights. - $form['content_ranking'] = array('#type' => 'fieldset', '#title' => t('Content ranking')); - $form['content_ranking']['#theme'] = 'node_search_admin'; - $form['content_ranking']['info'] = array('#type' => 'markup', '#value' => ''. t('The following numbers control which properties the content search should favor when ordering the results. Higher numbers mean more influence, zero means the property is ignored. Changing these numbers does not require the search index to be rebuilt. Changes take effect immediately.') .''); - - $ranking = array('node_rank_relevance' => t('Keyword relevance'), - 'node_rank_recent' => t('Recently posted')); - if (module_exist('comment')) { - $ranking['node_rank_comments'] = t('Number of comments'); - } - if (module_exist('statistics') && variable_get('statistics_count_content_views', 0)) { - $ranking['node_rank_views'] = t('Number of views'); - } - - // Note: reversed to reflect that higher number = higher ranking. - $options = drupal_map_assoc(range(0, 10)); - foreach ($ranking as $var => $title) { - $form['content_ranking']['factors'][$var] = array('#title' => $title, '#type' => 'select', '#options' => $options, '#default_value' => variable_get($var, 5)); - } - return $form; - - case 'search': - // Build matching conditions - list($join1, $where1) = _db_rewrite_sql(); - $arguments1 = array(); - $conditions1 = 'n.status = 1'; - - if ($type = search_query_extract($keys, 'type')) { - $types = array(); - foreach (explode(',', $type) as $t) { - $types[] = "n.type = '%s'"; - $arguments1[] = $t; - } - $conditions1 .= ' AND ('. implode(' OR ', $types) .')'; - $keys = search_query_insert($keys, 'type'); - } - - if ($category = search_query_extract($keys, 'category')) { - $categories = array(); - foreach (explode(',', $category) as $c) { - $categories[] = "tn.tid = %d"; - $arguments1[] = $c; - } - $conditions1 .= ' AND ('. implode(' OR ', $categories) .')'; - $join1 .= ' INNER JOIN {term_node} tn ON n.nid = tn.nid'; - $keys = search_query_insert($keys, 'category'); - } - - // Build ranking expression (we try to map each parameter to a - // uniform distribution in the range 0..1). - $ranking = array(); - $arguments2 = array(); - $join2 = ''; - // Used to avoid joining on node_comment_statistics twice - $stats_join = false; - if ($weight = (int)variable_get('node_rank_relevance', 5)) { - // Average relevance values hover around 0.15 - $ranking[] = '%d * i.relevance'; - $arguments2[] = $weight; - } - if ($weight = (int)variable_get('node_rank_recent', 5)) { - // Exponential decay with half-life of 6 months, starting at last indexed node - $ranking[] = '%d * POW(2, (GREATEST(n.created, n.changed, c.last_comment_timestamp) - %d) * 6.43e-8)'; - $arguments2[] = $weight; - $arguments2[] = (int)variable_get('node_cron_last', 0); - $join2 .= ' INNER JOIN {node} n ON n.nid = i.sid LEFT JOIN {node_comment_statistics} c ON c.nid = i.sid'; - $stats_join = true; - } - if (module_exist('comment') && $weight = (int)variable_get('node_rank_comments', 5)) { - // Inverse law that maps the highest reply count on the site to 1 and 0 to 0. - $scale = variable_get('node_cron_comments_scale', 0.0); - $ranking[] = '%d * (2.0 - 2.0 / (1.0 + c.comment_count * %f))'; - $arguments2[] = $weight; - $arguments2[] = $scale; - if (!$stats_join) { - $join2 .= ' LEFT JOIN {node_comment_statistics} c ON c.nid = i.sid'; - } - } - if (module_exist('statistics') && variable_get('statistics_count_content_views', 0) && - $weight = (int)variable_get('node_rank_views', 5)) { - // Inverse law that maps the highest view count on the site to 1 and 0 to 0. - $scale = variable_get('node_cron_views_scale', 0.0); - $ranking[] = '%d * (2.0 - 2.0 / (1.0 + nc.totalcount * %f))'; - $arguments2[] = $weight; - $arguments2[] = $scale; - $join2 .= ' LEFT JOIN {node_counter} nc ON n.nid = nc.nid'; - } - $select2 = (count($ranking) ? implode(' + ', $ranking) : 'i.relevance') . ' AS score'; - - // Do search - $find = do_search($keys, 'node', 'INNER JOIN {node} n ON n.nid = i.sid '. $join1 .' INNER JOIN {users} u ON n.uid = u.uid', $conditions1 . (empty($where1) ? '' : ' AND '. $where1), $arguments1, $select2, $join2, $arguments2); - - // Load results - $results = array(); - foreach ($find as $item) { - $node = node_load($item->sid); - - // Get node output (filtered and with module-specific fields). - if (node_hook($node, 'view')) { - node_invoke($node, 'view', false, false); - } - else { - $node = node_prepare($node, false); - } - // Allow modules to change $node->body before viewing. - node_invoke_nodeapi($node, 'view', false, false); - - // Fetch comments for snippet - $node->body .= module_invoke('comment', 'nodeapi', $node, 'update index'); - - $extra = node_invoke_nodeapi($node, 'search result'); - $results[] = array('link' => url('node/'. $item->sid), - 'type' => node_get_name($node), - 'title' => $node->title, - 'user' => theme('username', $node), - 'date' => $node->changed, - 'node' => $node, - 'extra' => $extra, - 'snippet' => search_excerpt($keys, $node->body)); - } - return $results; - } -} - -/** - * Implementation of hook_user(). - */ -function node_user($op, &$edit, &$user) { - if ($op == 'delete') { - db_query('UPDATE {node} SET uid = 0 WHERE uid = %d', $user->uid); - db_query('UPDATE {node_revisions} SET uid = 0 WHERE uid = %d', $user->uid); - } -} - -function theme_node_search_admin($form) { - $output = form_render($form['info']); - - $header = array(t('Factor'), t('Weight')); - foreach (element_children($form['factors']) as $key) { - $row = array(); - $row[] = $form['factors'][$key]['#title']; - unset($form['factors'][$key]['#title']); - $row[] = form_render($form['factors'][$key]); - $rows[] = $row; - } - $output .= theme('table', $header, $rows); - - $output .= form_render($form); - return $output; -} - -/** - * Menu callback; presents general node configuration options. - */ -function node_configure() { - - $form['default_nodes_main'] = array( - '#type' => 'select', '#title' => t('Number of posts on main page'), '#default_value' => variable_get('default_nodes_main', 10), - '#options' => drupal_map_assoc(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30)), - '#description' => t('The default maximum number of posts to display per page on overview pages such as the main page.') - ); - - $form['teaser_length'] = array( - '#type' => 'select', '#title' => t('Length of trimmed posts'), '#default_value' => variable_get('teaser_length', 600), - '#options' => array(0 => t('Unlimited'), 200 => t('200 characters'), 400 => t('400 characters'), 600 => t('600 characters'), - 800 => t('800 characters'), 1000 => t('1000 characters'), 1200 => t('1200 characters'), 1400 => t('1400 characters'), - 1600 => t('1600 characters'), 1800 => t('1800 characters'), 2000 => t('2000 characters')), - '#description' => t("The maximum number of characters used in the trimmed version of a post. Drupal will use this setting to determine at which offset long posts should be trimmed. The trimmed version of a post is typically used as a teaser when displaying the post on the main page, in XML feeds, etc. To disable teasers, set to 'Unlimited'. Note that this setting will only affect new or updated content and will not affect existing teasers.") - ); - - $form['node_preview'] = array( - '#type' => 'radios', '#title' => t('Preview post'), '#default_value' => variable_get('node_preview', 0), - '#options' => array(t('Optional'), t('Required')), '#description' => t('Must users preview posts before submitting?') - ); - - return system_settings_form('node_configure', $form); -} - -/** - * Retrieve the comment mode for the given node ID (none, read, or read/write). - */ -function node_comment_mode($nid) { - static $comment_mode; - if (!isset($comment_mode[$nid])) { - $comment_mode[$nid] = db_result(db_query('SELECT comment FROM {node} WHERE nid = %d', $nid)); - } - return $comment_mode[$nid]; -} - -/** - * Implementation of hook_link(). - */ -function node_link($type, $node = 0, $main = 0) { - $links = array(); - - if ($type == 'node') { - if (array_key_exists('links', $node)) { - $links = $node->links; - } - - if ($main == 1 && $node->teaser && $node->readmore) { - $links[] = l(t('read more'), "node/$node->nid", array('title' => t('Read the rest of this posting.'), 'class' => 'read-more')); - } - } - - return $links; -} - -/** - * Implementation of hook_menu(). - */ -function node_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/node', 'title' => t('content'), - 'callback' => 'node_admin_nodes', - 'access' => user_access('administer nodes')); - $items[] = array('path' => 'admin/node/overview', 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - - if (module_exist('search')) { - $items[] = array('path' => 'admin/node/search', 'title' => t('search'), - 'callback' => 'node_admin_search', - 'access' => user_access('administer nodes'), - 'type' => MENU_LOCAL_TASK); - } - - $items[] = array('path' => 'admin/settings/node', 'title' => t('posts'), - 'callback' => 'node_configure', - 'access' => user_access('administer nodes')); - $items[] = array('path' => 'admin/settings/content-types', 'title' => t('content types'), - 'callback' => 'node_types_configure', - 'access' => user_access('administer nodes')); - - $items[] = array('path' => 'node', 'title' => t('content'), - 'callback' => 'node_page', - 'access' => user_access('access content'), - 'type' => MENU_SUGGESTED_ITEM); - $items[] = array('path' => 'node/add', 'title' => t('create content'), - 'callback' => 'node_page', - 'access' => user_access('access content'), - 'type' => MENU_ITEM_GROUPING, - 'weight' => 1); - $items[] = array('path' => 'rss.xml', 'title' => t('rss feed'), - 'callback' => 'node_feed', - 'access' => user_access('access content'), - 'type' => MENU_CALLBACK); - } - else { - if (arg(0) == 'node' && is_numeric(arg(1))) { - $node = node_load(arg(1)); - if ($node->nid) { - $items[] = array('path' => 'node/'. arg(1), 'title' => t('view'), - 'callback' => 'node_page', - 'access' => node_access('view', $node), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'node/'. arg(1) .'/view', 'title' => t('view'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'node/'. arg(1) .'/edit', 'title' => t('edit'), - 'callback' => 'node_page', - 'access' => node_access('update', $node), - 'weight' => 1, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'node/'. arg(1) .'/delete', 'title' => t('delete'), - 'callback' => 'node_delete_confirm', - 'access' => node_access('delete', $node), - 'weight' => 1, - 'type' => MENU_CALLBACK); - $revisions_access = ((user_access('view revisions') || user_access('administer nodes')) && node_access('view', $node) && db_result(db_query('SELECT COUNT(vid) FROM {node_revisions} WHERE nid = %d', arg(1))) > 1); - $items[] = array('path' => 'node/'. arg(1) .'/revisions', 'title' => t('revisions'), - 'callback' => 'node_revisions', - 'access' => $revisions_access, - 'weight' => 2, - 'type' => MENU_LOCAL_TASK); - } - } - else if (arg(0) == 'admin' && arg(1) == 'settings' && arg(2) == 'content-types' && is_string(arg(3))) { - $items[] = array('path' => 'admin/settings/content-types/'. arg(3), - 'title' => t("'%name' content type", array('%name' => node_get_name(arg(3)))), - 'type' => MENU_CALLBACK); - } - } - - return $items; -} - -function node_last_changed($nid) { - $node = db_fetch_object(db_query('SELECT changed FROM {node} WHERE nid = %d', $nid)); - return ($node->changed); -} - -/** - * List node administration operations that can be performed. - */ -function node_operations() { - $operations = array( - 'approve' => array(t('Approve the selected posts'), 'UPDATE {node} SET status = 1, moderate = 0 WHERE nid = %d'), - 'promote' => array(t('Promote the selected posts'), 'UPDATE {node} SET status = 1, promote = 1 WHERE nid = %d'), - 'sticky' => array(t('Make the selected posts sticky'), 'UPDATE {node} SET status = 1, sticky = 1 WHERE nid = %d'), - 'demote' => array(t('Demote the selected posts'), 'UPDATE {node} SET promote = 0 WHERE nid = %d'), - 'unpublish' => array(t('Unpublish the selected posts'), 'UPDATE {node} SET status = 0 WHERE nid = %d'), - 'delete' => array(t('Delete the selected posts'), '') - ); - return $operations; -} - -/** - * List node administration filters that can be applied. - */ -function node_filters() { - // Regular filters - $filters['status'] = array('title' => t('status'), - 'options' => array('status-1' => t('published'), 'status-0' => t('not published'), - 'moderate-1' => t('in moderation'), 'moderate-0' => t('not in moderation'), - 'promote-1' => t('promoted'), 'promote-0' => t('not promoted'), - 'sticky-1' => t('sticky'), 'sticky-0' => t('not sticky'))); - $filters['type'] = array('title' => t('type'), 'options' => node_get_types()); - // The taxonomy filter - if ($taxonomy = module_invoke('taxonomy', 'form_all', 1)) { - $filters['category'] = array('title' => t('category'), 'options' => $taxonomy); - } - - return $filters; -} - -/** - * Build query for node administration filters based on session. - */ -function node_build_filter_query() { - $filters = node_filters(); - - // Build query - $where = $args = array(); - $join = ''; - foreach ($_SESSION['node_overview_filter'] as $index => $filter) { - list($key, $value) = $filter; - switch($key) { - case 'status': - // Note: no exploitable hole as $key/$value have already been checked when submitted - list($key, $value) = explode('-', $value, 2); - $where[] = 'n.'. $key .' = %d'; - break; - case 'category': - $table = "tn$index"; - $where[] = "$table.tid = %d"; - $join .= "INNER JOIN {term_node} $table ON n.nid = $table.nid "; - break; - case 'type': - $where[] = "n.type = '%s'"; - } - $args[] = $value; - } - $where = count($where) ? 'WHERE '. implode(' AND ', $where) : ''; - - return array('where' => $where, 'join' => $join, 'args' => $args); -} - -/** - * Return form for node administration filters. - */ -function node_filter_form() { - $session = &$_SESSION['node_overview_filter']; - $session = is_array($session) ? $session : array(); - $filters = node_filters(); - - $i = 0; - $form['filters'] = array('#type' => 'fieldset', - '#title' => t('Show only items where'), - '#theme' => 'node_filters', - ); - foreach ($session as $filter) { - list($type, $value) = $filter; - if ($type == 'category') { - // Load term name from DB rather than search and parse options array. - $value = module_invoke('taxonomy', 'get_term', $value); - $value = $value->name; - } - else { - $value = $filters[$type]['options'][$value]; - } - $string = ($i++ ? 'and where %a is %b' : '%a is %b'); - $form['filters']['current'][] = array('#value' => t($string, array('%a' => $filters[$type]['title'] , '%b' => $value))); - } - - foreach ($filters as $key => $filter) { - $names[$key] = $filter['title']; - $form['filters']['status'][$key] = array('#type' => 'select', '#options' => $filter['options']); - } - - $form['filters']['filter'] = array('#type' => 'radios', '#options' => $names, '#default_value' => 'status'); - $form['filters']['buttons']['submit'] = array('#type' => 'submit', '#value' => (count($session) ? t('Refine') : t('Filter'))); - if (count($session)) { - $form['filters']['buttons']['undo'] = array('#type' => 'submit', '#value' => t('Undo')); - $form['filters']['buttons']['reset'] = array('#type' => 'submit', '#value' => t('Reset')); - } - - return drupal_get_form('node_filter_form', $form); -} - -/** - * Theme node administration filter form. - */ -function theme_node_filter_form(&$form) { - $output .= ''. t('Log') .':'. filter_xss($node->log) .''; - $output .= form_render($form['filters']); - $output .= ''; - $output .= form_render($form); - return $output; -} - -/** - * Theme node administraton filter selector. - */ -function theme_node_filters(&$form) { - $output .= '- ';
- if (sizeof($form['current'])) {
- foreach (element_children($form['current']) as $key) {
- $output .= '
- ' . form_render($form['current'][$key]) . ' '; - } - } - - $output .= '
- ' . (sizeof($form['current']) ? '
- '. t('and') .' '. t('where') .' ' : '') . '
- '; - foreach (element_children($form['filter']) as $key) { - $output .= form_render($form['filter'][$key]); - } - $output .= ' '; - - $output .= '
- '. t('is') .' ' . '
- '; - - foreach (element_children($form['status']) as $key) { - $output .= form_render($form['status'][$key]); - } - $output .= ' '; - - $output .= '
'. form_render($form['buttons']) .''; - $output .= '
'; - - return $output; -} - -/** - * Process result from node administration filter form. - */ -function node_filter_form_submit() { - global $form_values; - $op = $_POST['op']; - $filters = node_filters(); - switch ($op) { - case t('Filter'): - case t('Refine'): - if (isset($form_values['filter'])) { - $filter = $form_values['filter']; - - // Flatten the options array to accomodate hierarchical/nested options. - $flat_options = form_options_flatten($filters[$filter]['options']); - - if (isset($flat_options[$form_values[$filter]])) { - $_SESSION['node_overview_filter'][] = array($filter, $form_values[$filter]); - } - } - break; - case t('Undo'): - array_pop($_SESSION['node_overview_filter']); - break; - case t('Reset'): - $_SESSION['node_overview_filter'] = array(); - break; - } -} - -/** - * Generate the content administration overview. - */ -function node_admin_nodes_submit($form_id, $edit) { - $operations = node_operations(); - if ($operations[$edit['operation']][1]) { - // Flag changes - $operation = $operations[$edit['operation']][1]; - foreach ($edit['nodes'] as $nid => $value) { - if ($value) { - db_query($operation, $nid); - } - } - drupal_set_message(t('The update has been performed.')); - } -} - -function node_admin_nodes_validate($form_id, $edit) { - $edit['nodes'] = array_diff($edit['nodes'], array(0)); - if (count($edit['nodes']) == 0) { - if ($edit['operation'] == 'delete') { - form_set_error('', t('Please select some items to perform the delete operation.')); - } - else { - form_set_error('', t('Please select some items to perform the update on.')); - } - } -} - -/** - * Menu callback: content administration. - */ -function node_admin_nodes() { - global $form_values; - $output = node_filter_form(); - - if ($_POST['edit']['operation'] == 'delete' && $_POST['edit']['nodes']) { - return node_multiple_delete_confirm(); - } - - $filter = node_build_filter_query(); - - $result = pager_query('SELECT n.*, u.name, u.uid FROM {node} n '. $filter['join'] .' INNER JOIN {users} u ON n.uid = u.uid '. $filter['where'] .' ORDER BY n.changed DESC', 50, 0, NULL, $filter['args']); - - $form['options'] = array('#type' => 'fieldset', - '#title' => t('Update options'), - '#prefix' => '', - '#suffix' => '', - ); - $options = array(); - foreach (node_operations() as $key => $value) { - $options[$key] = $value[0]; - } - $form['options']['operation'] = array('#type' => 'select', '#options' => $options, '#default_value' => 'approve'); - $form['options']['submit'] = array('#type' => 'submit', '#value' => t('Update')); - - $destination = drupal_get_destination(); - while ($node = db_fetch_object($result)) { - $nodes[$node->nid] = ''; - $form['title'][$node->nid] = array('#value' => l($node->title, 'node/'. $node->nid) .' '. theme('mark', node_mark($node->nid, $node->changed))); - $form['name'][$node->nid] = array('#value' => node_get_name($node)); - $form['username'][$node->nid] = array('#value' => theme('username', $node)); - $form['status'][$node->nid] = array('#value' => ($node->status ? t('published') : t('not published'))); - $form['operations'][$node->nid] = array('#value' => l(t('edit'), 'node/'. $node->nid .'/edit', array(), $destination)); - } - $form['nodes'] = array('#type' => 'checkboxes', '#options' => $nodes); - $form['pager'] = array('#value' => theme('pager', NULL, 50, 0)); - - $form['#method'] = 'post'; - $form['#action'] = url('admin/node'); - - // Call the form first, to allow for the form_values array to be populated. - $output .= drupal_get_form('node_admin_nodes', $form); - - return $output; -} - -/** - * Theme node administration overview. - */ -function theme_node_admin_nodes($form) { - // Overview table: - $header = array(NULL, t('Title'), t('Type'), t('Author'), t('Status'), t('Operations')); - - $output .= form_render($form['options']); - if (isset($form['title']) && is_array($form['title'])) { - foreach (element_children($form['title']) as $key) { - $row = array(); - $row[] = form_render($form['nodes'][$key]); - $row[] = form_render($form['title'][$key]); - $row[] = form_render($form['name'][$key]); - $row[] = form_render($form['username'][$key]); - $row[] = form_render($form['status'][$key]); - $row[] = form_render($form['operations'][$key]); - $rows[] = $row; - } - - } - else { - $rows[] = array(array('data' => t('No posts available.'), 'colspan' => '6')); - } - - $output .= theme('table', $header, $rows); - if ($form['pager']['#value']) { - $output .= form_render($form['pager']); - } - - $output .= form_render($form); - - return $output; -} - -function node_multiple_delete_confirm() { - $edit = $_POST['edit']; - - $form['nodes'] = array('#prefix' => '- ', '#suffix' => '
- ', '#suffix' => check_plain($title) ."
\n"); - } - $form['operation'] = array('#type' => 'hidden', '#value' => 'delete'); - - return confirm_form('node_multiple_delete_confirm', $form, - t('Are you sure you want to delete these items?'), - 'admin/node', t('This action cannot be undone.'), - t('Delete all'), t('Cancel')); -} - -function node_multiple_delete_confirm_submit($form_id, $edit) { - if ($edit['confirm']) { - foreach ($edit['nodes'] as $nid => $value) { - node_delete($nid); - } - drupal_set_message(t('The items have been deleted.')); - } - return 'admin/node'; -} - -/** - * Menu callback; presents each node type configuration page. - */ -function node_types_configure($type = NULL) { - if (isset($type)) { - $node = new stdClass(); - $node->type = $type; - $form['submission'] = array('#type' => 'fieldset', '#title' =>t('Submission form') ); - $form['submission'][$type . '_help'] = array( - '#type' => 'textarea', '#title' => t('Explanation or submission guidelines'), '#default_value' => variable_get($type .'_help', ''), - '#description' => t('This text will be displayed at the top of the %type submission form. It is useful for helping or instructing your users.', array('%type' => node_get_name($type))) - ); - $form['submission']['minimum_'. $type .'_size'] = array( - '#type' => 'select', '#title' => t('Minimum number of words'), '#default_value' => variable_get('minimum_'. $type .'_size', 0), '#options' => drupal_map_assoc(array(0, 10, 25, 50, 75, 100, 125, 150, 175, 200)), - '#description' => t('The minimum number of words a %type must be to be considered valid. This can be useful to rule out submissions that do not meet the site\'s standards, such as short test posts.', array('%type' => node_get_name($type))) - ); - $form['workflow'] = array('#type' => 'fieldset', '#title' =>t('Workflow')); - $form['type'] = array('#type' => 'value', '#value' => $type); - - $form['array_filter'] = array('#type' => 'value', '#value' => TRUE); - return system_settings_form($type .'_node_settings', $form); - } - else { - $header = array(t('Type'), t('Operations')); - - $rows = array(); - foreach (node_get_types() as $type => $name) { - $rows[] = array($name, l(t('configure'), 'admin/settings/content-types/'. $type)); - } - - return theme('table', $header, $rows); - } -} - -/** - * Generate an overview table of older revisions of a node. - */ -function node_revision_overview($node) { - drupal_set_title(t('Revisions for %title', array('%title' => check_plain($node->title)))); - - $header = array(t('Revision'), array('data' => t('Operations'), 'colspan' => 2)); - - $revisions = node_revision_list($node); - - $rows = array(); - $revert_permission = FALSE; - if ((user_access('revert revisions') || user_access('administer nodes')) && node_access('update', $node)) { - $revert_permission = TRUE; - } - $delete_permission = FALSE; - if (user_access('administer nodes')) { - $delete_permission = TRUE; - } - foreach ($revisions as $revision) { - $row = array(); - $operations = array(); - - if ($revision->current_vid > 0) { - $row[] = array('data' => t('%date by %username', array('%date' => l(format_date($revision->timestamp, 'small'), "node/$node->nid"), '%username' => theme('username', $revision))) - . (($revision->log != '') ? ''. filter_xss($revision->log) .'
' : ''), - 'class' => 'revision-current'); - $operations[] = array('data' => theme('placeholder', t('current revision')), 'class' => 'revision-current', 'colspan' => 2); - } - else { - $row[] = t('%date by %username', array('%date' => l(format_date($revision->timestamp, 'small'), "node/$node->nid/revisions/$revision->vid/view"), '%username' => theme('username', $revision))) - . (($revision->log != '') ? ''. filter_xss($revision->log) .'
' : ''); - if ($revert_permission) { - $operations[] = l(t('revert'), "node/$node->nid/revisions/$revision->vid/revert"); - } - if ($delete_permission) { - $operations[] = l(t('delete'), "node/$node->nid/revisions/$revision->vid/delete"); - } - } - $rows[] = array_merge($row, $operations); - } - $output .= theme('table', $header, $rows); - - return $output; -} - -/** - * Revert to the revision with the specified revision number. A node and nodeapi "update" event is triggered - * (via the node_save() call) when a revision is reverted. - */ -function node_revision_revert($nid, $revision) { - global $user; - - $node = node_load($nid, $revision); - if ((user_access('revert revisions') || user_access('administer nodes')) && node_access('update', $node)) { - if ($node->vid) { - $node->revision = 1; - $node->log = t('Copy of the revision from %date.', array('%date' => theme('placeholder', format_date($node->revision_timestamp)))); - $node->taxonomy = array_keys($node->taxonomy); - - node_save($node); - - drupal_set_message(t('%title has been reverted back to the revision from %revision-date', array('%revision-date' => theme('placeholder', format_date($node->revision_timestamp)), '%title' => theme('placeholder', check_plain($node->title))))); - watchdog('content', t('%type: reverted %title revision %revision.', array('%type' => theme('placeholder', t($node->type)), '%title' => theme('placeholder', $node->title), '%revision' => theme('placeholder', $revision)))); - } - else { - drupal_set_message(t('You tried to revert to an invalid revision.'), 'error'); - } - drupal_goto('node/'. $nid .'/revisions'); - } - drupal_access_denied(); -} - -/** - * Delete the revision with specified revision number. A "delete revision" nodeapi event is invoked when a - * revision is deleted. - */ -function node_revision_delete($nid, $revision) { - if (user_access('administer nodes')) { - $node = node_load($nid); - if (node_access('delete', $node)) { - // Don't delete the current revision - if ($revision != $node->vid) { - $node = node_load($nid, $revision); - - db_query("DELETE FROM {node_revisions} WHERE nid = %d AND vid = %d", $nid, $revision); - node_invoke_nodeapi($node, 'delete revision'); - drupal_set_message(t('Deleted %title revision %revision.', array('%title' => theme('placeholder', $node->title), '%revision' => theme('placeholder', $revision)))); - watchdog('content', t('%type: deleted %title revision %revision.', array('%type' => theme('placeholder', t($node->type)), '%title' => theme('placeholder', $node->title), '%revision' => theme('placeholder', $revision)))); - } - - else { - drupal_set_message(t('Deletion failed. You tried to delete the current revision.')); - } - if (db_result(db_query('SELECT COUNT(vid) FROM {node_revisions} WHERE nid = %d', $nid)) > 1) { - drupal_goto("node/$nid/revisions"); - } - else { - drupal_goto("node/$nid"); - } - } - } - - drupal_access_denied(); -} - -/** - * Return a list of all the existing revision numbers. - */ -function node_revision_list($node) { - $revisions = array(); - $result = db_query('SELECT r.vid, r.title, r.log, r.uid, n.vid AS current_vid, r.timestamp, u.name FROM {node_revisions} r LEFT JOIN {node} n ON n.vid = r.vid INNER JOIN {users} u ON u.uid = r.uid WHERE r.nid = %d ORDER BY r.timestamp DESC', $node->nid); - while ($revision = db_fetch_object($result)) { - $revisions[] = $revision; - } - - return $revisions; -} - -function node_admin_search() { - $output = search_form(url('admin/node/search'), $_POST['edit']['keys'], 'node') . search_data($_POST['edit']['keys'], 'node'); - return $output; -} - -/** - * Implementation of hook_block(). - */ -function node_block($op = 'list', $delta = 0) { - if ($op == 'list') { - $blocks[0]['info'] = t('Syndicate'); - return $blocks; - } - else if ($op == 'view') { - $block['subject'] = t('Syndicate'); - $block['content'] = theme('feed_icon', url('rss.xml')); - - return $block; - } -} - -/** - * A generic function for generating RSS feeds from a set of nodes. - * - * @param $nodes - * An object as returned by db_query() which contains the nid field. - * @param $channel - * An associative array containing title, link, description and other keys. - * The link should be an absolute URL. - */ -function node_feed($nodes = 0, $channel = array()) { - global $base_url, $locale; - - if (!$nodes) { - $nodes = db_query_range(db_rewrite_sql('SELECT n.nid FROM {node} n WHERE n.promote = 1 AND n.status = 1 ORDER BY n.created DESC'), 0, variable_get('feed_default_items', 10)); - } - - $item_length = variable_get('feed_item_length', 'teaser'); - $namespaces = array('xmlns:dc="http://purl.org/dc/elements/1.1/"'); - - while ($node = db_fetch_object($nodes)) { - // Load the specified node: - $item = node_load($node->nid); - $link = url("node/$node->nid", NULL, NULL, 1); - - if ($item_length != 'title') { - $teaser = ($item_length == 'teaser') ? TRUE : FALSE; - - // Filter and prepare node teaser - if (node_hook($item, 'view')) { - node_invoke($item, 'view', $teaser, FALSE); - } - else { - $item = node_prepare($item, $teaser); - } - - // Allow modules to change $node->teaser before viewing. - node_invoke_nodeapi($item, 'view', $teaser, FALSE); - } - - // Prepare the item description - switch ($item_length) { - case 'fulltext': - $item_text = $item->body; - break; - case 'teaser': - $item_text = $item->teaser; - if ($item->readmore) { - $item_text .= ''. l(t('read more'), 'node/'. $item->nid, NULL, NULL, NULL, TRUE) .'
'; - } - break; - case 'title': - $item_text = ''; - break; - } - - // Allow modules to add additional item fields - $extra = node_invoke_nodeapi($item, 'rss item'); - $extra = array_merge($extra, array(array('key' => 'pubDate', 'value' => date('r', $item->created)), array('key' => 'dc:creator', 'value' => $item->name), array('key' => 'guid', 'value' => $item->nid . ' at ' . $base_url, 'attributes' => array('isPermaLink' => 'false')))); - foreach ($extra as $element) { - if ($element['namespace']) { - $namespaces = array_merge($namespaces, $element['namespace']); - } - } - $items .= format_rss_item($item->title, $link, $item_text, $extra); - } - - $channel_defaults = array( - 'version' => '2.0', - 'title' => variable_get('site_name', 'drupal') .' - '. variable_get('site_slogan', ''), - 'link' => $base_url, - 'description' => variable_get('site_mission', ''), - 'language' => $locale - ); - $channel = array_merge($channel_defaults, $channel); - - $output = "\n"; - $output .= "\n"; - $output .= format_rss_channel($channel['title'], $channel['link'], $channel['description'], $items, $channel['language']); - $output .= " \n"; - - drupal_set_header('Content-Type: text/xml; charset=utf-8'); - print $output; -} - -/** - * Prepare node for save and allow modules to make changes. - */ -function node_submit($node) { - global $user; - - // Convert the node to an object, if necessary. - $node = (object)$node; - - // Auto-generate the teaser, but only if it hasn't been set (e.g. by a - // module-provided 'teaser' form item). - if (!isset($node->teaser)) { - $node->teaser = isset($node->body) ? node_teaser($node->body, isset($node->format) ? $node->format : NULL) : ''; - } - - if (user_access('administer nodes')) { - // Populate the "authored by" field. - if ($account = user_load(array('name' => $node->name))) { - $node->uid = $account->uid; - } - else { - $node->uid = 0; - } - - $node->created = strtotime($node->date); - } - else { - // Force defaults in case people modify the form: - $node_options = variable_get('node_options_'. $node->type, array('status', 'promote')); - foreach (array('status', 'moderate', 'promote', 'sticky', 'revision') as $key) { - $node->$key = in_array($key, $node_options); - } - } - - // Do node-type-specific validation checks. - node_invoke($node, 'submit'); - node_invoke_nodeapi($node, 'submit'); - - $node->validated = TRUE; - - return $node; -} - -/** - * Perform validation checks on the given node. - */ -function node_validate($node) { - // Convert the node to an object, if necessary. - $node = (object)$node; - - // Make sure the body has the minimum number of words. - // todo use a better word counting algorithm that will work in other languages - if (isset($node->body) && count(explode(' ', $node->body)) < variable_get('minimum_'. $node->type .'_size', 0)) { - form_set_error('body', t('The body of your %type is too short. You need at least %words words.', array('%words' => variable_get('minimum_'. $node->type .'_size', 0), '%type' => node_get_name($node)))); - } - - if (isset($node->nid) && (node_last_changed($node->nid) > $node->changed)) { - form_set_error('changed', t('This content has been modified by another user; changes cannot be saved.')); - } - - if (user_access('administer nodes')) { - // Validate the "authored by" field. - if (!empty($node->name) && !($account = user_load(array('name' => $node->name)))) { - // The use of empty() is mandatory in the context of usernames - // as the empty string denotes the anonymous user. In case we - // are dealing with an anonymous user we set the user ID to 0. - form_set_error('name', t('The username %name does not exist.', array ('%name' => theme('placeholder', $node->name)))); - } - - // Validate the "authored on" field. As of PHP 5.1.O, strtotime returns FALSE instead of -1 upon failure. - if (strtotime($node->date) <= 0) { - form_set_error('date', t('You have to specify a valid date.')); - } - } - - // Do node-type-specific validation checks. - node_invoke($node, 'validate'); - node_invoke_nodeapi($node, 'validate'); -} - -function node_form_validate($form_id, $edit) { - node_validate($edit); -} - -function node_object_prepare(&$node) { - if (user_access('administer nodes')) { - // Set up default values, if required. - if (!isset($node->created)) { - $node->created = time(); - } - - if (!isset($node->date)) { - $node->date = format_date($node->created, 'custom', 'Y-m-d H:i:s O'); - } - } - node_invoke($node, 'prepare'); - node_invoke_nodeapi($node, 'prepare'); -} - -/** - * Generate the node editing form. - */ -function node_form($node) { - $node = (object)$node; - $form = node_form_array($node); - return drupal_get_form($node->type .'_node_form', $form, 'node_form'); -} - -/** -* Generate the node editing form array. -*/ -function node_form_array($node) { - node_object_prepare($node); - - // Set the id of the top-level form tag - $form['#id'] = 'node-form'; - - /** - * Basic node information. - * These elements are just values so they are not even sent to the client. - */ - foreach (array('nid', 'vid', 'uid', 'created', 'changed', 'type') as $key) { - $form[$key] = array('#type' => 'value', '#value' => $node->$key); - } - - // Get the node-specific bits. - $form = array_merge_recursive($form, node_invoke($node, 'form')); - if (!isset($form['title']['#weight'])) { - $form['title']['#weight'] = -5; - } - - $node_options = variable_get('node_options_'. $node->type, array('status', 'promote')); - // If this is a new node, fill in the default values. - if (!isset($node->nid)) { - foreach (array('status', 'moderate', 'promote', 'sticky', 'revision') as $key) { - $node->$key = in_array($key, $node_options); - } - global $user; - $node->uid = $user->uid; - } - else { - // Nodes being edited should always be preset with the default revision setting. - $node->revision = in_array('revision', $node_options); - } - $form['#node'] = $node; - - if (user_access('administer nodes')) { - // Node author information - $form['author'] = array('#type' => 'fieldset', '#title' => t('Authoring information'), '#collapsible' => TRUE, '#collapsed' => TRUE, '#weight' => 20); - $form['author']['name'] = array('#type' => 'textfield', '#title' => t('Authored by'), '#maxlength' => 60, '#autocomplete_path' => 'user/autocomplete', '#default_value' => $node->name ? $node->name : '', '#weight' => -1, '#description' => t('Leave blank for %anonymous.', array('%anonymous' => theme('placeholder', variable_get('anonymous', 'Anonymous'))))); - $form['author']['date'] = array('#type' => 'textfield', '#title' => t('Authored on'), '#maxlength' => 25, '#required' => TRUE, '#default_value' => $node->date); - - // Node options for administrators - $form['options'] = array('#type' => 'fieldset', '#title' => t('Publishing options'), '#collapsible' => TRUE, '#collapsed' => TRUE, '#weight' => 25); - $form['options']['status'] = array('#type' => 'checkbox', '#title' => t('Published'), '#default_value' => $node->status); - $form['options']['moderate'] = array('#type' => 'checkbox', '#title' => t('In moderation queue'), '#default_value' => $node->moderate); - $form['options']['promote'] = array('#type' => 'checkbox', '#title' => t('Promoted to front page'), '#default_value' => $node->promote); - $form['options']['sticky'] = array('#type' => 'checkbox', '#title' => t('Sticky at top of lists'), '#default_value' => $node->sticky); - $form['options']['revision'] = array('#type' => 'checkbox', '#title' => t('Create new revision'), '#default_value' => $node->revision); - } - else { - // Put all of these through as values if the user doesn't have access to them. - foreach (array('uid', 'created') as $key) { - $form[$key] = array('#type' => 'value', '#value' => $node->$key); - } - } - - // Add the buttons. - $form['preview'] = array('#type' => 'button', '#value' => t('Preview'), '#weight' => 40); - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit'), '#weight' => 45); - if ($node->nid && node_access('delete', $node)) { - $form['delete'] = array('#type' => 'button', '#value' => t('Delete'), '#weight' => 50); - } - - $form['#after_build'] = 'node_form_add_preview'; - - return $form; -} - -function node_form_add_preview($form, $edit) { - $op = isset($_POST['op']) ? $_POST['op'] : ''; - if ($op == t('Preview')) { - drupal_validate_form($form['form_id']['#value'], $form); - if (!form_get_errors()) { - $form['node_preview'] = array('#value' => node_preview((object)$edit), '#weight' => -100); - } - } - if (variable_get('node_preview', 0) && (form_get_errors() || $op != t('Preview'))) { - unset($form['submit']); - } - return $form; -} - -function theme_node_form($form) { - $output = ''; - if (isset($form['node_preview'])) { - $output .= form_render($form['node_preview']); - } - - $output .= ''; - return $output; -} - -/** - * Present a node submission form or a set of links to such forms. - */ -function node_add($type) { - global $user; - - // If a node type has been specified, validate its existence. - if (array_key_exists($type, node_get_types()) && node_access('create', $type)) { - // Initialize settings: - $node = array('uid' => $user->uid, 'name' => $user->name, 'type' => $type); - - $output = node_form($node); - drupal_set_title(t('Submit %name', array('%name' => node_get_name($node)))); - } - else { - // If no (valid) node type has been provided, display a node type overview. - foreach (node_get_types() as $type => $name) { - if (module_invoke(node_get_base($type), 'access', 'create', $type)) { - $out = ''; - $output .= form_render($form); - $output .= ''; - $output .= ''; - $output .= ' '; - $output .= ' '; - $output .= ''; - $output .= '- '. l($name, "node/add/$type", array('title' => t('Add a new %s.', array('%s' => $name)))) .'
'; - $out .= '- '. implode("\n", module_invoke_all('help', 'node/add#'. $type)) .'
'; - $item[$name] = $out; - } - } - - if (isset($item)) { - uasort($item, 'strnatcasecmp'); - $output = t('Choose the appropriate item from the list:') .'- '. implode('', $item) .'
'; - if ($node->teaser && $node->teaser != $node->body) { - drupal_set_message(t('The trimmed version of your post shows what your post looks like when promoted to the main page or when exported for syndication. You can insert the delimiter "<!--break-->" (without the quotes) to fine-tune where your post gets split.')); - $output .= '\n"; - - return $output; -} - -function node_form_submit($form_id, $edit) { - global $user; - - // Fix up the node when required: - $node = node_submit($edit); - - // Prepare the node's body: - if ($node->nid) { - // Check whether the current user has the proper access rights to - // perform this operation: - if (node_access('update', $node)) { - node_save($node); - watchdog('content', t('%type: updated %title.', array('%type' => theme('placeholder', t($node->type)), '%title' => theme('placeholder', $node->title))), WATCHDOG_NOTICE, l(t('view'), 'node/'. $node->nid)); - drupal_set_message(t('The %post was updated.', array ('%post' => node_get_name($node)))); - } - } - else { - // Check whether the current user has the proper access rights to - // perform this operation: - if (node_access('create', $node)) { - node_save($node); - watchdog('content', t('%type: added %title.', array('%type' => theme('placeholder', t($node->type)), '%title' => theme('placeholder', $node->title))), WATCHDOG_NOTICE, l(t('view'), "node/$node->nid")); - drupal_set_message(t('Your %post was created.', array ('%post' => node_get_name($node)))); - } - } - if ($node->nid) { - if (node_access('view', $node)) { - return 'node/'. $node->nid; - } - else { - return ''; - } - } - // it is very unlikely we get here - return FALSE; -} - -/** - * Menu callback -- ask for confirmation of node deletion - */ -function node_delete_confirm() { - $edit = $_POST['edit']; - $edit['nid'] = $edit['nid'] ? $edit['nid'] : arg(1); - $node = node_load($edit['nid']); - - if (node_access('delete', $node)) { - $form['nid'] = array('#type' => 'value', '#value' => $node->nid); - $output = confirm_form('node_delete_confirm', $form, - t('Are you sure you want to delete %title?', array('%title' => theme('placeholder', $node->title))), - $_GET['destination'] ? $_GET['destination'] : 'node/'. $node->nid, t('This action cannot be undone.'), - t('Delete'), t('Cancel') ); - } - - return $output; -} - -/** - * Execute node deletion - */ -function node_delete_confirm_submit($form_id, $form_values) { - if ($form_values['confirm']) { - node_delete($form_values['nid']); - } -} - -/** - * Delete a node. - */ -function node_delete($nid) { - - $node = node_load($nid); - - if (node_access('delete', $node)) { - db_query('DELETE FROM {node} WHERE nid = %d', $node->nid); - db_query('DELETE FROM {node_revisions} WHERE nid = %d', $node->nid); - - // Call the node-specific callback (if any): - node_invoke($node, 'delete'); - node_invoke_nodeapi($node, 'delete'); - - // Clear the cache so an anonymous poster can see the node being deleted. - cache_clear_all(); - - // Remove this node from the search index if needed. - if (function_exists('search_wipe')) { - search_wipe($node->nid, 'node'); - } - drupal_set_message(t('%title has been deleted.', array('%title' => theme('placeholder', $node->title)))); - watchdog('content', t('%type: deleted %title.', array('%type' => theme('placeholder', t($node->type)), '%title' => theme('placeholder', $node->title)))); - } -} - -/** - * Menu callback for revisions related activities. - */ -function node_revisions() { - if (is_numeric(arg(1)) && arg(2) == 'revisions') { - $op = arg(4) ? arg(4) : 'overview'; - switch ($op) { - case 'overview': - $node = node_load(arg(1)); - if ((user_access('view revisions') || user_access('administer nodes')) && node_access('view', $node)) { - return node_revision_overview($node); - } - drupal_access_denied(); - return; - case 'view': - if (is_numeric(arg(3))) { - $node = node_load(arg(1), arg(3)); - if ($node->nid) { - if ((user_access('view revisions') || user_access('administer nodes')) && node_access('view', $node)) { - drupal_set_title(t('Revision of %title from %date', array('%title' => theme('placeholder', $node->title), '%date' => format_date($node->revision_timestamp)))); - return node_show($node, arg(2)); - } - drupal_access_denied(); - return; - } - } - break; - case 'revert': - node_revision_revert(arg(1), arg(3)); - break; - case 'delete': - node_revision_delete(arg(1), arg(3)); - break; - } - } - drupal_not_found(); -} - -/** - * Generate a listing of promoted nodes. - */ -function node_page_default() { - $result = pager_query(db_rewrite_sql('SELECT n.nid, n.sticky, n.created FROM {node} n WHERE n.promote = 1 AND n.status = 1 ORDER BY n.sticky DESC, n.created DESC'), variable_get('default_nodes_main', 10)); - - if (db_num_rows($result)) { - drupal_add_link(array('rel' => 'alternate', - 'type' => 'application/rss+xml', - 'title' => t('RSS'), - 'href' => url('rss.xml', NULL, NULL, TRUE))); - - $output = ''; - while ($node = db_fetch_object($result)) { - $output .= node_view(node_load($node->nid), 1); - } - $output .= theme('pager', NULL, variable_get('default_nodes_main', 10)); - } - else { - $output = t(" -'. t('Preview trimmed version') .'
'; - $output .= node_view(drupal_clone($node), 1, FALSE, 0); - $output .= ''. t('Preview full version') .'
'; - $output .= node_view($node, 0, FALSE, 0); - } - else { - $output .= node_view($node, 0, FALSE, 0); - } - $output .= "Welcome to your new Drupal-powered website. This message will guide you through your first steps with Drupal, and will disappear once you have posted your first piece of content.
-The first thing you will need to do is create the first account. This account will have full administration rights and will allow you to configure your website. Once logged in, you can visit the administration section and set up your site's configuration.
-Drupal comes with various modules, each of which contains a specific piece of functionality. You should visit the module list and enable those modules which suit your website's needs.
-Themes handle the presentation of your website. You can use one of the existing themes, modify them or create your own from scratch.
-We suggest you look around the administration section and explore the various options Drupal offers you. For more information, you can refer to the Drupal handbooks online.
", array('%drupal' => 'http://drupal.org/', '%register' => url('user/register'), '%admin' => url('admin'), '%config' => url('admin/settings'), '%modules' => url('admin/modules'), '%themes' => url('admin/themes'), '%handbook' => 'http://drupal.org/handbooks')); - } - - return $output; -} - -/** - * Menu callback; dispatches control to the appropriate operation handler. - */ -function node_page() { - $op = arg(1); - - if (is_numeric($op)) { - $op = (arg(2) && !is_numeric(arg(2))) ? arg(2) : 'view'; - } - - switch ($op) { - case 'view': - if (is_numeric(arg(1))) { - $node = node_load(arg(1)); - if ($node->nid) { - drupal_set_title(check_plain($node->title)); - return node_show($node, arg(2)); - } - else if (db_result(db_query('SELECT nid FROM {node} WHERE nid = %d', arg(1)))) { - drupal_access_denied(); - } - else { - drupal_not_found(); - } - } - break; - case 'add': - return node_add(arg(2)); - break; - case 'edit': - if ($_POST['op'] == t('Delete')) { - // Note: we redirect from node/uid/edit to node/uid/delete to make the tabs disappear. - if ($_REQUEST['destination']) { - $destination = drupal_get_destination(); - unset($_REQUEST['destination']); - } - drupal_goto('node/'. arg(1) .'/delete', $destination); - } - - if (is_numeric(arg(1))) { - $node = node_load(arg(1)); - if ($node->nid) { - drupal_set_title(check_plain($node->title)); - return node_form($node); - } - else if (db_result(db_query('SELECT nid FROM {node} WHERE nid = %d', arg(1)))) { - drupal_access_denied(); - } - else { - drupal_not_found(); - } - } - break; - default: - drupal_set_title(''); - return node_page_default(); - } -} - -/** - * shutdown function to make sure we always mark the last node processed. - */ -function node_update_shutdown() { - global $last_change, $last_nid; - - if ($last_change && $last_nid) { - variable_set('node_cron_last', $last_change); - variable_set('node_cron_last_nid', $last_nid); - } -} - -/** - * Implementation of hook_update_index(). - */ -function node_update_index() { - global $last_change, $last_nid; - - register_shutdown_function('node_update_shutdown'); - - $last = variable_get('node_cron_last', 0); - $last_nid = variable_get('node_cron_last_nid', 0); - $limit = (int)variable_get('search_cron_limit', 100); - - // Store the maximum possible comments per thread (used for ranking by reply count) - variable_set('node_cron_comments_scale', 1.0 / max(1, db_result(db_query('SELECT MAX(comment_count) FROM {node_comment_statistics}')))); - variable_set('node_cron_views_scale', 1.0 / max(1, db_result(db_query('SELECT MAX(totalcount) FROM {node_counter}')))); - - $result = db_query_range('SELECT GREATEST(c.last_comment_timestamp, n.changed, n.created) as last_change, n.nid FROM {node} n LEFT JOIN {node_comment_statistics} c ON n.nid = c.nid WHERE n.status = 1 AND ((GREATEST(n.created, n.changed, c.last_comment_timestamp) = %d AND n.nid > %d) OR (n.created > %d OR n.changed > %d OR c.last_comment_timestamp > %d)) ORDER BY GREATEST(n.created, n.changed, c.last_comment_timestamp) ASC, n.nid ASC', $last, $last_nid, $last, $last, $last, 0, $limit); - - while ($node = db_fetch_object($result)) { - $last_change = $node->last_change; - $last_nid = $node->nid; - $node = node_load($node->nid); - - // Get node output (filtered and with module-specific fields). - if (node_hook($node, 'view')) { - node_invoke($node, 'view', false, false); - } - else { - $node = node_prepare($node, false); - } - // Allow modules to change $node->body before viewing. - node_invoke_nodeapi($node, 'view', false, false); - - $text = ''. check_plain($node->title) .'
'. $node->body; - - // Fetch extra data normally not visible - $extra = node_invoke_nodeapi($node, 'update index'); - foreach ($extra as $t) { - $text .= $t; - } - - // Update index - search_index($node->nid, 'node', $text); - } -} - -/** - * Implementation of hook_form_alter(). - */ -function node_form_alter($form_id, &$form) { - // Node publishing options - if (isset($form['type']) && $form['type']['#value'] .'_node_settings' == $form_id) { - $form['workflow']['node_options_'. $form['type']['#value']] = array('#type' => 'checkboxes', - '#title' => t('Default options'), - '#default_value' => variable_get('node_options_'. $form['type']['#value'], array('status', 'promote')), - '#options' => array( - 'status' => t('Published'), - 'moderate' => t('In moderation queue'), - 'promote' => t('Promoted to front page'), - 'sticky' => t('Sticky at top of lists'), - 'revision' => t('Create new revision'), - ), - '#description' => t('Users with the administer nodes permission will be able to override these options.'), - ); - } - - // Advanced node search form - elseif ($form_id == 'search_form' && arg(1) == 'node') { - // Keyword boxes: - $form['advanced'] = array( - '#type' => 'fieldset', - '#title' => t('Advanced search'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - '#attributes' => array('class' => 'search-advanced'), - ); - $form['advanced']['keywords'] = array( - '#prefix' => '', - '#suffix' => '', - ); - $form['advanced']['keywords']['or'] = array( - '#type' => 'textfield', - '#title' => t('Containing any of the words'), - '#size' => 30, - '#maxlength' => 255, - ); - $form['advanced']['keywords']['phrase'] = array( - '#type' => 'textfield', - '#title' => t('Containing the phrase'), - '#size' => 30, - '#maxlength' => 255, - ); - $form['advanced']['keywords']['negative'] = array( - '#type' => 'textfield', - '#title' => t('Containing none of the words'), - '#size' => 30, - '#maxlength' => 255, - ); - - // Taxonomy box: - if ($taxonomy = module_invoke('taxonomy', 'form_all', 1)) { - $form['advanced']['category'] = array( - '#type' => 'select', - '#title' => t('Only in the category(s)'), - '#prefix' => '', - '#size' => 10, - '#suffix' => '', - '#options' => $taxonomy, - '#multiple' => TRUE, - ); - } - - // Node types: - $types = node_get_types(); - $form['advanced']['type'] = array( - '#type' => 'checkboxes', - '#title' => t('Only of the type(s)'), - '#prefix' => '', - '#suffix' => '', - '#options' => $types, - ); - $form['advanced']['submit'] = array( - '#type' => 'submit', - '#value' => t('Advanced search'), - '#prefix' => '', - '#suffix' => '
', - ); - - $form['#validate']['node_search_validate'] = array(); - } -} - -/** - * Form API callback for the search form. Registered in node_form_alter(). - */ -function node_search_validate($form_id, $form_values) { - // Initialise using any existing basic search keywords. - $keys = $form_values['processed_keys']['#ref']; - - // Insert extra restrictions into the search keywords string. - if (isset($form_values['type']) && is_array($form_values['type'])) { - // Retrieve selected types - Forms API sets the value of unselected checkboxes to 0. - $form_values['type'] = array_filter($form_values['type']); - if (count($form_values['type'])) { - $keys = search_query_insert($keys, 'type', implode(',', array_keys($form_values['type']))); - } - } - if (isset($form_values['category']) && is_array($form_values['category'])) { - $keys = search_query_insert($keys, 'category', implode(',', $form_values['category'])); - } - if ($form_values['or'] != '') { - if (preg_match_all('/ ("[^"]+"|[^" ]+)/i', ' '. $form_values['or'], $matches)) { - $keys .= ' '. implode(' OR ', $matches[1]); - } - } - if ($form_values['negative'] != '') { - if (preg_match_all('/ ("[^"]+"|[^" ]+)/i', ' '. $form_values['negative'], $matches)) { - $keys .= ' -'. implode(' -', $matches[1]); - } - } - if ($form_values['phrase'] != '') { - $keys .= ' "'. str_replace('"', ' ', $form_values['phrase']) .'"'; - } - if (!empty($keys)) { - $form_values['processed_keys']['#ref'] = trim($keys); - } -} - -/** - * @defgroup node_access Node access rights - * @{ - * The node access system determines who can do what to which nodes. - * - * In determining access rights for a node, node_access() first checks - * whether the user has the "administer nodes" permission. Such users have - * unrestricted access to all nodes. Then the node module's hook_access() - * is called, and a TRUE or FALSE return value will grant or deny access. - * This allows, for example, the blog module to always grant access to the - * blog author, and for the book module to always deny editing access to - * PHP pages. - * - * If node module does not intervene (returns NULL), then the - * node_access table is used to determine access. All node access - * modules are queried using hook_node_grants() to assemble a list of - * "grant IDs" for the user. This list is compared against the table. - * If any row contains the node ID in question (or 0, which stands for "all - * nodes"), one of the grant IDs returned, and a value of TRUE for the - * operation in question, then access is granted. Note that this table is a - * list of grants; any matching row is sufficient to grant access to the - * node. - * - * In node listings, the process above is followed except that - * hook_access() is not called on each node for performance reasons and for - * proper functioning of the pager system. When adding a node listing to your - * module, be sure to use db_rewrite_sql() to add - * the appropriate clauses to your query for access checks. - * - * To see how to write a node access module of your own, see - * node_access_example.module. - */ - -/** - * Determine whether the current user may perform the given operation on the - * specified node. - * - * @param $op - * The operation to be performed on the node. Possible values are: - * - "view" - * - "update" - * - "delete" - * - "create" - * @param $node - * The node object (or node array) on which the operation is to be performed, - * or node type (e.g. 'forum') for "create" operation. - * @param $uid - * The user ID on which the operation is to be performed. - * @return - * TRUE if the operation may be performed. - */ -function node_access($op, $node = NULL, $uid = NULL) { - // Convert the node to an object if necessary: - if ($op != 'create') { - $node = (object)$node; - } - // If the node is in a restricted format, disallow editing. - if ($op == 'update' && !filter_access($node->format)) { - return FALSE; - } - - if (user_access('administer nodes')) { - return TRUE; - } - - if (!user_access('access content')) { - return FALSE; - } - - // Can't use node_invoke(), because the access hook takes the $op parameter - // before the $node parameter. - $access = module_invoke(node_get_base($node), 'access', $op, $node); - if (!is_null($access)) { - return $access; - } - - // If the module did not override the access rights, use those set in the - // node_access table. - if ($op != 'create' && $node->nid && $node->status) { - $grants = array(); - foreach (node_access_grants($op, $uid) as $realm => $gids) { - foreach ($gids as $gid) { - $grants[] = "(gid = $gid AND realm = '$realm')"; - } - } - - $grants_sql = ''; - if (count($grants)) { - $grants_sql = 'AND ('. implode(' OR ', $grants) .')'; - } - - $sql = "SELECT COUNT(*) FROM {node_access} WHERE (nid = 0 OR nid = %d) $grants_sql AND grant_$op >= 1"; - $result = db_query($sql, $node->nid); - return (db_result($result)); - } - return FALSE; -} - -/** - * Generate an SQL join clause for use in fetching a node listing. - * - * @param $node_alias - * If the node table has been given an SQL alias other than the default - * "n", that must be passed here. - * @param $node_access_alias - * If the node_access table has been given an SQL alias other than the default - * "na", that must be passed here. - * @return - * An SQL join clause. - */ -function _node_access_join_sql($node_alias = 'n', $node_access_alias = 'na') { - if (user_access('administer nodes')) { - return ''; - } - - return 'INNER JOIN {node_access} '. $node_access_alias .' ON '. $node_access_alias .'.nid = '. $node_alias .'.nid'; -} - -/** - * Generate an SQL where clause for use in fetching a node listing. - * - * @param $op - * The operation that must be allowed to return a node. - * @param $node_access_alias - * If the node_access table has been given an SQL alias other than the default - * "na", that must be passed here. - * @return - * An SQL where clause. - */ -function _node_access_where_sql($op = 'view', $node_access_alias = 'na', $uid = NULL) { - if (user_access('administer nodes')) { - return; - } - - $grants = array(); - foreach (node_access_grants($op, $uid) as $realm => $gids) { - foreach ($gids as $gid) { - $grants[] = "($node_access_alias.gid = $gid AND $node_access_alias.realm = '$realm')"; - } - } - - $grants_sql = ''; - if (count($grants)) { - $grants_sql = 'AND ('. implode(' OR ', $grants) .')'; - } - - $sql = "$node_access_alias.grant_$op >= 1 $grants_sql"; - return $sql; -} - -/** - * Fetch an array of permission IDs granted to the given user ID. - * - * The implementation here provides only the universal "all" grant. A node - * access module should implement hook_node_grants() to provide a grant - * list for the user. - * - * @param $op - * The operation that the user is trying to perform. - * @param $uid - * The user ID performing the operation. If omitted, the current user is used. - * @return - * An associative array in which the keys are realms, and the values are - * arrays of grants for those realms. - */ -function node_access_grants($op, $uid = NULL) { - global $user; - - if (isset($uid)) { - $user_object = user_load(array('uid' => $uid)); - } - else { - $user_object = $user; - } - - return array_merge(array('all' => array(0)), module_invoke_all('node_grants', $user_object, $op)); -} - -/** - * Determine whether the user has a global viewing grant for all nodes. - */ -function node_access_view_all_nodes() { - static $access; - - if (!isset($access)) { - $grants = array(); - foreach (node_access_grants('view') as $realm => $gids) { - foreach ($gids as $gid) { - $grants[] = "(gid = $gid AND realm = '$realm')"; - } - } - - $grants_sql = ''; - if (count($grants)) { - $grants_sql = 'AND ('. implode(' OR ', $grants) .')'; - } - - $sql = "SELECT COUNT(*) FROM {node_access} WHERE nid = 0 $grants_sql AND grant_view >= 1"; - $result = db_query($sql); - $access = db_result($result); - } - - return $access; -} - -/** - * Implementation of hook_db_rewrite_sql - */ -function node_db_rewrite_sql($query, $primary_table, $primary_field) { - if ($primary_field == 'nid' && !node_access_view_all_nodes()) { - $return['join'] = _node_access_join_sql($primary_table); - $return['where'] = _node_access_where_sql(); - $return['distinct'] = 1; - return $return; - } -} - -/** - * @} End of "defgroup node_access". - */ - - diff --git a/modules/page/page.module b/modules/page/page.module deleted file mode 100644 index 320ce8accbd7c2c08558e8f46c69ed5e87d52f6a..0000000000000000000000000000000000000000 --- a/modules/page/page.module +++ /dev/null @@ -1,100 +0,0 @@ -'. t('The page module allows users to create static pages, which are the most basic type of content. Pages are commonly collected in books via the book module. Users should create a page if the information on the page is static. An example would be an "about" page. ') .''; - $output .= ''. t('When a page is created, a user can set authoring information, configure publishing options, whether readers will be able to post comments. They can also select the content type of the page (e.g., full HTML, filtered HTML). ') .'
'; - $output .= ''. t('As an administrator, you can set the publishing default for a page (in its workflow): you can specify whether a page is by default published, sent to moderation, promoted to the front page, sticky at the top of lists, and whether revisions are enabled by default. You can set the permissions that different user roles have to view, create, and edit pages.') .'
'; - $output .= ''. t('If the location module is enabled, then location specific information can be added. If the trackback module is enabled trackbacks can be configured.') .'
'; - $output .= t('You can
--
-
- read the node administration help at administer >> help >> node. -
- read the page administration help at administer >> help >> page. -
- read the story administration help at administer >> help >> story. -
- create a page at create content >> page. -
- administer page content type at administer >> settings >> content types >> configure page. -
'. t('For more information please read the configuration and customization handbook Page page.', array('%page' => 'http://drupal.org/handbook/modules/page/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables the creation of pages that can be added to the navigation system.'); - case 'node/add#page': - return t('If you want to add a static page, like a contact page or an about page, use a page.'); - } -} - -/** - * Implementation of hook_perm(). - */ -function page_perm() { - return array('create pages', 'edit own pages'); -} - -/** - * Implementation of hook_node_info(). - */ -function page_node_info() { - return array('page' => array('name' => t('page'), 'base' => 'page')); -} - -/** - * Implementation of hook_access(). - */ -function page_access($op, $node) { - global $user; - - if ($op == 'create') { - return user_access('create pages'); - } - - if ($op == 'update' || $op == 'delete') { - if (user_access('edit own pages') && ($user->uid == $node->uid)) { - return TRUE; - } - } -} - -/** - * Implementation of hook_menu(). - */ -function page_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'node/add/page', 'title' => t('page'), - 'access' => user_access('create pages')); - } - - return $items; -} - -/** - * Implementation of hook_form(). - */ -function page_form(&$node) { - - $form['title'] = array('#type' => 'textfield', '#title' => t('Title'), '#required' => TRUE, '#default_value' => $node->title, '#weight' => -5); - - $form['body_filter']['body'] = array('#type' => 'textarea', '#title' => t('Body'), '#default_value' => $node->body, '#rows' => 20, '#required' => TRUE); - $form['body_filter']['format'] = filter_form($node->format); - - $form['log'] = array( - '#type' => 'textarea', '#title' => t('Log message'), '#default_value' => $node->log, '#weight' => 5, - '#description' => t('An explanation of the additions or updates being made to help other authors understand your motivations.') - ); - - return $form; -} - - diff --git a/modules/path/path.module b/modules/path/path.module deleted file mode 100644 index f6f43125b071713108e0f8319a32f37243beb055..0000000000000000000000000000000000000000 --- a/modules/path/path.module +++ /dev/null @@ -1,351 +0,0 @@ -'. t('The path module allows you to specify aliases for Drupal URLs. Such aliases improve readability of URLs for your users and may help internet search engines to index your content more effectively. More than one alias may be created for a given page.') .''; - $output .= t('Some examples of URL aliases are:
--
-
- user/login => login -
- image/tid/16 => store -
- taxonomy/term/7+19+20+21 => store/products/whirlygigs -
- node/3 => contact -
'. t('The path module enables an extra field for aliases in all node input and editing forms (when users have the appropriate permissions). It also provides an interface to view and edit all URL aliases. The two permissions are related to URL aliasing are "administer a list of URL aliases" and "add url aliases". ') .'
'; - $output .= ''. t('This module also comes with user-defined mass URL aliasing capabilities, which is useful if you wish to uniformly use URLs different from the default. For example, you may want to have your URLs presented in a different language. Access to the Drupal source code on the web server is required to set up these kinds of aliases. ') .'
'; - $output .= t('You can
--
-
- set the path for a post with the path module. -
- add a URL alias: administer >> url aliases >> add alias. -
- administer the list of URL aliases: administer >> url aliases. -
- read how to configure clean URLs for your webserver. -
- enable clean url\'s to remove the =? at administer >> settings. -
'. t('For more information please read the configuration and customization handbook Path page.', array('%path' => 'http://drupal.org/handbook/modules/path/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to rename URLs.'); - case 'admin/path': - return t("Drupal provides users complete control over URLs through aliasing. This feature is typically used to make URLs human-readable or easy to remember. For example, one could map the relative URL 'node/1' onto 'about'. Each system path can have multiple aliases.
"); - case 'admin/path/add': - return t('Enter the path you wish to create the alias for, followed by the name of the new alias.
'); - } -} - -/** - * Implementation of hook_menu(). - */ -function path_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/path', 'title' => t('url aliases'), - 'callback' => 'path_admin', - 'access' => user_access('administer url aliases')); - $items[] = array('path' => 'admin/path/edit', 'title' => t('edit alias'), - 'callback' => 'path_admin_edit', - 'access' => user_access('administer url aliases'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/path/delete', 'title' => t('delete alias'), - 'callback' => 'path_admin_delete_confirm', - 'access' => user_access('administer url aliases'), - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/path/list', 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/path/add', 'title' => t('add alias'), - 'callback' => 'path_admin_edit', - 'access' => user_access('administer url aliases'), - 'type' => MENU_LOCAL_TASK); - } - - return $items; -} - -/** - * Menu callback; presents an overview of all URL aliases. - */ -function path_admin() { - return path_overview(); -} - -/** - * Menu callback; handles pages for creating and editing URL aliases. - */ -function path_admin_edit($pid = 0) { - if ($pid) { - $alias = path_load($pid); - drupal_set_title($alias['dst']); - $output = path_form(path_load($pid)); - } - else { - $output = path_form(); - } - - return $output; -} - -/** - * Menu callback; confirms deleting an URL alias - **/ -function path_admin_delete_confirm($pid) { - $path = path_load($pid); - if (user_access('administer url aliases')) { - $form['pid'] = array('#type' => 'value', '#value' => $pid); - $output = confirm_form('path_admin_delete_confirm', $form, - t('Are you sure you want to delete path alias %title?', array('%title' => theme('placeholder', $path['dst']))), - $_GET['destination'] ? $_GET['destination'] : 'admin/path', t('This action cannot be undone.'), - t('Delete'), t('Cancel') ); - } - - return $output; -} - -/** - * Execute URL alias deletion - **/ -function path_admin_delete_confirm_submit($form_id, $form_values) { - if ($form_values['confirm']) { - path_admin_delete($form_values['pid']); - return 'admin/path'; - } -} - -/** - * Post-confirmation; delete an URL alias. - */ -function path_admin_delete($pid = 0) { - db_query('DELETE FROM {url_alias} WHERE pid = %d', $pid); - drupal_set_message(t('The alias has been deleted.')); -} - - - -/** - * Set an aliased path for a given Drupal path, preventing duplicates. - */ -function path_set_alias($path = NULL, $alias = NULL, $pid = NULL) { - if ($path && !$alias) { - db_query("DELETE FROM {url_alias} WHERE src = '%s'", $path); - drupal_clear_path_cache(); - } - else if (!$path && $alias) { - db_query("DELETE FROM {url_alias} WHERE dst = '%s'", $alias); - drupal_clear_path_cache(); - } - else if ($path && $alias) { - $path = urldecode($path); - $path_count = db_result(db_query("SELECT COUNT(src) FROM {url_alias} WHERE src = '%s'", $path)); - $alias = urldecode($alias); - $alias_count = db_result(db_query("SELECT COUNT(dst) FROM {url_alias} WHERE dst = '%s'", $alias)); - - // We have an insert: - if ($path_count == 0 && $alias_count == 0) { - db_query("INSERT INTO {url_alias} (src, dst) VALUES ('%s', '%s')", $path, $alias); - drupal_clear_path_cache(); - } - else if ($path_count >= 1 && $alias_count == 0) { - if ($pid) { - db_query("UPDATE {url_alias} SET dst = '%s', src = '%s' WHERE pid = %d", $alias, $path, $pid); - } - else { - db_query("INSERT INTO {url_alias} (src, dst) VALUES ('%s', '%s')", $path, $alias); - } - drupal_clear_path_cache(); - } - else if ($path_count == 0 && $alias_count == 1) { - db_query("UPDATE {url_alias} SET src = '%s' WHERE dst = '%s'", $path, $alias); - drupal_clear_path_cache(); - } - else if ($path_count == 1 && $alias_count == 1) { - // This will delete the path that alias was originally pointing to: - path_set_alias(NULL, $alias); - path_set_alias($path); - path_set_alias($path, $alias); - } - } -} - -/** - * Return a form for editing or creating an individual URL alias. - */ -function path_form($edit = '') { - - $form['src'] = array('#type' => 'textfield', '#title' => t('Existing system path'), '#default_value' => $edit['src'], '#maxlength' => 64, '#description' => t('Specify the existing path you wish to alias. For example: node/28, forum/1, taxonomy/term/1+2.')); - $form['dst'] = array('#type' => 'textfield', '#default_value' => $edit['dst'], '#maxlength' => 64, '#description' => t('Specify an alternative path by which this data can be accessed. For example, type "about" when writing an about page. Use a relative path and don\'t add a trailing slash or the URL alias won\'t work.')); - - if ($edit['pid']) { - $form['pid'] = array('#type' => 'hidden', '#value' => $edit['pid']); - $form['submit'] = array('#type' => 'submit', '#value' => t('Update alias')); - } - else { - $form['submit'] = array('#type' => 'submit', '#value' => t('Create new alias')); - } - - return drupal_get_form('path_form', $form); -} - -/** - * Implementation of hook_nodeapi(). - * - * Allows URL aliases for nodes to be specified at node edit time rather - * than through the administrative interface. - */ -function path_nodeapi(&$node, $op, $arg) { - if (user_access('create url aliases') || user_access('administer url aliases')) { - switch ($op) { - case 'validate': - $node->path = trim($node->path); - if ($node->path && !valid_url($node->path)) { - form_set_error('path', t('The path is invalid.')); - } - else if (db_result(db_query("SELECT COUNT(dst) FROM {url_alias} WHERE dst = '%s' AND src != '%s'", $node->path, "node/$node->nid"))) { - form_set_error('path', t('The path is already in use.')); - } - break; - - case 'load': - $path = "node/$node->nid"; - $alias = drupal_get_path_alias($path); - if ($alias != $path) { - $node->path = $alias; - } - break; - - case 'insert': - // Don't try to insert if path is NULL. We may have already set - // the alias ahead of time. - if ($node->path) { - path_set_alias("node/$node->nid", $node->path); - } - break; - - case 'update': - path_set_alias("node/$node->nid", $node->path, $node->pid); - break; - - case 'delete': - $path = "node/$node->nid"; - if (drupal_get_path_alias($path) != $path) { - path_set_alias($path); - } - break; - } - } -} - -/** - * Implementation of hook_form_alter(). - */ -function path_form_alter($form_id, &$form) { - if (user_access('create url aliases') && isset($form['type']) && $form['type']['#value'] .'_node_form' == $form_id) { - $path = $form['#node']->path; - $form['path'] = array( - '#type' => 'fieldset', - '#title' => t('URL path settings'), - '#collapsible' => TRUE, - '#collapsed' => empty($path), - '#weight' => 30, - ); - $form['path']['path'] = array( - '#type' => 'textfield', - '#default_value' => $path, - '#maxlength' => 250, - '#collapsible' => TRUE, - '#collapsed' => TRUE, - '#description' => t('Optionally specify an alternative URL by which this node can be accessed. For example, type "about" when writing an about page. Use a relative path and don\'t add a trailing slash or the URL alias won\'t work.'), - ); - if ($path) { - $form['path']['pid'] = array( - '#type' => 'value', - '#value' => db_result(db_query("SELECT pid FROM {url_alias} WHERE dst = '%s'", $path)) - ); - } - } -} - - -/** - * Implementation of hook_perm(). - */ -function path_perm() { - return array('create url aliases', 'administer url aliases'); -} - -/** - * Return a listing of all defined URL aliases. - */ -function path_overview() { - $sql = 'SELECT * FROM {url_alias}'; - $header = array( - array('data' => t('Alias'), 'field' => 'dst', 'sort' => 'asc'), - array('data' => t('System'), 'field' => 'src'), - array('data' => t('Operations'), 'colspan' => '2') - ); - $sql .= tablesort_sql($header); - $result = pager_query($sql, 50); - - $destination = drupal_get_destination(); - while ($data = db_fetch_object($result)) { - $rows[] = array($data->dst, $data->src, l(t('edit'), "admin/path/edit/$data->pid", array(), $destination), l(t('delete'), "admin/path/delete/$data->pid", array(), $destination)); - } - - if (!$rows) { - $rows[] = array(array('data' => t('No URL aliases available.'), 'colspan' => '4')); - } - - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 50, 0, tablesort_pager()); - return $output; -} - -/** - * Fetch a specific URL alias from the database. - */ -function path_load($pid) { - return db_fetch_array(db_query('SELECT * FROM {url_alias} WHERE pid = %d', $pid)); -} - -/** - * Verify that a new URL alias is valid, and save it to the database. - */ -function path_form_submit() { - $edit = $GLOBALS['form_values']; - $src = $edit['src']; - $dst = $edit['dst']; - $pid = $edit['pid']; - - if (!valid_url($src)) { - form_set_error('src', t('The system path %path is invalid.', array('%path' => theme('placeholder', $src)))); - } - - if (!valid_url($dst)) { - form_set_error('dst', t('The alias %alias is invalid.', array('%alias' => theme('placeholder', $dst)))); - } - - if (db_result(db_query("SELECT COUNT(dst) FROM {url_alias} WHERE pid != %d AND dst = '%s'", $pid, $dst))) { - form_set_error('dst', t('The alias %alias is already in use.', array('%alias' => theme('placeholder', $dst)))); - } - - if (form_get_errors()) { - return path_form($edit); - } - else { - path_set_alias($src, $dst, $pid); - - drupal_set_message(t('The alias has been saved.')); - return 'admin/path'; - } -} - - diff --git a/modules/ping/ping.module b/modules/ping/ping.module deleted file mode 100644 index dfc51f03f1c0bd0dc546cf47513d32b932a13e98..0000000000000000000000000000000000000000 --- a/modules/ping/ping.module +++ /dev/null @@ -1,68 +0,0 @@ -'. t('The ping module is useful for notifying interested sites that your site has changed. It automatically sends notifications (called "pings") to the pingomatic service to tell it that your site has changed. In turn pingomatic will ping other services such as weblogs.com, Technorati, blo.gs, BlogRolling, Feedster.com, Moreover, etc.', array('%external-http-pingomatic-com' => 'http://pingomatic.com/')) .''; - $output .= ''. t('The ping module requires
'; - $output .= t('cronor a similar periodic job scheduler to be enabled.') .'You can:
--
-
- enable or disable the ping module at administer >> modules. -
- run your cron job at your sites cron page. -
- read about configuring cron jobs. -
'. t('For more information please read the configuration and customization handbook Ping page.', array('%ping' => 'http://drupal.org/handbook/modules/ping/')) .'
'; - return $output; - case 'admin/modules#description': - return('Alerts other sites when your site has been updated.'); - } -} - -/** - * Implementation of hook_cron(). - * - * Fire off notifications of updates to remote sites. - */ -function ping_cron() { - global $base_url; - - if (variable_get('site_name', 0) && variable_get('site_slogan', 0)) { - if (db_num_rows(db_query("SELECT nid FROM {node} WHERE status = 1 AND moderate = 0 AND (created > '". variable_get('cron_last', time()) ."' OR changed > '". variable_get('cron_last', time()) ."')"), 1)) { - _ping_notify(variable_get('site_name', '') .' - '. variable_get('site_slogan', ''), $base_url); - } - } -} - -/** - * Call hook_ping() in all modules to notify remote sites that there is - * new content at this one. - */ -function _ping_notify($name, $url) { - module_invoke_all('ping', $name, $url); -} - -/** - * Implementation of hook_ping(). - * - * Notifies pingomatic.com, blo.gs, and technorati.com of changes at this site. - */ -function ping_ping($name = '', $url = '') { - - $result = xmlrpc('http://rpc.pingomatic.com', 'weblogUpdates.ping', $name, $url); - - if ($result === FALSE) { - watchdog('directory ping', t('Failed to notify pingomatic.com (site).'), WATCHDOG_WARNING); - } -} - - diff --git a/modules/poll/poll.module b/modules/poll/poll.module deleted file mode 100644 index 7d452d5f44be59d9ec036cf63d7a5cdbdfc6c067..0000000000000000000000000000000000000000 --- a/modules/poll/poll.module +++ /dev/null @@ -1,503 +0,0 @@ -'. t('The poll module can be used to create simple polls for site users. A poll is a simple multiple choice questionnaire which displays the cummulative results of the answers to the poll. Having polls on the site is a good way to get instant feedback from community members.') .''; - $output .= ''. t('Users can create a poll. The title of the poll should be the question, then enter the answers and the "base" vote counts. You can also choose the time period over which the vote will run.The poll item in the navigation menu will take you to a page where you can see all the current polls, vote on them (if you haven\'t already) and view the results.', array('%poll' => url('poll'))) .'
'; - $output .= t('You can
--
-
- view the polls page. -
- administer >> content >> configure >> poll. -
'. t('For more information please read the configuration and customization handbook Poll page.', array('%poll' => 'http://drupal.org/handbook/modules/poll/')) .'
'; - return $output; - case 'admin/modules#description': - return t("Allows your site to capture votes on different topics in the form of multiple choice questions."); - case 'node/add#poll': - return t("A poll is a multiple-choice question which visitors can vote on."); - } -} - -/** - * Implementation of hook_access(). - */ -function poll_access($op, $node) { - if ($op == 'create') { - return user_access('create polls'); - } -} - -/** - * Implementation of hook_block(). - * - * Generates a block containing the latest poll. - */ -function poll_block($op = 'list', $delta = 0) { - if (user_access('access content')) { - if ($op == 'list') { - $blocks[0]['info'] = t('Most recent poll'); - return $blocks; - } - else if ($op == 'view') { - // Retrieve the latest poll. - $sql = db_rewrite_sql("SELECT MAX(n.created) FROM {node} n INNER JOIN {poll} p ON p.nid = n.nid WHERE n.status = 1 AND p.active = 1 AND n.moderate = 0"); - $timestamp = db_result(db_query($sql)); - if ($timestamp) { - $poll = node_load(array('type' => 'poll', 'created' => $timestamp, 'moderate' => 0, 'status' => 1)); - - if ($poll->nid) { - // poll_view() dumps the output into $poll->body. - poll_view($poll, 1, 0, 1); - } - } - $block['subject'] = t('Poll'); - $block['content'] = $poll->body; - return $block; - } - } -} - -/** - * Implementation of hook_cron(). - * - * Closes polls that have exceeded their allowed runtime. - */ -function poll_cron() { - $result = db_query('SELECT p.nid FROM {poll} p INNER JOIN {node} n ON p.nid = n.nid WHERE (n.created + p.runtime) < '. time() .' AND p.active = 1 AND p.runtime != 0'); - while ($poll = db_fetch_object($result)) { - db_query("UPDATE {poll} SET active = 0 WHERE nid = %d", $poll->nid); - } -} - -/** - * Implementation of hook_delete(). - */ -function poll_delete($node) { - db_query("DELETE FROM {poll} WHERE nid = %d", $node->nid); - db_query("DELETE FROM {poll_choices} WHERE nid = %d", $node->nid); - db_query("DELETE FROM {poll_votes} WHERE nid = %d", $node->nid); -} - -/** - * Implementation of hook_submit(). - */ -function poll_submit(&$node) { - // Renumber fields - $node->choice = array_values($node->choice); - $node->teaser = poll_teaser($node); -} - -/** - * Implementation of hook_validate(). - */ -function poll_validate($node) { - node_validate_title($node, t('You have to specify a question.')); - - if (isset($node->title)) { - // Check for at least two options and validate amount of votes: - $realchoices = 0; - // Renumber fields - $node->choice = array_values($node->choice); - foreach ($node->choice as $i => $choice) { - if ($choice['chtext'] != '') { - $realchoices++; - } - if ($choice['chvotes'] < 0) { - form_set_error("choice][$i][chvotes", t('Negative values are not allowed.')); - } - } - - if ($realchoices < 2) { - form_set_error("choice][$realchoices][chtext", t('You must fill in at least two choices.')); - } - } -} - -/** - * Implementation of hook_form(). - */ -function poll_form(&$node) { - $admin = user_access('administer nodes'); - - $form['title'] = array('#type' => 'textfield', '#title' => t('Question'), '#required' => TRUE, '#default_value' => $node->title, '#weight' => -1); - - $form['choice']['choices'] = array('#type' => 'hidden', '#default_value' => max(2, count($node->choice) ? count($node->choice) : 5)); - $form['choice']['morechoices'] = array('#type' => 'checkbox', '#title' => t('Need more choices'), '#default_value' => 0, '#description' => t("If the amount of boxes above isn't enough, check this box and click the Preview button below to add some more."), '#weight' => 1); - $form['choice'] = form_builder('poll_node_form', $form['choice']); - if ($form['choice']['morechoices']['#value']) { - $form['choice']['morechoices']['#value'] = 0; - $form['choice']['choices']['#value'] *= 2; - } - - // if the value was changed in a previous iteration, retain it. - $node->choices = $form['choice']['choices']['#value']; - - // Poll choices - $form['choice'] += array('#type' => 'fieldset', '#title' => t('Choices'), '#prefix' => '', '#suffix' => '', '#tree' => TRUE); - for ($a = 0; $a < $node->choices; $a++) { - $form['choice'][$a]['chtext'] = array('#type' => 'textfield', '#title' => t('Choice %n', array('%n' => ($a + 1))), '#default_value' => $node->choice[$a]['chtext']); - if ($admin) { - $form['choice'][$a]['chvotes'] = array('#type' => 'textfield', '#title' => t('Votes for choice %n', array('%n' => ($a + 1))), '#default_value' => (int)$node->choice[$a]['chvotes'], '#size' => 5, '#maxlength' => 7); - } - } - - // Poll attributes - $_duration = array(0 => t('Unlimited')) + drupal_map_assoc(array(86400, 172800, 345600, 604800, 1209600, 2419200, 4838400, 9676800, 31536000), "format_interval"); - $_active = array(0 => t('Closed'), 1 => t('Active')); - - if ($admin) { - $form['settings'] = array('#type' => 'fieldset', '#title' => t('Settings')); - $form['settings']['active'] = array('#type' => 'radios', '#title' => t('Poll status'), '#default_value' => isset($node->active) ? $node->active : 1, '#options' => $_active, '#description' => t('When a poll is closed, visitors can no longer vote for it.')); - } - $form['settings']['runtime'] = array('#type' => 'select', '#title' => t('Poll duration'), '#default_value' => $node->runtime ? $node->runtime : 0, '#options' => $_duration, '#description' => t('After this period, the poll will be closed automatically.')); - - return $form; -} - -function poll_insert($node) { - if (!user_access('administer nodes')) { - // Make sure all votes are 0 initially - foreach ($node->choice as $i => $choice) { - $node->choice[$i]['chvotes'] = 0; - } - $node->active = 1; - } - - db_query("INSERT INTO {poll} (nid, runtime, active) VALUES (%d, %d, %d)", $node->nid, $node->runtime, $node->active); - - foreach ($node->choice as $choice) { - if ($choice['chtext'] != '') { - db_query("INSERT INTO {poll_choices} (nid, chtext, chvotes, chorder) VALUES (%d, '%s', %d, %d)", $node->nid, $choice['chtext'], $choice['chvotes'], $i++); - } - } -} - -/** - * Implementation of hook_menu(). - */ -function poll_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'node/add/poll', 'title' => t('poll'), - 'access' => user_access('create polls')); - $items[] = array('path' => 'poll', 'title' => t('polls'), - 'callback' => 'poll_page', - 'access' => user_access('access content'), - 'type' => MENU_SUGGESTED_ITEM); - - $items[] = array('path' => 'poll/vote', - 'title' => t('vote'), - 'callback' => 'poll_vote', - 'access' => user_access('vote on polls'), - 'type' => MENU_CALLBACK); - } - else { - if (arg(0) == 'node' && is_numeric(arg(1))) { - $node = node_load(arg(1)); - - if ($node->type == 'poll' && $node->allowvotes) { - $items[] = array('path' => 'node/'. arg(1) .'/results', - 'title' => t('results'), - 'callback' => 'poll_results', - 'access' => user_access('access content'), - 'weight' => 3, - 'type' => MENU_LOCAL_TASK); - } - } - } - - return $items; -} - -/** - * Implementation of hook_load(). - */ -function poll_load($node) { - global $user; - - // Load the appropriate choices into the $node object - $poll = db_fetch_object(db_query("SELECT runtime, active FROM {poll} WHERE nid = %d", $node->nid)); - - $result = db_query("SELECT chtext, chvotes, chorder FROM {poll_choices} WHERE nid = %d ORDER BY chorder", $node->nid); - while ($choice = db_fetch_array($result)) { - $poll->choice[$choice['chorder']] = $choice; - } - - // Determine whether or not this user is allowed to vote - $poll->allowvotes = FALSE; - if (user_access('vote on polls') && $poll->active) { - if ($user->uid && db_num_rows(db_query('SELECT uid FROM {poll_votes} WHERE nid = %d AND uid = %d', $node->nid, $user->uid)) == 0) { - $poll->allowvotes = TRUE; - } - else if ($user->uid == 0 && db_num_rows(db_query("SELECT hostname FROM {poll_votes} WHERE nid = %d AND hostname = '%s'", $node->nid, $_SERVER['REMOTE_ADDR'])) == 0) { - $poll->allowvotes = TRUE; - } - } - return $poll; -} - -/** - * Implementation of hook_node_info(). - */ -function poll_node_info() { - return array('poll' => array('name' => t("poll"), 'base' => 'poll')); -} - -function poll_page() { - // List all polls - $sql = "SELECT n.nid, n.title, p.active, n.created, SUM(c.chvotes) AS votes FROM {node} n INNER JOIN {poll} p ON n.nid = p.nid INNER JOIN {poll_choices} c ON n.nid = c.nid WHERE n.status = 1 AND n.moderate = 0 GROUP BY n.nid, n.title, p.active, n.created ORDER BY n.created DESC"; - $sql = db_rewrite_sql($sql); - $result = pager_query($sql, 15); - $output = '- ';
- while ($node = db_fetch_object($result)) {
- $output .= '
- '. l($node->title, "node/$node->nid") .' - '. format_plural($node->votes, '1 vote', '%count votes') .' - '. ($node->active ? t('open') : t('closed')) .' '; - } - $output .= '
'; - $output .= ''; - return $output; -} - -/** - * Generates a graphical representation of the results of a poll. - */ -function poll_view_results(&$node, $teaser, $page, $block) { - // Count the votes and find the maximum - foreach ($node->choice as $choice) { - $total_votes += $choice['chvotes']; - $max_votes = max($max_votes, $choice['chvotes']); - } - - foreach ($node->choice as $i => $choice) { - if ($choice['chtext'] != '') { - $poll_results .= theme('poll_bar', check_plain($choice['chtext']), round($choice['chvotes'] * 100 / max($total_votes, 1)), format_plural($choice['chvotes'], '1 vote', '%count votes'), $block); - } - } - - $output .= theme('poll_results', check_plain($node->title), $poll_results, $total_votes, $node->links, $block); - - return $output; -} - -function theme_poll_results($title, $results, $votes, $links, $block) { - if ($block) { - $output .= ''; - $output .= ''; - $output .= form_render($form); - $output .= ''; - $output .= form_render($form['choice']); - $output .= ''; - $output .= form_render($form['nid']); - $output .= form_render($form['vote']); - $output .= ''; - $output .= ''; - $output .= ''. $title .''; - $output .= $results; - $output .= ''. t('Total votes: %votes', array('%votes' => $votes)) .''; - $output .= ''. theme('links', $links) .''; - } - else { - $output .= ''; - $output .= $results; - $output .= ''; - } - - return $output; -} - -function theme_poll_bar($title, $percentage, $votes, $block) { - if ($block) { - $output = ''. t('Total votes: %votes', array('%votes' => $votes)) .''; - $output .= ''. $title .''; - $output .= ''; - $output .= ''. $percentage .'%'; - } - else { - $output = ''. $title .''; - $output .= ''; - $output .= ''. $percentage .'% ('. $votes .')'; - } - - return $output; -} - -/** - * Callback for the 'results' tab for polls you can vote on - */ -function poll_results() { - if ($node = node_load(arg(1))) { - drupal_set_title(check_plain($node->title)); - return node_show($node, 0); - } - else { - drupal_not_found(); - } -} - -/** - * Callback for processing a vote - */ -function poll_vote(&$node) { - global $user; - $nid = arg(1); - - if ($node = node_load($nid)) { - $edit = $_POST['edit']; - $choice = $edit['choice']; - $vote = $_POST['vote']; - - if (isset($choice) && isset($node->choice[$choice])) { - if ($node->allowvotes) { - // Mark the user or host as having voted. - if ($user->uid) { - db_query('INSERT INTO {poll_votes} (nid, uid) VALUES (%d, %d)', $node->nid, $user->uid); - } - else { - db_query("INSERT INTO {poll_votes} (nid, hostname) VALUES (%d, '%s')", $node->nid, $_SERVER['REMOTE_ADDR']); - } - - // Add one to the votes. - db_query("UPDATE {poll_choices} SET chvotes = chvotes + 1 WHERE nid = %d AND chorder = %d", $node->nid, $choice); - - $node->allowvotes = FALSE; - $node->choice[$choice]['chvotes']++; - drupal_set_message(t('Your vote was recorded.')); - } - else { - drupal_set_message(t("You're not allowed to vote on this poll."), 'error'); - } - } - else { - drupal_set_message(t("You didn't specify a valid poll choice."), 'error'); - } - - drupal_goto('node/'. $nid); - } - else { - drupal_not_found(); - } -} - -/** - * Implementation of hook_view(). - * - * @param $block - * An extra parameter that adapts the hook to display a block-ready - * rendering of the poll. - */ -function poll_view(&$node, $teaser = FALSE, $page = FALSE, $block = FALSE) { - global $user; - $output = ''; - - // Special display for side-block - if ($block) { - // No 'read more' link - $node->body = $node->teaser = ''; - - $links = module_invoke_all('link', 'node', $node, 1); - $links[] = l(t('older polls'), 'poll', array('title' => t('View the list of polls on this site.'))); - if ($node->allowvotes && $block) { - $links[] = l(t('results'), 'node/'. $node->nid .'/results', array('title' => t('View the current poll results.'))); - } - - $node->links = $links; - } - - if ($node->allowvotes && ($block || arg(2) != 'results')) { - $output .= poll_view_voting($node, $teaser, $page, $block); - } - else { - $output .= poll_view_results($node, $teaser, $page, $block); - } - - $node->body = $node->teaser = $output; -} - -/** - * Implementation of hook_update(). - */ -function poll_update($node) { - db_query('UPDATE {poll} SET runtime = %d, active = %d WHERE nid = %d', $node->runtime, $node->active, $node->nid); - - db_query('DELETE FROM {poll_choices} WHERE nid = %d', $node->nid); - db_query('DELETE FROM {poll_votes} WHERE nid = %d', $node->nid); - foreach ($node->choice as $choice) { - $chvotes = (int)$choice['chvotes']; - $chtext = $choice['chtext']; - - if ($chtext != '') { - db_query("INSERT INTO {poll_choices} (nid, chtext, chvotes, chorder) VALUES (%d, '%s', %d, %d)", $node->nid, $chtext, $chvotes, $i++); - } - } -} - -/** - * Implementation of hook_user(). - */ -function poll_user($op, &$edit, &$user) { - if ($op == 'delete') { - db_query('UPDATE {poll_votes} SET uid = 0 WHERE uid = %d', $user->uid); - } -} diff --git a/modules/profile/profile.module b/modules/profile/profile.module deleted file mode 100644 index d08b8be9407907b02d1544fa6da0590db83aca68..0000000000000000000000000000000000000000 --- a/modules/profile/profile.module +++ /dev/null @@ -1,776 +0,0 @@ -'. t('The profile module allows you to define custom fields (such as country, real name, age, ...) in the user profile. This permits users of a site to share more information about themselves, and can help community-based sites to organize users around profile fields.') .''; - $output .= t('The following types of fields can be added to the user profile:
--
-
- single-line textfield -
- multi-line textfield -
- checkbox -
- list selection -
- freeform list -
- URL -
- date -
You can
--
-
- view user profiles. -
- administer profile settings: administer >> settings >> profiles. -
'. t('For more information please read the configuration and customization handbook Profile page.', array('%profile' => 'http://drupal.org/handbook/modules/profile/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Supports configurable user profiles.'); - case 'admin/settings/profile': - return t('Here you can define custom fields that users can fill in in their user profile (such as country, real name, age, ...).
'); - } -} - -/** - * Implementation of hook_menu(). - */ -function profile_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'profile', - 'title' => t('user list'), - 'callback' => 'profile_browse', - 'access' => user_access('access user profiles'), - 'type' => MENU_SUGGESTED_ITEM); - $items[] = array('path' => 'admin/settings/profile', - 'title' => t('profiles'), - 'callback' => 'profile_admin_overview'); - $items[] = array('path' => 'admin/settings/profile/add', - 'title' => t('add field'), - 'callback' => 'profile_field_form', - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/settings/profile/edit', - 'title' => t('edit field'), - 'callback' => 'profile_field_form', - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/settings/profile/delete', - 'title' => t('delete field'), - 'callback' => 'profile_field_delete', - 'type' => MENU_CALLBACK); - } - - return $items; -} - -/** - * Implementation of hook_block(). - */ -function profile_block($op = 'list', $delta = 0, $edit = array()) { - - if ($op == 'list') { - $blocks[0]['info'] = t('Author information'); - - return $blocks; - } - else if ($op == 'configure' && $delta == 0) { - // Compile a list of fields to show - $fields = array(); - $result = db_query('SELECT name, title, weight, visibility FROM {profile_fields} WHERE visibility IN (%d, %d) ORDER BY weight', PROFILE_PUBLIC, PROFILE_PUBLIC_LISTINGS); - while ($record = db_fetch_object($result)) { - $fields[$record->name] = $record->title; - } - $fields['user_profile'] = t('Link to full user profile'); - $form['profile_block_author_fields'] = array('#type' => 'checkboxes', - '#title' => t('Profile fields to display'), - '#default_value' => variable_get('profile_block_author_fields', NULL), - '#options' => $fields, - '#description' => t('Select which profile fields you wish to display in the block. Only fields designated as public in the profile field configuration are available.', array('%profile-admin' => url('admin/settings/profile'))), - ); - return $form; - } - else if ($op == 'save' && $delta == 0) { - variable_set('profile_block_author_fields', $edit['profile_block_author_fields']); - } - else if ($op == 'view') { - if (user_access('access user profiles')) { - if ((arg(0) == 'node') && is_numeric(arg(1)) && (arg(2) == NULL)) { - $node = node_load(arg(1)); - $account = user_load(array('uid' => $node->uid)); - - if ($use_fields = variable_get('profile_block_author_fields', array())) { - // Compile a list of fields to show. - $fields = array(); - $result = db_query('SELECT name, title, type, visibility, weight FROM {profile_fields} WHERE visibility IN (%d, %d) ORDER BY weight', PROFILE_PUBLIC, PROFILE_PUBLIC_LISTINGS); - while ($record = db_fetch_object($result)) { - // Ensure that field is displayed only if it is among the defined block fields and, if it is private, the user has appropriate permissions. - if (isset($use_fields[$record->name]) && $use_fields[$record->name]) { - $fields[] = $record; - } - } - } - - if ($fields) { - $fields = _profile_update_user_fields($fields, $account); - $output .= theme('profile_block', $account, $fields, true); - } - - if (isset($use_fields['user_profile']) && $use_fields['user_profile']) { - $output .= '' . l(t('View full user profile'), 'user/' . $account->uid) . ''; - } - } - - if ($output) { - $block['subject'] = t('About %name', array('%name' => $account->name)); - $block['content'] = $output; - return $block; - } - } - } -} - -/** - * Implementation of hook_user(). - */ -function profile_user($type, &$edit, &$user, $category = NULL) { - switch ($type) { - case 'load': - return profile_load_profile($user); - case 'register': - return profile_form_profile($edit, $user, $category); - case 'update': - case 'insert': - return profile_save_profile($edit, $user, $category); - case 'view': - return profile_view_profile($user); - case 'form': - return profile_form_profile($edit, $user, $category); - case 'validate': - return profile_validate_profile($edit, $category); - case 'categories': - return profile_categories(); - case 'delete': - db_query('DELETE FROM {profile_values} WHERE uid = %d', $user->uid); - } -} - -/** - * Menu callback: Generate a form to add/edit a user profile field. - */ -function profile_field_form($arg = NULL) { - if (arg(3) == 'edit') { - if (is_numeric($arg)) { - $fid = $arg; - - $edit = db_fetch_array(db_query('SELECT * FROM {profile_fields} WHERE fid = %d', $fid)); - - if (!$edit) { - drupal_not_found(); - return; - } - drupal_set_title(t('edit %title', array('%title' => $edit['title']))); - $form['fid'] = array('#type' => 'value', - '#value' => $fid, - ); - $type = $edit['type']; - } - else { - drupal_not_found(); - return; - } - } - else { - $types = _profile_field_types(); - if (!isset($types[$arg])) { - drupal_not_found(); - return; - } - $type = $arg; - drupal_set_title(t('add new %type', array('%type' => $types[$type]))); - $edit = array('name' => 'profile_'); - $form['type'] = array('#type' => 'value', '#value' => $type); - } - $form['fields'] = array('#type' => 'fieldset', - '#title' => t('Field settings'), - ); - $form['fields']['category'] = array('#type' => 'textfield', - '#title' => t('Category'), - '#default_value' => $edit['category'], - '#description' => t('The category the new field should be part of. Categories are used to group fields logically. An example category is "Personal information".'), - '#required' => TRUE, - ); - $form['fields']['title'] = array('#type' => 'textfield', - '#title' => t('Title'), - '#default_value' => $edit['title'], - '#description' => t('The title of the new field. The title will be shown to the user. An example title is "Favorite color".'), - '#required' => TRUE, - ); - $form['fields']['name'] = array('#type' => 'textfield', - '#title' => t('Form name'), - '#default_value' => $edit['name'], - '#description' => t('The name of the field. The form name is not shown to the user but used internally in the HTML code and URLs. -Unless you know what you are doing, it is highly recommended that you prefix the form name withprofile_to avoid name clashes with other fields. Spaces or any other special characters except dash (-) and underscore (_) are not allowed. An example name is "profile_favorite_color" or perhaps just "profile_color".'), - '#required' => TRUE, - ); - $form['fields']['explanation'] = array('#type' => 'textarea', - '#title' => t('Explanation'), - '#default_value' => $edit['explanation'], - '#description' => t('An optional explanation to go with the new field. The explanation will be shown to the user.'), - ); - if ($type == 'selection') { - $form['fields']['options'] = array('#type' => 'textarea', - '#title' => t('Selection options'), - '#default_value' => $edit['options'], - '#description' => t('A list of all options. Put each option on a separate line. Example options are "red", "blue", "green", etc.'), - ); - } - $form['fields']['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $edit['weight'], - '#delta' => 5, - '#description' => t('The weights define the order in which the form fields are shown. Lighter fields "float up" towards the top of the category.'), - ); - $form['fields']['visibility'] = array('#type' => 'radios', - '#title' => t('Visibility'), - '#default_value' => isset($edit['visibility']) ? $edit['visibility'] : PROFILE_PUBLIC, - '#options' => array(PROFILE_HIDDEN => t('Hidden profile field, only accessible by administrators, modules and themes.'), PROFILE_PRIVATE => t('Private field, content only available to privileged users.'), PROFILE_PUBLIC => t('Public field, content shown on profile page but not used on member list pages.'), PROFILE_PUBLIC_LISTINGS => t('Public field, content shown on profile page and on member list pages.')), - ); - if ($type == 'selection' || $type == 'list') { - $form['fields']['page'] = array('#type' => 'textfield', - '#title' => t('Page title'), - '#default_value' => $edit['page'], - '#description' => t('The title of the page showing all users with the specified field. The word%valuewill be substituted with the corresponding value. An example page title is "People whose favorite color is %value". This is only applicable for a public field.'), - ); - } - else { - $form['fields']['page'] = array('#type' => 'textfield', - '#title' => t('Page title'), - '#default_value' => $edit['page'], - '#description' => t('The title of the page showing all users with the specified field. Only applicable if the field is configured to be shown on member listings.'), - ); - } - $form['fields']['required'] = array('#type' => 'checkbox', - '#title' => t('The user must enter a value.'), - '#default_value' => $edit['required'], - ); - $form['fields']['register'] = array('#type' => 'checkbox', - '#title' => t('Visible in user registration form.'), - '#default_value' => $edit['register'], - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Save field'), - ); - return drupal_get_form('profile_field_form', $form); -} - -/** - * Validate profile_field_form submissions. - */ -function profile_field_form_validate($form_id, $form_values) { - // Validate the 'field name': - if (eregi('[^a-z0-9_-]', $form_values['name'])) { - form_set_error('name', t('The specified form name contains one or more illegal characters. Spaces or any other special characters expect dash (-) and underscore (_) are not allowed.')); - } - - if (in_array($form_values['name'], user_fields())) { - form_set_error('name', t('The specified form name is reserved for use by Drupal.')); - } - // Validate the category: - if (!$form_values['category']) { - form_set_error('category', t('You must enter a category.')); - } - if ($form_values['category'] == 'account') { - form_set_error('category', t('The specified category name is reserved for use by Drupal.')); - } - $args1 = array($form_values['title'], $form_values['category']); - $args2 = array($form_values['name']); - $query_suffix = ''; - - if (isset($form_values['fid'])) { - $args1[] = $args2[] = $form_values['fid']; - $query_suffix = ' AND fid != %d'; - } - - if (db_result(db_query("SELECT fid FROM {profile_fields} WHERE title = '%s' AND category = '%s'". $query_suffix, $args1))) { - form_set_error('title', t('The specified title is already in use.')); - } - if (db_result(db_query("SELECT fid FROM {profile_fields} WHERE name = '%s'". $query_suffix, $args2))) { - form_set_error('name', t('The specified name is already in use.')); - } -} - -/** - * Process profile_field_form submissions. - */ -function profile_field_form_submit($form_id, $form_values) { - if (!isset($form_values['fid'])) { - db_query("INSERT INTO {profile_fields} (title, name, explanation, category, type, weight, required, register, visibility, options, page) VALUES ('%s', '%s', '%s', '%s', '%s', %d, %d, %d, %d, '%s', '%s')", $form_values['title'], $form_values['name'], $form_values['explanation'], $form_values['category'], $form_values['type'], $form_values['weight'], $form_values['required'], $form_values['register'], $form_values['visibility'], $form_values['options'], $form_values['page']); - - drupal_set_message(t('The field has been created.')); - watchdog('profile', t('Profile field %field added under category %category.', array('%field' => theme('placeholder', $form_values['title']), '%category' => theme('placeholder', $form_values['category']))), WATCHDOG_NOTICE, l(t('view'), 'admin/settings/profile')); - } - else { - db_query("UPDATE {profile_fields} SET title = '%s', name = '%s', explanation = '%s', category = '%s', weight = %d, required = %d, register = %d, visibility = %d, options = '%s', page = '%s' WHERE fid = %d", $form_values['title'], $form_values['name'], $form_values['explanation'], $form_values['category'], $form_values['weight'], $form_values['required'], $form_values['register'], $form_values['visibility'], $form_values['options'], $form_values['page'], $form_values['fid']); - - drupal_set_message(t('The field has been updated.')); - } - cache_clear_all(); - - return 'admin/settings/profile'; -} - -/** - * Menu callback; deletes a field from all user profiles. - */ -function profile_field_delete($fid) { - $field = db_fetch_object(db_query("SELECT title FROM {profile_fields} WHERE fid = %d", $fid)); - if (!$field) { - drupal_not_found(); - return; - } - $form['fid'] = array('#type' => 'value', '#value' => $fid); - $form['title'] = array('#type' => 'value', '#value' => $field->title); - - return confirm_form('profile_field_delete', $form, t('Are you sure you want to delete the field %field?', array('%field' => theme('placeholder', $field->title))), 'admin/settings/profile', t('This action cannot be undone. If users have entered values into this field in their profile, these entries will also be deleted. If you want to keep the user-entered data, instead of deleting the field you may wish to edit this field and change it to a %hidden-field so that it may only be accessed by administrators.', array('%edit-field' => url('admin/settings/profile/edit/' . $fid), '%hidden-field' => theme('placeholder', 'hidden profile field')), t('Delete'), t('Cancel'))); -} - -/** - * Process a field delete form submission. - */ -function profile_field_delete_submit($form_id, $form_values) { - db_query('DELETE FROM {profile_fields} WHERE fid = %d', $form_values['fid']); - db_query('DELETE FROM {profile_values} WHERE fid = %d', $form_values['fid']); - - cache_clear_all(); - - drupal_set_message(t('The field %field has been deleted.', array('%field' => theme('placeholder', $form_values['title'])))); - watchdog('profile', t('Profile field %field deleted.', array('%field' => theme('placeholder', $form_values['title']))), WATCHDOG_NOTICE, l(t('view'), 'admin/settings/profile')); - - return 'admin/settings/profile'; -} - -/** - * Menu callback; display a listing of all editable profile fields. - */ -function profile_admin_overview() { - - $result = db_query('SELECT * FROM {profile_fields} ORDER BY category, weight'); - $rows = array(); - while ($field = db_fetch_object($result)) { - $rows[] = array(check_plain($field->title), $field->name, _profile_field_types($field->type), $field->category, l(t('edit'), "admin/settings/profile/edit/$field->fid"), l(t('delete'), "admin/settings/profile/delete/$field->fid")); - } - if (count($rows) == 0) { - $rows[] = array(array('data' => t('No fields defined.'), 'colspan' => '6')); - } - - $header = array(t('Title'), t('Name'), t('Type'), t('Category'), array('data' => t('Operations'), 'colspan' => '2')); - - $output = theme('table', $header, $rows); - $output .= ''. t('Add new field') .'
'; - $output .= '- ';
- foreach (_profile_field_types() as $key => $value) {
- $output .= '
- '. l($value, "admin/settings/profile/add/$key") .' '; - } - $output .= '
'; - while ($account = db_fetch_object($result)) { - $account = user_load(array('uid' => $account->uid)); - $fields = _profile_update_user_fields($fields, $account); - $output .= theme('profile_listing', $account, $fields); - } - $output .= theme('pager', NULL, 20); - - if ($field->type == 'selection' || $field->type == 'list') { - $title = strtr($field->page, array('%value' => theme('placeholder', $value))); - } - else { - $title = $field->page; - } - $output .= ''; - - drupal_set_title($title); - return $output; - } - else if ($name && !$field->fid) { - drupal_not_found(); - } - else { - // Compile a list of fields to show. - $fields = array(); - $result = db_query('SELECT name, title, type, weight FROM {profile_fields} WHERE visibility = %d ORDER BY category, weight', PROFILE_PUBLIC_LISTINGS); - while ($record = db_fetch_object($result)) { - $fields[] = $record; - } - - // Extract the affected users: - $result = pager_query("SELECT uid, access FROM {users} WHERE uid > 0 AND status != 0 ORDER BY access DESC", 20, 0, NULL); - - $output = ''; - while ($account = db_fetch_object($result)) { - $account = user_load(array('uid' => $account->uid)); - $profile = _profile_update_user_fields($fields, $account); - $output .= theme('profile_listing', $account, $profile); - } - $output .= ''; - $output .= theme('pager', NULL, 20); - - drupal_set_title(t('user list')); - return $output; - } -} - -function profile_load_profile(&$user) { - $result = db_query('SELECT f.name, f.type, v.value FROM {profile_fields} f INNER JOIN {profile_values} v ON f.fid = v.fid WHERE uid = %d', $user->uid); - while ($field = db_fetch_object($result)) { - if (empty($user->{$field->name})) { - $user->{$field->name} = _profile_field_serialize($field->type) ? unserialize($field->value) : $field->value; - } - } -} - -function profile_save_profile(&$edit, &$user, $category) { - if ((arg(0) == 'user' && arg(1) == 'register') || (arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create')) { - $result = db_query('SELECT fid, name, type FROM {profile_fields} WHERE register = 1 AND visibility != %d ORDER BY category, weight', PROFILE_HIDDEN); - } - else { - $result = db_query("SELECT fid, name, type FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') AND visibility != %d", $category, PROFILE_HIDDEN); - // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues. - } - while ($field = db_fetch_object($result)) { - if (_profile_field_serialize($field->type)) { - $edit[$field->name] = serialize($edit[$field->name]); - } - db_query("DELETE FROM {profile_values} WHERE fid = %d AND uid = %d", $field->fid, $user->uid); - db_query("INSERT INTO {profile_values} (fid, uid, value) VALUES (%d, %d, '%s')", $field->fid, $user->uid, $edit[$field->name]); - // Mark field as handled (prevents saving to user->data). - $edit[$field->name] = NULL; - } -} - -function profile_view_field($user, $field) { - // Only allow browsing of private fields for admins. - $browse = user_access('administer users') || $field->visibility != PROFILE_PRIVATE; - - if ($value = $user->{$field->name}) { - switch ($field->type) { - case 'textfield': - return check_plain($value); - case 'textarea': - return check_markup($value); - case 'selection': - return $browse ? l($value, 'profile/'. $field->name .'/'. $value) : check_plain($value); - case 'checkbox': - return $browse ? l($field->title, 'profile/'. $field->name) : check_plain($field->title); - case 'url': - return ''. check_plain($value) .''; - case 'date': - list($format) = explode(' - ', variable_get('date_format_short', 'm/d/Y - H:i'), 2); - // Note: Avoid PHP's date() because it does not handle dates before - // 1970 on Windows. This would make the date field useless for e.g. - // birthdays. - $replace = array('d' => sprintf('%02d', $value['day']), - 'j' => $value['day'], - 'm' => sprintf('%02d', $value['month']), - 'M' => map_month($value['month']), - 'Y' => $value['year'], - 'H:i' => null, - 'g:ia' => null); - return strtr($format, $replace); - case 'list': - $values = split("[,\n\r]", $value); - $fields = array(); - foreach ($values as $value) { - if ($value = trim($value)) { - $fields[] = $browse ? l($value, "profile/". drupal_urlencode($field->name) ."/". drupal_urlencode($value)) : check_plain($value); - } - } - return implode(', ', $fields); - } - } -} - -function profile_view_profile($user) { - - profile_load_profile($user); - - // Show private fields to administrators and people viewing their own account. - if (user_access('administer users') || $GLOBALS['user']->uid == $user->uid) { - $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d ORDER BY category, weight', PROFILE_HIDDEN); - } - else { - $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND visibility != %d ORDER BY category, weight', PROFILE_PRIVATE, PROFILE_HIDDEN); - } - - while ($field = db_fetch_object($result)) { - if ($value = profile_view_field($user, $field)) { - $description = ($field->visibility == PROFILE_PRIVATE) ? t('The content of this field is private and only visible to yourself.') : ''; - $title = ($field->type != 'checkbox') ? check_plain($field->title) : NULL; - $item = array('title' => $title, - 'value' => $value, - 'class' => $field->name, - ); - $fields[$field->category][] = $item; - } - } - return $fields; -} - -function _profile_form_explanation($field) { - $output = $field->explanation; - - if ($field->type == 'list') { - $output .= ' '. t('Put each item on a separate line or separate them by commas. No HTML allowed.'); - } - - if ($field->visibility == PROFILE_PRIVATE) { - $output .= ' '. t('The content of this field is kept private and will not be shown publicly.'); - } - - return $output; -} - -function profile_form_profile($edit, $user, $category) { - if (arg(0) == 'user' && arg(1) == 'register') { - $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND register = 1 ORDER BY category, weight', PROFILE_HIDDEN); - } - elseif (arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create') { - $result = db_query('SELECT * FROM {profile_fields} WHERE register = 1 ORDER BY category, weight'); - } - elseif (user_access('administer users')) { - $result = db_query("SELECT * FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') ORDER BY weight", $category); - } - else { - $result = db_query("SELECT * FROM {profile_fields} WHERE visibility != %d AND LOWER(category) = LOWER('%s') ORDER BY weight", PROFILE_HIDDEN, $category); - // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues. - } - - while ($field = db_fetch_object($result)) { - $category = $field->category; - if (!isset($fields[$category])) { - $fields[$category] = array('#type' => 'fieldset', '#title' => $category, '#weight' => $w++); - } - switch ($field->type) { - case 'textfield': - case 'url': - $fields[$category][$field->name] = array('#type' => 'textfield', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#maxlength' => 255, - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - case 'textarea': - $fields[$category][$field->name] = array('#type' => 'textarea', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - case 'list': - $fields[$category][$field->name] = array('#type' => 'textarea', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - case 'checkbox': - $fields[$category][$field->name] = array('#type' => 'checkbox', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - case 'selection': - $options = array('--'); - $lines = split("[,\n\r]", $field->options); - foreach ($lines as $line) { - if ($line = trim($line)) { - $options[$line] = $line; - } - } - $fields[$category][$field->name] = array('#type' => 'select', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#options' => $options, - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - case 'date': - $fields[$category][$field->name] = array('#type' => 'date', - '#title' => check_plain($field->title), - '#default_value' => $edit[$field->name], - '#description' => _profile_form_explanation($field), - '#required' => $field->required, - ); - break; - } - } - return $fields; -} - -/** - * Helper function: update an array of user fields by calling profile_view_field - */ -function _profile_update_user_fields($fields, $account) { - foreach ($fields as $key => $field) { - if ($value = profile_view_field($account, $field)) { - $fields[$key]->value = $value; - } - } - return $fields; -} - -function profile_validate_profile($edit, $category) { - if (arg(0) == 'user' && arg(1) == 'register') { - $result = db_query('SELECT * FROM {profile_fields} WHERE visibility != %d AND register = 1 ORDER BY category, weight', PROFILE_HIDDEN); - } - elseif (arg(0) == 'admin' && arg(1) == 'user' && arg(2) == 'create') { - $result = db_query('SELECT * FROM {profile_fields} WHERE register = 1 ORDER BY category, weight'); - } - elseif (user_access('administer users')) { - $result = db_query("SELECT * FROM {profile_fields} WHERE LOWER(category) = LOWER('%s') ORDER BY weight", $category); - } - else { - $result = db_query("SELECT * FROM {profile_fields} WHERE visibility != %d AND LOWER(category) = LOWER('%s') ORDER BY weight", PROFILE_HIDDEN, $category); - // Use LOWER('%s') instead of PHP's strtolower() to avoid UTF-8 conversion issues. - } - - while ($field = db_fetch_object($result)) { - if ($edit[$field->name]) { - if ($field->type == 'url') { - if (!valid_url($edit[$field->name], true)) { - form_set_error($field->name, t('The value provided for %field is not a valid URL.', array('%field' => theme('placeholder', $field->title)))); - } - } - } - else if ($field->required && !user_access('administer users')) { - form_set_error($field->name, t('The field %field is required.', array('%field' => theme('placeholder', $field->title)))); - } - } - - return $edit; -} - -function profile_categories() { - $result = db_query("SELECT DISTINCT(category) FROM {profile_fields}"); - while ($category = db_fetch_object($result)) { - $data[] = array('name' => check_plain($category->category), 'title' => $category->category, 'weight' => 3); - } - return $data; -} - -function theme_profile_block($account, $fields = array()) { - - $output .= theme('user_picture', $account); - - foreach ($fields as $field) { - if ($field->value) { - $output .= "$field->title:
\n"; - } - } - - return $output; -} - -function theme_profile_listing($account, $fields = array()) { - - $output = "
$field->value\n"; - $output .= theme('user_picture', $account); - $output .= '\n"; - - return $output; -} - -function _profile_field_types($type = NULL) { - $types = array('textfield' => t('single-line textfield'), - 'textarea' => t('multi-line textfield'), - 'checkbox' => t('checkbox'), - 'selection' => t('list selection'), - 'list' => t('freeform list'), - 'url' => t('URL'), - 'date' => t('date')); - return isset($type) ? $types[$type] : $types; -} - -function _profile_field_serialize($type = NULL) { - return $type == 'date'; -} diff --git a/modules/search/search.module b/modules/search/search.module deleted file mode 100644 index d7129c1e79683a3d068b9946056022dbc3346730..0000000000000000000000000000000000000000 --- a/modules/search/search.module +++ /dev/null @@ -1,1228 +0,0 @@ -'. t('The search module adds the ability to search for content by keywords. Search is often the only practical way to find content on a large site. Search is useful for finding users and posts by searching on keywords.') .''; - $output .= ''. theme('username', $account) ."\n"; - - foreach ($fields as $field) { - if ($field->value) { - $output .= "$field->value\n"; - } - } - - $output .= "'. t('The search engine works by maintaining an index of the words in your site\'s content. It indexes the posts and users. You can adjust the settings to tweak the indexing behaviour. Note that the search requires cron to be set up correctly. The index percentage sets the maximum amount of items that will be indexed in one cron run. Set this number lower if your cron is timing out or if PHP is running out of memory.') .'
'; - $output .= t('You can
--
-
- read about how your site uses cron in the administer >> help >> system. -
- run your cron.php. -
- read about configuring cron jobs. -
- administer >> settings >> search.
'. t('For more information please read the configuration and customization handbook Search page.', array('%search' => 'http://drupal.org/handbook/modules/search/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables site-wide keyword searching.'); - case 'admin/settings/search': - return t(' -The search engine works by maintaining an index of the words in your site\'s content. You can adjust the settings below to tweak the indexing behaviour. Note that the search requires cron to be set up correctly.
-'); - case 'search#noresults': - return t('-
-
- Check if your spelling is correct. -
- Remove quotes around phrases to match each word individually: "blue smurf" will match less than blue smurf. -
- Consider loosening your query with OR: blue smurf will match less than blue OR smurf. -
'. t('%percentage of the site has been indexed.', array('%percentage' => $percentage)) .' '. $count .'
'; - $form['status'] = array('#type' => 'fieldset', '#title' => t('Indexing status')); - $form['status']['status'] = array('#type' => 'markup', '#value' => $status); - $form['status']['wipe'] = array('#type' => 'submit', '#value' => t('Re-index site')); - - $items = drupal_map_assoc(array(10, 20, 50, 100, 200, 500)); - - // Indexing throttle: - $form['indexing_throttle'] = array('#type' => 'fieldset', '#title' => t('Indexing throttle')); - $form['indexing_throttle']['search_cron_limit'] = array('#type' => 'select', '#title' => t('Items to index per cron run'), '#default_value' => variable_get('search_cron_limit', 100), '#options' => $items, '#description' => t('The maximum amount of items that will be indexed in one cron run. Set this number lower if your cron is timing out or if PHP is running out of memory.')); - // Indexing settings: - $form['indexing_settings'] = array('#type' => 'fieldset', '#title' => t('Indexing settings')); - $form['indexing_settings']['info'] = array('#type' => 'markup', '#value' => ''. t('Changing the settings below will cause the site index to be rebuilt. The search index is not cleared but systematically updated to reflect the new settings. Searching will continue to work but new content won\'t be indexed until all existing content has been re-indexed.
The default settings should be appropriate for the majority of sites.
') .''); - $form['indexing_settings']['minimum_word_size'] = array('#type' => 'textfield', '#title' => t('Minimum word length to index'), '#default_value' => variable_get('minimum_word_size', 3), '#size' => 5, '#maxlength' => 3, '#description' => t('The number of characters a word has to be to be indexed. A lower setting means better search result ranking, but also a larger database. Each search query must contain at least one keyword that is this size (or longer).')); - $form['indexing_settings']['overlap_cjk'] = array('#type' => 'checkbox', '#title' => t('Simple CJK handling'), '#default_value' => variable_get('overlap_cjk', true), '#description' => t('Whether to apply a simple Chinese/Japanese/Korean tokenizer based on overlapping sequences. Turn this off if you want to use an external preprocessor for this instead. Does not affect other languages.')); - - // Per module settings - $form = array_merge($form, module_invoke_all('search', 'admin')); - return $form; -} - -/** - * Menu callback: confirm wiping of the index. - */ -function search_wipe_confirm() { - return confirm_form('search_wipe_confirm', $form, t('Are you sure you want to re-index the site?'), - 'admin/settings/search', t(' The search index is not cleared but systematically updated to reflect the new settings. Searching will continue to work but new content won\'t be indexed until all existing content has been re-indexed. This action cannot be undone.'), t('Re-index site'), t('Cancel')); -} - -/** - * Handler for wipe confirmation - */ -function search_wipe_confirm_submit($form_id, &$form) { - if ($form['confirm']) { - search_wipe(); - drupal_set_message(t('The index will be rebuilt.')); - return 'admin/settings/search'; - } -} - -/** - * Wipes a part of or the entire search index. - * - * @param $sid - * (optional) The SID of the item to wipe. If specified, $type must be passed - * too. - * @param $type - * (optional) The type of item to wipe. - */ -function search_wipe($sid = NULL, $type = NULL) { - if ($type == NULL && $sid == NULL) { - module_invoke_all('search', 'reset'); - } - else { - db_query("DELETE FROM {search_dataset} WHERE sid = %d AND type = '%s'", $sid, $type); - db_query("DELETE FROM {search_index} WHERE sid = %d AND type = '%s'", $sid, $type); - db_query("DELETE FROM {search_index} WHERE fromsid = %d AND fromtype = '%s'", $sid, $type); - } -} - -/** - * Marks a word as dirty (or retrieves the list of dirty words). This is used - * during indexing (cron). Words which are dirty have outdated total counts in - * the search_total table, and need to be recounted. - */ -function search_dirty($word = null) { - static $dirty = array(); - if ($word !== null) { - $dirty[$word] = true; - } - else { - return $dirty; - } -} - -/** - * Implementation of hook_cron(). - * - * Fires hook_update_index() in all modules and cleans up dirty words (see - * search_dirty). - */ -function search_cron() { - // We register a shutdown function to ensure that search_total is always up - // to date. - register_shutdown_function('search_update_totals'); - - // Update word index - foreach (module_list() as $module) { - module_invoke($module, 'update_index'); - } -} - -/** - * This function is called on shutdown to ensure that search_total is always - * up to date (even if cron times out or otherwise fails). - */ -function search_update_totals() { - // Update word IDF (Inverse Document Frequency) counts for new/changed words - foreach (search_dirty() as $word => $dummy) { - // Get total count - $total = db_result(db_query("SELECT SUM(score) FROM {search_index} WHERE word = '%s'", $word)); - // Apply Zipf's law to equalize the probability distribution - $total = log10(1 + 1/(max(1, $total))); - db_query("UPDATE {search_total} SET count = %f WHERE word = '%s'", $total, $word); - if (!db_affected_rows()) { - db_query("INSERT INTO {search_total} (word, count) VALUES ('%s', %f)", $word, $total); - } - } - // Find words that were deleted from search_index, but are still in - // search_total. We use a LEFT JOIN between the two tables and keep only the - // rows which fail to join. - $result = db_query("SELECT t.word AS realword, i.word FROM {search_total} t LEFT JOIN {search_index} i ON t.word = i.word WHERE i.word IS NULL"); - while ($word = db_fetch_object($result)) { - db_query("DELETE FROM {search_total} WHERE word = '%s'", $word->realword); - } -} - -/** - * Simplifies a string according to indexing rules. - */ -function search_simplify($text) { - // Decode entities to UTF-8 - $text = decode_entities($text); - - // Lowercase - $text = drupal_strtolower($text); - - // Call an external processor for word handling. - search_preprocess($text); - - // Simple CJK handling - if (variable_get('overlap_cjk', true)) { - $text = preg_replace_callback('/['. PREG_CLASS_CJK .']+/u', 'search_expand_cjk', $text); - } - - // To improve searching for numerical data such as dates, IP addresses - // or version numbers, we consider a group of numerical characters - // separated only by punctuation characters to be one piece. - // This also means that searching for e.g. '20/03/1984' also returns - // results with '20-03-1984' in them. - // Readable regexp: ([number]+)[punctuation]+(?=[number]) - $text = preg_replace('/(['. PREG_CLASS_NUMBERS .']+)['. PREG_CLASS_PUNCTUATION .']+(?=['. PREG_CLASS_NUMBERS .'])/u', '\1', $text); - - // The dot, underscore and dash are simply removed. This allows meaningful - // search behaviour with acronyms and URLs. - $text = preg_replace('/[._-]+/', '', $text); - - // With the exception of the rules above, we consider all punctuation, - // marks, spacers, etc, to be a word boundary. - $text = preg_replace('/['. PREG_CLASS_SEARCH_EXCLUDE . ']+/u', ' ', $text); - - return $text; -} - -/** - * Basic CJK tokenizer. Simply splits a string into consecutive, overlapping - * sequences of characters ('minimum_word_size' long). - */ -function search_expand_cjk($matches) { - $min = variable_get('minimum_word_size', 3); - $str = $matches[0]; - $l = drupal_strlen($str); - // Passthrough short words - if ($l <= $min) { - return ' '. $str .' '; - } - $tokens = ' '; - // FIFO queue of characters - $chars = array(); - // Begin loop - for ($i = 0; $i < $l; ++$i) { - // Grab next character - $current = drupal_substr($str, 0, 1); - $str = substr($str, strlen($current)); - $chars[] = $current; - if ($i >= $min - 1) { - $tokens .= implode('', $chars) .' '; - array_shift($chars); - } - } - return $tokens; -} - -/** - * Splits a string into tokens for indexing. - */ -function search_index_split($text) { - static $last = null; - static $lastsplit = null; - - if ($last == $text) { - return $lastsplit; - } - // Process words - $text = search_simplify($text); - $words = explode(' ', $text); - array_walk($words, '_search_index_truncate'); - - // Save last keyword result - $last = $text; - $lastsplit = $words; - - return $words; -} - -/** - * Helper function for array_walk in search_index_split. - */ -function _search_index_truncate(&$text) { - $text = truncate_utf8($text, 50); -} - -/** - * Invokes hook_search_preprocess() in modules. - */ -function search_preprocess(&$text) { - foreach (module_implements('search_preprocess') as $module) { - $text = module_invoke($module, 'search_preprocess', $text); - } -} - -/** - * Update the full-text search index for a particular item. - * - * @param $sid - * A number identifying this particular item (e.g. node id). - * - * @param $type - * A string defining this type of item (e.g. 'node') - * - * @param $text - * The content of this item. Must be a piece of HTML text. - * - * @ingroup search - */ -function search_index($sid, $type, $text) { - $minimum_word_size = variable_get('minimum_word_size', 3); - - // Link matching - global $base_url; - $node_regexp = '@href=[\'"]?(?:'. preg_quote($base_url, '@') .'/)?(?:\?q=)?/?((?![a-z]+:)[^\'">]+)[\'">]@i'; - - // Multipliers for scores of words inside certain HTML tags. - // Note: 'a' must be included for link ranking to work. - $tags = array('h1' => 25, - 'h2' => 18, - 'h3' => 15, - 'h4' => 12, - 'h5' => 9, - 'h6' => 6, - 'u' => 3, - 'b' => 3, - 'i' => 3, - 'strong' => 3, - 'em' => 3, - 'a' => 10); - - // Strip off all ignored tags to speed up processing, but insert space before/after - // them to keep word boundaries. - $text = str_replace(array('<', '>'), array(' <', '> '), $text); - $text = strip_tags($text, '<'. implode('><', array_keys($tags)) .'>'); - - // Split HTML tags from plain text. - $split = preg_split('/\s*<([^>]+?)>\s*/', $text, -1, PREG_SPLIT_DELIM_CAPTURE); - // Note: PHP ensures the array consists of alternating delimiters and literals - // and begins and ends with a literal (inserting $null as required). - - $tag = false; // Odd/even counter. Tag or no tag. - $link = false; // State variable for link analyser - $score = 1; // Starting score per word - $accum = ' '; // Accumulator for cleaned up data - $tagstack = array(); // Stack with open tags - $tagwords = 0; // Counter for consecutive words - $focus = 1; // Focus state - - $results = array(0 => array()); // Accumulator for words for index - - foreach ($split as $value) { - if ($tag) { - // Increase or decrease score per word based on tag - list($tagname) = explode(' ', $value, 2); - $tagname = drupal_strtolower($tagname); - // Closing or opening tag? - if ($tagname[0] == '/') { - $tagname = substr($tagname, 1); - // If we encounter unexpected tags, reset score to avoid incorrect boosting. - if (!count($tagstack) || $tagstack[0] != $tagname) { - $tagstack = array(); - $score = 1; - } - else { - // Remove from tag stack and decrement score - $score = max(1, $score - $tags[array_shift($tagstack)]); - } - if ($tagname == 'a') { - $link = false; - } - } - else { - if ($tagstack[0] == $tagname) { - // None of the tags we look for make sense when nested identically. - // If they are, it's probably broken HTML. - $tagstack = array(); - $score = 1; - } - else { - // Add to open tag stack and increment score - array_unshift($tagstack, $tagname); - $score += $tags[$tagname]; - } - if ($tagname == 'a') { - // Check if link points to a node on this site - if (preg_match($node_regexp, $value, $match)) { - $path = drupal_get_normal_path($match[1]); - if (preg_match('!(?:node|book)/(?:view/)?([0-9]+)!i', $path, $match)) { - $linknid = $match[1]; - if ($linknid > 0) { - // Note: ignore links to uncachable nodes to avoid redirect bugs. - $node = db_fetch_object(db_query('SELECT n.title, n.nid, n.vid, r.format FROM {node} n INNER JOIN {node_revisions} r ON n.vid = r.vid WHERE n.nid = %d', $linknid)); - if (filter_format_allowcache($node->format)) { - $link = true; - $linktitle = $node->title; - } - } - } - } - } - } - // A tag change occurred, reset counter. - $tagwords = 0; - } - else { - // Note: use of PREG_SPLIT_DELIM_CAPTURE above will introduce empty values - if ($value != '') { - if ($link) { - // Check to see if the node link text is its URL. If so, we use the target node title instead. - if (preg_match('!^https?://!i', $value)) { - $value = $linktitle; - } - } - $words = search_index_split($value); - foreach ($words as $word) { - // Add word to accumulator - $accum .= $word .' '; - $num = is_numeric($word); - // Check wordlength - if ($num || drupal_strlen($word) >= $minimum_word_size) { - // Normalize numbers - if ($num) { - $word = (int)ltrim($word, '-0'); - } - - if ($link) { - if (!isset($results[$linknid])) { - $results[$linknid] = array(); - } - $results[$linknid][$word] += $score * $focus; - } - else { - $results[0][$word] += $score * $focus; - // Focus is a decaying value in terms of the amount of unique words up to this point. - // From 100 words and more, it decays, to e.g. 0.5 at 500 words and 0.3 at 1000 words. - $focus = min(1, .01 + 3.5 / (2 + count($results[0]) * .015)); - } - } - $tagwords++; - // Too many words inside a single tag probably mean a tag was accidentally left open. - if (count($tagstack) && $tagwords >= 15) { - $tagstack = array(); - $score = 1; - } - } - } - } - $tag = !$tag; - } - - search_wipe($sid, $type); - - // Insert cleaned up data into dataset - db_query("INSERT INTO {search_dataset} (sid, type, data) VALUES (%d, '%s', '%s')", $sid, $type, $accum); - - // Insert results into search index - foreach ($results[0] as $word => $score) { - db_query("INSERT INTO {search_index} (word, sid, type, score) VALUES ('%s', %d, '%s', %f)", $word, $sid, $type, $score); - search_dirty($word); - } - unset($results[0]); - - // Now insert links to nodes - foreach ($results as $nid => $words) { - foreach ($words as $word => $score) { - db_query("INSERT INTO {search_index} (word, sid, type, fromsid, fromtype, score) VALUES ('%s', %d, '%s', %d, '%s', %f)", $word, $nid, 'node', $sid, $type, $score); - search_dirty($word); - } - } -} - -/** - * Extract a module-specific search option from a search query. e.g. 'type:book' - */ -function search_query_extract($keys, $option) { - if (preg_match('/(^| )'. $option .':([^ ]*)( |$)/i', $keys, $matches)) { - return $matches[2]; - } -} - -/** - * Return a query with the given module-specific search option inserted in. - * e.g. 'type:book'. - */ -function search_query_insert($keys, $option, $value = '') { - if (search_query_extract($keys, $option)) { - $keys = trim(preg_replace('/(^| )'. $option .':[^ ]*/i', '', $keys)); - } - if ($value != '') { - $keys .= ' '. $option .':'. $value; - } - return $keys; -} - -/** - * Parse a search query into SQL conditions. - * - * We build a query that matches the dataset bodies. - */ -function search_parse_query($text) { - $keys = array('positive' => array(), 'negative' => array()); - - // Tokenize query string - preg_match_all('/ (-?)("[^"]+"|[^" ]+)/i', ' '. $text, $matches, PREG_SET_ORDER); - - if (count($matches) < 1) { - return NULL; - } - - // Classify tokens - $or = false; - foreach ($matches as $match) { - $phrase = false; - // Strip off phrase quotes - if ($match[2]{0} == '"') { - $match[2] = substr($match[2], 1, -1); - $phrase = true; - } - // Simplify keyword according to indexing rules and external preprocessors - $words = search_simplify($match[2]); - // Re-explode in case simplification added more words, except when matching a phrase - $words = $phrase ? array($words) : preg_split('/ /', $words, -1, PREG_SPLIT_NO_EMPTY); - // Negative matches - if ($match[1] == '-') { - $keys['negative'] = array_merge($keys['negative'], $words); - } - // OR operator: instead of a single keyword, we store an array of all - // OR'd keywords. - elseif ($match[2] == 'OR' && count($keys['positive'])) { - $last = array_pop($keys['positive']); - // Starting a new OR? - if (!is_array($last)) { - $last = array($last); - } - $keys['positive'][] = $last; - $or = true; - continue; - } - // Plain keyword - else { - if ($or) { - // Add to last element (which is an array) - $keys['positive'][count($keys['positive']) - 1] = array_merge($keys['positive'][count($keys['positive']) - 1], $words); - } - else { - $keys['positive'] = array_merge($keys['positive'], $words); - } - } - $or = false; - } - - // Convert keywords into SQL statements. - $query = array(); - $query2 = array(); - $arguments = array(); - $arguments2 = array(); - $matches = 0; - // Positive matches - foreach ($keys['positive'] as $key) { - // Group of ORed terms - if (is_array($key) && count($key)) { - $queryor = array(); - $any = false; - foreach ($key as $or) { - list($q, $count) = _search_parse_query($or, $arguments2); - $any |= $count; - if ($q) { - $queryor[] = $q; - $arguments[] = $or; - } - } - if (count($queryor)) { - $query[] = '('. implode(' OR ', $queryor) .')'; - // A group of OR keywords only needs to match once - $matches += ($any > 0); - } - } - // Single ANDed term - else { - list($q, $count) = _search_parse_query($key, $arguments2); - if ($q) { - $query[] = $q; - $arguments[] = $key; - // Each AND keyword needs to match at least once - $matches += $count; - } - } - } - // Negative matches - foreach ($keys['negative'] as $key) { - list($q) = _search_parse_query($key, $arguments2, true); - if ($q) { - $query[] = $q; - $arguments[] = $key; - } - } - $query = implode(' AND ', $query); - - // Build word-index conditions for the first pass - $query2 = substr(str_repeat("i.word = '%s' OR ", count($arguments2)), 0, -4); - - return array($query, $arguments, $query2, $arguments2, $matches); -} - -/** - * Helper function for search_parse_query(); - */ -function _search_parse_query(&$word, &$scores, $not = false) { - $count = 0; - // Determine the scorewords of this word/phrase - if (!$not) { - $split = explode(' ', $word); - foreach ($split as $s) { - $num = is_numeric($s); - if ($num || drupal_strlen($s) >= variable_get('minimum_word_size', 3)) { - $s = $num ? ((int)ltrim($s, '-0')) : $s; - if (!isset($scores[$s])) { - $scores[$s] = $s; - $count++; - } - } - } - } - // Return matching snippet and number of added words - return array("d.data ". ($not ? 'NOT ' : '') ."LIKE '%% %s %%'", $count); -} - -/** - * Do a query on the full-text search index for a word or words. - * - * This function is normally only called by each module that support the - * indexed search (and thus, implements hook_update_index()). - * - * Two queries are performed which can be extended by the caller. - * - * The first query selects a set of possible matches based on the search index - * and any extra given restrictions. This is the classic "OR" search. - * - * SELECT i.type, i.sid, SUM(i.score*t.count) AS relevance - * FROM {search_index} i - * INNER JOIN {search_total} t ON i.word = t.word - * $join1 - * WHERE $where1 AND (...) - * GROUP BY i.type, i.sid - * - * The second query further refines this set by verifying advanced text - * conditions (such as AND, negative or phrase matches), and orders the results - * on a the column or expression 'score': - * - * SELECT i.type, i.sid, $select2 - * FROM temp_search_sids i - * INNER JOIN {search_dataset} d ON i.sid = d.sid AND i.type = d.type - * $join2 - * WHERE (...) - * ORDER BY score DESC - * - * @param $keywords - * A search string as entered by the user. - * - * @param $type - * A string identifying the calling module. - * - * @param $join1 - * (optional) Inserted into the JOIN part of the first SQL query. - * For example "INNER JOIN {node} n ON n.nid = i.sid". - * - * @param $where1 - * (optional) Inserted into the WHERE part of the first SQL query. - * For example "(n.status > %d)". - * - * @param $arguments1 - * (optional) Extra SQL arguments belonging to the first query. - * - * @param $select2 - * (optional) Inserted into the SELECT pat of the second query. Must contain - * a column selected as 'score'. - * defaults to 'i.relevance AS score' - * - * @param $join2 - * (optional) Inserted into the JOIN par of the second SQL query. - * For example "INNER JOIN {node_comment_statistics} n ON n.nid = i.sid" - * - * @param $arguments2 - * (optional) Extra SQL arguments belonging to the second query parameter. - * - * @param $sort_parameters - * (optional) SQL arguments for sorting the final results. - * Default: 'ORDER BY score DESC' - * - * @return - * An array of SIDs for the search results. - * - * @ingroup search - */ -function do_search($keywords, $type, $join1 = '', $where1 = '1', $arguments1 = array(), $select2 = 'i.relevance AS score', $join2 = '', $arguments2 = array(), $sort_parameters = 'ORDER BY score DESC') { - $query = search_parse_query($keywords); - - if ($query[2] == '') { - form_set_error('keys', t('You must include at least one positive keyword with %count characters or more.', array('%count' => variable_get('minimum_word_size', 3)))); - } - if ($query === NULL || $query[0] == '' || $query[2] == '') { - return array(); - } - - // First pass: select all possible matching sids, doing a simple index-based OR matching on the keywords. - // 'matches' is used to reject those items that cannot possibly match the query. - $conditions = $where1 .' AND ('. $query[2] .") AND i.type = '%s'"; - $arguments = array_merge($arguments1, $query[3], array($type, $query[4])); - $result = db_query_temporary("SELECT i.type, i.sid, SUM(i.score * t.count) AS relevance, COUNT(*) AS matches FROM {search_index} i INNER JOIN {search_total} t ON i.word = t.word $join1 WHERE $conditions GROUP BY i.type, i.sid HAVING COUNT(*) >= %d", $arguments, 'temp_search_sids'); - - // Calculate maximum relevance, to normalize it - $normalize = db_result(db_query('SELECT MAX(relevance) FROM temp_search_sids')); - if (!$normalize) { - return array(); - } - $select2 = str_replace('i.relevance', '('. (1.0 / $normalize) .' * i.relevance)', $select2); - - // Second pass: only keep items that match the complicated keywords conditions (phrase search, negative keywords, ...) - $conditions = '('. $query[0] .')'; - $arguments = array_merge($arguments2, $query[1]); - $result = db_query_temporary("SELECT i.type, i.sid, $select2 FROM temp_search_sids i INNER JOIN {search_dataset} d ON i.sid = d.sid AND i.type = d.type $join2 WHERE $conditions $sort_parameters", $arguments, 'temp_search_results'); - if (($count = db_result(db_query('SELECT COUNT(*) FROM temp_search_results'))) == 0) { - return array(); - } - $count_query = "SELECT $count"; - - // Do actual search query - $result = pager_query("SELECT * FROM temp_search_results", 10, 0, $count_query); - $results = array(); - while ($item = db_fetch_object($result)) { - $results[] = $item; - } - return $results; -} - -/** - * Helper function for grabbing search keys. - */ -function search_get_keys() { - // Extract keys as remainder of path - // Note: support old GET format of searches for existing links. - $path = explode('/', $_GET['q'], 3); - return count($path) == 3 ? $path[2] : $_REQUEST['keys']; -} - -/** - * Menu callback; presents the search form and/or search results. - */ -function search_view() { - $type = arg(1); - - // Search form submits with POST but redirects to GET. This way we can keep - // the search query URL clean as a whistle: - // search/type/keyword+keyword - if (!isset($_POST['edit']['keys'])) { - if ($type == '') { - // Note: search/node can not be a default tab because it would take on the - // path of its parent (search). It would prevent remembering keywords when - // switching tabs. This is why we drupal_goto to it from the parent instead. - drupal_goto('search/node'); - } - - $keys = search_get_keys(); - // Only perform search if there is non-whitespace search term: - if (trim($keys)) { - // Log the search keys: - watchdog('search', t('Search: %keys (%type).', array('%keys' => theme('placeholder', $keys), '%type' => module_invoke($type, 'search', 'name'))), WATCHDOG_NOTICE, l(t('results'), 'search/'. $type .'/'. $keys)); - - // Collect the search results: - $results = search_data($keys, $type); - - if ($results) { - $results = theme('box', t('Search results'), $results); - } - else { - $results = theme('box', t('Your search yielded no results'), search_help('search#noresults')); - } - } - - // Construct the search form. - $output = search_form(NULL, $keys, $type); - $output .= $results; - - return $output; - } - - return search_form(NULL, $keys, $type); -} - -/** - * @defgroup search Search interface - * @{ - * The Drupal search interface manages a global search mechanism. - * - * Modules may plug into this system to provide searches of different types of - * data. Most of the system is handled by search.module, so this must be enabled - * for all of the search features to work. - * - * There are three ways to interact with the search system: - * - Specifically for searching nodes, you can implement nodeapi('update index') - * and nodeapi('search result'). However, note that the search system already - * indexes all visible output of a node, i.e. everything displayed normally - * by hook_view() and hook_nodeapi('view'). This is usually sufficient. - * You should only use this mechanism if you want additional, non-visible data - * to be indexed. - * - Implement hook_search(). This will create a search tab for your module on - * the /search page with a simple keyword search form. You may optionally - * implement hook_search_item() to customize the display of your results. - * - Implement hook_update_index(). This allows your module to use Drupal's - * HTML indexing mechanism for searching full text efficiently. - * - * If your module needs to provide a more complicated search form, then you need - * to implement it yourself without hook_search(). In that case, you should - * define it as a local task (tab) under the /search page (e.g. /search/mymodule) - * so that users can easily find it. - */ - -/** - * Render a search form. - * - * @param $action - * Form action. Defaults to "search". - * @param $keys - * The search string entered by the user, containing keywords for the search. - * @param $type - * The type of search to render the node for. Must be the name of module - * which implements hook_search(). Defaults to 'node'. - * @param $prompt - * A piece of text to put before the form (e.g. "Enter your keywords") - * @return - * An HTML string containing the search form. - */ -function search_form($action = '', $keys = '', $type = NULL, $prompt = NULL) { - if (!$action) { - $action = url('search/'. $type); - } - if (is_null($prompt)) { - $prompt = t('Enter your keywords'); - } - - $form = array( - '#action' => $action, - '#attributes' => array('class' => 'search-form'), - ); - $form['module'] = array('#type' => 'value', '#value' => $type); - $form['basic'] = array('#type' => 'item', '#title' => $prompt); - $form['basic']['inline'] = array('#prefix' => '', '#suffix' => ''); - $form['basic']['inline']['keys'] = array( - '#type' => 'textfield', - '#title' => '', - '#default_value' => $keys, - '#size' => $prompt ? 40 : 20, - '#maxlength' => 255, - ); - // processed_keys is used to coordinate keyword passing between other forms - // that hook into the basic search form. - $form['basic']['inline']['processed_keys'] = array('#type' => 'value', '#value' => array()); - $form['basic']['inline']['submit'] = array('#type' => 'submit', '#value' => t('Search')); - - return drupal_get_form('search_form', $form); -} - -/** - * As the search form collates keys from other modules hooked in via - * hook_form_alter, the validation takes place in _submit. - * search_form_validate() is used solely to set the #ref property for the basic - * search form. - */ -function search_form_validate($form_id, $form_values, $form) { - $form['basic']['inline']['processed_keys']['#ref'] = trim($form_values['keys']); -} - -/** - * Process a search form submission. - */ -function search_form_submit($form_id, $form_values) { - $keys = $form_values['processed_keys']; - if ($keys == '') { - form_set_error('keys', t('Please enter some keywords.')); - // Fall through to the drupal_goto() call. - } - - $type = $form_values['module'] ? $form_values['module'] : 'node'; - return 'search/'. $type .'/'. $keys; -} - -function search_box_submit($form_id, $form_values) { - return 'search/node/'. trim($form_values['keys']); -} - -/** - * Perform a standard search on the given keys, and return the formatted results. - */ -function search_data($keys = NULL, $type = 'node') { - if (isset($keys)) { - if (module_hook($type, 'search')) { - $results = module_invoke($type, 'search', 'search', $keys); - if (isset($results) && is_array($results) && count($results)) { - if (module_hook($type, 'search_page')) { - return module_invoke($type, 'search_page', $results); - } - else { - return theme('search_page', $results, $type); - } - } - } - } -} - -/** - * Returns snippets from a piece of text, with certain keywords highlighted. - * Used for formatting search results. - * - * @param $keys - * A string containing a search query. - * - * @param $text - * The text to extract fragments from. - * - * @return - * A string containing HTML for the excerpt. - */ -function search_excerpt($keys, $text) { - // We highlight around non-indexable or CJK characters. - $boundary = '(?:(?<=['. PREG_CLASS_SEARCH_EXCLUDE . PREG_CLASS_CJK .'])|(?=['. PREG_CLASS_SEARCH_EXCLUDE . PREG_CLASS_CJK .']))'; - - // Extract positive keywords and phrases - preg_match_all('/ ("([^"]+)"|(?!OR)([^" ]+))/', ' '. $keys, $matches); - $keys = array_merge($matches[2], $matches[3]); - - // Prepare text - $text = ' '. strip_tags(str_replace(array('<', '>'), array(' <', '> '), $text)) .' '; - array_walk($keys, '_search_excerpt_replace'); - $workkeys = $keys; - - // Extract a fragment per keyword for at most 4 keywords. - // First we collect ranges of text around each keyword, starting/ending - // at spaces. - // If the sum of all fragments is too short, we look for second occurrences. - $ranges = array(); - $included = array(); - $length = 0; - while ($length < 256 && count($workkeys)) { - foreach ($workkeys as $k => $key) { - if (strlen($key) == 0) { - unset($workkeys[$k]); - unset($keys[$k]); - continue; - } - if ($length >= 256) { - break; - } - // Remember occurrence of key so we can skip over it if more occurrences - // are desired. - if (!isset($included[$key])) { - $included[$key] = 0; - } - // Locate a keyword (position $p), then locate a space in front (position - // $q) and behind it (position $s) - if (preg_match('/'. $boundary . $key . $boundary .'/iu', $text, $match, PREG_OFFSET_CAPTURE, $included[$key])) { - $p = $match[0][1]; - if (($q = strpos($text, ' ', max(0, $p - 60))) !== false) { - $end = substr($text, $p, 80); - if (($s = strrpos($end, ' ')) !== false) { - $ranges[$q] = $p + $s; - $length += $p + $s - $q; - $included[$key] = $p + 1; - } - else { - unset($workkeys[$k]); - } - } - else { - unset($workkeys[$k]); - } - } - else { - unset($workkeys[$k]); - } - } - } - - // If we didn't find anything, return the beginning. - if (count($ranges) == 0) { - return truncate_utf8($text, 256) . ' ...'; - } - - // Sort the text ranges by starting position. - ksort($ranges); - - // Now we collapse overlapping text ranges into one. The sorting makes it O(n). - $newranges = array(); - foreach ($ranges as $from2 => $to2) { - if (!isset($from1)) { - $from1 = $from2; - $to1 = $to2; - continue; - } - if ($from2 <= $to1) { - $to1 = max($to1, $to2); - } - else { - $newranges[$from1] = $to1; - $from1 = $from2; - $to1 = $to2; - } - } - $newranges[$from1] = $to1; - - // Fetch text - $out = array(); - foreach ($newranges as $from => $to) { - $out[] = substr($text, $from, $to - $from); - } - $text = (isset($newranges[0]) ? '' : '... '). implode(' ... ', $out) .' ...'; - - // Highlight keywords. Must be done at once to prevent conflicts ('strong' and ''). - $text = preg_replace('/'. $boundary .'('. implode('|', $keys) .')'. $boundary .'/iu', '\0', $text); - return $text; -} - -/** - * @} End of "defgroup search". - */ - -/** - * Helper function for array_walk in search_except. - */ -function _search_excerpt_replace(&$text) { - $text = preg_quote($text, '/'); -} - -/** - * Format a single result entry of a search query. This function is normally - * called by theme_search_page() or hook_search_page(). - * - * @param $item - * A single search result as returned by hook_search(). The result should be - * an array with keys "link", "title", "type", "user", "date", and "snippet". - * Optionally, "extra" can be an array of extra info to show along with the - * result. - * @param $type - * The type of item found, such as "user" or "node". - * - * @ingroup themeable - */ -function theme_search_item($item, $type) { - $output = '- '. check_plain($item['title']) .'
'; - $info = array(); - if ($item['type']) { - $info[] = $item['type']; - } - if ($item['user']) { - $info[] = $item['user']; - } - if ($item['date']) { - $info[] = format_date($item['date'], 'small'); - } - if (is_array($item['extra'])) { - $info = array_merge($info, $item['extra']); - } - $output .= '- '. ($item['snippet'] ? '
'; - return $output; -} - -/** - * Format the result page of a search query. - * - * Modules may implement hook_search_page() in order to override this default - * function to display search results. In that case it is expected they provide - * their own themable functions. - * - * @param $results - * All search result as returned by hook_search(). - * @param $type - * The type of item found, such as "user" or "node". - * - * @ingroup themeable - */ -function theme_search_page($results, $type) { - $output = ''. $item['snippet'] . '
' : '') . '' . implode(' - ', $info) .'
- ';
-
- foreach ($results as $entry) {
- $output .= theme('search_item', $entry, $type);
- }
- $output .= '
Statistics module features
--
-
- Logs show statistics for how many times your site and specific content on your site has been accessed. -
- Referrers tells you from where visitors came from (referrer URL). -
- Top pages shows you what\'s hot, what is the most popular content on your site. -
- Top users shows you the most active users for your site. -
- Recent hits displays information about the latest activity on your site. -
- Node count displays the number of times a node has been accessed in the node\'s link section next to # comments. -
- Popular content block creates a block that can display the day\'s top viewed content, the all time top viewed content, and the last content viewed. -
Configuring the statistics module
--
-
- Enable access log allows you to turn the access log on and off. This log is used to store data about every page accessed, such as the remote host\'s IP address, where they came from (referrer), what node they\'ve viewed, and their user name. Enabling the log adds one database call per page displayed by Drupal. -
- Discard access logs older than allows you to configure how long an access log entry is saved, after which time it is deleted from the database table. To use this you need to run cron.php -
- Enable node view counter allows you to turn on and off the node-counting functionality of this module. If it is turned on, an extra database query is added for each node displayed, which increments a counter. -
You can
--
-
- administer statistics administer >> setttings >> statistics. -
- access statistics logs administer >> logs. -
- view recent hits administer >> logs >> recent hits. -
- enable \'popular content\' block in block administration administer >> blocks but only after you have enabled \'Count content views\' in settings. -
'. t('For more information please read the configuration and customization handbook Statistics page.', array('%statistics' => 'http://drupal.org/handbook/modules/statistics/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Logs access statistics for your site.'); - case 'admin/settings/statistics': - return t('Settings for the statistical information that Drupal will keep about the site. See site statistics for the actual information.
', array('%statistics' => url('admin/logs/hits'))); - case 'admin/logs/hits': - return t('This page shows you the most recent hits.
'); - case 'admin/logs/referrers': - return t('This page shows you all external referrers. These are links pointing to your web site from outside your web site.
'); - case 'admin/logs/visitors': - return t('When you ban a visitor, you prevent his IP address from accessing your site. Unlike blocking a user, banning a visitor works even for anonymous users. The most common use for this is to block bots/web crawlers that are consuming too many resources.
'); - } -} - -/** - * Implementation of hook_exit(). - * - * This is where statistics are gathered on page accesses. - */ -function statistics_exit() { - global $user, $recent_activity; - - drupal_bootstrap(DRUPAL_BOOTSTRAP_PATH); - - if (variable_get('statistics_count_content_views', 0)) { - // We are counting content views. - if ((arg(0) == 'node') && is_numeric(arg(1)) && arg(2) == '') { - // A node has been viewed, so update the node's counters. - db_query('UPDATE {node_counter} SET daycount = daycount + 1, totalcount = totalcount + 1, timestamp = %d WHERE nid = %d', time(), arg(1)); - // If we affected 0 rows, this is the first time viewing the node. - if (!db_affected_rows()) { - // We must create a new row to store counters for the new node. - db_query('INSERT INTO {node_counter} (nid, daycount, totalcount, timestamp) VALUES (%d, 1, 1, %d)', arg(1), time()); - } - } - } - if ((variable_get('statistics_enable_access_log', 0)) && (module_invoke('throttle', 'status') == 0)) { - // Log this page access. - db_query("INSERT INTO {accesslog} (title, path, url, hostname, uid, sid, timer, timestamp) values('%s', '%s', '%s', '%s', %d, '%s', %d, %d)", strip_tags(drupal_get_title()), $_GET['q'], referer_uri(), $_SERVER['REMOTE_ADDR'], $user->uid, session_id(), timer_read('page'), time()); - } -} - -/** - * Implementation of hook_perm(). - */ -function statistics_perm() { - return array('access statistics', 'view post access counter'); -} - -/** - * Implementation of hook_link(). - */ -function statistics_link($type, $node = 0, $main = 0) { - global $id; - $links = array(); - - if ($type != 'comment' && user_access('view post access counter')) { - $statistics = statistics_get($node->nid); - if ($statistics) { - $links[] = format_plural($statistics['totalcount'], '1 read', '%count reads'); - } - } - - return $links; -} - -/** - * Implementation of hook_menu(). - */ -function statistics_menu($may_cache) { - $items = array(); - - $access = user_access('access statistics'); - if ($may_cache) { - $items[] = array('path' => 'admin/logs/hits', 'title' => t('recent hits'), - 'callback' => 'statistics_recent_hits', 'access' => $access, - 'weight' => 3); - $items[] = array('path' => 'admin/logs/pages', 'title' => t('top pages'), - 'callback' => 'statistics_top_pages', 'access' => $access, - 'weight' => 1); - $items[] = array('path' => 'admin/logs/visitors', 'title' => t('top visitors'), - 'callback' => 'statistics_top_visitors', 'access' => $access, - 'weight' => 2); - $items[] = array('path' => 'admin/logs/referrers', 'title' => t('referrers'), - 'callback' => 'statistics_top_referrers', 'access' => $access); - $items[] = array('path' => 'admin/logs/access', 'title' => t('details'), - 'callback' => 'statistics_access_log', 'access' => $access, - 'type' => MENU_CALLBACK); - } - else { - if (arg(0) == 'user' && is_numeric(arg(1))) { - $items[] = array('path' => 'user/'. arg(1) .'/track/navigation', 'title' => t('track page visits'), - 'callback' => 'statistics_user_tracker', 'access' => $access, - 'type' => MENU_LOCAL_TASK, 'weight' => 2); - } - if (arg(0) == 'node' && is_numeric(arg(1))) { - $items[] = array('path' => 'node/'. arg(1) .'/track', 'title' => t('track'), - 'callback' => 'statistics_node_tracker', 'access' => $access, - 'type' => MENU_LOCAL_TASK, 'weight' => 2); - } - } - - return $items; -} - -/** - * Implementation of hook_user(). - */ -function statistics_user($op, &$edit, &$user) { - if ($op == 'delete') { - db_query('UPDATE {accesslog} SET uid = 0 WHERE uid = %d', $user->uid); - } -} - -function statistics_access_log($aid) { - $result = db_query('SELECT a.*, u.name FROM {accesslog} a LEFT JOIN {users} u ON a.uid = u.uid WHERE aid = %d', $aid); - if ($access = db_fetch_object($result)) { - $output = ''; - $output .= '
'; - return $output; - } - else { - drupal_not_found(); - } -} - -function statistics_node_tracker() { - if ($node = node_load(arg(1))) { - - $header = array( - array('data' => t('Time'), 'field' => 'a.timestamp', 'sort' => 'desc'), - array('data' => t('Referrer'), 'field' => 'a.url'), - array('data' => t('User'), 'field' => 'u.name'), - array('data' => t('Operations'))); - - $result = pager_query('SELECT a.aid, a.timestamp, a.url, a.uid, u.name FROM {accesslog} a LEFT JOIN {users} u ON a.uid = u.uid WHERE a.path LIKE \'node/%d%%\'' . tablesort_sql($header), 30, 0, NULL, $node->nid); - while ($log = db_fetch_object($result)) { - $rows[] = array( - array('data' => format_date($log->timestamp, 'small'), 'class' => 'nowrap'), - l(_statistics_column_width($log->url), $log->url), - theme('username', $log), - l(t('details'), "admin/logs/access/$log->aid")); - } - - drupal_set_title(check_plain($node->title)); - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; - } - else { - drupal_not_found(); - } -} - -function statistics_user_tracker() { - if ($account = user_load(array('uid' => arg(1)))) { - - $header = array( - array('data' => t('Timestamp'), 'field' => 'timestamp', 'sort' => 'desc'), - array('data' => t('Page'), 'field' => 'path'), - array('data' => t('Operations'))); - - $result = pager_query('SELECT aid, timestamp, path, title FROM {accesslog} WHERE uid = %d' . tablesort_sql($header), 30, 0, NULL, $account->uid); - while ($log = db_fetch_object($result)) { - $rows[] = array( - array('data' => format_date($log->timestamp, 'small'), 'class' => 'nowrap'), - _statistics_format_item($log->title, $log->path), - l(t('details'), "admin/logs/access/$log->aid")); - } - - drupal_set_title($account->name); - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; - } - else { - drupal_not_found(); - } -} - -/** - * Menu callback; presents the "recent hits" page. - */ -function statistics_recent_hits() { - $header = array( - array('data' => t('Timestamp'), 'field' => 'a.timestamp', 'sort' => 'desc'), - array('data' => t('Page'), 'field' => 'a.path'), - array('data' => t('User'), 'field' => 'u.name'), - array('data' => t('Operations')) - ); - - $sql = 'SELECT a.aid, a.path, a.title, a.uid, u.name, a.timestamp FROM {accesslog} a LEFT JOIN {users} u ON u.uid = a.uid' . tablesort_sql($header); - - $result = pager_query($sql, 30); - while ($log = db_fetch_object($result)) { - $rows[] = array( - array('data' => format_date($log->timestamp, 'small'), 'class' => 'nowrap'), - _statistics_format_item($log->title, $log->path), - theme('username', $log), - l(t('details'), "admin/logs/access/$log->aid")); - } - - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; -} - -/** - * Menu callback; presents the "top pages" page. - */ -function statistics_top_pages() { - $sql = "SELECT COUNT(path) AS hits, path, title, AVG(timer) AS average_time, SUM(timer) AS total_time FROM {accesslog} GROUP BY path, title"; - $sql_cnt = "SELECT COUNT(DISTINCT(path)) FROM {accesslog}"; - - $header = array( - array('data' => t('Hits'), 'field' => 'hits', 'sort' => 'desc'), - array('data' => t('Page'), 'field' => 'path'), - array('data' => t('Average page generation time'), 'field' => 'average_time'), - array('data' => t('Total page generation time'), 'field' => 'total_time') - ); - $sql .= tablesort_sql($header); - $result = pager_query($sql, 30, 0, $sql_cnt); - - while ($page = db_fetch_object($result)) { - $rows[] = array($page->hits, _statistics_format_item($page->title, $page->path), t('%time ms', array('%time' => round($page->average_time))), format_interval(round($page->total_time / 1000))); - } - - drupal_set_title(t('Top pages in the past %interval', array('%interval' => format_interval(variable_get('statistics_flush_accesslog_timer', 259200))))); - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; -} - -/** - * Menu callback; presents the "top visitors" page. - */ -function statistics_top_visitors() { - - $header = array( - array('data' => t('Hits'), 'field' => 'hits', 'sort' => 'desc'), - array('data' => t('Visitor'), 'field' => 'u.name'), - array('data' => t('Total page generation time'), 'field' => 'total'), - array('data' => t('Operations')) - ); - - $sql = "SELECT COUNT(a.uid) AS hits, a.uid, u.name, a.hostname, SUM(a.timer) AS total, ac.aid FROM {accesslog} a LEFT JOIN {access} ac ON ac.type = 'host' AND LOWER(a.hostname) LIKE (ac.mask) LEFT JOIN {users} u ON a.uid = u.uid GROUP BY a.hostname, a.uid, u.name, ac.aid". tablesort_sql($header); - $sql_cnt = "SELECT COUNT(DISTINCT(uid)) FROM {accesslog}"; - $result = pager_query($sql, 30, 0, $sql_cnt); - - while ($account = db_fetch_object($result)) { - $qs = drupal_get_destination(); - $ban_link = $account->aid ? l(t('unban'), "admin/access/rules/delete/$account->aid", array(), $qs) : l(t('ban'), "admin/access/rules/add/$account->hostname/host", array(), $qs); - $rows[] = array($account->hits, ($account->uid ? theme('username', $account) : $account->hostname), format_interval(round($account->total / 1000)), $ban_link); - } - - drupal_set_title(t('Top visitors in the past %interval', array('%interval' => format_interval(variable_get('statistics_flush_accesslog_timer', 259200))))); - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; -} - -/** - * Menu callback; presents the "referrer" page. - */ -function statistics_top_referrers() { - $query = "SELECT url, COUNT(url) AS hits, MAX(timestamp) AS last FROM {accesslog} WHERE url NOT LIKE '%%%s%%' AND url <> '' GROUP BY url"; - $query_cnt = "SELECT COUNT(DISTINCT(url)) FROM {accesslog} WHERE url <> '' AND url NOT LIKE '%%%s%%'"; - drupal_set_title(t('Top referrers in the past %interval', array('%interval' => format_interval(variable_get('statistics_flush_accesslog_timer', 259200))))); - - $header = array( - array('data' => t('Hits'), 'field' => 'hits', 'sort' => 'desc'), - array('data' => t('Url'), 'field' => 'url'), - array('data' => t('Last visit'), 'field' => 'last'), - ); - - $query .= tablesort_sql($header); - $result = pager_query($query, 30, 0, $query_cnt, $_SERVER['HTTP_HOST']); - - while ($referrer = db_fetch_object($result)) { - $rows[] = array($referrer->hits, ''. check_plain(_statistics_column_width($referrer->url)) .'', t('%time ago', array('%time' => format_interval(time() - $referrer->last)))); - } - - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 30, 0, tablesort_pager()); - return $output; -} - -/** - * Implementation of hook_settings(). - */ -function statistics_settings() { - // access log settings: - $options = array('1' => t('Enabled'), '0' => t('Disabled')); - $form['access'] = array('#type' => 'fieldset', '#title' => t('Access log settings')); - $form['access']['statistics_enable_access_log'] = array('#type' => 'radios', '#title' => t('Enable access log'), '#default_value' => variable_get('statistics_enable_access_log', 0), '#options' => $options, '#description' => t('Log each page access. Required for referrer statistics.')); - $period = drupal_map_assoc(array(3600, 10800, 21600, 32400, 43200, 86400, 172800, 259200, 604800, 1209600, 2419200, 4838400, 9676800), 'format_interval'); - $form['access']['statistics_flush_accesslog_timer'] = array('#type' => 'select', '#title' => t('Discard access logs older than'), '#default_value' => variable_get('statistics_flush_accesslog_timer', 259200), '#options' => $period, '#description' => t('Older access log entries (including referrer statistics) will be automatically discarded. Requires crontab.')); - - // count content views settings - $form['content'] = array('#type' => 'fieldset', '#title' => t('Content viewing counter settings')); - $form['content']['statistics_count_content_views'] = array('#type' => 'radios', '#title' => t('Count content views'), '#default_value' => variable_get('statistics_count_content_views', 0), '#options' => $options, '#description' => t('Increment a counter each time content is viewed.')); - - return $form; -} - -/** - * Implementation of hook_cron(). - */ -function statistics_cron() { - $statistics_timestamp = variable_get('statistics_day_timestamp', ''); - - if ((time() - $statistics_timestamp) >= 86400) { - /* reset day counts */ - db_query('UPDATE {node_counter} SET daycount = 0'); - variable_set('statistics_day_timestamp', time()); - } - - /* clean expired access logs */ - db_query('DELETE FROM {accesslog} WHERE timestamp < %d', time() - variable_get('statistics_flush_accesslog_timer', 259200)); -} - -/** - * Returns all time or today top or last viewed node(s). - * - * @param $dbfield - * one of - * - 'totalcount': top viewed content of all time. - * - 'daycount': top viewed content for today. - * - 'timestamp': last viewed node. - * - * @param $dbrows - * number of rows to be returned. - * - * @return - * A query result containing n.nid, n.title, u.uid, u.name of the selected node(s) - * or FALSE if the query could not be executed correctly. - */ -function statistics_title_list($dbfield, $dbrows) { - return db_query_range(db_rewrite_sql("SELECT n.nid, n.title, u.uid, u.name FROM {node} n INNER JOIN {node_counter} s ON n.nid = s.nid INNER JOIN {users} u ON n.uid = u.uid WHERE %s <> '0' AND n.status = 1 ORDER BY %s DESC"), 's.'. $dbfield, 's.'. $dbfield, 0, $dbrows); -} - - -/** - * Retrieves a node's "view statistics". - * - * @param $nid - * node ID - * - * @return - * An array with three entries: [0]=totalcount, [1]=daycount, [2]=timestamp - * - totalcount: count of the total number of times that node has been viewed. - * - daycount: count of the total number of times that node has been viewed "today". - * For the daycount to be reset, cron must be enabled. - * - timestamp: timestamp of when that node was last viewed. - */ -function statistics_get($nid) { - - if ($nid > 0) { - /* retrieves an array with both totalcount and daycount */ - $statistics = db_fetch_array(db_query('SELECT totalcount, daycount, timestamp FROM {node_counter} WHERE nid = %d', $nid)); - } - - return $statistics; -} - -/** - * Implementation of hook_block(). - */ -function statistics_block($op = 'list', $delta = 0, $edit = array()) { - switch ($op) { - case 'list': - if (variable_get('statistics_count_content_views', 0)) { - $blocks[0]['info'] = t('Popular content'); - } - return $blocks; - - case 'configure': - // Popular content block settings - $numbers = array('0' => t('Disabled')) + drupal_map_assoc(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30, 40)); - $form['statistics_block_top_day_num'] = array('#type' => 'select', '#title' => t("Number of day's top views to display"), '#default_value' => variable_get('statistics_block_top_day_num', 0), '#options' => $numbers, '#description' => t('How many content items to display in "day" list.')); - $form['statistics_block_top_all_num'] = array('#type' => 'select', '#title' => t('Number of all time views to display'), '#default_value' => variable_get('statistics_block_top_all_num', 0), '#options' => $numbers, '#description' => t('How many content items to display in "all time" list.')); - $form['statistics_block_top_last_num'] = array('#type' => 'select', '#title' => t('Number of most recent views to display'), '#default_value' => variable_get('statistics_block_top_last_num', 0), '#options' => $numbers, '#description' => t('How many content items to display in "recently viewed" list.')); - return $form; - - case 'save': - variable_set('statistics_block_top_day_num', $edit['statistics_block_top_day_num']); - variable_set('statistics_block_top_all_num', $edit['statistics_block_top_all_num']); - variable_set('statistics_block_top_last_num', $edit['statistics_block_top_last_num']); - break; - - case 'view': - if (user_access('access content')) { - $content = array(); - - $daytop = variable_get('statistics_block_top_day_num', 0); - if ($daytop && ($result = statistics_title_list('daycount', $daytop)) && db_num_rows($result)) { - $content[] = node_title_list($result, t("Today's:")); - } - - $alltimetop = variable_get('statistics_block_top_all_num', 0); - if ($alltimetop && ($result = statistics_title_list('totalcount', $alltimetop)) && db_num_rows($result)) { - $content[] = node_title_list($result, t('All time:')); - } - - $lasttop = variable_get('statistics_block_top_last_num', 0); - if ($lasttop && ($result = statistics_title_list('timestamp', $lasttop)) && db_num_rows($result)) { - $content[] = node_title_list($result, t('Last viewed:')); - } - - if (count($content)) { - $block['content'] = implode(''. t('URL') ." ". l(url($access->path, NULL, NULL, TRUE), $access->path) ." '. t('Title') .' '. $access->title .' '. t('Referrer') ." ". ($access->url ? l($access->url, $access->url) : '') ." '. t('Date') .' '. format_date($access->timestamp, 'large') .' '. t('User') .' '. theme('username', $access) .' '. t('Hostname') .' '. check_plain($access->hostname) .'
', $content); - $block['subject'] = t('Popular content'); - return $block; - } - } - } -} - -/** - * It is possible to adjust the width of columns generated by the - * statistics module. - */ -function _statistics_column_width($column, $width = 35) { - return (strlen($column) > $width ? substr($column, 0, $width) . '...' : $column); -} - -function _statistics_format_item($title, $link) { - $link = ($link ? $link : '/'); - $output = ($title ? "$title
" : ''); - $output .= l(_statistics_column_width($link), $link); - return $output; -} - -/** - * Implementation of hook_nodeapi(). - */ -function statistics_nodeapi(&$node, $op, $arg = 0) { - switch ($op) { - case 'delete': - // clean up statistics table when node is deleted - db_query('DELETE FROM {node_counter} WHERE nid = %d', $node->nid); - } -} - - diff --git a/modules/story/story.module b/modules/story/story.module deleted file mode 100644 index 18123c15b58355f1dc6aa8c01f45a46d7430a105..0000000000000000000000000000000000000000 --- a/modules/story/story.module +++ /dev/null @@ -1,86 +0,0 @@ -'. t('The story module is used to create a content post type called stories. Stories are articles in their simplest form: they have a title, a teaser and a body. Stories are typically used to post news articles or as a group blog. ') .''; - $output .= ''. t('The story administration interface allows for complex configuration. It provides a submission form, workflow, default view permission, default edit permission, permissions for permission, and attachments. Trackbacks can also be enabled.') .'
'; - $output .= t('You can
--
-
- post a story at create content >> story. -
- configure story at administer >> settings >> content types >> configure story. -
'. t('For more information please read the configuration and customization handbook Story page.', array('%story' => 'http://drupal.org/handbook/modules/story/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to submit stories, articles or similar content.'); - case 'node/add#story': - return t('Stories are articles in their simplest form: they have a title, a teaser and a body, but can be extended by other modules. The teaser is part of the body too. Stories may be used as a personal blog or for news articles.'); - } -} - -/** - * Implementation of hook_node_info(). - */ -function story_node_info() { - return array('story' => array('name' => t('story'), 'base' => 'story')); -} - -/** - * Implementation of hook_perm(). - */ -function story_perm() { - return array('create stories', 'edit own stories'); -} - -/** - * Implementation of hook_access(). - */ -function story_access($op, $node) { - global $user; - - if ($op == 'create') { - return user_access('create stories'); - } - - if ($op == 'update' || $op == 'delete') { - if (user_access('edit own stories') && ($user->uid == $node->uid)) { - return TRUE; - } - } -} - -/** - * Implementation of hook_menu(). - */ -function story_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'node/add/story', 'title' => t('story'), - 'access' => user_access('create stories')); - } - - return $items; -} - -/** - * Implementation of hook_form(). - */ -function story_form(&$node) { - $form['title'] = array('#type' => 'textfield', '#title' => t('Title'), '#required' => TRUE, '#default_value' => $node->title, '#weight' => -5); - $form['body_filter']['body'] = array('#type' => 'textarea', '#title' => t('Body'), '#default_value' => $node->body, '#rows' => 20, '#required' => TRUE); - $form['body_filter']['format'] = filter_form($node->format); - return $form; -} - diff --git a/modules/system/system.module b/modules/system/system.module deleted file mode 100644 index a0dc4eb26ce4fbd0323cf9ad20037b9df7404974..0000000000000000000000000000000000000000 --- a/modules/system/system.module +++ /dev/null @@ -1,1256 +0,0 @@ -'. t('The system module provides system-wide defaults such as running jobs at a particular time, and storing web pages to improve efficiency. The ability to run scheduled jobs makes administering the web site more usable, as administrators do not have to manually start jobs. The storing of web pages, or caching, allows the site to efficiently re-use web pages and improve web site performance. The settings module provides control over preferences, behaviours including visual and operational settings.') .''; - $output .= ''. t('Some modules require regularly scheduled actions, such as cleaning up logfiles. Cron, which stands for chronograph, is a periodic command scheduler executing commands at intervals specified in seconds. It can be used to control the execution of daily, weekly and monthly jobs (or anything with a period measured in seconds). The aggregator module periodically updates feeds using cron. Ping periodically notifies services of new content on your site. Search periodically indexes the content on your site. Automating tasks is one of the best ways to keep a system running smoothly, and if most of your administration does not require your direct involvement, cron is an ideal solution.') .'
'; - $output .= ''. t('There is a caching mechanism which stores dynamically generated web pages in a database. By caching a web page, the system module does not have to create the page each time someone wants to view it, instead it takes only one SQL query to display it, reducing response time and the server\'s load. Only pages requested by anonymous users are cached. In order to reduce server load and save bandwidth, the system module stores and sends cached pages compressed.') .'
'; - $output .= t('You can
--
-
- activate your cron job on the cron page cron.php. -
- read how to configure cron jobs. -
- administer cache settings in administer >> settings. -
'. t('For more information please read the configuration and customization handbook System page.', array('%system' => 'http://drupal.org/handbook/modules/system/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Handles general site configuration for administrators.'); - case 'admin': - return t('Welcome to the administration section. Below are the most recent system events.
'); - case 'admin/settings': - return t('General configuration options for your site. Set up the name of the site, e-mail address used in mail-outs, clean URL options, caching, etc.
'); - case 'admin/themes': - return t('Select which themes are available to your users and specify the default theme. To configure site-wide display settings, click the "configure" task above. Alternately, to override these settings in a specific theme, click the "configure" link for the corresponding theme. Note that different themes may have different regions available for rendering content like blocks. If you want consistency in what your users see, you may wish to enable only one theme.
'); - case 'admin/themes/settings': - return t('These options control the default display settings for your entire site, across all themes. Unless they have been overridden by a specific theme, these settings will be used.
'); - case 'admin/themes/settings/'. arg(3): - $reference = explode('.', arg(3), 2); - $theme = array_pop($reference); - return t('These options control the display settings for the
', array('%template' => $theme, '%global' => url('admin/themes/settings'))); - case 'admin/modules': - return t('%templatetheme. When your site is displayed using this theme, these settings will be used. By clicking "Reset to defaults," you can choose to use the global settings for this theme.Modules are plugins for Drupal that extend its core functionality. Here you can select which modules are enabled. Click on the name of the module in the navigation menu for their individual configuration pages. Once a module is enabled, new permissions might be made available. Modules can automatically be temporarily disabled to reduce server load when your site becomes extremely busy by enabling the throttle.module and checking throttle. The auto-throttle functionality must be enabled on the throttle configuration page after having enabled the throttle module.
', array('%permissions' => url('admin/access/permissions'), '%throttle' => url('admin/settings/throttle'))); - } -} - -/** - * Implementation of hook_perm(). - */ -function system_perm() { - return array('administer site configuration', 'access administration pages', 'select different theme'); -} - -/** - * Implementation of hook_elements(). - */ -function system_elements() { - // Top level form - $type['form'] = array('#method' => 'post', '#action' => request_uri()); - - // Inputs - $type['checkbox'] = array('#input' => TRUE, '#return_value' => 1); - $type['submit'] = array('#input' => TRUE, '#name' => 'op', '#button_type' => 'submit', '#form_submitted' => TRUE); - $type['button'] = array('#input' => TRUE, '#name' => 'op', '#button_type' => 'submit', '#form_submitted' => FALSE); - $type['textfield'] = array('#input' => TRUE, '#size' => 60, '#maxlength' => 128, '#autocomplete_path' => FALSE); - $type['password'] = array('#input' => TRUE, '#size' => 30); - $type['password_confirm'] = array('#input' => TRUE, - '#value' => 'pass', - 'pass1' => array('#type' => 'password', '#size' => 12), - 'pass2' => array('#type' => 'password', '#size' => 12), - '#validate' => array('password_confirm_validate' => array()), - ); - $type['textarea'] = array('#input' => TRUE, '#cols' => 60, '#rows' => 5); - $type['radios'] = array('#input' => TRUE, '#process' => array('expand_radios' => array())); - $type['radio'] = array('#input' => TRUE); - $type['checkboxes'] = array('#input' => TRUE, '#process' => array('expand_checkboxes' => array()), '#tree' => TRUE); - $type['select'] = array('#input' => TRUE); - $type['weight'] = array('#input' => TRUE, '#delta' => 10, '#default_value' => 0); - $type['date'] = array('#input' => TRUE, '#process' => array('expand_date' => array())); - $type['file'] = array('#input' => TRUE, '#size' => 60); - - // Form structure - $type['item'] = array(); - $type['hidden'] = array('#input' => TRUE); - $type['value'] = array('#input' => TRUE); - $type['markup'] = array('#prefix' => '', '#suffix' => ''); - $type['fieldset'] = array('#collapsible' => FALSE, '#collapsed' => FALSE); - return $type; -} - -/** - * Implementation of hook_menu(). - */ -function system_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'system/files', 'title' => t('file download'), - 'callback' => 'file_download', - 'access' => TRUE, - 'type' => MENU_CALLBACK); - - // Clean URL tester - $items[] = array('path' => 'system/test', - 'callback' => 'system_test', - 'access' => TRUE, - 'type' => MENU_CALLBACK); - - $access = user_access('administer site configuration'); - - $items[] = array('path' => 'admin', 'title' => t('administer'), - 'access' => user_access('access administration pages'), - 'callback' => 'watchdog_overview', - 'weight' => 9); - - // Themes: - $items[] = array('path' => 'admin/themes', 'title' => t('themes'), - 'callback' => 'system_themes', 'access' => $access); - - $items[] = array('path' => 'admin/themes/select', 'title' => t('list'), - 'callback' => 'system_themes', 'access' => $access, - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -1); - - $items[] = array('path' => 'admin/themes/settings', 'title' => t('configure'), - 'callback' => 'system_theme_settings', 'access' => $access, - 'type' => MENU_LOCAL_TASK); - - // Theme configuration subtabs - $items[] = array('path' => 'admin/themes/settings/global', 'title' => t('global settings'), - 'callback' => 'system_theme_settings', 'access' => $access, - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -1); - - foreach (list_themes() as $theme) { - if ($theme->status) { - $items[] = array('path' => 'admin/themes/settings/'. $theme->name, 'title' => $theme->name, - 'callback' => 'system_theme_settings', 'callback arguments' => array($theme->name), 'access' => $access, - 'type' => MENU_LOCAL_TASK); - } - } - - // Modules: - $items[] = array('path' => 'admin/settings', 'title' => t('settings'), - 'callback' => 'system_site_settings', 'access' => $access); - foreach (module_list() as $name) { - if (module_hook($name, 'settings')) { - $items[] = array('path' => 'admin/settings/'. $name, 'title' => t($name)); - } - } - $items[] = array('path' => 'admin/modules', 'title' => t('modules'), - 'callback' => 'system_modules', 'access' => $access); - } - - return $items; -} - -/** - * Menu callback: dummy clean URL tester. - */ -function system_test() { - variable_set('clean_url_ok', 1); - exit; -} - -/** - * Implementation of hook_user(). - * - * Allows users to individually set their theme and time zone. - */ -function system_user($type, $edit, &$user, $category = NULL) { - if ($type == 'form' && $category == 'account') { - if (user_access('select different theme')) { - $themes = array_filter(list_themes(), create_function('$theme', 'return $theme->status;')); - - if (count($themes) > 1) { - ksort($themes); - - $form['themes'] = array( - '#type' => 'fieldset', '#title' => t('Theme configuration'), '#description' => t('Selecting a different theme will change the look and feel of the site.'), '#weight' => 2, '#collapsible' => TRUE, '#theme' => 'system_user'); - - foreach ($themes as $info) { - // For the default theme, revert to an empty string so the user's theme updates when the site theme is changed. - $info->key = $info->name == variable_get('theme_default', 'bluemarine') ? '' : $info->name; - - $info->screenshot = dirname($info->filename) . '/screenshot.png'; - $screenshot = file_exists($info->screenshot) ? theme('image', $info->screenshot, t('Screenshot for %theme theme', array('%theme' => $info->name)), '', array('class' => 'screenshot'), false) : t('no screenshot'); - - $form['themes'][$info->key]['screenshot'] = array('#type' => 'markup', '#value' => $screenshot); - $form['themes'][$info->key]['description'] = array('#type' => 'item', '#title' => $info->name, '#value' => dirname($info->filename) . ($info->name == variable_get('theme_default', 'bluemarine') ? t('
(site default theme)') : '')); - $options[$info->key] = ''; - } - - $form['themes']['theme'] = array('#type' => 'radios', '#options' => $options, '#default_value' => $edit['theme'] ? $edit['theme'] : ''); - } - } - - if (variable_get('configurable_timezones', 1)) { - $zones = _system_zonelist(); - $form['timezone'] = array('#type'=>'fieldset', '#title' => t('Locale settings'), '#weight' => 6); - $form['timezone']['timezone'] = array( - '#type' => 'select', '#title' => t('Time zone'), '#default_value' => strlen($edit['timezone']) ? $edit['timezone'] : variable_get('date_default_timezone', 0), - '#options' => $zones, '#description' => t('Select your current local time. Dates and times throughout this site will be displayed using this time zone.') - ); - } - return $form; - } -} - -function theme_system_user($form) { - foreach (element_children($form) as $key) { - $row = array(); - if (is_array($form[$key]['description'])) { - $row[] = form_render($form[$key]['screenshot']); - $row[] = form_render($form[$key]['description']); - $row[] = form_render($form['theme'][$key]); - } - $rows[] = $row; - } - - $header = array(t('Screenshot'), t('Name'), t('Selected')); - $output = theme('table', $header, $rows); - return $output; -} - -function _system_zonelist() { - $timestamp = time(); - $zonelist = array(-11, -10, -9.5, -9, -8, -7, -6, -5, -4, -3.5, -3, -2, -1, 0, 1, 2, 3, 3.5, 4, 5, 5.5, 5.75, 6, 6.5, 7, 8, 9, 9.5, 10, 10.5, 11, 11.5, 12, 12.75, 13, 14); - $zones = array(); - foreach ($zonelist as $offset) { - $zone = $offset * 3600; - $zones[$zone] = format_date($timestamp, 'custom', variable_get('date_format_long', 'l, F j, Y - H:i') . ' O', $zone); - } - return $zones; -} - -function system_view_general() { - // General settings: - $form['general'] = array( - '#type' => 'fieldset', '#title' => t('General settings'), - '#collapsible' => TRUE, '#collapsed' => TRUE - ); - $form['general']['site_name'] = array( - '#type' => 'textfield', '#title' => t('Name'), '#default_value' => variable_get('site_name', 'drupal'), - '#description' => t('The name of this web site.'), '#required' => TRUE - ); - $form['general']['site_mail'] = array( - '#type' => 'textfield', '#title' => t('E-mail address'), '#default_value' => variable_get('site_mail', ini_get('sendmail_from')), - '#description' => t('A valid e-mail address for this website, used by the auto-mailer during registration, new password requests, notifications, etc.') - ); - $form['general']['site_slogan'] = array( - '#type' => 'textfield', '#title' => t('Slogan'), '#default_value' => variable_get('site_slogan', ''), - '#description' => t('The slogan of this website. Some themes display a slogan when available.') - ); - - $form['general']['site_mission'] = array( - '#type' => 'textarea', '#title' => t('Mission'), '#default_value' => variable_get('site_mission', ''), - '#description' => t('Your site\'s mission statement or focus.') - ); - $form['general']['site_footer'] = array( - '#type' => 'textarea', '#title' => t('Footer message'), '#default_value' => variable_get('site_footer', ''), - '#description' => t('This text will be displayed at the bottom of each page. Useful for adding a copyright notice to your pages.') - ); - $form['general']['anonymous'] = array( - '#type' => 'textfield', '#title' => t('Anonymous user'), '#default_value' => variable_get('anonymous', 'Anonymous'), - '#description' => t('The name used to indicate anonymous users.') - ); - $form['general']['site_frontpage'] = array( - '#type' => 'textfield', '#title' => t('Default front page'), '#default_value' => variable_get('site_frontpage', 'node'), - '#description' => t('The home page displays content from this relative URL. If you are not using clean URLs, specify the part after "?q=". If unsure, specify "node".') - ); - - // We check for clean URL support using an image on the client side. - $form['general']['clean_url'] = array( - '#type' => 'radios', '#title' => t('Clean URLs'), '#default_value' => variable_get('clean_url', 0), '#options' => array(t('Disabled'), t('Enabled')), - '#description' => t('This option makes Drupal emit clean URLs (i.e. without?q=in the URL). You\'ll needModRewritesupport for this to work. See the.htaccessfile in Drupal\'s top-level directory for more information.') - ); - - variable_set('clean_url_ok', 0); - global $base_url; - // We will use a random URL so there is no way a proxy or a browser could cache the "no such image" answer. - $form['general']['clean_url_test'] = array('#type' => 'markup', '#value' => ' .'.png)
');
-
- // Error handling:
-
- $form['errors'] = array( '#type' => 'fieldset', '#title' =>t('Error handling'), '#collapsible' => TRUE, '#collapsed' => TRUE );
- $form['errors']['site_403'] = array(
- '#type' => 'textfield', '#title' => t('Default 403 (access denied) page'), '#default_value' => variable_get('site_403', ''),
- '#description' => t('This page is displayed when the requested document is denied to the current user. If you are not using clean URLs, specify the part after "?q=". If unsure, specify nothing.')
- );
-
- $form['errors']['site_404'] = array(
- '#type' => 'textfield', '#title' => t('Default 404 (not found) page'), '#default_value' => variable_get('site_404', ''),
- '#description' => t('This page is displayed when no other content matches the requested document. If you are not using clean URLs, specify the part after "?q=". If unsure, specify nothing.')
- );
-
- $form['errors']['error_level'] = array(
- '#type' => 'select', '#title' => t('Error reporting'), '#default_value' => variable_get('error_level', 1),
- '#options' => array(t('Write errors to the log'), t('Write errors to the log and to the screen')),
- '#description' => t('Where Drupal, PHP and SQL errors are logged. On a production server it is recommended that errors are only written to the error log. On a test server it can be helpful to write logs to the screen.')
- );
-
- $period = drupal_map_assoc(array(3600, 10800, 21600, 32400, 43200, 86400, 172800, 259200, 604800, 1209600, 2419200), 'format_interval');
- $period['1000000000'] = t('Never');
- $form['errors']['watchdog_clear'] = array(
- '#type' => 'select', '#title' => t('Discard log entries older than'), '#default_value' => variable_get('watchdog_clear', 604800), '#options' => $period,
- '#description' => t('The time log entries should be kept. Older entries will be automatically discarded. Requires crontab.')
- );
-
-
- // Caching:
- $form['cache'] = array('#type' => 'fieldset', '#title' => t('Cache settings'), '#collapsible' => TRUE, '#collapsed' => TRUE);
-
- $form['cache']['cache'] = array(
- '#type' => 'radios', '#title' => t('Page cache'), '#default_value' => variable_get('cache', CACHE_DISABLED),
- '#options' => array(CACHE_DISABLED => t('Disabled'), CACHE_ENABLED => t('Enabled')),
- '#description' => t("Drupal has a caching mechanism which stores dynamically generated web pages in a database. By caching a web page, Drupal does not have to create the page each time someone wants to view it, instead it takes only one SQL query to display it, reducing response time and the server's load. Only pages requested by \"anonymous\" users are cached. In order to reduce server load and save bandwidth, Drupal stores and sends compressed cached pages.")
- );
-
- $period = drupal_map_assoc(array(0, 60, 180, 300, 600, 900, 1800, 2700, 3600, 10800, 21600, 32400, 43200, 86400), 'format_interval');
- $period[0] = t('none');
- $form['cache']['cache_lifetime'] = array(
- '#type' => 'select', '#title' => t('Minimum cache lifetime'), '#default_value' => variable_get('cache_lifetime', 0), '#options' => $period,
- '#description' => t('Enabling the cache will offer a sufficient performance boost for most low-traffic and medium-traffic sites. On high-traffic sites it can become necessary to enforce a minimum cache lifetime. The minimum cache lifetime is the minimum amount of time that will go by before the cache is emptied and recreated. A larger minimum cache lifetime offers better performance, but users will not see new content for a longer period of time.')
- );
-
-
- // File system:
- $form['files'] = array('#type' => 'fieldset', '#title' => t('File system settings'), '#collapsible' => TRUE, '#collapsed' => TRUE);
-
- $form['files']['file_directory_path'] = array(
- '#type' => 'textfield',
- '#title' => t('File system path'),
- '#default_value' => file_directory_path(),
- '#maxlength' => 255,
- '#description' => t('A file system path where the files will be stored. This directory has to exist and be writable by Drupal. If the download method is set to public this directory has to be relative to Drupal installation directory, and be accessible over the web. When download method is set to private this directory should not be accessible over the web. Changing this location after the site has been in use will cause problems so only change this setting on an existing site if you know what you are doing.'),
- '#after_build' => 'system_check_directory',
- );
-
- $form['files']['file_directory_temp'] = array(
- '#type' => 'textfield',
- '#title' => t('Temporary directory'),
- '#default_value' => file_directory_temp(),
- '#maxlength' => 255,
- '#description' => t('Location where uploaded files will be kept during previews. Relative paths will be resolved relative to the Drupal installation directory.'),
- '#after_build' => 'system_check_directory',
- );
-
- $form['files']['file_downloads'] = array(
- '#type' => 'radios', '#title' => t('Download method'), '#default_value' => variable_get('file_downloads', FILE_DOWNLOADS_PUBLIC),
- '#options' => array(FILE_DOWNLOADS_PUBLIC => t('Public - files are available using http directly.'), FILE_DOWNLOADS_PRIVATE => t('Private - files are transferred by Drupal.')),
- '#description' => t('If you want any sort of access control on the downloading of files, this needs to be set to private. You can change this at any time, however all download URLs will change and there may be unexpected problems so it is not recommended.')
- );
-
- // Image handling:
- $toolkits_available = image_get_available_toolkits();
- if (count($toolkits_available) > 1) {
- $form['image'] = array('#type' => 'fieldset', '#title' => t('Image handling'), '#collapsible' => TRUE, '#collapsed' => true);
- $form['image']['image_toolkit'] = array(
- '#type' => 'radios', '#title' => t('Select an image processing toolkit'),
- '#default_value' => variable_get('image_toolkit', image_get_toolkit()), '#options' => $toolkits_available
- );
- }
-
- // Feed settings
- $form['feed'] = array('#type' => 'fieldset', '#title' => t('RSS feed settings'), '#collapsible' => TRUE, '#collapsed' => TRUE);
- $form['feed']['feed_default_items'] = array(
- '#type' => 'select', '#title' => t('Number of items per feed'), '#default_value' => variable_get('feed_default_items', 10),
- '#options' => drupal_map_assoc(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 15, 20, 25, 30)),
- '#description' => t('The default number of items to include in a feed.')
- );
- $form['feed']['feed_item_length'] = array(
- '#type' => 'select', '#title' => t('Display of XML feed items'), '#default_value' => variable_get('feed_item_length','teaser'),
- '#options' => array('title' => t('Titles only'), 'teaser' => t('Titles plus teaser'), 'fulltext' => t('Full text')),
- '#description' => t('Global setting for the length of XML feed items that are output by default.')
- );
-
- // Date settings:
- $zones = _system_zonelist();
-
- // Date settings: possible date formats
- $dateshort = array('Y-m-d H:i','m/d/Y - H:i', 'd/m/Y - H:i', 'Y/m/d - H:i',
- 'm/d/Y - g:ia', 'd/m/Y - g:ia', 'Y/m/d - g:ia',
- 'M j Y - H:i', 'j M Y - H:i', 'Y M j - H:i',
- 'M j Y - g:ia', 'j M Y - g:ia', 'Y M j - g:ia');
- $datemedium = array('D, Y-m-d H:i', 'D, m/d/Y - H:i', 'D, d/m/Y - H:i',
- 'D, Y/m/d - H:i', 'F j, Y - H:i', 'j F, Y - H:i', 'Y, F j - H:i',
- 'D, m/d/Y - g:ia', 'D, d/m/Y - g:ia', 'D, Y/m/d - g:ia',
- 'F j, Y - g:ia', 'j F Y - g:ia', 'Y, F j - g:ia');
- $datelong = array('l, F j, Y - H:i', 'l, j F, Y - H:i', 'l, Y, F j - H:i',
- 'l, F j, Y - g:ia', 'l, j F Y - g:ia', 'l, Y, F j - g:ia');
-
- // Date settings: construct choices for user
- foreach ($dateshort as $f) {
- $dateshortchoices[$f] = format_date(time(), 'custom', $f);
- }
- foreach ($datemedium as $f) {
- $datemediumchoices[$f] = format_date(time(), 'custom', $f);
- }
- foreach ($datelong as $f) {
- $datelongchoices[$f] = format_date(time(), 'custom', $f);
- }
-
- $form['dates'] = array('#type' => 'fieldset', '#title' => t('Date settings'), '#collapsible' => TRUE, '#collapsed' => TRUE);
- $form['dates']['date_default_timezone'] = array(
- '#type' => 'select', '#title' => t('Default time zone'), '#default_value' => variable_get('date_default_timezone', 0),
- '#options' => $zones, '#description' => t('Select the default site time zone.')
- );
-
- $form['dates']['configurable_timezones'] = array(
- '#type' => 'radios', '#title' => t('Configurable time zones'), '#default_value' => variable_get('configurable_timezones', 1), '#options' => array(t('Disabled'), t('Enabled')),
- '#description' => t('Enable or disable user-configurable time zones. When enabled, users can set their own time zone and dates will be updated accordingly.')
- );
-
- $form['dates']['date_format_short'] = array(
- '#type' => 'select', '#title' => t('Short date format'), '#default_value' => variable_get('date_format_short', $dateshort[0]),
- '#options' => $dateshortchoices, '#description' => t('The short format of date display.')
- );
-
- $form['dates']['date_format_medium'] = array(
- '#type' => 'select', '#title' => t('Medium date format'), '#default_value' => variable_get('date_format_medium', $datemedium[0]),
- '#options' => $datemediumchoices, '#description' => t('The medium sized date display.')
- );
-
- $form['dates']['date_format_long'] = array(
- '#type' => 'select', '#title' => t('Long date format'), '#default_value' => variable_get('date_format_long', $datelong[0]),
- '#options' => $datelongchoices, '#description' => t('Longer date format used for detailed display.')
- );
-
- $form['dates']['date_first_day'] = array(
- '#type' => 'select', '#title' => t('First day of week'), '#default_value' => variable_get('date_first_day', 0),
- '#options' => array(0 => t('Sunday'), 1 => t('Monday'), 2 => t('Tuesday'), 3 => t('Wednesday'), 4 => t('Thursday'), 5 => t('Friday'), 6 => t('Saturday')),
- '#description' => t('The first day of the week for calendar views.')
- );
-
-
- // Site off-line/maintenance settings
- $form['site_status'] = array(
- '#type' => 'fieldset',
- '#title' => t('Site maintenance'),
- '#collapsible' => TRUE,
- '#collapsed' => TRUE);
-
- $form['site_status']['site_offline'] = array(
- '#type' => 'radios',
- '#title' => t('Site status'),
- '#default_value' => variable_get('site_offline', 0),
- '#options' => array(t('Online'), t('Off-line')),
- '#description' => t('When set to "Online", all visitors will be able to browse your site normally. When set to "Off-line", only users with the "administer site configuration" permission will be able to access your site to perform maintenance; all other visitors will see the site off-line message configured below. Authorized users can log in during "Off-line" mode directly via the user login page.', array('%user-login' => url('user'))),
- );
-
- $form['site_status']['site_offline_message'] = array(
- '#type' => 'textarea',
- '#title' => t('Site off-line message'),
- '#default_value' => variable_get('site_offline_message', t('%site is currently under maintenance. We should be back shortly. Thank you for your patience.', array('%site' => variable_get('site_name', t('This Drupal site'))))),
- '#description' => t('Message to show visitors when the site is in off-line mode.')
- );
-
- // String handling: report status and errors.
- $form['strings'] = array('#type' => 'fieldset', '#title' => t('String handling'), '#collapsible' => TRUE, '#collapsed' => TRUE);
- $form['strings'] = array_merge($form['strings'], unicode_settings());
-
- // Cron: report status and errors.
- $form['cron'] = array('#type' => 'fieldset', '#title' => t('Cron jobs'), '#collapsible' => TRUE, '#collapsed' => TRUE);
- $form['cron'] = array_merge($form['cron'], system_cron_settings());
-
- // Check database setup if necessary
- if (function_exists('db_check_setup') && empty($_POST)) {
- db_check_setup();
- }
- return $form;
-}
-
-/**
- * Checks the existence of the directory specified in $form_element. This
- * function is called from the system_view_general form to check both the
- * file_directory_path and file_directory_temp directories. If validation
- * fails, the form element is flagged with an error from within the
- * file_check_directory function.
- *
- * @param $form_element
- * The form element containing the name of the directory to check.
- */
-function system_check_directory($form_element) {
- file_check_directory($form_element['#value'], FILE_CREATE_DIRECTORY, $form_element['#parents'][0]);
- return $form_element;
-}
-
-/**
- * Return the cron status and errors for admin/settings.
- */
-function system_cron_settings() {
- $cron_last = variable_get('cron_last', NULL);
-
- if (is_numeric($cron_last)) {
- $status = t('Cron is running. The last cron job ran %time ago.', array('%time' => format_interval(time() - $cron_last)));
- }
- else {
- $status = t('Cron has not run. It appears cron jobs have not been setup on your system. Please check the help pages for configuring cron jobs.', array('%url' => 'http://drupal.org/cron'));
- }
-
- $form['settings'] = array('#type' => 'item', '#value' => $status);
- return $form;
-}
-
-/**
- * Retrieves the current status of an array of files in the system table.
- */
-function system_get_files_database(&$files, $type) {
- // Extract current files from database.
- $result = db_query("SELECT filename, name, type, status, throttle, schema_version FROM {system} WHERE type = '%s'", $type);
- while ($file = db_fetch_object($result)) {
- if (isset($files[$file->name]) && is_object($files[$file->name])) {
- $file->old_filename = $file->filename;
- foreach ($file as $key => $value) {
- if (!isset($files[$file->name]) || !isset($files[$file->name]->$key)) {
- $files[$file->name]->$key = $value;
- }
- }
- }
- }
-}
-
-/**
- * Collect data about all currently available themes
- */
-function system_theme_data() {
- // Find themes
- $themes = system_listing('\.theme$', 'themes');
-
- // Find theme engines
- $engines = system_listing('\.engine$', 'themes/engines');
-
- // can't iterate over array itself as it uses a copy of the array items
- foreach (array_keys($themes) as $key) {
- drupal_get_filename('theme', $themes[$key]->name, $themes[$key]->filename);
- drupal_load('theme', $themes[$key]->name);
- $themes[$key]->owner = $themes[$key]->filename;
- $themes[$key]->prefix = $key;
- }
-
- // Remove all theme engines from the system table
- db_query("DELETE FROM {system} WHERE type = 'theme_engine'");
-
- foreach ($engines as $engine) {
- // Insert theme engine into system table
- drupal_get_filename('theme_engine', $engine->name, $engine->filename);
- drupal_load('theme_engine', $engine->name);
- db_query("INSERT INTO {system} (name, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', %d, %d, %d)", $engine->name, 'theme_engine', $engine->filename, 1, 0, 0);
-
- // Add templates to the site listing
- foreach (call_user_func($engine->name . '_templates') as $template) {
- // Do not double-insert templates with theme files in their directory,
- // but do register their engine data.
- if (array_key_exists($template->name, $themes)) {
- $themes[$template->name]->template = TRUE;
- $themes[$template->name]->owner = $engine->filename;
- $themes[$template->name]->prefix = $engine->name;
- }
- else {
- $template->template = TRUE;
- $template->name = basename(dirname($template->filename));
- $template->owner = $engine->filename;
- $template->prefix = $engine->name;
-
- $themes[$template->name] = $template;
- }
- }
- }
-
- // Find styles in each theme's directory.
- foreach ($themes as $theme) {
- foreach (file_scan_directory(dirname($theme->filename), 'style.css$') as $style) {
- $style->style = TRUE;
- $style->template = isset($theme->template) ? $theme->template : FALSE;
- $style->name = basename(dirname($style->filename));
- $style->owner = $theme->filename;
- $style->prefix = $theme->template ? $theme->prefix : $theme->name;
- // do not double-insert styles with theme files in their directory
- if (array_key_exists($style->name, $themes)) {
- continue;
- }
- $themes[$style->name] = $style;
- }
- }
-
- // Extract current files from database.
- system_get_files_database($themes, 'theme');
-
- db_query("DELETE FROM {system} WHERE type = 'theme'");
-
- foreach ($themes as $theme) {
- db_query("INSERT INTO {system} (name, description, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', '%s', %d, %d, %d)", $theme->name, $theme->owner, 'theme', $theme->filename, $theme->status, 0, 0);
- }
-
- return $themes;
-}
-
-/**
- * Get a list of available regions from a specified theme.
- *
- * @param $theme_key
- * The name of a theme.
- * @return
- * An array of regions in the form $region['name'] = 'description'.
- */
-function system_region_list($theme_key) {
- static $list = array();
-
- if (!array_key_exists($theme_key, $list)) {
- $theme = db_fetch_object(db_query("SELECT * FROM {system} WHERE type = 'theme' AND name = '%s'", $theme_key));
-
- // Stylesheets can't have regions; use its theme.
- if (strpos($theme->filename, '.css')) {
- return system_region_list(basename(dirname($theme->description)));
- }
-
- // If this is a custom theme, load it in before moving on.
- if (file_exists($file = dirname($theme->filename) .'/' . $theme_key . '.theme')) {
- include_once "./$file";
- }
-
- $regions = array();
-
- // This theme has defined its own regions.
- if (function_exists($theme_key . '_regions')) {
- $regions = call_user_func($theme_key . '_regions');
- }
- // File is an engine; include its regions.
- else if (strpos($theme->description, '.engine')) {
- include_once './' . $theme->description;
- $theme_engine = basename($theme->description, '.engine');
- $regions = function_exists($theme_engine . '_regions') ? call_user_func($theme_engine . '_regions') : array();
- }
-
- $list[$theme_key] = $regions;
- }
-
- return $list[$theme_key];
-}
-
-/**
- * Get the name of the default region for a given theme.
- *
- * @param $theme
- * The name of a theme.
- * @return
- * A string that is the region name.
- */
-function system_default_region($theme) {
- $regions = array_keys(system_region_list($theme));
- return $regions[0];
-}
-
-/**
- * Returns an array of files objects of the given type from both the
- * site-wide directory (i.e. modules/) and site-specific directory
- * (i.e. sites/somesite/modules/). The returned array will be keyed
- * using the key specified (name, basename, filename). Using name or
- * basename will cause site-specific files to shadow files in the
- * default directories. That is, if a file with the same name appears
- * in both location, only the site-specific version will be included.
- *
- * @param $mask
- * The regular expression of the files to find.
- * @param $directory
- * The subdirectory name in which the files are found. For example,
- * 'modules' will search in both modules/ and
- * sites/somesite/modules/.
- * @param $key
- * The key to be passed to file_scan_directory().
- * @param $min_depth
- * Minimum depth of directories to return files from.
- *
- * @return
- * An array of file objects of the specified type.
- */
-function system_listing($mask, $directory, $key = 'name', $min_depth = 1) {
- $config = conf_init();
- $searchdir = array($directory);
- $files = array();
-
- if (file_exists("$config/$directory")) {
- $searchdir[] = "$config/$directory";
- }
-
- // Get current list of items
- foreach ($searchdir as $dir) {
- $files = array_merge($files, file_scan_directory($dir, $mask, array('.', '..', 'CVS'), 0, TRUE, $key, $min_depth));
- }
-
- return $files;
-}
-
-/**
- * Assign an initial, default set of blocks for a theme.
- *
- * This function is called the first time a new theme is enabled. The new theme
- * gets a copy of the default theme's blocks, with the difference that if a
- * particular region isn't available in the new theme, the block is assigned
- * to the new theme's default region.
- *
- * @param $theme
- * The name of a theme.
- */
-function system_initialize_theme_blocks($theme) {
- // Initialize theme's blocks if none already registered.
- if (!(db_num_rows(db_query("SELECT module FROM {blocks} WHERE theme = '%s'", $theme)))) {
- $default_theme = variable_get('theme_default', 'bluemarine');
- $regions = system_region_list($theme);
- $result = db_query("SELECT * FROM {blocks} WHERE theme = '%s'", $default_theme);
- while($block = db_fetch_array($result)) {
- // If the region isn't supported by the theme, assign the block to the theme's default region.
- if (!array_key_exists($block['region'], $regions)) {
- $block['region'] = system_default_region($theme);
- }
- db_query("INSERT INTO {blocks} (module, delta, theme, status, weight, region, visibility, pages, custom, throttle) VALUES ('%s', '%s', '%s', %d, %d, '%s', %d, '%s', %d, %d)",
- $block['module'], $block['delta'], $theme, $block['status'], $block['weight'], $block['region'], $block['visibility'], $block['pages'], $block['custom'], $block['throttle']);
- }
- }
-}
-
-// Add the submit / reset buttons and run drupal_get_form()
-function system_settings_form($form_id, $form) {
- $form['buttons']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration') );
- $form['buttons']['reset'] = array('#type' => 'submit', '#value' => t('Reset to defaults') );
-
- if (!empty($_POST) && form_get_errors()) {
- drupal_set_message(t('The settings have not been saved because of the errors.'), 'error');
- }
-
- return drupal_get_form($form_id, $form, 'system_settings_form');
-}
-
-function system_theme_settings_submit($form_id, $values) {
- $op = isset($_POST['op']) ? $_POST['op'] : '';
- $key = $values['var'];
-
- if ($op == t('Reset to defaults')) {
- variable_del($key);
- drupal_set_message(t('The configuration options have been reset to their default values.'));
- }
- else {
- variable_set($key, $values);
- drupal_set_message(t('The configuration options have been saved.'));
- }
-}
-
-/**
- * Execute the system_settings_form.
- *
- * If you want node type configure style handling of your checkboxes,
- * add an array_filter value to your form.
- *
- */
-function system_settings_form_submit($form_id, $values) {
- $op = isset($_POST['op']) ? $_POST['op'] : '';
-
- foreach ($values as $key => $value) {
- if ($op == t('Reset to defaults')) {
- variable_del($key);
- }
- else {
- if (is_array($value) && isset($values['array_filter'])) {
- $value = array_keys(array_filter($value));
- }
- variable_set($key, $value);
- }
- }
- if ($op == t('Reset to defaults')) {
- drupal_set_message(t('The configuration options have been reset to their default values.'));
- }
- else {
- drupal_set_message(t('The configuration options have been saved.'));
- }
- menu_rebuild();
-}
-
-/**
- * Do the clean url validation, changing the form property if it doesn't work.
- */
-function system_settings_validate($form_id, &$form) {
- #TODO .. fix here.
- if ($edit['clean_url'] && !variable_get('clean_url_ok', 0)) {
- drupal_set_message(t('It appears your host is not configured correctly for Clean URLs. Please check for ModRewritesupport with your administrator.'), 'error'); - $edit['clean_url'] = 0; - } - -} - - - - -/** - * Menu callback; displays a listing of all themes. - */ -function system_themes() { - $themes = system_theme_data(); - ksort($themes); - - foreach ($themes as $info) { - $info->screenshot = dirname($info->filename) . '/screenshot.png'; - $screenshot = file_exists($info->screenshot) ? theme('image', $info->screenshot, t('Screenshot for %theme theme', array('%theme' => $info->name)), '', array('class' => 'screenshot'), false) : t('no screenshot'); - - $form[$info->name]['screenshot'] = array('#type' => 'markup', '#value' => $screenshot); - $form[$info->name]['description'] = array('#type' => 'item', '#title' => $info->name, '#value' => dirname($info->filename)); - $options[$info->name] = ''; - if ($info->status) { - $status[] = $info->name; - } - if ($info->status && (function_exists($info->prefix . '_settings') || function_exists($info->prefix . '_features'))) { - $form[$info->name]['operations'] = array('#type' => 'markup', '#value' => l(t('configure'), 'admin/themes/settings/' . $info->name) ); - } - else { - // Dummy element for form_render. Cleaner than adding a check in the theme function. - $form[$info->name]['operations'] = array(); - } - } - - $form['status'] = array('#type' => 'checkboxes', '#options' => $options, '#default_value' => $status); - $form['theme_default'] = array('#type' => 'radios', '#options' => $options, '#default_value' => variable_get('theme_default', 'bluemarine')); - $form['buttons']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration') ); - $form['buttons']['reset'] = array('#type' => 'submit', '#value' => t('Reset to defaults') ); - - return drupal_get_form('system_themes', $form); -} - -function theme_system_themes($form) { - foreach (element_children($form) as $key) { - $row = array(); - if (is_array($form[$key]['description'])) { - $row[] = form_render($form[$key]['screenshot']); - $row[] = form_render($form[$key]['description']); - $row[] = array('data' => form_render($form['status'][$key]), 'align' => 'center'); - if ($form['theme_default']) { - $row[] = array('data' => form_render($form['theme_default'][$key]), 'align' => 'center'); - $row[] = array('data' => form_render($form[$key]['operations']), 'align' => 'center'); - } - } - $rows[] = $row; - } - - $header = array(t('Screenshot'), t('Name'), t('Enabled'), t('Default'), t('Operations')); - $output = theme('table', $header, $rows); - $output .= form_render($form); - return $output; -} - - -function system_themes_submit($form_id, $values) { - - db_query("UPDATE {system} SET status = 0 WHERE type = 'theme'"); - - if ($_POST['op'] == t('Save configuration')) { - if (is_array($values['status'])) { - foreach ($values['status'] as $key => $choice) { - // Always enable the default theme, despite its status checkbox being checked: - if ($choice || $values['theme_default'] == $key) { - // If theme status is being set to 1 from 0, initialize block data for this theme if necessary. - if (db_num_rows(db_query("SELECT status FROM {system} WHERE type = 'theme' AND name = '%s' AND status = 0", $key))) { - system_initialize_theme_blocks($key); - } - db_query("UPDATE {system} SET status = 1 WHERE type = 'theme' and name = '%s'", $key); - } - } - } - variable_set('theme_default', $values['theme_default']); - } - else { - variable_del('theme_default'); - db_query("UPDATE {system} SET status = 1 WHERE type = 'theme' AND name = 'bluemarine'"); - } - - menu_rebuild(); - drupal_set_message(t('The configuration options have been saved.')); - return 'admin/themes'; -} - -/** - * Menu callback; displays a listing of all modules. - */ -function system_modules() { - // Get current list of modules - $files = system_listing('\.module$', 'modules', 'name', 0); - - // Extract current files from database. - system_get_files_database($files, 'module'); - - ksort($files); - - foreach ($files as $filename => $file) { - drupal_get_filename('module', $file->name, $file->filename); - drupal_load('module', $file->name); - - $file->description = module_invoke($file->name, 'help', 'admin/modules#description'); - - $form['name'][$file->name] = array('#value' => $file->name); - $form['description'][$file->name] = array('#value' => $file->description); - $options[$file->name] = ''; - if ($file->status) { - $status[] = $file->name; - } - if ($file->throttle) { - $throttle[] = $file->name; - } - - // log the critical hooks implemented by this module - $bootstrap = 0; - foreach (bootstrap_hooks() as $hook) { - if (module_hook($file->name, $hook)) { - $bootstrap = 1; - break; - } - } - - // Update the contents of the system table: - if (isset($file->status) || (isset($file->old_filename) && $file->old_filename != $file->filename)) { - db_query("UPDATE {system} SET description = '%s', name = '%s', bootstrap = %d, filename = '%s' WHERE filename = '%s'", $file->description, $file->name, $bootstrap, $file->filename, $file->old_filename); - } - else { - // This is a new module. - db_query("INSERT INTO {system} (name, description, type, filename, status, throttle, bootstrap) VALUES ('%s', '%s', '%s', '%s', %d, %d, %d)", $file->name, $file->description, 'module', $file->filename, $file->status, $file->throttle, $bootstrap); - } - } - - - // Handle status checkboxes, including overriding the generated - // checkboxes for required modules. - $form['status'] = array('#type' => 'checkboxes', '#default_value' => $status, '#options' => $options); - $required = array('block', 'filter', 'node', 'system', 'user', 'watchdog'); - foreach ($required as $require) { - $form['status'][$require] = array('#type' => 'hidden', '#value' => 1, '#suffix' => t('required')); - } - - /** - * Handle throttle checkboxes, including overriding the generated checkboxes for required modules. - */ - if (module_exist('throttle')) { - $form['throttle'] = array('#type' => 'checkboxes', '#default_value' => $throttle, '#options' => $options); - $throttle_required = array_merge($required, array('throttle')); - foreach ($throttle_required as $require) { - $form['throttle'][$require] = array('#type' => 'hidden', '#value' => 1, '#suffix' => t('required')); - } - } - - $form['buttons']['submit'] = array('#type' => 'submit', '#value' => t('Save configuration')); - - return drupal_get_form('system_modules', $form); -} - -function theme_system_modules($form) { - foreach (element_children($form['name']) as $key) { - $row = array(); - $row[] = form_render($form['name'][$key]); - $row[] = form_render($form['description'][$key]); - $row[] = array('data' => form_render($form['status'][$key]), 'align' => 'center'); - - if (module_exist('throttle')) { - $row[] = array('data' => form_render($form['throttle'][$key]), 'align' => 'center'); - } - $rows[] = $row; - } - - $header = array(t('Name'), t('Description'), t('Enabled')); - if (module_exist('throttle')) { - $header[] = t('Throttle'); - } - - $output = theme('table', $header, $rows); - $output .= form_render($form); - return $output; -} - - -function system_modules_submit($form_id, $edit) { - db_query("UPDATE {system} SET status = 0, throttle = 0 WHERE type = 'module'"); - - $new_modules = array(); - foreach ($edit['status'] as $key => $choice) { - if ($choice) { - db_query("UPDATE {system} SET status = 1 WHERE type = 'module' AND name = '%s'", $key); - if (!module_exist($key)) { - $new_modules[] = $key; - } - } - } - - if (is_array($edit['throttle'])) { - foreach ($edit['throttle'] as $key => $choice) { - if ($choice) { - db_query("UPDATE {system} SET throttle = 1 WHERE type = 'module' and name = '%s'", $key); - } - } - } - - module_list(TRUE, FALSE); - menu_rebuild(); - - include './includes/install.inc'; - foreach ($new_modules as $module) { - // Set the installed schema version for newly-enabled modules - $versions = drupal_get_schema_versions($module); - if (drupal_get_installed_schema_version($module) == SCHEMA_UNINSTALLED) { - drupal_set_installed_schema_version($module, $versions ? max($versions) : SCHEMA_INSTALLED); - module_invoke($module, 'install'); - } - } - - drupal_set_message(t('The configuration options have been saved.')); - return 'admin/modules'; -} - - -/** - * Menu callback; displays a module's settings page. - */ -function system_site_settings($module = NULL) { - - if ($module) { - $form = module_invoke($module, 'settings'); - } - else { - $form = system_view_general(); - $module = 'system'; - } - - return system_settings_form($module . '_settings_form', $form); -} - -/** - * Menu callback; display theme configuration for entire site and individual themes. - */ -function system_theme_settings($key = '') { - $directory_path = file_directory_path(); - file_check_directory($directory_path, FILE_CREATE_DIRECTORY, 'file_directory_path'); - - // Default settings are defined in theme_get_settings() in includes/theme.inc - if ($key) { - $settings = theme_get_settings($key); - $var = str_replace('/', '_', 'theme_'. $key .'_settings'); - $themes = system_theme_data(); - $features = function_exists($themes[$key]->prefix . '_features') ? call_user_func($themes[$key]->prefix . '_features') : array(); - } - else { - $settings = theme_get_settings(''); - $var = 'theme_settings'; - } - - $form['var'] = array('#type' => 'hidden', '#value' => $var); - - // Check for a new uploaded logo, and use that instead. - if ($file = file_check_upload('logo_upload')) { - if ($info = image_get_info($file->filepath)) { - $parts = pathinfo($file->filename); - $filename = ($key) ? str_replace('/', '_', $key) . '_logo.' . $parts['extension'] : 'logo.' . $parts['extension']; - - if ($file = file_save_upload('logo_upload', $filename, 1)) { - $_POST['edit']['default_logo'] = 0; - $_POST['edit']['logo_path'] = $file->filepath; - } - } - else { - form_set_error('file_upload', t('Only JPEG, PNG and GIF images are allowed to be used as logos.')); - } - } - - // Check for a new uploaded favicon, and use that instead. - if ($file = file_check_upload('favicon_upload')) { - $parts = pathinfo($file->filename); - $filename = ($key) ? str_replace('/', '_', $key) . '_favicon.' . $parts['extension'] : 'favicon.' . $parts['extension']; - - if ($file = file_save_upload('favicon_upload', $filename, 1)) { - $_POST['edit']['default_favicon'] = 0; - $_POST['edit']['favicon_path'] = $file->filepath; - } - } - - - // Logo settings - if ((!$key) || in_array('logo', $features)) { - $form['logo'] = array('#type' => 'fieldset', '#title' => t('Logo image settings')); - $form['logo']["default_logo"] = array( - '#type' => 'checkbox', - '#title' => t('Use the default logo'), - '#default_value' => $settings['default_logo'], - '#tree' => FALSE, - '#description' => t('Check here if you want the theme to use the logo supplied with it.') - ); - $form['logo']['logo_path'] = array( - '#type' => 'textfield', - '#title' => t('Path to custom logo'), - '#default_value' => $settings['logo_path'], - '#description' => t('The path to the file you would like to use as your logo file instead of the default logo.')); - - $form['logo']['logo_upload'] = array( - '#type' => 'file', - '#title' => t('Upload logo image'), - '#maxlength' => 40, - '#description' => t("If you don't have direct file access to the server, use this field to upload your logo.") - ); - } - - // Icon settings - if ((!$key) || in_array('toggle_favicon', $features)) { - $form['favicon'] = array('#type' => 'fieldset', '#title' => t('Shortcut icon settings')); - $form['favicon']['text'] = array('#value' => t('Your shortcut icon or \'favicon\' is displayed in the address bar and bookmarks of most browsers.')); - $form['favicon']['default_favicon'] = array( - '#type' => 'checkbox', - '#title' => t('Use the default shortcut icon.'), - '#default_value' => $settings['default_favicon'], - '#description' => t('Check here if you want the theme to use the default shortcut icon.') - ); - $form['favicon']['favicon_path'] = array( - '#type' => 'textfield', - '#title' => t('Path to custom icon'), - '#default_value' => $settings['favicon_path'], - '#description' => t('The path to the image file you would like to use as your custom shortcut icon.') - ); - - $form['favicon']['favicon_upload'] = array( - '#type' => 'file', - '#title' => t('Upload icon image'), - '#description' => t("If you don't have direct file access to the server, use this field to upload your shortcut icon.") - ); - } - - // System wide only settings. - if (!$key) { - // Toggle node display. - $node_types = module_invoke('node', 'get_types'); - if ($node_types) { - $group = ''; - $form['node_info'] = array('#type' => 'fieldset', '#title' => t('Display post information on'), '#description' => t('Enable or disable the "submitted by Username on date" text when displaying posts of the above type')); - foreach ($node_types as $type => $name) { - $form['node_info']["toggle_node_info_$type"] = array('#type' => 'checkbox', '#title' => $name, '#default_value' => $settings["toggle_node_info_$type"]); - } - } - } - - $group = ''; - - // Toggle settings - $toggles = array( - 'toggle_name' => t('Site name'), - 'toggle_slogan' => t('Site slogan'), - 'toggle_mission' => t('Mission statement'), - 'toggle_node_user_picture' => t('User pictures in posts'), - 'toggle_comment_user_picture' => t('User pictures in comments'), - 'toggle_search' => t('Search box'), - 'toggle_favicon' => t('Shortcut icon') - ); - - // Some features are not always available - $disabled = array(); - if (!variable_get('user_pictures', 0)) { - $disabled['toggle_node_user_picture'] = true; - $disabled['toggle_comment_user_picture'] = true; - } - if (!module_exist('search')) { - $disabled['toggle_search'] = true; - } - - $form['theme_settings'] = array('#type' => 'fieldset', '#title' => t('Toggle display'), '#description' => t('Enable or disable the display of certain page elements.')); - foreach ($toggles as $name => $title) { - if ((!$key) || in_array($name, $features)) { - // disable search box if search.module is disabled - $form['theme_settings'][$name] = array('#type' => 'checkbox', '#title' => $title, '#default_value' => $settings[$name]); - if (isset($disabled[$name])) { - $form['theme_settings'][$name]['#attributes'] = array('disabled' => 'disabled'); - } - } - } - - if ($key) { - // Template-specific settings - $function = $themes[$key]->prefix .'_settings'; - if (function_exists($function)) { - if ($themes[$key]->template) { - // file is a template or a style of a template - $form['specific'] = array('#type' => 'fieldset', '#title' => t('Engine-specific settings'), '#description' => t('These settings only exist for all the templates and styles based on the %engine theme engine.', array('%engine' => $themes[$key]->prefix))); - } - else { - // file is a theme or a style of a theme - $form['specific'] = array('#type' => 'fieldset', '#title' => t('Theme-specific settings'), '#description' => t('These settings only exist for the %theme theme and all the styles based on it.', array('%theme' => $themes[$key]->prefix))); - } - $group = $function(); - $form['specific'] = array_merge($form['specific'], (is_array($group) ? $group : array())); - } - } - $form['#attributes'] = array('enctype' => 'multipart/form-data'); - - return system_settings_form('system_theme_settings', $form); - -} - -/** - * Output a search form. - */ -function search_box($path = NULL) { - $form['keys'] = array('#type' => 'textfield', '#size'=> 15, '#default_value' => '', '#attributes' => array('alt' => t('Enter the terms you wish to search for.'))); - $form['submit'] = array('#type' => 'submit', '#value' => t('Search')); - return drupal_get_form('search_box', $form); -} - -/** - * Theme a search form. - */ -function theme_search_box($form) { - $output = ''; - $output .= form_render($form); - $output .= ''; - return $output; -} - -/** - * Output a confirmation form - * - * This function outputs a complete form for confirming an action. A link is - * offered to go back to the item that is being changed in case the user changes - * his/her mind. - * - * You should use $GLOBALS['values']['edit'][$name] (where $name is usually 'confirm') to - * check if the confirmation was successful. - * - * @param $form_id - * The unique form identifier. Used by the form API to construct the theme. - * @param $form - * Additional elements to inject into the form, for example hidden elements. - * @param $question - * The question to ask the user (e.g. "Are you sure you want to delete the - * block foo?"). - * @param $path - * The page to go to if the user denies the action. - * @param $description - * Additional text to display (defaults to "This action cannot be undone."). - * @param $yes - * A caption for the button which confirms the action (e.g. "Delete", - * "Replace", ...). - * @param $no - * A caption for the link which denies the action (e.g. "Cancel"). - * @param $name - * The internal name used to refer to the confirmation item. - * @return - * A themed HTML string representing the form. - */ - -function confirm_form($form_id, $form, $question, $path, $description = NULL, $yes = NULL, $no = NULL, $name = 'confirm') { - - $description = ($description) ? $description : t('This action cannot be undone.'); - drupal_set_title($question); - $form['#attributes'] = array('class' => 'confirmation'); - $form['description'] = array('#value' => $description); - $form[$name] = array('#type' => 'hidden', '#value' => 1); - - $form['actions'] = array('#prefix' => '', '#suffix' => ''); - $form['actions']['submit'] = array('#type' => 'submit', '#value' => $yes ? $yes : t('Confirm')); - $form['actions']['cancel'] = array('#value' => l($no ? $no : t('Cancel'), $path)); - return drupal_get_form($form_id, $form, 'confirm_form'); -} diff --git a/modules/taxonomy/taxonomy.module b/modules/taxonomy/taxonomy.module deleted file mode 100644 index b14ca95f72ea6183b47d7b8a359a357f70d4e0f2..0000000000000000000000000000000000000000 --- a/modules/taxonomy/taxonomy.module +++ /dev/null @@ -1,1366 +0,0 @@ -links(taxonomy_link('taxonomy terms', $node)); - * } - */ -function taxonomy_link($type, $node = NULL) { - if ($type == 'taxonomy terms' && $node != NULL) { - $links = array(); - if (array_key_exists('taxonomy', $node)) { - foreach ($node->taxonomy as $term) { - $links[] = l($term->name, taxonomy_term_path($term), array('rel' => 'tag', 'title' => $term->description)); - } - } - return $links; - } -} - -function taxonomy_term_path($term) { - $vocabulary = taxonomy_get_vocabulary($term->vid); - if ($vocabulary->module != 'taxonomy' && $path = module_invoke($vocabulary->module, 'term_path', $term)) { - return $path; - } - return 'taxonomy/term/'. $term->tid; -} - -/** - * Implementation of hook_menu(). - */ -function taxonomy_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/taxonomy', - 'title' => t('categories'), - 'callback' => 'taxonomy_overview_vocabularies', - 'access' => user_access('administer taxonomy')); - - $items[] = array('path' => 'admin/taxonomy/list', - 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'weight' => -10); - - $items[] = array('path' => 'admin/taxonomy/add/vocabulary', - 'title' => t('add vocabulary'), - 'callback' => 'taxonomy_admin_vocabulary_edit', - 'access' => user_access('administer taxonomy'), - 'type' => MENU_LOCAL_TASK); - - $items[] = array('path' => 'admin/taxonomy/edit/vocabulary', - 'title' => t('edit vocabulary'), - 'callback' => 'taxonomy_admin_vocabulary_edit', - 'access' => user_access('administer taxonomy'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'admin/taxonomy/edit/term', - 'title' => t('edit term'), - 'callback' => 'taxonomy_admin_term_edit', - 'access' => user_access('administer taxonomy'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'taxonomy/term', - 'title' => t('taxonomy term'), - 'callback' => 'taxonomy_term_page', - 'access' => user_access('access content'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'taxonomy/autocomplete', - 'title' => t('autocomplete taxonomy'), - 'callback' => 'taxonomy_autocomplete', - 'access' => user_access('access content'), - 'type' => MENU_CALLBACK); - } - else { - if (is_numeric(arg(2))) { - $items[] = array('path' => 'admin/taxonomy/' . arg(2), - 'title' => t('list terms'), - 'callback' => 'taxonomy_overview_terms', - 'callback arguments' => array(arg(2)), - 'access' => user_access('administer taxonomy'), - 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'admin/taxonomy/' . arg(2) . '/list', - 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'weight' => -10); - - $items[] = array('path' => 'admin/taxonomy/' . arg(2) . '/add/term', - 'title' => t('add term'), - 'callback' => 'taxonomy_admin_term_add', - 'callback arguments' => array(arg(2)), - 'access' => user_access('administer taxonomy'), - 'type' => MENU_LOCAL_TASK); - } - } - - return $items; -} - -/** - * List and manage vocabularies. - */ -function taxonomy_overview_vocabularies() { - $vocabularies = taxonomy_get_vocabularies(); - foreach ($vocabularies as $vocabulary) { - $types = array(); - foreach ($vocabulary->nodes as $type) { - $node_type = node_get_name($type); - $types[] = $node_type ? $node_type : $type; - } - $form[$vocabulary->vid]['name'] = array('#value' => check_plain($vocabulary->name)); - $form[$vocabulary->vid]['type'] = array('#value' => implode(', ', $types)); - $form[$vocabulary->vid]['edit'] = array('#value' => l(t('edit vocabulary'), "admin/taxonomy/edit/vocabulary/$vocabulary->vid")); - $form[$vocabulary->vid]['list'] = array('#value' => l(t('list terms'), "admin/taxonomy/$vocabulary->vid")); - } - - return drupal_get_form('taxonomy_overview_vocabularies', $form); -} - -/** - * Theme overview vocabularies. - */ -function theme_taxonomy_overview_vocabularies($form) { - $rows = array(); - foreach (element_children($form) as $key) { - if (isset($form[$key]['name'])) { - $row = array(); - $row[] = form_render($form[$key]['name']); - $row[] = form_render($form[$key]['type']); - $row[] = form_render($form[$key]['edit']); - $row[] = form_render($form[$key]['list']); - $rows[] = $row; - } - } - if (!$rows) { - $rows[] = array(array('data' => t('No categories available.'), 'colspan' => '4', 'class' => 'message')); - } - $header = array(t('Name'), t('Type'), array('data' => t('Operations'), 'colspan' => '2')); - - $output = theme('table', $header, $rows, array('id' => 'taxonomy')); - $output .= form_render($form); - return $output; -} - -/** - * Display a tree of all the terms in a vocabulary, with options to edit - * each one. - */ -function taxonomy_overview_terms($vid) { - $destination = drupal_get_destination(); - - $header = array(t('Name'), t('Operations')); - $vocabulary = taxonomy_get_vocabulary($vid); - - drupal_set_title(check_plain($vocabulary->name)); - $start_from = $_GET['page'] ? $_GET['page'] : 0; - $total_entries = 0; // total count for pager - $page_increment = 25; // number of tids per page - $displayed_count = 0; // number of tids shown - - $tree = taxonomy_get_tree($vocabulary->vid); - foreach ($tree as $term) { - $total_entries++; // we're counting all-totals, not displayed - if (($start_from && ($start_from * $page_increment) >= $total_entries) || ($displayed_count == $page_increment)) { continue; } - $rows[] = array(_taxonomy_depth($term->depth) . ' ' . l($term->name, "taxonomy/term/$term->tid"), l(t('edit'), "admin/taxonomy/edit/term/$term->tid", array(), $destination)); - $displayed_count++; // we're counting tids displayed - } - - if (!$rows) { - $rows[] = array(array('data' => t('No terms available.'), 'colspan' => '2')); - } - - $GLOBALS['pager_page_array'][] = $start_from; // FIXME - $GLOBALS['pager_total'][] = intval($total_entries / $page_increment) + 1; // FIXME - - if ($total_entries >= $page_increment) { - $rows[] = array(array('data' => theme('pager', NULL, $page_increment), 'colspan' => '2')); - } - - return theme('table', $header, $rows, array('id' => 'taxonomy')); -} - -/** - * Display form for adding and editing vocabularies. - */ -function taxonomy_form_vocabulary($edit = array()) { - $form['name'] = array('#type' => 'textfield', - '#title' => t('Vocabulary name'), - '#default_value' => $edit['name'], - '#maxlength' => 64, - '#description' => t('The name for this vocabulary. Example: "Topic".'), - '#required' => TRUE, - ); - $form['description'] = array('#type' => 'textarea', - '#title' => t('Description'), - '#default_value' => $edit['description'], - '#description' => t('Description of the vocabulary; can be used by modules.'), - ); - $form['help'] = array('#type' => 'textfield', - '#title' => t('Help text'), - '#default_value' => $edit['help'], - '#maxlength' => 255, - '#description' => t('Instructions to present to the user when choosing a term.'), - ); - $form['nodes'] = array('#type' => 'checkboxes', - '#title' => t('Types'), - '#default_value' => $edit['nodes'], - '#options' => node_get_types(), - '#description' => t('A list of node types you want to associate with this vocabulary.'), - '#required' => TRUE, - ); - $form['hierarchy'] = array('#type' => 'radios', - '#title' => t('Hierarchy'), - '#default_value' => $edit['hierarchy'], - '#options' => array(t('Disabled'), t('Single'), t('Multiple')), - '#description' => t('Allows a tree-like hierarchy between terms of this vocabulary.', array('%help-url' => url('admin/help/taxonomy', NULL, NULL, 'hierarchy'))), - ); - $form['relations'] = array('#type' => 'checkbox', - '#title' => t('Related terms'), - '#default_value' => $edit['relations'], - '#description' => t('Allows related terms in this vocabulary.', array('%help-url' => url('admin/help/taxonomy', NULL, NULL, 'related-terms'))), - ); - $form['tags'] = array('#type' => 'checkbox', - '#title' => t('Free tagging'), - '#default_value' => $edit['tags'], - '#description' => t('Content is categorized by typing terms instead of choosing from a list.'), - ); - $form['multiple'] = array('#type' => 'checkbox', - '#title' => t('Multiple select'), - '#default_value' => $edit['multiple'], - '#description' => t('Allows nodes to have more than one term from this vocabulary (always true for free tagging).'), - ); - $form['required'] = array('#type' => 'checkbox', - '#title' => t('Required'), - '#default_value' => $edit['required'], - '#description' => t('If enabled, every node must have at least one term in this vocabulary.'), - ); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $edit['weight'], - '#description' => t('In listings, the heavier vocabularies will sink and the lighter vocabularies will be positioned nearer the top.'), - ); - - // Add extra vocabulary form elements. - $extra = module_invoke_all('taxonomy', 'form', 'vocabulary'); - if (is_array($extra)) { - foreach ($extra as $key => $element) { - $extra[$key]['#weight'] = isset($extra[$key]['#weight']) ? $extra[$key]['#weight'] : -18; - } - $form = array_merge($form, $extra); - } - - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit')); - if ($edit['vid']) { - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete')); - $form['vid'] = array('#type' => 'value', '#value' => $edit['vid']); - } - return drupal_get_form('taxonomy_form_vocabulary', $form); -} - -/** - * Accept the form submission for a vocabulary and save the results. - */ -function taxonomy_form_vocabulary_submit($form_id, $form_values) { - // Fix up the nodes array to remove unchecked nodes. - $form_values['nodes'] = array_filter($form_values['nodes']); - switch (taxonomy_save_vocabulary($form_values)) { - case SAVED_NEW: - drupal_set_message(t('Created new vocabulary %name.', array('%name' => theme('placeholder', $form_values['name'])))); - break; - case SAVED_UPDATED: - drupal_set_message(t('Updated vocabulary %name.', array('%name' => theme('placeholder', $form_values['name'])))); - break; - } - return 'admin/taxonomy'; -} - -function taxonomy_save_vocabulary(&$edit) { - $edit['nodes'] = empty($edit['nodes']) ? array() : $edit['nodes']; - - if ($edit['vid'] && $edit['name']) { - db_query("UPDATE {vocabulary} SET name = '%s', description = '%s', help = '%s', multiple = %d, required = %d, hierarchy = %d, relations = %d, tags = %d, weight = %d, module = '%s' WHERE vid = %d", $edit['name'], $edit['description'], $edit['help'], $edit['multiple'], $edit['required'], $edit['hierarchy'], $edit['relations'], $edit['tags'], $edit['weight'], isset($edit['module']) ? $edit['module'] : 'taxonomy', $edit['vid']); - db_query("DELETE FROM {vocabulary_node_types} WHERE vid = %d", $edit['vid']); - foreach ($edit['nodes'] as $type => $selected) { - db_query("INSERT INTO {vocabulary_node_types} (vid, type) VALUES (%d, '%s')", $edit['vid'], $type); - } - module_invoke_all('taxonomy', 'update', 'vocabulary', $edit); - $status = SAVED_UPDATED; - } - else if ($edit['vid']) { - $status = taxonomy_del_vocabulary($edit['vid']); - } - else { - $edit['vid'] = db_next_id('{vocabulary}_vid'); - db_query("INSERT INTO {vocabulary} (vid, name, description, help, multiple, required, hierarchy, relations, tags, weight, module) VALUES (%d, '%s', '%s', '%s', %d, %d, %d, %d, %d, %d, '%s')", $edit['vid'], $edit['name'], $edit['description'], $edit['help'], $edit['multiple'], $edit['required'], $edit['hierarchy'], $edit['relations'], $edit['tags'], $edit['weight'], isset($edit['module']) ? $edit['module'] : 'taxonomy'); - foreach ($edit['nodes'] as $type => $selected) { - db_query("INSERT INTO {vocabulary_node_types} (vid, type) VALUES (%d, '%s')", $edit['vid'], $type); - } - module_invoke_all('taxonomy', 'insert', 'vocabulary', $edit); - $status = SAVED_NEW; - } - - cache_clear_all(); - - return $status; -} - -function taxonomy_del_vocabulary($vid) { - $vocabulary = (array) taxonomy_get_vocabulary($vid); - - db_query('DELETE FROM {vocabulary} WHERE vid = %d', $vid); - db_query('DELETE FROM {vocabulary_node_types} WHERE vid = %d', $vid); - $result = db_query('SELECT tid FROM {term_data} WHERE vid = %d', $vid); - while ($term = db_fetch_object($result)) { - taxonomy_del_term($term->tid); - } - - module_invoke_all('taxonomy', 'delete', 'vocabulary', $vocabulary); - - cache_clear_all(); - - return SAVED_DELETED; -} - -function _taxonomy_confirm_del_vocabulary($vid) { - $vocabulary = taxonomy_get_vocabulary($vid); - - $form['type'] = array('#type' => 'value', '#value' => 'vocabulary'); - $form['vid'] = array('#type' => 'value', '#value' => $vid); - $form['name'] = array('#type' => 'value', '#value' => $vocabulary->name); - return confirm_form('taxonomy_vocabulary_confirm_delete', $form, - t('Are you sure you want to delete the vocabulary %title?', - array('%title' => theme('placeholder', $vocabulary->name))), - 'admin/taxonomy', t('Deleting a vocabulary will delete all the terms in it. This action cannot be undone.'), - t('Delete'), - t('Cancel')); -} - -function taxonomy_vocabulary_confirm_delete_submit($form_id, $form_values) { - $status = taxonomy_del_vocabulary($form_values['vid']); - drupal_set_message(t('Deleted vocabulary %name.', array('%name' => theme('placeholder', $form_values['name'])))); - return 'admin/taxonomy'; -} - -function taxonomy_form_term($edit = array()) { - $vocabulary_id = isset($edit['vid']) ? $edit['vid'] : arg(4); - $vocabulary = taxonomy_get_vocabulary($vocabulary_id); - - $form['name'] = array('#type' => 'textfield', '#title' => t('Term name'), '#default_value' => $edit['name'], '#maxlength' => 64, '#description' => t('The name for this term. Example: "Linux".'), '#required' => TRUE); - - $form['description'] = array('#type' => 'textarea', '#title' => t('Description'), '#default_value' => $edit['description'], '#description' => t('A description of the term.')); - - if ($vocabulary->hierarchy) { - $parent = array_keys(taxonomy_get_parents($edit['tid'])); - $children = taxonomy_get_tree($vocabulary_id, $edit['tid']); - - // A term can't be the child of itself, nor of its children. - foreach ($children as $child) { - $exclude[] = $child->tid; - } - $exclude[] = $edit['tid']; - - if ($vocabulary->hierarchy == 1) { - $form['parent'] = _taxonomy_term_select(t('Parent'), 'parent', $parent, $vocabulary_id, l(t('Parent term'), 'admin/help/taxonomy', NULL, NULL, 'parent') .'.', 0, '<'. t('root') .'>', $exclude); - } - elseif ($vocabulary->hierarchy == 2) { - $form['parent'] = _taxonomy_term_select(t('Parents'), 'parent', $parent, $vocabulary_id, l(t('Parent terms'), 'admin/help/taxonomy', NULL, NULL, 'parent') .'.', 1, '<'. t('root') .'>', $exclude); - } - } - - if ($vocabulary->relations) { - $form['relations'] = _taxonomy_term_select(t('Related terms'), 'relations', array_keys(taxonomy_get_related($edit['tid'])), $vocabulary_id, NULL, 1, '<'. t('none') .'>', array($edit['tid'])); - } - - $form['synonyms'] = array('#type' => 'textarea', '#title' => t('Synonyms'), '#default_value' => implode("\n", taxonomy_get_synonyms($edit['tid'])), '#description' => t('Synonyms of this term, one synonym per line.', array('%help-url' => url('admin/help/taxonomy', NULL, NULL, 'synonyms')))); - $form['weight'] = array('#type' => 'weight', '#title' => t('Weight'), '#default_value' => $edit['weight'], '#description' => t('In listings, the heavier terms will sink and the lighter terms will be positioned nearer the top.')); - - // Add extra term form elements. - $extra = module_invoke_all('taxonomy', 'term', 'vocabulary'); - if (is_array($extra)) { - foreach ($extra as $key => $element) { - $extra[$key]['#weight'] = isset($extra[$key]['#weight']) ? $extra[$key]['#weight'] : -18; - } - $form = array_merge($form, $extra); - } - - - $form['vid'] = array('#type' => 'value', '#value' => $vocabulary->vid); - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit')); - - if ($edit['tid']) { - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete')); - $form['tid'] = array('#type' => 'value', '#value' => $edit['tid']); - } - else { - $form['destination'] = array('#type' => 'hidden', '#value' => $_GET['q']); - } - - return drupal_get_form('taxonomy_form_term', $form); -} - -/** - * Accept the form submission for a taxonomy term and save the result. - */ -function taxonomy_form_term_submit($form_id, $form_values) { - switch (taxonomy_save_term($form_values)) { - case SAVED_NEW: - drupal_set_message(t('Created new term %term.', array('%term' => theme('placeholder', $form_values['name'])))); - break; - case SAVED_UPDATED: - drupal_set_message(t('The term %term has been updated.', array('%term' => theme('placeholder', $form_values['name'])))); - break; - } - return 'admin/taxonomy'; -} - -function taxonomy_save_term(&$edit) { - if ($edit['tid'] && $edit['name']) { - db_query("UPDATE {term_data} SET name = '%s', description = '%s', weight = %d WHERE tid = %d", $edit['name'], $edit['description'], $edit['weight'], $edit['tid']); - module_invoke_all('taxonomy', 'update', 'term', $edit); - $status = SAVED_UPDATED; - } - else if ($edit['tid']) { - return taxonomy_del_term($edit['tid']); - } - else { - $edit['tid'] = db_next_id('{term_data}_tid'); - db_query("INSERT INTO {term_data} (tid, name, description, vid, weight) VALUES (%d, '%s', '%s', %d, %d)", $edit['tid'], $edit['name'], $edit['description'], $edit['vid'], $edit['weight']); - module_invoke_all('taxonomy', 'insert', 'term', $edit); - $status = SAVED_NEW; - } - - db_query('DELETE FROM {term_relation} WHERE tid1 = %d OR tid2 = %d', $edit['tid'], $edit['tid']); - if ($edit['relations']) { - foreach ($edit['relations'] as $related_id) { - if ($related_id != 0) { - db_query('INSERT INTO {term_relation} (tid1, tid2) VALUES (%d, %d)', $edit['tid'], $related_id); - } - } - } - - db_query('DELETE FROM {term_hierarchy} WHERE tid = %d', $edit['tid']); - if (!isset($edit['parent']) || empty($edit['parent'])) { - $edit['parent'] = array(0); - } - if (is_array($edit['parent'])) { - foreach ($edit['parent'] as $parent) { - if (is_array($parent)) { - foreach ($parent as $tid) { - db_query('INSERT INTO {term_hierarchy} (tid, parent) VALUES (%d, %d)', $edit['tid'], $tid); - } - } - else { - db_query('INSERT INTO {term_hierarchy} (tid, parent) VALUES (%d, %d)', $edit['tid'], $parent); - } - } - } - else { - db_query('INSERT INTO {term_hierarchy} (tid, parent) VALUES (%d, %d)', $edit['tid'], $edit['parent']); - } - - db_query('DELETE FROM {term_synonym} WHERE tid = %d', $edit['tid']); - if ($edit['synonyms']) { - foreach (explode ("\n", str_replace("\r", '', $edit['synonyms'])) as $synonym) { - if ($synonym) { - db_query("INSERT INTO {term_synonym} (tid, name) VALUES (%d, '%s')", $edit['tid'], chop($synonym)); - } - } - } - - cache_clear_all(); - - return $status; -} - -function taxonomy_del_term($tid) { - $tids = array($tid); - while ($tids) { - $children_tids = $orphans = array(); - foreach ($tids as $tid) { - // See if any of the term's children are about to be become orphans: - if ($children = taxonomy_get_children($tid)) { - foreach ($children as $child) { - // If the term has multiple parents, we don't delete it. - $parents = taxonomy_get_parents($child->tid); - if (count($parents) == 1) { - $orphans[] = $child->tid; - } - } - } - - $term = taxonomy_get_term($tid); - - db_query('DELETE FROM {term_data} WHERE tid = %d', $tid); - db_query('DELETE FROM {term_hierarchy} WHERE tid = %d', $tid); - db_query('DELETE FROM {term_relation} WHERE tid1 = %d OR tid2 = %d', $tid, $tid); - db_query('DELETE FROM {term_synonym} WHERE tid = %d', $tid); - db_query('DELETE FROM {term_node} WHERE tid = %d', $tid); - - module_invoke_all('taxonomy', 'delete', 'term', $term); - } - - $tids = $orphans; - } - - cache_clear_all(); - - return SAVED_DELETED; -} - -function _taxonomy_confirm_del_term($tid) { - $term = taxonomy_get_term($tid); - - $form['type'] = array('#type' => 'value', '#value' => 'term'); - $form['name'] = array('#type' => 'value', '#value' => $term->name); - $form['tid'] = array('#type' => 'value', '#value' => $tid); - return confirm_form('taxonomy_term_confirm_delete', $form, - t('Are you sure you want to delete the term %title?', - array('%title' => theme('placeholder', $term->name))), - 'admin/taxonomy', - t('Deleting a term will delete all its children if there are any. This action cannot be undone.'), - t('Delete'), - t('Cancel')); -} - -function taxonomy_term_confirm_delete_submit($form_id, $form_values) { - taxonomy_del_term($form_values['tid']); - drupal_set_message(t('Deleted term %name.', array('%name' => theme('placeholder', $form_values['name'])))); - return 'admin/taxonomy'; -} - -/** - * Generate a form element for selecting terms from a vocabulary. - */ -function taxonomy_form($vid, $value = 0, $help = NULL, $name = 'taxonomy') { - $vocabulary = taxonomy_get_vocabulary($vid); - $help = ($help) ? $help : $vocabulary->help; - if ($vocabulary->required) { - $blank = 0; - } - else { - $blank = '<'. t('none') .'>'; - } - - return _taxonomy_term_select(check_plain($vocabulary->name), $name, $value, $vid, $help, intval($vocabulary->multiple), $blank); -} - -/** - * Generate a set of options for selecting a term from all vocabularies. Can be - * passed to form_select. - */ -function taxonomy_form_all($free_tags = 0) { - $vocabularies = taxonomy_get_vocabularies(); - $options = array(); - foreach ($vocabularies as $vid => $vocabulary) { - if ($vocabulary->tags && !$free_tags) { continue; } - $tree = taxonomy_get_tree($vid); - $options[$vocabulary->name] = array(); - if ($tree) { - foreach ($tree as $term) { - $options[$vocabulary->name][$term->tid] = _taxonomy_depth($term->depth, '-') . $term->name; - } - } - } - return $options; -} - -/** - * Return an array of all vocabulary objects. - * - * @param $type - * If set, return only those vocabularies associated with this node type. - */ -function taxonomy_get_vocabularies($type = NULL) { - if ($type) { - $result = db_query(db_rewrite_sql("SELECT v.vid, v.*, n.type FROM {vocabulary} v LEFT JOIN {vocabulary_node_types} n ON v.vid = n.vid WHERE n.type = '%s' ORDER BY v.weight, v.name", 'v', 'vid'), $type); - } - else { - $result = db_query(db_rewrite_sql('SELECT v.*, n.type FROM {vocabulary} v LEFT JOIN {vocabulary_node_types} n ON v.vid = n.vid ORDER BY v.weight, v.name', 'v', 'vid')); - } - - $vocabularies = array(); - $node_types = array(); - while ($voc = db_fetch_object($result)) { - $node_types[$voc->vid][] = $voc->type; - unset($voc->type); - $voc->nodes = $node_types[$voc->vid]; - $vocabularies[$voc->vid] = $voc; - } - - return $vocabularies; -} - -/** - * Generate a form for selecting terms to associate with a node. - */ -function taxonomy_form_alter($form_id, &$form) { - if (isset($form['type']) && $form['type']['#value'] .'_node_form' == $form_id) { - $node = $form['#node']; - - if (!isset($node->taxonomy)) { - if ($node->nid) { - $terms = taxonomy_node_get_terms($node->nid); - } - else { - $terms = array(); - } - } - else { - $terms = $node->taxonomy; - } - - $c = db_query(db_rewrite_sql("SELECT v.* FROM {vocabulary} v INNER JOIN {vocabulary_node_types} n ON v.vid = n.vid WHERE n.type = '%s' ORDER BY v.weight, v.name", 'v', 'vid'), $node->type); - - while ($vocabulary = db_fetch_object($c)) { - if ($vocabulary->tags) { - $typed_terms = array(); - foreach ($terms as $term) { - // Extract terms belonging to the vocabulary in question. - if ($term->vid == $vocabulary->vid) { - - // Commas and quotes in terms are special cases, so encode 'em. - if (preg_match('/,/', $term->name) || preg_match('/"/', $term->name)) { - $term->name = '"'.preg_replace('/"/', '""', $term->name).'"'; - } - - $typed_terms[] = $term->name; - } - } - $typed_string = implode(', ', $typed_terms) . (array_key_exists('tags', $terms) ? $terms['tags'][$vocabulary->vid] : NULL); - - if ($vocabulary->help) { - $help = $vocabulary->help; - } - else { - $help = t('A comma-separated list of terms describing this content. Example: funny, bungie jumping, "Company, Inc.".'); - } - $form['taxonomy']['tags'][$vocabulary->vid] = array('#type' => 'textfield', - '#title' => $vocabulary->name, - '#description' => $help, - '#required' => $vocabulary->required, - '#default_value' => $typed_string, - '#autocomplete_path' => 'taxonomy/autocomplete/'. $vocabulary->vid, - '#weight' => $vocabulary->weight, - '#maxlength' => 100, - ); - } - else { - // Extract terms belonging to the vocabulary in question. - $default_terms = array(); - foreach ($terms as $term) { - if ($term->vid == $vocabulary->vid) { - $default_terms[$term->tid] = $term; - } - } - $form['taxonomy'][$vocabulary->vid] = taxonomy_form($vocabulary->vid, array_keys($default_terms), $vocabulary->help); - $form['taxonomy'][$vocabulary->vid]['#weight'] = $vocabulary->weight; - $form['taxonomy'][$vocabulary->vid]['#required'] = $vocabulary->required; - } - } - if (isset($form['taxonomy'])) { - $form['taxonomy'] += array('#type' => 'fieldset', '#title' => t('Categories'), '#collapsible' => TRUE, '#collapsed' => FALSE, '#tree' => TRUE, '#weight' => -3); - } - } -} - -/** - * Find all terms associated to the given node, within one vocabulary. - */ -function taxonomy_node_get_terms_by_vocabulary($nid, $vid, $key = 'tid') { - $result = db_query(db_rewrite_sql('SELECT t.tid, t.* FROM {term_data} t INNER JOIN {term_node} r ON r.tid = t.tid WHERE t.vid = %d AND r.nid = %d ORDER BY weight', 't', 'tid'), $vid, $nid); - $terms = array(); - while ($term = db_fetch_object($result)) { - $terms[$term->$key] = $term; - } - return $terms; -} - -/** - * Find all terms associated to the given node, ordered by vocabulary and term weight. - */ -function taxonomy_node_get_terms($nid, $key = 'tid') { - static $terms; - - if (!isset($terms[$nid])) { - $result = db_query(db_rewrite_sql('SELECT t.* FROM {term_node} r INNER JOIN {term_data} t ON r.tid = t.tid INNER JOIN {vocabulary} v ON t.vid = v.vid WHERE r.nid = %d ORDER BY v.weight, t.weight, t.name', 't', 'tid'), $nid); - $terms[$nid] = array(); - while ($term = db_fetch_object($result)) { - $terms[$nid][$term->$key] = $term; - } - } - return $terms[$nid]; -} - -/** - * Make sure incoming vids are free tagging enabled. - */ -function taxonomy_node_validate(&$node) { - if ($node->taxonomy) { - $terms = $node->taxonomy; - if ($terms['tags']) { - foreach ($terms['tags'] as $vid => $vid_value) { - $vocabulary = taxonomy_get_vocabulary($vid); - if (!$vocabulary->tags) { - form_set_error("taxonomy[tags][$vid", t('The %name vocabulary can not be modified in this way.', array('%name' => theme('placeholder', $vocabulary->name)))); - } - } - } - } -} - -/** - * Save term associations for a given node. - */ -function taxonomy_node_save($nid, $terms) { - taxonomy_node_delete($nid); - - // Free tagging vocabularies do not send their tids in the form, - // so we'll detect them here and process them independently. - if (isset($terms['tags'])) { - $typed_input = $terms['tags']; - unset($terms['tags']); - - foreach ($typed_input as $vid => $vid_value) { - // This regexp allows the following types of user input: - // this, "somecmpany, llc", "and ""this"" w,o.rks", foo bar - $regexp = '%(?:^|,\ *)("(?>[^"]*)(?>""[^"]* )*"|(?: [^",]*))%x'; - preg_match_all($regexp, $vid_value, $matches); - $typed_terms = $matches[1]; - - foreach ($typed_terms as $typed_term) { - // If a user has escaped a term (to demonstrate that it is a group, - // or includes a comma or quote character), we remove the escape - // formatting so to save the term into the DB as the user intends. - $typed_term = str_replace('""', '"', preg_replace('/^"(.*)"$/', '\1', $typed_term)); - $typed_term = trim($typed_term); - if ($typed_term == "") { continue; } - - // See if the term exists in the chosen vocabulary - // and return the tid, otherwise, add a new record. - $possibilities = taxonomy_get_term_by_name($typed_term); - $typed_term_tid = NULL; // tid match if any. - foreach ($possibilities as $possibility) { - if ($possibility->vid == $vid) { - $typed_term_tid = $possibility->tid; - } - } - - if (!$typed_term_tid) { - $edit = array('vid' => $vid, 'name' => $typed_term); - $status = taxonomy_save_term($edit); - $typed_term_tid = $edit['tid']; - } - - db_query('INSERT INTO {term_node} (nid, tid) VALUES (%d, %d)', $nid, $typed_term_tid); - } - } - } - - if (is_array($terms)) { - foreach ($terms as $term) { - if (is_array($term)) { - foreach ($term as $tid) { - if ($tid) { - db_query('INSERT INTO {term_node} (nid, tid) VALUES (%d, %d)', $nid, $tid); - } - } - } - else if ($term) { - db_query('INSERT INTO {term_node} (nid, tid) VALUES (%d, %d)', $nid, $term); - } - } - } -} - -/** - * Remove associations of a node to its terms. - */ -function taxonomy_node_delete($nid) { - db_query('DELETE FROM {term_node} WHERE nid = %d', $nid); -} - -/** - * Find all term objects related to a given term ID. - */ -function taxonomy_get_related($tid, $key = 'tid') { - if ($tid) { - $result = db_query('SELECT t.*, tid1, tid2 FROM {term_relation}, {term_data} t WHERE (t.tid = tid1 OR t.tid = tid2) AND (tid1 = %d OR tid2 = %d) AND t.tid != %d ORDER BY weight, name', $tid, $tid, $tid); - $related = array(); - while ($term = db_fetch_object($result)) { - $related[$term->$key] = $term; - } - return $related; - } - else { - return array(); - } -} - -/** - * Find all parents of a given term ID. - */ -function taxonomy_get_parents($tid, $key = 'tid') { - if ($tid) { - $result = db_query(db_rewrite_sql('SELECT t.tid, t.* FROM {term_data} t INNER JOIN {term_hierarchy} h ON h.parent = t.tid WHERE h.tid = %d ORDER BY weight, name', 't', 'tid'), $tid); - $parents = array(); - while ($parent = db_fetch_object($result)) { - $parents[$parent->$key] = $parent; - } - return $parents; - } - else { - return array(); - } -} - -/** - * Find all ancestors of a given term ID. - */ -function taxonomy_get_parents_all($tid) { - $parents = array(); - if ($tid) { - $parents[] = taxonomy_get_term($tid); - $n = 0; - while ($parent = taxonomy_get_parents($parents[$n]->tid)) { - $parents = array_merge($parents, $parent); - $n++; - } - } - return $parents; -} - -/** - * Find all children of a term ID. - */ -function taxonomy_get_children($tid, $vid = 0, $key = 'tid') { - if ($vid) { - $result = db_query(db_rewrite_sql('SELECT t.* FROM {term_data} t INNER JOIN {term_hierarchy} h ON h.tid = t.tid WHERE t.vid = %d AND h.parent = %d ORDER BY weight, name', 't', 'tid'), $vid, $tid); - } - else { - $result = db_query(db_rewrite_sql('SELECT t.* FROM {term_data} t INNER JOIN {term_hierarchy} h ON h.tid = t.tid WHERE parent = %d ORDER BY weight, name', 't', 'tid'), $tid); - } - $children = array(); - while ($term = db_fetch_object($result)) { - $children[$term->$key] = $term; - } - return $children; -} - -/** - * Create a hierarchical representation of a vocabulary. - * - * @param $vid - * Which vocabulary to generate the tree for. - * - * @param $parent - * The term ID under which to generate the tree. If 0, generate the tree - * for the entire vocabulary. - * - * @param $depth - * Internal use only. - * - * @param $max_depth - * The number of levels of the tree to return. Leave NULL to return all levels. - * - * @return - * An array of all term objects in the tree. Each term object is extended - * to have "depth" and "parents" attributes in addition to its normal ones. - */ -function taxonomy_get_tree($vid, $parent = 0, $depth = -1, $max_depth = NULL) { - static $children, $parents, $terms; - - $depth++; - - // We cache trees, so it's not CPU-intensive to call get_tree() on a term - // and its children, too. - if (!isset($children[$vid])) { - $children[$vid] = array(); - - $result = db_query(db_rewrite_sql('SELECT t.tid, t.*, parent FROM {term_data} t INNER JOIN {term_hierarchy} h ON t.tid = h.tid WHERE t.vid = %d ORDER BY weight, name', 't', 'tid'), $vid); - while ($term = db_fetch_object($result)) { - $children[$vid][$term->parent][] = $term->tid; - $parents[$vid][$term->tid][] = $term->parent; - $terms[$vid][$term->tid] = $term; - } - } - - $max_depth = (is_null($max_depth)) ? count($children[$vid]) : $max_depth; - if ($children[$vid][$parent]) { - foreach ($children[$vid][$parent] as $child) { - if ($max_depth > $depth) { - $terms[$vid][$child]->depth = $depth; - // The "parent" attribute is not useful, as it would show one parent only. - unset($terms[$vid][$child]->parent); - $terms[$vid][$child]->parents = $parents[$vid][$child]; - $tree[] = $terms[$vid][$child]; - - if ($children[$vid][$child]) { - $tree = array_merge($tree, taxonomy_get_tree($vid, $child, $depth, $max_depth)); - } - } - } - } - - return $tree ? $tree : array(); -} - -/** - * Return an array of synonyms of the given term ID. - */ -function taxonomy_get_synonyms($tid) { - if ($tid) { - $result = db_query('SELECT name FROM {term_synonym} WHERE tid = %d', $tid); - while ($synonym = db_fetch_array($result)) { - $synonyms[] = $synonym['name']; - } - return $synonyms ? $synonyms : array(); - } - else { - return array(); - } -} - -/** - * Return the term object that has the given string as a synonym. - */ -function taxonomy_get_synonym_root($synonym) { - return db_fetch_object(db_query("SELECT * FROM {term_synonym} s, {term_data} t WHERE t.tid = s.tid AND s.name = '%s'", $synonym)); -} - -/** - * Given a term id, count the number of published nodes in it. - */ -function taxonomy_term_count_nodes($tid, $type = 0) { - static $count; - - if (!isset($count[$type])) { - // $type == 0 always evaluates true is $type is a string - if (is_numeric($type)) { - $result = db_query(db_rewrite_sql('SELECT t.tid, COUNT(n.nid) AS c FROM {term_node} t INNER JOIN {node} n ON t.nid = n.nid WHERE n.status = 1 GROUP BY t.tid')); - } - else { - $result = db_query(db_rewrite_sql("SELECT t.tid, COUNT(n.nid) AS c FROM {term_node} t INNER JOIN {node} n ON t.nid = n.nid WHERE n.status = 1 AND n.type = '%s' GROUP BY t.tid"), $type); - } - while ($term = db_fetch_object($result)) { - $count[$type][$term->tid] = $term->c; - } - } - - foreach (_taxonomy_term_children($tid) as $c) { - $children_count += taxonomy_term_count_nodes($c, $type); - } - return $count[$type][$tid] + $children_count; -} - -/** - * Helper for taxonomy_term_count_nodes(). - */ -function _taxonomy_term_children($tid) { - static $children; - - if (!isset($children)) { - $result = db_query('SELECT tid, parent FROM {term_hierarchy}'); - while ($term = db_fetch_object($result)) { - $children[$term->parent][] = $term->tid; - } - } - return $children[$tid] ? $children[$tid] : array(); -} - -/** - * Try to map a string to an existing term, as for glossary use. - * - * Provides a case-insensitive and trimmed mapping, to maximize the - * likelihood of a successful match. - * - * @param name - * Name of the term to search for. - * - * @return - * An array of matching term objects. - */ -function taxonomy_get_term_by_name($name) { - $db_result = db_query(db_rewrite_sql("SELECT t.tid, t.* FROM {term_data} t WHERE LOWER('%s') LIKE LOWER(name)", 't', 'tid'), trim($name)); - $result = array(); - while ($term = db_fetch_object($db_result)) { - $result[] = $term; - } - - return $result; -} - -/** - * Return the vocabulary object matching a vocabulary ID. - */ -function taxonomy_get_vocabulary($vid) { - static $vocabularies = array(); - - if (!array_key_exists($vid, $vocabularies)) { - $result = db_query('SELECT v.*, n.type FROM {vocabulary} v LEFT JOIN {vocabulary_node_types} n ON v.vid = n.vid WHERE v.vid = %d ORDER BY v.weight, v.name', $vid); - $node_types = array(); - while ($voc = db_fetch_object($result)) { - $node_types[] = $voc->type; - unset($voc->type); - $voc->nodes = $node_types; - $vocabularies[$vid] = $voc; - } - } - - return $vocabularies[$vid]; -} - -/** - * Return the term object matching a term ID. - */ -function taxonomy_get_term($tid) { - // simple cache using a static var? - return db_fetch_object(db_query('SELECT * FROM {term_data} WHERE tid = %d', $tid)); -} - -function _taxonomy_term_select($title, $name, $value, $vocabulary_id, $description, $multiple, $blank, $exclude = array()) { - $tree = taxonomy_get_tree($vocabulary_id); - $options = array(); - - if ($blank) { - $options[0] = $blank; - } - if ($tree) { - foreach ($tree as $term) { - if (!in_array($term->tid, $exclude)) { - $options[$term->tid] = _taxonomy_depth($term->depth, '-') . $term->name; - } - } - if (!$blank && !$value) { - // required but without a predefined value, so set first as predefined - $value = $tree[0]->tid; - } - } - - return array('#type' => 'select', - '#title' => $title, - '#default_value' => $value, - '#options' => $options, - '#description' => $description, - '#multiple' => $multiple, - '#size' => $multiple ? min(9, count($options)) : 0, - '#weight' => -15, - '#theme' => 'taxonomy_term_select', - ); -} - -function theme_taxonomy_term_select($element) { - return theme('select', $element); -} - -function _taxonomy_depth($depth, $graphic = '--') { - for ($n = 0; $n < $depth; $n++) { - $result .= $graphic; - } - return $result; -} - -/** - * Finds all nodes that match selected taxonomy conditions. - * - * @param $tids - * An array of term IDs to match. - * @param $operator - * How to interpret multiple IDs in the array. Can be "or" or "and". - * @param $depth - * How many levels deep to traverse the taxonomy tree. Can be a nonnegative - * integer or "all". - * @param $pager - * Whether the nodes are to be used with a pager (the case on most Drupal - * pages) or not (in an XML feed, for example). - * @param $order - * The order clause for the query that retrieve the nodes. - * @return - * A resource identifier pointing to the query results. - */ -function taxonomy_select_nodes($tids = array(), $operator = 'or', $depth = 0, $pager = TRUE, $order = 'n.sticky DESC, n.created DESC') { - if (count($tids) > 0) { - // For each term ID, generate an array of descendant term IDs to the right depth. - $descendant_tids = array(); - if ($depth === 'all') { - $depth = NULL; - } - foreach ($tids as $index => $tid) { - $term = taxonomy_get_term($tid); - $tree = taxonomy_get_tree($term->vid, $tid, -1, $depth); - $descendant_tids[] = array_merge(array($tid), array_map('_taxonomy_get_tid_from_term', $tree)); - } - - if ($operator == 'or') { - $str_tids = implode(',', call_user_func_array('array_merge', $descendant_tids)); - $sql = 'SELECT DISTINCT(n.nid), n.sticky, n.title, n.created FROM {node} n INNER JOIN {term_node} tn ON n.nid = tn.nid WHERE tn.tid IN ('. $str_tids .') AND n.status = 1 ORDER BY '. $order; - $sql_count = 'SELECT COUNT(DISTINCT(n.nid)) FROM {node} n INNER JOIN {term_node} tn ON n.nid = tn.nid WHERE tn.tid IN ('. $str_tids .') AND n.status = 1'; - } - else { - $joins = ''; - $wheres = ''; - foreach ($descendant_tids as $index => $tids) { - $joins .= ' INNER JOIN {term_node} tn'. $index .' ON n.nid = tn'. $index .'.nid'; - $wheres .= ' AND tn'. $index .'.tid IN ('. implode(',', $tids) .')'; - } - $sql = 'SELECT DISTINCT(n.nid), n.sticky, n.title, n.created FROM {node} n '. $joins .' WHERE n.status = 1 '. $wheres .' ORDER BY '. $order; - $sql_count = 'SELECT COUNT(DISTINCT(n.nid)) FROM {node} n '. $joins .' WHERE n.status = 1 ' . $wheres; - } - $sql = db_rewrite_sql($sql); - $sql_count = db_rewrite_sql($sql_count); - if ($pager) { - $result = pager_query($sql, variable_get('default_nodes_main', 10), 0, $sql_count); - } - else { - $result = db_query_range($sql, 0, variable_get('feed_default_items', 10)); - } - } - - return $result; -} - -/** - * Accepts the result of a pager_query() call, such as that performed by - * taxonomy_select_nodes(), and formats each node along with a pager. -*/ -function taxonomy_render_nodes($result) { - if (db_num_rows($result) > 0) { - while ($node = db_fetch_object($result)) { - $output .= node_view(node_load($node->nid), 1); - } - $output .= theme('pager', NULL, variable_get('default_nodes_main', 10), 0); - } - else { - $output .= t('There are currently no posts in this category.'); - } - return $output; -} - -/** - * Implementation of hook_nodeapi(). - */ -function taxonomy_nodeapi($node, $op, $arg = 0) { - switch ($op) { - case 'load': - $output['taxonomy'] = taxonomy_node_get_terms($node->nid); - return $output; - case 'insert': - taxonomy_node_save($node->nid, $node->taxonomy); - break; - case 'update': - taxonomy_node_save($node->nid, $node->taxonomy); - break; - case 'delete': - taxonomy_node_delete($node->nid); - break; - case 'validate': - taxonomy_node_validate($node); - break; - case 'rss item': - return taxonomy_rss_item($node); - break; - } -} - -/** - * Menu callback; displays all nodes associated with a term. - */ -function taxonomy_term_page($str_tids = '', $depth = 0, $op = 'page') { - if (preg_match('/^([0-9]+[+ ])+[0-9]+$/', $str_tids)) { - $operator = 'or'; - // The '+' character in a query string may be parsed as ' '. - $tids = preg_split('/[+ ]/', $str_tids); - } - else if (preg_match('/^([0-9]+,)*[0-9]+$/', $str_tids)) { - $operator = 'and'; - $tids = explode(',', $str_tids); - } - else { - drupal_not_found(); - } - - if ($tids) { - $result = db_query(db_rewrite_sql('SELECT t.tid, t.name FROM {term_data} t WHERE t.tid IN (%s)', 't', 'tid'), implode(',', $tids)); - $tids = array(); // we rebuild the $tids-array so it only contains terms the user has access to. - $names = array(); - while ($term = db_fetch_object($result)) { - $tids[] = $term->tid; - $names[] = $term->name; - } - - if ($names) { - drupal_set_title($title = implode(', ', $names)); - - switch ($op) { - case 'page': - // Build breadcrumb based on first hierarchy of first term: - $current->tid = $tids[0]; - $breadcrumbs = array(array('path' => $_GET['q'])); - while ($parents = taxonomy_get_parents($current->tid)) { - $current = array_shift($parents); - $breadcrumbs[] = array('path' => 'taxonomy/term/'. $current->tid, 'title' => $current->name); - } - $breadcrumbs = array_reverse($breadcrumbs); - menu_set_location($breadcrumbs); - - drupal_add_link(array('rel' => 'alternate', - 'type' => 'application/rss+xml', - 'title' => 'RSS - '. $title, - 'href' => url('taxonomy/term/'. $str_tids .'/'. $depth .'/feed'))); - - $output = taxonomy_render_nodes(taxonomy_select_nodes($tids, $operator, $depth, TRUE)); - $output .= theme('feed_icon', url('taxonomy/term/'. $str_tids .'/'. $depth .'/feed')); - return $output; - break; - - case 'feed': - $term = taxonomy_get_term($tids[0]); - $channel['link'] = url('taxonomy/term/'. $str_tids .'/'. $depth, NULL, NULL, TRUE); - $channel['title'] = variable_get('site_name', 'drupal') .' - '. $title; - $channel['description'] = $term->description; - - $result = taxonomy_select_nodes($tids, $operator, $depth, FALSE); - node_feed($result, $channel); - break; - default: - drupal_not_found(); - } - } - else { - drupal_not_found(); - } - } -} - -/** - * Page to add or edit a vocabulary - */ -function taxonomy_admin_vocabulary_edit($vid = NULL) { - if ($_POST['op'] == t('Delete') || $_POST['edit']['confirm']) { - return _taxonomy_confirm_del_vocabulary($vid); - } - elseif ($vid) { - $vocabulary = (array)taxonomy_get_vocabulary($vid); - } - return taxonomy_form_vocabulary($vocabulary); -} - -/** - * Page to list terms for a vocabulary - */ -function taxonomy_admin_term_edit($tid = NULL) { - if ($_POST['op'] == t('Delete') || $_POST['edit']['confirm']) { - return _taxonomy_confirm_del_term($tid); - } - elseif ($tid) { - $term = (array)taxonomy_get_term($tid); - } - return taxonomy_form_term($term); -} - -/** - * Page to add a term to a specific vocabulary. - */ -function taxonomy_admin_term_add($vid = NULL) { - return taxonomy_form_term(array('vid' => arg(2))); -} - -/** - * Provides category information for rss feeds - */ -function taxonomy_rss_item($node) { - $output = array(); - foreach ($node->taxonomy as $term) { - $output[] = array('key' => 'category', - 'value' => check_plain($term->name), - 'attributes' => array('domain' => url('taxonomy/term/'. $term->tid, NULL, NULL, TRUE))); - } - return $output; -} - -/** - * Implementation of hook_help(). - */ -function taxonomy_help($section) { - switch ($section) { - case 'admin/help#taxonomy': - $output = ''. t('The taxonomy module is one of the most popular features because users often want to create categories to organize content by type. It can automatically classify new content, which is very useful for organizing content on-the-fly. A simple example would be organizing a list of music reviews by musical genre.') .'
'; - $output .= ''. t('Taxonomy is also the study of classification. The taxonomy module allows you to define vocabularies (sets of categories) which are used to classify content. The module supports hierarchical classification and association between terms, allowing for truly flexible information retrieval and classification. The taxonomy module allows multiple lists of categories for classification (controlled vocabularies) and offers the possibility of creating thesauri (controlled vocabularies that indicate the relationship of terms) and taxonomies (controlled vocabularies where relationships are indicated hierarchically). To view and manage the terms of each vocabulary, click on the associated list terms link. To delete a vocabulary and all its terms, choose edit vocabulary.') .'
'; - $output .= ''. t('A controlled vocabulary is a set of terms to use for describing content (known as descriptors in indexing lingo). Drupal allows you to describe each piece of content (blog, story, etc.) using one or many of these terms. For simple implementations, you might create a set of categories without subcategories, similar to Slashdot\'s sections. For more complex implementations, you might create a hierarchical list of categories.') .'
'; - $output .= t('You can
--
-
- add a vocabulary at administer >> categories >> add vocabulary. -
- administer taxonomy at administer >> categories. -
- restrict content access by category for specific users roles using the taxonomy access module. -
- build a custom view of your categories using the taxonomy browser. -
'. t('For more information please read the configuration and customization handbook Taxonomy page.', array('%taxonomy' => 'http://drupal.org/handbook/modules/taxonomy/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables the categorization of content.'); - case 'admin/taxonomy': - return t('The taxonomy module allows you to classify content into categories and subcategories; it allows multiple lists of categories for classification (controlled vocabularies) and offers the possibility of creating thesauri (controlled vocabularies that indicate the relationship of terms), taxonomies (controlled vocabularies where relationships are indicated hierarchically), and free vocabularies where terms, or tags, are defined during content creation. To view and manage the terms of each vocabulary, click on the associated list terms link. To delete a vocabulary and all its terms, choose "edit vocabulary".
'); - case 'admin/taxonomy/add/vocabulary': - return t("When you create a controlled vocabulary you are creating a set of terms to use for describing content (known as descriptors in indexing lingo). Drupal allows you to describe each piece of content (blog, story, etc.) using one or many of these terms. For simple implementations, you might create a set of categories without subcategories, similar to Slashdot.org's or Kuro5hin.org's sections. For more complex implementations, you might create a hierarchical list of categories.
"); - } -} - -/** - * Helper function for array_map purposes. - */ -function _taxonomy_get_tid_from_term($term) { - return $term->tid; -} - -/** - * Helper function for autocompletion - */ -function taxonomy_autocomplete($vid, $string = '') { - // The user enters a comma-separated list of tags. We only autocomplete the last tag. - // This regexp allows the following types of user input: - // this, "somecmpany, llc", "and ""this"" w,o.rks", foo bar - $regexp = '%(?:^|,\ *)("(?>[^"]*)(?>""[^"]* )*"|(?: [^",]*))%x'; - preg_match_all($regexp, $string, $matches); - $array = $matches[1]; - - // Fetch last tag - $last_string = trim(array_pop($array)); - if ($last_string != '') { - $result = db_query_range("SELECT name FROM {term_data} WHERE vid = %d AND LOWER(name) LIKE LOWER('%%%s%%')", $vid, $last_string, 0, 10); - - $prefix = count($array) ? implode(', ', $array) .', ' : ''; - - $matches = array(); - while ($tag = db_fetch_object($result)) { - $n = $tag->name; - // Commas and quotes in terms are special cases, so encode 'em. - if (preg_match('/,/', $tag->name) || preg_match('/"/', $tag->name)) { - $n = '"'. preg_replace('/"/', '""', $tag->name) .'"'; - } - $matches[$prefix . $n] = check_plain($tag->name); - } - print drupal_implode_autocomplete($matches); - exit(); - } -} diff --git a/modules/throttle/throttle.module b/modules/throttle/throttle.module deleted file mode 100644 index 18226523d9b2178f16d624d3a1a8ab9ae4742aa8..0000000000000000000000000000000000000000 --- a/modules/throttle/throttle.module +++ /dev/null @@ -1,158 +0,0 @@ -= %d AND uid = 0', time() - $time_period)); - } - else { - $guests = 0; - } - if ($max_users = variable_get('throttle_user', 0)) { - $users = db_result(db_query('SELECT COUNT(DISTINCT(uid)) AS count FROM {sessions} WHERE timestamp >= %d AND uid != 0', time() - $time_period)); - } - else { - $users = 0; - } - - // update the throttle status - $message = ''; - if ($max_users && $users > $max_users) { - if (!$throttle) { - variable_set('throttle_level', 1); - $message = format_plural($users, - '1 user accessing site; throttle enabled.', - '%count users accessing site; throttle enabled.'); - } - } - elseif ($max_guests && $guests > $max_guests) { - if (!$throttle) { - variable_set('throttle_level', 1); - $message = format_plural($guests, - '1 guest accessing site; throttle enabled.', - '%count guests accessing site; throttle enabled.'); - } - } - else { - if ($throttle) { - variable_set('throttle_level', 0); - // Note: unorthodox format_plural() usage due to Gettext plural limitations. - $message = format_plural($users, '1 user', '%count users') .', '; - $message .= format_plural($guests, '1 guest accessing site; throttle disabled', '%count guests accessing site; throttle disabled'); - } - } - if ($message) { - cache_clear_all(); - watchdog('throttle', t('Throttle') .': '. $message); - } - } -} - -function _throttle_validate($value, $form) { - if ($value != NULL) { - if (!is_numeric($value) || $value < 0) { - form_set_error($form, t("'%value' is not a valid auto-throttle setting. Please enter a positive numeric value.", array('%value' => theme('placeholder', $value)))); - } - } -} - -/** - * Implementation of hook_help(). - */ -function throttle_help($section) { - switch ($section) { - case 'admin/help#throttle': - $output = ''. t('The throttle module provides a congestion control throttling mechanism for automatically detecting a surge in incoming traffic. If the site gets linked to by a popular website, or otherwise comes under a "Denial of Service" (DoS) attack, your webserver might become overwhelmed. This mechanism is utilized by other modules to automatically optimize their performance by temporarily disabling CPU-intensive functionality. For example, in the site theme, you might choose to disable pictures when the site is too busy (reducing bandwidth), or in modules, you might choose to disable some complicated logic (reducing CPU utilization).') .'
'; - $output .= ''. t('The congestion control throttle can be automatically enabled when the number of anonymous or authenticated users currently visiting the site exceeds the specified threshold. ') .'
'; - $output .= t('You can
--
-
- enable throttle for modules at administer >> module. -
- enable throttle for blocks at administer >> block. -
- administer throttle at administer >> settings >> throttle. -
'. t('For more information please read the configuration and customization handbook Throttle page.', array('%throttle' => 'http://drupal.org/handbook/modules/throttle/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Handles the auto-throttling mechanism, to control site congestion.'); - case 'admin/settings/throttle': - return t('If your site gets linked to by a popular website, or otherwise comes under a "Denial of Service" (DoS) attack, your webserver might become overwhelmed. This module provides a congestion control throttling mechanism for automatically detecting a surge in incoming traffic. This mechanism is utilized by other Drupal modules to automatically optimize their performance by temporarily disabling CPU-intensive functionality.'); - } -} - -/** - * Implementation of hook_settings(). - */ -function throttle_settings() { - _throttle_validate(variable_get('throttle_anonymous', ''), 'throttle_anonymous'); - _throttle_validate(variable_get('throttle_user', ''), 'throttle_user'); - $probabilities = array(0 => '100%', 1 => '50%', 2 => '33.3%', 3 => '25%', 4 => '20%', 5 => '16.6%', 7 => '12.5%', 9 => '10%', 19 => '5%', 99 => '1%', 199 => '.5%', 399 => '.25%', 989 => '.1%'); - - $form['throttle_anonymous'] = array( - '#type' => 'textfield', - '#title' => t('Auto-throttle on anonymous users'), - '#default_value' => variable_get('throttle_anonymous', 0), - '#size' => 5, - '#maxlength' => 6, - '#description' => t('The congestion control throttle can be automatically enabled when the number of anonymous users currently visiting your site exceeds the specified threshold. For example, to start the throttle when your site has 250 anonymous users online at once, enter \'250\' in this field. Leave this value blank or set to "0" if you do not wish to auto-throttle on anonymous users. You can inspect the current number of anonymous users using the "Who\'s online" block.') - ); - $form['throttle_user'] = array( - '#type' => 'textfield', - '#title' => t('Auto-throttle on authenticated users'), - '#default_value' => variable_get('throttle_user', 0), - '#size' => 5, - '#maxlength' => 6, - '#description' => t('The congestion control throttle can be automatically enabled when the number of authenticated users currently visiting your site exceeds the specified threshold. For example, to start the throttle when your site has 50 registered users online at once, enter \'50\' in this field. Leave this value blank or set to "0" if you do not wish to auto-throttle on authenticated users. You can inspect the current number of authenticated users using the "Who\'s online" block.') - ); - $form['throttle_probability_limiter'] = array( - '#type' => 'select', - '#title' => t('Auto-throttle probability limiter'), - '#default_value' => variable_get('throttle_probability_limiter', 9), - '#options' => $probabilities, - '#description' => t('The auto-throttle probability limiter is an efficiency mechanism to statistically reduce the overhead of the auto-throttle. The limiter is expressed as a percentage of page views, so for example if set to the default of 10% we only perform the extra database queries to update the throttle status 1 out of every 10 page views. The busier your site, the lower you should set the limiter value.') - ); - - return $form; -} diff --git a/modules/tracker/tracker.module b/modules/tracker/tracker.module deleted file mode 100644 index f82611ceb1ba9f1e645d2bcb2830203082d43c5e..0000000000000000000000000000000000000000 --- a/modules/tracker/tracker.module +++ /dev/null @@ -1,129 +0,0 @@ -'. t('The tracker module displays the most recently added or updated content to the website allowing users to see the most recent contributions. The tracker module provides user level tracking for those who like to follow the contributions of particular authors.') .''; - $output .= ''. t('The "recent posts" page is available via a link in the navigation menu block and contains a reverse chronological list of new and recently-updated content. The table displays the content type, the title, the author\'s name, how many comments that item has received, and when it was last updated. Updates include any changes to the text, either by the original author or someone else, as well as any new comments added to an item. To use the tracker module to watch for a user\'s updated content, click on that user\'s profile, then the track tab.') .'
'; - $output .= t('You can
--
-
- view the most recent posts. -
- view user profiles and select the track tab. -
- not administer this module. -
'. t('For more information please read the configuration and customization handbook Tracker page.', array('%tracker' => 'http://drupal.org/handbook/modules/tracker/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables tracking of recent posts for users.'); - } -} - -/** - * Implementation of hook_menu(). - */ -function tracker_menu($may_cache) { - global $user; - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'tracker', 'title' => t('recent posts'), - 'callback' => 'tracker_page', 'access' => user_access('access content'), - 'weight' => 1); - - if ($user->uid) { - $items[] = array('path' => 'tracker/all', 'title' => t('all recent posts'), - 'type' => MENU_DEFAULT_LOCAL_TASK); - $items[] = array('path' => 'tracker/'. $user->uid, 'title' => t('my recent posts'), - 'type' => MENU_LOCAL_TASK); - } - } - else { - if (arg(0) == 'user' && is_numeric(arg(1))) { - $items[] = array('path' => 'user/'. arg(1) .'/track', 'title' => t('track'), - 'callback' => 'tracker_track_user', 'access' => user_access('access content'), - 'type' => MENU_IS_LOCAL_TASK); - $items[] = array('path' => 'user/'. arg(1) .'/track/posts', 'title' => t('track posts'), - 'type' => MENU_DEFAULT_LOCAL_TASK); - } - } - - return $items; -} - -/** - * Menu callback. Prints a listing of active nodes on the site. - */ -function tracker_track_user() { - if ($account = user_load(array('uid' => arg(1)))) { - if ($account->status || user_access('administer users')) { - drupal_set_title($account->name); - return tracker_page($account->uid); - } - else { - drupal_access_denied(); - } - } - else { - drupal_not_found(); - } -} - -/** - * Menu callback. Prints a listing of active nodes on the site. - */ -function tracker_page($uid = 0) { - if ($uid) { - $sql = 'SELECT DISTINCT(n.nid), n.title, n.type, n.changed, n.uid, u.name, l.last_comment_timestamp AS last_post, l.comment_count FROM {node} n INNER JOIN {node_comment_statistics} l ON n.nid = l.nid INNER JOIN {users} u ON n.uid = u.uid LEFT JOIN {comments} c ON n.nid = c.nid AND (c.status = %d OR c.status IS NULL) WHERE n.status = 1 AND (n.uid = %d OR c.uid = %d) ORDER BY last_post DESC'; - $sql = db_rewrite_sql($sql); - $sql_count = 'SELECT COUNT(DISTINCT(n.nid)) FROM {node} n LEFT JOIN {comments} c ON n.nid = c.nid AND (c.status = %d OR c.status IS NULL) WHERE n.status = 1 AND (n.uid = %d OR c.uid = %d)'; - $sql_count = db_rewrite_sql($sql_count); - $result = pager_query($sql, 25, 0, $sql_count, COMMENT_PUBLISHED, $uid, $uid); - } - else { - $sql = 'SELECT DISTINCT(n.nid), n.title, n.type, n.changed, n.uid, u.name, l.last_comment_timestamp AS last_post, l.comment_count FROM {node} n INNER JOIN {users} u ON n.uid = u.uid INNER JOIN {node_comment_statistics} l ON n.nid = l.nid WHERE n.status = 1 ORDER BY last_post DESC'; - $sql = db_rewrite_sql($sql); - $sql_count = 'SELECT COUNT(n.nid) FROM {node} n WHERE n.status = 1'; - $sql_count = db_rewrite_sql($sql_count); - $result = pager_query($sql, 25, 0, $sql_count); - } - - while ($node = db_fetch_object($result)) { - // Determine the number of comments: - $comments = 0; - if (module_exist('comment') && $node->comment_count) { - $comments = $node->comment_count; - - if ($new = comment_num_new($node->nid)) { - $comments .= '
'; - $comments .= l(format_plural($new, '1 new', '%count new'), "node/$node->nid", NULL, NULL, 'new'); - } - } - - $rows[] = array( - node_get_name($node->type), - l($node->title, "node/$node->nid") .' '. theme('mark', node_mark($node->nid, $node->changed)), - theme('username', $node), - array('class' => 'replies', 'data' => $comments), - t('%time ago', array('%time' => format_interval(time() - $node->last_post))) - ); - } - - $header = array(t('Type'), t('Post'), t('Author'), t('Replies'), t('Last post')); - - $output = ''; - $output .= theme('table', $header, $rows); - $output .= theme('pager', NULL, 25, 0); - $output .= ''; - - return $output; -} diff --git a/modules/upload/upload.module b/modules/upload/upload.module deleted file mode 100644 index 46d582400d48cb97d2981ad617193e1f064140ed..0000000000000000000000000000000000000000 --- a/modules/upload/upload.module +++ /dev/null @@ -1,649 +0,0 @@ -'. t('The upload module allows users to upload files to the site. The ability to upload files to a site is important for members of a community who want to share work. It is also useful to administrators who want to keep uploaded files connected to a node or page.') .''; - $output .= ''. t('Users with the upload files permission can upload attachments. You can choose which post types can take attachments on the content types settings page. Each user role can be customized for the file size of uploads, and the dimension of image files.') .'
'; - $output .= t('You can
--
-
- administer user permissions at administer >> user >> configure >> permissions. -
- administer content at administer >> content types. -
- administer upload at administer >> settings. -
'. t('For more information please read the configuration and customization handbook Upload page.', array('%upload' => 'http://drupal.org/handbook/modules/upload/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to upload and attach files to content.'); - case 'admin/settings/upload': - return t('Users with the upload files permission can upload attachments. You can choose which post types can take attachments on the content types settings page.
', array('%permissions' => url('admin/access'), '%types' => url('admin/settings/content-types'))); - } -} - -/** - * Implementation of hook_perm(). - */ -function upload_perm() { - return array('upload files', 'view uploaded files'); -} - -/** - * Implementation of hook_link(). - */ -function upload_link($type, $node = 0, $main = 0) { - $links = array(); - - // Display a link with the number of attachments - if ($main && $type == 'node' && is_array($node->files) && user_access('view uploaded files')) { - $num_files = 0; - foreach ($node->files as $file) { - if ($file->list) { - $num_files++; - } - } - if ($num_files) { - $links[] = l(format_plural($num_files, '1 attachment', '%count attachments'), "node/$node->nid", array('title' => t('Read full article to view attachments.')), NULL, 'attachments'); - } - } - - return $links; -} - -/** - * Implementation of hook_menu(). - */ -function upload_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array( - 'path' => 'upload/js', - 'callback' => 'upload_js', - 'access' => user_access('upload files'), - 'type' => MENU_CALLBACK - ); - } - else { - // Add handlers for previewing new uploads. - if ($_SESSION['file_previews']) { - foreach ($_SESSION['file_previews'] as $fid => $file) { - $filename = file_create_filename($file->filename, file_create_path()); - if (variable_get('file_downloads', FILE_DOWNLOADS_PUBLIC) == FILE_DOWNLOADS_PRIVATE) { - // strip file_directory_path() from filename. @see file_create_url - if (strpos($filename, file_directory_path()) !== false) { - $filename = trim(substr($filename, strlen(file_directory_path())), '\\/'); - } - $filename = 'system/files/' . $filename; - } - - $items[] = array( - 'path' => $filename, 'title' => t('file download'), - 'callback' => 'upload_download', - 'access' => user_access('view uploaded files'), - 'type' => MENU_CALLBACK - ); - $_SESSION['file_previews'][$fid]->_filename = $filename; - } - } - } - - return $items; -} - -function upload_settings() { - $form['settings_general'] = array('#type' => 'fieldset', '#title' => t('General settings')); - $form['settings_general']['upload_max_resolution'] = array( - '#type' => 'textfield', '#title' => t('Maximum resolution for uploaded images'), '#default_value' => variable_get('upload_max_resolution', 0), - '#size' => 15, '#maxlength' => 10, '#description' => t('The maximum allowed image size expressed as WIDTHxHEIGHT (e.g. 640x480). Set to 0 for no restriction.') - ); - - $form['settings_general']['upload_list_default'] = array('#type' => 'select', '#title' => t('List files by default'), - '#default_value' => variable_get('upload_list_default',1), - '#options' => array( 0 => t('No'), 1 => t('Yes') ), - '#description' => t('Set whether files attached to nodes are listed or not in the node view by default.'), - ); - - $roles = user_roles(0, 'upload files'); - - foreach ($roles as $rid => $role) { - $form["settings_role_$rid"] = array('#type' => 'fieldset', '#title' => t('Settings for %role', array('%role' => theme('placeholder', $role))), '#collapsible' => TRUE, '#collapsed' => TRUE); - $form["settings_role_$rid"]["upload_extensions_$rid"] = array( - '#type' => 'textfield', '#title' => t('Permitted file extensions'), '#default_value' => variable_get("upload_extensions_$rid", "jpg jpeg gif png txt html doc xls pdf ppt pps"), - '#maxlength' => 255, '#description' => t('Extensions that users in this role can upload. Separate extensions with a space and do not include the leading dot.') - ); - $form["settings_role_$rid"]["upload_uploadsize_$rid"] = array( - '#type' => 'textfield', '#title' => t('Maximum file size per upload'), '#default_value' => variable_get("upload_uploadsize_$rid", 1), - '#size' => 5, '#maxlength' => 5, '#description' => t('The maximum size of a file a user can upload (in megabytes).') - ); - $form["settings_role_$rid"]["upload_usersize_$rid"] = array( - '#type' => 'textfield', '#title' => t('Total file size per user'), '#default_value' => variable_get("upload_usersize_$rid", 10), - '#size' => 5, '#maxlength' => 5, '#description' => t('The maximum size of all files a user can have on the site (in megabytes).') - ); - } - - return $form; -} - -function upload_download() { - foreach ($_SESSION['file_previews'] as $file) { - if ($file->_filename == $_GET['q']) { - file_transfer($file->filepath, array('Content-Type: '. mime_header_encode($file->filemime), 'Content-Length: '. $file->filesize)); - } - } -} - -function upload_file_download($file) { - if (user_access('view uploaded files')) { - $file = file_create_path($file); - $result = db_query("SELECT f.* FROM {files} f WHERE filepath = '%s'", $file); - if ($file = db_fetch_object($result)) { - $node = node_load($file->nid); - if (node_access('view', $node)) { - $name = mime_header_encode($file->filename); - $type = mime_header_encode($file->filemime); - // Serve images and text inline for the browser to display rather than download. - $disposition = ereg('^(text/|image/)', $file->filemime) ? 'inline' : 'attachment'; - return array('Content-Type: '. $type .'; name='. $name, - 'Content-Length: '. $file->filesize, - 'Content-Disposition: '. $disposition .'; filename='. $name); - } - else { - return -1; - } - } - } - else { - return -1; - } -} - -/** - * Save new uploads and attach them to the node object. - * append file_previews to the node object as well. - */ -function _upload_prepare(&$node) { - - // Clean up old file previews if a post didn't get the user to this page. - // i.e. the user left the edit page, because they didn't want to upload anything. - if(count($_POST) == 0) { - if (is_array($_SESSION['file_previews']) && count($_SESSION['file_previews'])) { - foreach($_SESSION['file_previews'] as $fid => $file) { - file_delete($file->filepath); - } - unset($_SESSION['file_previews']); - } - } - - // $_SESSION['file_submitted'] tracks the fid of the file submitted this page request. - // form_builder sets the value of file->list to 0 for checkboxes added to a form after - // it has been submitted. Since unchecked checkboxes have no return value and do not - // get a key in _POST form_builder has no way of knowing the difference between a check - // box that wasn't present on the last form build, and a checkbox that is unchecked. - - unset($_SESSION['file_submitted']); - - // Save new file uploads to tmp dir. - if (($file = file_check_upload()) && user_access('upload files')) { - global $user; - - // Scale image uploads. - $file = _upload_image($file); - - $key = 'upload_'. count($_SESSION['file_previews']); - $file->fid = $key; - $file->source = $key; - $file->list = variable_get('upload_list_default',1); - $_SESSION['file_previews'][$key] = $file; - - // Store the uploaded fid for this page request in case of submit without - // preview or attach. See earlier notes. - $_SESSION['file_submitted'] = $key; - } - - // Attach file previews to node object. - if (is_array($_SESSION['file_previews']) && count($_SESSION['file_previews'])) { - foreach($_SESSION['file_previews'] as $fid => $file) { - $node->files[$fid] = $file; - } - } -} - -function upload_form_alter($form_id, &$form) { - if (isset($form['type'])) { - if ($form['type']['#value'] .'_node_settings' == $form_id) { - $form['workflow']['upload_'. $form['type']['#value']] = array( - '#type' => 'radios', '#title' => t('Attachments'), '#default_value' => variable_get('upload_'. $form['type']['#value'], 1), - '#options' => array(t('Disabled'), t('Enabled')), - ); - } - - $node = $form['#node']; - if ($form['type']['#value'] .'_node_form' == $form_id && variable_get("upload_$node->type", TRUE) && user_access('upload files')) { - drupal_add_js('misc/progress.js'); - drupal_add_js('misc/upload.js'); - - $form['attachments'] = array( - '#type' => 'fieldset', - '#title' => t('File attachments'), - '#collapsible' => TRUE, - '#collapsed' => empty($node->files), - '#description' => t('Changes made to the attachments are not permanent until you save this post. The first "listed" file will be included in RSS feeds.'), - '#prefix' => '', - '#weight' => 30, - ); - $form['attachments'] += _upload_form($node); - $form['#attributes'] = array('enctype' => 'multipart/form-data'); - } - } -} - -function _upload_validate(&$node) { - // Accumulator for disk space quotas. - $filesize = 0; - - // Check if node->files exists, and if it contains something. - if (is_array($node->files)) { - // Update existing files with form data. - foreach($node->files as $fid => $file) { - // Convert file to object for compatability - $file = (object)$file; - - // Validate new uploads. - if (strpos($fid, 'upload') !== false && !$file->remove) { - global $user; - - // Bypass validation for uid = 1. - if ($user->uid != 1) { - //Update filesize accumulator. - $filesize += $file->filesize; - - // Validate file against all users roles. - // Only denies an upload when all roles prevent it. - - $total_usersize = upload_space_used($user->uid) + $filesize; - $error = array(); - foreach ($user->roles as $rid => $name) { - $extensions = variable_get("upload_extensions_$rid", 'jpg jpeg gif png txt html doc xls pdf ppt pps'); - $uploadsize = variable_get("upload_uploadsize_$rid", 1) * 1024 * 1024; - $usersize = variable_get("upload_usersize_$rid", 1) * 1024 * 1024; - - $regex = '/\.('. ereg_replace(' +', '|', preg_quote($extensions)) .')$/i'; - - if (!preg_match($regex, $file->filename)) { - $error['extension']++; - } - - if ($uploadsize && $file->filesize > $uploadsize) { - $error['uploadsize']++; - } - - if ($usersize && $total_usersize + $file->filesize > $usersize) { - $error['usersize']++; - } - } - - $user_roles = count($user->roles); - $valid = TRUE; - if ($error['extension'] == $user_roles) { - form_set_error('upload', t('The selected file %name can not be attached to this post, because it is only possible to attach files with the following extensions: %files-allowed.', array('%name' => theme('placeholder', $file->filename), '%files-allowed' => theme('placeholder', $extensions)))); - $valid = FALSE; - } - elseif ($error['uploadsize'] == $user_roles) { - form_set_error('upload', t('The selected file %name can not be attached to this post, because it exceeded the maximum filesize of %maxsize.', array('%name' => theme('placeholder', $file->filename), '%maxsize' => theme('placeholder', format_size($uploadsize))))); - $valid = FALSE; - } - elseif ($error['usersize'] == $user_roles) { - form_set_error('upload', t('The selected file %name can not be attached to this post, because the disk quota of %quota has been reached.', array('%name' => theme('placeholder', $file->filename), '%quota' => theme('placeholder', format_size($usersize))))); - $valid = FALSE; - } - if (!$valid) { - unset($node->files[$fid], $_SESSION['file_previews'][$fid]); - file_delete($file->filepath); - } - } - } - } - } -} - -/** - * Implementation of hook_nodeapi(). - */ -function upload_nodeapi(&$node, $op, $arg) { - switch ($op) { - - case 'load': - if (variable_get("upload_$node->type", 1) == 1) { - $output['files'] = upload_load($node); - } - return $output; - break; - - case 'prepare': - _upload_prepare($node); - break; - - case 'validate': - _upload_validate($node); - break; - - case 'view': - if (is_array($node->files) && user_access('view uploaded files')) { - $header = array(t('Attachment'), t('Size')); - $rows = array(); - $previews = array(); - - // Build list of attached files - foreach ($node->files as $key => $file) { - if ($file->list) { - $rows[] = array( - ''. check_plain($file->description ? $file->description : $file->filename) .'', - format_size($file->filesize) - ); - // We save the list of files still in preview for later - if (strpos($file->fid, 'upload') !== false) { - $previews[] = $file; - } - } - } - - // URLs to files being previewed are actually Drupal paths. When Clean - // URLs are disabled, the two do not match. We perform an automatic - // replacement from temporary to permanent URLs. That way, the author - // can use the final URL in the body before having actually saved (to - // place inline images for example). - if (!variable_get('clean_url', 0)) { - foreach ($previews as $file) { - $old = file_create_filename($file->filename, file_create_path()); - $new = url($old); - $node->body = str_replace($old, $new, $node->body); - $node->teaser = str_replace($old, $new, $node->teaser); - } - } - - $teaser = $arg; - // Add the attachments list - if (count($rows) && !$teaser) { - $node->body .= theme('table', $header, $rows, array('id' => 'attachments')); - } - } - break; - - case 'insert': - case 'update': - if (user_access('upload files')) { - upload_save($node); - } - break; - - case 'delete': - upload_delete($node); - break; - - case 'delete revision': - upload_delete_revision($node); - break; - - case 'search result': - return is_array($node->files) ? format_plural(count($node->files), '1 attachment', '%count attachments') : null; - - case 'rss item': - if (is_array($node->files)) { - $files = array(); - foreach ($node->files as $file) { - if ($file->list) { - $files[] = $file; - } - } - if (count($files) > 0) { - // RSS only allows one enclosure per item - $file = array_shift($files); - return array(array('key' => 'enclosure', - 'attributes' => array('url' => file_create_url($file->filepath), - 'length' => $file->filesize, - 'type' => $file->filemime))); - } - } - return array(); - - } -} - -/** - * Determine how much disk space is occupied by a user's uploaded files. - * - * @param $uid - * The integer user id of a user. - * @return - * The amount of disk space used by the user in bytes. - */ -function upload_space_used($uid) { - return db_result(db_query('SELECT SUM(filesize) FROM {files} f INNER JOIN {node} n ON f.nid = n.nid WHERE n.uid = %d', $uid)); -} - -/** - * Determine how much disk space is occupied by uploaded files. - * - * @return - * The amount of disk space used by uploaded files in bytes. - */ -function upload_total_space_used() { - return db_result(db_query('SELECT SUM(filesize) FROM {files}')); -} - -function upload_save($node) { - if (!is_array($node->files)) { - return; - } - - foreach ($node->files as $fid => $file) { - // Convert file to object for compatability - $file = (object)$file; - - // Remove file. Process removals first since no further processing - // will be required. - if ($file->remove) { - // Remove file previews... - if (strpos($file->fid, 'upload') !== false) { - file_delete($file->filepath); - } - - // Remove managed files. - else { - db_query('DELETE FROM {file_revisions} WHERE fid = %d AND vid = %d', $fid, $node->vid); - // Only delete a file if it isn't used by any revision - $count = db_result(db_query('SELECT COUNT(fid) FROM {file_revisions} WHERE fid = %d', $fid)); - if ($count < 1) { - db_query('DELETE FROM {files} WHERE fid = %d', $fid); - file_delete($file->filepath); - } - } - } - - // New file upload - elseif (strpos($file->fid, 'upload') !== false) { - if ($file = file_save_upload($file, $file->filename)) { - // Track the file which was submitted last, in case of a direct submission - // without preview or attach. See notes in upload_prepare. - if ($_SESSION['file_submitted'] == $file->fid) { - $file->list = variable_get('upload_list_default',1); - } - - $file->fid = db_next_id('{files}_fid'); - db_query("INSERT INTO {files} (fid, nid, filename, filepath, filemime, filesize) VALUES (%d, %d, '%s', '%s', '%s', %d)", $file->fid, $node->nid, $file->filename, $file->filepath, $file->filemime, $file->filesize); - db_query("INSERT INTO {file_revisions} (fid, vid, list, description) VALUES (%d, %d, %d, '%s')", $file->fid, $node->vid, $file->list, $file->description); - } - unset($_SESSION['file_previews'][$fid]); - } - - // Create a new revision, as needed - elseif ($node->old_vid && is_numeric($fid)) { - db_query("INSERT INTO {file_revisions} (fid, vid, list, description) VALUES (%d, %d, %d, '%s')", $file->fid, $node->vid, $file->list, $file->description); - } - - // Update existing revision - else { - db_query("UPDATE {file_revisions} SET list = %d, description = '%s' WHERE fid = %d AND vid = %d", $file->list, $file->description, $file->fid, $node->vid); - } - } -} - -function upload_delete($node) { - $files = array(); - $result = db_query('SELECT * FROM {files} WHERE nid = %d', $node->nid); - while ($file = db_fetch_object($result)) { - $files[$file->fid] = $file; - } - - foreach ($files as $fid => $file) { - // Delete all file revision information associated with the node - db_query('DELETE FROM {file_revisions} WHERE fid = %d', $fid); - file_delete($file->filepath); - } - - // Delete all files associated with the node - db_query('DELETE FROM {files} WHERE nid = %d', $node->nid); -} - -function upload_delete_revision($node) { - if (is_array($node->files)) { - foreach ($node->files as $file) { - // Check if the file will be used after this revision is deleted - $count = db_result(db_query('SELECT COUNT(fid) FROM {file_revisions} WHERE fid = %d', $file->fid)); - - // if the file won't be used, delete it - if ($count < 2) { - db_query('DELETE FROM {files} WHERE fid = %d', $file->fid); - file_delete($file->filepath); - } - } - } - - // delete the revision - db_query('DELETE FROM {file_revisions} WHERE vid = %d', $node->vid); -} - -function _upload_form($node) { - $form['#theme'] = 'upload_form_new'; - if (is_array($node->files) && count($node->files)) { - $form['files']['#theme'] = 'upload_form_current'; - $form['files']['#tree'] = TRUE; - foreach ($node->files as $key => $file) { - $description = "". file_create_url((strpos($file->fid,'upload') === false ? $file->filepath : file_create_filename($file->filename, file_create_path()))) .""; - $form['files'][$key]['description'] = array('#type' => 'textfield', '#default_value' => (strlen($file->description)) ? $file->description : $file->filename, '#maxlength' => 256, '#description' => $description ); - $form['files'][$key]['size'] = array('#type' => 'markup', '#value' => format_size($file->filesize)); - $form['files'][$key]['remove'] = array('#type' => 'checkbox', '#default_value' => $file->remove); - $form['files'][$key]['list'] = array('#type' => 'checkbox', '#default_value' => $file->list); - $form['files'][$key]['filename'] = array('#type' => 'value', '#value' => $file->filename); - $form['files'][$key]['filepath'] = array('#type' => 'value', '#value' => $file->filepath); - $form['files'][$key]['filemime'] = array('#type' => 'value', '#value' => $file->filemime); - $form['files'][$key]['filesize'] = array('#type' => 'value', '#value' => $file->filesize); - $form['files'][$key]['fid'] = array('#type' => 'value', '#value' => $file->fid); - } - } - - if (user_access('upload files')) { - $form['new']['upload'] = array('#type' => 'file', '#title' => t('Attach new file'), '#size' => 40); - $form['new']['fileop'] = array('#type' => 'button', '#value' => t('Attach'), '#name'=> 'fileop', '#attributes' => array('id' => 'fileop')); - // The class triggers the js upload behaviour. - $form['fileop'] = array('#type' => 'hidden', '#value' => url('upload/js', NULL, NULL, TRUE), '#attributes' => array('class' => 'upload')); - } - - // Needed for JS - $form['current']['vid'] = array('#type' => 'hidden', '#value' => $node->vid); - return $form; -} - -function theme_upload_form_new($form) { - $output .= '' . "\n"; - $output .= '\n"; - return $output; -} - -function theme_upload_form_current(&$form) { - $header = array(t('Delete'), t('List'), t('Description'), t('Size')); - - foreach (element_children($form) as $key) { - $row = array(); - $row[] = form_render($form[$key]['remove']); - $row[] = form_render($form[$key]['list']); - $row[] = form_render($form[$key]['description']); - $row[] = form_render($form[$key]['size']); - $rows[] = $row; - } - $output = theme('table', $header, $rows); - $output .= form_render($form); - return $output; -} - -function upload_load($node) { - $files = array(); - - if ($node->vid) { - $result = db_query('SELECT * FROM {files} f INNER JOIN {file_revisions} r ON f.fid = r.fid WHERE r.vid = %d', $node->vid); - while ($file = db_fetch_object($result)) { - $files[$file->fid] = $file; - } - } - - return $files; -} - -/** - * Check an upload, if it is an image, make sure it fits within the - * maximum dimensions allowed. - */ -function _upload_image($file) { - $info = image_get_info($file->filepath); - - if ($info) { - list($width, $height) = explode('x', variable_get('upload_max_resolution', 0)); - if ($width && $height) { - $result = image_scale($file->filepath, $file->filepath, $width, $height); - if ($result) { - $file->filesize = filesize($file->filepath); - drupal_set_message(t('The image was resized to fit within the maximum allowed resolution of %resolution pixels.', array('%resolution' => theme('placeholder', variable_get('upload_max_resolution', 0))))); - } - } - } - - return $file; -} - -/** - * Menu-callback for JavaScript-based uploads. - */ -function upload_js() { - // We only do the upload.module part of the node validation process. - $node = (object)$_POST['edit']; - - // Load existing node files. - $node->files = upload_load($node); - - // Handle new uploads, and merge tmp files into node-files. - _upload_prepare($node); - _upload_validate($node); - - $form = _upload_form($node); - $form = form_builder('upload_js', $form); - $output = theme('status_messages') . form_render($form); - - // We send the updated file attachments form. - print drupal_to_js(array('status' => TRUE, 'data' => $output)); - exit; -} diff --git a/modules/user/user.module b/modules/user/user.module deleted file mode 100644 index d22ad64f656e00c8ff4f765cf338c3c7a2bf68b5..0000000000000000000000000000000000000000 --- a/modules/user/user.module +++ /dev/null @@ -1,2088 +0,0 @@ - $value) { - if ($key == 'uid' || $key == 'status') { - $query[] = "$key = %d"; - $params[] = $value; - } - else if ($key == 'pass') { - $query[] = "pass = '%s'"; - $params[] = md5($value); - } - else { - $query[]= "LOWER($key) = LOWER('%s')"; - $params[] = $value; - } - } - $result = db_query('SELECT * FROM {users} u WHERE ' . implode(' AND ', $query), $params); - - if (db_num_rows($result)) { - $user = db_fetch_object($result); - $user = drupal_unpack($user); - - $user->roles = array(); - if ($user->uid) { - $user->roles[DRUPAL_AUTHENTICATED_RID] = 'authenticated user'; - } - else { - $user->roles[DRUPAL_ANONYMOUS_RID] = 'anonymous user'; - } - $result = db_query('SELECT r.rid, r.name FROM {role} r INNER JOIN {users_roles} ur ON ur.rid = r.rid WHERE ur.uid = %d', $user->uid); - while ($role = db_fetch_object($result)) { - $user->roles[$role->rid] = $role->name; - } - user_module_invoke('load', $array, $user); - } - else { - $user = FALSE; - } - - return $user; -} - -/** - * Save changes to a user account. - * - * @param $account - * The $user object for the user to modify. - * - * @param $array - * An array of fields and values to save. For example array('name' => 'My name'); - * Setting a field to null deletes it from the data column. - * - * @param $category - * (optional) The category for storing profile information in. - */ -function user_save($account, $array = array(), $category = 'account') { - // Dynamically compose a SQL query: - $user_fields = user_fields(); - if ($account->uid) { - user_module_invoke('update', $array, $account, $category); - - $data = unserialize(db_result(db_query('SELECT data FROM {users} WHERE uid = %d', $account->uid))); - foreach ($array as $key => $value) { - if ($key == 'pass' && !empty($value)) { - $query .= "$key = '%s', "; - $v[] = md5($value); - } - else if ((substr($key, 0, 4) !== 'auth') && ($key != 'pass')) { - if (in_array($key, $user_fields)) { - // Save standard fields - $query .= "$key = '%s', "; - $v[] = $value; - } - else if ($key != 'roles') { - // Roles is a special case: it used below. - if ($value === null) { - unset($data[$key]); - } - else { - $data[$key] = $value; - } - } - } - } - $query .= "data = '%s' "; - $v[] = serialize($data); - - db_query("UPDATE {users} SET $query WHERE uid = %d", array_merge($v, array($account->uid))); - - // Reload user roles if provided - if (is_array($array['roles'])) { - db_query('DELETE FROM {users_roles} WHERE uid = %d', $account->uid); - - foreach (array_keys($array['roles']) as $rid) { - if (!in_array($rid, array(DRUPAL_ANONYMOUS_RID, DRUPAL_AUTHENTICATED_RID))) { - db_query('INSERT INTO {users_roles} (uid, rid) VALUES (%d, %d)', $account->uid, $rid); - } - } - } - - // Delete a blocked user's sessions to kick them if they are online. - if (isset($array['status']) && $array['status'] == 0) { - db_query('DELETE FROM {sessions} WHERE uid = %d', $account->uid); - } - - // Refresh user object - $user = user_load(array('uid' => $account->uid)); - } - else { - $array['created'] = time(); - $array['uid'] = db_next_id('{users}_uid'); - - // Note, we wait with saving the data column to prevent module-handled - // fields from being saved there. We cannot invoke hook_user('insert') here - // because we don't have a fully initialized user object yet. - foreach ($array as $key => $value) { - switch($key) { - case 'pass': - $fields[] = $key; - $values[] = md5($value); - $s[] = "'%s'"; - break; - case 'uid': case 'mode': case 'sort': - case 'threshold': case 'created': case 'access': - case 'login': case 'status': - $fields[] = $key; - $values[] = $value; - $s[] = "%d"; - break; - default: - if (substr($key, 0, 4) !== 'auth' && in_array($key, $user_fields)) { - $fields[] = $key; - $values[] = $value; - $s[] = "'%s'"; - } - break; - } - } - db_query('INSERT INTO {users} ('. implode(', ', $fields) .') VALUES ('. implode(', ', $s) .')', $values); - - // Reload user roles (delete just to be safe). - db_query('DELETE FROM {users_roles} WHERE uid = %d', $array['uid']); - foreach ((array)$array['roles'] as $rid) { - db_query('INSERT INTO {users_roles} (uid, rid) VALUES (%d, %d)', $array['uid'], $rid); - } - - // Build the initial user object. - $user = user_load(array('uid' => $array['uid'])); - - user_module_invoke('insert', $array, $user, $category); - - // Build and save the serialized data field now - $data = array(); - foreach ($array as $key => $value) { - if ((substr($key, 0, 4) !== 'auth') && ($key != 'roles') && (!in_array($key, $user_fields)) && ($value !== null)) { - $data[$key] = $value; - } - } - db_query("UPDATE {users} SET data = '%s' WHERE uid = %d", serialize($data), $user->uid); - - // Build the finished user object. - $user = user_load(array('uid' => $array['uid'])); - } - - // Save distributed authentication mappings - $authmaps = array(); - foreach ($array as $key => $value) { - if (substr($key, 0, 4) == 'auth') { - $authmaps[$key] = $value; - } - } - if (sizeof($authmaps) > 0) { - user_set_authmaps($user, $authmaps); - } - - return $user; -} - -/** - * Verify the syntax of the given name. - */ -function user_validate_name($name) { - if (!strlen($name)) return t('You must enter a username.'); - if (substr($name, 0, 1) == ' ') return t('The username cannot begin with a space.'); - if (substr($name, -1) == ' ') return t('The username cannot end with a space.'); - if (ereg(' ', $name)) return t('The username cannot contain multiple spaces in a row.'); - if (ereg("[^\x80-\xF7 [:alnum:]@_.-]", $name)) return t('The username contains an illegal character.'); - if (preg_match('/[\x{80}-\x{A0}'. // Non-printable ISO-8859-1 + NBSP - '\x{AD}'. // Soft-hyphen - '\x{2000}-\x{200F}'. // Various space characters - '\x{2028}-\x{202F}'. // Bidirectional text overrides - '\x{205F}-\x{206F}'. // Various text hinting characters - '\x{FEFF}'. // Byte order mark - '\x{FF01}-\x{FF60}'. // Full-width latin - '\x{FFF9}-\x{FFFD}]/u', // Replacement characters - $name)) { - return t('The username contains an illegal character.'); - } - if (ereg('@', $name) && !eregi('@([0-9a-z](-?[0-9a-z])*.)+[a-z]{2}([zmuvtg]|fo|me)?$', $name)) return t('The username is not a valid authentication ID.'); - if (strlen($name) > 56) return t('The username %name is too long: it must be less than 56 characters.', array('%name' => theme('placeholder', $name))); -} - -function user_validate_mail($mail) { - if (!$mail) return t('You must enter an e-mail address.'); - if (!valid_email_address($mail)) { - return t('The e-mail address %mail is not valid.', array('%mail' => theme('placeholder', $mail))); - } -} - -function user_validate_picture($file, &$edit, $user) { - global $form_values; - // Initialize the picture: - $form_values['picture'] = $user->picture; - - // Check that uploaded file is an image, with a maximum file size - // and maximum height/width. - $info = image_get_info($file->filepath); - list($maxwidth, $maxheight) = explode('x', variable_get('user_picture_dimensions', '85x85')); - - if (!$info || !$info['extension']) { - form_set_error('picture_upload', t('The uploaded file was not an image.')); - } - else if (image_get_toolkit()) { - image_scale($file->filepath, $file->filepath, $maxwidth, $maxheight); - } - else if (filesize($file->filepath) > (variable_get('user_picture_file_size', '30') * 1000)) { - form_set_error('picture_upload', t('The uploaded image is too large; the maximum file size is %size kB.', array('%size' => variable_get('user_picture_file_size', '30')))); - } - else if ($info['width'] > $maxwidth || $info['height'] > $maxheight) { - form_set_error('picture_upload', t('The uploaded image is too large; the maximum dimensions are %dimensions pixels.', array('%dimensions' => variable_get('user_picture_dimensions', '85x85')))); - } - - if (!form_get_errors()) { - if ($file = file_save_upload('picture_upload', variable_get('user_picture_path', 'pictures') .'/picture-'. $user->uid . '.' . $info['extension'], 1)) { - $form_values['picture'] = $file->filepath; - } - else { - form_set_error('picture_upload', t("Failed to upload the picture image; the %directory directory doesn't exist.", array('%directory' => ''. variable_get('user_picture_path', 'pictures') .''))); - } - } -} - -/** - * Generate a random alphanumeric password. - */ -function user_password($length = 10) { - // This variable contains the list of allowable characters for the - // password. Note that the number 0 and the letter 'O' have been - // removed to avoid confusion between the two. The same is true - // of 'I', 1, and l. - $allowable_characters = 'abcdefghijkmnopqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789'; - - // Zero-based count of characters in the allowable list: - $len = strlen($allowable_characters) - 1; - - // Declare the password as a blank string. - $pass = ''; - - // Loop the number of times specified by $length. - for ($i = 0; $i < $length; $i++) { - - // Each iteration, pick a random character from the - // allowable string and append it to the password: - $pass .= $allowable_characters[mt_rand(0, $len)]; - } - - return $pass; -} - -/** - * Determine whether the user has a given privilege. - * - * @param $string - * The permission, such as "administer nodes", being checked for. - * @param $account - * (optional) The account to check, if not given use currently logged in user. - * - * @return - * boolean TRUE if the current user has the requested permission. - * - * All permission checks in Drupal should go through this function. This - * way, we guarantee consistent behavior, and ensure that the superuser - * can perform all actions. - */ -function user_access($string, $account = NULL) { - global $user; - static $perm = array(); - - if (is_null($account)) { - $account = $user; - } - - // User #1 has all privileges: - if ($account->uid == 1) { - return TRUE; - } - - // To reduce the number of SQL queries, we cache the user's permissions - // in a static variable. - if (!isset($perm[$account->uid])) { - $result = db_query("SELECT DISTINCT(p.perm) FROM {role} r INNER JOIN {permission} p ON p.rid = r.rid WHERE r.rid IN (%s)", implode(',', array_keys($account->roles))); - - $perm[$account->uid] = ''; - while ($row = db_fetch_object($result)) { - $perm[$account->uid] .= "$row->perm, "; - } - } - - if (isset($perm[$account->uid])) { - return strpos($perm[$account->uid], "$string, ") !== FALSE; - } - - return FALSE; -} - -/** - * Checks for usernames blocked by user administration - * - * @return boolean true for blocked users, false for active - */ -function user_is_blocked($name) { - $allow = db_fetch_object(db_query("SELECT * FROM {users} WHERE status = 1 AND name = LOWER('%s')", $name)); - $deny = db_fetch_object(db_query("SELECT * FROM {users} WHERE status = 0 AND name = LOWER('%s')", $name)); - - return $deny && !$allow; -} - -/** - * Send an e-mail message. - */ -function user_mail($mail, $subject, $message, $header) { - if (variable_get('smtp_library', '') && file_exists(variable_get('smtp_library', ''))) { - include_once './' . variable_get('smtp_library', ''); - return user_mail_wrapper($mail, $subject, $message, $header); - } - else { - /* - ** Note: if you are having problems with sending mail, or mails look wrong - ** when they are received you may have to modify the str_replace to suit - ** your systems. - ** - \r\n will work under dos and windows. - ** - \n will work for linux, unix and BSDs. - ** - \r will work for macs. - ** - ** According to RFC 2646, it's quite rude to not wrap your e-mails: - ** - ** "The Text/Plain media type is the lowest common denominator of - ** Internet e-mail, with lines of no more than 997 characters (by - ** convention usually no more than 80), and where the CRLF sequence - ** represents a line break [MIME-IMT]." - ** - ** CRLF === \r\n - ** - ** http://www.rfc-editor.org/rfc/rfc2646.txt - ** - */ - return mail( - $mail, - mime_header_encode($subject), - str_replace("\r", '', $message), - "MIME-Version: 1.0\nContent-Type: text/plain; charset=UTF-8; format=flowed\nContent-transfer-encoding: 8Bit\n" . $header - ); - } -} - -function user_fields() { - static $fields; - - if (!$fields) { - $result = db_query('SELECT * FROM {users} WHERE uid = 1'); - if (db_num_rows($result)) { - $fields = array_keys(db_fetch_array($result)); - } - else { - // Make sure we return the default fields at least - $fields = array('uid', 'name', 'pass', 'mail', 'picture', 'mode', 'sort', 'threshold', 'theme', 'signature', 'created', 'access', 'login', 'status', 'timezone', 'language', 'init', 'data'); - } - } - - return $fields; -} - -/** - * Implementation of hook_perm(). - */ -function user_perm() { - return array('administer access control', 'administer users', 'access user profiles', 'change own username'); -} - -/** - * Implementation of hook_file_download(). - * - * Ensure that user pictures (avatars) are always downloadable. - */ -function user_file_download($file) { - if (strpos($file, variable_get('user_picture_path', 'pictures') .'/picture-') === 0) { - $info = image_get_info(file_create_path($file)); - return array('Content-type: '. $info['mime_type']); - } -} - -/** - * Implementation of hook_search(). - */ -function user_search($op = 'search', $keys = null) { - switch ($op) { - case 'name': - if (user_access('access user profiles')) { - return t('users'); - } - case 'search': - if (user_access('access user profiles')) { - $find = array(); - // Replace wildcards with MySQL/PostgreSQL wildcards. - $keys = preg_replace('!\*+!', '%', $keys); - $result = pager_query("SELECT * FROM {users} WHERE LOWER(name) LIKE LOWER('%%%s%%')", 15, 0, NULL, $keys); - while ($account = db_fetch_object($result)) { - $find[] = array('title' => $account->name, 'link' => url('user/'. $account->uid)); - } - return $find; - } - } -} - -/** - * Implementation of hook_user(). - */ -function user_user($type, &$edit, &$user, $category = NULL) { - if ($type == 'view') { - $items[] = array('title' => t('Member for'), - 'value' => format_interval(time() - $user->created), - 'class' => 'member', - ); - - return array(t('History') => $items); - } - if ($type == 'form' && $category == 'account') { - return user_edit_form(arg(1), $edit); - } - - if ($type == 'validate' && $category == 'account') { - return _user_edit_validate(arg(1), $edit); - } - - if ($type == 'submit' && $category == 'account') { - return _user_edit_submit(arg(1), $edit); - } - - if ($type == 'categories') { - return array(array('name' => 'account', 'title' => t('account settings'), 'weight' => 1)); - } -} - -/** - * Implementation of hook_block(). - */ -function user_block($op = 'list', $delta = 0, $edit = array()) { - global $user; - - if ($op == 'list') { - $blocks[0]['info'] = t('User login'); - $blocks[1]['info'] = t('Navigation'); - $blocks[2]['info'] = t('Who\'s new'); - $blocks[3]['info'] = t('Who\'s online'); - - return $blocks; - } - else if ($op == 'configure' && $delta == 3) { - $period = drupal_map_assoc(array(30, 60, 120, 180, 300, 600, 900, 1800, 2700, 3600, 5400, 7200, 10800, 21600, 43200, 86400), 'format_interval'); - $form['user_block_seconds_online'] = array('#type' => 'select', '#title' => t('User activity'), '#default_value' => variable_get('user_block_seconds_online', 900), '#options' => $period, '#description' => t('A user is considered online for this long after they have last viewed a page.')); - $form['user_block_max_list_count'] = array('#type' => 'select', '#title' => t('User list length'), '#default_value' => variable_get('user_block_max_list_count', 10), '#options' => drupal_map_assoc(array(0, 5, 10, 15, 20, 25, 30, 40, 50, 75, 100)), '#description' => t('Maximum number of currently online users to display.')); - - return $form; - } - else if ($op == 'save' && $delta == 3) { - variable_set('user_block_seconds_online', $edit['user_block_seconds_online']); - variable_set('user_block_max_list_count', $edit['user_block_max_list_count']); - } - else if ($op == 'view') { - $block = array(); - - switch ($delta) { - case 0: - // For usability's sake, avoid showing two login forms on one page. - if (!$user->uid && !(arg(0) == 'user' && !is_numeric(arg(1)))) { - $form['#action'] = url($_GET['q'], drupal_get_destination()); - $form['#id'] = 'user-login-form'; - $form['name'] = array('#type' => 'textfield', - '#title' => t('Username'), - '#maxlength' => 60, - '#size' => 15, - '#required' => TRUE, - ); - $form['pass'] = array('#type' => 'password', - '#title' => t('Password'), - '#size' => 15, - '#required' => TRUE, - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Log in'), - ); - - if (variable_get('user_register', 1)) { - $items[] = l(t('Create new account'), 'user/register', array('title' => t('Create a new user account.'))); - } - $items[] = l(t('Request new password'), 'user/password', array('title' => t('Request new password via e-mail.'))); - $form['links'] = array('#value' => theme('item_list', $items)); - - $output .= drupal_get_form('user_login_block', $form, 'user_login'); - - $block['subject'] = t('User login'); - $block['content'] = $output; - } - return $block; - - case 1: - if ($menu = theme('menu_tree')) { - $block['subject'] = $user->uid ? $user->name : t('Navigation'); - $block['content'] = $menu; - } - return $block; - - case 2: - if (user_access('access content')) { - // Retrieve a list of new users who have subsequently accessed the site successfully. - $result = db_query_range('SELECT uid, name FROM {users} WHERE status != 0 AND access != 0 ORDER BY created DESC', 0, 5); - while ($account = db_fetch_object($result)) { - $items[] = $account; - } - $output = theme('user_list', $items); - - $block['subject'] = t('Who\'s new'); - $block['content'] = $output; - } - return $block; - - case 3: - if (user_access('access content')) { - // Count users with activity in the past defined period. - $time_period = variable_get('user_block_seconds_online', 2700); - - // Perform database queries to gather online user lists. - $guests = db_fetch_object(db_query('SELECT COUNT(sid) AS count FROM {sessions} WHERE timestamp >= %d AND uid = 0', time() - $time_period)); - $users = db_query('SELECT uid, name, access FROM {users} WHERE access >= %d AND uid != 0 ORDER BY access DESC', time() - $time_period); - $total_users = db_num_rows($users); - - // Format the output with proper grammar. - if ($total_users == 1 && $guests->count == 1) { - $output = t('There is currently %members and %visitors online.', array('%members' => format_plural($total_users, '1 user', '%count users'), '%visitors' => format_plural($guests->count, '1 guest', '%count guests'))); - } - else { - $output = t('There are currently %members and %visitors online.', array('%members' => format_plural($total_users, '1 user', '%count users'), '%visitors' => format_plural($guests->count, '1 guest', '%count guests'))); - } - - // Display a list of currently online users. - $max_users = variable_get('user_block_max_list_count', 10); - $items = array(); - - while ($max_users-- && $account = db_fetch_object($users)) { - $items[] = $account; - } - - $output .= theme('user_list', $items, t('Online users')); - - $block['subject'] = t('Who\'s online'); - $block['content'] = $output; - } - return $block; - } - } -} - -function theme_user_picture($account) { - if (variable_get('user_pictures', 0)) { - if ($account->picture && file_exists($account->picture)) { - $picture = file_create_url($account->picture); - } - else if (variable_get('user_picture_default', '')) { - $picture = variable_get('user_picture_default', ''); - } - - if (isset($picture)) { - $alt = t('%user\'s picture', array('%user' => $account->name ? $account->name : variable_get('anonymous', 'Anonymous'))); - $picture = theme('image', $picture, $alt, $alt, '', false); - if (!empty($account->uid) && user_access('access user profiles')) { - $picture = l($picture, "user/$account->uid", array('title' => t('View user profile.')), NULL, NULL, FALSE, TRUE); - } - - return "' . "\n"; - $output .= form_render($form) . "\n"; - $output .= "\n"; - $output .= "$picture"; - } - } -} - -/** - * Theme a user page - * @param $account the user object - * @param $fields a multidimensional array for the fields, in the form of array ( - * 'category1' => array(item_array1, item_array2), 'category2' => array(item_array3, - * .. etc.). Item arrays are formatted as array(array('title' => 'item title', - * 'value' => 'item value', 'class' => 'class-name'), ... etc.). Module names are incorporated - * into the CSS class. - * - * @ingroup themeable - */ -function theme_user_profile($account, $fields) { - $output = ''; - $output .= theme('user_picture', $account); - foreach ($fields as $category => $items) { - if (strlen($category) > 0) { - $output .= ''; - - return $output; -} - -/** - * Make a list of users. - * @param $items an array with user objects. Should contain at least the name and uid - * - * @ingroup themeable - */ -function theme_user_list($users, $title = NULL) { - if (!empty($users)) { - foreach ($users as $user) { - $items[] = theme('username', $user); - } - } - return theme('item_list', $items, $title); -} - -/** - * Implementation of hook_menu(). - */ -function user_menu($may_cache) { - global $user; - - $items = array(); - - $admin_access = user_access('administer users'); - $access_access = user_access('administer access control'); - $view_access = user_access('access user profiles'); - - if ($may_cache) { - $items[] = array('path' => 'user', 'title' => t('user account'), - 'callback' => 'user_login', 'access' => TRUE, 'type' => MENU_CALLBACK); - - $items[] = array('path' => 'user/autocomplete', 'title' => t('user autocomplete'), - 'callback' => 'user_autocomplete', 'access' => $view_access, 'type' => MENU_CALLBACK); - - // Registration and login pages. - $items[] = array('path' => 'user/login', 'title' => t('log in'), - 'callback' => 'user_login', 'type' => MENU_DEFAULT_LOCAL_TASK); - $items[] = array('path' => 'user/register', 'title' => t('register'), - 'callback' => 'user_register', 'access' => $user->uid == 0 && variable_get('user_register', 1), 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'user/password', 'title' => t('request new password'), - 'callback' => 'user_pass', 'access' => $user->uid == 0, 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'user/reset', 'title' => t('reset password'), - 'callback' => 'user_pass_reset', 'access' => TRUE, 'type' => MENU_CALLBACK); - $items[] = array('path' => 'user/help', 'title' => t('help'), - 'callback' => 'user_help_page', 'type' => MENU_CALLBACK); - - // Admin user pages - $items[] = array('path' => 'admin/user', 'title' => t('users'), - 'callback' => 'user_admin', 'access' => $admin_access); - $items[] = array('path' => 'admin/user/list', 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/user/create', 'title' => t('add user'), - 'callback' => 'user_admin', 'access' => $admin_access, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/settings/user', 'title' => t('users'), - 'callback' => 'user_configure'); - - // Admin access pages - $items[] = array('path' => 'admin/access', 'title' => t('access control'), - 'callback' => 'user_admin_perm', 'access' => $access_access); - $items[] = array('path' => 'admin/access/permissions', 'title' => t('permissions'), - 'callback' => 'user_admin_perm', 'access' => $access_access, - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/access/roles', 'title' => t('roles'), - 'callback' => 'user_admin_role', 'access' => $access_access, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/access/roles/edit', 'title' => t('edit role'), - 'callback' => 'user_admin_role', 'access' => $access_access, - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/access/rules', 'title' => t('access rules'), - 'callback' => 'user_admin_access', 'access' => $access_access, - 'type' => MENU_LOCAL_TASK, 'weight' => 10); - $items[] = array('path' => 'admin/access/rules/list', 'title' => t('list'), - 'access' => $access_access, 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/access/rules/add', 'title' => t('add rule'), - 'callback' => 'user_admin_access_add', 'access' => $access_access, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/access/rules/check', 'title' => t('check rules'), - 'callback' => 'user_admin_access_check', 'access' => $access_access, - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'admin/access/rules/edit', 'title' => t('edit rule'), - 'callback' => 'user_admin_access_edit', 'access' => $access_access, - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/access/rules/delete', 'title' => t('delete rule'), - 'callback' => 'user_admin_access_delete', 'access' => $access_access, - 'type' => MENU_CALLBACK); - - if (module_exist('search')) { - $items[] = array('path' => 'admin/user/search', 'title' => t('search'), - 'callback' => 'user_admin', 'access' => $admin_access, - 'type' => MENU_LOCAL_TASK); - } - - // Your personal page - if ($user->uid) { - $items[] = array('path' => 'user/'. $user->uid, 'title' => t('my account'), - 'callback' => 'user_view', 'callback arguments' => array(arg(1)), 'access' => TRUE, - 'type' => MENU_DYNAMIC_ITEM); - } - - $items[] = array('path' => 'logout', 'title' => t('log out'), - 'access' => $user->uid != 0, - 'callback' => 'user_logout', - 'weight' => 10); - } - else { - if (arg(0) == 'user' && is_numeric(arg(1))) { - $account = user_load(array('uid' => arg(1))); - - if ($user !== FALSE) { - // Always let a user view their own account - $view_access |= $user->uid == arg(1); - // Only admins can view blocked accounts - $view_access &= $account->status || $admin_access; - - $items[] = array('path' => 'user/'. arg(1), 'title' => t('user'), - 'type' => MENU_CALLBACK, 'callback' => 'user_view', - 'callback arguments' => array(arg(1)), 'access' => $view_access); - - $items[] = array('path' => 'user/'. arg(1) .'/view', 'title' => t('view'), - 'access' => $view_access, 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - - $items[] = array('path' => 'user/'. arg(1) .'/edit', 'title' => t('edit'), - 'callback' => 'user_edit', 'access' => $admin_access || $user->uid == arg(1), - 'type' => MENU_LOCAL_TASK); - $items[] = array('path' => 'user/'. arg(1) .'/delete', 'title' => t('delete'), - 'callback' => 'user_edit', 'access' => $admin_access, - 'type' => MENU_CALLBACK); - - if (arg(2) == 'edit') { - if (($categories = _user_categories()) && (count($categories) > 1)) { - foreach ($categories as $key => $category) { - $items[] = array( - 'path' => 'user/'. arg(1) .'/edit/'. $category['name'], - 'title' => $category['title'], - 'type' => $category['name'] == 'account' ? MENU_DEFAULT_LOCAL_TASK : MENU_LOCAL_TASK, - 'weight' => $category['weight'], - 'access' => ($admin_access || $user->uid == arg(1))); - } - } - } - } - } - } - - return $items; -} - -/** - * Accepts an user object, $account, or a DA name and returns an associative - * array of modules and DA names. Called at external login. - */ -function user_get_authmaps($authname = NULL) { - $result = db_query("SELECT authname, module FROM {authmap} WHERE authname = '%s'", $authname); - if (db_num_rows($result) > 0) { - while ($authmap = db_fetch_object($result)) { - $authmaps[$authmap->module] = $authmap->authname; - } - return $authmaps; - } - else { - return 0; - } -} - -function user_set_authmaps($account, $authmaps) { - foreach ($authmaps as $key => $value) { - $module = explode('_', $key, 2); - if ($value) { - db_query("UPDATE {authmap} SET authname = '%s' WHERE uid = %d AND module = '%s'", $value, $account->uid, $module['1']); - if (!db_affected_rows()) { - db_query("INSERT INTO {authmap} (authname, uid, module) VALUES ('%s', %d, '%s')", $value, $account->uid, $module[1]); - } - } - else { - db_query("DELETE FROM {authmap} WHERE uid = %d AND module = '%s'", $account->uid, $module['1']); - } - } -} - -function user_auth_help_links() { - $links = array(); - foreach (module_list() as $module) { - if (module_hook($module, 'auth')) { - $links[] = l(module_invoke($module, 'info', 'name'), "user/help#$module"); - } - } - return $links; -} - -/*** User features *********************************************************/ - - - -function user_login($msg = '') { - global $user, $base_url; - - // If we are already logged on, go to the user page instead. - if ($user->uid) { - drupal_goto('user/'. $user->uid); - } - - // Display login form: - if ($msg) { - $form['message'] = array('#value' => "'. $category .'
'; - } - $output .= '- ';
- foreach ($items as $item) {
- if (isset($item['title'])) {
- $output .= '
- '. $item['title'] .' '; - } - $output .= '
- '. $item['value'] .' '; - } - $output .= '
$msg
"); - } - $form['name'] = array('#type' => 'textfield', - '#title' => t('Username'), - '#size' => 30, - '#maxlength' => 60, - '#required' => TRUE, - '#attributes' => array('tabindex' => '1'), - ); - if (count(user_auth_help_links()) > 0) { - $form['name']['#description'] = t('Enter your %s username, or an ID from one of our affiliates: %a.', array('%s' => variable_get('site_name', 'local'), '%a' => implode(', ', user_auth_help_links()))); - } - else { - $form['name']['#description'] = t('Enter your %s username.', array('%s' => variable_get('site_name', 'local'))); - } - $form['pass'] = array('#type' => 'password', - '#title' => t('Password'), - '#description' => t('Enter the password that accompanies your username.'), - '#required' => TRUE, - '#attributes' => array('tabindex' => '2'), - ); - $form['submit'] = array('#type' => 'submit', '#value' => t('Log in'), '#weight' => 2, '#attributes' => array('tabindex' => '3')); - return drupal_get_form('user_login', $form); -} - -function user_login_validate($form_id, $form_values) { - if ($form_values['name']) { - if (user_is_blocked($form_values['name'])) { - // blocked in user administration - form_set_error('login', t('The username %name has been blocked.', array('%name' => theme('placeholder', $form_values['name'])))); - } - else if (drupal_is_denied('user', $form_values['name'])) { - // denied by access controls - form_set_error('login', t('The name %name is a reserved username.', array('%name' => theme('placeholder', $form_values['name'])))); - } - else if ($form_values['pass']) { - $user = user_authenticate($form_values['name'], trim($form_values['pass'])); - - if (!$user->uid) { - form_set_error('login', t('Sorry. Unrecognized username or password.') .' '. l(t('Have you forgotten your password?'), 'user/password')); - watchdog('user', t('Login attempt failed for %user.', array('%user' => theme('placeholder', $form_values['name'])))); - } - } - } -} - -function user_login_submit($form_id, $form_values) { - global $user; - if ($user->uid) { - watchdog('user', t('Session opened for %name.', array('%name' => theme('placeholder', $user->name)))); - - // Update the user table timestamp noting user has logged in. - db_query("UPDATE {users} SET login = %d WHERE uid = %d", time(), $user->uid); - - user_module_invoke('login', $form_values, $user); - - $old_session_id = session_id(); - session_regenerate_id(); - db_query("UPDATE {sessions} SET sid = '%s' WHERE sid = '%s'", session_id(), $old_session_id); - - } -} - -function user_authenticate($name, $pass) { - global $user; - - // Try to log in the user locally. Don't set $user unless successful. - if ($account = user_load(array('name' => $name, 'pass' => $pass, 'status' => 1))) { - $user = $account; - }; - - // Strip name and server from ID: - if ($server = strrchr($name, '@')) { - $name = substr($name, 0, strlen($name) - strlen($server)); - $server = substr($server, 1); - } - - // When possible, determine corresponding external auth source. Invoke - // source, and log in user if successful: - if (!$user->uid && $server && $result = user_get_authmaps("$name@$server")) { - if (module_invoke(key($result), 'auth', $name, $pass, $server)) { - $user = user_external_load("$name@$server"); - watchdog('user', t('External load by %user using module %module.', array('%user' => theme('placeholder', $name .'@'. $server), '%module' => theme('placeholder', key($result))))); - } - else { - $error = t('Invalid password for %s.', array('%s' => theme('placeholder', $name .'@'. $server))); - } - } - - // Try each external authentication source in series. Register user if - // successful. - else if (!$user->uid && $server) { - foreach (module_list() as $module) { - if (module_hook($module, 'auth')) { - if (module_invoke($module, 'auth', $name, $pass, $server)) { - if (variable_get('user_register', 1) == 1) { - $account = user_load(array('name' => "$name@$server")); - if (!$account->uid) { // Register this new user. - $user = user_save('', array('name' => "$name@$server", 'pass' => user_password(), 'init' => "$name@$server", 'status' => 1, "authname_$module" => "$name@$server")); - watchdog('user', t('New external user: %user using module %module.', array('%user' => theme('placeholder', $name .'@'. $server), '%module' => theme('placeholder', $module))), WATCHDOG_NOTICE, l(t('edit'), 'user/'. $user->uid .'/edit')); - break; - } - } - } - } - } - } - return $user; -} - -/** - * Menu callback; logs the current user out, and redirects to the home page. - */ -function user_logout() { - global $user; - - watchdog('user', t('Session closed for %name.', array('%name' => theme('placeholder', $user->name)))); - - // Destroy the current session: - session_destroy(); - module_invoke_all('user', 'logout', NULL, $user); - - // We have to use $GLOBALS to unset a global variable: - $user = user_load(array('uid' => 0)); - - drupal_goto(); -} - -function user_pass() { - - // Display form: - $form['name'] = array('#type' => 'textfield', - '#title' => t('Username'), - '#size' => 30, - '#maxlength' => 60, - ); - $form['mail'] = array('#type' => 'textfield', - '#title' => t('E-mail address'), - '#size' => 30, - '#maxlength' => 64, - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('E-mail new password'), - '#weight' => 2, - ); - return drupal_get_form('user_pass', $form); -} - -function user_pass_validate() { - global $form_values; - - $name = $form_values['name']; - $mail = $form_values['mail']; - if ($name && !($form_values['account'] = user_load(array('name' => $name, 'status' => 1)))) { - form_set_error('name', t('Sorry. The username %name is not recognized.', array('%name' => theme('placeholder', $name)))); - } - else if ($mail && !($form_values['account'] = user_load(array('mail' => $mail, 'status' => 1)))) { - form_set_error('mail', t('Sorry. The e-mail address %email is not recognized.', array('%email' => theme('placeholder', $mail)))); - } - else if (!$mail && !$name) { - form_set_error('password', t('You must provide either a username or e-mail address.')); - } -} - -function user_pass_submit($form_id, $form_values) { - global $base_url; - - $account = $form_values['account']; - $from = variable_get('site_mail', ini_get('sendmail_from')); - - // Mail one time login URL and instructions. - $variables = array('%username' => $account->name, '%site' => variable_get('site_name', 'drupal'), '%login_url' => user_pass_reset_url($account), '%uri' => $base_url, '%uri_brief' => substr($base_url, strlen('http://')), '%mailto' => $account->mail, '%date' => format_date(time()), '%login_uri' => url('user', NULL, NULL, TRUE), '%edit_uri' => url('user/'. $account->uid .'/edit', NULL, NULL, TRUE)); - $subject = _user_mail_text('pass_subject', $variables); - $body = _user_mail_text('pass_body', $variables); - $headers = "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"; - $mail_success = user_mail($account->mail, $subject, $body, $headers); - - if ($mail_success) { - watchdog('user', t('Password reset instructions mailed to %name at %email.', array('%name' => ''. $account->name .'', '%email' => ''. $account->mail .''))); - drupal_set_message(t('Further instructions have been sent to your e-mail address.')); - } - else { - watchdog('user', t('Error mailing password reset instructions to %name at %email.', array('%name' => theme('placeholder', $account->name), '%email' => theme('placeholder', $account->mail))), WATCHDOG_ERROR); - drupal_set_message(t('Unable to send mail. Please contact the site admin.')); - } - return 'user'; -} - -function theme_user_pass($form) { - $output = ''. t('Enter your username or your e-mail address.') .'
'; - $output .= form_render($form); - return $output; -} - -/** - * Menu callback; process one time login link and redirects to the user page on success. - */ -function user_pass_reset($uid, $timestamp, $hashed_pass, $action = NULL) { - global $user; - - // Check if the user is already logged in. The back button is often the culprit here. - if ($user->uid) { - drupal_set_message(t('You have already used this one-time login link. It is not necessary to use this link to login anymore. You are already logged in.')); - drupal_goto(variable_get('site_frontpage', 'node')); - } - else { - // Time out, in seconds, until login URL expires. 24 hours = 86400 seconds. - $timeout = 86400; - $current = time(); - // Some redundant checks for extra security ? - if ($timestamp < $current && $account = user_load(array('uid' => $uid, 'status' => 1)) ) { - // No time out for first time login. - if ($account->login && $current - $timestamp > $timeout) { - drupal_set_message(t('You have tried to use a one-time login link that has expired. Please request a new one using the form below.')); - drupal_goto('user/password'); - } - else if ($account->uid && $timestamp > $account->login && $timestamp < $current && $hashed_pass == user_pass_rehash($account->pass, $timestamp, $account->login)) { - // First stage is a confirmation form, then login - if ($action == 'login') { - watchdog('user', t('User %name used one-time login link at time %timestamp.', array('%name' => "$account->name", '%timestamp' => $timestamp))); - // Update the user table noting user has logged in. - // And this also makes this hashed password a one-time-only login. - db_query("UPDATE {users} SET login = %d WHERE uid = %d", time(), $account->uid); - // Now we can set the new user. - $user = $account; - // And proceed with normal login, going to user page. - user_module_invoke('login', $edit, $user); - drupal_set_message(t('You have just used your one-time login link. It is no longer necessary to use this link to login. Please change your password.')); - drupal_goto('user/'. $user->uid .'/edit'); - } - else { - $form['message'] = array('#value' => t('This is a one-time login for %user_name and will expire on %expiration_date
Click on this button to login to the site and change your password.
', array('%user_name' => theme('placeholder',$account->name), '%expiration_date' => format_date($timestamp + $timeout)))); - $form['help'] = array('#value' => t('This login can be used only once.
')); - $form['submit'] = array('#type' => 'submit', '#value' => t('Log in')); - $form['#action'] = url("user/reset/$uid/$timestamp/$hashed_pass/login"); - return drupal_get_form('user_pass_reset', $form); - } - } - else { - drupal_set_message(t('You have tried to use a one-time login link which has either been used or is no longer valid. Please request a new one using the form below.')); - drupal_goto('user/password'); - } - } - else { - // Deny access, no more clues. - // Everything will be in the watchdog's URL for the administrator to check. - drupal_access_denied(); - } - } -} - -function user_pass_reset_url($account) { - $timestamp = time(); - return url("user/reset/$account->uid/$timestamp/".user_pass_rehash($account->pass, $timestamp, $account->login), NULL, NULL, TRUE); -} - -function user_pass_rehash($password, $timestamp, $login) { - return md5($timestamp . $password . $login); -} - -function user_register() { - global $user; - - $admin = user_access('administer users'); - - // If we aren't admin but already logged on, go to the user page instead. - if (!$admin && $user->uid) { - drupal_goto('user/'. $user->uid); - } - - // Display the registration form. - if (!$admin) { - $form['user_registration_help'] = array('#type' => 'markup', '#value' => variable_get('user_registration_help', '')); - } - $affiliates = user_auth_help_links(); - if (!$admin && count($affiliates) > 0) { - $affiliates = implode(', ', $affiliates); - $form['affiliates'] = array('#type' => 'markup', '#value' => ''. t('Note: if you have an account with one of our affiliates (%s), you may login now instead of registering.', array('%s' => $affiliates, '%login_uri' => url('user'))) .'
'); - } - $form['name'] = array('#type' => 'textfield', - '#title' => t('Username'), - '#size' => 30, - '#maxlength' => 60, - '#description' => t('Your full name or your preferred username; only letters, numbers and spaces are allowed.'), - '#required' => TRUE); - $form['mail'] = array('#type' => 'textfield', - '#title' => t('E-mail address'), - '#size' => 30, - '#maxlength' => 64, - '#description' => t('A password and instructions will be sent to this e-mail address, so make sure it is accurate.'), - '#required' => TRUE, - ); - if ($admin) { - $form['pass'] = array('#type' => 'password', - '#title' => t('Password'), - '#size' => 30, - '#description' => t('Provide a password for the new account.'), - '#required' => TRUE, - ); - $form['notify'] = array( - '#type' => 'checkbox', - '#title' => t('Notify user of new account') - ); - } - $extra = _user_forms($null, $null, $null, 'register'); - - // Only display form_group around default fields if there are other groups. - if ($extra) { - $form['account'] = array('#type' => 'fieldset', '#title' => t('Account information')); - $form['account']['name'] = $form['name']; - $form['account']['mail'] = $form['mail']; - $form['account']['pass'] = $form['pass']; - $form['account']['notify'] = $form['notify']; - unset($form['name'], $form['mail'], $form['pass'], $form['notify']); - $form = array_merge($form, $extra); - } - $form['submit'] = array('#type' => 'submit', '#value' => t('Create new account'), '#weight' => 30); - - return drupal_get_form('user_register', $form); -} - -function user_register_validate($form_id, $form_values) { - user_module_invoke('validate', $form_values, $form_values, 'account'); -} - -function user_register_submit($form_id, $form_values) { - global $base_url; - - $admin = user_access('administer users'); - - $mail = $form_values['mail']; - $name = $form_values['name']; - $pass = $admin ? $form_values['pass'] : user_password(); - $notify = $form_values['notify']; - $from = variable_get('site_mail', ini_get('sendmail_from')); - - if (!$admin && array_intersect(array_keys($form_values), array('uid', 'roles', 'init', 'session', 'status'))) { - watchdog('security', t('Detected malicious attempt to alter protected user fields.'), WATCHDOG_WARNING); - return 'user/register'; - } - - $account = user_save('', array_merge($form_values, array('pass' => $pass, 'init' => $mail, 'status' => ($admin || variable_get('user_register', 1) == 1)))); - watchdog('user', t('New user: %name %email.', array('%name' => theme('placeholder', $name), '%email' => theme('placeholder', '<'. $mail .'>'))), WATCHDOG_NOTICE, l(t('edit'), 'user/'. $account->uid .'/edit')); - - $variables = array('%username' => $name, '%site' => variable_get('site_name', 'drupal'), '%password' => $pass, '%uri' => $base_url, '%uri_brief' => substr($base_url, strlen('http://')), '%mailto' => $mail, '%date' => format_date(time()), '%login_uri' => url('user', NULL, NULL, TRUE), '%edit_uri' => url('user/'. $account->uid .'/edit', NULL, NULL, TRUE), '%login_url' => user_pass_reset_url($account)); - - // The first user may login immediately, and receives a customized welcome e-mail. - if ($account->uid == 1) { - user_mail($mail, t('Drupal user account details for %s', array('%s' => $name)), strtr(t("%username,\n\nYou may now login to %uri using the following username and password:\n\n username: %username\n password: %password\n\n%edit_uri\n\n--drupal"), $variables), "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - drupal_set_message(t('Welcome to Drupal. You are user #1, which gives you full and immediate access. All future registrants will receive their passwords via e-mail, so please make sure your website e-mail address is set properly under the general settings on the settings page.
Your password is %pass. You may change your password below.
', array('%pass' => $pass, '%settings' => url('admin/settings')))); - user_authenticate($account->name, trim($pass)); - - // Set the installed schema version of the system module to the most recent version. - include_once './includes/install.inc'; - drupal_set_installed_schema_version('system', max(drupal_get_schema_versions('system'))); - - return 'user/1/edit'; - } - else { - if ($admin && !$notify) { - drupal_set_message(t('Created a new user account. No e-mail has been sent.')); - - return 'admin/user'; - } - else if ($account->status || $notify) { - // Create new user account, no administrator approval required. - $subject = $notify ? _user_mail_text('admin_subject', $variables) : _user_mail_text('welcome_subject', $variables); - $body = $notify ? _user_mail_text('admin_body', $variables) : _user_mail_text('welcome_body', $variables); - - user_mail($mail, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - - if ($notify) { - drupal_set_message(t('Password and further instructions have been e-mailed to the new user %user.', array('%user' => theme('placeholder', $name)))); - return 'admin/user'; - } - else { - drupal_set_message(t('Your password and further instructions have been sent to your e-mail address.')); - return ''; - } - } - else { - // Create new user account, administrator approval required. - $subject = _user_mail_text('approval_subject', $variables); - $body = _user_mail_text('approval_body', $variables); - - user_mail($mail, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - user_mail(variable_get('site_mail', ini_get('sendmail_from')), $subject, t("%u has applied for an account.\n\n%uri", array('%u' => $account->name, '%uri' => url("user/$account->uid/edit", NULL, NULL, TRUE))), "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - drupal_set_message(t('Thank you for applying for an account. Your account is currently pending approval by the site administrator.
In the meantime, your password and further instructions have been sent to your e-mail address.')); - - } - } -} - -function user_edit_form($uid, $edit) { - // Account information: - $form['account'] = array('#type' => 'fieldset', - '#title' => t('Account information'), - ); - if (user_access('change own username') || user_access('administer users')) { - $form['account']['name'] = array('#type' => 'textfield', - '#title' => t('Username'), - '#default_value' => $edit['name'], - '#maxlength' => 60, - '#description' => t('Your full name or your preferred username: only letters, numbers and spaces are allowed.'), - '#required' => TRUE, - ); - } - $form['account']['mail'] = array('#type' => 'textfield', - '#title' => t('E-mail address'), - '#default_value' => $edit['mail'], - '#maxlength' => 64, - '#description' => t('Insert a valid e-mail address. All e-mails from the system will be sent to this address. The e-mail address is not made public and will only be used if you wish to receive a new password or wish to receive certain news or notifications by e-mail.'), - '#required' => TRUE, - ); - $form['account']['pass'] = array('#type' => 'password_confirm', - '#title' => t('Password'), - '#description' => t('To change the current user password, enter the new password in both fields.'), - ); - if (user_access('administer users')) { - $form['account']['status'] = array('#type' => 'radios', '#title' => t('Status'), '#default_value' => $edit['status'], '#options' => array(t('Blocked'), t('Active'))); - } - if (user_access('administer access control')) { - $roles = user_roles(1); - unset($roles[DRUPAL_AUTHENTICATED_RID]); - if ($roles) { - $form['account']['roles'] = array('#type' => 'checkboxes', '#title' => t('Roles'), '#default_value' => array_keys((array)$edit['roles']), '#options' => $roles, '#description' => t('The user receives the combined permissions of the %au role, and all roles selected here.', array('%au' => theme('placeholder', t('authenticated user'))))); - } - } - - // Picture/avatar: - if (variable_get('user_pictures', 0)) { - $form['picture'] = array('#type' => 'fieldset', '#title' => t('Picture'), '#weight' => 1); - $picture = theme('user_picture', (object)$edit); - if ($picture) { - $form['picture']['current_picture'] = array('#type' => 'markup', '#value' => $picture); - $form['picture']['picture_delete'] = array('#type' => 'checkbox', '#title' => t('Delete picture'), '#description' => t('Check this box to delete your current picture.')); - } else { - $form['picture']['picture_delete'] = array('#type' => 'hidden'); - } - $form['picture']['picture_upload'] = array('#type' => 'file', '#title' => t('Upload picture'), '#size' => 48, '#description' => t('Your virtual face or picture. Maximum dimensions are %dimensions and the maximum size is %size kB.', array('%dimensions' => variable_get('user_picture_dimensions', '85x85'), '%size' => variable_get('user_picture_file_size', '30'))) .' '. variable_get('user_picture_guidelines', '')); - } - - return $form; -} - -function _user_edit_validate($uid, &$edit) { - $user = user_load(array('uid' => $uid)); - // Validate the username: - if (user_access('change own username') || user_access('administer users') || arg(1) == 'register') { - if ($error = user_validate_name($edit['name'])) { - form_set_error('name', $error); - } - else if (db_num_rows(db_query("SELECT uid FROM {users} WHERE uid != %d AND LOWER(name) = LOWER('%s')", $uid, $edit['name'])) > 0) { - form_set_error('name', t('The name %name is already taken.', array('%name' => theme('placeholder', $edit['name'])))); - } - else if (drupal_is_denied('user', $edit['name'])) { - form_set_error('name', t('The name %name has been denied access.', array('%name' => theme('placeholder', $edit['name'])))); - } - } - - // Validate the e-mail address: - if ($error = user_validate_mail($edit['mail'])) { - form_set_error('mail', $error); - } - else if (db_num_rows(db_query("SELECT uid FROM {users} WHERE uid != %d AND LOWER(mail) = LOWER('%s')", $uid, $edit['mail'])) > 0) { - form_set_error('mail', t('The e-mail address %email is already taken.', array('%email' => theme('placeholder', $edit['mail'])))); - } - else if (drupal_is_denied('mail', $edit['mail'])) { - form_set_error('mail', t('The e-mail address %email has been denied access.', array('%email' => theme('placeholder', $edit['mail'])))); - } - - // If required, validate the uploaded picture. - if ($file = file_check_upload('picture_upload')) { - user_validate_picture($file, $edit, $user); - } -} - -function _user_edit_submit($uid, &$edit) { - $user = user_load(array('uid' => $uid)); - // Delete picture if requested, and if no replacement picture was given. - if ($edit['picture_delete']) { - if ($user->picture && file_exists($user->picture)) { - file_delete($user->picture); - } - $edit['picture'] = ''; - } - if (isset($edit['roles'])) { - $edit['roles'] = array_filter($edit['roles']); - } -} - -function user_edit($category = 'account') { - global $user; - - $account = user_load(array('uid' => arg(1))); - $edit = $_POST['op'] ? $_POST['edit'] : (array)$account; - - if (arg(2) == 'delete') { - if ($edit['confirm']) { - db_query('DELETE FROM {users} WHERE uid = %d', $account->uid); - db_query('DELETE FROM {sessions} WHERE uid = %d', $account->uid); - db_query('DELETE FROM {users_roles} WHERE uid = %d', $account->uid); - db_query('DELETE FROM {authmap} WHERE uid = %d', $account->uid); - watchdog('user', t('Deleted user: %name %email.', array('%name' => theme('placeholder', $account->name), '%email' => theme('placeholder', '<'. $account->mail .'>'))), WATCHDOG_NOTICE); - drupal_set_message(t('The account has been deleted.')); - module_invoke_all('user', 'delete', $edit, $account); - drupal_goto('admin/user'); - } - else { - return confirm_form('user_confirm_delete', array(), t('Are you sure you want to delete the account %name?', array('%name' => theme('placeholder', $account->name))), 'user/'. $account->uid, t('All submissions made by this user will be attributed to the anonymous account. This action cannot be undone.'), t('Delete'), t('Cancel')); - } - } - else if ($_POST['op'] == t('Delete')) { - if ($_REQUEST['destination']) { - $destination = drupal_get_destination(); - unset($_REQUEST['destination']); - } - // Note: we redirect from user/uid/edit to user/uid/delete to make the tabs disappear. - drupal_goto("user/$account->uid/delete", $destination); - } - - $form = _user_forms($edit, $account, $category); - $form['_category'] = array('#type' => 'value', '#value' => $category); - $form['_account'] = array('#type' => 'value', '#value' => $account); - $form['submit'] = array('#type' => 'submit', '#value' => t('Submit'), '#weight' => 30); - if (user_access('administer users')) { - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete'), '#weight' => 31); - } - $form['#attributes'] = array('enctype' => 'multipart/form-data'); - - drupal_set_title($account->name); - return drupal_get_form('user_edit', $form); -} - -function user_edit_validate($form_id, $form_values) { - user_module_invoke('validate', $form_values, $form_values['_account'], $form_values['_category']); - // Validate input to ensure that non-privileged users can't alter protected data. - if ((!user_access('administer users') && array_intersect(array_keys($form_values), array('uid', 'init', 'session'))) || (!user_access('administer access control') && isset($form_values['roles']))) { - $message = t('Detected malicious attempt to alter protected user fields.'); - watchdog('security', $message, WATCHDOG_WARNING); - // set this to a value type field - form_set_error('category', $message); - } -} - -function user_edit_submit($form_id, $form_values) { - $account = $form_values['_account']; - $category = $form_values['_category']; - unset($form_values['_account'], $form_values['submit'], $form_values['delete'], $form_values['form_id'], $form_values['_category']); - user_module_invoke('submit', $form_values, $account, $category); - user_save($account, $form_values, $category); - // Delete that user's menu cache. - cache_clear_all('menu:'. $account->uid, TRUE); - drupal_set_message(t('The changes have been saved.')); - return 'user/'. $account->uid; -} - -function user_view($uid = 0) { - global $user; - - $account = user_load(array('uid' => $uid)); - if ($account === FALSE) { - return drupal_not_found(); - } - // Retrieve and merge all profile fields: - $fields = array(); - foreach (module_list() as $module) { - if ($data = module_invoke($module, 'user', 'view', '', $account)) { - foreach ($data as $category => $items) { - foreach ($items as $item) { - $item['class'] = "$module-". $item['class']; - $fields[$category][] = $item; - } - } - } - } - drupal_set_title($account->name); - return theme('user_profile', $account, $fields); -} - -/*** Administrative features ***********************************************/ - -function _user_mail_text($messageid, $variables = array()) { - - // Check if an admin setting overrides the default string. - if ($admin_setting = variable_get('user_mail_' . $messageid, FALSE)) { - return strtr($admin_setting, $variables); - } - // No override, return with default strings. - else { - switch ($messageid) { - case 'welcome_subject': - return t('Account details for %username at %site', $variables); - case 'welcome_body': - return t("%username,\n\nThank you for registering at %site. You may now log in to %login_uri using the following username and password:\n\nusername: %username\npassword: %password\n\nYou may also log in by clicking on this link or copying and pasting it in your browser:\n\n%login_url\n\nThis is a one-time login, so it can be used only once.\n\nAfter logging in, you will be redirected to %edit_uri so you can change your password.\n\nYour new %site membership also enables to you to login to other Drupal powered websites (e.g. http://drupal.org/) without registering. Just use the following Drupal ID and password:\n\nDrupal ID: %username@%uri_brief\npassword: %password\n\n\n-- %site team", $variables); - case 'admin_subject': - return t('An administrator created an account for you at %site', $variables); - case 'admin_body': - return t("%username,\n\nA site administrator at %site has created an account for you. You may now log in to %login_uri using the following username and password:\n\nusername: %username\npassword: %password\n\nYou may also log in by clicking on this link or copying and pasting it in your browser:\n\n%login_url\n\nThis is a one-time login, so it can be used only once.\n\nAfter logging in, you will be redirected to %edit_uri so you can change your password.\n\nYour new %site membership also enables to you to login to other Drupal powered websites (e.g. http://www.drupal.org/) without registering. Just use the following Drupal ID and password:\n\nDrupal ID: %username@%uri_brief\npassword: %password\n\n\n-- %site team", $variables); - case 'approval_subject': - return t('Account details for %username at %site (pending admin approval)', $variables); - case 'approval_body': - return t("%username,\n\nThank you for registering at %site. Your application for an account is currently pending approval. Once it has been granted, you may log in to %login_uri using the following username and password:\n\nusername: %username\npassword: %password\n\nYou may also log in by clicking on this link or copying and pasting it in your browser:\n\n%login_url\n\nThis is a one-time login, so it can be used only once.\n\nAfter logging in, you may wish to change your password at %edit_uri\n\nYour new %site membership also enables to you to login to other Drupal powered websites (e.g. http://www.drop.org/) without registering. Just use the following Drupal ID and password:\n\nDrupal ID: %username@%uri_brief\npassword: %password\n\n\n-- %site team", $variables); - case 'pass_subject': - return t('Replacement login information for %username at %site', $variables); - case 'pass_body': - return t("%username,\n\nA request to reset the password for your account has been made at %site.\n\nYou may now log in to %uri_brief clicking on this link or copying and pasting it in your browser:\n\n%login_url\n\nThis is a one-time login, so it can be used only once. It expires after one day and nothing will happen if it's not used.\n\nAfter logging in, you will be redirected to %edit_uri so you can change your password.", $variables); - } - } -} - -function user_configure_settings() { -} - -/** - * Menu callback: check an access rule - */ -function user_admin_access_check() { - $form['user'] = array('#type' => 'fieldset', '#title' => t('Username')); - $form['user']['test'] = array('#type' => 'textfield', '#title' => '', '#description' => t('Enter a username to check if it will be denied or allowed.'), '#size' => 30, '#maxlength' => 64); - $form['user']['type'] = array('#type' => 'hidden', '#value' => 'user'); - $form['user']['submit'] = array('#type' => 'submit', '#value' => t('Check username')); - $output .= drupal_get_form('check_user', $form, 'user_admin_access_check'); - unset($form); // prevent endless loop? - - $form['mail'] = array('#type' => 'fieldset', '#title' => t('E-mail')); - $form['mail']['test'] = array('#type' => 'textfield', '#title' => '', '#description' => t('Enter an e-mail address to check if it will be denied or allowed.'), '#size' => 30, '#maxlength' => 64); - $form['mail']['type'] = array('#type' => 'hidden', '#value' => 'mail'); - $form['mail']['submit'] = array('#type' => 'submit', '#value' => t('Check e-mail')); - $output .= drupal_get_form('check_mail', $form, 'user_admin_access_check'); - unset($form); // prevent endless loop? - - $form['host'] = array('#type' => 'fieldset', '#title' => t('Hostname')); - $form['host']['test'] = array('#type' => 'textfield', '#title' => '', '#description' => t('Enter a hostname or IP address to check if it will be denied or allowed.'), '#size' => 30, '#maxlength' => 64); - $form['host']['type'] = array('#type' => 'hidden', '#value' => 'host'); - $form['host']['submit'] = array('#type' => 'submit', '#value' => t('Check hostname')); - $output .= drupal_get_form('check_host', $form, 'user_admin_access_check'); - unset($form); // prevent endless loop? - - return $output; -} - -function user_admin_access_check_validate($form_id, $edit) { - if (empty($edit['test'])) { - form_set_error($edit['type'], t('No value entered. Please enter a test string and try again.')); - } -} - -function user_admin_access_check_submit($form_id, $edit) { - switch ($edit['type']) { - case 'user': - if (drupal_is_denied('user', $edit['test'])) { - drupal_set_message(t('The username %name is not allowed.', array('%name' => theme('placeholder', $edit['test'])))); - } - else { - drupal_set_message(t('The username %name is allowed.', array('%name' => theme('placeholder', $edit['test'])))); - } - break; - case 'mail': - if (drupal_is_denied('mail', $edit['test'])) { - drupal_set_message(t('The e-mail address %mail is not allowed.', array('%mail' => theme('placeholder', $edit['test'])))); - } - else { - drupal_set_message(t('The e-mail address %mail is allowed.', array('%mail' => theme('placeholder', $edit['test'])))); - } - break; - case 'host': - if (drupal_is_denied('host', $edit['test'])) { - drupal_set_message(t('The hostname %host is not allowed.', array('%host' => theme('placeholder', $edit['test'])))); - } - else { - drupal_set_message(t('The hostname %host is allowed.', array('%host' => theme('placeholder', $edit['test'])))); - } - break; - default: - break; - } -} - -/** - * Menu callback: add an access rule - */ -function user_admin_access_add($mask = NULL, $type = NULL) { - if ($edit = $_POST['edit']) { - if (!$edit['mask']) { - form_set_error('mask', t('You must enter a mask.')); - } - else { - $aid = db_next_id('{access}_aid'); - db_query("INSERT INTO {access} (aid, mask, type, status) VALUES ('%s', '%s', '%s', %d)", $aid, $edit['mask'], $edit['type'], $edit['status']); - drupal_set_message(t('The access rule has been added.')); - drupal_goto('admin/access/rules'); - } - } - else { - $edit['mask'] = $mask; - $edit['type'] = $type; - } - - $form = _user_admin_access_form($edit); - $form['submit'] = array('#type' => 'submit', '#value' => t('Add rule')); - - return drupal_get_form('access_rule', $form); -} - -/** - * Menu callback: delete an access rule - */ -function user_admin_access_delete($aid = 0) { - $access_types = array('user' => t('username'), 'mail' => t('e-mail')); - $edit = db_fetch_object(db_query('SELECT aid, type, status, mask FROM {access} WHERE aid = %d', $aid)); - - $form = array(); - $form['aid'] = array('#type' => 'hidden', '#value' => $aid); - $output = confirm_form('user_admin_access_delete_confirm', $form, - t('Are you sure you want to delete the %type rule for %rule?', array('%type' => $access_types[$edit->type], '%rule' => theme('placeholder', $edit->mask))), - 'admin/access/rules', - t('This action cannot be undone.'), - t('Delete'), - t('Cancel')); - return $output; -} - -function user_admin_access_delete_confirm_submit($form_id, $edit) { - db_query('DELETE FROM {access} WHERE aid = %d', $edit['aid']); - drupal_set_message(t('The access rule has been deleted.')); - return 'admin/access/rules'; -} - -/** - * Menu callback: edit an access rule - */ -function user_admin_access_edit($aid = 0) { - if ($edit = $_POST['edit']) { - if (!$edit['mask']) { - form_set_error('mask', t('You must enter a mask.')); - } - else { - db_query("UPDATE {access} SET mask = '%s', type = '%s', status = '%s' WHERE aid = %d", $edit['mask'], $edit['type'], $edit['status'], $aid); - drupal_set_message(t('The access rule has been saved.')); - drupal_goto('admin/access/rules'); - } - } - else { - $edit = db_fetch_array(db_query('SELECT aid, type, status, mask FROM {access} WHERE aid = %d', $aid)); - } - $form = _user_admin_access_form($edit); - $form['submit'] = array('#type' => 'submit', '#value' => t('Save rule')); - - return drupal_get_form('access_rule', $form); -} - -function _user_admin_access_form($edit) { - $form['status'] = array( - '#type' => 'radios', - '#title' => t('Access type'), - '#default_value' => 0, - '#options' => array('1' => t('Allow'), '0' => t('Deny')), - ); - $type_options = array('user' => t('Username'), 'mail' => t('E-mail'), 'host' => t('Host')); - $form['type'] = array( - '#type' => 'radios', - '#title' => t('Rule type'), - '#default_value' => (isset($type_options[$edit['type']]) ? $edit['type'] : 'user'), - '#options' => $type_options, - ); - $form['mask'] = array( - '#type' => 'textfield', - '#title' => t('Mask'), - '#size' => 30, - '#maxlength' => 64, - '#default_value' => $edit['mask'], - '#description' => '%: '. t('Matches any number of characters, even zero characters') .'.
_: '. t('Matches exactly one character.'), - '#required' => TRUE, - ); - return $form; -} - -/** - * Menu callback: list all access rules - */ -function user_admin_access() { - $header = array(array('data' => t('Access type'), 'field' => 'status'), array('data' => t('Rule type'), 'field' => 'type'), array('data' =>t('Mask'), 'field' => 'mask'), array('data' => t('Operations'), 'colspan' => 2)); - $result = db_query("SELECT aid, type, status, mask FROM {access}". tablesort_sql($header)); - $access_types = array('user' => t('username'), 'mail' => t('e-mail'), 'host' => t('host')); - $rows = array(); - while ($rule = db_fetch_object($result)) { - $rows[] = array($rule->status ? t('allow') : t('deny'), $access_types[$rule->type], $rule->mask, l(t('edit'), 'admin/access/rules/edit/'. $rule->aid), l(t('delete'), 'admin/access/rules/delete/'. $rule->aid)); - } - if (count($rows) == 0) { - $rows[] = array(array('data' => ''. t('There are currently no access rules.') .'', 'colspan' => 5)); - } - $output .= theme('table', $header, $rows); - - return $output; -} - -function user_roles($membersonly = 0, $permission = 0) { - $roles = array(); - - if ($permission) { - $result = db_query("SELECT r.* FROM {role} r INNER JOIN {permission} p ON r.rid = p.rid WHERE p.perm LIKE '%%%s%%' ORDER BY r.name", $permission); - } - else { - $result = db_query('SELECT * FROM {role} ORDER BY name'); - } - while ($role = db_fetch_object($result)) { - if (!$membersonly || ($membersonly && $role->rid != DRUPAL_ANONYMOUS_RID)) { - $roles[$role->rid] = $role->name; - } - } - return $roles; -} - -/** - * Menu callback: administer permissions. - */ -function user_admin_perm($str_rids = NULL) { - if (preg_match('/^([0-9]+[+ ])*[0-9]+$/', $str_rids)) { - // The '+' character in a query string may be parsed as ' '. - $rids = preg_split('/[+ ]/', $str_rids); - } - - if($rids) { - $breadcrumbs = drupal_get_breadcrumb(); - $breadcrumbs[] = l(t('all roles'), 'admin/access'); - drupal_set_breadcrumb($breadcrumbs); - $result = db_query('SELECT r.rid, p.perm FROM {role} r LEFT JOIN {permission} p ON r.rid = p.rid WHERE r.rid IN (%s) ORDER BY name', implode(', ', $rids)); - } - else { - $result = db_query('SELECT r.rid, p.perm FROM {role} r LEFT JOIN {permission} p ON r.rid = p.rid ORDER BY name'); - } - - // Compile role array: - $roles = array(); - while ($role = db_fetch_object($result)) { - $role_permissions[$role->rid] = $role->perm; - } - - if($rids) { - $result = db_query('SELECT rid, name FROM {role} r WHERE r.rid IN (%s) ORDER BY name', implode(', ', $rids)); - } - else { - $result = db_query('SELECT rid, name FROM {role} ORDER BY name'); - } - $role_names = array(); - while ($role = db_fetch_object($result)) { - $role_names[$role->rid] = $role->name; - } - - // Render role/permission overview: - $options = array(); - foreach (module_list(FALSE, FALSE, TRUE) as $module) { - if ($permissions = module_invoke($module, 'perm')) { - $form['permission'][] = array('#type' => 'markup', '#value' => t('%module module', array('%module' => $module))); - asort($permissions); - foreach ($permissions as $perm) { - $options[$perm] = ''; - $form['permission'][$perm] = array('#type' => 'markup', '#value' => t($perm)); - foreach ($role_names as $rid => $name) { - // Builds arrays for checked boxes for each role - if (strstr($role_permissions[$rid], $perm)) { - $status[$rid][] = $perm; - } - } - } - } - } - // Have to build checkboxes here after checkbox arrays are built - foreach ($role_names as $rid => $name) { - $form['checkboxes'][$rid] = array('#type' => 'checkboxes', '#options' => $options, '#default_value' => $status[$rid]); - $form['role_names'][$rid] = array('#type' => 'markup', '#value' => l($name, 'admin/access/'. $rid), '#tree' => TRUE); - } - $form['submit'] = array('#type' => 'submit', '#value' => t('Save permissions')); - - return drupal_get_form('user_admin_perm', $form); -} - -function theme_user_admin_perm($form) { - foreach (element_children($form['permission']) as $key) { - // Don't take form control structures - if (is_array($form['permission'][$key])) { - $row = array(); - // Module name - if (is_numeric($key)) { - $row[] = array('data' => form_render($form['permission'][$key]), 'class' => 'module', 'colspan' => count($form['role_names']) + 1); - // Permissions - } - else { - $row[] = array('data' => form_render($form['permission'][$key]), 'class' => 'permission'); - foreach (element_children($form['checkboxes']) as $rid) { - if (is_array($form['checkboxes'][$rid])) { - $row[] = array('data' => form_render($form['checkboxes'][$rid][$key]), 'align' => 'center', 'title' => t($key)); - } - } - } - $rows[] = $row; - } - } - $header[] = (t('Permission')); - foreach (element_children($form['role_names']) as $rid) { - if (is_array($form['role_names'][$rid])) { - $header[] = form_render($form['role_names'][$rid]); - } - } - $output = theme('table', $header, $rows, array('id' => 'permissions')); - $output .= form_render($form); - return $output; -} - -function user_admin_perm_submit($form_id, $edit) { - // Save permissions: - $result = db_query('SELECT * FROM {role}'); - while ($role = db_fetch_object($result)) { - if(isset($edit[$role->rid])) { - // Delete, so if we clear every checkbox we reset that role; - // otherwise permissions are active and denied everywhere. - db_query('DELETE FROM {permission} WHERE rid = %d', $role->rid); - foreach ($edit[$role->rid] as $key => $value) { - if (!$value) { - unset($edit[$role->rid][$key]); - } - } - if (count($edit[$role->rid])) { - db_query("INSERT INTO {permission} (rid, perm) VALUES (%d, '%s')", $role->rid, implode(', ', array_keys($edit[$role->rid]))); - } - } - } - - drupal_set_message(t('The changes have been saved.')); - - // Clear the cached pages and menus: - menu_rebuild(); - -} - -/** - * Menu callback: administer roles. - */ -function user_admin_role() { - $edit = isset($_POST['edit']) ? $_POST['edit'] : ''; - $op = isset($_POST['op']) ? $_POST['op'] : ''; - $id = arg(4); - - if ($op == t('Save role')) { - if ($edit['name']) { - db_query("UPDATE {role} SET name = '%s' WHERE rid = %d", $edit['name'], $id); - drupal_set_message(t('The changes have been saved.')); - drupal_goto('admin/access/roles'); - } - else { - form_set_error('name', t('You must specify a valid role name.')); - } - } - else if ($op == t('Delete role')) { - db_query('DELETE FROM {role} WHERE rid = %d', $id); - db_query('DELETE FROM {permission} WHERE rid = %d', $id); - - // Update the users who have this role set: - $result = db_query('SELECT DISTINCT(ur1.uid) FROM {users_roles} ur1 LEFT JOIN {users_roles} ur2 ON ur2.uid = ur1.uid WHERE ur1.rid = %d AND ur2.rid != ur1.rid', $id); - $uid = array(); - - while ($u = db_fetch_object($result)) { - $uid[] = $u->uid; - } - - if ($uid) { - db_query('DELETE FROM {users_roles} WHERE rid = %d AND uid IN (%s)', $id, implode(', ', $uid)); - } - - drupal_set_message(t('The role has been deleted.')); - drupal_goto('admin/access/roles'); - } - else if ($op == t('Add role')) { - if ($edit['name']) { - db_query("INSERT INTO {role} (name) VALUES ('%s')", $edit['name']); - drupal_set_message(t('The role has been added.')); - drupal_goto('admin/access/roles'); - } - else { - form_set_error('name', t('You must specify a valid role name.')); - } - } - else if ($id) { - // Display the role form. - $role = db_fetch_object(db_query('SELECT * FROM {role} WHERE rid = %d', $id)); - $form['name'] = array('#type' => 'textfield', '#title' => t('Role name'), '#default_value' => $role->name, '#size' => 30, '#maxlength' => 64, '#description' => t('The name for this role. Example: "moderator", "editorial board", "site architect".')); - $form['submit'] = array('#type' => 'submit', '#value' => t('Save role')); - $form['delete'] = array('#type' => 'submit', '#value' => t('Delete role')); - return drupal_get_form('user_admin_role', $form); - } - $form['name'] = array('#type' => 'textfield', '#size' => 32, '#maxlength' => 64); - $form['submit'] = array('#type' => 'submit', '#value' => t('Add role')); - return drupal_get_form('user_admin_new_role', $form); -} - -function theme_user_admin_new_role($form) { - $header = array(t('Name'), t('Operations')); - foreach (user_roles() as $rid => $name) { - if (!in_array($rid, array(DRUPAL_ANONYMOUS_RID, DRUPAL_AUTHENTICATED_RID))) { - $rows[] = array($name, l(t('edit'), 'admin/access/roles/edit/'. $rid)); - } - else { - $rows[] = array($name, ''. t('locked') .''); - } - } - $rows[] = array(form_render($form['name']), form_render($form['submit'])); - - return theme('table', $header, $rows); -} - -function user_admin_account() { - $header = array( - array('data' => t('Username'), 'field' => 'u.name'), - array('data' => t('Status'), 'field' => 'u.status'), - array('data' => t('Member for'), 'field' => 'u.created', 'sort' => 'desc'), - array('data' => t('Last access'), 'field' => 'u.access'), - t('Operations') - ); - $sql = 'SELECT u.uid, u.name, u.status, u.created, u.access FROM {users} u WHERE uid != 0'; - $sql .= tablesort_sql($header); - $result = pager_query($sql, 50); - - $status = array(t('blocked'), t('active')); - while ($account = db_fetch_object($result)) { - $rows[] = array(theme('username', $account), - $status[$account->status], - format_interval(time() - $account->created), - $account->access ? t('%time ago', array('%time' => format_interval(time() - $account->access))) : t('never'), - l(t('edit'), "user/$account->uid/edit", array())); - } - - $output = theme('table', $header, $rows); - $output .= theme('pager', NULL, 50, 0, tablesort_pager()); - return $output; -} - -function user_configure() { - // User registration settings. - $form['registration'] = array('#type' => 'fieldset', '#title' => t('User registration settings')); - $form['registration']['user_register'] = array('#type' => 'radios', '#title' => t('Public registrations'), '#default_value' => variable_get('user_register', 1), '#options' => array(t('Only site administrators can create new user accounts.'), t('Visitors can create accounts and no administrator approval is required.'), t('Visitors can create accounts but administrator approval is required.'))); - $form['registration']['user_registration_help'] = array('#type' => 'textarea', '#title' => t('User registration guidelines'), '#default_value' => variable_get('user_registration_help', ''), '#description' => t('This text is displayed at the top of the user registration form. It\'s useful for helping or instructing your users.')); - - // User e-mail settings. - $form['email'] = array('#type' => 'fieldset', '#title' => t('User e-mail settings')); - $form['email']['user_mail_welcome_subject'] = array('#type' => 'textfield', '#title' => t('Subject of welcome e-mail'), '#default_value' => _user_mail_text('welcome_subject'), '#maxlength' => 180, '#description' => t('Customize the subject of your welcome e-mail, which is sent to new members upon registering.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %date, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_welcome_body'] = array('#type' => 'textarea', '#title' => t('Body of welcome e-mail'), '#default_value' => _user_mail_text('welcome_body'), '#rows' => 15, '#description' => t('Customize the body of the welcome e-mail, which is sent to new members upon registering.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_admin_subject'] = array('#type' => 'textfield', '#title' => t('Subject of welcome e-mail (user created by administrator)'), '#default_value' => _user_mail_text('admin_subject'), '#maxlength' => 180, '#description' => t('Customize the subject of your welcome e-mail, which is sent to new member accounts created by an administrator.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %date, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_admin_body'] = array('#type' => 'textarea', '#title' => t('Body of welcome e-mail (user created by administrator)'), '#default_value' => _user_mail_text('admin_body'), '#rows' => 15, '#description' => t('Customize the body of the welcome e-mail, which is sent to new member accounts created by an administrator.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_approval_subject'] = array('#type' => 'textfield', '#title' => t('Subject of welcome e-mail (awaiting admin approval)'), '#default_value' => _user_mail_text('approval_subject'), '#maxlength' => 180, '#description' => t('Customize the subject of your awaiting approval welcome e-mail, which is sent to new members upon registering.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %date, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_approval_body'] = array('#type' => 'textarea', '#title' => t('Body of welcome e-mail (awaiting admin approval)'), '#default_value' => _user_mail_text('approval_body'), '#rows' => 15, '#description' => t('Customize the body of the awaiting approval welcome e-mail, which is sent to new members upon registering.') .' '. t('Available variables are:') .' %username, %site, %password, %uri, %uri_brief, %mailto, %login_uri, %edit_uri, %login_url.'); - $form['email']['user_mail_pass_subject'] = array('#type' => 'textfield', '#title' => t('Subject of password recovery e-mail'), '#default_value' => _user_mail_text('pass_subject'), '#maxlength' => 180, '#description' => t('Customize the Subject of your forgotten password e-mail.') .' '. t('Available variables are:') .' %username, %site, %login_url, %uri, %uri_brief, %mailto, %date, %login_uri, %edit_uri.'); - $form['email']['user_mail_pass_body'] = array('#type' => 'textarea', '#title' => t('Body of password recovery e-mail'), '#default_value' => _user_mail_text('pass_body'), '#rows' => 15, '#description' => t('Customize the body of the forgotten password e-mail.') .' '. t('Available variables are:') .' %username, %site, %login_url, %uri, %uri_brief, %mailto, %login_uri, %edit_uri.'); - - // If picture support is enabled, check whether the picture directory exists: - if (variable_get('user_pictures', 0)) { - $picture_path = file_create_path(variable_get('user_picture_path', 'pictures')); - file_check_directory($picture_path, 1, 'user_picture_path'); - } - - $form['pictures'] = array('#type' => 'fieldset', '#title' => t('Pictures')); - $form['pictures']['user_pictures'] = array('#type' => 'radios', '#title' => t('Picture support'), '#default_value' => variable_get('user_pictures', 0), '#options' => array(t('Disabled'), t('Enabled')), '#description' => t('Enable picture support.')); - $form['pictures']['user_picture_path'] = array('#type' => 'textfield', '#title' => t('Picture image path'), '#default_value' => variable_get('user_picture_path', 'pictures'), '#size' => 30, '#maxlength' => 255, '#description' => t('Subdirectory in the directory "%dir" where pictures will be stored.', array('%dir' => file_directory_path() .'/'))); - $form['pictures']['user_picture_default'] = array('#type' => 'textfield', '#title' => t('Default picture'), '#default_value' => variable_get('user_picture_default', ''), '#size' => 30, '#maxlength' => 255, '#description' => t('URL of picture to display for users with no custom picture selected. Leave blank for none.')); - $form['pictures']['user_picture_dimensions'] = array('#type' => 'textfield', '#title' => t('Picture maximum dimensions'), '#default_value' => variable_get('user_picture_dimensions', '85x85'), '#size' => 15, '#maxlength' => 10, '#description' => t('Maximum dimensions for pictures.')); - $form['pictures']['user_picture_file_size'] = array('#type' => 'textfield', '#title' => t('Picture maximum file size'), '#default_value' => variable_get('user_picture_file_size', '30'), '#size' => 15, '#maxlength' => 10, '#description' => t('Maximum file size for pictures, in kB.')); - $form['pictures']['user_picture_guidelines'] = array('#type' => 'textarea', '#title' => t('Picture guidelines'), '#default_value' => variable_get('user_picture_guidelines', ''), '#description' => t('This text is displayed at the picture upload form in addition to the default guidelines. It\'s useful for helping or instructing your users.')); - - return system_settings_form('user_configure_settings', $form); -} - -function user_admin() { - $edit = isset($_POST['edit']) ? $_POST['edit'] : ''; - $op = isset($_POST['op']) ? $_POST['op'] : ''; - - if (empty($op)) { - $op = arg(2); - } - - switch ($op) { - case 'search': - case t('Search'): - $output = search_form(url('admin/user/search'), $_POST['edit']['keys'], 'user') . search_data($_POST['edit']['keys'], 'user'); - break; - case t('Create new account'): - case 'create': - $output = user_register(); - break; - default: - $output = user_admin_account(); - } - return $output; -} - -/** - * Implementation of hook_help(). - */ -function user_help($section) { - global $user; - - switch ($section) { - case 'admin/help#user': - $output = ''. t('The user module allows users to register, login, and logout. Users benefit from being able to sign on because it associates content they create with their account and allows various permissions to be set for their roles. The user module supports user roles which can setup fine grained permissions allowing each role to do only what the administrator wants them to. Each user is assigned to one or more roles. By default there are two roles anonymous - a user who has not logged in, and authenticated a user who has signed up and who has been authorized. ') .'
'; - $output .= ''. t('Users can use their own name or handle and can fine tune some personal configuration settings through their individual my account page. Registered users need to authenticate by supplying either a local username and password, or a remote username and password such as DelphiForums ID, or one from a Drupal powered website. A visitor accessing your website is assigned an unique ID, the so-called session ID, which is stored in a cookie. For security\'s sake, the cookie does not contain personal information but acts as a key to retrieve the information stored on your server. ') .'
'; - $output .= t('You can
--
-
- view your user page. -
- administer users at administer >> user. -
- allow users who have the "select different theme" permission to select themes from their user account by enabling themes in administer >> themes. -
- read user profile help at administer >> help >> profile. -
- read about distributed authentication in the system module help at administer >> help >> system. -
'. t('For more information please read the configuration and customization handbook User page.', array('%user' => 'http://drupal.org/handbook/modules/user/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Manages the user registration and login system.'); - case 'admin/user': - return t('Drupal allows users to register, login, logout, maintain user profiles, etc. No participant can use his own name to post content until he signs up for a user account.
'); - case 'admin/user/create': - case 'admin/user/account/create': - return t('This web page allows the administrators to register a new users by hand. Note that you cannot have a user where either the e-mail address or the username match another user in the system.
'); - case strstr($section, 'admin/access/rules'): - return t('Set up username and e-mail address access rules for new and existing accounts (currently logged in accounts will not be logged out). If a username or e-mail address for an account matches any deny rule, but not an allow rule, then the account will not be allowed to be created or to log in. A host rule is effective for every page view, not just registrations.
'); - case 'admin/access': - return t('Permissions let you control what users can do on your site. Each user role (defined on the user roles page) has its own set of permissions. For example, you could give users classified as "Administrators" permission to "administer nodes" but deny this power to ordinary, "authenticated" users. You can use permissions to reveal new features to privileged users (those with subscriptions, for example). Permissions also allow trusted users to share the administrative burden of running a busy site.
', array('%role' => url('admin/access/roles'))); - case 'admin/access/roles': - return t('Roles allow you to fine tune the security and administration of Drupal. A role defines a group of users that have certain privileges as defined in user permissions. Examples of roles include: anonymous user, authenticated user, moderator, administrator and so on. In this area you will define the role names of the various roles. To delete a role choose "edit".
By default, Drupal comes with two user roles:
--
-
- Anonymous user: this role is used for users that don\'t have a user account or that are not authenticated. -
- Authenticated user: this role is automatically granted to all logged in users. -
Enter a simple pattern ("*" may be used as a wildcard match) to search for a username. For example, one may search for "br" and Drupal might return "brian", "brad", and "brenda".
'); - case 'admin/user/configure': - case 'admin/user/configure/settings': - return t('In order to use the full power of Drupal a visitor must sign up for an account. This page lets you setup how a user signs up, logs out, the guidelines from the system about user subscriptions, and the e-mails the system will send to the user.
'); - case 'user/help#user': - $site = variable_get('site_name', 'this website'); - - $output = t(" -Distributed authentication
-One of the more tedious moments in visiting a new website is filling out the registration form. Here at %site, you do not have to fill out a registration form if you are already a member of %help-links. This capability is called distributed authentication, and is unique to Drupal, the software which powers %site.
-Distributed authentication enables a new user to input a username and password into the login box, and immediately be recognized, even if that user never registered at %site. This works because Drupal knows how to communicate with external registration databases. For example, lets say that new user 'Joe' is already a registered member of Delphi Forums. Drupal informs Joe on registration and login screens that he may login with his Delphi ID instead of registering with %site. Joe likes that idea, and logs in with a username of joe@remote.delphiforums.com and his usual Delphi password. Drupal then contacts the remote.delphiforums.com server behind the scenes (usually using XML-RPC, HTTP POST, or SOAP) and asks: \"Is the password for user Joe correct?\". If Delphi replies yes, then we create a new %site account for Joe and log him into it. Joe may keep on logging into %site in the same manner, and he will always be logged into the same account.
", array('%help-links' => (implode(', ', user_auth_help_links())), '%site' => "$site", '%drupal' => 'http://drupal.org', '%delphi-forums' => 'http://www.delphiforums.com', '%xml' => 'http://www.xmlrpc.com', '%http-post' => 'http://www.w3.org/Protocols/', '%soap' => 'http://www.soapware.org')); - - foreach (module_list() as $module) { - if (module_hook($module, 'auth')) { - $output .= "". module_invoke($module, 'info', 'name') .'
'; - $output .= module_invoke($module, 'help', "user/help#$module"); - } - } - - return $output; - } - -} - -/** - * Menu callback; Prints user-specific help information. - */ -function user_help_page() { - return user_help('user/help#user'); -} - -/** - * Retrieve a list of all user setting/information categories and sort them by weight. - */ -function _user_categories() { - $categories = array(); - - foreach (module_list() as $module) { - if ($data = module_invoke($module, 'user', 'categories', NULL, NULL, '')) { - $categories = array_merge($data, $categories); - } - } - - usort($categories, '_user_sort'); - - return $categories; -} - -function _user_sort($a, $b) { - return $a['weight'] < $b['weight'] ? -1 : ($a['weight'] > $b['weight'] ? 1 : ($a['title'] < $b['title'] ? -1 : 1)); -} - -/** - * Retrieve a list of all form elements for the specified category. - */ -function _user_forms(&$edit, $account, $category, $hook = 'form') { - $groups = array(); - foreach (module_list() as $module) { - if ($data = module_invoke($module, 'user', $hook, $edit, $account, $category)) { - $groups = array_merge_recursive($data, $groups); - } - } - uasort($groups, '_user_sort'); - - return empty($groups) ? FALSE : $groups; -} - -/** - * Retrieve a pipe delimited string of autocomplete suggestions for existing users - */ -function user_autocomplete($string) { - $matches = array(); - $result = db_query_range("SELECT name FROM {users} WHERE LOWER(name) LIKE LOWER('%s%%')", $string, 0, 10); - while ($user = db_fetch_object($result)) { - $matches[$user->name] = check_plain($user->name); - } - print drupal_implode_autocomplete($matches); - exit(); -} diff --git a/modules/watchdog/watchdog.module b/modules/watchdog/watchdog.module deleted file mode 100644 index 0f620b2ccb4c4f9adb961db0ffa446f8a6fe1144..0000000000000000000000000000000000000000 --- a/modules/watchdog/watchdog.module +++ /dev/null @@ -1,194 +0,0 @@ -'. t('The watchdog module monitors your system, capturing system events in a log to be reviewed by an authorized individual at a later time. This is useful for site administrators who want a quick overview of activities on their site. The logs also record the sequence of events, so it can be useful for debugging site errors.') .''; - $output .= ''. t('The watchdog log is simply a list of recorded events containing usage data, performance data, errors, warnings and operational information. Administrators should check the watchdog report on a regular basis to ensure their site is working properly.') .'
'; - $output .= t('You can
--
-
- view watchdog logs at administer >> watchdog. -
- view watchdog event logs at administer >> watchdog >> events. -
'. t('For more information please read the configuration and customization handbook Watchdog page.', array('%watchdog' => 'http://drupal.org/handbook/modules/watchdog/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Logs and records system events.'); - case 'admin/logs': - return t('The watchdog module monitors your web site, capturing system events in a log to be reviewed by an authorized individual at a later time. The watchdog log is simply a list of recorded events containing usage data, performance data, errors, warnings and operational information. It is vital to check the watchdog report on a regular basis as it is often the only way to tell what is going on.
'); - } -} - -/** - * Implementation of hook_menu(). - */ -function watchdog_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/logs', 'title' => t('logs'), - 'callback' => 'watchdog_overview'); - $items[] = array('path' => 'admin/logs/event', 'title' => t('details'), - 'callback' => 'watchdog_event', - 'type' => MENU_CALLBACK); - } - return $items; -} - -/** - * Implementation of hook_cron(). - * - * Remove expired log messages and flood control events. - */ -function watchdog_cron() { - db_query('DELETE FROM {watchdog} WHERE timestamp < %d', time() - variable_get('watchdog_clear', 604800)); - db_query('DELETE FROM {flood} WHERE timestamp < %d', time() - 3600); -} - -/** - * Implementation of hook_user(). - */ -function watchdog_user($op, &$edit, &$user) { - if ($op == 'delete') { - db_query('UPDATE {watchdog} SET uid = 0 WHERE uid = %d', $user->uid); - } -} - -/** - * Menu callback; displays a listing of log messages. - */ -function watchdog_overview() { - $icons = array(WATCHDOG_NOTICE => '', - WATCHDOG_WARNING => theme('image', 'misc/watchdog-warning.png', t('warning'), t('warning')), - WATCHDOG_ERROR => theme('image', 'misc/watchdog-error.png', t('error'), t('error'))); - $classes = array(WATCHDOG_NOTICE => 'watchdog-notice', WATCHDOG_WARNING => 'watchdog-warning', WATCHDOG_ERROR => 'watchdog-error'); - - $names['all'] = t('all messages'); - foreach (_watchdog_get_message_types() as $type) { - $names[$type] = t('%type messages', array('%type' => t($type))); - } - - if (empty($_SESSION['watchdog_overview_filter'])) { - $_SESSION['watchdog_overview_filter'] = 'all'; - } - - $form['filter'] = array( - '#type' => 'select', - '#title' => t('Filter by message type'), - '#options' => $names, - '#default_value' => $_SESSION['watchdog_overview_filter'] - ); - $form['#action'] = url('admin/logs'); - - $form['submit'] = array('#type' => 'submit', '#value' =>t('Filter')); - $output = drupal_get_form('watchdog_form_overview', $form); - - $header = array( - ' ', - array('data' => t('Type'), 'field' => 'w.type'), - array('data' => t('Date'), 'field' => 'w.wid', 'sort' => 'desc'), - array('data' => t('Message'), 'field' => 'w.message'), - array('data' => t('User'), 'field' => 'u.name'), - array('data' => t('Operations')) - ); - - $sql = "SELECT w.*, u.name, u.uid FROM {watchdog} w INNER JOIN {users} u ON w.uid = u.uid"; - $tablesort = tablesort_sql($header); - $type = $_SESSION['watchdog_overview_filter']; - if ($type != 'all') { - $result = pager_query($sql ." WHERE w.type = '%s'". $tablesort, 50, 0, NULL, $type); - } - else { - $result = pager_query($sql . $tablesort, 50); - } - - while ($watchdog = db_fetch_object($result)) { - $rows[] = array('data' => - array( - // Cells - $icons[$watchdog->severity], - t($watchdog->type), - format_date($watchdog->timestamp, 'small'), - l(truncate_utf8($watchdog->message, 56, TRUE, TRUE), 'admin/logs/event/'. $watchdog->wid, array(), NULL, NULL, FALSE, TRUE), - theme('username', $watchdog), - $watchdog->link, - ), - // Attributes for tr - 'class' => "watchdog-". preg_replace('/[^a-z]/i', '-', $watchdog->type) .' '. $classes[$watchdog->severity] - ); - } - - if (!$rows) { - $rows[] = array(array('data' => t('No log messages available.'), 'colspan' => 6)); - } - - $output .= theme('table', $header, $rows); - $output .= theme('pager', NULL, 50, 0, tablesort_pager()); - - return $output; -} - -function theme_watchdog_form_overview($form) { - return ''. form_render($form) .''; -} - -function watchdog_form_overview_submit($form_id, $form) { - global $form_values; - $_SESSION['watchdog_overview_filter'] = $form_values['filter']; -} - -/** - * Menu callback; displays details about a log message. - */ -function watchdog_event($id) { - $severity = array(WATCHDOG_NOTICE => t('notice'), WATCHDOG_WARNING => t('warning'), WATCHDOG_ERROR => t('error')); - $output = ''; - $result = db_query('SELECT w.*, u.name, u.uid FROM {watchdog} w INNER JOIN {users} u ON w.uid = u.uid WHERE w.wid = %d', $id); - if ($watchdog = db_fetch_object($result)) { - $header = array(t('Type'), t('Date'), t('User'), t('Location'), t('Referrer'), t('Message'), t('Severity'), t('Hostname')); - $data = array(t($watchdog->type), format_date($watchdog->timestamp, 'large'), theme('username', $watchdog), l($watchdog->location, $watchdog->location), l($watchdog->referer, $watchdog->referer), $watchdog->message, $severity[$watchdog->severity], $watchdog->hostname); - $output = theme('watchdog_event', $header, $data); - } - return $output; -} - -function theme_watchdog_event($header, $data) { - $output = ''; - $output .= ''; - - $n = count($header); - for ($i = 0; $i < $n; $i++) { - $output .= '
'; - - return $output; -} - -function _watchdog_get_message_types() { - $types = array(); - - $result = db_query('SELECT DISTINCT(type) FROM {watchdog} ORDER BY type'); - while ($object = db_fetch_object($result)) { - $types[] = $object->type; - } - - return $types; -}' . $header[$i] . ' ' . $data[$i] . '
-
'; - $output .= '- '),
- '#description' => t('The list of tags which are allowed in feeds, i.e., which will not be removed by Drupal.')
- );
-
- $form['aggregator_summary_items'] = array(
- '#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.')
- );
-
- $form['aggregator_clear'] = array(
- '#type' => 'select', '#title' => t('Discard news items older than'),
- '#default_value' => variable_get('aggregator_clear', 9676800), '#options' => $period,
- '#description' => t('Older news items will be automatically discarded. Requires crontab.')
- );
-
- $form['aggregator_category_selector'] = array(
- '#type' => 'radios', '#title' => t('Category selection type'), '#default_value' => variable_get('aggregator_category_selector', 'check'),
- '#options' => array('checkboxes' => t('checkboxes'), 'select' => t('multiple selector')),
- '#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.')
- );
- return $form;
-}
-
-/**
- * Implementation of hook_perm().
- */
-function aggregator_perm() {
- return array('administer news feeds', 'access news feeds');
-}
-
-/**
- * Implementation of hook_cron().
- *
- * Checks news feeds for updates once their refresh interval has elapsed.
- */
-function aggregator_cron() {
- $result = db_query('SELECT * FROM {aggregator_feed} WHERE checked + refresh < %d', time());
- while ($feed = db_fetch_array($result)) {
- aggregator_refresh($feed);
- }
-}
-
-/**
- * Implementation of hook_block().
- *
- * Generates blocks for the latest news items in each category and feed.
- */
-function aggregator_block($op, $delta = 0, $edit = array()) {
- if (user_access('access news feeds')) {
- if ($op == 'list') {
- $result = db_query('SELECT cid, title FROM {aggregator_category} ORDER BY title');
- while ($category = db_fetch_object($result)) {
- $block['category-'. $category->cid]['info'] = t('%title category latest items', array('%title' => theme('placeholder', $category->title)));
- }
- $result = db_query('SELECT fid, title FROM {aggregator_feed} ORDER BY fid');
- while ($feed = db_fetch_object($result)) {
- $block['feed-'. $feed->fid]['info'] = t('%title feed latest items', array('%title' => theme('placeholder', $feed->title)));
- }
- }
- else if ($op == 'configure') {
- list($type, $id) = explode('-', $delta);
- 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));
- }
- $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)));
- return $form;
- }
- else if ($op == 'save') {
- list($type, $id) = explode('-', $delta);
- 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);
- }
- }
- else if ($op == 'view') {
- list($type, $id) = explode('-', $delta);
- switch ($type) {
- case 'feed':
- if ($feed = db_fetch_object(db_query('SELECT fid, title, block FROM {aggregator_feed} WHERE fid = %d', $id))) {
- $block['subject'] = check_plain($feed->title);
- $result = db_query_range('SELECT * FROM {aggregator_item} WHERE fid = %d ORDER BY timestamp DESC, iid DESC', $feed->fid, 0, $feed->block);
- $block['content'] = '
'. l(t('more'), 'aggregator/sources/'. $feed->fid, array('title' => t('View this feed\'s recent news.'))) .''; - } - break; - - case 'category': - if ($category = db_fetch_object(db_query('SELECT cid, title, block FROM {aggregator_category} WHERE cid = %d', $id))) { - $block['subject'] = check_plain($category->title); - $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'] = ''. l(t('more'), 'aggregator/categories/'. $category->cid, array('title' => t('View this category\'s recent news.'))) .''; - } - break; - } - $items = array(); - while ($item = db_fetch_object($result)) { - $items[] = theme('aggregator_block_item', $item); - } - $block['content'] = theme('item_list', $items) . $block['content']; - } - return $block; - } -} - -/** - * 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'], - ); - $form['submit'] = array('#type' => 'submit', '#value' =>t('Submit')); - - if ($edit['cid']) { - $form['delete'] = array('#type' => 'submit', '#value' =>t('Delete')); - $form['cid'] = array('#type' => 'hidden', '#value' => $edit['cid']); - } - - return drupal_get_form('aggregator_form_category', $form); -} - -/** - * 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) { - form_set_error('title', t('A category named %category already exists. Please enter a unique title.', array('%category' => theme('placeholder', $form_values['title'])))); - } - } -} - -/** - * 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'])) { - drupal_set_message(t('The category %category has been updated.', array('%category' => theme('placeholder', $form_values['title'])))); - if (arg(0) == 'admin') { - return 'admin/aggregator/'; - } - else { - return 'aggregator/categories/'. $form_values['cid']; - } - } - else { - watchdog('aggregator', t('Category %category deleted.', array('%category' => theme('placeholder', $title)))); - drupal_set_message(t('The category %category has been deleted.', array('%category' => theme('placeholder', $title)))); - if (arg(0) == 'admin') { - return 'admin/aggregator/'; - } - else { - return 'aggregator/categories/'; - } - } - } - else { - watchdog('aggregator', t('Category %category added.', array('%category' => theme('placeholder', $form_values['title']))), WATCHDOG_NOTICE, l(t('view'), 'admin/aggregator')); - drupal_set_message(t('The category %category has been added.', array('%category' => theme('placeholder', $form_values['title'])))); - } -} - -/** - * 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)) { - $options[$category->cid] = $category->title; - if ($category->fid) $values[] = check_plain($category->cid); - } - 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.'), - ); - } - $form['submit'] = array('#type' => 'submit', '#value' =>t('Submit')); - - if ($edit['fid']) { - $form['delete'] = array('#type' => 'submit', '#value' =>t('Delete')); - $form['fid'] = array('#type' => 'hidden', '#value' => $edit['fid']); - } - - return drupal_get_form('aggregator_form_feed', $form); -} - -/** - * 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) { - form_set_error('title', t('A feed named %feed already exists. Please enter a unique title.', array('%feed' => theme('placeholder', $form_values['title'])))); - } - } - } -} - -/** - * 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'])) { - drupal_set_message(t('The feed %feed has been updated.', array('%feed' => theme('placeholder', $form_values['title'])))); - if (arg(0) == 'admin') { - return 'admin/aggregator/'; - } - else { - return 'aggregator/sources/'. $form_values['fid']; - } - } - else { - watchdog('aggregator', t('Feed %feed deleted.', array('%feed' => theme('placeholder', $title)))); - drupal_set_message(t('The feed %feed has been deleted.', array('%feed' => theme('placeholder', $title)))); - if (arg(0) == 'admin') { - return 'admin/aggregator/'; - } - else { - return 'aggregator/sources/'; - } - } - } - else { - watchdog('aggregator', t('Feed %feed added.', array('%feed' => theme('placeholder', $form_values['title']))), WATCHDOG_NOTICE, l(t('view'), 'admin/aggregator')); - drupal_set_message(t('The feed %feed has been added.', array('%feed' => theme('placeholder', $form_values['title'])))); - } -} - -/** - * 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); - } - } - } - } -} - -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"; - } - if ($items) { - db_query('DELETE FROM {aggregator_category_item} WHERE '. implode(' OR ', $items)); - } - db_query('DELETE FROM {aggregator_item} WHERE fid = %d', $feed['fid']); - db_query("UPDATE {aggregator_feed} SET checked = 0, etag = '', modified = 0 WHERE fid = %d", $feed['fid']); - drupal_set_message(t('The news items from %site have been removed.', array('%site' => theme('placeholder', $feed['title'])))); -} - -/** - * Call-back function used by the XML parser. - */ -function aggregator_element_start($parser, $name, $attributes) { - global $item, $element, $tag, $items, $channel; - - switch ($name) { - case 'IMAGE': - case 'TEXTINPUT': - case 'CONTENT': - case 'SUMMARY': - case 'TAGLINE': - case 'SUBTITLE': - case 'LOGO': - case 'INFO': - $element = $name; - break; - case 'ID': - if ($element != 'ITEM') { - $element = $name; - } - case 'LINK': - if ($attributes['REL'] == 'alternate') { - if ($element == 'ITEM') { - $items[$item]['LINK'] = $attributes['HREF']; - } - else { - $channel['LINK'] = $attributes['HREF']; - } - } - break; - case 'ITEM': - $element = $name; - $item += 1; - break; - case 'ENTRY': - $element = 'ITEM'; - $item += 1; - break; - } - - $tag = $name; -} - -/** - * Call-back function used by the XML parser. - */ -function aggregator_element_end($parser, $name) { - global $element; - - switch ($name) { - case 'IMAGE': - case 'TEXTINPUT': - case 'ITEM': - case 'ENTRY': - case 'CONTENT': - case 'INFO': - $element = ''; - break; - case 'ID': - if ($element == 'ID') { - $element = ''; - } - } -} - -/** - * Call-back function used by the XML parser. - */ -function aggregator_element_data($parser, $data) { - global $channel, $element, $items, $item, $image, $tag; - - switch ($element) { - case 'ITEM': - $items[$item][$tag] .= $data; - break; - case 'IMAGE': - case 'LOGO': - $image[$tag] .= $data; - break; - case 'LINK': - if ($data) { - $items[$item][$tag] .= $data; - } - break; - case 'CONTENT': - $items[$item]['CONTENT'] .= $data; - break; - case 'SUMMARY': - $items[$item]['SUMMARY'] .= $data; - break; - case 'TAGLINE': - case 'SUBTITLE': - $channel['DESCRIPTION'] .= $data; - break; - case 'INFO': - case 'ID': - case 'TEXTINPUT': - // The sub-element is not supported. However, we must recognize - // it or its contents will end up in the item array. - break; - default: - $channel[$tag] .= $data; - } -} - -/** - * Checks a news feed for new items. - */ -function aggregator_refresh($feed) { - global $channel, $image; - - // Generate conditional GET headers. - $headers = array(); - if ($feed['etag']) { - $headers['If-None-Match'] = $feed['etag']; - } - if ($feed['modified']) { - $headers['If-Modified-Since'] = gmdate('D, d M Y H:i:s', $feed['modified']) .' GMT'; - } - - // Request feed. - $result = drupal_http_request($feed['url'], $headers); - - // Process HTTP response code. - switch ($result->code) { - case 304: - db_query('UPDATE {aggregator_feed} SET checked = %d WHERE fid = %d', time(), $feed['fid']); - drupal_set_message(t('There is no new syndicated content from %site.', array('%site' => theme('placeholder', $feed['title'])))); - break; - case 301: - $feed['url'] = $result->redirect_url; - watchdog('aggregator', t('Updated URL for feed %title to %url.', array('%title' => theme('placeholder', $feed['title']), '%url' => theme('placeholder', $feed['url'])))); - break; - - case 200: - case 302: - case 307: - // Filter the input data: - if (aggregator_parse_feed($result->data, $feed)) { - - if ($result->headers['Last-Modified']) { - $modified = strtotime($result->headers['Last-Modified']); - } - - /* - ** Prepare the channel data: - */ - - foreach ($channel as $key => $value) { - $channel[$key] = trim($value); - } - - /* - ** Prepare the image data (if any): - */ - - foreach ($image as $key => $value) { - $image[$key] = trim($value); - } - - if ($image['LINK'] && $image['URL'] && $image['TITLE']) { - // 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 = ''; - } - else { - $image = NULL; - } - - /* - ** Update the feed data: - */ - - 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']); - - /* - ** Clear the cache: - */ - - cache_clear_all(); - - watchdog('aggregator', t('There is new syndicated content from %site.', array('%site' => theme('placeholder', $feed['title'])))); - drupal_set_message(t('There is new syndicated content from %site.', array('%site' => theme('placeholder', $feed['title'])))); - } - break; - default: - watchdog('aggregator', t('The RSS-feed from %site seems to be broken, due to "%error".', array('%site' => theme('placeholder', $feed['title']), '%error' => theme('placeholder', $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' => theme('placeholder', $feed['title']), '%error' => theme('placeholder', $result->code .' '. $result->error)))); - } -} - -/** - * 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. - * Originally from MagpieRSS (http://magpierss.sourceforge.net/). - * - * @param $date_str A string with a potentially W3C DTF date. - * @return A timestamp if parsed successfully or -1 if not. - */ -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 { - return FALSE; - } -} - -function aggregator_parse_feed(&$data, $feed) { - global $items, $image, $channel; - - // Unset the global variables before we use them: - unset($GLOBALS['element'], $GLOBALS['item'], $GLOBALS['tag']); - $items = array(); - $image = array(); - $channel = array(); - - // parse the data: - $xml_parser = drupal_xml_parser_create($data); - xml_set_element_handler($xml_parser, 'aggregator_element_start', 'aggregator_element_end'); - xml_set_character_data_handler($xml_parser, 'aggregator_element_data'); - - if (!xml_parse($xml_parser, $data, 1)) { - watchdog('aggregator', t('The RSS-feed from %site seems to be broken, due to an error "%error" on line %line.', array('%site' => theme('placeholder', $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' => theme('placeholder', $feed['title']), '%error' => xml_error_string(xml_get_error_code($xml_parser)), '%line' => xml_get_current_line_number($xml_parser))), 'error'); - return 0; - } - xml_parser_free($xml_parser); - - /* - ** We reverse the array such that we store the first item last, - ** and the last item first. In the database, the newest item - ** should be at the top. - */ - - $items = array_reverse($items); - - foreach ($items as $item) { - unset($title, $link, $author, $description); - - // Prepare the item: - foreach ($item as $key => $value) { - $item[$key] = trim($value); - } - - /* - ** Resolve the item's title. If no title is found, we use - ** up to 40 characters of the description ending at a word - ** boundary but not splitting potential entities. - */ - - if ($item['TITLE']) { - $title = $item['TITLE']; - } - else { - $title = preg_replace('/^(.*)[^\w;&].*?$/', "\\1", truncate_utf8($item['DESCRIPTION'], 40)); - } - - /* - ** Resolve the items link. - */ - - if ($item['LINK']) { - $link = $item['LINK']; - } - elseif ($item['GUID'] && (strncmp($item['GUID'], 'http://', 7) == 0)) { - $link = $item['GUID']; - } - else { - $link = $feed['link']; - } - - /** - * Atom feeds have a CONTENT and/or SUMMARY tag instead of a DESCRIPTION tag - */ - if ($item['CONTENT']) { - $item['DESCRIPTION'] = $item['CONTENT']; - } - else if ($item['SUMMARY']) { - $item['DESCRIPTION'] = $item['SUMMARY']; - } - - /* - ** Try to resolve and parse the item's publication date. If no - ** 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 - 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 - else $date = 'now'; - - $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) { - $timestamp = time(); // better than nothing - } - } - - /* - ** Save this item. Try to avoid duplicate entries as much as - ** possible. If we find a duplicate entry, we resolve it and - ** pass along it's ID such that we can update it if needed. - */ - - if ($link && $link != $feed['link'] && $link != $feed['url']) { - $entry = db_fetch_object(db_query("SELECT iid FROM {aggregator_item} WHERE fid = %d AND link = '%s'", $feed['fid'], $link)); - } - else { - $entry = db_fetch_object(db_query("SELECT iid FROM {aggregator_item} WHERE fid = %d AND title = '%s'", $feed['fid'], $title)); - } - - aggregator_save_item(array('iid' => $entry->iid, 'fid' => $feed['fid'], 'timestamp' => $timestamp, 'title' => $title, 'link' => $link, 'author' => $item['AUTHOR'], 'description' => $item['DESCRIPTION'])); - } - - /* - ** Remove all items that are older than flush item timer: - */ - - $age = time() - variable_get('aggregator_clear', 9676800); - $result = db_query('SELECT iid FROM {aggregator_item} WHERE fid = %d AND timestamp < %d', $feed['fid'], $age); - - if (db_num_rows($result)) { - $items = array(); - while ($item = db_fetch_object($result)) { - $items[] = $item->iid; - } - db_query('DELETE FROM {aggregator_category_item} WHERE iid IN ('. implode(', ', $items) .')'); - db_query('DELETE FROM {aggregator_item} WHERE fid = %d AND timestamp < %d', $feed['fid'], $age); - } - - return 1; -} - -function aggregator_save_item($edit) { - if ($edit['iid'] && $edit['title']) { - db_query("UPDATE {aggregator_item} SET title = '%s', link = '%s', author = '%s', description = '%s' WHERE iid = %d", $edit['title'], $edit['link'], $edit['author'], $edit['description'], $edit['iid']); - } - else if ($edit['iid']) { - db_query('DELETE FROM {aggregator_item} WHERE iid = %d', $edit['iid']); - db_query('DELETE FROM {aggregator_category_item} WHERE iid = %d', $edit['iid']); - } - else if ($edit['title'] && $edit['link']) { - $edit['iid'] = db_next_id('{aggregator_item}_iid'); - db_query("INSERT INTO {aggregator_item} (iid, fid, title, link, author, description, timestamp) VALUES (%d, %d, '%s', '%s', '%s', '%s', %d)", $edit['iid'], $edit['fid'], $edit['title'], $edit['link'], $edit['author'], $edit['description'], $edit['timestamp']); - // file the items in the categories indicated by the feed - $categories = db_query('SELECT cid FROM {aggregator_category_feed} WHERE fid = %d', $edit['fid']); - while ($category = db_fetch_object($categories)) { - db_query('INSERT INTO {aggregator_category_item} (cid, iid) VALUES (%d, %d)', $category->cid, $edit['iid']); - } - } -} - -function aggregator_get_feed($fid) { - return db_fetch_array(db_query('SELECT * FROM {aggregator_feed} WHERE fid = %d', $fid)); -} - -function aggregator_get_category($cid) { - return db_fetch_array(db_query('SELECT * FROM {aggregator_category} WHERE cid = %d', $cid)); -} - -function aggregator_view() { - $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'); - - $output .= '
'. t('Feed overview') .'
'; - - $header = array(t('Title'), t('Items'), t('Last update'), t('Next update'), array('data' => t('Operations'), 'colspan' => '3')); - $rows = array(); - while ($feed = db_fetch_object($result)) { - $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/aggregator/edit/feed/$feed->fid"), l(t('remove items'), "admin/aggregator/remove/$feed->fid"), l(t('update items'), "admin/aggregator/update/$feed->fid")); - } - $output .= theme('table', $header, $rows); - - $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'); - - $output .= ''. t('Category overview') .'
'; - - $header = array(t('Title'), t('Items'), t('Operations')); - $rows = array(); - while ($category = db_fetch_object($result)) { - $rows[] = array(l($category->title, "aggregator/categories/$category->cid"), format_plural($category->items, '1 item', '%count items'), l(t('edit'), "admin/aggregator/edit/category/$category->cid")); - } - $output .= theme('table', $header, $rows); - - return $output; -} - -/** - * Menu callback; removes all items from a feed, then redirects to the overview page. - */ -function aggregator_admin_remove_feed($feed) { - aggregator_remove(aggregator_get_feed($feed)); - drupal_goto('admin/aggregator'); -} - -/** - * Menu callback; refreshes a feed, then redirects to the overview page. - */ -function aggregator_admin_refresh_feed($feed) { - aggregator_refresh(aggregator_get_feed($feed)); - drupal_goto('admin/aggregator'); -} - -/** - * Menu callback; displays the aggregator administration page. - */ -function aggregator_admin_overview() { - return aggregator_view(); -} - -/** - * Menu callback; displays the most recent items gathered from any feed. - */ -function aggregator_page_last() { - return _aggregator_page_list('SELECT i.*, f.title AS ftitle, f.link AS flink FROM {aggregator_item} i INNER JOIN {aggregator_feed} f ON i.fid = f.fid ORDER BY i.timestamp DESC, i.iid DESC', arg(1)); -} - -/** - * Menu callback; displays all the items captured from a particular feed. - */ -function aggregator_page_source() { - $feed = db_fetch_object(db_query('SELECT * FROM {aggregator_feed} WHERE fid = %d', arg(2))); - $info = theme('aggregator_feed', $feed); - - return _aggregator_page_list('SELECT * FROM {aggregator_item} WHERE fid = '. $feed->fid .' ORDER BY timestamp DESC, iid DESC', arg(3), $info); -} - -/** - * Menu callback; displays all the items aggregated in a particular category. - */ -function aggregator_page_category() { - $category = db_fetch_object(db_query('SELECT cid, title FROM {aggregator_category} WHERE cid = %d', arg(2))); - - return _aggregator_page_list('SELECT i.*, f.title AS ftitle, f.link AS flink FROM {aggregator_category_item} c LEFT JOIN {aggregator_item} i ON c.iid = i.iid LEFT JOIN {aggregator_feed} f ON i.fid = f.fid WHERE cid = '. $category->cid .' ORDER BY timestamp DESC, iid DESC', arg(3)); -} - -/** - * Prints an aggregator page listing a number of feed items. Various - * menu callbacks use this function to print their feeds. - */ -function _aggregator_page_list($sql, $op, $header = '') { - $categorize = (user_access('administer news feeds') && ($op == 'categorize')); - - $output = ''; - - $form['header'] = array('#value' => $header); - $output .= $form['header']['#value']; - - $result = pager_query($sql, 20); - $categories = array(); - while ($item = db_fetch_object($result)) { - $form['items'][$item->iid] = array('#value' => theme('aggregator_page_item', $item)); - $output .= $form['items'][$item->iid]['#value']; - $form['categories'][$item->iid] = array(); - - if ($categorize) { - - $categories_result = db_query('SELECT c.cid, c.title, ci.iid FROM {aggregator_category} c LEFT JOIN {aggregator_category_item} ci ON c.cid = ci.cid AND ci.iid = %d', $item->iid); - $selected = array(); - while ($category = db_fetch_object($categories_result)) { - if (!$done) { - $categories[$category->cid] = check_plain($category->title); - } - if ($category->iid) { - $selected[] = $category->cid; - } - } - $done = true; - $form['categories'][$item->iid] = array( - '#type' => variable_get('aggregator_category_selector', 'checkboxes'), - '#default_value' => $selected, '#options' => $categories, - '#size' => 10, '#multiple' => true - ); - } - } - $output .= ''; - $form['submit'] = array('#type' => 'submit', '#value' => t('Save categories')); - $form['pager'] = array('#value' => theme('pager', NULL, 20, 0)); - $output .= $form['pager']['#value']; - - // arg(1) is undefined if we are at the top aggregator URL - // is there a better way to do this? - if (!arg(1)) { - $form['feed_icon'] = array('#value' => theme('feed_icon', url('aggregator/rss'))); - } - elseif (arg(1) == 'categories' && arg(2) && !arg(3)) { - $form['feed_icon'] = array('#value' => theme('feed_icon', url('aggregator/rss/' . arg(2)))); - } - $output .= $form['feed_icon']['#value']; - - return ($categorize) ? drupal_get_form('aggregator_page_list', $form) : $output; -} - -function theme_aggregator_page_list($form) { - $output = ''; - $output .= form_render($form['header']); - $rows = array(); - if ($form['items']) { - foreach (element_children($form['items']) as $key) { - if (is_array($form['items'][$key])) { - $rows[] = array(form_render($form['items'][$key]), array('data' => form_render($form['categories'][$key]), 'class' => 'categorize-item')); - } - } - } - $output .= theme('table', array('', t('Categorize')), $rows); - $output .= form_render($form['submit']); - $output .= ''; - $output .= form_render($form); - return $output; -} - -function aggregator_page_list_validate($form_id, &$form) { - if (!user_access('administer news feeds')) { - form_error($form, t('You are not allowed to categorize this feed item.')); - } -} - -function aggregator_page_list_submit($form_id, $form_values) { - foreach ($form_values as $iid => $selection) { - db_query('DELETE FROM {aggregator_category_item} WHERE iid = %d', $iid); - foreach ($selection as $cid) { - if ($cid) { - db_query('INSERT INTO {aggregator_category_item} (cid, iid) VALUES (%d, %d)', $cid, $iid); - } - } - } - drupal_set_message(t('The categories have been saved.')); -} - -/** - * Menu callback; displays all the feeds used by the aggregator. - */ -function aggregator_page_sources() { - $result = db_query('SELECT f.fid, f.title, f.description, f.image, MAX(i.timestamp) AS last FROM {aggregator_feed} f LEFT JOIN {aggregator_item} i ON f.fid = i.fid GROUP BY f.fid, f.title, f.description, f.image ORDER BY last DESC, f.title'); - $output = "\n"; - while ($feed = db_fetch_object($result)) { - $output .= ''; - return $output; -} - -/** - * Menu callback; generate an RSS 0.92 feed of aggregator items or categories. - */ -function aggregator_page_rss() { - global $base_url; - - // arg(2) is the passed cid, only select for that category - $result = NULL; - if (arg(2)) { - $category = db_fetch_object(db_query('SELECT cid, title FROM {aggregator_category} WHERE cid = %d', arg(2))); - $url = '/categories/' . $category->cid; - $title = ' ' . t('in category') . ' ' . $category->title; - $sql = 'SELECT i.*, f.title AS ftitle, f.link AS flink FROM {aggregator_category_item} c LEFT JOIN {aggregator_item} i ON c.iid = i.iid LEFT JOIN {aggregator_feed} f ON i.fid = f.fid WHERE cid = %d ORDER BY timestamp DESC, iid DESC'; - $result = db_query_range($sql, $category->cid, 0, variable_get('feed_default_items', 10)); - } - // or, get the default aggregator items - else { - $sql = 'SELECT i.*, f.title AS ftitle, f.link AS flink FROM {aggregator_item} i INNER JOIN {aggregator_feed} f ON i.fid = f.fid ORDER BY i.timestamp DESC, i.iid DESC'; - $result = db_query_range($sql, 0, variable_get('feed_default_items', 10)); - } - - while ($item = db_fetch_object($result)) { - switch (variable_get('feed_item_length', 'teaser')) { - case 'teaser': - $teaser = node_teaser($item->description); - if ($teaser != $item_description) { - $teaser .= '\n"; - } - $item->description = $teaser; - break; - case 'title': - $item->description = ''; - break; - } - $items .= format_rss_item($item->ftitle . ': ' . $item->title, $item->link, $item->description, array('pubDate' => date('r', $item->timestamp))); - } - - $output .= "\n"; - $output .= "'. check_plain($feed->title) ."
\n"; - - // Most recent items: - $list = array(); - if (variable_get('aggregator_summary_items', 3)) { - $items = db_query_range('SELECT i.title, i.timestamp, i.link FROM {aggregator_item} i WHERE i.fid = %d ORDER BY i.timestamp DESC', $feed->fid, 0, variable_get('aggregator_summary_items', 3)); - while ($item = db_fetch_object($items)) { - $list[] = theme('aggregator_summary_item', $item); - } - } - $output .= theme('item_list', $list); - $output .= ''. theme('links', array(l(t('more'), 'aggregator/sources/'. $feed->fid))) ."\n"; - } - $output .= theme('xml_icon', url('aggregator/opml')); - $output .= '\n"; - $output .= format_rss_channel(variable_get('site_name', t('Drupal')) . ' ' . t('aggregator'), $base_url . '/' . url('aggregator' . $url), variable_get('site_name', t('Drupal')) . ' - ' . t('aggregated feeds') . $title, $items, 'en'); - $output .= " \n"; - - drupal_set_header('Content-Type: text/xml; charset=utf-8'); - print $output; -} - -/** - * Menu callback; generates an OPML representation of all feeds. - */ -function aggregator_page_opml($cid = NULL) { - if ($cid) { - $result = db_query('SELECT f.title, f.url FROM {aggregator_feed} f LEFT JOIN {aggregator_category_feed} c on f.fid = c.fid WHERE c.cid = %d ORDER BY title', $cid); - } - else { - $result = db_query('SELECT * FROM {aggregator_feed} ORDER BY title'); - } - - $output = "\n"; - $output .= "\n"; - $output .= "\n"; - $output .= ' \n"; - - drupal_set_header('Content-Type: text/xml; charset=utf-8'); - print $output; -} - -/** - * Menu callback; displays all the categories used by the aggregator. - */ -function aggregator_page_categories() { - $result = db_query('SELECT c.cid, c.title, c.description FROM {aggregator_category} c LEFT JOIN {aggregator_category_item} ci ON c.cid = ci.cid LEFT JOIN {aggregator_item} i ON ci.iid = i.iid GROUP BY c.cid, c.title, c.description'); - $output = "'. check_plain(variable_get('site_name', 'Drupal')) ." \n"; - $output .= ''. gmdate('r') ." \n"; - $output .= "\n"; - $output .= "\n"; - - while ($feed = db_fetch_object($result)) { - $output .= '\n"; - } - - $output .= "\n"; - $output .= " \n"; - - while ($category = db_fetch_object($result)) { - $output .= ''; - - return $output; -} - -/** - * Format a news feed. - * - * @ingroup themeable - */ -function theme_aggregator_feed($feed) { - $output = ''. check_plain($category->title) ."
\n"; - if (variable_get('aggregator_summary_items', 3)) { - $list = array(); - $items = db_query_range('SELECT i.title, i.timestamp, i.link, f.title as feed_title, f.link as feed_link FROM {aggregator_category_item} ci LEFT JOIN {aggregator_item} i ON i.iid = ci.iid LEFT JOIN {aggregator_feed} f ON i.fid = f.fid WHERE ci.cid = %d ORDER BY i.timestamp DESC', $category->cid, 0, variable_get('aggregator_summary_items', 3)); - while ($item = db_fetch_object($items)) { - $list[] = theme('aggregator_summary_item', $item); - } - $output .= theme('item_list', $list); - } - $output .= ''. theme('links', array(l(t('more'), 'aggregator/categories/'. $category->cid))) ."\n"; - } - $output .= ''; - $output .= theme('feed_icon', $feed->url) ."\n"; - $output .= $feed->image . '\n"; - - return $output; -} - -/** - * Format an individual feed item for display in the block. - * - * @ingroup themeable - */ -function theme_aggregator_block_item($item, $feed = 0) { - global $user; - - if ($user->uid && module_exist('blog') && user_access('edit own blog')) { - if ($image = theme('image', 'misc/blog.png', t('blog it'), t('blog it'))) { - $output .= ''. check_plain($feed->title) ."
\n"; - $output .= ''. t('Description:') .' '. aggregator_filter_xss($feed->description) ."\n"; - - $updated = t('%time ago', array('%time' => format_interval(time() - $feed->checked))); - if (user_access('administer news feeds')) { - $updated = l($updated, 'admin/aggregator'); - } - - $output .= ''. t('Updated:') . " $updated"; - $output .= "'. l($image, 'node/add/blog', array('title' => t('Comment on this news item in your personal blog.'), 'class' => 'blog-it'), "iid=$item->iid", NULL, FALSE, TRUE) .''; - } - } - - // Display the external link to the item. - $output .= ''. check_plain($item->title) ."\n"; - - return $output; -} - -/** - * Return a themed item heading for summary pages located at "aggregator/sources" - * and "aggregator/categories". - * - * @param $item The item object from the aggregator module. - * @return A string containing the output. - * - * @ingroup themeable - */ -function theme_aggregator_summary_item($item) { - $output = ''. check_plain($item->title) .' '. t('%age old', array('%age' => format_interval(time() - $item->timestamp))) .''; - if ($item->feed_link) { - $output .= ', '. check_plain($item->feed_title) .''; - } - return $output ."\n"; -} - -/** - * Format an individual feed item for display on the aggregator page. - * - * @ingroup themeable - */ -function theme_aggregator_page_item($item) { - - $source = ''; - if ($item->ftitle && $item->fid) { - $source = l($item->ftitle, "aggregator/sources/$item->fid", array('class' => 'feed-item-source')) . ' -'; - } - - if (date('Ymd', $item->timestamp) == date('Ymd')) { - $source_date = t('%ago ago', array('%ago' => format_interval(time() - $item->timestamp))); - } - else { - $source_date = format_date($item->timestamp, 'custom', variable_get('date_format_medium', 'D, Y-m-d H:i')); - } - - $output .= "\n"; - $output .= '\n"; - - return $output; -} - -/** - * Safely render HTML content, as allowed. - */ -function aggregator_filter_xss($value) { - return filter_xss($value, preg_split('/\s+|<|>/', variable_get("aggregator_allowed_html_tags", ''. check_plain($item->title) ."
\n"; - $output .= "\n"; - - if ($item->description) { - $output .= ''. aggregator_filter_xss($item->description) ."\n"; - } - - $result = db_query('SELECT c.title, c.cid FROM {aggregator_category_item} ci LEFT JOIN {aggregator_category} c ON ci.cid = c.cid WHERE ci.iid = %d ORDER BY c.title', $item->iid); - $categories = array(); - while ($category = db_fetch_object($result)) { - $categories[] = l($category->title, 'aggregator/categories/'. $category->cid); - } - if ($categories) { - $output .= ''. t('Categories') .': '. implode(', ', $categories) ."\n"; - } - - $output .= "
'. t('The sidebar each block appears in depends on both which theme you are using (some are left-only, some right, some both), and on the settings in block management.') .'
'; - $output .= ''. t('The block management screen lets you specify the vertical sort-order of the blocks within a sidebar. You do this by assigning a weight to each block. Lighter blocks (smaller weight) "float up" towards the top of the sidebar. Heavier ones "sink down" towards the bottom of it.') .'
'; - $output .= t('A block\'s visibility depends on:
--
-
'. t('Module blocks') .'
'; - $output .= ''. t('Module blocks are available when modules are enabled. These blocks can be administered in block administration.') .'
'; - $output .= ''. t('Administrator defined blocks') .'
'; - $output .= ''. t('An administrator defined block contains content supplied by the administrator. Each admin-defined block consists of a title, a description, and a body which can be as long as you wish. The Drupal engine will render the content of the block.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Block page.', array('%block' => 'http://drupal.org/handbook/modules/block/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Controls the boxes that are displayed around the main content.'); - case 'admin/block': - return t(" -Blocks are content rendered into regions, often boxes in the left and right side bars of the web site. They are made available by modules or created manually.
-Only enabled blocks are shown. You can position the blocks by deciding which area of the page they will show up on (e.g., a sidebar) and in which order they appear (weight). Highlighting on this page shows the regions where content will be rendered.
-If you want certain blocks to disable themselves temporarily during high server loads, check the 'Throttle' box. You can configure the auto-throttle on the throttle configuration page after having enabled the throttle module.
-", array('%throttle' => url('admin/settings/throttle'))); - case 'admin/block/add': - return t('Here you can create a new block. Once you have created this block you must make it active and give it a place on the page using blocks. The title is used when displaying the block. The description is used in the "block" column on the blocks page.
', array('%overview' => url('admin/block'))); - } -} - -/** - * Implementation of hook_perm(). - */ -function block_perm() { - return array('administer blocks', 'use PHP for block visibility'); -} - -/** - * Implementation of hook_menu(). - */ -function block_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/block', 'title' => t('blocks'), - 'access' => user_access('administer blocks'), - 'callback' => 'block_admin_display'); - $items[] = array('path' => 'admin/block/list', 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/block/configure', 'title' => t('configure block'), - 'access' => user_access('administer blocks'), - 'callback' => 'block_admin_configure', - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/block/delete', 'title' => t('delete block'), - 'access' => user_access('administer blocks'), - 'callback' => 'block_box_delete', - 'type' => MENU_CALLBACK); - $items[] = array('path' => 'admin/block/add', 'title' => t('add block'), - 'access' => user_access('administer blocks'), - 'callback' => 'block_box_add', - 'type' => MENU_LOCAL_TASK); - foreach (list_themes() as $key => $theme) { - if ($theme->status) { - if ($key == variable_get('theme_default', 'bluemarine')) { - $items[] = array('path' => 'admin/block/list/' . $key, 'title' => t('%key settings', array('%key' => $key)), - 'access' => user_access('administer blocks'), 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - } - else { - $items[] = array('path' => 'admin/block/list/' . $key, 'title' => t('%key settings', array('%key' => $key)), - 'access' => user_access('administer blocks'), 'type' => MENU_LOCAL_TASK); - } - } - } - } - - return $items; -} - -/** - * Implementation of hook_block(). - * - * Generates the administrator-defined blocks for display. - */ -function block_block($op = 'list', $delta = 0, $edit = array()) { - switch ($op) { - case 'list': - $blocks = array(); - - $result = db_query('SELECT bid, title, info FROM {boxes} ORDER BY title'); - while ($block = db_fetch_object($result)) { - $blocks[$block->bid]['info'] = $block->info ? check_plain($block->info) : check_plain($block->title); - } - return $blocks; - - case 'configure': - $box = block_box_get($delta); - if (filter_access($box['format'])) { - return block_box_form($box); - } - break; - - case 'save': - block_box_save($edit, $delta); - break; - - case 'view': - $block = db_fetch_object(db_query('SELECT * FROM {boxes} WHERE bid = %d', $delta)); - $data['subject'] = check_plain($block->title); - $data['content'] = check_markup($block->body, $block->format, FALSE); - return $data; - } -} - -/** - * Update the 'blocks' DB table with the blocks currently exported by modules. - * - * @param $order_by php array_multisort() - * style sort ordering, eg. "weight", SORT_ASC, SORT_STRING. - * - * @return - * Blocks currently exported by modules, sorted by $order_by. - */ -function _block_rehash($order_by = array('weight')) { - global $theme_key; - - init_theme(); - - $result = db_query("SELECT * FROM {blocks} WHERE theme = '%s'", $theme_key); - while ($old_block = db_fetch_object($result)) { - $old_blocks[$old_block->module][$old_block->delta] = $old_block; - } - - db_query("DELETE FROM {blocks} WHERE theme = '%s'", $theme_key); - - foreach (module_list() as $module) { - $module_blocks = module_invoke($module, 'block', 'list'); - if ($module_blocks) { - foreach ($module_blocks as $delta => $block) { - $block['module'] = $module; - $block['delta'] = $delta; - // If previously written to database, load values. - if ($old_blocks[$module][$delta]) { - $block['status'] = $old_blocks[$module][$delta]->status; - $block['weight'] = $old_blocks[$module][$delta]->weight; - $block['region'] = $old_blocks[$module][$delta]->region; - $block['visibility'] = $old_blocks[$module][$delta]->visibility; - $block['pages'] = $old_blocks[$module][$delta]->pages; - $block['custom'] = $old_blocks[$module][$delta]->custom; - $block['throttle'] = $old_blocks[$module][$delta]->throttle; - } - // Otherwise, use any set values, or else substitute defaults. - else { - $properties = array ('status' => 0, 'weight' => 0, 'region' => 'left', 'pages' => '', 'custom' => 0); - foreach ($properties as $property => $default) { - if (!isset ($block[$property])) { - $block[$property] = $default; - } - } - } - - // reinsert blocks into table - db_query("INSERT INTO {blocks} (module, delta, theme, status, weight, region, visibility, pages, custom, throttle) VALUES ('%s', '%s', '%s', %d, %d, '%s', %d, '%s', %d, %d)", - $block['module'], $block['delta'], $theme_key, $block['status'], $block['weight'], $block['region'], $block['visibility'], $block['pages'], $block['custom'], $block['throttle']); - $blocks[] = $block; - - // build array to sort on - $order[$order_by[0]][] = $block[$order_by[0]]; - } - } - } - - // sort - array_multisort($order[$order_by[0]], $order_by[1] ? $order_by[1] : SORT_ASC, $order_by[2] ? $order_by[2] : SORT_REGULAR, $blocks); - - return $blocks; -} - -/** - * Generate main block administration form. - */ -function block_admin_display() { - global $theme_key, $custom_theme; - - // If non-default theme configuration has been selected, set the custom theme. - if (arg(3)) { - $custom_theme = arg(3); - } - else { - $custom_theme = variable_get('theme_default', 'bluemarine'); - } - init_theme(); - - $throttle = module_exist('throttle'); - $blocks = _block_rehash(); - $block_regions = system_region_list($theme_key); - - $form['#action'] = arg(3) ? url('admin/block/list/' . $theme_key) : url('admin/block'); - $form['#tree'] = TRUE; - foreach ($blocks as $block) { - $form[$block['module']][$block['delta']]['info'] = array('#value' => $block['info']); - $form[$block['module']][$block['delta']]['status'] = array('#type' => 'checkbox', '#default_value' => $block['status']); - $form[$block['module']][$block['delta']]['theme'] = array('#type' => 'hidden', '#value' => $theme_key); - $form[$block['module']][$block['delta']]['weight'] = array('#type' => 'weight', '#default_value' => $block['weight']); - $form[$block['module']][$block['delta']]['region'] = array('#type' => 'select', - '#default_value' => isset($block['region']) ? $block['region'] : system_default_region(), - '#options' => $block_regions, - ); - - if ($throttle) { - $form[$block['module']][$block['delta']]['throttle'] = array('#type' => 'checkbox', '#default_value' => $block['throttle']); - } - $form[$block['module']][$block['delta']]['configure'] = array('#value' => l(t('configure'), 'admin/block/configure/'. $block['module'] .'/'. $block['delta'])); - if ($block['module'] == 'block') { - $form[$block['module']][$block['delta']]['delete'] = array('#value' => l(t('delete'), 'admin/block/delete/'. $block['delta'])); - } - } - $form['submit'] = array('#type' => 'submit', '#value' => t('Save blocks')); - - return drupal_get_form('block_admin_display', $form); -} - -/** - * Process main block administration form submission. - */ -function block_admin_display_submit($form_id, $form_values) { - foreach ($form_values as $module => $blocks) { - foreach ($blocks as $delta => $block) { - db_query("UPDATE {blocks} SET status = %d, weight = %d, region = '%s', throttle = %d WHERE module = '%s' AND delta = '%s' AND theme = '%s'", $block['status'], $block['weight'], $block['region'], $block['throttle'], $module, $delta, $block['theme']); - } - } - drupal_set_message(t('The block settings have been updated.')); - cache_clear_all(); -} - -/** - * Theme main block administration form submission. - */ -function theme_block_admin_display($form) { - global $theme_key; - - $throttle = module_exist('throttle'); - $block_regions = system_region_list($theme_key); - - // Highlight regions on page to provide visual reference. - foreach ($block_regions as $key => $value) { - drupal_set_content($key, '' . $value . ''); - } - $regions = array(); - $disabled = array(); - foreach (element_children($form) as $module) { - // Do not take form control structures. - if (is_array($form[$module])) { - foreach ($form[$module] as $delta => $element) { - // Only take form elements that are blocks. - if (is_array($form[$module][$delta]['info'])) { - $block = $form[$module][$delta]; - $row = array(array('data' => form_render($block['info']), 'class' => 'block'), form_render($block['status']) . form_render($block['theme']), form_render($block['weight']), form_render($block['region'])); - if ($throttle) { - $row[] = form_render($block['throttle']); - } - $row[] = form_render($block['configure']); - $row[] = $block['delete'] ? form_render($block['delete']) : ''; - if ($block['status']['#default_value']) { - $regions[$block['region']['#default_value']][] = $row; - } - else if ($block['region']['#default_value'] <= 1) { - $disabled[] = $row; - } - } - } - } - } - - $rows = array(); - if (count($regions)) { - foreach ($regions as $region => $row) { - $region_title = t('%region', array ('%region' => ucfirst($block_regions[$region]))); - $rows[] = array(array('data' => $region_title, 'class' => 'region', 'colspan' => ($throttle ? 7 : 6))); - $rows = array_merge($rows, $row); - } - } - if (count($disabled)) { - $rows[] = array(array('data' => t('Disabled'), 'class' => 'region', 'colspan' => ($throttle ? 7 : 6))); - $rows = array_merge($rows, $disabled); - } - $header = array(t('Block'), t('Enabled'), t('Weight'), t('Placement')); - if ($throttle) { - $header[] = t('Throttle'); - } - $header[] = array('data' => t('Operations'), 'colspan' => 2); - $output = theme('table', $header, $rows, array('id' => 'blocks')); - $output .= form_render($form['submit']); - // Also render the form_id as there is no form_render($form) call (as form_render does not appear to handle the - // multi-dimensional block form array very well). - $output .= form_render($form['form_id']); - - return $output; -} - -function block_box_get($bid) { - return db_fetch_array(db_query('SELECT * FROM {boxes} WHERE bid = %d', $bid)); -} - -/** - * Menu callback; displays the block configuration form. - */ -function block_admin_configure($module = NULL, $delta = 0) { - - $form['module'] = array('#type' => 'value', '#value' => $module); - $form['delta'] = array('#type' => 'value', '#value' => $delta); - - $edit = db_fetch_array(db_query("SELECT pages, visibility, custom FROM {blocks} WHERE module = '%s' AND delta = '%s'", $module, $delta)); - - // Module-specific block configurations. - if ($settings = module_invoke($module, 'block', 'configure', $delta)) { - $form['block_settings'] = array( - '#type' => 'fieldset', - '#title' => t('Block specific settings'), - '#collapsible' => true, - ); - - foreach ($settings as $k => $v) { - $form['block_settings'][$k] = $v; - } - } - - // Get the block subject for the page title. - $info = module_invoke($module, 'block', 'list'); - drupal_set_title(t("'%name' block", array('%name' => $info[$delta]['info']))); - - // Standard block configurations. - - $form['user_vis_settings'] = array( - '#type' => 'fieldset', - '#title' => t('User specific visibility settings'), - '#collapsible' => true, - ); - $form['user_vis_settings']['custom'] = array( - '#type' => 'radios', - '#title' => t('Custom visibility settings'), - '#options' => array(t('Users cannot control whether or not they see this block.'), t('Show this block by default, but let individual users hide it.'), t('Hide this block by default but let individual users show it.')), - '#description' => t('Allow individual users to customize the visibility of this block in their account settings.'), - '#default_value' => $edit['custom'], - ); - $form['page_vis_settings'] = array( - '#type' => 'fieldset', - '#title' => t('Page specific visibility settings'), - '#collapsible' => true, - ); - $access = user_access('use PHP for block visibility'); - - if ($edit['visibility'] == 2 && !$access) { - $form['page_vis_settings'] = array(); - $form['page_vis_settings']['visibility'] = array('#type' => 'value', '#value' => 2); - $form['page_vis_settings']['pages'] = array('#type' => 'value', '#value' => $edit['pages']); - } - else { - $options = array(t('Show on every page except the listed pages.'), t('Show on only the listed pages.')); - $description = t("Enter one page per line as Drupal paths. The '*' character is a wildcard. Example paths are '%blog' for the blog page and %blog-wildcard for every personal blog. %front is the front page.", array('%blog' => theme('placeholder', 'blog'), '%blog-wildcard' => theme('placeholder', 'blog/*'), '%front' => theme('placeholder', ''))); - - if ($access) { - $options[] = t('Show if the following PHP code returns TRUE(PHP-mode, experts only).'); - $description .= t('If the PHP-mode is chosen, enter PHP code between %php. Note that executing incorrect PHP-code can break your Drupal site.', array('%php' => theme('placeholder', ''))); - } - $form['page_vis_settings']['visibility'] = array( - '#type' => 'radios', - '#title' => t('Show block on specific pages'), - '#options' => $options, - '#default_value' => $edit['visibility'], - ); - $form['page_vis_settings']['pages'] = array( - '#type' => 'textarea', - '#title' => t('Pages'), - '#default_value' => $edit['pages'], - '#description' => $description, - ); - } - - $form['submit'] = array( - '#type' => 'submit', - '#value' => t('Save block'), - ); - - return drupal_get_form('block_admin_configure', $form); -} - -function block_admin_configure_validate($form_id, $form_values) { - if ($form_values['module'] == 'block') { - if (empty($form_values['info']) || db_num_rows(db_query("SELECT bid FROM {boxes} WHERE bid != %d AND info = '%s'", $form_values['delta'], $form_values['info']))) { - form_set_error('info', t('Please ensure that each block description is unique.')); - } - } -} - -function block_admin_configure_submit($form_id, $form_values) { - if (!form_get_errors()) { - db_query("UPDATE {blocks} SET visibility = %d, pages = '%s', custom = %d WHERE module = '%s' AND delta = '%s'", $form_values['visibility'], $form_values['pages'], $form_values['custom'], $form_values['module'], $form_values['delta']); - module_invoke($form_values['module'], 'block', 'save', $form_values['delta'], $form_values); - drupal_set_message(t('The block configuration has been saved.')); - cache_clear_all(); - return 'admin/block'; - } -} - -/** - * Menu callback; displays the block creation form. - */ -function block_box_add() { - $form = block_box_form(); - $form['submit'] = array('#type' => 'submit', '#value' => t('Save block')); - - return drupal_get_form('block_box_add', $form); -} - -function block_box_add_validate($form_id, $form_values) { - if (empty($form_values['info']) || db_num_rows(db_query("SELECT info FROM {boxes} WHERE info = '%s'", $form_values['info']))) { - form_set_error('info', t('Please ensure that each block description is unique.')); - } -} - -function block_box_add_submit($form_id, $form_values) { - if (!form_get_errors()) { - if (block_box_save($form_values)) { - drupal_set_message(t('The block has been created.')); - return 'admin/block'; - } - } -} - -/** - * Menu callback; confirm deletion of custom blocks. - */ -function block_box_delete($bid = 0) { - $box = block_box_get($bid); - $form['info'] = array('#type' => 'hidden', '#value' => $box['info'] ? $box['info'] : $box['title']); - $form['bid'] = array('#type' => 'hidden', '#value' => $bid); - - return confirm_form('block_box_delete_confirm', $form, t('Are you sure you want to delete the block %name?', array('%name' => theme('placeholder', $info))), 'admin/block', '', t('Delete'), t('Cancel')); -} - -/** - * Deletion of custom blocks. - */ -function block_box_delete_confirm_submit($form_id, $form_values) { - db_query('DELETE FROM {boxes} WHERE bid = %d', $form_values['bid']); - drupal_set_message(t('The block %name has been removed.', array('%name' => theme('placeholder', $form_values['info'])))); - cache_clear_all(); - return 'admin/block'; -}; - -function block_box_form($edit = array()) { - $form['info'] = array( - '#type' => 'textfield', - '#title' => t('Block description'), - '#default_value' => $edit['info'], - '#maxlength' => 64, - '#description' => t('A brief description of your block. Used on the block overview page.', array('%overview' => url('admin/block'))), - '#required' => TRUE, - '#weight' => -19, - ); - $form['title'] = array( - '#type' => 'textfield', - '#title' => t('Block title'), - '#default_value' => $edit['title'], - '#maxlength' => 64, - '#description' => t('The title of the block as shown to the user.'), - '#weight' => -18, - ); - $form['body_filter']['#weight'] = -17; - $form['body_filter']['body'] = array( - '#type' => 'textarea', - '#title' => t('Block body'), - '#default_value' => $edit['body'], - '#rows' => 15, - '#description' => t('The content of the block as shown to the user.'), - '#weight' => -17, - ); - $form['body_filter']['format'] = filter_form($edit['format'], -16); - - return $form; -} - -function block_box_save($edit, $delta = NULL) { - if (!filter_access($edit['format'])) { - $edit['format'] = FILTER_FORMAT_DEFAULT; - } - - if (isset($delta)) { - db_query("UPDATE {boxes} SET title = '%s', body = '%s', info = '%s', format = %d WHERE bid = %d", $edit['title'], $edit['body'], $edit['info'], $edit['format'], $delta); - } - else { - db_query("INSERT INTO {boxes} (title, body, info, format) VALUES ('%s', '%s', '%s', %d)", $edit['title'], $edit['body'], $edit['info'], $edit['format']); - } - return true; -} - -/** - * Implementation of hook_user(). - * - * Allow users to decide which custom blocks to display when they visit - * the site. - */ -function block_user($type, $edit, &$user, $category = NULL) { - switch ($type) { - case 'form': - if ($category == 'account') { - $result = db_query('SELECT * FROM {blocks} WHERE status = 1 AND custom != 0 ORDER BY weight, module, delta'); - $form['block'] = array('#type' => 'fieldset', '#title' => t('Block configuration'), '#weight' => 3, '#collapsible' => TRUE, '#tree' => TRUE); - while ($block = db_fetch_object($result)) { - $data = module_invoke($block->module, 'block', 'list'); - if ($data[$block->delta]['info']) { - $return = TRUE; - $form['block'][$block->module][$block->delta] = array('#type' => 'checkbox', '#title' => $data[$block->delta]['info'], '#default_value' => isset($user->block[$block->module][$block->delta]) ? $user->block[$block->module][$block->delta] : ($block->custom == 1)); - } - } - - if ($return) { - return $form; - } - } - - break; - case 'validate': - if (!$edit['block']) { - $edit['block'] = array(); - } - return $edit; - } -} - -/** - * Return all blocks in the specified region for the current user. - * - * @param $region - * The name of a region. - * - * @return - * An array of block objects, indexed with module_delta. - * If you are displaying your blocks in one or two sidebars, you may check - * whether this array is empty to see how many columns are going to be - * displayed. - * - * @todo - * Add a proper primary key (bid) to the blocks table so we don't have - * to mess around with this module_delta construct. - * Currently, the blocks table has no primary key defined! - */ -function block_list($region) { - global $user, $theme_key; - - static $blocks = array(); - - if (!count($blocks)) { - $result = db_query("SELECT * FROM {blocks} WHERE theme = '%s' AND status = 1 ORDER BY region, weight, module", $theme_key); - while ($block = db_fetch_object($result)) { - if (!isset($blocks[$block->region])) { - $blocks[$block->region] = array(); - } - // Use the user's block visibility setting, if necessary - if ($block->custom != 0) { - if ($user->uid && isset($user->block[$block->module][$block->delta])) { - $enabled = $user->block[$block->module][$block->delta]; - } - else { - $enabled = ($block->custom == 1); - } - } - else { - $enabled = TRUE; - } - - // Match path if necessary - if ($block->pages) { - if ($block->visibility < 2) { - $path = drupal_get_path_alias($_GET['q']); - $regexp = '/^('. preg_replace(array('/(\r\n?|\n)/', '/\\\\\*/', '/(^|\|)\\\\'. t('The blog module allows registered users to maintain an online weblog (commonly known as a blog), often referred to as an online journal or diary. Blogs are made up of individual posts that are time stamped and are typically viewed by date as you would a diary. Blogs often contain links to webpages users have read and/or agree/disagree with.') .'
'; - $output .= ''. t('The blog module adds a user blogs navigation link to the site, which takes any visitor to a page that displays the most recent blog entries from all the users on the site. The navigation menu has a create a blog entry link (which takes you to a submission form) and a view personal blog link (which displays your blog entries as other people will see them). The blog module also creates a recent blog posts block that can be enabled.') .'
'; - $output .= ''. t('If a user has the ability to post blogs, then the import module (news aggregator) will display a blog-it link next to each news item in its lists. Clicking on this takes the user to the blog submission form, with the title, a link to the item, and a link to the source into the body text already in the text box, ready for the user to add a comment or explanation. This actively encourages people to add blog entries about things they see and hear elsewhere in the website and from your syndicated partner sites.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Blog page.', array('%blog' => 'http://drupal.org/handbook/modules/blog/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Enables keeping an easily and regularly updated web page or a blog.'); - case 'node/add#blog': - return t("A blog is a regularly updated journal or diary made up of individual posts shown in reversed chronological order. A blog is tightly coupled to the author so each user will have his 'own' blog."); - } -} - -/** - * Displays an RSS feed containing recent blog entries of a given user. - */ -function blog_feed_user($uid = 0) { - global $user; - - if ($uid) { - $account = user_load(array('uid' => $uid, 'status' => 1)); - } - else { - $account = $user; - } - - $result = db_query_range(db_rewrite_sql("SELECT n.nid, n.title, r.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {node_revisions} r ON n.vid = r.vid INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND u.uid = %d AND n.status = 1 ORDER BY n.created DESC"), $uid, 0, variable_get('feed_default_items', 10)); - $channel['title'] = $account->name ."'s blog"; - $channel['link'] = url("blog/$uid", NULL, NULL, TRUE); - $channel['description'] = $term->description; - node_feed($result, $channel); -} - -/** - * Displays an RSS feed containing recent blog entries of all users. - */ -function blog_feed_last() { - $result = db_query_range(db_rewrite_sql("SELECT n.nid, n.title, r.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {node_revisions} r ON n.vid = r.vid INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.created DESC"), 0, variable_get('feed_default_items', 10)); - $channel['title'] = variable_get('site_name', 'drupal') .' blogs'; - $channel['link'] = url('blog', NULL, NULL, TRUE); - $channel['description'] = $term->description; - node_feed($result, $channel); -} - -/** - * Menu callback; displays a Drupal page containing recent blog entries. - */ -function blog_page($a = NULL, $b = NULL) { - - if (is_numeric($a)) { // $a is a user ID - if ($b == 'feed') { - return blog_feed_user($a); - } - else { - return blog_page_user($a); - } - } - else if ($a == 'feed') { - return blog_feed_last(); - } - else { - return blog_page_last(); - } -} - -/** - * Displays a Drupal page containing recent blog entries of a given user. - */ -function blog_page_user($uid) { - global $user; - - $account = user_load(array((is_numeric($uid) ? 'uid' : 'name') => $uid, 'status' => 1)); - - if ($account->uid) { - drupal_set_title($title = t("%name's blog", array('%name' => $account->name))); - - if (($account->uid == $user->uid) && user_access('edit own blog')) { - $output = '- '. $output .'
'. l(t('more'), 'blog', array('title' => t('Read the latest blog entries.'))) .''; - $block['subject'] = t('Recent blog posts'); - return $block; - } - } - } -} - - diff --git a/modules/blogapi/blogapi.module b/modules/blogapi/blogapi.module deleted file mode 100644 index ce025f913fc89e88cbe662c2adc8453e38b8de79..0000000000000000000000000000000000000000 --- a/modules/blogapi/blogapi.module +++ /dev/null @@ -1,737 +0,0 @@ -'. t('The blog API module enables a post to be posted to a site via external GUI applications. Many users perfer to use external tools to improve their ability to read and post responses in a customized way. The blog api provides users the freedom to use the blogging tools they want but still have the blogging server of choice.') .''; - $output .= ''. t('When this module is enabled and configured you can use programs like Ecto to create and publish posts from your desktop. Blog API module supports several XML-RPC based blogging APIs such as the Blogger API, MetaWeblog API, and most of the Movable Type API. Any desktop blogging tools or other services (e.g. Flickr\'s "post to blog") that support these APIs should work with this site.', array('%external-http-ecto-kung-foo-tv' => 'http://ecto.kung-foo.tv/', '%-' => url('http://www.blogger.com/developers/api/1_docs/'), '%external-http-www-xmlrpc-com-metaWeblogApi' => 'http://www.xmlrpc.com/metaWeblogApi', '%external-http-www-movabletype-org-docs-mtmanual_programmatic-html' => 'http://www.movabletype.org/docs/mtmanual_programmatic.html', '%external-http-www-flickr-com' => 'http://www.flickr.com')) .'
'; - $output .= ''. t('This module also allows site administrators to configure which content types can be posted via the external applications. So, for instance, users can post forum topics as well as blog posts. Where supported, the external applications will display each content type as a separate "blog".') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook BlogApi page.', array('%blogapi' => 'http://drupal.org/handbook/modules/blogapi/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to post content using applications that support XML-RPC blog APIs.'); - } -} - -/** - * Implementation of hook_xmlrpc(). - */ -function blogapi_xmlrpc() { - return array( - array( - 'blogger.getUsersBlogs', - 'blogapi_blogger_get_users_blogs', - array('array', 'string', 'string', 'string'), - t('Returns a list of weblogs to which an author has posting privileges.')), - array( - 'blogger.getUserInfo', - 'blogapi_blogger_get_user_info', - array('struct', 'string', 'string', 'string'), - t('Returns information about an author in the system.')), - array( - 'blogger.newPost', - 'blogapi_blogger_new_post', - array('string', 'string', 'string', 'string', 'string', 'string', 'boolean'), - t('Creates a new post, and optionally publishes it.')), - array( - 'blogger.editPost', - 'blogapi_blogger_edit_post', - array('boolean', 'string', 'string', 'string', 'string', 'string', 'boolean'), - t('Updates the information about an existing post.')), - array( - 'blogger.getPost', - 'blogapi_blogger_get_post', - array('struct', 'string', 'string', 'string', 'string'), - t('Returns information about a specific post.')), - array( - 'blogger.deletePost', - 'blogapi_blogger_delete_post', - array('boolean', 'string', 'string', 'string', 'string', 'boolean'), - t('Deletes a post.')), - array( - 'blogger.getRecentPosts', - 'blogapi_blogger_get_recent_posts', - array('array', 'string', 'string', 'string', 'string', 'int'), - t('Returns a list of the most recent posts in the system.')), - array( - 'metaWeblog.newPost', - 'blogapi_metaweblog_new_post', - array('string', 'string', 'string', 'string', 'struct', 'boolean'), - t('Creates a new post, and optionally publishes it.')), - array( - 'metaWeblog.editPost', - 'blogapi_metaweblog_edit_post', - array('boolean', 'string', 'string', 'string', 'struct', 'boolean'), - t('Updates information about an existing post.')), - array( - 'metaWeblog.getPost', - 'blogapi_metaweblog_get_post', - array('struct', 'string', 'string', 'string'), - t('Returns information about a specific post.')), - array( - 'metaWeblog.newMediaObject', - 'blogapi_metaweblog_new_media_object', - array('string', 'string', 'string', 'string', 'struct'), - t('Uploads a file to your webserver.')), - array( - 'metaWeblog.getCategories', - 'blogapi_metaweblog_get_category_list', - array('struct', 'string', 'string', 'string'), - t('Returns a list of all categories to which the post is assigned.')), - array( - 'metaWeblog.getRecentPosts', - 'blogapi_metaweblog_get_recent_posts', - array('array', 'string', 'string', 'string', 'int'), - t('Returns a list of the most recent posts in the system.')), - array( - 'mt.getRecentPostTitles', - 'blogapi_mt_get_recent_post_titles', - array('array', 'string', 'string', 'string', 'int'), - t('Returns a bandwidth-friendly list of the most recent posts in the system.')), - array( - 'mt.getCategoryList', - 'blogapi_mt_get_category_list', - array('array', 'string', 'string', 'string'), - t('Returns a list of all categories defined in the weblog.')), - array( - 'mt.getPostCategories', - 'blogapi_mt_get_post_categories', - array('array', 'string', 'string', 'string'), - t('Returns a list of all categories to which the post is assigned.')), - array( - 'mt.setPostCategories', - 'blogapi_mt_set_post_categories', - array('boolean', 'string', 'string', 'string', 'array'), - t('Sets the categories for a post.')), - array( - 'mt.supportedMethods', - 'xmlrpc_server_list_methods', - array('array'), - t('Retrieve information about the XML-RPC methods supported by the server.')), - array( - 'mt.supportedTextFilters', - 'blogapi_mt_supported_text_filters', - array('array'), - t('Retrieve information about the text formatting plugins supported by the server.')), - array( - 'mt.getTrackbackPings', - 'blogapi_mt_get_trackback_pings', - array('array', 'string'), - t('Retrieve the list of TrackBack pings posted to a particular entry. This could be used to programmatically retrieve the list of pings for a particular entry, then iterate through each of those pings doing the same, until one has built up a graph of the web of entries referencing one another on a particular topic.')), - array( - 'mt.publishPost', - 'blogap_mti_publish_post', - array('boolean', 'string', 'string', 'string'), - t('Publish (rebuild) all of the static files related to an entry from your weblog. Equivalent to saving an entry in the system (but without the ping).'))); -} - -/** - * Blogging API callback. Finds the URL of a user's blog. - */ - -function blogapi_blogger_get_users_blogs($appid, $username, $password) { - - $user = blogapi_validate_user($username, $password); - if ($user->uid) { - $types = _blogapi_get_node_types(); - $structs = array(); - foreach ($types as $type) { - $structs[] = array('url' => url('blog/' . $user->uid, NULL, NULL, true), 'blogid' => $type, 'blogName' => $user->name . ": " . $type); - } - return $structs; - } - else { - return blogapi_error($user); - } -} - -/** - * Blogging API callback. Returns profile information about a user. - */ -function blogapi_blogger_get_user_info($appkey, $username, $password) { - $user = blogapi_validate_user($username, $password); - - if ($user->uid) { - $name = explode(' ', $user->realname ? $user->realname : $user->name, 2); - return array( - 'userid' => $user->uid, - 'lastname' => $name[1], - 'firstname' => $name[0], - 'nickname' => $user->name, - 'email' => $user->mail, - 'url' => url('blog/' . $user->uid, NULL, NULL, true)); - } - else { - return blogapi_error($user); - } -} - -/** - * Blogging API callback. Inserts a new blog post as a node. - */ -function blogapi_blogger_new_post($appkey, $blogid, $username, $password, $content, $publish) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $edit = array(); - $edit['type'] = _blogapi_blogid($blogid); - // get the node type defaults - $node_type_default = variable_get('node_options_'. $edit['type'], array('status', 'promote')); - $edit['uid'] = $user->uid; - $edit['name'] = $user->name; - $edit['promote'] = in_array('promote', $node_type_default); - $edit['comment'] = variable_get('comment_'. $edit['type'], 2); - $edit['moderate'] = in_array('moderate', $node_type_default); - $edit['revision'] = in_array('revision', $node_type_default); - $edit['format'] = FILTER_FORMAT_DEFAULT; - $edit['status'] = $publish; - - // check for bloggerAPI vs. metaWeblogAPI - if (is_array($content)) { - $edit['title'] = $content['title']; - $edit['body'] = $content['description']; - _blogapi_mt_extra($edit, $content); - } - else { - $edit['title'] = blogapi_blogger_title($content); - $edit['body'] = $content; - } - - if (!node_access('create', $edit['type'])) { - return blogapi_error(t('You do not have permission to create the type of post you wanted to create.')); - } - - if (user_access('administer nodes') && !isset($edit['date'])) { - $edit['date'] = format_date(time(), 'custom', 'Y-m-d H:i:s O'); - } - - node_validate($edit); - if ($errors = form_get_errors()) { - return blogapi_error(implode("\n", $errors)); - } - - $node = node_submit($edit); - node_save($node); - if ($node->nid) { - watchdog('content', t('%type: added %title using blog API.', array('%type' => ''. t($node->type) .'', '%title' => theme('placeholder', $node->title))), WATCHDOG_NOTICE, l(t('view'), "node/$node->nid")); - // blogger.newPost returns a string so we cast the nid to a string by putting it in double quotes: - return "$node->nid"; - } - - return blogapi_error(t('Error storing post.')); -} - -/** - * Blogging API callback. Modifies the specified blog node. - */ -function blogapi_blogger_edit_post($appkey, $postid, $username, $password, $content, $publish) { - - $user = blogapi_validate_user($username, $password); - - if (!$user->uid) { - return blogapi_error($user); - } - - $node = node_load($postid); - if (!$node) { - return blogapi_error(message_na()); - } - // Let the teaser be re-generated. - unset($node->teaser); - - if (!node_access('update', $node)) { - return blogapi_error(t('You do not have permission to update this post.')); - } - - $node->status = $publish; - - // check for bloggerAPI vs. metaWeblogAPI - if (is_array($content)) { - $node->title = $content['title']; - $node->body = $content['description']; - _blogapi_mt_extra($node, $content); - } - else { - $node->title = blogapi_blogger_title($content); - $node->body = $content; - } - - node_validate($node); - if ($errors = form_get_errors()) { - return blogapi_error(implode("\n", $errors)); - } - - if (user_access('administer nodes') && !isset($edit['date'])) { - $node->date = format_date($node->created, 'custom', 'Y-m-d H:i:s O'); - } - $node = node_submit($node); - node_save($node); - if ($node->nid) { - watchdog('content', t('%type: updated %title using blog API.', array('%type' => ''. t($node->type) .'', '%title' => theme('placeholder', $node->title))), WATCHDOG_NOTICE, l(t('view'), "node/$node->nid")); - return true; - } - - return blogapi_error(t('Error storing post.')); -} - -/** - * Blogging API callback. Returns a specified blog node. - */ -function blogapi_blogger_get_post($appkey, $postid, $username, $password) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $node = node_load($postid); - - return _blogapi_get_post($node, true); -} - -/** - * Blogging API callback. Removes the specified blog node. - */ -function blogapi_blogger_delete_post($appkey, $postid, $username, $password, $publish) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - node_delete($postid); - return true; -} - -/** - * Blogging API callback. Returns the latest few postings in a user's blog. $bodies TRUE - * - * returns a bandwidth-friendly list. - */ -function blogapi_blogger_get_recent_posts($appkey, $blogid, $username, $password, $number_of_posts, $bodies = TRUE) { - // Remove unused appkey (from bloggerAPI). - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $type = _blogapi_blogid($blogid); - if ($bodies) { - $result = db_query_range("SELECT n.nid, n.title, r.body, n.created, u.name FROM {node} n, {node_revisions} r, {users} u WHERE n.uid = u.uid AND n.vid = r.vid AND n.type = '%s' AND n.uid = %d ORDER BY n.created DESC", $type, $user->uid, 0, $number_of_posts); - } - else { - $result = db_query_range("SELECT n.nid, n.title, n.created, u.name FROM {node} n, {users} u WHERE n.uid = u.uid AND n.type = '%s' AND n.uid = %d ORDER BY n.created DESC", $type, $user->uid, 0, $number_of_posts); - } - $blogs = array (); - while ($blog = db_fetch_object($result)) { - $blogs[] = _blogapi_get_post($blog, $bodies); - } - return $blogs; -} - -function blogapi_metaweblog_new_post($blogid, $username, $password, $content, $publish) { - return blogapi_blogger_new_post('0123456789ABCDEF', $blogid, $username, $password, $content, $publish); -} - -function blogapi_metaweblog_edit_post($postid, $username, $password, $content, $publish) { - return blogapi_blogger_edit_post('0123456789ABCDEF', $postid, $username, $password, $content, $publish); -} - -function blogapi_metaweblog_get_post($postid, $username, $password) { - return blogapi_blogger_get_post('01234567890ABCDEF', $postid, $username, $password); -} - -/** - * Blogging API callback. Inserts a file into Drupal. - */ -function blogapi_metaweblog_new_media_object($blogid, $username, $password, $file) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $name = basename($file['name']); - $data = $file['bits']; - - if (!$data) { - return blogapi_error(t('No file sent.')); - } - - if (!$file = file_save_data($data, $name)) { - return blogapi_error(t('Error storing file.')); - } - - // Return the successful result. - return array('url' => file_create_url($file), 'struct'); -} -/** - * Blogging API callback. Returns a list of the taxonomy terms that can be - * associated with a blog node. - */ -function blogapi_metaweblog_get_category_list($blogid, $username, $password) { - $type = _blogapi_blogid($blogid); - $vocabularies = module_invoke('taxonomy', 'get_vocabularies', $type, 'vid'); - $categories = array(); - if ($vocabularies) { - foreach ($vocabularies as $vocabulary) { - $terms = module_invoke('taxonomy', 'get_tree', $vocabulary->vid, 0, -1); - foreach ($terms as $term) { - $term_name = $term->name; - foreach (module_invoke('taxonomy', 'get_parents', $term->tid, 'tid') as $parent) { - $term_name = $parent->name . '/' . $term_name; - } - $categories[] = array('categoryName' => $term_name, 'categoryId' => $term->tid); - } - } - } - return $categories; -} - -function blogapi_metaweblog_get_recent_posts($blogid, $username, $password, $number_of_posts) { - return blogapi_blogger_get_recent_posts('0123456789ABCDEF', $blogid, $username, $password, $number_of_posts, TRUE); -} - -// see above -function blogapi_mt_get_recent_post_titles($blogid, $username, $password, $number_of_posts) { - return blogapi_blogger_get_recent_posts('0123456789ABCDEF', $blogid, $username, $password, $number_of_posts, FALSE); -} - -/* **** */ -function blogapi_mt_get_category_list($blogid, $username, $password) { - return blogapi_metaweblog_get_category_list($blogid, $username, $password); -} - -/** - * Blogging API callback. Returns a list of the taxonomy terms that are - * assigned to a particular node. - */ -function blogapi_mt_get_post_categories($postid, $username, $password) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $terms = module_invoke('taxonomy', 'node_get_terms', $postid, 'tid'); - $categories = array(); - foreach ($terms as $term) { - $term_name = $term->name; - foreach (module_invoke('taxonomy', 'get_parents', $term->tid, 'tid') as $parent) { - $term_name = $parent->name . '/' . $term_name; - } - $categories[] = array('categoryName' => $term_name, 'categoryId' => $term->tid, 'isPrimary' => true); - } - return $categories; -} - -/** - * Blogging API callback. Assigns taxonomy terms to a particular node. - */ -function blogapi_mt_set_post_categories($postid, $username, $password, $categories) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - - $node = node_load($postid); - $node->taxonomy = array(); - foreach ($categories as $category) { - $node->taxonomy[] = $category['categoryId']; - } - node_save($node); - return TRUE; -} - -/** - * Blogging API callback. Sends a list of available input formats. - */ -function blogapi_mt_supported_text_filters() { - // NOTE: we're only using anonymous' formats because the MT spec - // does not allow for per-user formats. - $formats = filter_formats(); - - $filters = array(); - foreach ($formats as $format) { - $filter['key'] = $format->format; - $filter['label'] = $format->name; - $filters[] = $filter; - } - - return $filters; -} - -/** - * Blogging API callback. Can not be implemented without support from - * trackback module. - */ -function blogapi_mt_get_trackback_pings() { - return blogapi_error(t('Not implemented.')); -} - -/** - * Blogging API callback. Publishes the given node - */ -function blogap_mti_publish_post($postid, $username, $password) { - $user = blogapi_validate_user($username, $password); - if (!$user->uid) { - return blogapi_error($user); - } - $node = node_load($postid); - if (!$node) { - return blogapi_error(t('Invalid post.')); - } - - $node->status = 1; - if (!node_access('update', $node)) { - return blogapi_error(t('You do not have permission to update this post.')); - } - - node_save($node); - - return true; -} - -/** - * Prepare an error message for returning to the XMLRPC caller. - */ -function blogapi_error($message) { - static $xmlrpcusererr; - if (!is_array($message)) { - $message = array($message); - } - - $message = implode(' ', $message); - - return xmlrpc_error($xmlrpcusererr + 1, strip_tags($message)); -} - -/** - * Ensure that the given user has permission to edit a blog. - */ -function blogapi_validate_user($username, $password) { - global $user; - - $user = user_authenticate($username, $password); - - if ($user->uid) { - if (user_access('edit own blog', $user)) { - return $user; - } - else { - return t("You either tried to edit somebody else's blog or you don't have permission to edit your own blog."); - } - } - else { - return t('Wrong username or password.'); - } -} - -/** - * For the blogger API, extract the node title from the contents field. - */ -function blogapi_blogger_title(&$contents) { - if (eregi('([^<]*) ', $contents, $title)) { - $title = strip_tags($title[0]); - $contents = ereg_replace('[^<]* ', '', $contents); - } - else { - list($title, $contents) = explode("\n", $contents, 2); - } - return $title; -} - -function blogapi_settings() { - $form['blogapi_engine'] = array( - '#type' => 'select', '#title' => t('XML-RPC Engine'), '#default_value' => variable_get('blogapi_engine', 0), - '#options' => array(0 => 'Blogger', 1 => 'MetaWeblog', 2 => 'Movabletype'), - '#description' => t('RSD or Really-Simple-Discovery is a mechanism which allows external blogger tools to discover the APIs they can use to interact with Drupal. Here you can set the preferred method for blogger tools to interact with your site. The common XML-RPC engines are Blogger, MetaWeblog and Movabletype. If you are not sure which is the correct setting, choose Blogger.') - ); - - $node_types = node_get_types(); - $defaults = isset($node_types['blog']) ? array('blog' => 1) : array(); - $form['blogapi_node_types'] = array( - '#type' => 'checkboxes', '#title' => t('Blog types'), '#required' => TRUE, - '#default_value' => variable_get('blogapi_node_types', $defaults), '#options' => $node_types, - '#description' => t('Select the content types for which you wish to enable posting via blogapi. Each type will appear as a different "blog" in the client application (if supported).') - ); - - return $form; -} - -function blogapi_menu($may_cache) { - $items = array(); - - if (drupal_get_path_alias($_GET['q']) == variable_get('site_frontpage', 'node')) { - drupal_add_link(array('rel' => 'EditURI', - 'type' => 'application/rsd+xml', - 'title' => t('RSD'), - 'href' => url('blogapi/rsd', NULL, NULL, TRUE))); - } - - if ($may_cache) { - $items[] = array('path' => 'blogapi', 'title' => t('RSD'), 'callback' => 'blogapi_blogapi', 'access' => user_access('access content'), 'type' => MENU_CALLBACK); - } - - return $items; -} - -function blogapi_blogapi() { - switch (arg(1)) { - case 'rsd': - blogapi_rsd(); - break; - default: - drupal_not_found(); - break; - } -} - -function blogapi_rsd() { - global $base_url; - - $xmlrpc = $base_url .'/'. 'xmlrpc.php'; - $base = url('', NULL, NULL, TRUE); - $blogid = 1; # until we figure out how to handle multiple bloggers - - drupal_set_header('Content-Type: application/rsd+xml; charset=utf-8'); - print <<<__RSD__ - -- -__RSD__; -} - -/** - * Handles extra information sent by clients according to MovableType's spec. - */ -function _blogapi_mt_extra(&$node, $struct) { - if (is_array($node)) { - $was_array = true; - $node = (object)$node; - } - - // mt_allow_comments - if (array_key_exists('mt_allow_comments', $struct)) { - switch ($struct['mt_allow_comments']) { - case 0: - $node->comment = COMMENT_NODE_DISABLED; - break; - case 1: - $node->comment = COMMENT_NODE_READ_WRITE; - break; - case 2: - $node->comment = COMMENT_NODE_READ_ONLY; - break; - } - } - - // merge the 3 body sections (description, mt_excerpt, mt_text_more) into - // one body - if ($struct['mt_excerpt']) { - $node->body = $struct['mt_excerpt'] .''.$node->body; - } - if ($struct['mt_text_more']) { - $node->body = $node->body . '' . $struct['mt_text_more']; - } - - // mt_tb_ping_urls - if (function_exists('trackback_send')) { - if (is_array($struct['mt_tb_ping_urls'])) { - foreach ($struct['mt_tb_ping_urls'] as $tb_ping_url) { - $node->tb_url = $tb_ping_url->getVal(); - trackback_send($node); - unset($node->tb_url); // make sure we don't ping twice - } - } - else { - $node->tb_url = $struct['mt_tb_ping_urls']; - } - } - - // mt_convert_breaks - if ($struct['mt_convert_breaks']) { - $node->format = $struct['mt_convert_breaks']; - } - - // dateCreated - if ($struct['dateCreated']) { - $node->date = format_date(mktime($struct['dateCreated']->hour, $struct['dateCreated']->minute, $struct['dateCreated']->second, $struct['dateCreated']->month, $struct['dateCreated']->day, $struct['dateCreated']->year), 'custom', 'Y-m-d H:i:s O'); - } - - if ($was_array) { - $node = (array)$node; - } -} - -function _blogapi_get_post($node, $bodies = true) { - $xmlrpcval = array ( - 'userid' => $node->name, - 'dateCreated' => xmlrpc_date($node->created), - 'title' => $node->title, - 'postid' => $node->nid, - 'link' => url('node/'.$node->nid, NULL, NULL, true), - 'permaLink' => url('node/'.$node->nid, NULL, NULL, true), - ); - if ($bodies) { - if ($node->comment = 1) { - $comment = 2; - } - if ($node->comment = 2) { - $comment = 1; - } - - $xmlrpcval['content'] = "- -Drupal -http://drupal.org/ -$base -- -- - - $node->title $node->body"; - $xmlrpcval['description'] = $node->body; - // Add MT specific fields - $xmlrpcval['mt_allow_comments'] = $comment; - $xmlrpcval['mt_convert_breaks'] = $node->format; - } - - return $xmlrpcval; -} - -function _blogapi_blogid($id) { - if (is_numeric($id)) { - return 'blog'; - } - else { - return $id; - } -} - -function _blogapi_get_node_types() { - $available_types = array_keys(array_filter(variable_get('blogapi_node_types', array('blog' => 1)))); - $types = array(); - foreach (node_get_types() as $type => $name) { - if (node_access('create', $type) && in_array($type, $available_types)) { - $types[] = $type; - } - } - - return $types; -} - diff --git a/modules/book/book.module b/modules/book/book.module deleted file mode 100644 index 0f8fc78df18730393b6e908bfe43283d3f5342d6..0000000000000000000000000000000000000000 --- a/modules/book/book.module +++ /dev/null @@ -1,1045 +0,0 @@ - array('name' => t('book page'), 'base' => 'book')); -} - -/** - * Implementation of hook_perm(). - */ -function book_perm() { - return array('outline posts in books', 'create book pages', 'create new books', 'edit book pages', 'edit own book pages', 'see printer-friendly version'); -} - -/** - * Implementation of hook_access(). - */ -function book_access($op, $node) { - global $user; - - if ($op == 'create') { - // Only registered users can create book pages. Given the nature - // of the book module this is considered to be a good/safe idea. - return user_access('create book pages'); - } - - if ($op == 'update') { - // Only registered users can update book pages. Given the nature - // of the book module this is considered to be a good/safe idea. - // One can only update a book page if there are no suggested updates - // of that page waiting for approval. That is, only updates that - // don't overwrite the current or pending information are allowed. - - if ((user_access('edit book pages') && !$node->moderate) || ($node->uid == $user->uid && user_access('edit own book pages'))) { - return TRUE; - } - else { - // do nothing. node-access() will determine further access - } - } -} - -/** - * Implementation of hook_link(). - */ -function book_link($type, $node = 0, $main = 0) { - - $links = array(); - - if ($type == 'node' && isset($node->parent)) { - if (!$main) { - if (book_access('create', $node)) { - $links[] = l(t('add child page'), "node/add/book/parent/$node->nid"); - } - if (user_access('see printer-friendly version')) { - $links[] = l(t('printer-friendly version'), - 'book/export/html/'. $node->nid, - array('title' => t('Show a printer-friendly version of this book page and its sub-pages.'))); - } - } - } - - return $links; -} - -/** - * Implementation of hook_menu(). - */ -function book_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array( - 'path' => 'book', - 'title' => t('books'), - 'access' => user_access('access content'), - 'type' => MENU_NORMAL_ITEM, - 'weight' => 5); - $items[] = array( - 'path' => 'node/add/book', - 'title' => t('book page'), - 'access' => user_access('create book pages')); - $items[] = array( - 'path' => 'admin/node/book', - 'title' => t('books'), - 'callback' => 'book_admin', - 'access' => user_access('administer nodes'), - 'type' => MENU_LOCAL_TASK, - 'weight' => -1); - $items[] = array( - 'path' => 'admin/node/book/list', - 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK); - $items[] = array( - 'path' => 'admin/node/book/orphan', - 'title' => t('orphan pages'), - 'callback' => 'book_admin_orphan', - 'type' => MENU_LOCAL_TASK, - 'weight' => 8); - $items[] = array( - 'path' => 'book', - 'title' => t('books'), - 'callback' => 'book_render', - 'access' => user_access('access content'), - 'type' => MENU_SUGGESTED_ITEM); - $items[] = array( - 'path' => 'book/export', - 'callback' => 'book_export', - 'access' => user_access('access content'), - 'type' => MENU_CALLBACK); - } - else { - // To avoid SQL overhead, check whether we are on a node page and whether the - // user is allowed to outline posts in books. - if (arg(0) == 'node' && is_numeric(arg(1)) && user_access('outline posts in books')) { - // Only add the outline-tab for non-book pages: - $result = db_query(db_rewrite_sql("SELECT n.nid FROM {node} n WHERE n.nid = %d AND n.type != 'book'"), arg(1)); - if (db_num_rows($result) > 0) { - $items[] = array( - 'path' => 'node/'. arg(1) .'/outline', - 'title' => t('outline'), - 'callback' => 'book_outline', - 'callback arguments' => array(arg(1)), - 'access' => user_access('outline posts in books'), - 'type' => MENU_LOCAL_TASK, - 'weight' => 2); - } - } - } - - return $items; -} - -/** - * Implementation of hook_block(). - * - * Displays the book table of contents in a block when the current page is a - * single-node view of a book node. - */ -function book_block($op = 'list', $delta = 0) { - $block = array(); - if ($op == 'list') { - $block[0]['info'] = t('Book navigation'); - return $block; - } - else if ($op == 'view') { - // Only display this block when the user is browsing a book: - if (arg(0) == 'node' && is_numeric(arg(1))) { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), arg(1)); - if (db_num_rows($result) > 0) { - $node = db_fetch_object($result); - - $path = book_location($node); - $path[] = $node; - - $expand = array(); - foreach ($path as $key => $node) { - $expand[] = $node->nid; - } - - $block['subject'] = check_plain($path[0]->title); - $block['content'] = book_tree($expand[0], 5, $expand); - } - } - - return $block; - } -} - -/** - * Implementation of hook_load(). - */ -function book_load($node) { - global $user; - - $book = db_fetch_object(db_query('SELECT * FROM {book} WHERE vid = %d', $node->vid)); - - if (arg(2) == 'edit' && !user_access('administer nodes')) { - // If a user is about to update a book page, we overload some - // fields to reflect the changes. - if ($user->uid) { - $book->uid = $user->uid; - $book->name = $user->name; - } - else { - $book->uid = 0; - $book->name = ''; - } - } - - return $book; -} - -/** - * Implementation of hook_insert(). - */ -function book_insert($node) { - db_query("INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)", $node->nid, $node->vid, $node->parent, $node->weight); -} - -/** - * Implementation of hook_update(). - */ -function book_update($node) { - if ($node->revision) { - db_query("INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)", $node->nid, $node->vid, $node->parent, $node->weight); - } - else { - db_query("UPDATE {book} SET parent = %d, weight = %d WHERE vid = %d", $node->parent, $node->weight, $node->vid); - } -} - -/** - * Implementation of hook_delete(). - */ -function book_delete(&$node) { - db_query('DELETE FROM {book} WHERE nid = %d', $node->nid); -} - -/** - * Implementation of hook_submit(). - */ -function book_submit(&$node) { - // Set default values for non-administrators. - if (!user_access('administer nodes')) { - $node->weight = 0; - $node->revision = 1; - } -} - -/** - * Implementation of hook_form(). - */ -function book_form(&$node) { - if ($node->nid && !$node->parent && !user_access('create new books')) { - $form['parent'] = array('#type' => 'value', '#value' => $node->parent); - } - else { - $form['parent'] = array('#type' => 'select', - '#title' => t('Parent'), - '#default_value' => ($node->parent ? $node->parent : arg(4)), - '#options' => book_toc($node->nid), - '#weight' => -4, - '#description' => user_access('create new books') ? t('The parent section in which to place this page. Note that each page whose parent is <top-level> is an independent, top-level book.') : t('The parent that this page belongs in.'), - ); - } - - $form['title'] = array('#type' => 'textfield', - '#title' => t('Title'), - '#required' => TRUE, - '#default_value' => $node->title, - '#weight' => -5, - ); - $form['body_filter']['body'] = array('#type' => 'textarea', - '#title' => t('Body'), - '#default_value' => $node->body, - '#rows' => 20, - '#required' => TRUE, - ); - $form['body_filter']['format'] = filter_form($node->format); - - $form['log'] = array( - '#type' => 'textarea', - '#title' => t('Log message'), - '#default_value' => $node->log, - '#weight' => 5, - '#description' => t('An explanation of the additions or updates being made to help other authors understand your motivations.'), - ); - - if (user_access('administer nodes')) { - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $node->weight, - '#delta' => 15, - '#weight' => 5, - '#description' => t('Pages at a given level are ordered first by weight and then by title.'), - ); - } - else { - // If a regular user updates a book page, we create a new revision - // authored by that user: - $form['revision'] = array('#type' => 'hidden', '#value' => 1); - } - - return $form; -} - -/** - * Implementation of function book_outline() - * Handles all book outline operations. - */ -function book_outline($nid) { - $node = node_load($nid); - $page = book_load($node); - - $form['parent'] = array('#type' => 'select', - '#title' => t('Parent'), - '#default_value' => $page->parent, - '#options' => book_toc($node->nid), - '#description' => t('The parent page in the book.'), - ); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $page->weight, - '#delta' => 15, - '#description' => t('Pages at a given level are ordered first by weight and then by title.'), - ); - $form['log'] = array('#type' => 'textarea', - '#title' => t('Log message'), - '#default_value' => $node->log, - '#description' => t('An explanation to help other authors understand your motivations to put this post into the book.'), - ); - - $form['nid'] = array('#type' => 'value', '#value' => $nid); - if ($page->nid) { - $form['update'] = array('#type' => 'submit', - '#value' => t('Update book outline'), - ); - $form['remove'] = array('#type' => 'submit', - '#value' => t('Remove from book outline'), - ); - } - else { - $form['add'] = array('#type' => 'submit', '#value' => t('Add to book outline')); - } - - drupal_set_title(check_plain($node->title)); - return drupal_get_form('book_outline', $form); -} - -/** - * Handles book outline form submissions. - */ -function book_outline_submit($form_id, $form_values) { - $op = $_POST['op']; - $node = node_load($form_values['nid']); - - switch ($op) { - case t('Add to book outline'): - db_query('INSERT INTO {book} (nid, vid, parent, weight) VALUES (%d, %d, %d, %d)', $node->nid, $node->vid, $form_values['parent'], $form_values['weight']); - db_query("UPDATE {node_revisions} SET log = '%s' WHERE vid = %d", $form_values['log'], $node->vid); - drupal_set_message(t('The post has been added to the book.')); - break; - case t('Update book outline'): - db_query('UPDATE {book} SET parent = %d, weight = %d WHERE vid = %d', $form_values['parent'], $form_values['weight'], $node->vid); - db_query("UPDATE {node_revisions} SET log = '%s' WHERE vid = %d", $form_values['log'], $node->vid); - drupal_set_message(t('The book outline has been updated.')); - break; - case t('Remove from book outline'): - db_query('DELETE FROM {book} WHERE nid = %d', $node->nid); - drupal_set_message(t('The post has been removed from the book.')); - break; - } - return "node/$node->nid"; -} - -/** - * Given a node, this function returns an array of 'book node' objects - * representing the path in the book tree from the root to the - * parent of the given node. - * - * @param node - a book node object for which to compute the path - * - * @return - an array of book node objects representing the path of - * nodes root to parent of the given node. Returns an empty array if - * the node does not exist or is not part of a book hierarchy. - * - */ -function book_location($node, $nodes = array()) { - $parent = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d'), $node->parent)); - if ($parent->title) { - $nodes = book_location($parent, $nodes); - $nodes[] = $parent; - } - return $nodes; -} - -/** - * Accumulates the nodes up to the root of the book from the given node in the $nodes array. - */ -function book_location_down($node, $nodes = array()) { - $last_direct_child = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.nid = b.nid WHERE n.status = 1 AND b.parent = %d ORDER BY b.weight DESC, n.title DESC'), $node->nid)); - if ($last_direct_child) { - $nodes[] = $last_direct_child; - $nodes = book_location_down($last_direct_child, $nodes); - } - return $nodes; -} - -/** - * Fetches the node object of the previous page of the book. - */ -function book_prev($node) { - // If the parent is zero, we are at the start of a book so there is no previous. - if ($node->parent == 0) { - return NULL; - } - - // Previous on the same level: - $direct_above = db_fetch_object(db_query(db_rewrite_sql("SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 AND n.moderate = 0 AND (b.weight < %d OR (b.weight = %d AND n.title < '%s')) ORDER BY b.weight DESC, n.title DESC"), $node->parent, $node->weight, $node->weight, $node->title)); - if ($direct_above) { - // Get last leaf of $above. - $path = book_location_down($direct_above); - - return $path ? (count($path) > 0 ? array_pop($path) : NULL) : $direct_above; - } - else { - // Direct parent: - $prev = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.nid = %d AND n.status = 1 AND n.moderate = 0'), $node->parent)); - return $prev; - } -} - -/** - * Fetches the node object of the next page of the book. - */ -function book_next($node) { - // get first direct child - $child = db_fetch_object(db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 AND n.moderate = 0 ORDER BY b.weight ASC, n.title ASC'), $node->nid)); - if ($child) { - return $child; - } - - // No direct child: get next for this level or any parent in this book. - $path[] = book_location($node); // Path to top-level node including this one. - $path[] = $node; - - while (($leaf = array_pop($path)) && count($path)) { - $next = db_fetch_object(db_query(db_rewrite_sql("SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d AND n.status = 1 AND n.moderate = 0 AND (b.weight > %d OR (b.weight = %d AND n.title > '%s')) ORDER BY b.weight ASC, n.title ASC"), $leaf->parent, $leaf->weight, $leaf->weight, $leaf->title)); - if ($next) { - return $next; - } - } -} - -/** - * Returns the content of a given node. If $teaser if true, returns - * the teaser rather than full content. Displays the most recently - * approved revision of a node (if any) unless we have to display this - * page in the context of the moderation queue. - */ -function book_content($node, $teaser = FALSE) { - // Return the page body. - return node_prepare($node, $teaser); -} - -/** - * Implementation of hook_view(). - * - * If not displayed on the main page, we render the node as a page in the - * book with extra links to the previous and next pages. - */ -function book_view(&$node, $teaser = FALSE, $page = FALSE) { - $node = node_prepare($node, $teaser); -} - -/** - * Implementation of hook_nodeapi(). - * - * Appends book navigation to all nodes in the book. - */ -function book_nodeapi(&$node, $op, $teaser, $page) { - switch ($op) { - case 'view': - if (!$teaser) { - $book = db_fetch_array(db_query('SELECT * FROM {book} WHERE vid = %d', $node->vid)); - if ($book) { - if ($node->moderate && user_access('administer nodes')) { - drupal_set_message(t("The post has been submitted for moderation and won't be accessible until it has been approved.")); - } - - foreach ($book as $key => $value) { - $node->$key = $value; - } - - $path = book_location($node); - // Construct the breadcrumb: - $node->breadcrumb = array(); // Overwrite the trail with a book trail. - foreach ($path as $level) { - $node->breadcrumb[] = array('path' => 'node/'. $level->nid, 'title' => $level->title); - } - $node->breadcrumb[] = array('path' => 'node/'. $node->nid); - - $node->body .= theme('book_navigation', $node); - - if ($page) { - menu_set_location($node->breadcrumb); - } - } - } - break; - case 'delete revision': - db_query('DELETE FROM {book} WHERE vid = %d', $node->vid); - break; - case 'delete': - db_query('DELETE FROM {book} WHERE nid = %d', $node->nid); - break; - } -} - -/** - * Prepares the links to children (TOC) and forward/backward - * navigation for a node presented as a book page. - * - * @ingroup themeable - */ -function theme_book_navigation($node) { - $output = ''; - - if ($node->nid) { - $tree = book_tree($node->nid); - - if ($prev = book_prev($node)) { - drupal_add_link(array('rel' => 'prev', 'href' => url('node/'. $prev->nid))); - $links .= l(t('‹ ') . $prev->title, 'node/'. $prev->nid, array('class' => 'page-previous', 'title' => t('Go to previous page'))); - } - if ($node->parent) { - drupal_add_link(array('rel' => 'index', 'href' => url('node/'. $node->parent))); - $links .= l(t('up'), 'node/'. $node->parent, array('class' => 'page-up', 'title' => t('Go to parent page'))); - } - if ($next = book_next($node)) { - drupal_add_link(array('rel' => 'next', 'href' => url('node/'. $next->nid))); - $links .= l($next->title . t(' ›'), 'node/'. $next->nid, array('class' => 'page-next', 'title' => t('Go to next page'))); - } - - if (isset($tree) || isset($links)) { - $output = ''; - } - } - - return $output; -} - -/** - * This is a helper function for book_toc(). - */ -function book_toc_recurse($nid, $indent, $toc, $children, $exclude) { - if ($children[$nid]) { - foreach ($children[$nid] as $foo => $node) { - if (!$exclude || $exclude != $node->nid) { - $toc[$node->nid] = $indent .' '. $node->title; - $toc = book_toc_recurse($node->nid, $indent .'--', $toc, $children, $exclude); - } - } - } - - return $toc; -} - -/** - * Returns an array of titles and nid entries of book pages in table of contents order. - */ -function book_toc($exclude = 0) { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.parent, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 ORDER BY b.weight, n.title')); - - while ($node = db_fetch_object($result)) { - if (!$children[$node->parent]) { - $children[$node->parent] = array(); - } - $children[$node->parent][] = $node; - } - - $toc = array(); - // If the user has permission to create new books, add the top-level book page to the menu; - if (user_access('create new books')) { - $toc[0] = '<'. t('top-level') .'>'; - } - - $toc = book_toc_recurse(0, '', $toc, $children, $exclude); - - return $toc; -} - -/** - * This is a helper function for book_tree() - */ -function book_tree_recurse($nid, $depth, $children, $unfold = array()) { - if ($depth > 0) { - if ($children[$nid]) { - foreach ($children[$nid] as $foo => $node) { - if (in_array($node->nid, $unfold)) { - if ($tree = book_tree_recurse($node->nid, $depth - 1, $children, $unfold)) { - $output .= ''; - } - else { - $output .= '\n"; - } - $output .= book_recurse($nid, $depth, 'book_node_visitor_html_pre', 'book_node_visitor_html_post'); - for ($i = 1; $i < $depth; $i++) { - $output .= "\n"; - - } - $html = "\n"; - $html .= ''; - $html .= "\n". check_plain($node->title) ." \n"; - $html .= ''; - $html .= '' . "\n"; - $html .= "\n"; - $html .= "\n\n". $output . "\n\n\n"; - return $html; - } - else { - drupal_access_denied(); - } -} - -/** - * How the book's HTML export should be themed - * - * @ingroup themeable - */ -function theme_book_export_html($title, $content) { - global $base_url; - $html = "\n"; - $html .= ''; - $html .= "\n ". $title ." \n"; - $html .= ''; - $html .= '' . "\n"; - $html .= "\n"; - $html .= "\n\n". $content . "\n\n\n"; - return $html; -} - -/** - * Traverses the book tree. Applies the $visit_pre() callback to each - * node, is called recursively for each child of the node (in weight, - * title order). Finally appends the output of the $visit_post() - * callback to the output before returning the generated output. - * - * @param nid - * - the node id (nid) of the root node of the book hierarchy. - * @param depth - * - the depth of the given node in the book hierarchy. - * @param visit_pre - * - a function callback to be called upon visiting a node in the tree - * @param visit_post - * - a function callback to be called after visiting a node in the tree, - * but before recursively visiting children. - * @return - * - the output generated in visiting each node - */ -function book_recurse($nid = 0, $depth = 1, $visit_pre, $visit_post) { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND n.nid = %d AND n.moderate = 0 ORDER BY b.weight, n.title'), $nid); - while ($page = db_fetch_object($result)) { - // Load the node: - $node = node_load($page->nid); - - if ($node) { - if (function_exists($visit_pre)) { - $output .= call_user_func($visit_pre, $node, $depth, $nid); - } - else { - $output .= book_node_visitor_html_pre($node, $depth, $nid); - } - - $children = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE n.status = 1 AND b.parent = %d AND n.moderate = 0 ORDER BY b.weight, n.title'), $node->nid); - while ($childpage = db_fetch_object($children)) { - $childnode = node_load($childpage->nid); - if ($childnode->nid != $node->nid) { - $output .= book_recurse($childnode->nid, $depth + 1, $visit_pre, $visit_post); - } - } - if (function_exists($visit_post)) { - $output .= call_user_func($visit_post, $node, $depth); - } - else { - # default - $output .= book_node_visitor_html_post($node, $depth); - } - } - } - - return $output; -} - -/** - * Generates printer-friendly HTML for a node. This function - * is a 'pre-node' visitor function for book_recurse(). - * - * @param $node - * - the node to generate output for. - * @param $depth - * - the depth of the given node in the hierarchy. This - * is used only for generating output. - * @param $nid - * - the node id (nid) of the given node. This - * is used only for generating output. - * @return - * - the HTML generated for the given node. - */ -function book_node_visitor_html_pre($node, $depth, $nid) { - // Output the content: - if (node_hook($node, 'content')) { - $node = node_invoke($node, 'content'); - } - // Allow modules to change $node->body before viewing. - node_invoke_nodeapi($node, 'print', $node->body, false); - - $output .= " nid ."\" class=\"section-$depth\">\n"; - $output .= "\n"; -} - -function _book_admin_table($nodes = array()) { - $form = array( - '#theme' => 'book_admin_table', - '#tree' => TRUE, - ); - - foreach ($nodes as $node) { - $form = array_merge($form, _book_admin_table_tree($node, 0)); - } - - return $form; -} - -function _book_admin_table_tree($node, $depth) { - $form = array(); - - $form[] = array( - 'nid' => array('#type' => 'value', '#value' => $node->nid), - 'depth' => array('#type' => 'value', '#value' => $depth), - 'title' => array( - '#type' => 'textfield', - '#default_value' => $node->title, - '#maxlength' => 255, - ), - 'weight' => array( - '#type' => 'weight', - '#default_value' => $node->weight, - '#delta' => 15, - ), - ); - - $children = db_query(db_rewrite_sql('SELECT n.nid, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = %d ORDER BY b.weight, n.title'), $node->nid); - while ($child = db_fetch_object($children)) { - $form = array_merge($form, _book_admin_table_tree(node_load($child->nid), $depth + 1)); - } - - return $form; -} - -function theme_book_admin_table($form) { - $header = array(t('Title'), t('Weight'), array('data' => t('Operations'), 'colspan' => '3')); - - $rows = array(); - foreach (element_children($form) as $key) { - $nid = $form[$key]['nid']['#value']; - $rows[] = array( - '". check_plain($node->title) ."
\n"; - - if ($node->body) { - $output .= $node->body; - } - return $output; -} - -/** - * Finishes up generation of printer-friendly HTML after visiting a - * node. This function is a 'post-node' visitor function for - * book_recurse(). - */ -function book_node_visitor_html_post($node, $depth) { - return "'. form_render($form[$key]['title']) .'', - form_render($form[$key]['weight']), - l(t('view'), 'node/'. $nid), - l(t('edit'), 'node/'. $nid .'/edit'), - l(t('delete'), 'node/'. $nid .'/delete') - ); - } - - return theme('table', $header, $rows); -} - -/** - * Display an administrative view of the hierarchy of a book. - */ -function book_admin_edit($nid) { - $node = node_load($nid); - if ($node->nid) { - drupal_set_title(check_plain($node->title)); - $form = array(); - - $form['table'] = _book_admin_table(array($node)); - $form['save'] = array( - '#type' => 'submit', - '#value' => t('Save book pages'), - ); - - return drupal_get_form('book_admin_edit', $form); - } - else { - drupal_not_found(); - } -} - -/** - * Menu callback; displays a listing of all orphaned book pages. - */ -function book_admin_orphan() { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, n.status, b.parent FROM {node} n INNER JOIN {book} b ON n.vid = b.vid')); - - $pages = array(); - while ($page = db_fetch_object($result)) { - $pages[$page->nid] = $page; - } - - $orphans = array(); - if (count($pages)) { - foreach ($pages as $page) { - if ($page->parent && empty($pages[$page->parent])) { - $orphans[] = node_load($page->nid); - } - } - } - - if (count($orphans)) { - $form = array(); - - $form['table'] = _book_admin_table($orphans); - $form['save'] = array( - '#type' => 'submit', - '#value' => t('Save book pages'), - ); - - return drupal_get_form('book_admin_edit', $form); - } - else { - return ''. t('There are no orphan pages.') .'
'; - } -} - -function book_admin_edit_submit($form_id, $form_values) { - foreach ($form_values['table'] as $row) { - $node = node_load($row['nid']); - - if ($row['title'] != $node->title || $row['weight'] != $node->weight) { - $node->title = $row['title']; - $node->weight = $row['weight']; - - node_save($node); - watchdog('content', t('%type: updated %title.', array('%type' => theme('placeholder', t('book')), '%title' => theme('placeholder', $node->title))), WATCHDOG_NOTICE, l(t('view'), 'node/'. $node->nid)); - } - } - - if (is_numeric(arg(3))) { - // Updating pages in a single book. - $book = node_load(arg(3)); - drupal_set_message(t('Updated book %title.', array('%title' => theme('placeholder', $book->title)))); - } - else { - // Updating the orphan pages. - drupal_set_message(t('Updated orphan book pages.')); - } -} - -/** - * Menu callback; displays the book administration page. - */ -function book_admin($nid = 0) { - if ($nid) { - return book_admin_edit($nid); - } - else { - return book_admin_overview(); - } -} - -/** - * Returns an administrative overview of all books. - */ -function book_admin_overview() { - $result = db_query(db_rewrite_sql('SELECT n.nid, n.title, b.weight FROM {node} n INNER JOIN {book} b ON n.vid = b.vid WHERE b.parent = 0 ORDER BY b.weight, n.title')); - while ($book = db_fetch_object($result)) { - $rows[] = array(l($book->title, "node/$book->nid"), l(t('outline'), "admin/node/book/$book->nid")); - } - $headers = array(t('Book'), t('Operations')); - - return theme('table', $headers, $rows); -} - -/** - * Implementation of hook_help(). - */ -function book_help($section) { - switch ($section) { - case 'admin/help#book': - $output = ''. t('The book content type is suited for creating structured, multi-page hypertexts such as site resource guides, manuals, and Frequently Asked Questions (FAQs). It permits a document to have chapters, sections, subsections, etc. Authors with suitable permissions can add pages to a collaborative book, placing them into the existing document by adding them to a table of contents menu. ') .'
'; - $output .= ''. t('Books have additional previous, up, and next navigation elements at the bottom of each page for moving through the text. Additional navigation may be provided by enabling the book navigation block on the block administration page.', array('%admin-block' => url('admin/block'))) .'
'; - $output .= ''. t('Users can select the printer-friendly version link visible at the bottom of a book page to generate a printer-friendly display of the page and all of its subsections. ') .'
'; - $output .= ''. t('Administrators can view a book outline, from which is it possible to change the titles of sections, and their weight (thus reordering sections). From this outline, it is also possible to edit and/or delete book pages. Many content types besides pages (for example, blog entries, stories, and polls) can be added to a collaborative book by choosing the outline tab when viewing the post.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Book page.', array('%book' => 'http://drupal.org/handbook/modules/book/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to collaboratively author a book.'); - case 'admin/node/book': - return t('The book module offers a means to organize content, authored by many users, in an online manual, outline or FAQ.
'); - case 'admin/node/book/orphan': - return t('Pages in a book are like a tree. As pages are edited, reorganized and removed, child pages might be left with no link to the rest of the book. Such pages are referred to as "orphan pages". On this page, administrators can review their books for orphans and reattach those pages as desired.
'); - case 'node/add#book': - return t("A book is a collaborative writing effort: users can collaborate writing the pages of the book, positioning the pages in the right order, and reviewing or modifying pages previously written. So when you have some information to share or when you read a page of the book and you didn't like it, or if you think a certain page could have been written better, you can do something about it."); - } - - if (arg(0) == 'node' && is_numeric(arg(1)) && arg(2) == 'outline') { - return t('The outline feature allows you to include posts in the book hierarchy.', array('%book' => url('book'))); - } -} - - diff --git a/modules/comment/comment.module b/modules/comment/comment.module deleted file mode 100644 index 755eff9ad699ab58618c40a4787d0c5fcc074787..0000000000000000000000000000000000000000 --- a/modules/comment/comment.module +++ /dev/null @@ -1,1725 +0,0 @@ -'. t('The comment module creates a discussion board for each post. Users can post comments to discuss a forum topic, weblog post, story, collaborative book page, etc. The ability to comment is an important part of involving members in a communtiy dialogue.') .''; - $output .= ''. t('An administrator can give comment permissions to user groups, and users can (optionally) edit their last comment, assuming no others have been posted since. Attached to each comment board is a control panel for customizing the way that comments are displayed. Users can control the chronological ordering of posts (newest or oldest first) and the number of posts to display on each page. Comments behave like other user submissions. Filters, smileys and HTML that work in nodes will also work with comments. The comment module provides specific features to inform site members when new comments have been posted.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Comment page.', array('%comment' => 'http://drupal.org/handbook/modules/comment/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Allows users to comment on and discuss published content.'); - case 'admin/comment': - case 'admin/comment/new': - return t("Below is a list of the latest comments posted to your site. Click on a subject to see the comment, the author's name to edit the author's user information , \"edit\" to modify the text, and \"delete\" to remove their submission.
"); - case 'admin/comment/approval': - return t("Below is a list of the comments posted to your site that need approval. To approve a comment, click on \"edit\" and then change its \"moderation status\" to Approved. Click on a subject to see the comment, the author's name to edit the author's user information, \"edit\" to modify the text, and \"delete\" to remove their submission.
"); - case 'admin/comment/configure': - case 'admin/comment/configure/settings': - return t("Comments can be attached to any node, and their settings are below. The display comes in two types: a \"flat list\" where everything is flush to the left side, and comments come in chronological order, and a \"threaded list\" where replies to other comments are placed immediately below and slightly indented, forming an outline. They also come in two styles: \"expanded\", where you see both the title and the contents, and \"collapsed\" where you only see the title. Preview comment forces a user to look at their comment by clicking on a \"Preview\" button before they can actually add the comment.
"); - } -} - -/** - * Implementation of hook_menu(). - */ -function comment_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $access = user_access('administer comments'); - $items[] = array('path' => 'admin/comment', 'title' => t('comments'), - 'callback' => 'comment_admin_overview', 'access' => $access); - - // Tabs: - $items[] = array('path' => 'admin/comment/list', 'title' => t('list'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/comment/configure', 'title' => t('configure'), - 'callback' => 'comment_configure', 'access' => $access, 'type' => MENU_LOCAL_TASK); - - // Subtabs: - $items[] = array('path' => 'admin/comment/list/new', 'title' => t('published comments'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - $items[] = array('path' => 'admin/comment/list/approval', 'title' => t('approval queue'), - 'callback' => 'comment_admin_overview', 'access' => $access, - 'callback arguments' => array('approval'), - 'type' => MENU_LOCAL_TASK); - - $items[] = array('path' => 'admin/comment/configure/settings', 'title' => t('settings'), - 'type' => MENU_DEFAULT_LOCAL_TASK, 'weight' => -10); - - $items[] = array('path' => 'comment/delete', 'title' => t('delete comment'), - 'callback' => 'comment_delete', 'access' => $access, 'type' => MENU_CALLBACK); - - $access = user_access('post comments'); - $items[] = array('path' => 'comment/edit', 'title' => t('edit comment'), - 'callback' => 'comment_edit', 'access' => $access, 'type' => MENU_CALLBACK); - } - else { - if (arg(0) == 'comment' && arg(1) == 'reply' && is_numeric(arg(2))) { - $node = node_load(arg(2)); - if ($node->nid) { - $items[] = array('path' => 'comment/reply', 'title' => t('reply to comment'), - 'callback' => 'comment_reply', 'access' => node_access('view', $node), 'type' => MENU_CALLBACK); - } - } - if ((arg(0) == 'node') && is_numeric(arg(1)) && is_numeric(arg(2))) { - $items[] = array('path' => ('node/'. arg(1) .'/'. arg(2)), 'title' => t('view'), - 'callback' => 'node_page', - 'type' => MENU_CALLBACK); - } - } - - return $items; -} - -/** - * Implementation of hook_perm(). - */ -function comment_perm() { - return array('access comments', 'post comments', 'administer comments', 'post comments without approval'); -} - -/** - * Implementation of hook_block(). - * - * Generates a block with the most recent comments. - */ -function comment_block($op = 'list', $delta = 0) { - if ($op == 'list') { - $blocks[0]['info'] = t('Recent comments'); - return $blocks; - } - else if ($op == 'view' && user_access('access comments')) { - $block['subject'] = t('Recent comments'); - $block['content'] = theme('comment_block'); - return $block; - } -} - -function theme_comment_block() { - $result = db_query_range(db_rewrite_sql('SELECT c.nid, c.subject, c.cid, c.timestamp FROM {comments} c INNER JOIN {node} n ON n.nid = c.nid WHERE n.status = 1 AND c.status = %d ORDER BY c.timestamp DESC', 'c'), COMMENT_PUBLISHED, 0, 10); - $items = array(); - while ($comment = db_fetch_object($result)) { - $items[] = l($comment->subject, 'node/'. $comment->nid, NULL, NULL, 'comment-'. $comment->cid) .'
'. t('%time ago', array('%time' => format_interval(time() - $comment->timestamp))); - } - return theme('item_list', $items); -} - -/** - * Implementation of hook_link(). - */ -function comment_link($type, $node = 0, $main = 0) { - $links = array(); - - if ($type == 'node' && $node->comment) { - - if ($main) { - // Main page: display the number of comments that have been posted. - - if (user_access('access comments')) { - $all = comment_num_all($node->nid); - $new = comment_num_new($node->nid); - - if ($all) { - $links[] = l(format_plural($all, '1 comment', '%count comments'), "node/$node->nid", array('title' => t('Jump to the first comment of this posting.')), NULL, 'comment'); - - if ($new) { - $links[] = l(format_plural($new, '1 new comment', '%count new comments'), "node/$node->nid", array('title' => t('Jump to the first new comment of this posting.')), NULL, 'new'); - } - } - else { - if ($node->comment == COMMENT_NODE_READ_WRITE) { - if (user_access('post comments')) { - $links[] = l(t('add new comment'), "comment/reply/$node->nid", array('title' => t('Add a new comment to this page.')), NULL, 'comment_form'); - } - else { - $links[] = theme('comment_post_forbidden', $node->nid); - } - } - } - } - } - else { - // Node page: add a "post comment" link if the user is allowed to - // post comments, if this node is not read-only, and if the comment form isn't already shown - - if ($node->comment == COMMENT_NODE_READ_WRITE) { - if (user_access('post comments')) { - if (variable_get('comment_form_location', COMMENT_FORM_SEPARATE_PAGE) == COMMENT_FORM_SEPARATE_PAGE) { - $links[] = l(t('add new comment'), "comment/reply/$node->nid", array('title' => t('Share your thoughts and opinions related to this posting.')), NULL, 'comment_form'); - } - } - else { - $links[] = theme('comment_post_forbidden', $node->nid); - } - } - } - } - - if ($type == 'comment') { - $links = comment_links($node, $main); - } - - return $links; -} - -function comment_form_alter($form_id, &$form) { - if (isset($form['type'])) { - if ($form['type']['#value'] .'_node_settings' == $form_id) { - $form['workflow']['comment_'. $form['type']['#value']] = array('#type' => 'radios', '#title' => t('Default comment setting'), '#default_value' => variable_get('comment_'. $form['type']['#value'], COMMENT_NODE_READ_WRITE), '#options' => array(t('Disabled'), t('Read only'), t('Read/Write')), '#description' => t('Users with the administer comments permission will be able to override this setting.')); - } - if ($form['type']['#value'] .'_node_form' == $form_id) { - $node = $form['#node']; - if (user_access('administer comments')) { - $form['comment_settings'] = array( - '#type' => 'fieldset', - '#title' => t('Comment settings'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - '#weight' => 30, - ); - $form['comment_settings']['comment'] = array( - '#type' => 'radios', - '#parents' => array('comment'), - '#default_value' => $node->comment, - '#options' => array(t('Disabled'), t('Read only'), t('Read/Write')), - ); - } - else { - $form['comment_settings']['comment'] = array( - '#type' => 'value', - '#value' => $node->comment, - ); - } - } - } -} - -/** - * Implementation of hook_nodeapi(). - * - */ -function comment_nodeapi(&$node, $op, $arg = 0) { - switch ($op) { - case 'load': - return db_fetch_array(db_query("SELECT last_comment_timestamp, last_comment_name, comment_count FROM {node_comment_statistics} WHERE nid = %d", $node->nid)); - break; - - case 'prepare': - if (!isset($node->comment)) { - $node->comment = variable_get("comment_$node->type", COMMENT_NODE_READ_WRITE); - } - break; - - case 'insert': - db_query('INSERT INTO {node_comment_statistics} (nid, last_comment_timestamp, last_comment_name, last_comment_uid, comment_count) VALUES (%d, %d, NULL, %d, 0)', $node->nid, $node->created, $node->uid); - break; - - case 'delete': - db_query('DELETE FROM {comments} WHERE nid = %d', $node->nid); - db_query('DELETE FROM {node_comment_statistics} WHERE nid = %d', $node->nid); - break; - - case 'update index': - $text = ''; - $comments = db_query('SELECT subject, comment, format FROM {comments} WHERE nid = %d AND status = %d', $node->nid, COMMENT_PUBLISHED); - while ($comment = db_fetch_object($comments)) { - $text .= ''. check_plain($comment->subject) .'
'. check_markup($comment->comment, $comment->format, FALSE); - } - return $text; - - case 'search result': - $comments = db_result(db_query('SELECT comment_count FROM {node_comment_statistics} WHERE nid = %d', $node->nid)); - return format_plural($comments, '1 comment', '%count comments'); - - case 'rss item': - return array(array('key' => 'comments', 'value' => url('node/'. $node->nid, NULL, 'comment', TRUE))); - } -} - -/** - * Implementation of hook_user(). - * - * Provides signature customization for the user's comments. - */ -function comment_user($type, $edit, &$user, $category = NULL) { - if ($type == 'form' && $category == 'account') { - // when user tries to edit his own data - $form['comment_settings'] = array( - '#type' => 'fieldset', - '#title' => t('Comment settings'), - '#collapsible' => TRUE, - '#weight' => 4); - $form['comment_settings']['signature'] = array( - '#type' => 'textarea', - '#title' => t('Signature'), - '#default_value' => $edit['signature'], - '#description' => t('Your signature will be publicly displayed at the end of your comments.')); - - return $form; - } - elseif ($type == 'delete') { - db_query('UPDATE {comments} SET uid = 0 WHERE uid = %d', $user->uid); - db_query('UPDATE {node_comment_statistics} SET last_comment_uid = 0 WHERE last_comment_uid = %d', $user->uid); - } -} - -/** - * Menu callback; presents the comment settings page. - */ -function comment_configure() { - $form['viewing_options'] = array( - '#type' => 'fieldset', - '#title' => t('Viewing options'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - ); - - $form['viewing_options']['comment_default_mode'] = array( - '#type' => 'radios', - '#title' => t('Default display mode'), - '#default_value' => variable_get('comment_default_mode', COMMENT_MODE_THREADED_EXPANDED), - '#options' => _comment_get_modes(), - '#description' => t('The default view for comments. Expanded views display the body of the comment. Threaded views keep replies together.'), - ); - - $form['viewing_options']['comment_default_order'] = array( - '#type' => 'radios', - '#title' => t('Default display order'), - '#default_value' => variable_get('comment_default_order', COMMENT_ORDER_NEWEST_FIRST), - '#options' => _comment_get_orders(), - '#description' => t('The default sorting for new users and anonymous users while viewing comments. These users may change their view using the comment control panel. For registered users, this change is remembered as a persistent user preference.'), - ); - - $form['viewing_options']['comment_default_per_page'] = array( - '#type' => 'select', - '#title' => t('Default comments per page'), - '#default_value' => variable_get('comment_default_per_page', 50), - '#options' => _comment_per_page(), - '#description' => t('Default number of comments for each page: more comments are distributed in several pages.'), - ); - - $form['viewing_options']['comment_controls'] = array( - '#type' => 'radios', - '#title' => t('Comment controls'), - '#default_value' => variable_get('comment_controls', COMMENT_CONTROLS_HIDDEN), - '#options' => array( - t('Display above the comments'), - t('Display below the comments'), - t('Display above and below the comments'), - t('Do not display')), - '#description' => t('Position of the comment controls box. The comment controls let the user change the default display mode and display order of comments.'), - ); - - $form['posting_settings'] = array( - '#type' => 'fieldset', - '#title' => t('Posting settings'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - ); - - $form['posting_settings']['comment_anonymous'] = array( - '#type' => 'radios', - '#title' => t('Anonymous commenting'), - '#default_value' => variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT), - '#options' => array( - COMMENT_ANONYMOUS_MAYNOT_CONTACT => t('Anonymous posters may not enter their contact information'), - COMMENT_ANONYMOUS_MAY_CONTACT => t('Anonymous posters may leave their contact information'), - COMMENT_ANONYMOUS_MUST_CONTACT => t('Anonymous posters must leave their contact information')), - '#description' => t('This option is enabled when anonymous users have permission to post comments on the permissions page.', array('%url' => url('admin/access'))), - ); - if (!user_access('post comments', user_load(array('uid' => 0)))) { - $form['posting_settings']['comment_anonymous']['#attributes'] = array('disabled' => 'disabled'); - } - - $form['posting_settings']['comment_subject_field'] = array( - '#type' => 'radios', - '#title' => t('Comment subject field'), - '#default_value' => variable_get('comment_subject_field', 1), - '#options' => array(t('Disabled'), t('Enabled')), - '#description' => t('Can users provide a unique subject for their comments?'), - ); - - $form['posting_settings']['comment_preview'] = array( - '#type' => 'radios', - '#title' => t('Preview comment'), - '#default_value' => variable_get('comment_preview', COMMENT_PREVIEW_REQUIRED), - '#options' => array(t('Optional'), t('Required')), - ); - - $form['posting_settings']['comment_form_location'] = array( - '#type' => 'radios', - '#title' => t('Location of comment submission form'), - '#default_value' => variable_get('comment_form_location', COMMENT_FORM_SEPARATE_PAGE), - '#options' => array(t('Display on separate page'), t('Display below post or comments')), - ); - - return system_settings_form('comment_settings_form', $form); -} - -/** - * This is *not* a hook_access() implementation. This function is called - * to determine whether the current user has access to a particular comment. - * - * Authenticated users can edit their comments as long they have not been - * replied to. This prevents people from changing or revising their - * statements based on the replies their posts got. Furthermore, users - * can't reply to their own comments and are encouraged instead to extend - * their original comment. - */ -function comment_access($op, $comment) { - global $user; - - if ($op == 'edit') { - return ($user->uid && $user->uid == $comment->uid && comment_num_replies($comment->cid) == 0) || user_access('administer comments'); - } -} - -function comment_node_url() { - return arg(0) .'/'. arg(1); -} - -function comment_edit($cid) { - global $user; - - $comment = db_fetch_object(db_query('SELECT c.*, u.uid, u.name AS registered_name, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d', $cid)); - $comment = drupal_unpack($comment); - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - if (comment_access('edit', $comment)) { - return comment_form((array)$comment); - } - else { - drupal_access_denied(); - } -} - -function comment_reply($nid, $pid = NULL) { - // set the breadcrumb trail - $node = node_load($nid); - menu_set_location(array(array('path' => "node/$nid", 'title' => $node->title), array('path' => "comment/reply/$nid"))); - - $op = isset($_POST['op']) ? $_POST['op'] : ''; - - $output = ''; - - // or are we merely showing the form? - if (user_access('access comments')) { - - if ($op == t('Preview comment')) { - if (user_access('post comments')) { - $output .= comment_form(array('pid' => $pid, 'nid' => $nid), NULL); - } - else { - drupal_set_message(t('You are not authorized to post comments.'), 'error'); - drupal_goto("node/$nid"); - } - } - else { - // if this is a reply to another comment, show that comment first - // else, we'll just show the user the node they're commenting on. - if ($pid) { - if ($comment = db_fetch_object(db_query('SELECT c.*, u.uid, u.name AS registered_name, u.picture, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status = %d', $pid, COMMENT_PUBLISHED))) { - $comment = drupal_unpack($comment); - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - $output .= theme('comment_view', $comment); - } - else { - drupal_set_message(t('The comment you are replying to does not exist.'), 'error'); - drupal_goto("node/$nid"); - } - } - else if (user_access('access content')) { - $output .= node_view($node); - } - - // should we show the reply box? - if (node_comment_mode($nid) != COMMENT_NODE_READ_WRITE) { - drupal_set_message(t("This discussion is closed: you can't post new comments."), 'error'); - drupal_goto("node/$nid"); - } - else if (user_access('post comments')) { - $output .= comment_form(array('pid' => $pid, 'nid' => $nid), t('Reply')); - } - else { - drupal_set_message(t('You are not authorized to post comments.'), 'error'); - drupal_goto("node/$nid"); - } - } - } - else { - drupal_set_message(t('You are not authorized to view comments.'), 'error'); - drupal_goto("node/$nid"); - } - - return $output; -} - -/** - * Accepts a submission of new or changed comment content. - * - * @param $edit - * A comment array. - * - * @return - * If the comment is successfully saved the comment ID is returned. If the comment - * is not saved, FALSE is returned. - */ -function comment_save($edit) { - global $user; - if (user_access('post comments') && (user_access('administer comments') || node_comment_mode($edit['nid']) == COMMENT_NODE_READ_WRITE)) { - if (!form_get_errors()) { - // Check for duplicate comments. Note that we have to use the - // validated/filtered data to perform such check. - $duplicate = db_result(db_query("SELECT COUNT(cid) FROM {comments} WHERE pid = %d AND nid = %d AND subject = '%s' AND comment = '%s'", $edit['pid'], $edit['nid'], $edit['subject'], $edit['comment']), 0); - if ($duplicate != 0) { - watchdog('content', t('Comment: duplicate %subject.', array('%subject' => theme('placeholder', $edit['subject']))), WATCHDOG_WARNING); - } - - if ($edit['cid']) { - // Update the comment in the database. - db_query("UPDATE {comments} SET status = %d, timestamp = %d, subject = '%s', comment = '%s', format = %d, uid = %d, name = '%s', mail = '%s', homepage = '%s' WHERE cid = %d", $edit['status'], $edit['timestamp'], $edit['subject'], $edit['comment'], $edit['format'], $edit['uid'], $edit['name'], $edit['mail'], $edit['homepage'], $edit['cid']); - - _comment_update_node_statistics($edit['nid']); - - // Allow modules to respond to the updating of a comment. - comment_invoke_comment($edit, 'update'); - - - // Add an entry to the watchdog log. - watchdog('content', t('Comment: updated %subject.', array('%subject' => theme('placeholder', $edit['subject']))), WATCHDOG_NOTICE, l(t('view'), 'node/'. $edit['nid'], NULL, NULL, 'comment-'. $edit['cid'])); - } - else { - // Add the comment to database. - $status = user_access('post comments without approval') ? COMMENT_PUBLISHED : COMMENT_NOT_PUBLISHED; - $roles = variable_get('comment_roles', array()); - $score = 0; - - foreach (array_intersect(array_keys($roles), array_keys($user->roles)) as $rid) { - $score = max($roles[$rid], $score); - } - - $users = serialize(array(0 => $score)); - - // Here we are building the thread field. See the comment - // in comment_render(). - if ($edit['pid'] == 0) { - // This is a comment with no parent comment (depth 0): we start - // by retrieving the maximum thread level. - $max = db_result(db_query('SELECT MAX(thread) FROM {comments} WHERE nid = %d', $edit['nid'])); - - // Strip the "/" from the end of the thread. - $max = rtrim($max, '/'); - - // Finally, build the thread field for this new comment. - $thread = int2vancode(vancode2int($max) + 1) .'/'; - } - else { - // This is comment with a parent comment: we increase - // the part of the thread value at the proper depth. - - // Get the parent comment: - $parent = _comment_load($edit['pid']); - - // Strip the "/" from the end of the parent thread. - $parent->thread = (string) rtrim((string) $parent->thread, '/'); - - // Get the max value in _this_ thread. - $max = db_result(db_query("SELECT MAX(thread) FROM {comments} WHERE thread LIKE '%s.%%' AND nid = %d", $parent->thread, $edit['nid'])); - - if ($max == '') { - // First child of this parent. - $thread = $parent->thread .'.'. int2vancode(0) .'/'; - } - else { - // Strip the "/" at the end of the thread. - $max = rtrim($max, '/'); - - // We need to get the value at the correct depth. - $parts = explode('.', $max); - $parent_depth = count(explode('.', $parent->thread)); - $last = $parts[$parent_depth]; - - // Finally, build the thread field for this new comment. - $thread = $parent->thread .'.'. int2vancode(vancode2int($last) + 1) .'/'; - } - } - - $edit['cid'] = db_next_id('{comments}_cid'); - $edit['timestamp'] = time(); - - if ($edit['uid'] == $user->uid) { - $edit['name'] = $user->name; - } - - db_query("INSERT INTO {comments} (cid, nid, pid, uid, subject, comment, format, hostname, timestamp, status, score, users, thread, name, mail, homepage) VALUES (%d, %d, %d, %d, '%s', '%s', %d, '%s', %d, %d, %d, '%s', '%s', '%s', '%s', '%s')", $edit['cid'], $edit['nid'], $edit['pid'], $edit['uid'], $edit['subject'], $edit['comment'], $edit['format'], $_SERVER['REMOTE_ADDR'], $edit['timestamp'], $status, $score, $users, $thread, $edit['name'], $edit['mail'], $edit['homepage']); - - _comment_update_node_statistics($edit['nid']); - - // Tell the other modules a new comment has been submitted. - comment_invoke_comment($edit, 'insert'); - - // Add an entry to the watchdog log. - watchdog('content', t('Comment: added %subject.', array('%subject' => theme('placeholder', $edit['subject']))), WATCHDOG_NOTICE, l(t('view'), 'node/'. $edit['nid'], NULL, NULL, 'comment-'. $edit['cid'])); - } - - // Clear the cache so an anonymous user can see his comment being added. - cache_clear_all(); - - // Explain the approval queue if necessary, and then - // redirect the user to the node he's commenting on. - if ($status == COMMENT_NOT_PUBLISHED) { - drupal_set_message(t('Your comment has been queued for moderation by site administrators and will be published after approval.')); - } - return $edit['cid']; - } - else { - return FALSE; - } - } - else { - $txt = t('Comment: unauthorized comment submitted or comment submitted to a closed node %subject.', array('%subject' => theme('placeholder', $edit['subject']))); - watchdog('content', $txt, WATCHDOG_WARNING); - drupal_set_message($txt, 'error'); - return FALSE; - } -} - -function comment_links($comment, $return = 1) { - global $user; - - $links = array(); - - // If we are viewing just this comment, we link back to the node. - if ($return) { - $links[] = l(t('parent'), comment_node_url(), NULL, NULL, "comment-$comment->cid"); - } - - if (node_comment_mode($comment->nid) == COMMENT_NODE_READ_WRITE) { - if (user_access('administer comments') && user_access('post comments')) { - $links[] = l(t('delete'), "comment/delete/$comment->cid"); - $links[] = l(t('edit'), "comment/edit/$comment->cid"); - $links[] = l(t('reply'), "comment/reply/$comment->nid/$comment->cid"); - } - else if (user_access('post comments')) { - if (comment_access('edit', $comment)) { - $links[] = l(t('edit'), "comment/edit/$comment->cid"); - } - $links[] = l(t('reply'), "comment/reply/$comment->nid/$comment->cid"); - } - else { - $links[] = theme('comment_post_forbidden', $comment->nid); - } - } - - return $links; -} - -function comment_render($node, $cid = 0) { - global $user; - - $mode = $_GET['mode']; - $order = $_GET['order']; - $comments_per_page = $_GET['comments_per_page']; - $comment_page = $_GET['comment_page']; - - $output = ''; - - if (user_access('access comments')) { - // Pre-process variables. - $nid = $node->nid; - if (empty($nid)) { - $nid = 0; - } - - if (empty($mode)) { - $mode = $user->mode ? $user->mode : ($_SESSION['comment_mode'] ? $_SESSION['comment_mode'] : variable_get('comment_default_mode', COMMENT_MODE_THREADED_EXPANDED)); - } - - if (empty($order)) { - $order = $user->sort ? $user->sort : ($_SESSION['comment_sort'] ? $_SESSION['comment_sort'] : variable_get('comment_default_order', COMMENT_ORDER_NEWEST_FIRST)); - } - - if (empty($comments_per_page)) { - $comments_per_page = $user->comments_per_page ? $user->comments_per_page : ($_SESSION['comment_comments_per_page'] ? $_SESSION['comment_comments_per_page'] : variable_get('comment_default_per_page', '50')); - } - - $output .= "\n"; - - if ($cid) { - // Single comment view. - $result = db_query('SELECT c.cid, c.pid, c.nid, c.subject, c.comment, c.format, c.timestamp, c.name, c.mail, c.homepage, u.uid, u.name AS registered_name, u.picture, u.data, c.score, c.users FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status = %d GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.format, c.timestamp, c.name, c.mail, u.picture, c.homepage, u.uid, u.name, u.picture, u.data, c.score, c.users', $cid, COMMENT_PUBLISHED); - - if ($comment = db_fetch_object($result)) { - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - $output .= theme('comment_view', $comment, module_invoke_all('link', 'comment', $comment, 1)); - } - } - else { - // Multiple comment view - $query .= "SELECT c.cid as cid, c.pid, c.nid, c.subject, c.comment, c.format, c.timestamp, c.name, c.mail, c.homepage, u.uid, u.name AS registered_name, u.picture, u.data, c.score, c.users, c.thread FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.nid = %d AND c.status = %d"; - - $query .= ' GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.format, c.timestamp, c.name, c.mail, u.picture, c.homepage, u.uid, u.name, u.picture, u.data, c.score, c.users, c.thread'; - - /* - ** We want to use the standard pager, but threads would need every - ** comment to build the thread structure, so we need to store some - ** extra info. - ** - ** We use a "thread" field to store this extra info. The basic idea - ** is to store a value and to order by that value. The "thread" field - ** keeps this data in a way which is easy to update and convenient - ** to use. - ** - ** A "thread" value starts at "1". If we add a child (A) to this - ** comment, we assign it a "thread" = "1.1". A child of (A) will have - ** "1.1.1". Next brother of (A) will get "1.2". Next brother of the - ** parent of (A) will get "2" and so on. - ** - ** First of all note that the thread field stores the depth of the - ** comment: depth 0 will be "X", depth 1 "X.X", depth 2 "X.X.X", etc. - ** - ** Now to get the ordering right, consider this example: - ** - ** 1 - ** 1.1 - ** 1.1.1 - ** 1.2 - ** 2 - ** - ** If we "ORDER BY thread ASC" we get the above result, and this is - ** the natural order sorted by time. However, if we "ORDER BY thread - ** DESC" we get: - ** - ** 2 - ** 1.2 - ** 1.1.1 - ** 1.1 - ** 1 - ** - ** Clearly, this is not a natural way to see a thread, and users - ** will get confused. The natural order to show a thread by time - ** desc would be: - ** - ** 2 - ** 1 - ** 1.2 - ** 1.1 - ** 1.1.1 - ** - ** which is what we already did before the standard pager patch. To - ** achieve this we simply add a "/" at the end of each "thread" value. - ** This way out thread fields will look like depicted below: - ** - ** 1/ - ** 1.1/ - ** 1.1.1/ - ** 1.2/ - ** 2/ - ** - ** we add "/" since this char is, in ASCII, higher than every number, - ** so if now we "ORDER BY thread DESC" we get the correct order. Try - ** it, it works ;). However this would spoil the "ORDER BY thread ASC" - ** Here, we do not need to consider the trailing "/" so we use a - ** substring only. - */ - - if ($order == COMMENT_ORDER_NEWEST_FIRST) { - if ($mode == COMMENT_MODE_FLAT_COLLAPSED || $mode == COMMENT_MODE_FLAT_EXPANDED) { - $query .= ' ORDER BY c.timestamp DESC'; - } - else { - $query .= ' ORDER BY c.thread DESC'; - } - } - else if ($order == COMMENT_ORDER_OLDEST_FIRST) { - if ($mode == COMMENT_MODE_FLAT_COLLAPSED || $mode == COMMENT_MODE_FLAT_EXPANDED) { - $query .= ' ORDER BY c.timestamp'; - } - else { - - /* - ** See comment above. Analysis learns that this doesn't cost - ** too much. It scales much much better than having the whole - ** comment structure. - */ - - $query .= ' ORDER BY SUBSTRING(c.thread, 1, (LENGTH(c.thread) - 1))'; - } - } - - // Start a form, for use with comment control. - $result = pager_query($query, $comments_per_page, 0, "SELECT COUNT(*) FROM {comments} WHERE nid = %d AND status = %d", $nid, COMMENT_PUBLISHED); - if (db_num_rows($result) && (variable_get('comment_controls', COMMENT_CONTROLS_HIDDEN) == COMMENT_CONTROLS_ABOVE || variable_get('comment_controls', COMMENT_CONTROLS_HIDDEN) == COMMENT_CONTROLS_ABOVE_BELOW)) { - $output .= comment_controls($mode, $order, $comments_per_page); - } - - while ($comment = db_fetch_object($result)) { - $comment = drupal_unpack($comment); - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - $comment->depth = count(explode('.', $comment->thread)) - 1; - - if ($mode == COMMENT_MODE_FLAT_COLLAPSED) { - $output .= theme('comment_flat_collapsed', $comment); - } - else if ($mode == COMMENT_MODE_FLAT_EXPANDED) { - $output .= theme('comment_flat_expanded', $comment); - } - else if ($mode == COMMENT_MODE_THREADED_COLLAPSED) { - $output .= theme('comment_thread_collapsed', $comment); - } - else if ($mode == COMMENT_MODE_THREADED_EXPANDED) { - $output .= theme('comment_thread_expanded', $comment); - } - } - - // Use the standard pager; $pager_total is the number of returned rows, - // is global and defined in pager.inc. - $output .= theme('pager', NULL, $comments_per_page, 0, array('comments_per_page' => $comments_per_page)); - - if (db_num_rows($result) && (variable_get('comment_controls', COMMENT_CONTROLS_HIDDEN) == COMMENT_CONTROLS_BELOW || variable_get('comment_controls', COMMENT_CONTROLS_HIDDEN) == COMMENT_CONTROLS_ABOVE_BELOW)) { - $output .= comment_controls($mode, $order, $comments_per_page); - } - } - - // If enabled, show new comment form. - if (user_access('post comments') && node_comment_mode($nid) == COMMENT_NODE_READ_WRITE && (variable_get('comment_form_location', COMMENT_FORM_SEPARATE_PAGE) == COMMENT_FORM_BELOW)) { - $output .= comment_form(array('nid' => $nid), t('Post new comment')); - } - } - return $output; -} - - -/** - * Menu callback; delete a comment. - */ -function comment_delete($cid) { - $comment = db_fetch_object(db_query('SELECT c.*, u.name AS registered_name, u.uid FROM {comments} c INNER JOIN {users} u ON u.uid = c.uid WHERE c.cid = %d', $cid)); - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - - $output = ''; - - // We'll only delete if the user has confirmed the - // deletion using the form in our else clause below. - if ($comment->cid && $_POST['edit']['confirm']) { - drupal_set_message(t('The comment and all its replies have been deleted.')); - - // Delete comment and its replies. - _comment_delete_thread($comment); - - _comment_update_node_statistics($comment->nid); - - // Clear the cache so an anonymous user sees that his comment was deleted. - cache_clear_all(); - - drupal_goto("node/$comment->nid"); - } - else if ($comment->cid) { - $output = confirm_form('comment_confirm_delete', - array(), - t('Are you sure you want to delete the comment %title?', array('%title' => theme('placeholder', $comment->subject))), - 'node/'. $comment->nid, - t('Any replies to this comment will be lost. This action cannot be undone.'), - t('Delete'), - t('Cancel')); - } - else { - drupal_set_message(t('The comment no longer exists.')); - } - - return $output; -} - -/** - * Comment operations. We offer different update operations depending on - * which comment administration page we're on. - */ -function comment_operations($action = NULL) { - if ($action == 'publish') { - $operations = array( - 'publish' => array(t('Publish the selected comments'), 'UPDATE {comments} SET status = '. COMMENT_PUBLISHED .' WHERE cid = %d'), - 'delete' => array(t('Delete the selected comments'), '') - ); - } - else if ($action == 'unpublish') { - $operations = array( - 'unpublish' => array(t('Unpublish the selected comments'), 'UPDATE {comments} SET status = '. COMMENT_NOT_PUBLISHED .' WHERE cid = %d'), - 'delete' => array(t('Delete the selected comments'), '') - ); - } - else { - $operations = array( - 'publish' => array(t('Publish the selected comments'), 'UPDATE {comments} SET status = '. COMMENT_PUBLISHED .' WHERE cid = %d'), - 'unpublish' => array(t('Unpublish the selected comments'), 'UPDATE {comments} SET status = '. COMMENT_NOT_PUBLISHED .' WHERE cid = %d'), - 'delete' => array(t('Delete the selected comments'), '') - ); - } - return $operations; -} - -/** - * Menu callback; present an administrative comment listing. - */ -function comment_admin_overview($type = 'new') { - $edit = $_POST['edit']; - - if ($edit['operation'] == 'delete') { - return comment_multiple_delete_confirm(); - } - - // build an 'Update options' form - $form['options'] = array( - '#type' => 'fieldset', '#title' => t('Update options'), - '#prefix' => '', '#suffix' => '' - ); - $options = array(); - foreach (comment_operations(arg(3) == 'approval' ? 'publish' : 'unpublish') as $key => $value) { - $options[$key] = $value[0]; - } - $form['options']['operation'] = array('#type' => 'select', '#options' => $options, '#default_value' => 'publish'); - $form['options']['submit'] = array('#type' => 'submit', '#value' => t('Update')); - - // load the comments that we want to display - $status = ($type == 'approval') ? COMMENT_NOT_PUBLISHED : COMMENT_PUBLISHED; - $form['header'] = array('#type' => 'value', '#value' => array( - NULL, - array('data' => t('Subject'), 'field' => 'subject'), - array('data' => t('Author'), 'field' => 'name'), - array('data' => t('Time'), 'field' => 'timestamp', 'sort' => 'desc'), - array('data' => t('Operations')) - )); - $result = pager_query('SELECT c.subject, c.nid, c.cid, c.comment, c.timestamp, c.status, c.name, c.homepage, u.name AS registered_name, u.uid FROM {comments} c INNER JOIN {users} u ON u.uid = c.uid WHERE c.status = %d'. tablesort_sql($form['header']['#value']), 50, 0, NULL, $status); - - // build a table listing the appropriate comments - $destination = drupal_get_destination(); - while ($comment = db_fetch_object($result)) { - $comments[$comment->cid] = ''; - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - $form['subject'][$comment->cid] = array('#value' => l($comment->subject, 'node/'. $comment->nid, array('title' => truncate_utf8($comment->comment, 128)), NULL, 'comment-'. $comment->cid)); - $form['username'][$comment->cid] = array('#value' => theme('username', $comment)); - $form['timestamp'][$comment->cid] = array('#value' => format_date($comment->timestamp, 'small')); - $form['operations'][$comment->cid] = array('#value' => l(t('edit'), 'comment/edit/'. $comment->cid, array(), $destination)); - } - $form['comments'] = array('#type' => 'checkboxes', '#options' => $comments); - $form['pager'] = array('#value' => theme('pager', NULL, 50, 0)); - return drupal_get_form('comment_admin_overview', $form); -} - -/** - * We can't execute any 'Update options' if no comments were selected. - */ -function comment_admin_overview_validate($form_id, $edit) { - $edit['comments'] = array_diff($edit['comments'], array(0)); - if (count($edit['comments']) == 0) { - form_set_error('', t('Please select one or more comments to perform the update on.')); - drupal_goto('admin/comment'); - } -} - -/** - * Execute the chosen 'Update option' on the selected comments, such as - * publishing, unpublishing or deleting. - */ -function comment_admin_overview_submit($form_id, $edit) { - $operations = comment_operations(); - if ($operations[$edit['operation']][1]) { - // extract the appropriate database query operation - $query = $operations[$edit['operation']][1]; - foreach ($edit['comments'] as $cid => $value) { - if ($value) { - // perform the update action, then refresh node statistics - db_query($query, $cid); - $comment = _comment_load($cid); - _comment_update_node_statistics($comment->nid); - // Allow modules to respond to the updating of a comment. - comment_invoke_comment($comment, $edit['operation']); - // Add an entry to the watchdog log. - watchdog('content', t('Comment: updated %subject.', array('%subject' => theme('placeholder', $comment->subject))), WATCHDOG_NOTICE, l(t('view'), 'node/'. $comment->nid, NULL, NULL, 'comment-'. $comment->cid)); - } - } - cache_clear_all(); - drupal_set_message(t('The update has been performed.')); - drupal_goto('admin/comment'); - } -} - -function theme_comment_admin_overview($form) { - $output = form_render($form['options']); - if (isset($form['subject']) && is_array($form['subject'])) { - foreach (element_children($form['subject']) as $key) { - $row = array(); - $row[] = form_render($form['comments'][$key]); - $row[] = form_render($form['subject'][$key]); - $row[] = form_render($form['username'][$key]); - $row[] = form_render($form['timestamp'][$key]); - $row[] = form_render($form['operations'][$key]); - $rows[] = $row; - } - } - else { - $rows[] = array(array('data' => t('No comments available.'), 'colspan' => '6')); - } - - $output .= theme('table', $form['header']['#value'], $rows); - if ($form['pager']['#value']) { - $output .= form_render($form['pager']); - } - - $output .= form_render($form); - - return $output; -} - -/** - * List the selected comments and verify that the admin really wants to delete - * them. - */ -function comment_multiple_delete_confirm() { - $edit = $_POST['edit']; - - $form['comments'] = array('#prefix' => '- ', '#suffix' => '
http://example.com/directory.')); - } - } - } - } - - return $edit; -} - -/* -** Generate the basic commenting form, for appending to a node or display on a separate page. -** This is rendered by theme_comment_form. -*/ - -function comment_form($edit, $title = NULL) { - global $user; - - $op = isset($_POST['op']) ? $_POST['op'] : ''; - - if ($user->uid) { - if ($edit['cid'] && user_access('administer comments')) { - if ($edit['author']) { - $author = $edit['author']; - } - elseif ($edit['name']) { - $author = $edit['name']; - } - else { - $author = $edit['registered_name']; - } - - if ($edit['status']) { - $status = $edit['status']; - } - else { - $status = 0; - } - - if ($edit['date']) { - $date = $edit['date']; - } - else { - $date = format_date($edit['timestamp'], 'custom', 'Y-m-d H:i O'); - } - - $form['admin'] = array( - '#type' => 'fieldset', - '#title' => t('Administration'), - '#collapsible' => TRUE, - '#collapsed' => TRUE, - '#weight' => -2, - ); - - if ($edit['registered_name'] != '') { - // The comment is by a registered user - $form['admin']['author'] = array( - '#type' => 'textfield', - '#title' => t('Authored by'), - '#size' => 30, - '#maxlength' => 60, - '#autocomplete_path' => 'user/autocomplete', - '#default_value' => $author, - '#weight' => -1, - ); - } - else { - // The comment is by an anonymous user - $form['is_anonymous'] = array( - '#type' => 'value', - '#value' => TRUE, - ); - $form['admin']['name'] = array( - '#type' => 'textfield', - '#title' => t('Authored by'), - '#size' => 30, - '#maxlength' => 60, - '#default_value' => $author, - '#weight' => -1, - ); - $form['admin']['mail'] = array( - '#type' => 'textfield', - '#title' => t('E-mail'), - '#maxlength' => 64, - '#size' => 30, - '#default_value' => $edit['mail'], - '#description' => t('The content of this field is kept private and will not be shown publicly.'), - ); - - $form['admin']['homepage'] = array( - '#type' => 'textfield', - '#title' => t('Homepage'), - '#maxlength' => 255, - '#size' => 30, - '#default_value' => $edit['homepage'], - ); - } - - $form['admin']['date'] = array('#type' => 'textfield', '#parents' => array('date'), '#title' => t('Authored on'), '#size' => 20, '#maxlength' => 25, '#default_value' => $date, '#weight' => -1); - - $form['admin']['status'] = array('#type' => 'radios', '#parents' => array('status'), '#title' => t('Status'), '#default_value' => $status, '#options' => array(t('Published'), t('Not published')), '#weight' => -1); - - } - else { - $form['_author'] = array('#type' => 'item', '#title' => t('Your name'), '#value' => theme('username', $user) - ); - $form['author'] = array('#type' => 'value', '#value' => $user->name); - } - } - else if (variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT) == COMMENT_ANONYMOUS_MAY_CONTACT) { - $form['name'] = array('#type' => 'textfield', '#title' => t('Your name'), '#maxlength' => 60, '#size' => 30, '#default_value' => $edit['name'] ? $edit['name'] : variable_get('anonymous', 'Anonymous') - ); - - $form['mail'] = array('#type' => 'textfield', '#title' => t('E-mail'), '#maxlength' => 64, '#size' => 30, '#default_value' => $edit['mail'], '#description' => t('The content of this field is kept private and will not be shown publicly.') - ); - - $form['homepage'] = array('#type' => 'textfield', '#title' => t('Homepage'), '#maxlength' => 255, '#size' => 30, '#default_value' => $edit['homepage']); - } - else if (variable_get('comment_anonymous', COMMENT_ANONYMOUS_MAYNOT_CONTACT) == COMMENT_ANONYMOUS_MUST_CONTACT) { - $form['name'] = array('#type' => 'textfield', '#title' => t('Your name'), '#maxlength' => 60, '#size' => 30, '#default_value' => $edit['name'] ? $edit['name'] : variable_get('anonymous', 'Anonymous'), '#required' => TRUE); - - $form['mail'] = array('#type' => 'textfield', '#title' => t('E-mail'), '#maxlength' => 64, '#size' => 30, '#default_value' => $edit['mail'],'#description' => t('The content of this field is kept private and will not be shown publicly.'), '#required' => TRUE); - - $form['homepage'] = array('#type' => 'textfield', '#title' => t('Homepage'), '#maxlength' => 255, '#size' => 30, '#default_value' => $edit['homepage']); - } - - if (variable_get('comment_subject_field', 1) == 1) { - $form['subject'] = array('#type' => 'textfield', '#title' => t('Subject'), '#maxlength' => 64, '#default_value' => $edit['subject']); - } - - $form['comment_filter']['comment'] = array('#type' => 'textarea', '#title' => t('Comment'), '#rows' => 15, '#default_value' => $edit['comment'] ? $edit['comment'] : $user->signature, '#required' => TRUE); - $form['comment_filter']['format'] = filter_form($edit['format']); - - $form['cid'] = array('#type' => 'value', '#value' => $edit['cid']); - $form['pid'] = array('#type' => 'value', '#value' => $edit['pid']); - $form['nid'] = array('#type' => 'value', '#value' => $edit['nid']); - $form['uid'] = array('#type' => 'value', '#value' => $edit['uid']); - - $form['preview'] = array('#type' => 'button', '#value' => t('Preview comment'), '#weight' => 19); - $form['#token'] = 'comment' . $edit['nid'] . $edit['pid']; - - // Only show post button if preview is optional or if we are in preview mode. - // We show the post button in preview mode even if there are form errors so that - // optional form elements (e.g., captcha) can be updated in preview mode. - if (!form_get_errors() && ((variable_get('comment_preview', COMMENT_PREVIEW_REQUIRED) == COMMENT_PREVIEW_OPTIONAL) || ($op == t('Preview comment')) || ($op == t('Post comment')))) { - $form['submit'] = array('#type' => 'submit', '#value' => t('Post comment'), '#weight' => 20); - } - - if ($op == t('Preview comment')) { - $form['#after_build'] = 'comment_form_add_preview'; - } - - if ($_REQUEST['destination']) { - $form['#attributes']['destination'] = $_REQUEST['destination']; - } - - if (empty($edit['cid']) && empty($edit['pid'])) { - $form['#action'] = url('comment/reply/'. $edit['nid']); - } - - // Graft in extra form additions - $form = array_merge($form, comment_invoke_comment($form, 'form')); - - return theme('box', $title, drupal_get_form('comment_form', $form)); -} - -function comment_form_add_preview($form, $edit) { - global $user; - - drupal_set_title(t('Preview comment')); - - $output = ''; - - comment_validate($edit); - $comment = (object)_comment_form_submit($edit); - - // Attach the user and time information. - if ($edit['author']) { - $account = user_load(array('name' => $edit['author'])); - } - elseif ($user->uid && !isset($edit['is_anonymous'])) { - $account = $user; - } - if ($account) { - $comment->uid = $account->uid; - $comment->name = check_plain($account->name); - } - $comment->timestamp = $edit['timestamp'] ? $edit['timestamp'] : time(); - - // Preview the comment with security check. - if (!form_get_errors()) { - $output .= theme('comment_view', $comment); - } - $form['comment_preview'] = array('#value' => $output, '#weight' => -100); - - $output = ''; - - if ($edit['pid']) { - $comment = db_fetch_object(db_query('SELECT c.*, u.uid, u.name AS registered_name, u.picture, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status = %d', $edit['pid'], COMMENT_PUBLISHED)); - $comment = drupal_unpack($comment); - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - $output .= theme('comment_view', $comment); - } - else { - $output .= node_view(node_load($edit['nid'])); - $edit['pid'] = 0; - } - - $form['comment_preview_below'] = array('#value' => $output, '#weight' => 100); - - return $form; -} - -function comment_form_validate($form_id, $form_values) { - comment_validate($form_values); -} - -function _comment_form_submit($form_values) { - if (!isset($form_values['date'])) { - $form_values['date'] = 'now'; - } - $form_values['timestamp'] = strtotime($form_values['date']); - if (isset($form_values['author'])) { - $account = user_load(array('name' => $form_values['author'])); - $form_values['uid'] = $account->uid; - $form_values['name'] = $form_values['author']; - } - // Validate the comment's subject. If not specified, extract - // one from the comment's body. - if (trim($form_values['subject']) == '') { - // The body may be in any format, so we: - // 1) Filter it into HTML - // 2) Strip out all HTML tags - // 3) Convert entities back to plain-text. - // Note: format is checked by check_markup(). - $form_values['subject'] = truncate_utf8(decode_entities(strip_tags(check_markup($form_values['comment'], $form_values['format']))), 29, TRUE); - } - return $form_values; -} - -function comment_form_submit($form_id, $form_values) { - $form_values = _comment_form_submit($form_values); - if ($cid = comment_save($form_values)) { - return array('node/'. $form_values['nid'], NULL, "comment-$cid"); - } -} - -/* -** Renderer or visualization functions this can be optionally -** overridden by themes. -*/ - -function theme_comment_preview($comment, $links = array(), $visible = 1) { - $output = ''; - $output .= theme('comment_view', $comment, $links, $visible); - $output .= ''; - return $output; -}; - -function theme_comment_view($comment, $links = array(), $visible = 1) { - - // Emit selectors: - $output = ''; - if (($comment->new = node_mark($comment->nid, $comment->timestamp)) != MARK_READ) { - $output .= "\n"; - } - - $output .= "cid\">\n"; - - // Switch to folded/unfolded view of the comment - if ($visible) { - $comment->comment = check_markup($comment->comment, $comment->format, FALSE); - - // Comment API hook - comment_invoke_comment($comment, 'view'); - - $output .= theme('comment', $comment, $links); - } - else { - $output .= theme('comment_folded', $comment); - } - - return $output; -} - -function comment_controls($mode = COMMENT_MODE_THREADED_EXPANDED, $order = COMMENT_ORDER_NEWEST_FIRST, $comments_per_page = 50) { - $form['mode'] = array('#type' => 'select', - '#default_value' => $mode, - '#options' => _comment_get_modes(), - '#weight' => 1, - ); - $form['order'] = array( - '#type' => 'select', - '#default_value' => $order, - '#options' => _comment_get_orders(), - '#weight' => 2, - ); - foreach (_comment_per_page() as $i) { - $options[$i] = t('%a comments per page', array('%a' => $i)); - } - $form['comments_per_page'] = array('#type' => 'select', - '#default_value' => $comments_per_page, - '#options' => $options, - '#weight' => 3, - ); - - $form['submit'] = array('#type' => 'submit', - '#value' => t('Save settings'), - '#weight' => 20, - ); - - return drupal_get_form('comment_controls', $form); -} - -function theme_comment_controls($form) { - $output .= ''; - $output .= form_render($form); - $output .= ''; - $output .= ''. t('Select your preferred way to display the comments and click "Save settings" to activate your changes.') .''; - return theme('box', t('Comment viewing options'), $output); -} - -function comment_controls_submit($form_id, $form_values) { - global $user; - - $mode = $form_values['mode']; - $order = $form_values['order']; - $comments_per_page = $form_values['comments_per_page']; - - if ($user->uid) { - $user = user_save($user, array('mode' => $mode, 'sort' => $order, 'comments_per_page' => $comments_per_page)); - } - else { - $_SESSION['comment_mode'] = $mode; - $_SESSION['comment_sort'] = $order; - $_SESSION['comment_comments_per_page'] = $comments_per_page; - } -} - -function theme_comment($comment, $links = array()) { - $output = ''; - $output .= ''; - return $output; -} - -function theme_comment_folded($comment) { - $output = "'. l($comment->subject, $_GET['q'], NULL, NULL, "comment-$comment->cid") . ' ' . theme('mark', $comment->new) ."\n"; - $output .= ''. t('by %a on %b', array('%a' => theme('username', $comment), '%b' => format_date($comment->timestamp))) ."\n"; - $output .= ''. $comment->comment .''; - $output .= ''. theme('links', $links) .''; - $output .= '\n"; - $output .= ' '. l($comment->subject, comment_node_url() .'/'. $comment->cid, NULL, NULL, "comment-$comment->cid") . ' '. theme('mark', $comment->new) .' '; - $output .= ''. t('by') .' '. theme('username', $comment) ."\n"; - $output .= "\n"; - return $output; -} - -function theme_comment_flat_collapsed($comment) { - return theme('comment_view', $comment, '', 0); - return ''; -} - -function theme_comment_flat_expanded($comment) { - return theme('comment_view', $comment, module_invoke_all('link', 'comment', $comment, 0)); -} - -function theme_comment_thread_collapsed($comment) { - $output = '\n"; - $output .= theme('comment_view', $comment, '', 0); - $output .= "\n"; - return $output; -} - -function theme_comment_thread_expanded($comment) { - $output = ''; - if ($comment->depth) { - $output .= '\n"; - } - - $output .= theme('comment_view', $comment, module_invoke_all('link', 'comment', $comment, 0)); - - if ($comment->depth) { - $output .= "\n"; - } - return $output; -} - -function theme_comment_post_forbidden($nid) { - global $user; - if ($user->uid) { - return t("you can't post comments"); - } - else { - // we cannot use drupal_get_destination() because these links sometimes appear on /node and taxo listing pages - if (variable_get('comment_form_location', COMMENT_FORM_SEPARATE_PAGE) == COMMENT_FORM_SEPARATE_PAGE) { - $destination = "destination=". urlencode("comment/reply/$nid#comment_form"); - } - else { - $destination = "destination=". urlencode("node/$nid#comment_form"); - } - - if (variable_get('user_register', 1)) { - return t('login or register to post comments', array('%login' => url('user/login', $destination), '%register' => check_url(url('user/register', $destination)))); - } - else { - return t('login to post comments', array('%login' => check_url(url('user/login', $destination)))); - } - } -} - -function _comment_delete_thread($comment) { - // Delete the comment: - db_query('DELETE FROM {comments} WHERE cid = %d', $comment->cid); - watchdog('content', t('Comment: deleted %subject.', array('%subject' => theme('placeholder', $comment->subject)))); - - comment_invoke_comment($comment, 'delete'); - - // Delete the comment's replies - $result = db_query('SELECT c.*, u.name AS registered_name, u.uid FROM {comments} c INNER JOIN {users} u ON u.uid = c.uid WHERE pid = %d', $comment->cid); - while ($comment = db_fetch_object($result)) { - $comment->name = $comment->uid ? $comment->registered_name : $comment->name; - _comment_delete_thread($comment); - } -} - -/** - * Return an array of viewing modes for comment listings. - * - * We can't use a global variable array because the locale system - * is not initialized yet when the comment module is loaded. - */ -function _comment_get_modes() { - return array( - COMMENT_MODE_FLAT_COLLAPSED => t('Flat list - collapsed'), - COMMENT_MODE_FLAT_EXPANDED => t('Flat list - expanded'), - COMMENT_MODE_THREADED_COLLAPSED => t('Threaded list - collapsed'), - COMMENT_MODE_THREADED_EXPANDED => t('Threaded list - expanded') - ); -} - -/** - * Return an array of viewing orders for comment listings. - * - * We can't use a global variable array because the locale system - * is not initialized yet when the comment module is loaded. - */ -function _comment_get_orders() { - return array( - COMMENT_ORDER_NEWEST_FIRST => t('Date - newest first'), - COMMENT_ORDER_OLDEST_FIRST => t('Date - oldest first') - ); -} - -/** - * Return an array of "comments per page" settings from which the user - * can choose. - */ -function _comment_per_page() { - return drupal_map_assoc(array(10, 30, 50, 70, 90, 150, 200, 250, 300)); -} - -/** - * Updates the comment statistics for a given node. This should be called any - * time a comment is added, deleted, or updated. - * - * The following fields are contained in the node_comment_statistics table. - * - last_comment_timestamp: the timestamp of the last comment for this node or the node create stamp if no comments exist for the node. - * - last_comment_name: the name of the anonymous poster for the last comment - * - last_comment_uid: the uid of the poster for the last comment for this node or the node authors uid if no comments exists for the node. - * - comment_count: the total number of approved/published comments on this node. - */ -function _comment_update_node_statistics($nid) { - $count = db_result(db_query('SELECT COUNT(cid) FROM {comments} WHERE nid = %d AND status = %d', $nid, COMMENT_PUBLISHED)); - - // comments exist - if ($count > 0) { - $last_reply = db_fetch_object(db_query_range('SELECT cid, name, timestamp, uid FROM {comments} WHERE nid = %d AND status = %d ORDER BY cid DESC', $nid, COMMENT_PUBLISHED, 0, 1)); - db_query("UPDATE {node_comment_statistics} SET comment_count = %d, last_comment_timestamp = %d, last_comment_name = '%s', last_comment_uid = %d WHERE nid = %d", $count, $last_reply->timestamp, $last_reply->uid ? '' : $last_reply->name, $last_reply->uid, $nid); - } - - // no comments - else { - $node = db_fetch_object(db_query("SELECT uid, created FROM {node} WHERE nid = %d", $nid)); - db_query("UPDATE {node_comment_statistics} SET comment_count = 0, last_comment_timestamp = %d, last_comment_name = '', last_comment_uid = %d WHERE nid = %d", $node->created, $node->uid, $nid); - } -} - -/** - * Invoke a hook_comment() operation in all modules. - * - * @param &$comment - * A comment object. - * @param $op - * A string containing the name of the comment operation. - * @return - * The returned value of the invoked hooks. - */ -function comment_invoke_comment(&$comment, $op) { - $return = array(); - foreach (module_implements('comment') as $name) { - $function = $name .'_comment'; - $result = $function($comment, $op); - if (isset($result) && is_array($result)) { - $return = array_merge($return, $result); - } - else if (isset($result)) { - $return[] = $result; - } - } - return $return; -} - -/** - * Generate vancode. - * - * Consists of a leading character indicating length, followed by N digits - * with a numerical value in base 36. Vancodes can be sorted as strings - * without messing up numerical order. - * - * It goes: - * 00, 01, 02, ..., 0y, 0z, - * 110, 111, ... , 1zy, 1zz, - * 2100, 2101, ..., 2zzy, 2zzz, - * 31000, 31001, ... - */ -function int2vancode($i = 0) { - $num = base_convert((int)$i, 10, 36); - $length = strlen($num); - return chr($length + ord('0') - 1) . $num; -} - -/** - * Decode vancode back to an integer. - */ -function vancode2int($c = '00') { - return base_convert(substr($c, 1), 36, 10); -} diff --git a/modules/contact/contact.module b/modules/contact/contact.module deleted file mode 100644 index da34b83e00de42e16b9db2285d63f793c40e82b0..0000000000000000000000000000000000000000 --- a/modules/contact/contact.module +++ /dev/null @@ -1,551 +0,0 @@ -'. t('The contact module enables the use of both personal and site-wide contact forms, thereby facilitating easy communication within the community. While personal contact forms allow users to contact each other by e-mail, site-wide forms allow community members to contact the site administration from a central location. Users can specify a subject and message in the contact form, and also request that a copy of the e-mail be sent to their own address.') .''; - $output .= ''. t("Users can activate/deactivate their personal contact forms in their account settings. Upon activation, a contact tab will appear in their user profiles. Privileged users such as site administrators are able to contact users even if they have chosen not to enable this feature.") .'
'; - $output .= ''. t('If the menu module is enabled, a menu item linking to the site-wide contact page is added to the navigation block. It is disabled by default, but can be enabled via the menu management page. Links to the contact page may also be added to the primary and secondary links using the same page.', array('%menu-module' => url('admin/menu'))) .'
'; - $output .= t('Contact module links:') .'- ';
- $output .= '
'. t('The contact module also adds a menu item (disabled by default) to the navigation block.', array('%menu-settings' => url('admin/menu'))) .' '. $menu_note .'
'; - return($output); - } -} - -/** - * Implementation of hook_menu(). - */ -function contact_menu($may_cache) { - $items = array(); - if ($may_cache) { - $items[] = array('path' => 'admin/contact', - 'title' => t('contact form'), - 'callback' => 'contact_admin_categories', - 'access' => user_access('administer site configuration'), - ); - $items[] = array('path' => 'admin/contact/category', - 'title' => t('categories'), - 'callback' => 'contact_admin_categories', - 'access' => user_access('administer site configuration'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - ); - $items[] = array('path' => 'admin/contact/category/list', - 'title' => t('list'), - 'callback' => 'contact_admin_categories', - 'access' => user_access('administer site configuration'), - 'type' => MENU_DEFAULT_LOCAL_TASK, - ); - $items[] = array('path' => 'admin/contact/category/add', - 'title' => t('add category'), - 'callback' => 'contact_admin_edit', - 'access' => user_access('administer site configuration'), - 'type' => MENU_LOCAL_TASK, - 'weight' => 1, - ); - $items[] = array('path' => 'admin/contact/category/edit', - 'title' => t('edit contact category'), - 'callback' => 'contact_admin_edit', - 'access' => user_access('administer site configuration'), - 'type' => MENU_CALLBACK, - ); - $items[] = array('path' => 'admin/contact/category/delete', - 'title' => t('delete contact'), - 'callback' => 'contact_admin_delete', - 'access' => user_access('administer site configuration'), - 'type' => MENU_CALLBACK, - ); - $items[] = array('path' => 'admin/contact/settings', - 'title' => t('settings'), - 'callback' => 'contact_admin_settings', - 'access' => user_access('administer site configuration'), - 'type' => MENU_LOCAL_TASK, - 'weight' => 1, - ); - $items[] = array('path' => 'contact', - 'title' => t('contact'), - 'callback' => 'contact_mail_page', - 'access' => user_access('access content'), - 'type' => MENU_SUGGESTED_ITEM, - ); - } - else { - if (arg(0) == 'user' && is_numeric(arg(1))) { - $items[] = array('path' => "user/". arg(1) ."/contact", - 'title' => t('contact'), - 'callback' => 'contact_mail_user', - 'type' => MENU_LOCAL_TASK, - 'weight' => 2, - ); - } - } - - return $items; -} - -/** - * Implementation of hook_user(). - * - * Allows the user the option of enabling/disabling his personal contact form. - */ -function contact_user($type, $edit, &$user, $category = NULL) { - if ($type == 'form' && $category == 'account') { - $form['contact'] = array('#type' => 'fieldset', - '#title' => t('Contact settings'), - '#weight' => 5, - '#collapsible' => TRUE, - ); - $form['contact']['contact'] = array('#type' => 'checkbox', - '#title' => t('Personal contact form'), - '#default_value' => $edit['contact'], - '#description' => t('Allow other users to contact you by e-mail via your personal contact form. Note that while your e-mail address is not made public to other members of the community, privileged users such as site administrators are able to contact you even if you choose not to enable this feature.', array('%url' => url("user/$user->uid/contact"))), - ); - return $form; - } - if ($type == 'validate') { - return array('contact' => $edit['contact']); - } -} - -/** - * Categories/list tab. - */ -function contact_admin_categories() { - $result = db_query('SELECT cid, category, recipients, selected FROM {contact} ORDER BY weight, category'); - $rows = array(); - while ($category = db_fetch_object($result)) { - $rows[] = array($category->category, $category->recipients, ($category->selected ? t('Yes') : t('No')), l(t('edit'), 'admin/contact/category/edit/'. $category->cid), l(t('delete'), 'admin/contact/category/delete/'. $category->cid)); - } - $header = array(t('Category'), t('Recipients'), t('Selected'), array('data' => t('Operations'), 'colspan' => 2)); - - return theme('table', $header, $rows); -} - -/** - * Category edit page. - */ -function contact_admin_edit($cid = NULL) { - if (arg(3) == "edit" && $cid > 0) { - $edit = db_fetch_array(db_query("SELECT * FROM {contact} WHERE cid = %d", $cid)); - } - $form['category'] = array('#type' => 'textfield', - '#title' => t('Category'), - '#maxlength' => 255, - '#default_value' => $edit['category'], - '#description' => t("Example: 'website feedback' or 'product information'."), - '#required' => TRUE, - ); - $form['recipients'] = array('#type' => 'textarea', - '#title' => t('Recipients'), - '#default_value' => $edit['recipients'], - '#description' => t("Example: 'webmaster@yoursite.com' or 'sales@yoursite.com'. To specify multiple recipients, separate each e-mail address with a comma."), - '#required' => TRUE, - ); - $form['reply'] = array('#type' => 'textarea', - '#title' => t('Auto-reply'), - '#default_value' => $edit['reply'], - '#description' => t('Optional auto-reply. Leave empty if you do not want to send the user an auto-reply message.'), - ); - $form['weight'] = array('#type' => 'weight', - '#title' => t('Weight'), - '#default_value' => $edit['weight'], - '#description' => t('When listing categories, those with lighter (smaller) weights get listed before categories with heavier (larger) weights. Categories with equal weights are sorted alphabetically.'), - ); - $form['selected'] = array('#type' => 'select', - '#title' => t('Selected'), - '#options' => array('0' => t('No'), '1' => t('Yes')), - '#default_value' => $edit['selected'], - '#description' => t('Set this to Yes if you would like this category to be selected by default.'), - ); - $form['cid'] = array('#type' => 'value', - '#value' => $edit['cid'], - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Submit'), - ); - - return drupal_get_form('contact_admin_edit', $form); -} - -/** - * Validate the contact category edit page form submission. - */ -function contact_admin_edit_validate($form_id, $form_values) { - if (empty($form_values['category'])) { - form_set_error('category', t('You must enter a category.')); - } - if (empty($form_values['recipients'])) { - form_set_error('recipients', t('You must enter one or more recipients.')); - } - else { - $recipients = explode(',', $form_values['recipients']); - foreach($recipients as $recipient) { - if (!valid_email_address(trim($recipient))) { - form_set_error('recipients', t('%recipient is an invalid e-mail address.', array('%recipient' => theme('placeholder', $recipient)))); - } - } - } -} - -/** - * Process the contact category edit page form submission. - */ -function contact_admin_edit_submit($form_id, $form_values) { - if ($form_values['selected']) { - // Unselect all other contact categories. - db_query('UPDATE {contact} SET selected = 0'); - } - $recipients = explode(',', $form_values['recipients']); - foreach($recipients as $key=>$recipient) { - // E-mail address validation has already been done in _validate. - $recipients[$key] = trim($recipient); - } - $form_values['recipients'] = implode(',', $recipients); - if (arg(3) == 'add') { - db_query("INSERT INTO {contact} (category, recipients, reply, weight, selected) VALUES ('%s', '%s', '%s', %d, %d)", $form_values['category'], $form_values['recipients'], $form_values['reply'], $form_values['weight'], $form_values['selected']); - drupal_set_message(t('Category %category has been added.', array('%category' => theme('placeholder', $form_values['category'])))); - watchdog('mail', t('Contact form: category %category added.', array('%category' => theme('placeholder', $form_values['category']))), WATCHDOG_NOTICE, l(t('view'), 'admin/contact')); - - } - else { - db_query("UPDATE {contact} SET category = '%s', recipients = '%s', reply = '%s', weight = %d, selected = %d WHERE cid = %d", $form_values['category'], $form_values['recipients'], $form_values['reply'], $form_values['weight'], $form_values['selected'], $form_values['cid']); - drupal_set_message(t('Category %category has been updated.', array('%category' => theme('placeholder', $form_values['category'])))); - watchdog('mail', t('Contact form: category %category updated.', array('%category' => theme('placeholder', $form_values['category']))), WATCHDOG_NOTICE, l(t('view'), 'admin/contact')); - } - - return 'admin/contact'; -} - -/** - * Category delete page. - */ -function contact_admin_delete($cid = NULL) { - if ($info = db_fetch_object(db_query("SELECT category FROM {contact} WHERE cid = %d", $cid))) { - $form['category'] = array('#type' => 'value', - '#value' => $info->category, - ); - - return confirm_form('contact_admin_delete', $form, t('Are you sure you want to delete %category?', array('%category' => theme('placeholder', $info->category))), 'admin/contact', t('This action cannot be undone.'), t('Delete'), t('Cancel')); - } - else { - drupal_set_message(t('Category not found.'), 'error'); - drupal_goto('admin/contact'); - } -} - -/** - * Process category delete form submission. - */ -function contact_admin_delete_submit($form_id, $form_values) { - db_query("DELETE FROM {contact} WHERE cid = %d", arg(4)); - drupal_set_message(t('Category %category has been deleted.', array('%category' => theme('placeholder', $form_values['category'])))); - watchdog('mail', t('Contact form: category %category deleted.', array('%category' => theme('placeholder', $form_values['category']))), WATCHDOG_NOTICE); - - return 'admin/contact'; -} - -/** - * Settings tab. Using a form rather than hook_settings(). - */ -function contact_admin_settings() { - $form['contact_form_information'] = array('#type' => 'textarea', - '#title' => t('Additional information'), - '#default_value' => variable_get('contact_form_information', t('You can leave a message using the contact form below.')), - '#description' => t('Information to show on the contact page. Can be anything from submission guidelines to your postal address or telephone number.', array('%form' => url('contact'))), - ); - $form['contact_hourly_threshold'] = array('#type' => 'select', - '#title' => t('Hourly threshold'), - '#options' => drupal_map_assoc(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 20, 30, 40, 50)), - '#default_value' => variable_get('contact_hourly_threshold', 3), - '#description' => t('The maximum number of contact form submissions a user can perform per hour.'), - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Save configuration'), - ); - $form['reset'] = array('#type' => 'submit', - '#value' => t('Reset to defaults'), - ); - // Use system_settings_form for the callback. - return drupal_get_form('contact_admin_settings', $form, 'system_settings_form'); -} - -/** - * Personal contact page. - */ -function contact_mail_user() { - global $user; - - if ($account = user_load(array('uid' => arg(1)))) { - $admin_access = user_access('administer users'); - if (!$account->status && !$admin_access) { - drupal_access_denied(); - } - else if (!$account->contact && !$admin_access) { - $output = t('%name is not accepting e-mails.', array('%name' => $account->name)); - } - else if (!$user->uid) { - $output = t('Please login or register to send %name a message.', array('%login' => url('user/login'), '%register' => url('user/register'), '%name' => $account->name)); - } - else if (!valid_email_address($user->mail)) { - $output = t('You need to provide a valid e-mail address to contact other users. Please update your user information and try again.', array('%url' => url("user/$user->uid/edit"))); - } - else if (!flood_is_allowed('contact', variable_get('contact_hourly_threshold', 3))) { - $output = t('You cannot contact more than %number users per hour. Please try again later.', array('%number' => variable_get('contact_hourly_threshold', 3))); - } - else { - drupal_set_title($account->name); - - $form['#token'] = $user->name . $user->mail; - $form['from'] = array('#type' => 'item', - '#title' => t('From'), - '#value' => $user->name .' <'. $user->mail .'>', - ); - $form['to'] = array('#type' => 'item', - '#title' => t('To'), - '#value' => $account->name, - ); - $form['subject'] = array('#type' => 'textfield', - '#title' => t('Subject'), - '#maxlength' => 50, - '#required' => TRUE, - ); - $form['message'] = array('#type' => 'textarea', - '#title' => t('Message'), - '#rows' => 15, - '#required' => TRUE, - ); - $form['copy'] = array('#type' => 'checkbox', - '#title' => t('Send me a copy.'), - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Send e-mail'), - ); - $output = drupal_get_form('contact_mail_user', $form); - } - - return $output; - } - else { - drupal_not_found(); - } -} - -/** - * Process the personal contact page form submission. - */ -function contact_mail_user_submit($form_id, $edit) { - global $user; - - $account = user_load(array('uid' => arg(1), 'status' => 1)); - // Compose the body: - $message[] = "$account->name,"; - $message[] = t("%name (%name-url) has sent you a message via your contact form (%form-url) at %site.", array('%name' => $user->name, '%name-url' => url("user/$user->uid", NULL, NULL, TRUE), '%form-url' => url($_GET['q'], NULL, NULL, TRUE), '%site' => variable_get('site_name', 'drupal'))); - $message[] = t("If you don't want to receive such e-mails, you can change your settings at %url.", array('%url' => url("user/$account->uid", NULL, NULL, TRUE))); - $message[] = t('Message:'); - $message[] = $edit['message']; - - // Tidy up the body: - foreach ($message as $key => $value) { - $message[$key] = wordwrap($value); - } - - // Prepare all fields: - $to = $account->mail; - $from = $user->mail; - - // Format the subject: - $subject = '['. variable_get('site_name', 'drupal') .'] '. $edit['subject']; - - // Prepare the body: - $body = implode("\n\n", $message); - - // Send the e-mail: - user_mail($to, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - - // Send a copy if requested: - if ($edit['copy']) { - user_mail($from, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - } - - // Log the operation: - flood_register_event('contact'); - watchdog('mail', t('%name-from sent %name-to an e-mail.', array('%name-from' => theme('placeholder', $user->name), '%name-to' => theme('placeholder', $account->name)))); - - // Set a status message: - drupal_set_message(t('The message has been sent.')); - - // Jump to the user's profile page: - return "user/$account->uid"; -} - -/** - * Site-wide contact page - */ -function contact_mail_page() { - global $user; - - $breadcrumb[] = array('path' => 'contact', 'title' => t('contact')); - menu_set_location($breadcrumb); - - if (!flood_is_allowed('contact', variable_get('contact_hourly_threshold', 3))) { - $output = t("You cannot send more than %number messages per hour. Please try again later.", array('%number' => variable_get('contact_hourly_threshold', 3))); - } - else { - if ($user->uid) { - $edit['name'] = $user->name; - $edit['mail'] = $user->mail; - } - - $result = db_query('SELECT cid, category, selected FROM {contact} ORDER BY weight, category'); - while ($category = db_fetch_object($result)) { - $categories[$category->cid] = $category->category; - if ($category->selected) { - $default_category = $category->cid; - } - } - - if (count($categories) > 0) { - $form['#token'] = $user->name . $user->mail; - $form['contact_information'] = array('#value' => variable_get('contact_form_information', t('You can leave us a message using the contact form below.'))); - $form['name'] = array('#type' => 'textfield', - '#title' => t('Your name'), - '#maxlength' => 255, - '#default_value' => $edit['name'], - '#required' => TRUE, - ); - $form['mail'] = array('#type' => 'textfield', - '#title' => t('Your e-mail address'), - '#maxlength' => 255, - '#default_value' => $edit['mail'], - '#required' => TRUE, - ); - $form['subject'] = array('#type' => 'textfield', - '#title' => t('Subject'), - '#maxlength' => 255, - '#required' => TRUE, - ); - if (count($categories) > 1) { - // If there is more than one category available and no default category has been selected, - // prepend a default placeholder value. - if (!isset($default_category)) { - $categories = array(t('--')) + $categories; - } - $form['cid'] = array('#type' => 'select', - '#title' => t('Category'), - '#default_value' => $default_category, - '#options' => $categories, - '#required' => TRUE, - ); - } - else { - // If there is only one category, store its cid. - $form['cid'] = array('#type' => 'value', - '#value' => array_shift(array_keys($categories)), - ); - } - $form['message'] = array('#type' => 'textarea', - '#title' => t('Message'), - '#required' => TRUE, - ); - $form['copy'] = array('#type' => 'checkbox', - '#title' => t('Send me a copy.'), - ); - $form['submit'] = array('#type' => 'submit', - '#value' => t('Send e-mail'), - ); - $output = drupal_get_form('contact_mail_page', $form); - } - else { - $output = t('The contact form has not been configured.'); - } - } - - return $output; -} - -/** - * Validate the site-wide contact page form submission. - */ -function contact_mail_page_validate($form_id, $form_values) { - if (!$form_values['cid']) { - form_set_error('category', t('You must select a valid category.')); - } - if (!valid_email_address($form_values['mail'])) { - form_set_error('mail', t('You must enter a valid e-mail address.')); - } -} - -/** - * Process the site-wide contact page form submission. - */ -function contact_mail_page_submit($form_id, $edit) { - - // E-mail address of the sender: as the form field is a text field, - // all instances of \r and \n have been automatically stripped from it. - $from = $edit['mail']; - - // Compose the body: - $message[] = t("%name sent a message using the contact form at %form.", array('%name' => $edit['name'], '%form' => url($_GET['q'], NULL, NULL, TRUE))); - $message[] = $edit['message']; - - // Tidy up the body: - foreach ($message as $key => $value) { - $message[$key] = wordwrap($value); - } - - // Load the category information: - $contact = db_fetch_object(db_query("SELECT * FROM {contact} WHERE cid = %d", $edit['cid'])); - - // Format the category: - $subject = t('[%category] %subject', array('%category' => $contact->category, '%subject' => $edit['subject'])); - - // Prepare the body: - $body = implode("\n\n", $message); - - // Send the e-mail to the recipients: - user_mail($contact->recipients, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - - // If the user requests it, send a copy. - if ($edit['copy']) { - user_mail($from, $subject, $body, "From: $from\nReply-to: $from\nX-Mailer: Drupal\nReturn-path: $from\nErrors-to: $from"); - } - - // Send an auto-reply if necessary: - if ($contact->reply) { - user_mail($from, $subject, wordwrap($contact->reply), "From: $contact->recipients\nReply-to: $contact->recipients\nX-Mailer: Drupal\nReturn-path: $contact->recipients\nErrors-to: $contact->recipients"); - } - - // Log the operation: - flood_register_event('contact'); - watchdog('mail', t('%name-from sent an e-mail regarding %category.', array('%name-from' => theme('placeholder', $edit['name'] ." <$from>"), '%category' => theme('placeholder', $contact->category)))); - - // Update user: - drupal_set_message(t('Your message has been sent.')); - - // Jump to home page rather than back to contact page to avoid contradictory messages if flood control has been activated. - return(''); -} diff --git a/modules/drupal/drupal.module b/modules/drupal/drupal.module deleted file mode 100644 index e1566f09152bd96810baee43a533700e40ee1eb2..0000000000000000000000000000000000000000 --- a/modules/drupal/drupal.module +++ /dev/null @@ -1,364 +0,0 @@ -'. t('The Drupal module uses the XML-RPC network communication protocol to connect your site with a central server that maintains a directory of client sites.') .''; - $output .= t('Enabling the Drupal module will allow you to:
--
-
'. t('The Drupal module administration page allows you to set the xml-rpc server page and other related options.') .'
'; - $output .= t('You can
--
-
'. t('If you maintain a directory of sites, you can list them on a page using the
drupal_client_page()function. Sample instructions: --
-
'. t('For more information please read the configuration and customization handbook Drupal page.', array('%drupal' => 'http://drupal.org/handbook/modules/drupal/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Lets you register your site with a central server and improve ranking of Drupal projects by posting information on your installed modules and themes; also enables users to log in using a Drupal ID.'); - case 'admin/settings/drupal': - return t('Using this your site can "call home" to another Drupal server. By calling home to drupal.org and sending a list of your installed modules and themes, you help rank projects on drupal.org and so assist all Drupal administrators to find the best components for meeting their needs. If you want to register with a different server, you can change the Drupal XML-RPC server setting -- but the server has to be able to handle Drupal XML. Some XML-RPC servers may present directories of all registered sites. To get all your site information listed, go to the settings page and set the site name, the e-mail address, the slogan, and the mission statement.
', array('%site-settings' => url('admin/settings'))); - case 'user/help#drupal': - return variable_get('drupal_authentication_service', 0) ? t("Drupal is the name of the software that powers %this-site. There are Drupal web sites all over the world, and many of them share their registration databases so that users may freely log in to any Drupal site using a single Drupal ID.
-So please feel free to log in to your account here at %this-site with a username from another Drupal site. The format of a Drupal ID is similar to an e-mail address: username@server. An example of a valid Drupal ID is mwlily@drupal.org.
", array('%Drupal' => 'http://drupal.org', '%this-site' => ''. variable_get('site_name', 'this web site') .'')) : NULL; - } -} - -/** - * Implementation of hook_settings(). - */ -function drupal_settings() { - // Check if all required fields are present - if ((variable_get('site_name', 'drupal') == 'drupal') || (variable_get('site_name', 'drupal') == '')) { - form_set_error('drupal_directory', t('You must set the name of your site on the administer » settings page.', array('%url' => url('admin/settings')))); - } - else if (variable_get('site_mail', ini_get('sendmail_from')) == '') { - form_set_error('drupal_directory', t('You must set an e-mail address for your site on the administer » settings page.', array('%url' => url('admin/settings')))); - } - else if (variable_get('site_slogan', '') == '') { - form_set_error('drupal_directory', t('You must set your site slogan on the administer » settings page.', array('%url' => url('admin/settings')))); - } - else if (variable_get('site_mission', '') == '') { - form_set_error('drupal_directory', t('You must set your site mission on the administer » settings page.' , array('%url' => url('admin/settings')))); - } - $options = array('1' => t('Enabled'), '0' => t('Disabled')); - - $form['drupal'] = array( - '#type' => 'fieldset', - '#title' => t('Post data to another site'), - '#tree' => FALSE - ); - - $form['drupal']['drupal_register'] = array( - '#type' => 'radios', - '#title' => t('Register with a Drupal server'), - '#default_value' => variable_get('drupal_register', 0), - '#options' => $options, - '#description' => t("If enabled, your Drupal site will register itself with the specified Drupal XML-RPC server. For this to work properly, you must set your site's name, e-mail address, slogan and mission statement. When the \"Drupal XML-RPC server\" field is set to \"%drupal-xml-rpc\", your web site will register itself with drupal.org. Requires the cron feature to be enabled.", array("%drupal-xml-rpc" => "http://drupal.org/xmlrpc.php", "%drupal-sites" => "http://drupal.org/drupal-sites/")) - ); - - $form['drupal']['drupal_server'] = array( - '#type' => 'textfield', - '#title' => t('Drupal XML-RPC server'), - '#default_value' => variable_get('drupal_server', 'http://drupal.org/xmlrpc.php'), - '#description' => t('The URL of the Drupal XML-RPC server you wish to register with.') - ); - - $form['drupal']['drupal_system'] = array( - '#type' => 'radios', - '#title' => t('Send system information'), - '#default_value' => variable_get('drupal_system', 0), - '#options' => $options, - '#description' => t("If enabled, your site will send information on its installed components (modules, themes, and theme engines). This information can help in compiling statistics on usage of Drupal projects.") - ); - - $form['drupal']['drupal_statistics'] = array( - '#type' => 'radios', - '#title' => t('Send statistics'), - '#default_value' => variable_get('drupal_statistics', 0), - '#options' => $options, - '#description' => t("If enabled, your site will send summary statistics on the number of registered users and the total number of posts. No private information will be sent. These data help to improve the ranking statistics of Drupal projects.") - ); - - $form['services'] = array( - '#type' => 'fieldset', - '#title' => t('Receive data from other sites'), - '#tree' => FALSE - ); - - $form['services']['drupal_client_service'] = array( - '#type' => 'radios', - '#title' => t('Allow other Drupal sites to register'), - '#default_value' => variable_get('drupal_client_service', 0), - '#options' => $options, - '#description' => t('If enabled, your Drupal site will allow other sites to register with your site and send information to this site. This functionality can be used to maintain a list of related sites.') - ); - - $form['services']['drupal_authentication_service'] = array( - '#type' => 'radios', - '#title' => t('Authentication service'), - '#default_value' => variable_get('drupal_authentication_service', 0), - '#options' => $options, - '#description' => t('If enabled, your Drupal site will accept logins with the user names of other Drupal sites, and likewise provide authentication for users logging into other Drupal sites, based on their user accounts here.') - ); - - return $form; -} - -/** - * Implementation of hook_cron(); handles pings to and from the site. - */ -function drupal_cron() { - if (time() - variable_get('cron_last', 0) > 21600) { - - // If this site acts as a Drupal XML-RPC server, delete the sites that - // stopped sending "ping" messages. - if (variable_get('drupal_client_service', 0)) { - $result = db_query("SELECT cid FROM {client} WHERE changed < %d", time() - 259200); - while ($client = db_fetch_object($result)) { - db_query("DELETE FROM {client_system} WHERE cid = %d", $client->cid); - db_query("DELETE FROM {client} WHERE cid = %d", $client->cid); - } - } - - // If this site acts as a Drupal XML-RPC client, send a message to the - // Drupal XML-RPC server. - if (variable_get('drupal_register', 0) && variable_get('drupal_server', 0)) { - drupal_notify(variable_get('drupal_server', '')); - } - } -} - -/** - * Callback function from drupal_xmlrpc() called when another site pings this one. - */ -function drupal_client_ping($client, $system) { - /* - ** Parse our parameters: - */ - - foreach (array('link', 'name', 'mail', 'slogan', 'mission') as $key) { - $client[$key] = strip_tags($client[$key]); - } - - /* - ** Update the data in our database and send back a reply: - */ - - if ($client['link'] && $client['name'] && $client['mail'] && $client['slogan'] && $client['mission']) { - $result = db_query(db_rewrite_sql("SELECT cid FROM {client} WHERE link = '%s'"), $client['link']); - if (db_num_rows($result)) { - $record = db_fetch_object($result); - $client['cid'] = $record->cid; - // We have an existing record. - db_query("UPDATE {client} SET link = '%s', name = '%s', mail = '%s', slogan = '%s', mission = '%s', users = %d, nodes = %d, version = '%s', changed = '%s' WHERE cid = %d", $client['uid'], $client['link'], $client['name'], $client['mail'], $client['slogan'], $client['mission'], $client['users'], $client['nodes'], $client['version'], time(), $client['cid']); - } - else { - $client['cid'] = db_next_id('{client}_cid'); - db_query("INSERT INTO {client} (cid, link, name, mail, slogan, mission, users, nodes, version, created, changed) VALUES (%d, '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s', '%s')", $client['cid'], $client['link'], $client['name'], $client['mail'], $client['slogan'], $client['mission'], $client['users'], $client['nodes'], $client['version'], time(), time()); - } - if (is_array($system)) { - db_query("DELETE FROM {client_system} WHERE cid = %d", $client['cid']); - foreach ($system as $item) { - db_query("INSERT INTO {client_system} (cid, name, type) VALUES (%d, '%s', '%s')", $client['cid'], $item['name'], $item['type']); - } - } - watchdog('client ping', t('Ping from %name (%link).', array('%name' => theme('placeholder', $client['name']), '%link' => theme('placeholder', $client['link']))), WATCHDOG_NOTICE, 'view'); - - return TRUE; - } - else { - return 0; - } - -} - -/** - * Formats a list of all clients. - * - * This function may be called from a custom page on sites that are - * Drupal directory servers. - */ -function drupal_client_page($sort = 'name') { - $result = db_query('SELECT * FROM {client} ORDER BY %s', $sort); - - $clients = array(); - while ($client = db_fetch_object($result)) { - $clients[] = $client; - } - - return theme('client_list', $clients); -} - -/** - * Theme a client list. - */ -function theme_client_list($clients) { - // Note: All fields except the mission are treated as plain-text. - // The mission is stripped of any HTML tags to keep the output simple and consistent. - $output = "\n- \n";
- foreach ($clients as $client) {
- $output .= '
'. t('Users can choose between the available input formats when creating or editing content. Administrators can configure which input formats are available to which user roles, as well as choose a default input format. Administrators can also create new input formats. Each input format can be configured to use a selection of filters.') .'
'; - $output .= t('You can
--
-
'. t('For more information please read the configuration and customization handbook Filter page.', array('%filter' => 'http://drupal.org/handbook/modules/filter/')) .'
'; - return $output; - case 'admin/modules#description': - return t('Handles the filtering of content in preparation for display.'); - - case 'admin/filters': - return t(' -Input formats define a way of processing user-supplied text in Drupal. Every input format has its own settings of which filters to apply. Possible filters include stripping out malicious HTML and making URLs clickable.
-Users can choose between the available input formats when submitting content.
-Below you can configure which input formats are available to which roles, as well as choose a default input format (used for imported content, for example).
-Note that (1) the default format is always available to all roles, and (2) all filter formats can always be used by roles with the "administer filters" permission even if they are not explicitly listed in the Roles column of this table.
'); - - case 'admin/filters/'. arg(2): - return t(' -Every filter performs one particular change on the user input, for example stripping out malicious HTML or making URLs clickable. Choose which filters you want to apply to text in this input format.
-If you notice some filters are causing conflicts in the output, you can rearrange them.
', array('%rearrange' => url('admin/filters/'. arg(2) .'/order'))); - - case 'admin/filters/'. arg(2) .'/configure': - return t(' -If you cannot find the settings for a certain filter, make sure you\'ve enabled it on the view tab first.
', array('%url' => url('admin/filters/'. arg(2)))); - - case 'admin/filters/'. arg(2) .'/order': - return t(' -Because of the flexible filtering system, you might encounter a situation where one filter prevents another from doing its job. For example: a word in an URL gets converted into a glossary term, before the URL can be converted in a clickable link. When this happens, you will need to rearrange the order in which filters get executed.
-Filters are executed from top-to-bottom. You can use the weight column to rearrange them: heavier filters \'sink\' to the bottom.
'); - } -} - -/** - * Implementation of hook_menu(). - */ -function filter_menu($may_cache) { - $items = array(); - - if ($may_cache) { - $items[] = array('path' => 'admin/filters', - 'title' => t('input formats'), - 'callback' => 'filter_admin_overview', - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/list', - 'title' => t('list'), - 'callback' => 'filter_admin_overview', - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/add', - 'title' => t('add input format'), - 'callback' => 'filter_admin_format_form', - 'type' => MENU_LOCAL_TASK, - 'weight' => 1, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/delete', - 'title' => t('delete input format'), - 'callback' => 'filter_admin_delete', - 'type' => MENU_CALLBACK, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'filter/tips', - 'title' => t('compose tips'), - 'callback' => 'filter_tips_long', - 'access' => TRUE, - 'type' => MENU_SUGGESTED_ITEM, - ); - } - else { - if (arg(0) == 'admin' && arg(1) == 'filters' && is_numeric(arg(2))) { - $formats = filter_formats(); - - if (isset($formats[arg(2)])) { - $items[] = array('path' => 'admin/filters/'. arg(2), - 'title' => t("'%format' input format", array('%format' => $formats[arg(2)]->name)), - 'callback' => 'filter_admin_format_form', - 'callback arguments' => array('format' => $formats[arg(2)]), - 'type' => MENU_CALLBACK, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/'. arg(2) .'/list', - 'title' => t('view'), - 'callback' => 'filter_admin_format_form', - 'callback arguments' => array('format' => $formats[arg(2)]), - 'type' => MENU_DEFAULT_LOCAL_TASK, - 'weight' => 0, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/'. arg(2) .'/configure', - 'title' => t('configure'), - 'callback' => 'filter_admin_configure', - 'type' => MENU_LOCAL_TASK, - 'weight' => 1, - 'access' => user_access('administer filters'), - ); - $items[] = array('path' => 'admin/filters/'. arg(2) .'/order', - 'title' => t('rearrange'), - 'callback' => 'filter_admin_order', - 'callback arguments' => array('format' => $formats[arg(2)]), - 'type' => MENU_LOCAL_TASK, - 'weight' => 2, - 'access' => user_access('administer filters'), - ); - } - } - } - - return $items; -} - -/** - * Implementation of hook_perm(). - */ -function filter_perm() { - return array('administer filters'); -} - -/** - * Implementation of hook_filter_tips(). - */ -function filter_filter_tips($delta, $format, $long = false) { - global $base_url; - switch ($delta) { - case 0: - if (variable_get("filter_html_$format", FILTER_HTML_STRIP) == FILTER_HTML_STRIP) { - if ($allowed_html = variable_get("allowed_html_$format", '