drupal/modules/blog.module

260 lines
11 KiB
Plaintext
Raw Normal View History

<?php
// $Id$
function blog_system($field){
2002-06-09 16:44:52 +00:00
$system["description"] = t("Enables keeping a blog or easily and regularly updated web page.");
$system["admin_help"] = t("A weBLOG is a running journal of a users ideas. Enter the minimum word count for a single entry, and the text displayed on the entry submission form");
return $system[$field];
}
function blog_settings() {
$output = form_textarea(t("Explanation or submission guidelines"), "blog_help", variable_get("blog_help", ""), 70, 4, t("This text is displayed at the top of the blog submission form. It's useful for helping or instructing your users."));
$words = t("words");
$output .= form_select(t("Minimum number of words in a blog entry"), "minimum_blog_size", variable_get("minimum_blog_size", 0), array(0 => "0 $words", 10 => "10 $words", 25 => "25 $words", 50 => "50 $words", 75 => "75 $words", 100 => "100 $words", 125 => "125 $words", 150 => "150 $words", 175 => "175 $words", 200 => "200 $words"), t("The minimum number of words a personal blog entry should contain. This is useful to rule out submissions that do not meet the site's standards, such as short test posts."));
2002-06-09 16:44:52 +00:00
return $output;
}
function blog_node($field) {
global $user;
2002-01-07 22:08:52 +00:00
$info["name"] = t("personal blog entry");
2002-06-09 16:44:52 +00:00
$info["description"] = t("A blog is a regularly updated web page that is similar to a diary -- that (generally) anyone in the world can see. It is made up of individual entries, often called posts, that are time stamped and typically arranged by the day, with the newest on top (a diary is the reverse). Blogs often contain links to things you've seen, or on which you agree/disagree. Some blogs also contain original material written solely for the blog. Since a Blog is personal, you and only you have full control on what you publish. The most interesting blog entries or those blog entries that fit the site's topic well might get promoted to the front page by the community or the people with access to do this.");
return $info[$field];
}
function blog_perm() {
return array("maintain personal blog");
}
function blog_access($op, $node) {
global $user;
if ($op == "view") {
return $node->status;
}
if ($op == "create") {
return user_access("maintain personal blog") && $user->uid;
}
if ($op == "update") {
return user_access("maintain personal blog") && ($user->uid == $node->uid);
}
if ($op == "delete") {
return user_access("maintain personal blog") && ($user->uid == $node->uid);
}
}
function blog_head($main = 0) {
$mod = arg(0);
$id = arg(1);
2003-04-21 14:55:03 +00:00
$output = array();
if ($mod == "blog" && $id) {
$account = user_load(array("uid" => $id));
$output[] = "<link rel=\"alternate\" type=\"application/rss+xml\" title=\"RSS - ". $account->name. "'s blog\" href=\"". url("blog/view/$id") ."\" />";
}
2003-04-21 14:55:03 +00:00
return $output;
}
function blog_user($type, &$edit, &$user) {
switch ($type) {
case "view_public":
case "view_private":
return form_item(t("Blog"), l(t("view recent blog entries"), "blog/$user->uid", array("title" => t("Read %username's latest blog entries.", array("%username" => $user->name)))));
}
}
function blog_help() {
$output .= "<p>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. They 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.";
$output .= " Blogs 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, or agree/disagree with. A typical example of a long term blog can be seen at <a href=\"http://www.scripting.com/\">http://www.scripting.com/</a>.</p>";
$output .= "<p>The blog module adds a couple of menu options. \"user blogs\", a page that everyone gets to see that displays the most recent blog entries from every participant. Your personal menu adds a \"create a blog entry\" link which takes you to a submission form, a \"view personal blog\" link which displays your blog entries as <i>other</i> people will see them. And, on the bottom of each of your blog entry, there is an \"edit this blog entry\" link that lets you edit or delete old entries.</p>";
$output .= "<p>In the import module (news aggregator) a glyph that looks like a pinboard stickit note is displayed. Click on this and you are taken to the blog submission form. The system helpfully copies the title, a link to the item, and a link to the source into the body text 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.</p>";
return t($output);
}
function blog_feed_user($uid = 0) {
global $user;
2001-09-16 11:33:14 +00:00
if ($uid) {
$account = user_load(array("uid" => $uid, "status" => 1));
}
else {
$account = $user;
}
$result = db_query_range("SELECT n.nid, n.title, n.teaser, n.created, u.name, u.uid FROM node n LEFT 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);
$channel["title"] = $account->name. "'s blog";
$channel["link"] = url("blog/view/$uid");
$channel["description"] = $term->description;
node_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 LEFT JOIN users u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, 15);
2003-01-06 19:51:01 +00:00
$channel["title"] = variable_get("site_name", "drupal") ." blogs";
$channel["link"] = url("blog");
$channel["description"] = $term->description;
node_feed($result, $channel);
}
function blog_page_user($uid = 0) {
global $user;
2001-09-16 11:33:14 +00:00
if ($uid) {
$account = user_load(array((is_numeric($uid) ? "uid" : "name") => $uid, "status" => 1));
2001-09-16 11:33:14 +00:00
}
else {
$account = $user;
}
$result = pager_query("SELECT nid FROM node WHERE type = 'blog' AND uid = '$account->uid' AND status = 1 ORDER BY nid DESC", variable_get("default_nodes_main", 10));
while ($node = db_fetch_object($result)) {
node_view(node_load(array("nid" => $node->nid)), 1);
}
print pager_display(NULL, variable_get("default_nodes_main", 10));
print l("<img align=\"right\" src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" alt=\"\" />", "blog/feed/$account->uid", array("title" => t("View the XML version of %username's blog", array ("%username" => $account->name))));
}
2001-07-14 14:19:45 +00:00
function blog_page_last() {
global $user;
$result = pager_query("SELECT nid FROM node WHERE type = 'blog' AND status = 1 ORDER BY nid DESC", variable_get("default_nodes_main", 10));
2001-08-05 14:33:53 +00:00
while ($node = db_fetch_object($result)) {
$output = node_view(node_load(array("nid" => $node->nid)), 1);
}
$output .= pager_display(NULL, variable_get("default_nodes_main", 10));
$output .= l("<img align=\"right\" src=\"". theme("image", "xml.gif") ."\" width=\"36\" height=\"14\" border=\"0\" alt=\"\" />", "blog/feed", array("title" => t("Read the XML version of all blogs.")));
return $output;
}
function blog_form(&$node, &$help, &$error) {
global $nid, $iid;
if (empty($node->body)) {
/*
** Carry out some explanation or submission guidelines:
*/
$help = variable_get("blog_help", "");
/*
** If the user clicked a "blog it" link, we load the data from the
** database and quote it in the blog:
*/
if ($nid && $blog = node_load(array("nid" => $nid))) {
2003-01-06 19:51:01 +00:00
$node->body = "<i>". $blog->body ."</i> [". l($blog->name, "node/view/$nid") ."]";
}
if ($iid && $item = db_fetch_object(db_query("SELECT i.*, f.title as ftitle, f.link as flink FROM item i, feed f WHERE i.iid = %d AND i.fid = f.fid", $iid))) {
$node->title = $item->title;
$node->body = "<a href=\"$item->link\">$item->title</a> - <i>". check_output($item->description) ."</i> [<a href=\"$item->flink\">$item->ftitle</a>]\n";
}
}
else {
/*
** Validate the size of the blog:
*/
if (count(explode(" ", $node->body)) < variable_get("minimum_blog_size", 0)) {
$error["body"] = theme("theme_error", t("The body of your blog is too short."));
}
}
if (function_exists("taxonomy_node_form")) {
2002-05-20 16:39:58 +00:00
$output .= implode("", taxonomy_node_form("blog", $node));
}
2001-12-08 13:29:43 +00:00
$output .= form_textarea(t("Body"), "body", $node->body, 60, 15, $error["body"] ? $error["body"] : t("Allowed HTML tags") .": ". htmlspecialchars(variable_get("allowed_html", "")));
return $output;
}
function blog_page() {
if (user_access("access content")) {
2003-01-06 19:51:01 +00:00
switch (arg(1)) {
case "feed":
2003-01-06 19:51:01 +00:00
if (arg(2)) {
blog_feed_user(arg(2));
}
else {
blog_feed_last();
}
break;
default:
theme("header");
2003-01-06 19:51:01 +00:00
if (arg(1)) {
blog_page_user(arg(1));
}
else {
print blog_page_last();
}
theme("footer");
}
}
else {
theme("header");
theme("box", t("Access denied"), message_access());
theme("footer");
}
2001-07-14 14:19:45 +00:00
}
function blog_link($type, $node = 0, $main) {
global $user;
2003-04-21 14:55:03 +00:00
$links = array();
if ($type == "page" && user_access("access content")) {
$links[] = l(t("blogs"), "blog", array("title" => t("Read the latest blog entries.")));
}
if ($type == "menu.create" && user_access("maintain personal blog")) {
2003-01-06 19:51:01 +00:00
$links[] = l(t("create blog entry"), "node/add/blog", array("title" => t("Add a new personal blog entry.")));
}
if ($type == "menu.view" && user_access("maintain personal blog")) {
2003-01-06 19:51:01 +00:00
$links[] = l(t("view personal blog"), "blog/$user->uid", array("title" => t("Read your latest blog entries.")));
}
if ($type == "node" && $node->type == "blog") {
global $mod, $op, $id;
if (blog_access("update", $node)) {
2003-01-06 19:51:01 +00:00
$links[] = l(t("edit this blog entry"), "node/edit/$node->nid", array("title" => t("Edit this blog entry.")));
}
elseif (empty($id)) {
2003-01-06 19:51:01 +00:00
$links[] = l(t("%username's blog", array("%username" => $node->name)), "blog/$node->uid", array("title" => t("Read %username's latest blog entries.", array("%username" => $node->name))));
}
}
2003-04-21 14:55:03 +00:00
return $links;
}
function blog_block($op = "list", $delta = 0) {
2001-09-16 11:33:14 +00:00
global $user;
if ($op == "list") {
$block[0]["info"] = t("Blogs");
2002-11-09 20:51:23 +00:00
return $block;
}
else {
if (user_access("access content")) {
$block["content"] = node_title_list(db_query_range("SELECT u.uid, u.name, n.created, n.title, n.nid FROM node n LEFT JOIN users u ON n.uid = u.uid WHERE n.type = 'blog' AND n.status = 1 ORDER BY n.nid DESC", 0, 10));
2003-01-06 19:51:01 +00:00
$block["content"] .= "<div align=\"right\" id=\"blog_more\">". l(t("more"), "blog", array("title" => t("Read the latest blog entries."))) ."</div>";
$block["subject"] = t("Blogs");
}
return $block;
}
}
2003-01-20 20:19:21 +00:00
?>