drupal/modules/blog.module

357 lines
15 KiB
Plaintext
Raw Normal View History

<?php
// $Id$
function blog_system($field){
$system["description"] = t("Enables users to keep a blog or online journal.");
return $system[$field];
}
function blog_conf_options() {
$output .= form_textarea("Explanation or submission guidelines", "blog_help", variable_get("blog_help", ""), 55, 4, "This text will be displayed at the top of the blog submission form. Useful for helping or instructing your users.");
$output .= form_select(t("Minimum number of words in a node"), "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 consist of. This can be useful to rule out submissions that do not meet the site's standards, such as short test posts."));
return $output;
}
function blog_node($field) {
global $user;
2002-01-07 22:08:52 +00:00
$info["name"] = t("personal blog entry");
$info["description"] = t("A blog is your personal diary or journal. It is made up of individual entries that are time stamped and are typically arranged by the day, as normal a diary. Blogs often contain links to things you've seen, or on which you agree/disagree. Since a Blog is personal, you and only you have full control on what you publish. The most interesting blogs, or those blogs that fit the site's topic might get promoted to the front page.");
return $info[$field];
}
function blog_access($op, $node) {
global $user;
if ($op == "view") {
return $node->status;
}
if ($op == "create") {
return $user->uid;
}
if ($op == "update") {
return ($user->uid == $node->uid);
}
if ($op == "delete") {
return ($user->uid == $node->uid);
}
}
function blog_user($type, &$edit, &$user) {
switch ($type) {
case "view_public":
case "view_private":
return form_item(t("Blog"), lm(t("view recent entries"), array("mod" => "blog", "id" => $user->uid), "", array("title" => t("View recent blog entries."))) ."<br />". lm(t("view all entries"), array("mod" => "blog", "id" => $user->uid, "all" => 1), "", array("title" => t("View all blog entries."))));
}
}
2001-11-12 22:17:52 +00:00
function blog_save($op, $node) {
if ($op == "approve") {
return array("promote" => 1);
}
if ($op == "create") {
if (user_access("administer nodes")) {
return array("body" => filter($node->body), "teaser" => filter($node->teaser));
}
else {
return array("body" => filter($node->body), "promote" => 0, "moderate" => 1, "status" => 1, "teaser" => filter($node->teaser));
}
2001-11-12 22:17:52 +00:00
}
if ($op == "decline") {
return array("promote" => 0);
}
if ($op == "update") {
if (user_access("administer nodes")) {
/*
** When an administrator updates blog entries through the admin
** pages, they will not be changed unless explicitly specified.
*/
return array("body" => filter($node->body), "teaser" => filter($node->teaser));
}
else {
/*
** Updating your own blog entry will demote it (if promoted),
** and will queue it in the moderation queue for promotion.
*/
return array("body" => filter($node->body), "promote" => 0, "moderate" => 1, "score" => 0, "teaser" => filter($node->teaser), "votes" => 0, "users" => 0);
}
2001-11-12 22:17:52 +00:00
}
}
function blog_help() {
?>
<p>Drupal's blog module allows registered users to maintain an online 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. It is made up of individual entries 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>
<p>The blog module adds a couple of menu options. Everyone gets to see the "latest blogs", a page that displays the most recent blog entries from every participant. If you are logged in, your personal menu also has "submit a blog" link which will lead you to a submission form. You are also presented a "view personal blog" menu option that displays your blog entries as other people will see it. For you only, there is an edit link at the bottom left of a page that lets you edit or delete old entries.</p>
<p>Both in the import module (news aggregator) and the blog module displays glyphs that looks like a pinboard stickit note. 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>
<p>For Drupal administrators a blog entry is just another node that can be administered from the "content management" page in the administration pages.</p>
<?php
}
2001-09-16 11:33:14 +00:00
function blog_feed_user($uid = 0, $date = 0) {
global $user;
2001-09-16 11:33:14 +00:00
if ($uid) {
$account = user_load(array("uid" => $uid, "status" => 1));
}
else {
$account = $user;
}
if (!$date) {
$date = time();
}
$result = db_query("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 = '$uid' AND n.created > '". ($date - 2592000) ."' ORDER BY n.nid DESC LIMIT 15");
while ($blog = db_fetch_object($result)) {
$items .= format_rss_item($blog->title, path_uri() . drupal_url(array("id" => $blog->nid)), $blog->teaser);
}
$output .= "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?>\n";
2001-11-28 22:00:45 +00:00
// $output .= "<!DOCTYPE rss [<!ENTITY % HTMLlat1 PUBLIC \"-//W3C//ENTITIES Latin 1 for XHTML//EN\" \"http://www.w3.org/TR/xhtml1/DTD/xhtml-lat1.ent\">\n";
$output .= "<rss version=\"0.91\">\n";
$output .= format_rss_channel("$account->name's blog", path_uri() . drupal_url(array("mod" => "blog", "op" => "view", "id" => $account->uid), "module"), "$account->name's blog", $items);
$output .= "</rss>\n";
header("Content-Type: text/xml");
print $output;
}
function blog_feed_last() {
$result = db_query("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' ORDER BY n.nid DESC LIMIT 15");
while ($blog = db_fetch_object($result)) {
$items .= format_rss_item($blog->title, path_uri() . drupal_url(array("id" => $blog->nid)), $blog->teaser);
}
$output .= "<?xml version=\"1.0\" encoding=\"ISO-8859-1\" ?>\n";
$output .= "<rss version=\"0.91\">\n";
$output .= format_rss_channel(variable_get("site_name", "drupal") .": user blogs", path_uri() . drupal_url(array("mod" => "blog"), "module"), "Recently updated blogs.", $items);
$output .= "</rss>\n";
header("Content-Type: text/xml");
print $output;
}
function blog_page_user($uid = 0, $date = 0, $all = 0) {
global $theme, $user;
2001-09-16 11:33:14 +00:00
if ($uid) {
$account = user_load(array("uid" => $uid, "status" => 1));
}
else {
$account = $user;
}
2001-09-16 11:33:14 +00:00
if (!$date) {
$date = time();
}
$result = db_query("SELECT nid FROM node WHERE type = 'blog' AND uid = '$account->uid' AND created <= '$date' ORDER BY nid DESC". ($all ? "" : " LIMIT 20"));
$output .= "<table border=\"0\" cellpadding=\"4\" cellspacing=\"4\">";
2001-08-05 14:33:53 +00:00
while ($node = db_fetch_object($result)) {
$blog = node_load(array("nid" => $node->nid));
2001-08-05 14:33:53 +00:00
if ($date != date("dny", $blog->created)) {
$date = date("dny", $blog->created);
2002-05-20 21:03:07 +00:00
$output .= "<tr><td colspan=\"3\"><b>". lm(format_date($blog->created, "small", "d M Y"), array("mod" => "blog", "id" => $blog->uid, "date" => mktime(23, 59, 59, date("n", $blog->created), date("d", $blog->created), date("Y", $blog->created))), "", array("title" => t("Permanent link to this date."))) ."</b></td></tr>";
2001-08-05 14:33:53 +00:00
}
$links = link_node($blog, 1);
2001-08-05 14:33:53 +00:00
$output .= "<tr><td><div style=\"margin-left: 20px;\"><b>". check_output($blog->title) ."</b></div></td><td align=\"right\">". $theme->links($links) ."</td><td>". l('<img src="misc/blog.gif" width="12" height="16" border="0" align="top">', array("id" => $node->nid), "node", "", array("title" => t("Permanent link to this blog entry."))) ."</td></tr>";
2002-05-20 21:03:07 +00:00
$output .= "<tr><td colspan=\"3\"><div style=\"margin-left: 40px;\">". check_output($blog->teaser, 1) ."</div><br /></td></tr>";
2001-08-05 14:33:53 +00:00
}
2001-08-05 14:33:53 +00:00
$output .= "</table>";
$output .= lm("<img src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" align=\"right\" border=\"0\" />", array("mod" => "blog", "op" => "feed", "id" => $account->uid), "", array("title" => t("Read the XML version of this page."))) ."\n";
if (!$all && $date) {
$output .= lm(t("show all blogs"), array("mod" => "blog", "op" => "view", "id" => $account->uid, "all" => 1), "", array("title" => t("Show all blogs by this user.")));
}
else {
$output .= lm(t("show recent blogs"), array("mod" => "blog", "op" => "view", "id" => $account->uid), "", array("title" => t("Show recent blogs by this user.")));
}
$theme->box(t("%u's blog", array("%u" => $account->name)), $output);
}
2001-07-14 14:19:45 +00:00
function blog_page_last() {
2001-08-05 14:33:53 +00:00
global $theme, $user;
$result = db_query("SELECT nid FROM node WHERE type = 'blog' ORDER BY nid DESC LIMIT 20");
$output .= "<table border=\"0\" cellpadding=\"4\" cellspacing=\"4\">";
2001-08-05 14:33:53 +00:00
while ($node = db_fetch_object($result)) {
$blog = node_load(array("nid" => $node->nid));
2001-08-05 14:33:53 +00:00
$links = link_node($blog, 1);
$output .= "<tr><td><b>". check_output($blog->title) ."</b></td><td align=\"right\">". $theme->links($links) ."</td><td>". l('<img src="misc/blog.gif" width="12" height="16" border="0" align="top">', array("id" => $node->nid), "node", "", array("title" => t("Permanent link to this blog entry"))) ."</td></tr>";
$output .= "<tr><td colspan=\"3\"><div style=\"margin-left: 20px;\">". check_output($blog->teaser, 1) ."</div><br /></td></tr>";
}
2001-08-05 14:33:53 +00:00
$output .= "</table>";
$output .= lm("<img src=\"". $theme->image("xml.gif") ."\" width=\"36\" height=\"14\" align=\"right\" border=\"0\" />", array("mod" => "blog", "op" => "feed"), "", array("title" => t("Read the XML version of this page."))) ."\n";
$theme->box(t("User blogs"), $output, "main");
}
function blog_form(&$node, &$help, &$error) {
global $nid, $iid;
if (isset($node->body)) {
/*
** Validate the size of the blog:
*/
if (count(explode(" ", $node->body)) < variable_get("minimum_blog_size", 0)) {
$error["body"] = "<div style=\"color: red;\">". t("The body of your blog is too short.") ."</div>";
}
}
else {
/*
** 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))) {
$node->body = "<i>". $blog->body ."</i> [".lm($blog->name, array("mod" => "blog", "id" => $blog->uid, "date" => $blog->created))."]";
}
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 = '%s' AND i.fid = f.fid", $iid))) {
$node->body = "<a href=\"$item->link\">$item->title</a> - <i>". check_output($item->description) ."</i> [<a href=\"$item->flink\">$item->ftitle</a>]\n";
}
}
if ($node->teaser) {
$output .= form_textarea(t("Teaser"), "teaser", $node->teaser, 60, 5, $error["teaser"]);
}
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() {
global $theme, $id, $op, $date, $all, $name;
2001-07-14 14:19:45 +00:00
if (user_access("access content")) {
switch ($op) {
case "feed":
2001-09-16 11:33:14 +00:00
if ($id) {
blog_feed_user($id, $date);
}
else {
blog_feed_last();
}
break;
default:
2001-07-14 15:09:56 +00:00
$theme->header();
if ($name) {
$user = user_load(array("name" => $name));
$id = $user->uid;
}
2001-09-16 11:33:14 +00:00
if ($id) {
blog_page_user($id, $date, $all);
}
else {
blog_page_last();
}
2001-07-14 15:09:56 +00:00
$theme->footer();
}
}
else {
2001-07-14 15:09:56 +00:00
$theme->header();
2001-07-14 14:19:45 +00:00
$theme->box(t("Access denied"), message_access());
2001-07-14 15:09:56 +00:00
$theme->footer();
}
2001-07-14 14:19:45 +00:00
}
function blog_link($type, $node = 0, $main) {
global $user;
if ($type == "page" && user_access("access content")) {
$links[] = lm(t("user blogs"), array("mod" => "blog"), "", array("title" => t("Read the latest blog entries.")));
}
if ($type == "menu.create" && user_access("post content")) {
$links[] = lm(t("create blog entry"), array("mod" => "node", "op" => "add", "type" => "blog"), "", array("title" => t("Add a new personal blog entry.")));
}
if ($type == "menu.view" && user_access("access content")) {
$links[] = lm(t("view personal blog"), array("mod" => "blog", "op" => "view", "id" => $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)) {
$links[] = lm(t("edit this blog"), array("mod" => "node", "op" => "edit", "id" => $node->nid), "", array("title" => t("Edit this blog entry.")));
}
elseif ($op != "view" && !$id) {
$links[] = lm(t("%u's blog", array("%u" => $node->name)), array("mod" => "blog", "op" => "view", "id" => $node->uid), "", array("title" => t("Read %u's latest blog entries.", array("%u" => $node->name))));
}
}
return $links ? $links : array();
}
function blog_block() {
2001-09-16 11:33:14 +00:00
global $user;
$result = db_query("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' ORDER BY n.nid DESC LIMIT 10");
if (user_access("access content")) {
while ($node = db_fetch_object($result)) {
$output .= l(check_output($node->title), array("id" => $node->nid)) ."<br />\n";
}
$output .= "<br /><div align=\"right\">".lm(t("more"), array("mod" => "blog"), t("Read the latest blog entries."))."</div>";
$block[0]["content"] = $output;
}
$block[0]["subject"] = t("User blogs");
$block[0]["info"] = t("User blogs");
$block[0]["link"] = drupal_url(array("mod" => "blog"), "module");
return $block;
}
?>