Panels is made up of two parts – CTools (Chaos Tools – another merlinofchaos inspired contribution to Drupal) and Panels. Chaos Tools are the underpinnings – a library of helpful tools and frameworks – used by Panels and other modules (like Feeds). Panels is the other one.
Install from http://drupal.org/project/panels and http://drupal.org/project/ctools
Or alternatively use drush to download panels and ctools.
There are lots of submodules in these which we found a bit confusing at the beginning, so here I'll list the ones we commonly use/enable.
Chaos Tools (ctools)
[This needs to be changed as documentation for advanced help is done]
Module | Do We Use it? | Comments |
Bulk Export | Not much | This allows exporting and importing structures you've created – a bit like Views Bulk Export. You develop on your dev site, export everything to code, then push your page manager pages with all their configuration to your live site just by updating the code. |
Chaos Tools | Always | This is core CTools and Panels requires it |
CTools Ajax | We haven't used this one yet | |
CTools Plugin Example | No | This is a fantastic 'tutorial' on using CTools functionality. We don't enable the module, but we look at the code in it quite a bit. If you plan to do customisation, look at this stuff. |
Custom content panels / rulesets | Not Yet | These create reusable components, but we haven't used them yet. |
Page Manager | Yes | This provides a navigation menu in Site Building > Pages which we find pretty useful to get around (it does duplicate the Panels Dashboard a bit which some people found a bit confusing) |
Stylizer | Not Yet | |
Views Content Panes | Always | This allows Views to be embedded into Panels – probably one of the best bits of content to embed. We use these in nearly every page! |
Panels (panels)
Mini panels | Sometimes | As mentioned above this gives you the ability to create snippets to reuse in other panels or inside 'block' spaces. We find ourselves creating custom layouts instead of using these – not sure which is best or if there's just personal preference. |
Panel Nodes | Not Yet | In general we're using panels selection rules to override the way nodes display, so we haven't yet found ourselves using this. In general, you will not use page manager AND panel nodes in the same application. If you find yourself wanting a truly panel-node solution, the new panelizer module is a better solution anyway. It is possible that as we move forward, panel nodes will be ejected from Panels into their own project and we will favor Panelizer as the solution. |
Panels | Always | Core Panels |
Panels In Place Editor | Not Yet | We tried to use the powerful drag and move features of this, but since we're a bit geeky we ended up just doing custom layouts instead. |
The panels dashboard: This is really kind of an overview; because Panels is so spread out, this brings everything into one place primarily to help you find it. You don't actually truly administrate things from here, but it's a good starting location to get to what you do want to administer. As such, I wouldn't really recommend editing pages from the panels dashboard. What it shows you from page manager is a pretty small snippet of what's available.
An important note:
We got burnt by this once and shame on us for not following/reading instructions. I seem to remember reading somewhere that Panels and CTools have coordinated releases – so you should always be on the same version. I guess the latest one. I can't find where I read that.