- Bugfix: renamed "create PHP content" to "create php content". Reported
by Simon, patch by Gerhard. - Improvement: synchronized the import module help with the version on drupal.org.4.2.x
Dries Buytaert
parent
7bbd226f88
commit
1c38cd9099
|
|
@ -1,13 +1,54 @@
|
|||
<?php
|
||||
// $Id$
|
||||
|
||||
|
||||
function import_help() {
|
||||
$output .= "<p>**REWRITE** In Drupal you have <i>feeds</i> and <i>bundles</i>. Feeds define news sources and bundles categorize syndicated content by source, topic or any other heuristic. Bundles provide a generalized way of creating composite feeds. They allow you, for example, to combine various sport-related feeds into one bundle called \"Sport\".</p>";
|
||||
$output .= "<p>You can have several providers of news feeds. You can add a feed by clicking the \"add feed\" link on the import administration pages. Give the feed a name, supply the URI and a comma-separated list of attributes that you want to associate the feed with. The update interval defines how often Drupal should go out to try and grab fresh content. The expiration time defines how long syndicated content is kept in the database. So set the update and expiration time and save your settings. You have just defined your first feed. If you have more feeds repeat as necessary.</p>";
|
||||
$output .= "<p>To verify whether your feed works, press \"update items\" at the overview page. The number of news items that have been sucessfully fetched, should then become visible in the third column of the feed overview.</p>";
|
||||
$output .= "<p>Now you have to define some bundles. Bundles look for feeds that contain one of the keywords associated with the bundle and display those feeds together. To define a bundle you have to give it a name and a comma-separated list of keywords just like this is the case for feeds.</p>";
|
||||
$output .= "<p>Your newly created bundle will now show up in the list of blocks that you can see at the block related administration pages. There you can customize where and when your bundles will be displayed.</p>";
|
||||
return t($output);
|
||||
$output .= "<p>Thousands of web sites, especially news sites and weblogs, syndicate their most recent site content for others to display. The syndicated content always includes titles, also known as headlines, for the newest published stories. Each headline acts as a direct link to the stories on the remote site. Along with the headline, most sites typically provide either the first few paragraphs of the story or a short summary. Many individuals use client-based news aggregators on their personal computer to aggregate content, such as <a href=\"http://www.disobey.com/amphetadesk/\">AmphetaDesk</a>.</p>";
|
||||
|
||||
$output .= "<p>Drupal also has a news aggregator built in as a standard feature. With it, you can subscribe to feeds from other sites and display their content for your site users. Simply enable the import module in site administration and enter the feeds that you choose.</p>";
|
||||
$output .= "<h3>What do I need to subscribe to a feed?</h3>";
|
||||
$output .= "<p>The standard method of syndication is using the XML-based <a href=\"http://groups.yahoo.com/group/rss-dev/files/specification.html\">Rich Site Summary</a> (RSS). To syndicate a site's content, obtain the full URL of the RSS page providing syndication. Common file tags for RSS pages are .rss, .xml and .rdf. Example: <a href=\"http://slashdot.org/slashdot.rdf\">http://slashdot.org/slashdot.rdf</a>.</p>";
|
||||
$output .= "<p>Most weblog sites that offer syndication will have an obvious link on the main page. Often you need only look for an xml syndication button, such as the one Drupal uses for site syndication.</p>";
|
||||
$output .= "<p>But some sites do not make their RSS feeds as easy to find. Or maybe you want to find a number of feeds on a given topic, without extensively searching the web. In that case, try an RSS syndication directory such as <a href=\"http://www.syndic8.com/\">Syndic8</a>.</p>";
|
||||
$output .= "<p>To learn much more about RSS, read Mark Pilgrim's <a href=\"http://www.xml.com/pub/a/2002/12/18/dive-into-xml.html\">What is RSS</a> and WebReference.com's <a href=\"http://www.webreference.com/authoring/languages/xml/rss/1/\">The Evolution of RSS</a>.</p>";
|
||||
$output .= "<p>NOTE: Enable your site's xml syndication button by turning on the Syndicate block in block management.</p>";
|
||||
$output .= "<h3>Configuring news feeds</h3>";
|
||||
$output .= "<p>To subscribe to an RSS feed on another site, use the <i>administer news feeds</i> shortcut at the top of the news aggregation page. The link leads directly to the news aggregation configuration section of Drupal site administration.</p>";
|
||||
$output .= "<p>Once there, select <i>add new feed</i> from the left hand menu. Drupal will then ask for the following:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The text entered here will be used in your news aggregator, within the administration configuration section, and as title for the news feed block. As a general rule, use the web site name from which the feed originates.</li>";
|
||||
$output .= " <li><b>URL</b> -- Here you'll enter the fully-qualified URL for the feed for the site you want to subscribe to.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Attributes are keywords which can be used to collect feeds into <i>bundles</i> (see below). Think of these as the means of classifying your feeds. Separate multiple attributes with commas. If you do not plan on using the specific feed in a bundle, this input field can be left blank.</li>";
|
||||
$output .= " <li><b>Update interval</b> -- The update interval is how often Drupal will automatically access the RSS URL for the site for fresh content. The 1 hour default is typically the minimum you will want to use. Accessing another site's RSS page more frequently can be considered impolite. After all, it does require the other site's server to handle your automatic requests. To take advantage of this feature, note that cron.php must be configured to have your feeds updated regularly. Otherwise, you'll have to manually update feeds one at a time within the news aggregation administration section by using <i>update items</i>.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<p>Once you submit your new feed, check to see if it is working properly. Select <i>update items </i> on the main news 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.</p>";
|
||||
$output .= "<h3>Adding bundles</h3>";
|
||||
$output .= "<p>You may want to follow some feeds more closely than others. Or perhaps you'd like to display a select list of the titles for some feeds as a block for users. Bundles are a way of grouping your feeds into categories. Bundles look for feeds that contain at least one of the keywords, or attributes, associated with the bundle and display those feeds together.</p>";
|
||||
$output .= "<p>When adding a bundle, Drupal will ask for:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The title will be used in the <i>news by topics</i> listing in your news aggregator and with the customized block created for the bundle.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Enter one or more of the attributes used to categorize the news feeds already created. Separate multiple attributes with commas. Be careful to use the same spelling. Don't have any feeds with attributes for the bundle? After creating the bundle, edit existing feeds or create new ones and tag them with the attribute.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>Using the news aggregator</h3>";
|
||||
$output .= "<p>The news aggregator has a number of ways that it displays your subscribed content:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Latest news</b> -- Displays all incoming content in the order received with:";
|
||||
$output .= " <ul>";
|
||||
$output .= " <li>The title of the original post.</li>";
|
||||
$output .= " <li>The name of the source, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " <li>A description, the first few paragraphs or summary of the originating post (if any).</li>";
|
||||
$output .= " <li>A <i>blog it</i> link. Users can select this link to have Drupal automatically prepare a blog post for the specific item.</li>";
|
||||
$output .= " <li>A <i>feed</i> link, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " </ul>";
|
||||
$output .= " </li>";
|
||||
$output .= " <li><b>News by source -- </b>Organizes incoming content by feed, displaying titles which link to the originating post. Also has an icon which acts as blog it link.</li>";
|
||||
$output .= " <li><b>News by topic</b> -- Organizes incoming content by bundles, displaying titles which link to the originating post. Also has an icon which acts as
|
||||
blog it link.</li>";
|
||||
$output .= " <li><b>News sources</b> -- Displays an alphabetical listing of all subscribed feeds and a description. The title acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>RSS feed blocks</h3>";
|
||||
$output .= "<p>In addition to providing subscribed content through the news aggregator, Drupal automatically creates a block for each subscribed feed and every bundle created. Beside each headline in each block, Drupal includes an icon which acts a blog it link. Enable any or all of the blocks using block management.</p>";
|
||||
return $output;
|
||||
}
|
||||
|
||||
function import_system($field){
|
||||
|
|
|
|||
|
|
@ -1,13 +1,54 @@
|
|||
<?php
|
||||
// $Id$
|
||||
|
||||
|
||||
function import_help() {
|
||||
$output .= "<p>**REWRITE** In Drupal you have <i>feeds</i> and <i>bundles</i>. Feeds define news sources and bundles categorize syndicated content by source, topic or any other heuristic. Bundles provide a generalized way of creating composite feeds. They allow you, for example, to combine various sport-related feeds into one bundle called \"Sport\".</p>";
|
||||
$output .= "<p>You can have several providers of news feeds. You can add a feed by clicking the \"add feed\" link on the import administration pages. Give the feed a name, supply the URI and a comma-separated list of attributes that you want to associate the feed with. The update interval defines how often Drupal should go out to try and grab fresh content. The expiration time defines how long syndicated content is kept in the database. So set the update and expiration time and save your settings. You have just defined your first feed. If you have more feeds repeat as necessary.</p>";
|
||||
$output .= "<p>To verify whether your feed works, press \"update items\" at the overview page. The number of news items that have been sucessfully fetched, should then become visible in the third column of the feed overview.</p>";
|
||||
$output .= "<p>Now you have to define some bundles. Bundles look for feeds that contain one of the keywords associated with the bundle and display those feeds together. To define a bundle you have to give it a name and a comma-separated list of keywords just like this is the case for feeds.</p>";
|
||||
$output .= "<p>Your newly created bundle will now show up in the list of blocks that you can see at the block related administration pages. There you can customize where and when your bundles will be displayed.</p>";
|
||||
return t($output);
|
||||
$output .= "<p>Thousands of web sites, especially news sites and weblogs, syndicate their most recent site content for others to display. The syndicated content always includes titles, also known as headlines, for the newest published stories. Each headline acts as a direct link to the stories on the remote site. Along with the headline, most sites typically provide either the first few paragraphs of the story or a short summary. Many individuals use client-based news aggregators on their personal computer to aggregate content, such as <a href=\"http://www.disobey.com/amphetadesk/\">AmphetaDesk</a>.</p>";
|
||||
|
||||
$output .= "<p>Drupal also has a news aggregator built in as a standard feature. With it, you can subscribe to feeds from other sites and display their content for your site users. Simply enable the import module in site administration and enter the feeds that you choose.</p>";
|
||||
$output .= "<h3>What do I need to subscribe to a feed?</h3>";
|
||||
$output .= "<p>The standard method of syndication is using the XML-based <a href=\"http://groups.yahoo.com/group/rss-dev/files/specification.html\">Rich Site Summary</a> (RSS). To syndicate a site's content, obtain the full URL of the RSS page providing syndication. Common file tags for RSS pages are .rss, .xml and .rdf. Example: <a href=\"http://slashdot.org/slashdot.rdf\">http://slashdot.org/slashdot.rdf</a>.</p>";
|
||||
$output .= "<p>Most weblog sites that offer syndication will have an obvious link on the main page. Often you need only look for an xml syndication button, such as the one Drupal uses for site syndication.</p>";
|
||||
$output .= "<p>But some sites do not make their RSS feeds as easy to find. Or maybe you want to find a number of feeds on a given topic, without extensively searching the web. In that case, try an RSS syndication directory such as <a href=\"http://www.syndic8.com/\">Syndic8</a>.</p>";
|
||||
$output .= "<p>To learn much more about RSS, read Mark Pilgrim's <a href=\"http://www.xml.com/pub/a/2002/12/18/dive-into-xml.html\">What is RSS</a> and WebReference.com's <a href=\"http://www.webreference.com/authoring/languages/xml/rss/1/\">The Evolution of RSS</a>.</p>";
|
||||
$output .= "<p>NOTE: Enable your site's xml syndication button by turning on the Syndicate block in block management.</p>";
|
||||
$output .= "<h3>Configuring news feeds</h3>";
|
||||
$output .= "<p>To subscribe to an RSS feed on another site, use the <i>administer news feeds</i> shortcut at the top of the news aggregation page. The link leads directly to the news aggregation configuration section of Drupal site administration.</p>";
|
||||
$output .= "<p>Once there, select <i>add new feed</i> from the left hand menu. Drupal will then ask for the following:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The text entered here will be used in your news aggregator, within the administration configuration section, and as title for the news feed block. As a general rule, use the web site name from which the feed originates.</li>";
|
||||
$output .= " <li><b>URL</b> -- Here you'll enter the fully-qualified URL for the feed for the site you want to subscribe to.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Attributes are keywords which can be used to collect feeds into <i>bundles</i> (see below). Think of these as the means of classifying your feeds. Separate multiple attributes with commas. If you do not plan on using the specific feed in a bundle, this input field can be left blank.</li>";
|
||||
$output .= " <li><b>Update interval</b> -- The update interval is how often Drupal will automatically access the RSS URL for the site for fresh content. The 1 hour default is typically the minimum you will want to use. Accessing another site's RSS page more frequently can be considered impolite. After all, it does require the other site's server to handle your automatic requests. To take advantage of this feature, note that cron.php must be configured to have your feeds updated regularly. Otherwise, you'll have to manually update feeds one at a time within the news aggregation administration section by using <i>update items</i>.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<p>Once you submit your new feed, check to see if it is working properly. Select <i>update items </i> on the main news 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.</p>";
|
||||
$output .= "<h3>Adding bundles</h3>";
|
||||
$output .= "<p>You may want to follow some feeds more closely than others. Or perhaps you'd like to display a select list of the titles for some feeds as a block for users. Bundles are a way of grouping your feeds into categories. Bundles look for feeds that contain at least one of the keywords, or attributes, associated with the bundle and display those feeds together.</p>";
|
||||
$output .= "<p>When adding a bundle, Drupal will ask for:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The title will be used in the <i>news by topics</i> listing in your news aggregator and with the customized block created for the bundle.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Enter one or more of the attributes used to categorize the news feeds already created. Separate multiple attributes with commas. Be careful to use the same spelling. Don't have any feeds with attributes for the bundle? After creating the bundle, edit existing feeds or create new ones and tag them with the attribute.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>Using the news aggregator</h3>";
|
||||
$output .= "<p>The news aggregator has a number of ways that it displays your subscribed content:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Latest news</b> -- Displays all incoming content in the order received with:";
|
||||
$output .= " <ul>";
|
||||
$output .= " <li>The title of the original post.</li>";
|
||||
$output .= " <li>The name of the source, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " <li>A description, the first few paragraphs or summary of the originating post (if any).</li>";
|
||||
$output .= " <li>A <i>blog it</i> link. Users can select this link to have Drupal automatically prepare a blog post for the specific item.</li>";
|
||||
$output .= " <li>A <i>feed</i> link, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " </ul>";
|
||||
$output .= " </li>";
|
||||
$output .= " <li><b>News by source -- </b>Organizes incoming content by feed, displaying titles which link to the originating post. Also has an icon which acts as blog it link.</li>";
|
||||
$output .= " <li><b>News by topic</b> -- Organizes incoming content by bundles, displaying titles which link to the originating post. Also has an icon which acts as
|
||||
blog it link.</li>";
|
||||
$output .= " <li><b>News sources</b> -- Displays an alphabetical listing of all subscribed feeds and a description. The title acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>RSS feed blocks</h3>";
|
||||
$output .= "<p>In addition to providing subscribed content through the news aggregator, Drupal automatically creates a block for each subscribed feed and every bundle created. Beside each headline in each block, Drupal includes an icon which acts a blog it link. Enable any or all of the blocks using block management.</p>";
|
||||
return $output;
|
||||
}
|
||||
|
||||
function import_system($field){
|
||||
|
|
|
|||
|
|
@ -43,7 +43,7 @@ function block_perm() {
|
|||
function block_link($type) {
|
||||
if ($type == "admin" && user_access("administer blocks")) {
|
||||
$help["block"] = t("Blocks are the boxes visible in the side bars on the left- and right-hand side of the web site, depending on the choosen theme. They are created by <b>active</b> Drupal modules. In order to view a block it must be enabled. You can assign the block's placement by giving it a region and a weight. The region specifies which side of the page the block is on, and the weight sorts blocks within a region. Lighter (smaller weight value) blocks \"float up\" towards the top of the page. The path setting is a mask which lets you define on which pages you want the specific block to be shown. The custom checkbox lets your users hide the block from their account setting page. You can also create your own blocks, where you specify the content of the block rather than it being generated by a module (you can even use PHP in these). You can create one of these by clicking the %createblock link in the menu to the left. Edit and delete links will become active below for these customized blocks.", array("%createblock" => l(t("create new block"), "admin/block/add")));
|
||||
$help["create"] = t("Here you can create a custom content block. Once you have created this block you must make it active, and give it a place on the page using <a href=\"%overview\">block management</a>. The title is used when displaying the block. The description is used in the \"block\" column on the <a href=\"%overview\">block management</a> page. If you are going to place PHP code in the block, and you have <b>create PHP content</b> permission (see <a href=\"%permission\">user management >> user permissions</a>) you <B>must</b> change the type to PHP to make your code active.", array("%overview" => url("admin/block"), "%permission" => url("admin/user/permission")));
|
||||
$help["create"] = t("Here you can create a custom content block. Once you have created this block you must make it active, and give it a place on the page using <a href=\"%overview\">block management</a>. The title is used when displaying the block. The description is used in the \"block\" column on the <a href=\"%overview\">block management</a> page. If you are going to place PHP code in the block, and you have <b>create php content</b> permission (see <a href=\"%permission\">user management >> user permissions</a>) you <B>must</b> change the type to PHP to make your code active.", array("%overview" => url("admin/block"), "%permission" => url("admin/user/permission")));
|
||||
$help["preview"] = t("This page helps show you the placement of your blocks in different themes. The numbers are the weight of each block, which is used to sort them within the sidebars.");
|
||||
|
||||
menu("admin/block", "block management", "block_admin", $help["block"], 3);
|
||||
|
|
@ -233,7 +233,7 @@ function block_box_form($edit = array()) {
|
|||
}
|
||||
|
||||
function block_box_save($edit) {
|
||||
if (!user_access("create PHP content")) {
|
||||
if (!user_access("create php content")) {
|
||||
$edit["type"] = 0;
|
||||
}
|
||||
|
||||
|
|
@ -330,4 +330,4 @@ function block_user($type, &$edit, &$user) {
|
|||
}
|
||||
}
|
||||
|
||||
?>
|
||||
?>
|
||||
|
|
|
|||
|
|
@ -43,7 +43,7 @@ function block_perm() {
|
|||
function block_link($type) {
|
||||
if ($type == "admin" && user_access("administer blocks")) {
|
||||
$help["block"] = t("Blocks are the boxes visible in the side bars on the left- and right-hand side of the web site, depending on the choosen theme. They are created by <b>active</b> Drupal modules. In order to view a block it must be enabled. You can assign the block's placement by giving it a region and a weight. The region specifies which side of the page the block is on, and the weight sorts blocks within a region. Lighter (smaller weight value) blocks \"float up\" towards the top of the page. The path setting is a mask which lets you define on which pages you want the specific block to be shown. The custom checkbox lets your users hide the block from their account setting page. You can also create your own blocks, where you specify the content of the block rather than it being generated by a module (you can even use PHP in these). You can create one of these by clicking the %createblock link in the menu to the left. Edit and delete links will become active below for these customized blocks.", array("%createblock" => l(t("create new block"), "admin/block/add")));
|
||||
$help["create"] = t("Here you can create a custom content block. Once you have created this block you must make it active, and give it a place on the page using <a href=\"%overview\">block management</a>. The title is used when displaying the block. The description is used in the \"block\" column on the <a href=\"%overview\">block management</a> page. If you are going to place PHP code in the block, and you have <b>create PHP content</b> permission (see <a href=\"%permission\">user management >> user permissions</a>) you <B>must</b> change the type to PHP to make your code active.", array("%overview" => url("admin/block"), "%permission" => url("admin/user/permission")));
|
||||
$help["create"] = t("Here you can create a custom content block. Once you have created this block you must make it active, and give it a place on the page using <a href=\"%overview\">block management</a>. The title is used when displaying the block. The description is used in the \"block\" column on the <a href=\"%overview\">block management</a> page. If you are going to place PHP code in the block, and you have <b>create php content</b> permission (see <a href=\"%permission\">user management >> user permissions</a>) you <B>must</b> change the type to PHP to make your code active.", array("%overview" => url("admin/block"), "%permission" => url("admin/user/permission")));
|
||||
$help["preview"] = t("This page helps show you the placement of your blocks in different themes. The numbers are the weight of each block, which is used to sort them within the sidebars.");
|
||||
|
||||
menu("admin/block", "block management", "block_admin", $help["block"], 3);
|
||||
|
|
@ -233,7 +233,7 @@ function block_box_form($edit = array()) {
|
|||
}
|
||||
|
||||
function block_box_save($edit) {
|
||||
if (!user_access("create PHP content")) {
|
||||
if (!user_access("create php content")) {
|
||||
$edit["type"] = 0;
|
||||
}
|
||||
|
||||
|
|
@ -330,4 +330,4 @@ function block_user($type, &$edit, &$user) {
|
|||
}
|
||||
}
|
||||
|
||||
?>
|
||||
?>
|
||||
|
|
|
|||
|
|
@ -1,13 +1,54 @@
|
|||
<?php
|
||||
// $Id$
|
||||
|
||||
|
||||
function import_help() {
|
||||
$output .= "<p>**REWRITE** In Drupal you have <i>feeds</i> and <i>bundles</i>. Feeds define news sources and bundles categorize syndicated content by source, topic or any other heuristic. Bundles provide a generalized way of creating composite feeds. They allow you, for example, to combine various sport-related feeds into one bundle called \"Sport\".</p>";
|
||||
$output .= "<p>You can have several providers of news feeds. You can add a feed by clicking the \"add feed\" link on the import administration pages. Give the feed a name, supply the URI and a comma-separated list of attributes that you want to associate the feed with. The update interval defines how often Drupal should go out to try and grab fresh content. The expiration time defines how long syndicated content is kept in the database. So set the update and expiration time and save your settings. You have just defined your first feed. If you have more feeds repeat as necessary.</p>";
|
||||
$output .= "<p>To verify whether your feed works, press \"update items\" at the overview page. The number of news items that have been sucessfully fetched, should then become visible in the third column of the feed overview.</p>";
|
||||
$output .= "<p>Now you have to define some bundles. Bundles look for feeds that contain one of the keywords associated with the bundle and display those feeds together. To define a bundle you have to give it a name and a comma-separated list of keywords just like this is the case for feeds.</p>";
|
||||
$output .= "<p>Your newly created bundle will now show up in the list of blocks that you can see at the block related administration pages. There you can customize where and when your bundles will be displayed.</p>";
|
||||
return t($output);
|
||||
$output .= "<p>Thousands of web sites, especially news sites and weblogs, syndicate their most recent site content for others to display. The syndicated content always includes titles, also known as headlines, for the newest published stories. Each headline acts as a direct link to the stories on the remote site. Along with the headline, most sites typically provide either the first few paragraphs of the story or a short summary. Many individuals use client-based news aggregators on their personal computer to aggregate content, such as <a href=\"http://www.disobey.com/amphetadesk/\">AmphetaDesk</a>.</p>";
|
||||
|
||||
$output .= "<p>Drupal also has a news aggregator built in as a standard feature. With it, you can subscribe to feeds from other sites and display their content for your site users. Simply enable the import module in site administration and enter the feeds that you choose.</p>";
|
||||
$output .= "<h3>What do I need to subscribe to a feed?</h3>";
|
||||
$output .= "<p>The standard method of syndication is using the XML-based <a href=\"http://groups.yahoo.com/group/rss-dev/files/specification.html\">Rich Site Summary</a> (RSS). To syndicate a site's content, obtain the full URL of the RSS page providing syndication. Common file tags for RSS pages are .rss, .xml and .rdf. Example: <a href=\"http://slashdot.org/slashdot.rdf\">http://slashdot.org/slashdot.rdf</a>.</p>";
|
||||
$output .= "<p>Most weblog sites that offer syndication will have an obvious link on the main page. Often you need only look for an xml syndication button, such as the one Drupal uses for site syndication.</p>";
|
||||
$output .= "<p>But some sites do not make their RSS feeds as easy to find. Or maybe you want to find a number of feeds on a given topic, without extensively searching the web. In that case, try an RSS syndication directory such as <a href=\"http://www.syndic8.com/\">Syndic8</a>.</p>";
|
||||
$output .= "<p>To learn much more about RSS, read Mark Pilgrim's <a href=\"http://www.xml.com/pub/a/2002/12/18/dive-into-xml.html\">What is RSS</a> and WebReference.com's <a href=\"http://www.webreference.com/authoring/languages/xml/rss/1/\">The Evolution of RSS</a>.</p>";
|
||||
$output .= "<p>NOTE: Enable your site's xml syndication button by turning on the Syndicate block in block management.</p>";
|
||||
$output .= "<h3>Configuring news feeds</h3>";
|
||||
$output .= "<p>To subscribe to an RSS feed on another site, use the <i>administer news feeds</i> shortcut at the top of the news aggregation page. The link leads directly to the news aggregation configuration section of Drupal site administration.</p>";
|
||||
$output .= "<p>Once there, select <i>add new feed</i> from the left hand menu. Drupal will then ask for the following:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The text entered here will be used in your news aggregator, within the administration configuration section, and as title for the news feed block. As a general rule, use the web site name from which the feed originates.</li>";
|
||||
$output .= " <li><b>URL</b> -- Here you'll enter the fully-qualified URL for the feed for the site you want to subscribe to.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Attributes are keywords which can be used to collect feeds into <i>bundles</i> (see below). Think of these as the means of classifying your feeds. Separate multiple attributes with commas. If you do not plan on using the specific feed in a bundle, this input field can be left blank.</li>";
|
||||
$output .= " <li><b>Update interval</b> -- The update interval is how often Drupal will automatically access the RSS URL for the site for fresh content. The 1 hour default is typically the minimum you will want to use. Accessing another site's RSS page more frequently can be considered impolite. After all, it does require the other site's server to handle your automatic requests. To take advantage of this feature, note that cron.php must be configured to have your feeds updated regularly. Otherwise, you'll have to manually update feeds one at a time within the news aggregation administration section by using <i>update items</i>.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<p>Once you submit your new feed, check to see if it is working properly. Select <i>update items </i> on the main news 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.</p>";
|
||||
$output .= "<h3>Adding bundles</h3>";
|
||||
$output .= "<p>You may want to follow some feeds more closely than others. Or perhaps you'd like to display a select list of the titles for some feeds as a block for users. Bundles are a way of grouping your feeds into categories. Bundles look for feeds that contain at least one of the keywords, or attributes, associated with the bundle and display those feeds together.</p>";
|
||||
$output .= "<p>When adding a bundle, Drupal will ask for:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Title</b> -- The title will be used in the <i>news by topics</i> listing in your news aggregator and with the customized block created for the bundle.</li>";
|
||||
$output .= " <li><b>Attributes</b> -- Enter one or more of the attributes used to categorize the news feeds already created. Separate multiple attributes with commas. Be careful to use the same spelling. Don't have any feeds with attributes for the bundle? After creating the bundle, edit existing feeds or create new ones and tag them with the attribute.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>Using the news aggregator</h3>";
|
||||
$output .= "<p>The news aggregator has a number of ways that it displays your subscribed content:</p>";
|
||||
$output .= "<ul>";
|
||||
$output .= " <li><b>Latest news</b> -- Displays all incoming content in the order received with:";
|
||||
$output .= " <ul>";
|
||||
$output .= " <li>The title of the original post.</li>";
|
||||
$output .= " <li>The name of the source, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " <li>A description, the first few paragraphs or summary of the originating post (if any).</li>";
|
||||
$output .= " <li>A <i>blog it</i> link. Users can select this link to have Drupal automatically prepare a blog post for the specific item.</li>";
|
||||
$output .= " <li>A <i>feed</i> link, which acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= " </ul>";
|
||||
$output .= " </li>";
|
||||
$output .= " <li><b>News by source -- </b>Organizes incoming content by feed, displaying titles which link to the originating post. Also has an icon which acts as blog it link.</li>";
|
||||
$output .= " <li><b>News by topic</b> -- Organizes incoming content by bundles, displaying titles which link to the originating post. Also has an icon which acts as
|
||||
blog it link.</li>";
|
||||
$output .= " <li><b>News sources</b> -- Displays an alphabetical listing of all subscribed feeds and a description. The title acts as a link to an individual feed page, listing information about that feed and incoming content for that feed only.</li>";
|
||||
$output .= "</ul>";
|
||||
$output .= "<h3>RSS feed blocks</h3>";
|
||||
$output .= "<p>In addition to providing subscribed content through the news aggregator, Drupal automatically creates a block for each subscribed feed and every bundle created. Beside each headline in each block, Drupal includes an icon which acts a blog it link. Enable any or all of the blocks using block management.</p>";
|
||||
return $output;
|
||||
}
|
||||
|
||||
function import_system($field){
|
||||
|
|
|
|||
Loading…
Reference in New Issue