pkp / pkp-lib

The library used by PKP's applications OJS, OMP and OPS, open source software for scholarly publishing.
https://pkp.sfu.ca
GNU General Public License v3.0
297 stars 443 forks source link

Redesign submission lists to improve submission tracking and discovery #7495

Open NateWr opened 2 years ago

NateWr commented 2 years ago

Summary

Describe the problem you would like to solve

Editors spend a lot of time using the submissions list to manage submissions and other editorial assignments. To do their work more quickly, they want the lists to show more information, provide more tools to find submissions, take actions more quickly, and distinguish between different assignments.

Describe the solution you'd like Redesign the submission lists to accomodate more information and support a UI framework that can grow over time to include more features.

Who is asking for this feature? This is a longstanding community priority. See further details below.

Motivating Issues
  • Tracking submissions in the review stage #4172, #7488
  • Distinguishing between editor, author and reviewer assignments #4975
  • Requests for more filters #5263, #7489 that have made the filter list large and unwieldy
  • Allow common editorial actions to be taken directly from the submissions list #7490, #7491
  • Separate declined and published submissions #7494
  • Unable to use submissions lists on small screens

Proposal

@Devika008 has created the following mockups and conducted extensive user research and testing. The final details may continue to evolve, but the broad proposal should be considered final.

  1. A new submissions dashboard for editors with more details and additional views to help editors track submissions.

 English {Size_ 1440x1024}

  1. A summary panel that can be opened with more details and actions for each submission.

 English {Size_ 1440x1024}

Further mockups are available in the different issues below

Issues

This is a major undertaking scheduled for the 3.5 milestone. As such a large feature, we have broken it down into smaller issues. These have been further split into critical and optional issues.

Critical Issues

These issues must be completed in the 3.5 milestone in order to migrate from the old submissions list to the new submissions list.

Optional Issues (in order of priority)

These issues are optional, but many are high value. We hope at least some of them can be completed for 3.5. These are ranked in order of priority, based on user research to determine what would be most useful. The top issues should be worked on first.

  1. 8888

  2. 8889

  3. 8890

  4. 8891

  5. 8892

  6. 8893

  7. 8894

  8. 8895

  9. 8896

  10. 8897

  11. 8899

Original Proposal

The mockups above and in the linked issues were compiled after extensive user research. They are an evolution of an original proposal from 2021.

