Add a Block Region to a Drupal 7 Theme
In this tutorial, I will walk through the steps for adding a region to Drupal’s Bartik theme. There are a couple ways you can do this.
- Modify the Bartik theme directly. Of course, this is not the suggested practice. In the Drupal community, we don’t modify Drupal’s core unless we are applying a patch.
- Copy the Bartik theme to the /sites/all/themes directory, rename the theme, and modify it to include the region you desire.
There is a third option, which includes turning Bartik into a base theme and then creating a sub-theme, but that conversation is outside the scope of this tutorial.
In this tutorial, we will make a copy of Bartik and modify it.
Step 1. Copy the Bartik theme
Go to the root themes directory on your server and download the bartik directory to your computer. Rename the directory to mybartik.
Step 2. Modify the bartik.info file
Open bartik.info in a text editor like Notepad and make the following changes.
- Change name from Bartik to mybartik
- Add the region you want. In our example, we are going to add a region below the content region. Insert regions[content_bottom] = Content Bottom (see line 18 in the screen shot)
- Save the file as mybartik.info
Step 3. Add the region to the page template.
First, open the templates directory and then open page.tpl.php and tell Drupal to print the new region. Enter the following line of code as shown in the screen shot.
<?php print render($page[‘content_bottom’]); ?>
Inserting the region here will cause content bottom region to be rendered the same as the content region. Of course, you can place the region where ever you want but remember to wrap this line of code in a <div> tag so that you can apply the CSS that makes the region unique.
Step 4. Upload mybartik to your site
Upload your new theme to the sites/all/themes directory.
Step 5. Enable your theme and see the new region
Go to your site and click on Appearance in the black menu bar. Enable and set as default the mybartik theme that now appears in the disabled list.
The example above is simple, yes, but it conveys the steps needed to add a region to an existing theme. You can follow this process for any Drupal 7 theme. However, if you choose to copy and then modify an existing theme and that theme is updated, those updates will not automatically post to your version of the theme. If you choose to simple modify the theme so that updates can be applied, then you will likely loose the modifications you made.
At the start of this tutorial, I mentioned the base/sub-theme strategy. This strategy leaves the chosen theme in tact except for a minor modification to the .info file, allowing you to easily update the theme and not loose the changes you have made because the changes are stored in a sub-theme.
Just what I was looking for, thanks!
I don’t understand. How does that differ from “Copy the Bartik theme to the /sites/all/themes directory, rename the theme, and modify it to include the region you desire.”. You did just that. Or am I missing something.
Here is a correct way to add a sub-theme:
To add a region just change copy page.tpl.php from “bartik/templates” to “mybartik/templates” nad change info file.
This is a very good template. I will try to apply it to my website: [url=http://templendo.com]http://templendo.com[/url]
i’m using the marinelli theme,
I want to create a block region on the left far side bar (out of any content)
what code do I need to put in to make this possible?
Thank you ! Very helpful and concise.
i have bootsrap theme and i made subtheme of that theme and in that theme there is region like this
regions[navigation] = ‘Navigation’
regions[header] = ‘Top Bar’
regions[highlighted] = ‘Highlighted’
regions[help] = ‘Help’
regions[content] = ‘Content’
regions[sidebar_first] = ‘Primary’
regions[sidebar_second] = ‘Secondary’
regions[Top_Footer] = ‘Top Footer’
regions[footer] = ‘Footer’
regions[page_top] = ‘Page top’
regions[page_bottom] = ‘Page bottom’
This all data is in .info file
as u see i add a region top fotter in this but i want to render a block also so how can i make could anyone will suggest it to me .
this is a VERY old blog post that is for Drupal 7 and Bartik only. Bootstrap has it’s own way of doing a sub-theme.
Let’s see what we can do: Are you on Drupal 7 or 8? – the theming engine is very different for both. Let me know and we’ll see how we can help.