Please note that campus is switching to Layout. If your site is still using Panelizer, please discuss your transition process with your site owner.
What is Panelizer?
Panelizer and Panels are modules that work together. These module allow developers to panelize any entity type on Drupal. This provides a way to change the layout of a node page, user page, or any other type of entity. The Campus Web Solutions team has "panelized" the basic page content type. Due to this, editors and site builders are able to change the layout, add blocks, move blocks around the page regions, and even create new blocks right from any basic page. This allows editors and site builders a more visual way of placing blocks, rather than going through Drupal's default "Block Layout" under Structure.
How do I use Panelizer?
- First, create a basic page.
- Once you have added a title and body information, save or save and publish your page.
- This will take you to your page, where you'll have tabs across the top such as "View", "Edit", "Delete" and "Revisions" (if there are any). However, you should also see at the bottom, a sticky tab with options for "Change Layout", "Manage Content", "Edit", and "Revert to Default" or "Save" (depending on the mode you are in). This is what we call the "Panelizer Tab".
- From here, you can change the layout of the page, add custom blocks you've created, add system blocks, and move these blocks around.
There are 1, 2, and 3 column layout options. Each layout has various regions. Regions are the places you can put bodies and blocks of content. All layouts have regions for a full 100% width for "top" and "bottom" plus the two or three column options in the middle. For 2 column layouts, there are options for "bricks". Bricks essentially gives you a double stack of regions for the layout. You can choose which regions to use (you don't have to use all the regions!). The layout selected will be denoted with a green "Current" tag.
All basic page nodes start off as one column layouts. An editor or site builder can later update the layout of the page after its first save (or save & publish). No content will be lost if you suddenly go from a three column layout to a two column layout, however, blocks will need to be rearranged in the proper regions.
Moving content to regions
Please be aware that only "blocks" of content can be moved into regions within a layout. You cannot select a specific part of text from the body and paste it into a region, the full body content must be moved. You'll need to create basic blocks if you want text within different regions, separate from the body block content.
There is a wide variety of options in the Manage Content tab of Panelizer. You'll mostly want to be using "Create Content" to create new blocks (these are the same custom blocks you can create using the Custom Block Library) or "Custom" to place custom blocks already created. "Lists (Views)" is also a useful option to place any teaser blocks for articles and blogs.
- Create Content - Create a custom block. The user interface is a little different than the block library, however, the types are the same and the content will be stored in the block library. This way is convenient to create custom blocks of content, it can all be done at once in one place. Also, you can then select which region to place the newly created block of content for this page only.
- AddToAny - Recommended to not use in regions. AddToAny are the social icons that automatically display on events and articles.
- Content - This is every field used in our profile of Drupal. It is not recommended to use any of these. However, it is good to note that if you accidentally delete your "body" block from a basic page, you can get it back here by selecting "Body".
- Custom - All custom blocks created are located here. Place any of your blocks onto the node/page by clicking on it and selecting whether to display the title, and which region to place the block in.
- Entity Block - Any entity can be added to a node. These include other content nodes and taxonomy terms.
- Forms - Allows placement of user login block. Not recommended to be used in page regions.
- Help - Add the default Drupal help block. Not recommended to be used in page regions.
- Lists (Views) - Views for event "teaser" blocks.
- Menus - Add existing menus to a node. It is not recommended to use the main navigation within the page content.
- System - Branding, breadcrumbs, and other system variables that are used in specific places on sites. Not recommended to be used.
- UC Riverside Custom Site Configuration - All UCR default profile site configurations for header and footer. Warning: It may not display as expected if added to a node outside of their intended uses.
- User - Who's New block
- Views - All views created to display content in a certain. This includes exposed forms such as filtering articles.
- Core - Drupal core functions like admin actions and editor tabs. Not recommended to be used in page regions.
When "Edit" is clicked on the Panelizer tab, your custom blocks become movable and editable with pink icons. Make sure you are selecting the pink pencil, not the gray pencil.
- "X" - Removes the block from the node/page
- "^" - Move the selected block up one block
- "v" - Move the selected block down one block
- Gears icon - Select whether to display the title or not, change title displayed, and some blocks have extra options such as the number to display
- Pink Pencil Icon - Edit the block. Keep in mind that this edits the block wherever it has been placed. It is the same as editing the block in the custom block library.
You can drag and drop blocks into different regions if you are using something other than the single column template.
Things to note:
- Only editors and site builders can access the Panelizer tab at the bottom of the screen.
- Regions, in edit mode, will be distinguishable with a dark gray header. They will read "REGION:", followed by the title of the region.
- Blocks, the areas that can be moved to different regions, have a light grey header. They will read "BLOCK:" followed by the title of the block.
- Not all region columns will work well with every block.