This module provides a form for admins to create a block of tabbed content by
selecting a view, a node, a block or an existing Quicktabs instance as the
content of each tab.
The Quicktabs module allows you to create blocks of tabbed content. Clicking on
the tabs makes the corresponding content display instantly (it uses jQuery). The
content for each tabbed section can be a node, view, block or another Quicktabs
instance. You can create an unlimited number of Quicktabs instances, each of
which will automatically have an associated block.
The module can be extended to display other types of content.
Installation
Install this module using the official Backdrop CMS instructions at
https://backdropcms.org/guide/modules.
Usage
- Enable module in module list located at administer > structure > modules.
- Go to admin/structure/quicktabs and click on "Add Quicktabs Instance".
- Add a title (this will be the block title) and start entering information for your tabs
- Use the Add another tab button to add more tabs.
- Use the drag handles on the left to re-arrange tabs.
- Once you have defined all the tabs, click 'Save'.
- You new block will be available at admin/structure/blocks.
- Configure & enable it as required.
- To add tab styles to your Quicktabs instances, enable the quicktabs_tabstyles module
- Edit the default style at
admin/structure/quicktabs/styles - Control the style of individual Quicktabs instances by editing the instance in
question and selecting from the style dropdown.
Note on ajax
Because Quicktabs allows your tabbed content to be pulled via ajax, it has its
own menu callback for getting this content and returning it in JSON format. For
node content, it uses the standard node_access check to make sure the user has
access to this content. It is important to note that ANY node can be viewed
from this menu callback; if you go to it directly at quicktabs/ajax/node/[nid]
it will return a JSON text string of the node information. If there are certain
fields in ANY of your nodes that are supposed to be private, these MUST be
controlled at admin/content/node-type/MY_NODE_TYPE/display by setting them to
be excluded on teaser and node view. Setting them as private through some other
mechanism will not affect their being displayed in an ajax Quicktab.
Note on robots.txt
Because Quicktabs provides urls for each tab in a Quicktabs instance (these are
used both for graceful degradation without javascript, and for the ability to
link to a page with a Quicktabs instance and specify which tab should be active),
you may have a problem with the number of URLs being indexed by search engines
for your site. There is a blog post
about this problem and how to deal with it.
For Developers
The basic Quicktabs functionality can be extended in several ways. The most basic is
to use the quicktabs_build_quicktabs() function to create Quicktabs instances
programmatically, putting whatever you want into the Quicktabs instance. This function
takes 3 parameters:
$name- the name of an existing Quicktabs instance (i.e. existing in the
database or in code), or a new name if creating an instance from scratch$overrides- an array of options to override the settings for the existing
instance, or to override the default settings if creating an instance from
scratch$custom_tabs- an array of tab content arrays. A very basic tab content
array would bearray('title' => 'My Custom Tab', 'contents' => 'Some text').
One example of where this might prove useful is in a hook_page_alter implementation,
where you could essentially put any render array that's part of the page into a
Quicktabs instance. The contents property of a cusom tab can be a render array or
a string of html.
Another way to extend Quicktabs is to add a renderer plugin. Quicktabs comes with
3 renderer plugins: jQuery UI Tabs, jQuery UI Accordion, and classic Quicktabs. A
renderer plugin is a class that extends the QuickRenderer class and implements the
render() method, returning a render array that can be passed to backdrop_render().
See any of the existing renderer plugins for examples. Also see Quicktabs' implement-
ation of hook_quicktabs_renderers().
Lastly, Quicktabs can be extended by adding new types of entities that can be loaded
as tab content. Quicktabs itself provides the node, block, view, qtabs and callback
tab content types. Your contents plugins should extend the QuickContent class. See
the existing plugins and the hook_quicktabs_contents implementation for guidance.
License
This project is GPL v2 software. See the LICENSE.txt file in this directory for
complete text.
Maintainers
- herbdool
- Seeking co-maintainers.
Credit
Ported to Backdrop by herbdool.
Drupal maintainers: