Thousands of sites (particularly news sites and weblogs) publish their latest headlines and/or stories in a machine-readable format so that other sites can easily link to them. This content is usually in the form of an RSS feed (which is an XML-based syndication standard).
-You can read aggregated content from many sites using RSS feed readers, such as Amphetadesk.
-Drupal provides the means to aggregate feeds from many sites and display these aggregated feeds to your site\'s visitors. To do this, enable the aggregator module in site administration and then go to the aggregator configuration page, where you can subscribe to feeds and set up other options.
-Many web sites (especially weblogs) display small XML icons or other obvious links on their home page. You can follow these to obtain the web address for the RSS feed. Common extensions for RSS feeds are .rss, .xml and .rdf. For example: Slashdot RSS.
-If you can\'t find a feed for a site, or you want to find several feeds on a given topic, try an RSS syndication directory such as Syndic8.
-To learn more about RSS, read Mark Pilgrim\'s What is RSS and WebReference.com\'s The Evolution of RSS articles.
-NOTE: Enable your site\'s XML syndication button by turning on the Syndicate block in block management.
-To subscribe to an RSS feed on another site, use the aggregation page.
-Once there, click the new feed tab. Drupal will then ask for the following:
+The news aggregator is a powerful on-site RSS syndicator/news reader that can gather fresh content from news sites and weblogs around the web.
+Users can view the latest news chronologically in the main news aggregator display or by source. Administrators can add, edit and delete feeds and choose how often to check for newly updated news for each individual feed. Administrators can also tag individual feeds with categories, offering selective grouping of some feeds into separate displays. Listings of the latest news for individual sources or categorized sources can be enabled as blocks for display in the sidebar through the block administration page. The news aggregator requires cron to check for the latest news from the sites to which you have subscribed. Drupal also provides a machine-readable OPML file of all of your subscribed feeds.
+You can
Once you have submitted the new feed, check to make sure it is working properly by selecting update items on the aggregation page. If you do not see any items listed for that feed, edit the feed and make sure that the URL was entered correctly.
-News items can be filed into categories. To create a category, start at the aggregation page.
-Once there, select new category from the menu. Drupal will then ask for the following:
-The news aggregator has a number of ways that it displays your subscribed content:
-Pages that display items (for sources, categories, etc.) display the following for each item: -
Additionally, users with the administer news feeds permission will see a link to categorize the news items. Clicking this will allow them to select which category(s) each news item is in.
-Drupal automatically generates an OPML feed file that is available by selecting the XML icon on the News Sources page.
-When fetching feeds Drupal supports conditional GETs, this reduces the bandwidth usage for feeds that have not been updated since the last check.
-If a feed is permanently moved to a new location Drupal will automatically update the feed URL to the new address.
', array('%block' => url('admin/block'), '%admin-news' => url('admin/aggregator'), '%new-feed' => url('admin/aggregator/add/feed'), '%new-category' => url('admin/aggregator/add/category'), '%update-items' => url('admin/aggregator'), '%news-aggregator' => url('aggregator'), '%sources' => url('aggregator/sources'), '%categories' => url('aggregator/categories'))); +For more information, read the configuration and customization handbook aggregator page.
+ ',array('%mainnewsaggregatordisplay' => url('aggregator'),'%newsaggregatorsources' => url('aggregator/sources'),'%blockadministration' => url('admin/block'),'%OPMLfile' => url('aggregator/opml'),'%administerfeeds' => url('admin/aggregator'),'%addfeed' => url('admin/aggregator/add/feed'),'%addcategory' => url('admin/aggregator/add/category'),'%configuresettings' => url('admin/settings/aggregator'),'%accesspermissions' => url('admin/access'))); case 'admin/modules#description': return t('Aggregates syndicated content (RSS and RDF feeds).'); case 'admin/aggregator': Index: modules/archive.module =================================================================== RCS file: /cvs/drupal/drupal/modules/archive.module,v retrieving revision 1.79 diff -u -r1.79 archive.module --- modules/archive.module 1 Apr 2005 15:54:58 -0000 1.79 +++ modules/archive.module 30 Jun 2005 16:43:16 -0000 @@ -11,6 +11,18 @@ */ function archive_help($section) { switch ($section) { + case 'admin/help#archive': + return 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.
+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.
+You can
+For more information, read the configuration and customization handbook archive page.
+ ',array('%archivebyday' => url('archive'),'%blockadministration' => url('admin/block'))); case 'admin/modules#description': return t('Displays a calendar for navigating older content.'); } Index: modules/block.module =================================================================== RCS file: /cvs/drupal/drupal/modules/block.module,v retrieving revision 1.162.2.3 diff -u -r1.162.2.3 block.module --- modules/block.module 22 May 2005 12:50:09 -0000 1.162.2.3 +++ modules/block.module 30 Jun 2005 16:37:25 -0000 @@ -13,28 +13,28 @@ switch ($section) { case 'admin/help#block': return t(' -Blocks are the boxes visible in the sidebar(s) of your web site. These are usually generated automatically by modules (e.g. recent forum topics), but you can also create your own blocks.
-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.
-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.
-A block\'s visibility depends on:
-An administrator defined block contains content supplied by you (as opposed to being generated automatically by a module). 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.
'); - case 'admin/modules#description': - return t('Controls the boxes that are displayed around the main content.'); - case 'admin/block': - return t(" -Blocks are the 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 side of the page they will show up on (sidebar) and in which order they appear (weight).
-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'))); +Blocks are the boxes of related/grouped data that are visible in the sidebar(s) of your web site. These are usually generated automatically by modules (e.g. recent forum topics), but administrators can also create their own defined blocks.
+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.
+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.
+A block\'s visibility depends on:
+Module blocks are available when modules are enabled. These blocks can be administered in block administration.
+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.
+You can
+For more information, read the configuration and customization handbook block page.
+ ',array('%administerblock' => url('admin/block'),'%addblock' => url('admin/block/add'))); 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'))); } Index: modules/blog.module =================================================================== RCS file: /cvs/drupal/drupal/modules/blog.module,v retrieving revision 1.213.2.2 diff -u -r1.213.2.2 blog.module --- modules/blog.module 31 May 2005 21:13:38 -0000 1.213.2.2 +++ modules/blog.module 30 Jun 2005 15:01:22 -0000 @@ -52,11 +52,21 @@ function blog_help($section) { switch ($section) { case 'admin/help#blog': - return t(" -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.
-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/')); + return 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.
+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.
+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.
+You can
++
For more information, read the configuration and customization handbook blog page.
+ ',array('%userprofile' => url('user'),'%postablog' => url('node/add/blog'),'%administerblog' => url('admin/node/configure/types/blog'),'%administerblogapi' => url('admin/settings/blogapi'),'%blockconfigurationpage' => url('admin/block'))); case 'admin/modules#description': return t('Enables keeping an easily and regularly updated web page or a blog.'); case 'node/add#blog': Index: modules/blogapi.module =================================================================== RCS file: /cvs/drupal/drupal/modules/blogapi.module,v retrieving revision 1.39.2.5 diff -u -r1.39.2.5 blogapi.module --- modules/blogapi.module 6 Jun 2005 19:01:31 -0000 1.39.2.5 +++ modules/blogapi.module 30 Jun 2005 16:51:23 -0000 @@ -12,7 +12,17 @@ function blogapi_help($section) { switch ($section) { case 'admin/help#blogapi': - return t('This module adds support for several XML-RPC based blogging APIs. Specifically, it currently implements the %bloggerAPI, %metaweblogAPI, and most of the %moveabletype extensions. This allows users to contribute to Drupal using external GUI applications, which can often offer richer functionality that online forms based editing.
This module also allows site administrators to configure which node 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 node type as a separate "blog".
', array('%bloggerAPI' => 'Blogger API', '%metaweblogAPI' => 'MetaWeblog API', '%moveabletype' => 'Movable Type API. ')); + return 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.
+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.
+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".
+You can
+For more information, read the configuration and customization handbook blogapi page.
+ ',array('%administerblogapi' => url('admin/settings/blogapi'), '%xmlrpc' => 'xmlrpc.php')); case 'admin/modules#description': return t('Allows users to post content using applications that support XML-RPC blog APIs.'); } Index: modules/book.module =================================================================== RCS file: /cvs/drupal/drupal/modules/book.module,v retrieving revision 1.288.2.7 diff -u -r1.288.2.7 book.module --- modules/book.module 22 Jun 2005 20:24:35 -0000 1.288.2.7 +++ modules/book.module 30 Jun 2005 17:00:47 -0000 @@ -796,17 +796,21 @@ function book_help($section) { switch ($section) { case 'admin/help#book': - return t(" -The book organises content into a nested hierarchical structure. It is particularly good for manuals, Frequently Asked Questions (FAQs) and the like, allowing you to have chapters, sections, etc.
-A book is simply a collection of nodes that have been linked together. These nodes are usually of type book page, but you can insert nodes of any type into a book outline. Every node in the book has a parent node which \"contains\" it. This is how book.module establishes its hierarchy. At any given level in the hierarchy, a book can contain many nodes. All these sibling nodes are sorted according to the weight that you give them.
-Book pages contain a log message field which helps your users understand the motivation behind an edit of a book page. Each edited version of a book page is stored as a new revision of a node. This capability makes it easy to revert to an old version of a page, should that be desirable.
-Like other node types, book submissions and edits may be subject to moderation, depending on your configuration. Similarly, books use permissions to determine who may read and write to them. Only administrators are allowed to create new books, which are really just nodes whose parent is <top-level>. To include an existing node in your book, click on the \"outline\"-tab on the node's page. This enables you to place the node wherever you'd like within the book hierarchy. To add a new node into your book, use the create content » book page link.
-Administrators may review the hierarchy of their books by clicking on the collaborative book link in the administration pages. There, nodes may be edited, reorganized, removed from book, and deleted. This behavior may change in the future. When a parent node is deleted, it may leave behind child nodes. These nodes are now orphans. Administrators should periodically review their books for orphans and reaffiliate those pages as desired. Finally, administrators may also export their books to a single, flat HTML page which is suitable for printing.
-Collaborative books let you easily set up a Frequently Asked Questions (FAQ) section on your web site. The main benefit is that you don't have to write all the questions/answers by yourself - let the community do it for you!
-In order to set up the FAQ, you have to create a new book which will hold all your content. To do so, click on the create content » book page link. Give it a thoughtful title, and body. A title like \"Estonia Travel - FAQ\" is nice. You may always edit these fields later. You will probably want to designate <top-level> as the parent of this page. Leave the log message and type fields blank for now. After you have submitted this book page, you are ready to begin filling up your book with questions that are frequently asked.
-Whenever you come across a post which you want to include in your FAQ, click on the administer link. Then click on the edit book outline button at the bottom of the page. Then place the relevant post wherever is most appropriate in your book by selecting a parent. Books are quite flexible. They can have sections like Flying to Estonia, Eating in Estonia and so on. As you get more experienced with the book module, you can reorganize posts in your book so that it stays organized.
-Notes:
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.
+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.
+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. They can choose to export the page and its subsections as DocBook XML (for offline editing, or production of print or other electronic publication formats), or as an outline (titles only), by selecting the "export DocBook XML" and "export OPML" links respectively. DocBook export currently treats node content as preformatted text.
+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.
+You can
+For more information, read the configuration and customization handbook book page.
+ ',array('%blockadministration' => url('admin/block'),'%admin/node/book' => url('node/add/book'),'%bookpagecontenttype' => url('admin/node/configure/types/book'),'%administerblock' => url('admin/block'),'%accesspermissions' => url('admin/access'),'%adminnodebook' => url('admin/node/book'))); case 'admin/modules#description': return t('Allows users to collaboratively author a book.'); case 'admin/node/book': Index: modules/comment.module =================================================================== RCS file: /cvs/drupal/drupal/modules/comment.module,v retrieving revision 1.347.2.5 diff -u -r1.347.2.5 comment.module --- modules/comment.module 29 Jun 2005 19:53:35 -0000 1.347.2.5 +++ modules/comment.module 30 Jun 2005 15:17:40 -0000 @@ -16,48 +16,17 @@ function comment_help($section = "admin/help#comment") { switch ($section) { case 'admin/help#comment': - return t(" -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, story, collaborative book page, etc. 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. Additional settings include:
-When a user chooses save settings, the comments are then redisplayed using the user's new choices. Administrators can set the default settings for the comment control panel, along with other comment defaults, in administer » comments » configure. NOTE: When comment moderation is enabled, users will have another control panel option to control thresholds (see below).
- -Comments behave like other user submissions in Drupal. Filters, smileys and HTML that work in nodes will also work with comments. Administrators can control access to various comment module functions through administer » access control » permissions. Know that in a new Drupal installation, all comment permissions are disabled by default. The choice of which permissions to grant to which roles (groups of users) is left up to the site administrator. The following permissions:
-Drupal provides specific features to inform site members when new comments have been posted.
-Drupal displays the total number of comments attached to each node, and tracks comments read by individual site members. Members which have logged in will see a notice accompanying nodes which contain comments they have not read. Some administrators may want to download, install and configure the notify module. Users can then request that Drupal send them an e-mail when new comments are posted (the notify module requires that cron.php be configured properly).
-The tracker module, disabled by default, displays all the site's recent posts. There is a link to the recent posts page in the navigation block. This page is a useful way to browse new or updated nodes and comments. Content which the user has not yet read is tagged with a red star (this graphic depends on the current theme). Visit the comment board for any node, and Drupal will display a red \"new\" label beside the text of unread comments.
- -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 » configure must be configured.
- -The first step is to create moderation labels which allow users to rate a comment. Go to administer » comments » configure » moderation votes. In the vote field, enter the textual labels which users will see when casting their votes. Some examples are
-So that users know how their votes affect the comment, these examples include the vote value as part of the label, although that is optional. 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.
- -Next go to administer » comments » configure » 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.
- -In administer » comments » configure » 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.
- -Finally, you may want to enter some initial comment scores. In administer » comments » configure » moderation roles 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/comment/configure'), '%permissions' => url('admin/access/permissions'), '%tracker' => url('tracker'), '%download-notify' => 'http://drupal.org/project/releases', '%comment-votes' => url('admin/comment/configure/votes'), '%comment-matrix' => url('admin/comment/configure/matrix'), '%comment-thresholds' => url('admin/comment/configure/thresholds'), '%slashdot' => ' http://slashdot.org', '%comment-initial' => url('admin/comment/configure/roles'))); + return 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.
+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. On sites with active commenting from users, the administrator can turn over comment moderation to the community.
+You can
++
For more information, read the configuration and customization handbook comment page.
+ ',array('%accesspermissions' => url('admin/access'),'%administercomments' => url('admin/comment/configure'))); 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.
"); Index: modules/contact.module =================================================================== RCS file: /cvs/drupal/drupal/modules/contact.module,v retrieving revision 1.6.2.1 diff -u -r1.6.2.1 contact.module --- modules/contact.module 11 Apr 2005 11:06:13 -0000 1.6.2.1 +++ modules/contact.module 30 Jun 2005 15:19:16 -0000 @@ -14,6 +14,17 @@ */ function contact_help($section) { switch ($section) { + case 'admin/help#contact': + return t(' +The contact module allows other users to contact you by e-mail via your personal contact form. Users can send a subject and message in the contact form. The contact module is important in helping make connections among members of your community.
+Users can administer the contact settings in their account settings. Note that a users e-mail address is not made public and that privileged users such as site administrators are able to contact you even if you choose not to enable this feature. If users activate the personal contact form, then a contact tab will appear in their user profile.
+You can
+For more information, read the configuration and customization handbook contact page.
+ ',array('%profiles' => url('profiles'),'%administerusers' => url('admin/user'))); case 'admin/modules#description': return t('Enables the use of personal contact forms.'); } Index: modules/drupal.module =================================================================== RCS file: /cvs/drupal/drupal/modules/drupal.module,v retrieving revision 1.100.2.1 diff -u -r1.100.2.1 drupal.module --- modules/drupal.module 18 May 2005 21:13:52 -0000 1.100.2.1 +++ modules/drupal.module 30 Jun 2005 17:04:40 -0000 @@ -12,12 +12,25 @@ function drupal_help($section) { switch ($section) { case 'admin/help#drupal': - return t(" -The \"Drupal\" module features a capability whereby other drupal sites may call home to report their existence. In turn, this enables a pod of Drupal sites to find, cooperate and advertise each other.
-Currently, the main application of this feature is the Drupal sites page. By default, fresh Drupal installations can use drupal.org as their directory server and report their existence. This reporting occurs via scheduled XML-RPC pings.
-Drupal administrators should simply enable this feature to get listed on the Drupal sites page. Just set your site's name, e-mail address, slogan and mission statement on the administer » settings page. Then make sure that the field called Drupal XML-RPC server on the administer » settings » drupal page is set to %drupal-xml-rpc, and enable this feature using the dropdown directly below.
-The listing of your site will occur shortly after your site's next cron run. Note that cron.php should be called using the domain name which you want to have listed at drupal.org. For example, don't kick off cron by requesting http://127.0.0.1/cron.php. Instead, use a publicly accessible domain name such as http://www.example.com/cron.php.
-Also note that your installation need not use drupal.org as its directory server. For example, this feature is perfectly capable of aggregating pings from all of your departmental drupal installations sites within an enterprise.
", array('%drupal-sites' => 'http://www.drupal.org/drupal-sites', '%Drupal' => 'http://www.drupal.org', '%drupal-xml-rpc' => 'http://www.drupal.org/xmlrpc.php', '%xml-rpc' => 'http://www.xmlrpc.com/', '%site-settings' => url('admin/settings'), '%drupal-settings' => url('admin/settings/drupal'))); + return t(' +The Drupal module uses the XML-RPC network communication protocol to connect your site with a directory server that maintains a directory of sites. Community leaders who have common interests may wish to be part of a larger community and showing sites in a common directory is a good way to do this.
+Enabling this module will:
+The Drupal module administration page allows you to set the xml-rpc server page. The listing of your site in a site directory will occur shortly after your sites next cron run.
+You can
++
For more information, read the configuration and customization handbook drupal page.
+ ',array('%administerDrupal' => url('admin/settings/drupal'))); case 'admin/modules#description': return t('Lets users log in using a Drupal ID and can notify a central server about your site.'); case 'admin/settings/drupal': Index: modules/filter.module =================================================================== RCS file: /cvs/drupal/drupal/modules/filter.module,v retrieving revision 1.57.2.6 diff -u -r1.57.2.6 filter.module --- modules/filter.module 29 Jun 2005 19:53:35 -0000 1.57.2.6 +++ modules/filter.module 30 Jun 2005 16:38:02 -0000 @@ -22,6 +22,17 @@ */ function filter_help($section) { switch ($section) { + case 'admin/help#filter': + return t(' +The filter module allows administrators to configure text input formats for the site. For example, an administrator may want a filter to strip out malicious HTML from user\'s comments. Administrators may also want to make URLs linkable even if they are only entered in an unlinked format.
+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 and have its position rearranged.
+You can
+For more information, read the configuration and customization handbook filter page.
+ ',array('%administerfilter' => url('admin/filter'),'%administerfitler' => url('admin/filter'))); case 'admin/modules#description': return t('Handles the filtering of content in preparation for display.'); Index: modules/forum.module =================================================================== RCS file: /cvs/drupal/drupal/modules/forum.module,v retrieving revision 1.243.2.10 diff -u -r1.243.2.10 forum.module --- modules/forum.module 19 Jun 2005 08:44:25 -0000 1.243.2.10 +++ modules/forum.module 30 Jun 2005 15:24:04 -0000 @@ -11,6 +11,17 @@ */ function forum_help($section) { switch ($section) { + case 'admin/help#forum': + return 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.
+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.
+You can
++
For more information, read the configuration and customization handbook forum page.
+ ',array('%administerforum' => url('admin/forum'))); 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': Index: modules/help.module =================================================================== RCS file: /cvs/drupal/drupal/modules/help.module,v retrieving revision 1.45 diff -u -r1.45 help.module --- modules/help.module 1 Apr 2005 15:55:00 -0000 1.45 +++ modules/help.module 30 Jun 2005 16:38:24 -0000 @@ -84,6 +84,23 @@ */ function help_help($section) { switch ($section) { + case 'admin/help#help': + return 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.
+Modules can make documentation available to other modules with this module. All user help should be presented using this module. Some examples of help:
+You can
+For more information, read the configuration and customization handbook help page.
+ '); case 'admin/modules#description': return t('Manages the display of online help.'); } Index: modules/legacy.module =================================================================== RCS file: /cvs/drupal/drupal/modules/legacy.module,v retrieving revision 1.5 diff -u -r1.5 legacy.module --- modules/legacy.module 12 Feb 2005 09:23:06 -0000 1.5 +++ modules/legacy.module 30 Jun 2005 15:27:37 -0000 @@ -11,6 +11,22 @@ */ function legacy_help($section) { switch ($section) { + case 'admin/help#legacy': + return 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.
+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).
+Example Mappings:
+Legacy module has no configurable options.
+For more information, read the configuration and customization handbook legacy page.
+ '); case 'admin/modules#description': return t('Provides legacy handlers for upgrades from older Drupal installations.'); } Index: modules/locale.module =================================================================== RCS file: /cvs/drupal/drupal/modules/locale.module,v retrieving revision 1.120.2.1 diff -u -r1.120.2.1 locale.module --- modules/locale.module 3 May 2005 05:22:41 -0000 1.120.2.1 +++ modules/locale.module 30 Jun 2005 16:45:19 -0000 @@ -18,6 +18,20 @@ */ function locale_help($section = "admin/help#locale") { switch ($section) { + case 'admin/help#locale': + return 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.
+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 http://drupal.org.
+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.
+You can
++
For more information, read the configuration and customization handbook locale page.
+ ',array('%administerlocale' => url('admin/locale'),'%administerlocalestrings' => url('admin/locale/string/search'),'%addlocalelanguage' => url('admin/locale/language/add'))); case 'admin/modules#description': return t('Enables the translation of the user interface to languages other than English.'); case 'admin/locale': @@ -31,14 +45,6 @@ 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 is to generate a translation template, which contains all Drupal strings, but without their translations. You can use this template to start a new translation using a specialized desktop application.
"); case 'admin/locale/string/search': return t("It is often more convenient to get the strings of your setup on the export page, and start with a desktop Gettext translation editor though. Here you can search in the translated and untranslated strings, and the default English texts provided by Drupal.
", array("%export" => url("admin/locale/language/export"))); - - case 'admin/help#locale': - return t(" -Most programs are written and documented in English, and primarily use English to interact with users. This is also true for a great deal of web sites. However, most people are less comfortable with English than with their native language, and would prefer to use their mother tongue as much as possible. Many people love to see their web site showing a lot less English, and far more of their own language. Therefore Drupal provides a framework to setup a multi-lingual web site, or to overwrite the default English texts.
-Whenever Drupal encounters an interface string 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.
-Drupal provides two options to translate these strings. First is the integrated web interface, where you can search for untranslated strings, and specify their translations via simple web forms. An easier, and much less time consuming method is to import translations already done for your language. This is achieved by the use of GNU gettext Portable Object files. These are editable with quite convenient desktop editors specifically architected for supporting your work with GNU Gettext files. The import feature allows you to add strings from such files into the site database. The export functionality enables you to share your translations with others, generating Portable Object files from your site strings."); - break; } } Index: modules/menu.module =================================================================== RCS file: /cvs/drupal/drupal/modules/menu.module,v retrieving revision 1.29 diff -u -r1.29 menu.module --- modules/menu.module 31 Mar 2005 21:18:08 -0000 1.29 +++ modules/menu.module 30 Jun 2005 15:32:08 -0000 @@ -57,6 +57,25 @@ */ function menu_help($section) { switch ($section) { + case 'admin/help#menu': + return t(' +
The menu module allows for customization of the menus. Menus are useful for providing navigation in your site. The main menu for navigation is the navigation menu. Menus appear in blocks on your site.
++
You can
+For more information, read the configuration and customization handbook menu page.
+ ',array('%administermenu' => url('admin/menus'),'%administerblock' => url('admin/block'),'%addmenu' => url('admin/menu/menu/add'),'%addmenuitem' => url('admin/menu/item/add'))); case 'admin/modules#description': return t('Allows administrators to customize the site navigation menu.'); case 'admin/menu': Index: modules/node.module =================================================================== RCS file: /cvs/drupal/drupal/modules/node.module,v retrieving revision 1.485.2.9 diff -u -r1.485.2.9 node.module --- modules/node.module 29 Jun 2005 19:53:35 -0000 1.485.2.9 +++ modules/node.module 30 Jun 2005 15:33:29 -0000 @@ -14,31 +14,22 @@ function node_help($section) { switch ($section) { case 'admin/help#node': - $output = t(" -The core of the Drupal system is the node. All of the contents of the system are placed in nodes, or extensions of nodes. - A base node contains:
Now that you know what is in a node, here are some of the types of nodes available.
", array("%teaser" => url("admin/node/configure/settings"))); - - foreach (node_list() as $type) { - $output .= 'The node module manages the basic Drupal content type: the node or "post." All content on your site is stored in nodes or extensions of nodes such as blogs, stories, polls, forums, etc. (Note: comments are not stored as nodes but are always associated with a node). Having content as a node is an important aspect of making a content management system that can use new types of content and apply features to all content.
+Node module features
+You can
+For more information, read the configuration and customization handbook node page.
+ ',array('%search' => url('search'),'%administercontent' => url('admin/node/configure/types'))); case 'admin/modules#description': return t('Allows content to be submitted to the site and displayed on pages.'); case 'admin/node/configure': Index: modules/page.module =================================================================== RCS file: /cvs/drupal/drupal/modules/page.module,v retrieving revision 1.132 diff -u -r1.132 page.module --- modules/page.module 8 Feb 2005 19:44:39 -0000 1.132 +++ modules/page.module 30 Jun 2005 17:09:41 -0000 @@ -11,6 +11,20 @@ */ function page_help($section) { switch ($section) { + case 'admin/help#page': + return 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.
+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).
+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.
+If the location module is enabled, then location specific information can be added. If the trackback module is enabled trackbacks can be configured.
+You can
+For more information, read the configuration and customization handbook page page.
+ ',array('%nodeadministrationhelp' => url('admin/help/node'),'%pageadministrationhelp' => url('admin/help/node'),'%addpage' => url('node/add/page'),'%configpage' => url('admin/node/configure/types/page'))); case 'admin/modules#description': return t('Enables the creation of pages that can be added to the navigation system.'); case 'node/add#page': Index: modules/path.module =================================================================== RCS file: /cvs/drupal/drupal/modules/path.module,v retrieving revision 1.56.2.1 diff -u -r1.56.2.1 path.module --- modules/path.module 19 Jun 2005 19:28:08 -0000 1.56.2.1 +++ modules/path.module 30 Jun 2005 15:37:09 -0000 @@ -11,6 +11,25 @@ */ function path_help($section) { switch ($section) { + case 'admin/help#path': + return 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.
+Some examples of URL aliases are:
+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".
+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.
+You can
+For more information, read the configuration and customization handbook path page.
+ ',array('%addalias' => url('admin/path/add'),'%administerURLalias' => url('admin/path'))); case 'admin/modules#description': return t('Allows users to rename URLs.'); case 'admin/path': Index: modules/ping.module =================================================================== RCS file: /cvs/drupal/drupal/modules/ping.module,v retrieving revision 1.29 diff -u -r1.29 ping.module --- modules/ping.module 1 Apr 2005 15:55:00 -0000 1.29 +++ modules/ping.module 30 Jun 2005 15:38:38 -0000 @@ -12,17 +12,15 @@ function ping_help($section) { switch ($section) { case 'admin/help#ping': - $output .= t(" -Drupal can automatically send notifications (called \"pings\") to the %pingomatic to tell them that your site has changed. In turn pingomatic.com will ping other services like weblogs.com, Technorati, blo.gs, BlogRolling, Feedster.com, Moreover, etc.
-The ping feature requires crontab.
", array('%pingomatic' => 'http://pingomatic.com/')); - break; - + return 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.
+The ping module requires cron or a similar periodic job scheduler to be enabled.
You can enable or disable the ping module at administer >> modules.
+For more information, read the configuration and customization handbook ping page.
+ ',array('%adminstermodules' => url('admin/modules'))); case 'admin/modules#description': - $output = t('Alerts other sites when your site has been updated.'); - break; + return t('Alerts other sites when your site has been updated.'); } - - return $output; } /** Index: modules/poll.module =================================================================== RCS file: /cvs/drupal/drupal/modules/poll.module,v retrieving revision 1.162.2.1 diff -u -r1.162.2.1 poll.module --- modules/poll.module 31 May 2005 21:13:39 -0000 1.162.2.1 +++ modules/poll.module 30 Jun 2005 18:44:18 -0000 @@ -13,15 +13,16 @@ function poll_help($section) { switch ($section) { case 'admin/help#poll': - return t(" -Users with the correct permissions can create and/or vote on polls.
+ return 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.
+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.
+You can
Creating a poll is much like creating any other node. Click \"create poll\" in your user box. 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 links 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("%permissions" => url("admin/access/permissions"), "%poll" => url("poll"))); +For more information, read the configuration and customization handbook poll page.
+ ',array('%polls' => url('poll'),'%pollspage' => url('admin/node/configure/types/poll'))); 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': Index: modules/profile.module =================================================================== RCS file: /cvs/drupal/drupal/modules/profile.module,v retrieving revision 1.90.2.2 diff -u -r1.90.2.2 profile.module --- modules/profile.module 1 Jun 2005 04:30:07 -0000 1.90.2.2 +++ modules/profile.module 30 Jun 2005 15:46:30 -0000 @@ -18,6 +18,26 @@ */ function profile_help($section) { switch ($section) { + case 'admin/help#profile': + return 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.
+The following types of fields can be added to the user profile:
+You can
+For more information, read the configuration and customization handbook profile page.
+ ',array('%userprofile' => url('profile'), '%adminprofiles' => url('admin/settings/profile'))); case 'admin/modules#description': return t('Supports configurable user profiles.'); case 'admin/settings/profile': Index: modules/search.module =================================================================== RCS file: /cvs/drupal/drupal/modules/search.module,v retrieving revision 1.123.2.2 diff -u -r1.123.2.2 search.module --- modules/search.module 23 Apr 2005 07:34:42 -0000 1.123.2.2 +++ modules/search.module 30 Jun 2005 21:06:43 -0000 @@ -47,6 +47,18 @@ */ function search_help($section = 'admin/help#search') { switch ($section) { + case 'admin/help#search': + return 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.
+The search engine works by maintaining an index of the words in your site\'s content. 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.
+You can
+For more information, read the configuration and customization handbook search page.
+ ',array('%Systemmodulehelp' => url('admin/help/system'),'%administersearch' => url('admin/settings/search'))); case 'admin/modules#description': return t('Enables site-wide keyword searching.'); case 'admin/settings/search': Index: modules/statistics.module =================================================================== RCS file: /cvs/drupal/drupal/modules/statistics.module,v retrieving revision 1.186.2.5 diff -u -r1.186.2.5 statistics.module --- modules/statistics.module 31 May 2005 21:13:39 -0000 1.186.2.5 +++ modules/statistics.module 30 Jun 2005 16:46:58 -0000 @@ -12,33 +12,35 @@ function statistics_help($section) { switch ($section) { case 'admin/help#statistics': - return t(" -The statistics module keeps track of numerous statistics for your site but be warned, statistical collection does cause a little overhead, thus everything comes disabled by default.
-The module counts how many times, and from where -- using HTTP referrer -- each of your posts is viewed. Once we have that count the module can do the following with it: + return t(' +
The statistics module keeps track of numerous statistics of site usage. It counts how many times, and from where each of your posts is viewed. The statistics module can be used to learn many useful things about how users are interacting with each other and your site.
+Statistics module features
Notes on using the statistics:
+Configuring the statistics module
As with any new module, the statistics module needs to be enabled before you can use it. Also refer to the permissions section, as this module supports four separate permissions.
-There are some configuration options added to the main administer » settings » statistics section:
+You can
This module creates a block that can display the day's top viewed content, the all time top viewed content, and the last content viewed. Each of these links can be enabled or disabled individually, and the number of posts displayed for each can be configured with a drop down menu. If you disable all sections of this block, it will not appear.
-Don't forget to enable the block.
", - array('%modules' => url('admin/modules'), '%permissions' => url('admin/access/permissions'), '%referer' => url('admin/logs/referrers'), '%configuration' => url('admin/settings/statistics'), '%block' => url('admin/block'))); ++
For more information, read the configuration and customization handbook statistics page.
+ ',array('%stats' => url('admin/settings/statistics'),'%hits' => url('admin/logs/hits'),'%adminblocks' => url('admin/block'),'%adminlogs' => url('admin/logs'))); case 'admin/modules#description': return t('Logs access statistics for your site.'); case 'admin/settings/statistics': Index: modules/story.module =================================================================== RCS file: /cvs/drupal/drupal/modules/story.module,v retrieving revision 1.167 diff -u -r1.167 story.module --- modules/story.module 1 Apr 2005 15:55:01 -0000 1.167 +++ modules/story.module 30 Jun 2005 15:55:25 -0000 @@ -11,6 +11,17 @@ */ function story_help($section) { switch ($section) { + case 'admin/help#story': + return 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.
+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.
+You can
+For more information, read the configuration and customization handbook story page.
+ ',array('%postastory' => url('node/add/story'),'%configurestory' => url('admin/node/configure/types'))); case 'admin/modules#description': return t('Allows users to submit stories, articles or similar content.'); case 'node/add#story': Index: modules/system.module =================================================================== RCS file: /cvs/drupal/drupal/modules/system.module,v retrieving revision 1.204.2.3 diff -u -r1.204.2.3 system.module --- modules/system.module 1 Jun 2005 04:17:17 -0000 1.204.2.3 +++ modules/system.module 30 Jun 2005 21:07:34 -0000 @@ -27,17 +27,18 @@ case 'admin/modules': return t('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'))); case 'admin/help#system': - return t(" -Drupal comes with system-wide defaults but the setting-module provides control over many Drupal preferences, behaviours including visual and operational settings.
-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). 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.
-The recommended way to set up your cron system is to set up a Unix/Linux crontab entry (see \"man crontab\") that frequently visits %cron-link. Note that cron does not guarantee the commands will be executed at the specified interval. However, Drupal will try its best to run the tasks as close to the specified intervals as possible. The more you visit cron.php, the more accurate cron will be.
-If your hosting company does not allow you to set up crontab entries, you can always ask someone else to set up an entry for you. After all, virtually any Unix/Linux machine with access to the internet can set up a crontab entry to frequently visit %cron-link.
-For the Unix/Linux crontab itself, use a browser like lynx or wget but make sure the process terminates: either use /usr/bin/lynx -source %base_url/cron.php or /usr/bin/wget -o /dev/null -O /dev/null %cron-link. Take a look at the example scripts in the scripts-directory. Make sure to adjust them to fit your needs. A good crontab line to run the cron script once every hour would be:
-
00 * * * * /home/www/drupal/scripts/cron-lynx.sh- Note that it is essential to access
cron.php using a browser on the web site's domain; do not run it using command line PHP and avoid using localhost or 127.0.0.1 or some of the environment variables will not be set correctly and features may not work as expected.
- 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 cached pages compressed.
", array('%base_url' => $base_url, '%cron-link' => "$base_url/cron.php", '%lynx' => 'http://lynx.browser.org', '%wget' => 'http://www.gnu.org/software/wget/wget.html' )); + return 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.
+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). 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.
+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.
+You can
++
For more information, read the configuration and customization handbook system page.
+ ',array('%adminsettings' => url('admin/settings'))); case 'admin/modules#description': return t('Handles general site configuration for administrators.'); } Index: modules/taxonomy.module =================================================================== RCS file: /cvs/drupal/drupal/modules/taxonomy.module,v retrieving revision 1.192.2.5 diff -u -r1.192.2.5 taxonomy.module --- modules/taxonomy.module 31 May 2005 21:13:40 -0000 1.192.2.5 +++ modules/taxonomy.module 30 Jun 2005 16:39:43 -0000 @@ -1058,38 +1058,16 @@ 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.
"); case 'admin/help#taxonomy': return t(' -Taxonomy is the study of classification. Drupal\'s taxonomy module allows you to define vocabularies which are used to classify content. The module supports hierarchical classification and association between terms, allowing for truly flexible information retrieval and classification. For more details about classification types and insight into the development of the taxonomy module, see this drupal.org discussion.
-Notes
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\'s sections. For more complex implementations, you might create a hierarchical list of categories such as Food taxonomy shown above.
-When setting up a controlled vocabulary, if you select the hierarchy option, you will be defining a tree structure of terms, as in a thesaurus. If you select the related terms option, you are allowing the definition of related terms (think see also), as in a thesaurus. Selecting multiple select will allow you to describe a piece of content using more than one term. That content will then appear on each term\'s page, increasing the chance that a user will find it.
-When setting up a controlled vocabulary you are asked for:
Once done defining the vocabulary, you have to add terms to it to make it useful. The options you see when adding a term to a vocabulary will depend on what you selected for related terms, hierarchy and multiple select. These options are:
-In order to view the content associated with a term or a collection of terms, you should browse to a properly formed Taxonomy URL. For example, taxonomy/term/1+2. Taxonomy URLs always contain one or more term IDs at the end of the URL. You may learn the term ID for a given term by hovering over that term in the taxonomy overview page and noting the number at the end or the URL. To build a Taxonomy URL start with "taxonomy/term/". Then list the term IDs, separated by "+" to choose content tagged with any of the given term IDs, or separated by "," to choose content tagged with all of the given term IDs. In other words, "+" is less specific than ",". Finally, you may optionally specify a "depth" in the vocabulary hierarchy. This defaults to "0", which means only the explicitly listed terms are searched. A positive number indicates the number of additional levels of the tree to search. You may also use the value "all", which means that all descendant terms are searched.
-Every term, or collection of terms, provides an RSS feed to which interested users may subscribe. The URL format for a sample RSS feed is taxonomy/term/1+2/0/feed. These are built just like Taxonomy URLs, but are followed by the word "feed".
', array('%classification-types' => 'http://www.eleganthack.com/archives/002165.html', '%drupal-dis' => 'http://drupal.org/node/55', '%slashdot' => 'http://slashdot.com/', '%taxo-example' => url('taxonomy/term/1+2'), '%taxo-overview' => url('admin/taxonomy'), '%userland-rss' => 'http://backend.userland.com/stories/rss', '%sample-rss' => url('taxonomy/term/1+2/feed'), '%taxo-help' => url('admin/help/taxonomy', NULL, 'taxonomy-url'))); +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.
+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 delete a term choose "edit term." To delete a vocabulary, and all its terms, choose "edit vocabulary."
+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.
+You can
+ +For more information, read the configuration and customization handbook taxonomy page.
+ ',array('%addavocabulary' => url('admin/taxonomy/add/vocabulary'),'%administertaxonomy' => url('admin/taxonomy'))); } } Index: modules/throttle.module =================================================================== RCS file: /cvs/drupal/drupal/modules/throttle.module,v retrieving revision 1.48.2.2 diff -u -r1.48.2.2 throttle.module --- modules/throttle.module 1 Jun 2005 19:40:01 -0000 1.48.2.2 +++ modules/throttle.module 30 Jun 2005 16:01:19 -0000 @@ -108,6 +108,18 @@ */ function throttle_help($section) { switch ($section) { + case 'admin/help#throttle': + return 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).
+The congestion control throttle can be automatically enabled when the number of anonymous users currently visiting the site exceeds the specified threshold. The congestion control throttle can be automatically enabled when the number of authenticated users currently visiting the site exceeds the specified threshold.
+You can
+For more information, read the configuration and customization handbook throttle page.
+ ',array('%administermodules' => url('admin/modules'),'%administerblock' => url('admin/block'),'%administerthrottle' => url('admin/settings/throttle'))); case 'admin/modules#description': return t('Handles the auto-throttling mechanism, to control site congestion.'); case 'admin/settings/throttle': Index: modules/tracker.module =================================================================== RCS file: /cvs/drupal/drupal/modules/tracker.module,v retrieving revision 1.114.2.1 diff -u -r1.114.2.1 tracker.module --- modules/tracker.module 14 May 2005 17:13:30 -0000 1.114.2.1 +++ modules/tracker.module 30 Jun 2005 16:47:45 -0000 @@ -12,11 +12,17 @@ function tracker_help($section) { switch ($section) { case 'admin/help#tracker': - return t('The tracker module is a handy module for displaying the most recently added or updated content to a Drupal site. The link to the tracker is labeled recent posts in the user\'s navigation block. Updates include changes to the text by either the original author or someone else that has permission to edit the content, such as an editor or administrator as well as all comments added to an item.
-The Tracker module presents a page listing the recently-updated content written by the user with the content type, the title, the user\'s name, how many comments that item has received, as well as how long ago it was updated. If an item was written by someone else, tracker will show that item at the top of the list. An example:
-A user named Jessica writes a blog post, then some time passes, and others write blog posts. Then if John posts a comment to Jessica\'s post, and you have bookmarked John\'s tracker page (see below on how to do this) then Jessica\'s content will appear at the top.
-If an user with administer comments (e.g. an administrator or editor of a site) deletes a comment (e.g. it is off-topic, inappropriate language, or unsolicited advertisement), the content item will drop down to when it was updated previous to that deleted comment.
-To use the Tracker module to "watch" for a user\'s updated content, click on that user\'s profile, then the "track" tab.
'); + return 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.
+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.
+You can
+For more information, read the configuration and customization handbook tracker page.
+ ',array('%mostrecentposts' => url('tracker/'),'%userprofiles' => url('profile'))); case 'admin/modules#description': return t('Enables tracking of recent posts for users.'); } Index: modules/upload.module =================================================================== RCS file: /cvs/drupal/drupal/modules/upload.module,v retrieving revision 1.31.2.5 diff -u -r1.31.2.5 upload.module --- modules/upload.module 25 May 2005 04:28:59 -0000 1.31.2.5 +++ modules/upload.module 30 Jun 2005 21:12:11 -0000 @@ -11,6 +11,18 @@ */ function upload_help($section) { switch ($section) { + case 'admin/help#upload': + return 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.
+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.
+You can
+For more information, read the configuration and customization handbook upload page.
+ ',array('%administerusers' => url('admin/user/configure'),'%administersettings' => url('admin/node/configure'),'%adminsettings' => url('admin/settings/upload'))); case 'admin/modules#description': return t('Allows users to upload and attach files to content.'); case 'admin/settings/upload': Index: modules/user.module =================================================================== RCS file: /cvs/drupal/drupal/modules/user.module,v retrieving revision 1.454.2.13 diff -u -r1.454.2.13 user.module --- modules/user.module 1 Jun 2005 20:16:04 -0000 1.454.2.13 +++ modules/user.module 30 Jun 2005 16:40:19 -0000 @@ -1743,29 +1743,17 @@ return $output; case 'admin/help#user': - $output = t(" -Drupal offers a powerful access system that allows users to register, login, logout, maintain user profiles, etc. By using roles you can setup fine grained permissions allowing each role to do only what you want 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 \"authorized\" a user who has signed up and who has been authorized. As anonymous users, participants suffer numerous disadvantages, for example they cannot sign their names to nodes, and their moderated posts beginning at a lower score.
-In contrast, those with a user account can use their own name or handle and are granted various privileges: the most important is probably the ability to moderate new submissions, to rate comments, and to fine-tune the site to their personal liking, with saved personal settings. Drupal themes make fine tuning quite a pleasure.
-Registered users need to authenticate by supplying either a local username and password, or a remote username and password such as a Jabber ID, DelphiForums ID, or one from a Drupal powered website. See the distributed authentication help for more information on this innovative feature. - The local username and password, hashed with Message Digest 5 (MD5), are stored in your database. When you enter a password it is also hashed with MD5 and compared with what is in the database. If the hashes match, the username and password are correct. Once a user authenticated session is started, and until that session is over, the user won't have to re-authenticate. To keep track of the individual sessions, Drupal relies on PHP sessions. 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. When a visitor accesses your site, Drupal will check whether a specific session ID has been sent with the request. If this is the case, the prior saved environment is recreated.
-Each Drupal user has a profile, and a set of preferences which may be edited by clicking on the \"my account\" link. Of course, a user must be logged into reach those pages. There, users will find a page for changing their preferred time zone, language, username, e-mail address, password, theme, signature, and distributed authentication names. Changes made here take effect immediately. Also, administrators may make profile and preferences changes in account administration on behalf of their users.
- -One of the more tedious moments in visiting a new website is filling out the registration form. The reg form provides helpful information to the website owner, but not much value for the user. The value for the end user is usually the ability to post a messages or receive personalized news, etc. Distributed authentication (DA) gives the user what they want without having to fill out the reg form. Removing this obstacle yields more registered and active users for the website.
-DA enables a new user to input a username and password into the login box and immediately be recognized, even if that user never registered on your site. This works because Drupal knows how to communicate with external registration databases. For example, lets say that your new user 'Joe' is already a registered member of Delphi Forums. If your Drupal has the delphi module installed, then Drupal will inform Joe on the registration and login screens that he may login with his Delphi ID instead of registering with your Drupal instance. Joe likes that idea, and logs in with a username of joe@remote.delphiforums.com and his usual Delphi password. Drupal then communicates with remote.delphiforums.com (usually using XML, HTTP-POST, or SOAP) behind the scenes and asks "is this password for username=joe?" If Delphi replies yes, then Drupal will create a new local account for joe and log joe into it. Joe may keep on logging into your Drupal instance in the same manner, and he will be logged into the same joe@remote.delphiforums.com account.
-One key element of DA is the 'authmap' table, which maps a user's authname (e.g. joe@remote.delphiforums.com) to his local UID (i.e. user identification number). This map is checked whenever a user successfully logs into an external authentication source. Once Drupal knows that the current user is definitely joe@remote.delphiforums.com (because Delphi says so), he looks up Joe's UID and logs Joe into that account.
-To disable distributed authentication, simply disable or remove all DA modules. For a virgin install, that means removing/disabling the jabber module and the drupal module.
-Drupal is setup so that it is very easy to add support for any external authentication source. You currently have the following authentication modules installed ...
", array('%user-role' => url('admin/access/roles'), '%user-permission' => url('admin/access/permissions'), '%jabber' => 'http://www.jabber.org/', '%delphi-forums' => 'http://www.delphiforums.com/', '%drupal' => 'http://www.drupal.org/', '%da-auth' => url('admin/help/user#da'), '%php-sess' => 'http://www.php.net/manual/en/ref.session.php', '%admin-user' => url('admin/user'), '%xml' => 'http://www.xmlrpc.org/', '%http-post' => 'http://www.w3.org/Protocols/', '%soap' => 'http://www.soapware.org/', '%dis-module' => url('admin/modules'), '%user-prefs' => url('user/' . $user->uid))); - - foreach (module_list() as $module) { - if (module_hook($module, 'auth')) { - $output = strtr($output, array('%module-list' => '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.
+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 a Jabber ID, 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.
+You can
+For more information, read the configuration and customization handbook user page.
+ ',array('%administerprofile' => url('admin/help/profile'),'%administersystem' => url('admin/help/system'),'%administeruser' => url('admin/user'))); } } Index: modules/watchdog.module =================================================================== RCS file: /cvs/drupal/drupal/modules/watchdog.module,v retrieving revision 1.121 diff -u -r1.121 watchdog.module --- modules/watchdog.module 26 Jan 2005 23:02:44 -0000 1.121 +++ modules/watchdog.module 30 Jun 2005 16:05:40 -0000 @@ -17,6 +17,17 @@ */ function watchdog_help($section = 'admin/help#watchdog') { switch ($section) { + case 'admin/help#watchdog': + return 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.
+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.
+You can
+For more information, read the configuration and customization handbook watchdog page.
+ ',array('%administerwatchdog' => url('admin/watchdog'),'%administerwatchdogevents' => url('admin/watchdog/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.
'); case 'admin/modules#description': Index: sites/default/settings.php =================================================================== RCS file: /cvs/drupal/drupal/sites/default/settings.php,v retrieving revision 1.12.2.2 diff -u -r1.12.2.2 settings.php --- sites/default/settings.php 14 Apr 2005 18:35:19 -0000 1.12.2.2 +++ sites/default/settings.php 30 Jun 2005 16:14:48 -0000 @@ -78,7 +78,7 @@ * $db_url = 'mysql://username:password@localhost/database'; * $db_url = 'pgsql://username:password@localhost/database'; */ -$db_url = 'mysql://username:password@localhost/database'; +$db_url = 'mysql://root:@localhost/drupal2'; $db_prefix = ''; /** @@ -87,7 +87,7 @@ * The URL of your website's main page. It is not allowed to have * a trailing slash; Drupal will add it for you. */ -$base_url = 'http://localhost'; +$base_url = 'http://localhost/mydrupal/CSL/4-6-2-helptext'; /** * PHP settings: