Permalink
Browse files

MINOR Changed $Left placeholder in CMS templates to $Tools, documente…

…d it
  • Loading branch information...
1 parent 060e110 commit 92d513857c0b11949a468118e8eff8cc75131a76 @chillu chillu committed Feb 14, 2012
Showing with 10 additions and 2 deletions.
  1. +2 −2 admin/templates/Includes/LeftAndMain_EditForm.ss
  2. +8 −0 docs/en/reference/cms-architecture.md
@@ -24,9 +24,9 @@
</div>
</div>
- <% if Left %>
+ <% if Tools %>
<div class="cms-content-tools west cms-panel cms-panel-layout collapsed" id="cms-content-tools" data-expandOnClick="true" data-layout="{type: 'border'}">
- $Left
+ $Tools
</div>
<% end_if %>
@@ -72,6 +72,14 @@ Depending on the complexity of your layout, you'll also need to overload the
a tabbed form which only scrolls the main tab areas, while keeping the buttons at the bottom of the frame.
This requires manual assignment of the template to your form instance, see `[api:CMSMain->getEditForm()]` for details.
+Often its useful to have a "tools" panel in between the menu and your content,
+usually occupied by a search form or navigational helper.
+In this case, you can either overload the template as described above,
+or use the special `$Tools` placeholder on `LeftAndMain->getEditForm()`.
+See `CMSPageEditController->getEditForm()` for sample usage.
+As the base template is aware of this placeholder, it saves you from
+overloading a complex template.
+
## Layout and Panels
The CMS markup is structured into "panels", which are the base units containing

0 comments on commit 92d5138

Please sign in to comment.