Attached is a patch making minor adjustments to the text in Aggregator module. Mostly just fiddling, there's no big problems here.

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

catch’s picture

Status: Needs review » Reviewed & tested by the community
FileSize
8.91 KB

Everything looked fine to me, except one t() which had single quotes and an escaped apostrophe instead of double quotes and no escaping. Nitpicking, so rather than set it to needs work I've attached a patch with the change and RTBCed.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Needs work

It is not a requirement to have a cron entry point to cron.php actually. You can use poormanscron, or even run cron by hand, if you wish so (eg. in the short initial period you get to know whether the module fits you). It would definitely be better to have some good substitute for this admittedly quite unfriendly 'requires crontab' notes though.

keith.smith’s picture

Good point. Thanks for the review. I'll see if I can adjust this in some way.

keith.smith’s picture

Status: Needs work » Needs review
FileSize
11 KB

Attached is the text, which standardizes on a cron message: A correctly configured Cron maintenance task is required to...., where the Cron maintenance task is a link to the /admin/reports/status page (where there is a section for Cron maintenance tasks). If this is an acceptable mechanism for doing this, I'll roll a patch to modify the other similar references to cron in core.

Note that this patch changes instances of "News aggregator" to "Feed aggregator", EXCEPT in the permissions, which still refer to 'administer news feeds' and 'access news feeds'. I'm not sure that I have the fu to change these and provide an update path without help, but I can find a similar example if these need to be changed as well.

I made this change because "News reader" has always sounded odd to me: I understand the origin, but it seems strange especially if the feed items do not represent "news" in the strict sense. Wikipedia says this:

In computing, a feed aggregator, also known as a feed reader, news reader or simply as an aggregator, ...

Also, please note:
-- Breadcrumbs have an issue in aggregator, but that is present without this patch. The patch in http://drupal.org/node/170309 cures it.

-- On the aggregator/categories page, I receive the following notices:

    * notice: Undefined variable: feed_age in /web/test/modules/aggregator/aggregator-summary-item.tpl.php on line 19.

for each item displayed. An issue may already exist for this, I have not yet searched. This notice occurs whether the patch is applied or not.

keith.smith’s picture

FileSize
11 KB

Changed a string delimited [unnecessarily] by " to ', per coding standards.

catch’s picture

Status: Needs review » Reviewed & tested by the community

The cron text is much better. Sending people to status seems sane as well - since they can see if they have such a thing as a "correctly configured cron maintenance task" then only have to find out what it is if it's not working.

So back to RTBC.

Gábor Hojtsy’s picture

Status: Reviewed & tested by the community » Needs work

A major weaknesses of the text which is not solved by this patch is that RDF and Atom support is mentioned quite late (ie. only on the feed addition page). Otherwise RSS is used which can easily make people think this is only an RSS aggregator. I'd use "syncidation format (such as RSS, RDF and Atom)" instead of simply RSS. I am not attached to this exact wording, but I'd like to see this fixed with the text updates as well. Otherwise all seem to be fine. Thanks!

keith.smith’s picture

Status: Needs work » Needs review
FileSize
11.21 KB

Hopefully the third (or fourth) time will be the trick.

I expanded the discussion in the initial paragraph of the aggregator module help text to include RSS, RDF and Atom formats (and linking to what I thought to be the most authoritative page for each, after a casual search).

New patch attached.

Gábor Hojtsy’s picture

Status: Needs review » Needs work

admin/content/aggregator still only talks about RSS. Otherwise all looks good as far as I see.

keith.smith’s picture

Status: Needs work » Needs review
FileSize
11.43 KB

*sigh*

Obviously, I've been doing a poor job of reviewing these of late. Thank you for your very good eye for detail!

I've adjusted the text at admin/content/aggregator, borrowing RSS, RDF and Atom text from the help page.

Gábor Hojtsy’s picture

Status: Needs review » Fixed

Great, this one committed now.

It would indeed be great to standardize on this cron information note/link at other places where cron is mentioned (as a requirement). Please inform me about the issue number for this once submitted :) Thanks for your awesome work in making Drupal more understandable!

keith.smith’s picture

Thanks, Gábor -- you're just swell!

The "Cron maintenance task" issue is http://drupal.org/node/197730, but no patch yet. :( I'll work on it this afternoon, hopefully.

Anonymous’s picture

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for two weeks with no activity.