WordPress does this neat thing where out of the box you get several blocks on the dashboard that tie you directly back into their upstream community: WordPress Blog shows official communication, "Other WordPress News" offers their equivalent of Drupal Planet, and so on.

Since our dashboard needs content, and since we have a news feed at http://drupal.org/news that talks about things like new core releases, how to get involved in Drupal, and upcoming Drupal events, this seems like a nice thing to point people at to give them an "in" into the community.

Comments

gdd’s picture

A great idea, look forward to the patch (aka subscribe)

webchick’s picture

Status: Active » Needs review
StatusFileSize
new1.24 KB

Here we go.

cweagans’s picture

Status: Needs review » Reviewed & tested by the community

Great idea! Code looks good. Easy patch is easy.

Now all that's left is to bikeshed the position of the block for the next 197 comments.

cweagans’s picture

Status: Reviewed & tested by the community » Needs review

Just kidding.

webchick pointed out that title & description should be wrapped in t().

webchick’s picture

Issue tags: +☃

Yeah, I'm actually not sure if they should be or not. I noticed other similar things in this file were not.

Tagging for snowman. :)

David_Rothstein’s picture

Status: Needs review » Needs work
  1. The patch leads to a fatal error in the installer, since aggregator module is not enabled... (Look closely at the test results in #2 - we apparently have an interesting bug where "0 passes" makes it look like the patch passed tests.)
  2. Regarding wrapping in st(), translation in the installer is a bit of a complicated mess, but I think the answer for this one is "yes". Background reading to confirm that I'm right/wrong is at:
    #1048006: Name of vocabulary (Tags) created during install cannot be localized
    #1016006: Default title, body and other field labels not localizable
  3. When defining the block:
    +      'delta' => 'feed-1',
    

    I don't think we can assume this on some databases. aggregator_save_feed() may need to be modified to return the actual feed ID that was saved so we can use that instead.

webchick’s picture

Status: Needs work » Needs review
StatusFileSize
new1.98 KB

LOL whoops. I forgot to diff the entirety of the standard profile, not just the .install file. I had some aggregator patches going on in the modules dir that I didn't want to include, including #1266322: aggregator_save_feed() should return the feed ID. ;) (And yeah, that "0 passes == green" thing is a known bug about PIFT: #873496: Bogus test results PASSED: [[SimpleTest]]: [MySQL] 0 passes.)

Here's a hopefully better-working patch, with the st() wrappers this time and #1266322: aggregator_save_feed() should return the feed ID included.

Screenshot!
Only local images are allowed.

eaton’s picture

A big +1 from me in favor of adding this block; it's one of the things that's on the agenda for the Snowman 'Small Group Tool' installation profile as well, and putting it in Standard makes sense from a Drupal branding perspective. It's probably worth paying a little extra attention to our d.o. front page node titles, though, as a lot of the stuff that shows up in that feed (other than Drupal release notes) is a bit opaque from a microcontent perspective.

It's outside of the purview of this particular patch, but writing to the audience of People Who Installed A New Drupal Site vs. People Who Read Drupal.org is something to keep in mind!

Status: Needs review » Needs work

The last submitted patch, drupalorg-dashboard.patch, failed testing.

David_Rothstein’s picture

Issue tags: +Needs usability review

The code looks good now (except for whatever is causing that failing test). Also, aggregator_save_feed() should have its @return documented.

I had a similar thought as @eaton when looking at the list of aggregator item titles. What would someone relatively new to Drupal think when they saw that list - would they really have enough context to understand what they were looking at?

It's been a long while since I looked at the Wordpress version of this so I don't quite remember how it works, but I seem to remember it being a bit different... maybe they have descriptions next to the items? Or an overall description at the top of the block? It would be worth taking a look. It may be we can't do much to change this without changing the behavior of the aggregator module itself and/or improving the titles of d.o. front page posts (which is a bit out of scope), but it does feel like it would be improved with some kind of extra sentence of context or what not.

webchick’s picture

Sure. Here's a screenshot of their two blocks:

Only local images are allowed.

I think the WordPress Blog is contextualized a bit by having a teaser view rather than a title listing view of the content. Their "Planet" feed looks a lot like aggregator's default output.

There's no extra description though. The only thing you get if you hover over the block titles is a "configure" link that lets you make some adjustments like how many items to show and what feed URL to point it at (something like views lite, which is kind of interesting).

The point about curating titles on drupal.org for both audiences eaton talks about is very fair, though. Would be something to communicate with the team who handles the front page.

Bojhan’s picture

Issue tags: -Needs usability review, -☃ +Usability

Looks good to me, I dont think we really need to do much customization, the reason Wordpress also has teasers is because they are trying to balance the visual elements on the dashboard (several blocks with only links, is not going to help that).

Does this require aggregation module to be enabled by default? Because that to me, seems like a more major concern given the UX problems it has.

webchick’s picture

Issue tags: +snowman

It does mean that yes, but it's buried pretty deep in the UI, so the chances of someone stumbling across it are fairly nil. Are there specific UX concerns with aggregator module, and are they captured in other issues?

Restoring snowman tag (eaton told me the less funny one is official), because this has to do with Drupal's default user experience.

Bojhan’s picture

I agree that for the initial user experience, its unlikely to cause any issues. With that in mind we can definitely consider letting this go in. However in light of the recent discussions about our product, we should definitively have to talk whether this module as a whole deserves a place in the product (other issue, though). Even if we remove aggregator we could have a block like this.

The issues I see with aggregator are not in the administrative section, but rather in the front-end (the results). These are really hard to discover and understand the relationship between pages. It uses its own form of categorization, which has many confusing side effects (e.g. categorize pages with no content, empty configuration pages and poor navigation between categories and feed streams). But also the initial experience of aggregator, being an "empty" one - unless you do some customization its likely the first feeds you pull in are going to be empty till an update comes by. In the administrative section there are other problems, such as the categorization and feeds shown on one page, with several feeds and categories this gets messy quickly.

I am not sure how this patch is implemented, but does it create a "default" setting here by creating a "Drupal news" feed? If so, we need to consider whether hiding it - makes sense. This because for the user it will be somewhat confusing to see a "administrative" feature being performed by a module. The connection between the block, and what is shown in aggregator will not immediately be clear.

I have no knowledge of existing issues about this, clearly it hasn't been a focus point of us. Given the problems we face for D8, I doubt we will get to it.

webchick’s picture

"I am not sure how this patch is implemented, but does it create a "default" setting here by creating a "Drupal news" feed? If so, we need to consider whether hiding it - makes sense. This because for the user it will be somewhat confusing to see a "administrative" feature being performed by a module. The connection between the block, and what is shown in aggregator will not immediately be clear. "

The way this is implemented is in the standard profile only, it does indeed create a "Drupal news" feed, and puts the block this feed exposes into the dashboard. People using the minimal profile, or any other profile, would not see this feed/block.

People using the standard profile, if they arrived at the Aggregator module settings page, would indeed see a "Drupal news" feed. However, I don't see this as fundamentally different with how Contact (which creates a "Website feedback" category upon enabling) and Forum (which creates a "General discussion" forum upon enabling) modules work currently. Other than this approach puts the defaults where they belong, IMO—the profile, where it's opt-in, not the module itself where you have to undo work.

I see the question of whether we should do this because aggregator might be removed by core developers at some point during the D8 cycle as a bit of a chicken/egg problem. One of the reasons people want to remove aggregator is because we're not actively using it in core atm. With this patch we would now be using it in our product, for a real use case that would help bring more people into our community.

eaton’s picture

It does mean that yes, but it's buried pretty deep in the UI, so the chances of someone stumbling across it are fairly nil. Are there specific UX concerns with aggregator module, and are they captured in other issues?

One patch that's been kicked around for Aggregator is forcing it to follow the same pattern that's being proposed for other listing pages: allow both the listing page and the block to be turned off independently, so that there's no externally-facing UI/menu cruft to discourage this sort of usage. That's definitely a task for another patch, though.

yoroy’s picture

Much love for this. A lifeline between your install and the mothership.

Webchick: Understood. Which means that Aggregator module would be enabled in the standard profile right? (Not only still part of core, but switched on, even)

I'm thinking this could use a 'register now' call to action to unlock the membership block with welcoming get started links. Basically, rework the 'contributor links' block on the d.o. dashboard for support/community onramp. Which is another issue. But this news block might be a good place for triggering it.

Bojhan’s picture

@eaton I would definitely favor that, although loads of this brings us to the component & page library idea we had for a more consistent approach.

@webchick Interesting to see your position on this, I don't really want to hold this up because I feel its a useful thing to endeavour. But I do wish to note that fundamentally we did not consider aggregate as part of our "enabled by default" product offering because "we" believe that this type of functionality is not a common usecase for the first 3/4 hours of initial experience. You seemed to have changed position on this, but I find it weird to "enable" something just to proof people wrong that even core doesn't use it. We should have a clear use case we are trying to support in the initial user experience. Hence my attempt to evaluate enabling aggregator independent of this issue.

When it comes to the example data purpose, I dont find it similar to forum and contact. In those modules the sole purpose of it is, to provide direction. Here we use it for actual functionality, if you remove this "Drupal news feed" it will impact the UX of your administrative dashboard. So it's not really example data, its simply using the functionality of the system with the added bonus that this module doesn't start out empty.

Again I don't wish to hold this functionality on this. But please remember, that during the Drupal 7 period we enabled a number of modules with supporting usecases for the initial user experience, in this case that doesn't seem to apply (or at least hasn't been discussed).

More important is the workflow here, do we repeat the Drupal 4/5/6/7 workflow of putting stuff in and than fixing the major(not critical) UX issues later, or do we require these to be solved before we enable new functionality? In this instance, aggregator its problem are very solvable - but will delay actual implementation of this issue.

David_Rothstein’s picture

Status: Needs work » Needs review
StatusFileSize
new5.26 KB

Thanks for the screenshot in #11. I guess those teasers were the extra text I was thinking of in the Wordpress case, and we probably don't need to deal with having those (especially not in this issue).

But in our case, a description of the feed still seems like it would provide useful context, especially since the patch tries to save one to the database anyway. We don't have to deal with that here either, but I created an issue for it at #1270476: Aggregator feed blocks should have an option to display the feed description. (Note that there's a related bug with the patch; the description that the patch tries to save to the database gets overridden immediately afterwards with an empty string, since the aggregator module gets descriptions from the feed itself, and drupal.org apparently doesn't provide a feed description that the aggregator module can understand. So this should probably be fixed on drupal.org rather than trying to save a description as part of this patch.)

I've rerolled the patch to fix the failing test. My other feedback above (on the missing @return docs) is already being handled in #1266322: aggregator_save_feed() should return the feed ID so there's no need to worry about it here.

alanburke’s picture

Status: Needs review » Needs work

The patch in #19 adds an extra text case.
Was that really intended for this issues?

David_Rothstein’s picture

Status: Needs work » Needs review

There is no extra test case, just an extra test module, which was introduced in order to fix the failing test.

(There are a couple other ways to fix the failure, but this seems like the most future-proof to me, since it's the only one that doesn't require the user module to depend on knowledge of some other random module in core.)

sun’s picture

Issue tags: +Platform Initiative
cweagans’s picture

Status: Needs review » Closed (won't fix)

Dashboard is gone now.

David_Rothstein’s picture

Title: Add a "Drupal news" block to the dashboard in Standard profile » Add a "Drupal news" block to an appropriate administrative area in the Standard profile
Status: Closed (won't fix) » Needs work

Views? Panels-in-Core (or whatever they're calling it these days)?

I think there are some options here.

Bojhan’s picture

Version: 8.x-dev » 9.x-dev

We dont have a dashboard, and I doubt that feature can make it in now. This is a good idea, but one for D9.

mgifford’s picture

Issue summary: View changes

That is too bad. It would be a nice addition. Even if it were just a block featured on the home page and an available option for folks to enable/disable later on.

We do need to have more means to push people back to the community after they have downloaded the code.

mallezie’s picture

Just to add. Also CiviCRM does this.

catch’s picture

Version: 9.x-dev » 8.1.x-dev
mgifford’s picture

Issue tags: +maintain

This could be very useful as a strategy to help build community awareness.

Version: 8.1.x-dev » 8.2.x-dev

Drupal 8.1.0-beta1 was released on March 2, 2016, which means new developments and disruptive changes should now be targeted against the 8.2.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.2.x-dev » 8.3.x-dev

Drupal 8.2.0-beta1 was released on August 3, 2016, which means new developments and disruptive changes should now be targeted against the 8.3.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.3.x-dev » 8.4.x-dev

Drupal 8.3.0-alpha1 will be released the week of January 30, 2017, which means new developments and disruptive changes should now be targeted against the 8.4.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.4.x-dev » 8.5.x-dev

Drupal 8.4.0-alpha1 will be released the week of July 31, 2017, which means new developments and disruptive changes should now be targeted against the 8.5.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.5.x-dev » 8.6.x-dev

Drupal 8.5.0-alpha1 will be released the week of January 17, 2018, which means new developments and disruptive changes should now be targeted against the 8.6.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.6.x-dev » 8.7.x-dev

Drupal 8.6.0-alpha1 will be released the week of July 16, 2018, which means new developments and disruptive changes should now be targeted against the 8.7.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.7.x-dev » 8.8.x-dev

Drupal 8.7.0-alpha1 will be released the week of March 11, 2019, which means new developments and disruptive changes should now be targeted against the 8.8.x-dev branch. For more information see the Drupal 8 minor version schedule and the Allowed changes during the Drupal 8 release cycle.

Version: 8.8.x-dev » 8.9.x-dev

Drupal 8.8.0-alpha1 will be released the week of October 14th, 2019, which means new developments and disruptive changes should now be targeted against the 8.9.x-dev branch. (Any changes to 8.9.x will also be committed to 9.0.x in preparation for Drupal 9’s release, but some changes like significant feature additions will be deferred to 9.1.x.). For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 8.9.x-dev » 9.1.x-dev

Drupal 8.9.0-beta1 was released on March 20, 2020. 8.9.x is the final, long-term support (LTS) minor release of Drupal 8, which means new developments and disruptive changes should now be targeted against the 9.1.x-dev branch. For more information see the Drupal 8 and 9 minor version schedule and the Allowed changes during the Drupal 8 and 9 release cycles.

Version: 9.1.x-dev » 9.2.x-dev

Drupal 9.1.0-alpha1 will be released the week of October 19, 2020, which means new developments and disruptive changes should now be targeted for the 9.2.x-dev branch. For more information see the Drupal 9 minor version schedule and the Allowed changes during the Drupal 9 release cycle.

Version: 9.2.x-dev » 9.3.x-dev

Drupal 9.2.0-alpha1 will be released the week of May 3, 2021, which means new developments and disruptive changes should now be targeted for the 9.3.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.3.x-dev » 9.4.x-dev

Drupal 9.3.0-rc1 was released on November 26, 2021, which means new developments and disruptive changes should now be targeted for the 9.4.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.4.x-dev » 9.5.x-dev

Drupal 9.4.0-alpha1 was released on May 6, 2022, which means new developments and disruptive changes should now be targeted for the 9.5.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

Version: 9.5.x-dev » 10.1.x-dev

Drupal 9.5.0-beta2 and Drupal 10.0.0-beta2 were released on September 29, 2022, which means new developments and disruptive changes should now be targeted for the 10.1.x-dev branch. For more information see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

ghost of drupal past’s picture

Issue tags: -

Version: 10.1.x-dev » 11.x-dev

Drupal core is moving towards using a “main” branch. As an interim step, a new 11.x branch has been opened, as Drupal.org infrastructure cannot currently fully support a branch named main. New developments and disruptive changes should now be targeted for the 11.x branch, which currently accepts only minor-version allowed changes. For more information, see the Drupal core minor version schedule and the Allowed changes during the Drupal core release cycle.

quietone’s picture

Status: Needs work » Closed (outdated)

I am inclined to agree with #44. Therefor I am closing this.