Original Proposal The video below introduces proposed mockups that bring together feature requests and proposals from several other issues into a single, coherent design. However, they are just proposals. No decisions have yet been made about the precise design of the new submissions lists or how it will operate. [![Video walkthrough of proposals](https://img.youtube.com/vi/sPqgMiPZsUQ/0.jpg)](https://www.youtube.com/watch?v=sPqgMiPZsUQ) [Video walkthrough of proposals](https://www.youtube.com/watch?v=sPqgMiPZsUQ) ### List View The following mockup shows a proposal for a list-based view of submissions. The list-based view is easy to adapt to small screens, but it is harder to fit lots of information on the screen and even harder for a plugin to add its own information. ![submissions-panel](https://user-images.githubusercontent.com/2306629/143906397-4dcd76b3-01f3-4d18-9fc2-d00e8570e7a9.png) ### Table View The following mockup shows a proposal for a table-based view of submissions. The table view allows plugins to easily add/remove columns. However, extra work would need to be done to ensure it worked on small screens. ![Table View - Desktop](https://user-images.githubusercontent.com/2306629/143903075-0e0eda22-e7d6-4533-b43f-5070b7fd25e0.png) The columns shown here are suggestions. Which columns are shown will depend on how important they are. It may even be possible to let users configure which columns they see. ### Mobile View The following mockup shows a simplified view for mobile phones. The dropdown toggle would expand more complete details for each submission. ![Submissions](https://user-images.githubusercontent.com/2306629/143906942-58855ff3-8c29-44b3-b020-d9fa2cef5e88.png) ### Groups instead of separate lists Instead of having separate tabs for different submission lists (My Queue, All Active, Archived), the new submission list will only have a single list. The user can view one of the following groups at a time: ![submissions-lists](https://user-images.githubusercontent.com/2306629/143903455-9ffc92ef-6486-4aea-a9bb-03c945b4efde.png) | Group | Description | | --- | --- | | Assigned to me | Same as "My Queue" | | All Active | No change | | Unassigned | No change | | Scheduled for Publication | Any submissions with the scheduled for publication status. In OJS this is a submission scheduled for publication in an issue that is not yet published. | | Published | Published submissions | | Declined | Declined submisssions | | Incomplete | Incomplete submissions. Incomplete submissions should only show in this group and not appear in any other groups. | ### Filter Groups The number of filters has gotten pretty large. The new list should organise these filters into dropdowns so they are easier to find and use. ![submissions-filters](https://user-images.githubusercontent.com/2306629/143904928-0925671d-c22e-48f1-9f74-d3a36d659d94.png) A filter group can be expanded to show the filters in it. ![submissions-filters-open](https://user-images.githubusercontent.com/2306629/143904931-a2566cde-4cc3-4052-8e50-04f6d2615322.png) ### Review Assignments The new lists can show more details about the review stage. See more detailed mockups at [#4172](https://github.com/pkp/pkp-lib/issues/4172). ![submissions-reviews](https://user-images.githubusercontent.com/2306629/143905659-e3a3b42b-49d3-44a6-b534-a3e2dcc765b0.png) ### Quick Actions and Details In the List View, each submission will expand to show further actions and information. ![submissions-panel-actions](https://user-images.githubusercontent.com/2306629/143907222-bda8191a-5634-4890-bb30-3e08c8ec924f.png) In the Table View, more of the information and actions are shown in each row. However, additional information and actions is available through the Edit button. ![submissions-table-actions](https://user-images.githubusercontent.com/2306629/143907503-cbf0c195-e2fd-4206-89b7-62d7c662418b.png)
ajnyga commented 2 years ago

This is an additional comment that came up in a working group at the Helsinki Sprint:

Incomplete submissions currently show to the Editor within the All Active list. This causes unnecessary ‘noise’ within the submission list, where the editor is presented with article data that has not actually been submitted to the journal. This adds unnecessary content to the submission list and makes it harder for the Editor to find their tasks.

Describe the solution you'd like Remove the Incomplete submissions from the default All Active list so that an editor does not see them each time they enter the list.

The Incomplete submissions should still be available via the ‘Incomplete’ filter option, should an editor need to access them.

forgive38 commented 1 year ago

Hello I made PR for this issue: OJS pkp/ojs#3808

you can see screenshots in pkp lib pkp/pkp-lib#8722

ui-library pkp/ui-library#265

thank you

NateWr commented 1 year ago

Wow, @forgive38, this is a lot of work! The screenshots look great. At the moment, we are finalizing our plans for the submission list for 3.5. Our designer, @Devika008, has adapted the proposal above and is testing out a couple of different mockups with users. We plan to work on this a lot in 3.5, but there are still some changes to come to exactly how it will work. If you would email me directly (my email is natew at the domain name name publicknowledgeproject.org), I can talk to you more about our plans and we can discuss how to make the best use of your work here.

Vitaliy-1 commented 1 year ago

PRs pkp-lib: https://github.com/pkp/pkp-lib/pull/9198 ui-library: https://github.com/pkp/ui-library/pull/277 OJS: https://github.com/pkp/ojs/pull/3991

Edit OMP: https://github.com/pkp/omp/pull/1440 OPS: https://github.com/pkp/ops/pull/554

This adds basic support for the new submission lists UI and API endpoints. As this disrupts tests, it's available through switching on the enable_new_submission_listing flag in the config.

Vitaliy-1 commented 1 year ago

It appears that the modification of ui-library in components\Table\ causes failure of jobs panel rendering. @jardakotesovec, do you have time to look at this? I'm not much familiar with Vue 3 syntax.

Vitaliy-1 commented 1 year ago

To reproduce:

  1. Go to the Administration -> Jobs and click on the view jobs
  2. See that the content (header) of the jobs panel isn't rendered
  3. Run php lib/pkp/tools/jobs.php test and refresh the page
  4. See that newly created jobs are also not shown. jobs
Vitaliy-1 commented 1 year ago

@asmecher, can you take a look at these PRs?

asmecher commented 1 year ago

Hi all! I've taken a quick first look (https://github.com/pkp/pkp-lib/pull/9198#pullrequestreview-1563443965); this won't break OMP and OPS if merged as a WIP, right? If not, please go ahead as you see fit :+1:

Very much looking forward to seeing this all come together!

Vitaliy-1 commented 1 year ago

Leaving this open until new UI is implemented

lpanebr commented 8 months ago

This will be game changing for osj. Congrats on the great job!

Devika008 commented 6 months ago

Hello,

After a lot of user and data backed research, I have refined the above designs further to meet accessibility guidelines as well as staying consistent with the overall design system. Here are the revised designs.

A. A new submissions dashboard for editors with more details and additional views to help editors track submissions.

Image

Image

B. A summary panel that can be opened with more details and actions for each submission.

  1. For Desk-Review Stage

Image

  1. For Review Stage

Image

  1. For copyediting Stage

Image

  1. For Production Stage

Image

  1. For a submission thats scheduled for publishing

Image

lpanebr commented 6 months ago

Wizards will be wizards. 🧙 ❤