On Mon, Mar 23, 2009 at 9:06 AM, DrunkenMonk <[email protected]> wrote: > > I was trying to get to grips with forms in order to create some ticket- > sales management for my theatre group wiki, and was therefor > confronted by the forms documentation. I was surprised, because the > documentation pages did not help. > > They are clearly not complete, and normally I would simply pitch in > and help write them, but if I could do that I would not have needed > them in the first place. Instead, I thought I'd offer some feedback. > > Anyway. I think the biggest problem I had with the documentation pages > is that there are no examples. > > Take, for example, the "warn" command. The code: > > [form] > [hidden message "warning message"] > [session warn {=message}] > [session warn message] > [submit] > [form] > > Does absolutely nothing when pressed. By the documentation I would > have expected, i dunnu, a warning message, but there is nothing there > which would suggest this or any other usage.
Probably what you want is simply [form] [session warn "warning message"] [submit] [form] But what you had will give the message: "Form submitted. message". The second warn line over writes the first warn. To see the message however, you need to have [messages] somewhere on the page, to display them. Usually, this is built into the skin. If you don't have it somewhere, you won't see the messages. But you can put them individually where the forms are if you like as well. [messages] [form] [session warn "warning message"] [submit] [form] > I get similar results when using the if command, and I believe > inserting simple example code would greatly increase readability of > the forms documentation. Possibly the same problem. Just need the [messages] markup to tell BoltWire to display your system messages. > Further, there are a lot of great suggestions in the forms > documentation, but without boltwire example code, it is often > difficult to see directly what the writer is trying to suggest. Yes, it all just takes time. If you get a snippet working, feel free to add it. For that matter, if you care to add a note about how to display the system messages, in the docs somewhere, that would be helpful. Cheers, Dan --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "BoltWire" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/boltwire?hl=en -~----------~----~----~----~------~----~------~--~---
