Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update viewsreference argument field description with better help #2622

Open
trackleft opened this issue Jul 28, 2023 · 1 comment
Open

Update viewsreference argument field description with better help #2622

trackleft opened this issue Jul 28, 2023 · 1 comment
Labels
editor experience Improvements to the editor experience for individuals editing Quickstart websites enhancement New feature or request good first issue Good for newcomers

Comments

@trackleft
Copy link
Member

trackleft commented Jul 28, 2023

Motivation

A common question we get is, How do I configure the argument field when I already know the term ids
Example:

I need a view to show only events that have both taxonomy terms present (undergraduate info session and in-person info session, for example). What’s the proper way to do that in the argument? “ID,ID” is not working, nor does ID+ID. Been a while since I’ve done that. Thanks!

To which, go on a mission to track down the clearest documentation about it.

The documentation for working with views arguments can be found under the “How to Create a View of a Specific Category” section of this page https://quickstart.arizona.edu/page-elements/views
Enter an Argument to display only items in a certain category. (Leaving this blank will display all items.)
The Argument must be the taxonomy term ID number of the category you wish to display.
You can enter:
Single taxonomy arguments: 4
Multiple taxonomy arguments: “4,6,3" (Taxonomy terms within double quotes and separated by comma)
Single secondary taxonomy arguments: 8 (No double quotes used)
Multiple secondary taxonomy arguments: 8 9 (No double quotes or comma used)
For more information, see the Taxonomy page.

And end up supplementing that documentation with stuff like
Comma signifies the AND operator
Plus signifies the OR operator
According to views documentation
AND operator means that content has to have ALL the designated terms
OR operator means that content has to have ANY of the designated terms.

Certain views have different requirements, which isn’t ideal, but for views with multiple accepted argument types.
Example arg 1 taxonomy term, arg 2 content type

Proposed Resolution

Possibly help with this issue: https://www.drupal.org/project/viewsreference/issues/3304493
Or apply this patch: https://www.drupal.org/files/issues/2022-08-18/viewsreference-argument-description.patch

Describe the solution you'd like

A clear and concise description of what you want to happen.

Describe alternatives you've considered

A clear and concise description of any alternative solutions or features you've considered.

Roles and Permissions considerations

A clear and concise description of how each of the following roles would be impacted by this change:

  • Anonymous user
  • Authenticated user
  • Content editor
  • Content administrator
  • Administrator

Additional context

Add any other context or screenshots about the feature request here.

@joeparsons joeparsons added enhancement New feature or request editor experience Improvements to the editor experience for individuals editing Quickstart websites labels Aug 4, 2023
@trackleft trackleft added the good first issue Good for newcomers label Aug 29, 2023
@trackleft
Copy link
Member Author

Related to #3443

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
editor experience Improvements to the editor experience for individuals editing Quickstart websites enhancement New feature or request good first issue Good for newcomers
Projects
None yet
Development

No branches or pull requests

2 participants