documentation.txt 2.3 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. All of the HTM files within this folder will be a part of the admin/GM control
  2. panel. These are some guidelines about the way they're meant to work and get
  3. named. Following them should help both users and maintainers :
  4. 1- There are 5 major categories in which the admin panel gets divided. For each
  5. major category, there is one file whose name ends with "_menu":
  6. main_menu.htm (classic_menu.htm serves the same purpose in classic mode)
  7. game_menu.htm
  8. effects_menu.htm
  9. server_menu.htm
  10. mods_menu.htm
  11. 2- Any other .htm file within the admin folder or any subfolder but "help", should
  12. be accessible in some way by means of clicking a link or button.
  13. 3- Unless the file is outdated or there are strong reasons on the contrary, every
  14. .htm file should have a design coherent with the following style guides:
  15. a-Buttons linking to the 5 major sections in the upper side of the page.
  16. b-A predominant edit-type widget (I named it QuickBox) with Send and Help buttons.
  17. GMs should be able to pass any value or parameter needed by the admin command
  18. buttons by means of using this QuickBox.
  19. c-Under the QuickBox, there should be buttons associated with the relevant admin
  20. actions. Those buttons should be organized from top to bottom in the way that
  21. best aids to keep useability and readability:
  22. - More frequently used, first.
  23. - Commands that require quickbox values, first.
  24. - Commands that could behave as toggles, first.
  25. - Commands that have a counterpart (such as Ban/Unban), kept in pairs.
  26. - Buttons may form groups of no more than 4 rows and 3 columns.
  27. d-Any "Help" button available should take the reader to another file with the same
  28. name, but within the help folder. Said in other words, every xyz.htm file of the
  29. admin panel should have a counterpart in the form help/xyz.htm that helps people
  30. understand what can be done with it. "Back" links should be provided, also.
  31. e-If a given file needs additional navigation facilities, all of them should be
  32. kept in the upper side of the page, right after the buttons described in "a" if
  33. they appeared.
  34. 4- L2J Mods introduced to the main distribution stream, should provide a set of
  35. commands that could be added in the mods admin panel. Additionally, a help file should
  36. be desirable. Such a file should reside in help/l2jmod/.