Split Summary Message Can Be Confusing
JuliaKM - April 2, 2009 - 21:07
| Project: | Table of Contents |
| Version: | 6.x-2.x-dev |
| Component: | User interface |
| Category: | feature request |
| Priority: | normal |
| Assigned: | AlexisWilke |
| Status: | closed |
Description
I ended up commenting out these messages because my end users found them confusing:
- A split summary was automatically created as site settings don't allow Table of Contents in summaries.
- Your summary was split from the body as site settings don't allow Table of Contents in summaries.
Would you be in favor of only showing the message for uid 1? If so, I'd be happy to submit a patch.

#1
The main reason I wanted those messages shown is that the module is actively changing the user's content. I didn't want users to be confused when they went back to edit their page and found it to have a distinct summary. In many cases this means that the summary and the body have nearly-identical content which needs to both be updated at the same time.
Would you mind explaining what's going on to your users, and asking them what would have been a clearer message? Are these users who are comfortable with using summaries and such normally?
Thanks!
#2
Would you mind explaining what's going on to your users, and asking them what would have been a clearer message? Are these users who are comfortable with using summaries and such normally?
Sure. The problem is that I'm using the module as part of a wiki. There are two primary groups of users: staff members at my organization and non-staff authenticated users who want to edit a wiki page. While it makes a lot of sense for the staff members to see the messages, the non-staff authenticated users get confused when editing a page. They think that they have done something wrong because they are not familiar with the teaser concept and didn't set out to create a tester. The typical non-authenticated user's sole goal is to make a small text change to a wiki page. As a result, the display message ends up being more confusing than helpful for them.
#3
Ok, that makes sense. However, the message should only show when the module decides it has to mess with the structure of the body. Is it showing up on every save? If so, that's a bug that needs to be fixed.
As for the text, how about something like this?
and
It's a little verbose, but perhaps not quite so daunting. It also makes it clear that nothing has gone wrong, and why their content has changed (since I imagine many users will go back to the edit tab, using "Save" as a preview function).
#4
Thanks for your help. I'm attaching a patch with the revised message.
If anyone finds this post in the future and would like to create a more customized message using Drupal 6 and tableofcontents, I recommend the String Overrides modules.
#5
#6
Under what conditions does the message actually display? Dumb (and probably related) question: What admin page is it referring to exactly when it says "site settings"? It just started popping up for me after going to 2.3, and I'm obviously flailing. (Caveat: this is pre-coffee for me, but I definitely searched around and read the readme before asking!).
#7
Under what conditions does the message actually display?
When you save a message that includes a TOC and the TOC is to be hidden from the teaser page as defined in the settings.
What admin page is it referring to exactly when it says "site settings"?
Administer -> Settings -> Input format
Click on the format you want to support TOC, select the TOC filter, Save
Go back to the format and click on Configuration
#8
Ah, got it. Very obvious now in hindsight, but perhaps it would be helpful to explicitly mention that in the text.
Thanks again for picking up the module!
#9
Updated using #4 (although added "teaser" between parenthesis because some people won't know what the summary is, but they know about the teaser.)
#10
Automatically closed -- issue fixed for 2 weeks with no activity.
#11
When you save a message that includes a TOC and the TOC is to be hidden from the teaser page as defined in the settings.
I 'disabled' teasers for my whole site because it confuses my users (they are really simple users) but now I get this warning and the hateful summary text-area. Is it possible to avoid the split summary thing if teasers are not used?
Thank you!
#12
#13
Ah, I'm really blind. I just discovered the option 'remove table of contents from teasers' inside the input format configuration. Thank you!
#14
When you do NOT turn on the "Remove Table of Contents tags from teasers" checkbox, it does not do anything to the teaser. That should solve your problem.
Let me know if that is still a problem.
Thank you.
Alexis Wilke
#15
Okay, you posted again just before me. Marking the issue fixed again. 8-)
#16
Automatically closed -- issue fixed for 2 weeks with no activity.