Drupal's blog module allows registered users to maintain an online weblog (commonly known as a blog), often referred to as an online journal or diary. These can be filled with daily thoughts, poetry, boneless blabber, spiritual theories, intimate details, valuable experiences, cynical rants, semi-coherent comments, writing experiments, artistic babblings, critics on current facts, fresh insights, diverse dreams, chronicles and mumbling madness available for public consumption.
Blogs are made up of individual entries (nodes) that are timestamped and are typically viewed by day as you would a diary. Blogs often contain links to things you've seen and/or agree/disagree with. A typical example of a long term blog can be seen at %scripting-com.
-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. Personal user menus gain 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). On the bottom of each of your own blog entries, there is an \"edit this blog entry\" link that lets you edit or delete that entry.
+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. Personal user menus gain a \"create a blog entry\" link (which takes you to a submission form) and a \"view blog\" link (which displays your blog entries as other people will see them). On the bottom of each of your own blog entries, there is an \"edit this blog entry\" link that lets you edit or delete that entry.
If a user has the ability to post blogs, then the import module (news aggregator) will display a blog-it link (b) next to each news item in its lists. Click on this and you will be taken 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 you to add your explanation. This actively encourages people to add blog entries about things they see and hear elsewhere in the Drupal site and from your syndicated partner sites.
", array("%scripting-com" => "http://www.scripting.com/")); break; case 'admin/system/modules#description': @@ -84,19 +124,19 @@ $account = $user; } - $result = db_query_range("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND u.uid = %d AND n.status = 1 ORDER BY n.nid DESC", $uid, 0, 15); + $result = db_query_range("SELECT * FROM {node} n INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND u.uid = %d AND n.status = 1 ORDER BY n.nid DESC", $uid, 0, variable_get("blog_syndicate_entries", 15)); $channel["title"] = $account->name ."'s blog"; - $channel["link"] = url("blog/view/$uid", NULL, NULL, TRUE); - $channel["description"] = $term->description; - node_feed($result, $channel); + $channel["link"] = url("blog/$uid", NULL, NULL, TRUE); + $channel["description"] = variable_get('site_mission',''); + _blog_feed($result, $channel); } function blog_feed_last() { - $result = db_query_range("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM {node} n INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, 15); - $channel["title"] = variable_get("site_name", "drupal") ." blogs"; - $channel["link"] = url("blog"); - $channel["description"] = $term->description; - node_feed($result, $channel); + $result = db_query_range("SELECT * FROM {node} n INNER JOIN {users} u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, variable_get("blog_syndicate_entries",15)); + $channel["title"] = variable_get("site_name", "drupal"); + $channel["link"] = url("", NULL, NULL, TRUE); + $channel["description"] = variable_get('site_mission',''); + _blog_feed($result, $channel); } function blog_page_user($uid) { @@ -139,7 +179,7 @@ ** Validate the size of the blog: */ - if (isset($node->body) && count(explode(" ", $node->body)) < variable_get("minimum_blog_size", 0)) { + if (isset($node->body) && count(explode(" ", $node->body." ".$node->extended)) < variable_get("minimum_blog_size", 0)) { $error["body"] = theme("error", t("The body of your blog is too short.")); } @@ -170,7 +210,14 @@ $output .= implode("", taxonomy_node_form("blog", $node)); } - $output .= form_textarea(t("Body"), "body", $node->body, 60, 15, $error["body"] ? $error["body"] : filter_tips_short()); + $output .= form_textarea(t("Entry Body"), "body", $node->body, 60, 10, ""); + + $output .= form_textarea(t("Extended Entry"), "extended", $node->extended, 60, 15, ""); + + $output .= form_textarea(t("Excerpt"), "excerpt", $node->excerpt, 60, 5, $error["body"] ? $error["body"] : filter_tips_short()); + + $format_type = array(-1 => "No formatting", 0 => "Convert Line Breaks", 1 => "Simple Wiki"); + $output .= form_select(t("Text Formatting"), "format", $node->format, $format_type, t("'Convert Line Breaks' enclose your paragraph in <p> and </p> tag for you which is what most bloggers are used to. 'No formatting' assume you will do all HTML formatting. 'Simple Wiki' supports very basic Wiki Formatting Rules.")); return $output; } @@ -197,7 +244,7 @@ } function blog_content($node, $main = 0) { - return node_prepare($node, $main); + return _blog_prepare($node, $main); } function blog_view($node, $main = 0, $page = 0) { @@ -223,7 +270,7 @@ if ($type == "system") { if (user_access("edit own blog")) { menu("node/add/blog", t("blog entry"), "node_page", 0); - menu("blog/". $user->uid, t("my blog"), "blog_page", 1); + menu("blog/". $user->uid, t("blog archives"), "blog_page", 1); } if (user_access("access content")) { menu("blog", t("blogs"), "blog_page", 0, MENU_HIDE); @@ -235,7 +282,7 @@ } if ($type == "node" && $node->type == "blog") { - if (blog_access("update", $node)) { + if (blog_access("update", $node) && !user_access('administer nodes')) { $links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry."))); } elseif (arg(0) != 'blog' && arg(1) != $node->uid) { @@ -254,12 +301,229 @@ } else { if (user_access("access content")) { - $block["content"] = node_title_list(db_query_range("SELECT n.title, n.nid FROM {node} n WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, 10)); + $block["content"] = node_title_list(db_query_range("SELECT n.title, n.nid FROM {node} n WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, variable_get("blog_block_entries",10))); + $block["content"] .= theme('xml_icon', url('blog/feed')); $block["content"] .= "". check_output($p) ."
"; + } + return implode("\n\n",$paras); + } + + // Simple Wiki + if ($node->format == 1) { + //include_once "modules/wiki.module"; + //return _wiki_transform($str); + $wiki_search = array( + "/('*)'''(.*?)'''/", + "/''(.*)''/", + "/----+/", + "/\[(http|https|ftp|mailto):(\S+)\s+([^\]]+)\]/", + "/^(http|https|ftp):\/\/(\S+)(gif|jpg|png|bmp|jpeg)/", + "/([^\"\[])(http|https|ftp|mailto):(\S+)/", + ); + + $wiki_replace = array( + "\\1\\2", + "\\1", + "" . check_output( + preg_replace($wiki_search,$wiki_replace,$p)) . "
"; + } + return implode("\n\n",$paras); + } + + return $str; +} + +function _blog_prepare($node,$main = 0) { + $node->readmore = (strlen($node->extended) > 0 + || strlen($node->excerpt > 0)); + if ($main == 0) { + $str = rtrim($node->body) . "\n\n" . rtrim($node->extended); + $node->body = _blog_process_format($node,$str); + } else { + if (strlen(rtrim($node->excerpt)) > 0) + $node->teaser = _blog_process_format($node,rtrim($node->excerpt)); + else + $node->teaser = _blog_process_format($node,rtrim($node->body)); + } + return $node; +} + +/* +** based on node_feed +*/ +function _blog_feed($nodes = 0, $channel = array()) { + global $base_url, $languages; + + /* + ** A generic function for generating RSS feeds from a set of nodes. + ** - $nodes should be an object as returned by db_query() which contains + ** the nid field. + ** - $channel is an associative array containing title, link, + ** description and other keys. The link should be an absolute URL. + */ + + if (!$nodes) { + return blog_feed_last(); + } + + while ($node = db_fetch_object($nodes)) { + /* + ** Load the specified node: + */ + + $item = node_load(array('nid' => $node->nid)); + $link = url("node/view/$node->nid", NULL, NULL, 1); + + switch (variable_get("blog_syndicate_rss",0)) { + case 0: + $node = _blog_prepare($item,0); + $desc = drupal_specialchars($node->body); + break; + case 1: + $node = _blog_prepare($item,1); + $node->teaser .= "...read more"; + $desc = drupal_specialchars($node->teaser); + break; + } + $items .= _blog_format_rss_item($item->title, $link, $desc, + array( + 'dc:date' => iso8601_date($item->changed), + 'dc:creator' => $item->name, +# need to add category/taxonomy info + ) + ); + } + + $channel_defaults = array( + 'version' => '0.92', + 'title' => variable_get('site_name', 'drupal') .' - '. variable_get('site_slogan', ''), + 'link' => $base_url, + 'description' => variable_get('site_mission', ''), + 'language' => (($key = reset(array_keys($languages))) ? $key : 'en') + ); + $channel = array_merge($channel_defaults, $channel); + + $output = "\n"; + $output .= "]>\n"; + $output .= "When enabled, the Drupal comment module creates a discussion board for each Drupal node. Users can post comments to discuss a forum topic, weblog post, collaborative book page, etc.
(Only for Partial of Full Comment Control)
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. Additional settings include:
(Only for Full Comment Control)
On sites with active commenting from users, the administrator can turn over comment moderation to the community.
With comment moderation, each comment is automatically assigned an initial rating. As users read comments, they can apply a vote which affects the comment rating. At the same time, users have an additional option in the control panel which allows them to set a threshold for the comments they wish to view. Those comments with ratings lower than the set threshold will not be shown.
To enable moderation, the administrator must grant moderate comments permissions. Then, a number of options in administer » comments » moderation must be configured.
(Only for Full Comment Control)
The first step is to create moderation labels which allow users to rate a comment. Go to administer » comments » moderation » votes. In the vote field, enter the textual labels which users will see when casting their votes. Some examples are
Using the weight option, you can control the order in which the votes appear to users. Setting the weight heavier (positive numbers) will make the vote label appear at the bottom of the list. Lighter (a negative number) will push it to the top. To encourage positive voting, a useful order might be higher values, positive votes, at the top, with negative votes at the bottom.
(Only for Full Comment Control)
Next go to administer » comments » moderation » matrix. Enter the values for the vote labels for each permission role in the vote matrix. The values entered here will be used to create the rating for each comment.
NOTE: Comment ratings are calculated by averaging user votes with the initial rating.
(Only for Full Comment Control)
In administer » comments » moderation » thresholds, you'll have to create some comment thresholds to make the comment rating system useful. When comment moderation is enabled and the thresholds are created, users will find another comment control panel option for selecting their thresholds. They'll use the thresholds you enter here to filter out comments with low ratings. Consequently, you'll probably want to create more than one threshold to give users some flexibility in filtering comments.
When creating the thresholds, note that the Minimum score is asking you for the lowest rating that a comment can have in order to be displayed.
To see a common example of how thresholds work, you might visit Slashdot and view one of their comment boards associated with a story. You can reset the thresholds in their comment control panel.
(Only for Full Comment Control)
Finally, you may want to enter some initial comment scores. In administer » comments » initial comment scores you can assign a beginning rating for all comments posted by a particular permission role. If you do not assign any initial scores, Drupal will assign a rating of 0 as the default.
", array("%comment-config" => url("admin/system/modules/comment"), "%site-config" => url("admin/system"), "%user-permissions" => url("admin/user/permission"), "%tracker" => url("tracker"), "%download-notify" => "http://drupal.org/project/releases", "%permission" => url("admin/user/permission"), "%comment-moderation" => url("admin/comment/moderation"), "%comment-votes" => url("admin/comment/moderation/votes"), "%comment-matrix" => url("admin/comment/moderation/matrix"), "%comment-thresholds" => url("admin/comment/moderation/filters"), "%slashdot" => " http://slashdot.org", "%comment-initial" => url("admin/comment/moderation/roles"))); break; case 'admin/system/modules#description': @@ -114,23 +119,32 @@ } function comment_settings() { - $group = form_radios(t("Default display mode"), "comment_default_mode", variable_get("comment_default_mode", 4), _comment_get_modes(), t("The default view for comments. Expanded views display the body of the comment. Threaded views keep replies together.")); - $group .= form_radios(t("Default display order"), "comment_default_order", variable_get("comment_default_order", 1), _comment_get_orders(), 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.")); - $group .= form_select(t("Default comments per page"), "comment_default_per_page", variable_get("comment_default_per_page", "50"), _comment_per_page(), t("Default number of comments for each page: more comments are distributed in several pages.")); - $group .= form_radios(t("Comment controls"), "comment_controls", variable_get("comment_controls", 0), array(t("Display above the comments"), t("Display below the comments"), t("Display above and below the comments"), t("Do not display")), t("Position of the comment controls box. The comment controls let the user change the default display mode and display order of comments.")); - $output = form_group(t('Comment viewing options'), $group); - - $group = form_radios(t("Preview comment"), "comment_preview", variable_get("comment_preview", 1), array(t("Optional"), t("Required")), t("Must users preview comments before submitting?")); - $group .= form_radios(t("Location of comment submission form"), "comment_form_location", variable_get("comment_form_location", 0), array(t("Display on separate page"), t("Display below post or comments")), t("The location of the comment submission form.")); - $output .= form_group(t('Comment posting settings'), $group); - - $result = db_query("SELECT fid, filter FROM {moderation_filters} "); - while ($filter = db_fetch_object($result)) { - $thresholds[$filter->fid] = ($filter->filter); - } - if ($thresholds) { - $group = form_select(t("Default threshold"), "comment_default_threshold", variable_get("comment_default_threshold", 0), $thresholds, t("Thresholds are values below which comments are hidden. These thresholds are useful for busy sites which want to hide poor comments from most users.")); - $output .= form_group(t('Comment moderation settings'), $group); + $group = form_radios(t("Comment Complexity"), "comment_complex", variable_get("comment_complex", 0), array(0 => t("Simple Comment Control"), 1 => t("Partial Comment Control (no moderation)"), 2 => t("Full Comment Control")),t("'Simple Comment Control' is easier to managed and sufficient for most people. 'Partial Comment Control' enables threaded comments but no moderation features. 'Full Comment Control' gives you complete control.")); + $group .=form_radios(t("Anonymous comment options"), "comment_anon", variable_get("comment_anon", 1), array(0 => t("Anonymous users may not enter their contact info"), 1=> t("Anonymous users may leave their contact info"), 2=> t("Anonymous users must leave their contact info")), t("This feature is only useful if you allow anonymous user to post comments. Set this in the ") . l(t("account permission"),"admin/user/permission") . t(" configuration.")); + $output = form_group(t('Comment control'), $group); + + $group = ""; + if (variable_get("comment_complex",0)) { + $group .= form_radios(t("Default display mode"), "comment_default_mode", variable_get("comment_default_mode", 4), _comment_get_modes(), t("The default view for comments. Expanded views display the body of the comment. Threaded views keep replies together.")); + $group .= form_radios(t("Default display order"), "comment_default_order", variable_get("comment_default_order", 1), _comment_get_orders(), 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.")); + $group .= form_select(t("Default comments per page"), "comment_default_per_page", variable_get("comment_default_per_page", "50"), _comment_per_page(), t("Default number of comments for each page: more comments are distributed in several pages.")); + $group .= form_radios(t("Comment controls"), "comment_controls", variable_get("comment_controls", 0), array(t("Display above the comments"), t("Display below the comments"), t("Display above and below the comments"), t("Do not display")), t("Position of the comment controls box. The comment controls let the user change the default display mode and display order of comments.")); + $output .= form_group(t('Comment viewing options'), $group); + + $group = form_radios(t("Preview comment"), "comment_preview", variable_get("comment_preview", 1), array(t("Optional"), t("Required")), t("Must users preview comments before submitting?")); + $group .= form_radios(t("Location of comment submission form"), "comment_form_location", variable_get("comment_form_location", 1), array(t("Display on separate page"), t("Display below post or comments")), t("The location of the comment submission form.")); + $output .= form_group(t('Comment posting settings'), $group); + + if (variable_get("comment_complex",0)>1) { + $result = db_query("SELECT fid, filter FROM {moderation_filters} "); + while ($filter = db_fetch_object($result)) { + $thresholds[$filter->fid] = ($filter->filter); + } + if ($thresholds) { + $group = form_select(t("Default threshold"), "comment_default_threshold", variable_get("comment_default_threshold", 0), $thresholds, t("Thresholds are values below which comments are hidden. These thresholds are useful for busy sites which want to hide poor comments from most users.")); + $output .= form_group(t('Comment moderation settings'), $group); + } + } } return $output; @@ -187,6 +201,11 @@ $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status != 2", $cid)); $comment = drupal_unpack($comment); + + if (!$comment->uid && variable_get("comment_anon",1)) + $comment->name = _comment_anon_namefix($comment, + unserialize($comment->anon)); + if (comment_access("edit", $comment)) { return comment_preview(object2array($comment)); } @@ -205,6 +224,9 @@ if ($pid) { $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status = 0", $pid)); $comment = drupal_unpack($comment); + if (!$comment->uid && variable_get("comment_anon",1)) + $comment->name = _comment_anon_namefix($comment, + unserialize($comment->anon)); $output .= theme("comment_view", $comment); } else if (user_access("access content")) { @@ -250,6 +272,10 @@ $comment->name = $user->name; $comment->timestamp = time(); + if (!$user->uid + && variable_get("comment_anon",1)) + $comment->name = _comment_anon_namefix($comment,$edit); + /* ** Preview the comment: */ @@ -260,6 +286,9 @@ if ($edit["pid"]) { $comment = db_fetch_object(db_query("SELECT c.*, u.uid, u.name, u.data FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.cid = %d AND c.status = 0", $edit["pid"])); $comment = drupal_unpack($comment); + if (!$comment->uid && variable_get("comment_anon",1)) + $comment->name = _comment_anon_namefix($comment, + unserialize($comment->anon)); $output .= theme("comment_view", $comment); } else { @@ -428,7 +457,15 @@ $edit["cid"] = db_next_id("{comments}_cid"); - db_query("INSERT INTO {comments} (cid, nid, pid, uid, subject, comment, hostname, timestamp, status, score, users, thread) VALUES (%d, %d, %d, %d, '%s', '%s', '%s', %d, %d, %d, '%s', '%s')", $edit["cid"], $edit["nid"], $edit["pid"], $user->uid, $edit["subject"], $edit["comment"], $_SERVER['REMOTE_ADDR'], time(), $status, $score, $users, $thread); + $anon = ""; + if (variable_get("comment_anon",1)) { + $anon = serialize(array( + 'anon_name' => trim(strip_tags($edit['anon_name'])), + 'anon_mail' => trim(strip_tags($edit['anon_mail'])), + 'anon_url' => trim(strip_tags($edit['anon_url'])))); + } + + db_query("INSERT INTO {comments} (cid, nid, pid, uid, subject, comment, hostname, timestamp, status, score, users, anon, thread) VALUES (%d, %d, %d, %d, '%s', '%s', '%s', %d, %d, %d, '%s', '%s', '%s')", $edit["cid"], $edit["nid"], $edit["pid"], $user->uid, $edit["subject"], $edit["comment"], $_SERVER['REMOTE_ADDR'], time(), $status, $score, $users, $anon, $thread); /* ** Tell the other modules a new comment has been submitted: @@ -532,6 +569,7 @@ if (empty($mode)) { $mode = $user->mode ? $user->mode : ($_SESSION["comment_mode"] ? $_SESSION["comment_mode"] : variable_get("comment_default_mode", 4)); + if (variable_get("comment_complex",0) == 0) $mode = 2; } if (empty($order)) { @@ -561,6 +599,9 @@ $result = db_query("SELECT c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, 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 = 0 GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users", $cid); if ($comment = db_fetch_object($result)) { + if (!$comment->uid && variable_get("comment_anon",1)) + $comment->name = _comment_anon_namefix($comment, + unserialize($comment->anon)); $output .= theme("comment_view", $comment, theme('links', module_invoke_all('link', 'comment', $comment, 1))); } @@ -575,7 +616,12 @@ ** Multiple comments view */ - $query .= "SELECT c.cid as cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users, c.thread FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.nid = '". check_query($nid) ."' AND c.status = 0"; + $query .= "SELECT c.cid as cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.status, c.anon, c.users, c.thread FROM {comments} c INNER JOIN {users} u ON c.uid = u.uid WHERE c.nid = '". check_query($nid); + + if (!user_access("administer comments")) + $query .= "' AND c.status = 0"; + else + $query .= "' AND (c.status = 0 OR c.status = 1)"; $query .= " GROUP BY c.cid, c.pid, c.nid, c.subject, c.comment, c.timestamp, u.uid, u.name, u.data, c.score, c.users, c.thread"; @@ -671,7 +717,7 @@ */ $result = pager_query($query, $comments_per_page, 0, "SELECT COUNT(*) FROM {comments} WHERE nid = '". check_query($nid) ."'"); - if (db_num_rows($result) && (variable_get("comment_controls", 0) == 0 || variable_get("comment_controls", 0) == 2)) { + if (db_num_rows($result) && ((variable_get("comment_controls", 0) == 0 && variable_get("comment_complex",0)) || variable_get("comment_controls", 0) == 2)) { $output .= "