README.txt 4.1 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778
  1. *******************************************************************************
  2. Quicktabs
  3. Description:
  4. -------------------------------------------------------------------------------
  5. This module provides a form for admins to create a block of tabbed content by
  6. selecting a view, a node, a block or an existing Quicktabs instance as the content
  7. of each tab.
  8. The module can be extended to display other types of content.
  9. Installation & Use:
  10. -------------------------------------------------------------------------------
  11. 1. Enable module in module list located at administer > structure > modules.
  12. 2. Go to admin/structure/quicktabs and click on "Add Quicktabs Instance".
  13. 3. Add a title (this will be the block title) and start entering information for your tabs
  14. 4. Use the Add another tab button to add more tabs.
  15. 5. Use the drag handles on the left to re-arrange tabs.
  16. 6. Once you have defined all the tabs, click 'Save'.
  17. 7. You new block will be available at admin/structure/blocks.
  18. 8. Configure & enable it as required.
  19. 9. To add tab styles to your Quicktabs instances, enable the quicktabs_tabstyles module
  20. 10. Edit the default style at admin/structure/quicktabs/styles
  21. 11. Control the style of individual Quicktabs instances by editing the instance in
  22. question and selecting from the style dropdown.
  23. Note:
  24. -------------------------------------------------------------------------------
  25. Because Quicktabs allows your tabbed content to be pulled via ajax, it has its
  26. own menu callback for getting this content and returning it in JSON format. For
  27. node content, it uses the standard node_access check to make sure the user has
  28. access to this content. It is important to note that ANY node can be viewed
  29. from this menu callback; if you go to it directly at quicktabs/ajax/node/[nid]
  30. it will return a JSON text string of the node information. If there are certain
  31. fields in ANY of your nodes that are supposed to be private, these MUST be
  32. controlled at admin/content/node-type/MY_NODE_TYPE/display by setting them to
  33. be excluded on teaser and node view. Setting them as private through some other
  34. mechanism, e.g. Panels, will not affect their being displayed in an ajax Quicktab.
  35. For Developers:
  36. -------------------------------------------------------------------------------
  37. The basic Quicktabs functionality can be extended in several ways. The most basic is
  38. to use the quicktabs_build_quicktabs() function to create Quicktabs instances
  39. programmatically, putting whatever you want into the Quicktabs instance. This function
  40. takes 3 parameters:
  41. $name - the name of an existing Quicktabs instance (i.e. existing in the database or
  42. in code), or a new name if creating an instance from scratch
  43. $overrides - an array of options to override the settings for the existing instance, or
  44. to override the default settings if creating an instance from scratch
  45. $custom_tabs - an array of tab content arrays. A very basic tab content array would be
  46. array('title' => 'My Custom Tab', 'contents' => 'Some text').
  47. One example of where this might prove useful is in a hook_page_alter implementation,
  48. where you could essentially put any render array that's part of the page into a
  49. Quicktabs instance. The contents property of a cusom tab can be a render array or
  50. a string of html.
  51. Another way to extend Quicktabs is to add a renderer plugin. Quicktabs comes with
  52. 3 renderer plugins: jQuery UI Tabs, jQuery UI Accordion, and classic Quicktabs. A
  53. renderer plugin is a class that extends the QuickRenderer class and implements the
  54. render() method, returning a render array that can be passed to drupal_render().
  55. See any of the existing renderer plugins for examples. Also see Quicktabs' implement-
  56. ation of hook_quicktabs_renderers().
  57. Lastly, Quicktabs can be extended by adding new types of entities that can be loaded
  58. as tab content. Quicktabs itself provides the node, block, view, qtabs and callback
  59. tab content types. Your contents plugins should extend the QuickContent class. See
  60. the existing plugins and the hook_quicktabs_contents implementation for guidance.
  61. Author:
  62. -------------------------------------------------------------------------------
  63. Katherine Bailey <katherine@katbailey.net>
  64. http://drupal.org/user/172987