You are here

panelizer.html in Lightning Layout 8

Same filename and directory in other branches
  1. 8.2 help/panelizer.html

File

help/panelizer.html
View source
<p>Lightning gives you the tools to take real control of the layout of your site's content. It integrates the Panelizer module, which gives you a very flexible drag-and-drop interface with which you can set up the look of your content.</p>
<p>Panelizer is enabled per <dfn>view mode</dfn>. A view mode is, essentially, a single layout for a content type. A content type can have any number of view modes. Out of the box, content types will have two view modes: Default and Teaser. Default is the view mode used when you visit a single piece of content on its own page. Teaser is generally used when viewing a list of content (each piece of content in the list is displayed in the Teaser view mode).</p>
<p>With the exception of the Landing Page content type, Panelizer is <strong>not</strong> enabled for any view mode out of the box. Here's how to enable it for a content type:</p>
<ol>
    <li>Visit the <i>Manage &gt; Structure &gt; Content types</i> page.</li>
    <li>Click the drop button for the content type you'd like to enable Panelizer on, and select &quot;Manage display&quot;.</li>
    <li>Scroll down to the bottom of the table, and check the box labeled &quot;Panelize this view mode&quot;. Another checkbox will appear below it, labeled &quot;Allow custom overrides of each entity&quot;. Check it as well.</li>
    <li>Click the Save button.</li>
</ol>
<p>It's important to understand that any piece of panelized content will take its layout from one of two possible places. It can use the default layout for its content type, or it can use a layout that has been set up for <em>just that one</em> piece of content (this is referred to as a &quot;custom&quot; or &quot;overridden&quot; layout).</p>
<p>At the moment, when you save changes to the layout of any piece of panelized content, you're presented with the option to save your changes as the defaults for that content type, or as a custom layout that piece of content only. It's possible, however, to set up permissions to ensure that the default layout <em>cannot</em> be changed that way. This is desirable if you have a content type wherein <em>every</em> piece of content should use its own custom layout -- landing pages being a prime example. To disable the ability to set the default layout, you will want to tweak the permissions named something like &quot;Content Landing page: Administer Panelizer default panels, allowed content and settings&quot;.</p>
<p>(For the record, we're aware that this is potentially very confusing and a less than ideal user experience. Work is underway to clean this up enormously, and it will change before Lightning comes out of beta.)</p>