Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
We need to improve the help text under the advanced fieldset for term creation. People don't understand concepts like parents, related terms, and synonyms, and the help text doesn't do a great job of helping people understand.
Comment | File | Size | Author |
---|---|---|---|
#35 | termsaddbugged.png | 36.36 KB | Bojhan |
#31 | tag.jpg | 308.24 KB | Dries |
#26 | cleanup_term_form_ui_03.patch | 1.89 KB | asimmonds |
#21 | cleanup_term_form_ui_02.patch | 2.63 KB | Xano |
#16 | cleanup_term_form_ui_00.patch | 3.35 KB | Xano |
Comments
Comment #1
beeradb CreditAttribution: beeradb commentedupdating tags.
Comment #2
yoroy CreditAttribution: yoroy commentedComment #3
chrisshattuck CreditAttribution: chrisshattuck commentedAttached is a patch for this text. I was a little torn on weather to indicate that the inputs did not have any functionality by default, but after spending a while figuring this out myself, it seems like it might be an important piece of information.
Comment #4
karschsp CreditAttribution: karschsp commentedchanging status to CNR. Also fixed a misspelling in the patch. Correction attached.
Comment #5
chrisshattuck CreditAttribution: chrisshattuck commentedThanks, karschsp!
Comment #6
Bojhan CreditAttribution: Bojhan commentedwow, guys we are trying to decrease the amount of help text not increase it. I have to give this a thorough review, but few people really had trouble understanding the concept, as soon as they actually did it. So I think its save to assume, this issue although exiting might be solved by something else then a lot of help text (changing labels?)
Comment #7
beeradb CreditAttribution: beeradb commented@bojhan although in general I agree with you, these are advanced features which are totally undocumented in the interface. Do you know what a synonym does? what effect it actually has on the vocabulary? I don't think these features are self explanatory.
I'm open to other ways to convey the meaning of these fields, but as is we're not doing that at all.
Comment #9
emmajane CreditAttribution: emmajane commented@bojhan What would you recommend for the help text on each of those fields?
Here are my suggestions for the text. The "relationship" information is based on the correct terms for semantic relationships in controlled vocabularies. See more at: http://www.slis.kent.edu/~mzeng/Z3919/4relationship.htm
1. Parents
Relationship: hierarchical. Items will exist below (or within) the parent(s) you select.
2. Related Terms
Relationship: associative. Items will exist alongside the ones you select.
3. Synonyms
Relationship: equivalent. Items entered will behave as if they were identical to one another. Enter one term per line.
I'm not convinced it makes sense to repeat the phrase, "X has/have no core functionality, but may be extended by other modules." I think there is a better place to put this information. What if Parents and Weight were grouped, and "Related Terms" and "Synonyms" were also grouped?
Comment #10
berenddeboer CreditAttribution: berenddeboer commentedThe problem with improving things, is that Drupal does not appear to use the advanced options without third party modules. In the opinion of the UX-2009 Sprint team it would be better to move the advanced settings (without weight perhaps) to a third party (support) module.
Comment #11
berenddeboer CreditAttribution: berenddeboer commentedAdding tags.
Comment #12
berenddeboer CreditAttribution: berenddeboer commentedIgnore last patch. We need the text a 3rd party module is necessary only once.
Comment #13
berenddeboer CreditAttribution: berenddeboer commentedAnd this patch renames "Advanced options" to "Relationships" as that is basically what it is.
Comment #14
seutje CreditAttribution: seutje commentedchanging d7uxsprint tag
Comment #15
eigentor CreditAttribution: eigentor commentedScreenshots before and after the patch #13
before:
after:
Comment #16
XanoThis patch removes the Identification fieldset and all redundant element descriptions. It also renames "Related terms" to "Similar terms", to prevent collision with the "Relations" fieldset and because parent terms are also related. #504078: Synonym collapsing in core adds a description to the Synonym textare explaining what it's used for.
Comment #17
XanoComment #19
Bojhan CreditAttribution: Bojhan commentedLooks good, please fix the patch.
Comment #20
yoroy CreditAttribution: yoroy commentedBump. Xano, still on this?
Comment #21
XanoBefore & after.
Comment #22
catchNice. I like 'relation's here - since that's what the fieldset has, and if I don't care what relations is, I don't need to open it, whereas you can never tell with 'advanced'.
Comment #23
Bojhan CreditAttribution: Bojhan commentedYup, agreed - good terminology.
Comment #24
yoroy CreditAttribution: yoroy commentedWhat catch said. RTBC
Comment #26
asimmonds CreditAttribution: asimmonds commentedRerolled patch from #21
Comment #27
yoroy CreditAttribution: yoroy commentedback to rtbc
Comment #28
XanoWe might even want to get rid of the "Optionally (...)", because the asterisks indicate required and optional fields anyway. No commit blocker, just nitpicking.
Comment #29
yoroy CreditAttribution: yoroy commentedWe'll leave it in here. Without it, the sentence reads very 'required'.
Comment #30
Dries CreditAttribution: Dries commentedCommitted to CVS HEAD. Thanks.
Comment #31
Dries CreditAttribution: Dries commentedThe term form is pretty broken still:
Comment #32
Dries CreditAttribution: Dries commentedComment #33
asimmonds CreditAttribution: asimmonds commentedRelated issue for the position of URL alias textfield: #678590: Path alias link is below submit button on taxonomy term add
Comment #34
Bojhan CreditAttribution: Bojhan commentedThis is a bug.
Comment #35
Bojhan CreditAttribution: Bojhan commentedAll we need to fix is the location of the url alias? The rest seems to been fixed, the breadcrumb is a larger issue - not meant to be fixed here.
Comment #36
Bojhan CreditAttribution: Bojhan commentedAlso, this bug isn't really critical anymore
Comment #37
yched CreditAttribution: yched commentedThis form has Field API 'fields'. The order is defined by the admins on admin/structure/taxonomy/%tid/fields.
Reordering doesn't play nice when there are fixed-weight items in the middle of user-reorderable items.
So the consequence for other, non-Field elements in the form is that :
a) Either they declare themselves as 'reorderable' as well, using hook_field_extra_fields(). They just provide a default weight.
That's the case of 'Name' and 'Description' : see taxonomy_field_extra_fields(), and the result on this screenshot.
Should be done only if we see value in letting users tweak their position. Having too much stuff available for reordering only adds confusion for users.
I'm not sure this is the case for 'URL alias' and the 'Relations' fieldset.
b) Or they stick with a fixed position at the bottom of the form, with a reasonably high weight (100+) so that they stay out of the range of weights of the reorderable items
That's what the buttons container does.
Currently, 'url alias' has an implicit fixed weight of 0 (path_form_taxonomy_form_term_alter()), and 'Relations' has a fixed weight of 10. Both are wrong.
Comment #38
Dave ReidI think its perfectly reasonable to let users re-order fields whenever they want. For the URL alias field, see #687994: Add hook_field_extra_fields() implementation to path module
Comment #39
Bojhan CreditAttribution: Bojhan commentedWon't fix it is then?
Comment #40
yched CreditAttribution: yched commentedNot yet. See my reply in #687994-7: Add hook_field_extra_fields() implementation to path module.
At any rate, "something" needs to be done for 'URL alias' and 'Relations'. Either a) or b) from #37 above.
Comment #41
Xano