Personal tools
You are here: Home Documentation How-tos Static Text Portlets
Document Actions

Static Text Portlets

This How-to applies to: 3.0

How to use a Static Portlet

A Static Text Portlet is the only Portlet that will allow you to enter custom text, links, and images easily through the graphical interface. This is extremely useful for things like a "Take Action" Portlet where you would have a link to a Petition or third-party action campaign tool. An example of Static Text Portlet on LearnPlone.Org is the "still stumped?" portlet to the right.


To create a Static Text Portlet we must first be in the Manage Portlets page. Navigate to the page you decide will be the top level of Portlet (We will be using the Homepage for this example). Once there we can click the Manage Portlets link at the bottom of either the left or right columns. Also we could have chosen to add /@@manage-portlets to the end of our URL (e.g.

Once we are in the Manage Portlet screen, we must choose what side we want our Portlet to appear on. For our example, we are going to place it on the left side of the page. To do this we will click the drop down box labeled Add Portlet and select Static Text Portlet. This will take us to the Portlet Configuration screen. From here we will be able to specify what we want our Portlet to say and link to.

The configuration for a Static Text Portlet is very similar to editing the content on a Page. First we specify the Title or Header of our Portlet. Then we simply type in the text and add the links and other desired content, just as if it were a Page. Although you have the full editing capabilities as on a Page, we aware that you have very limited space to work with. Typically, a portlet is only a fraction of the width of your website.


For our example we created a "Take Action" type of portlet. We added some text to grab the user and then provided them a link to sign up on our petition that is on our site using an internal link.

We are also able to add an image into our Portlet as well. In this case the arrows before our "Sign Up Now" link are an image. If you need help, watch the videos in our Video Section for directions on how to upload and add images, as well as editing text.


There are a final few details before finishing a Static Text Portlet. We can add a footer that will display at the bottom of the Portlet, turn a border on or off, add a link in the header and footer section, or hide the Portlet.

To create a link on any header or footer text, specify the link to the site in the Details Link Section. If we were to do this for our example, the site address we would enter would be the same as our "Sign Up Now" link. This way whenever someone would click on the header or footer text they would also be taken to the Sign Up Page.

The Hide Portlet option is useful if you are not using the portlet at the moment, but will want to come back to it later. In our example we could hide the Portlet until we have another petition starting. Then we could simply change the text and link in the Portlet without having to add the Portlet all over again.

Once you have all the information filled in for your Portlet, click save.portlet_static


You can now view your Portlet.


You may want to tweak the text and add different formats to make the Portlet appear the way you desire.








by Josh Boese last modified 2008-11-05 13:38 All content on this site is licensed under a Creative Commons License.
Still Stumped?
If you've still got questions about Plone, here are your best bets for finding out more:

All content in this site distributed under the Creative Commons "Attribution-NonCommercial-ShareAlike" license unless otherwise noted.

Powered by Plone CMS, the Open Source Content Management System