From iThemes Codex
Revision as of 20:15, 17 June 2011 by Skylermoore (talk | contribs)
Jump to: navigation, search

Series: DisplayBuddy


The RotatingText plugin adds the ability to create groups of text entries that can be displayed on the front end of a site by fading each of the entries in and out one at a time.


The first step in adding RotatingText to your site is to create a group to store the text entries in. The link to RotatingText in the WordPress admin area is in the DisplayBuddy section of the menu. When you click the RotatingText link it will direct you to the area where you can create a group. The only information requested to create a group is a name for that group. After you have created a group it will be added to a table that lists all of the existing groups and lists information about them.


Each entry created is one of the pieces of text that will be rotated through on the front end of the site. Once you have created a group you can then add entries to that group by selecting one of the groups from the groups table. The only information needed to create an entry is the text you would like to rotate. When creating an entry there are two optional fields that will allow you set a link for the text entry and an option for that link to open in a new tab or window when it is clicked.

After you create an entry it is added to a table that lists all of the created entries for that group and information about that entry. The order of the entries is determined by the order that they are listed in the entry table. To the right of each entry listed in the table there is a small image graphic that will allow you easily reorder entries by dragging them to the position in the list where you would like for then to occur, then after you have them placed in the order you like you can click the "Save order" button to save it.

Group Settings

The settings section will allow you to easily customize each group to fit your sites needs.

Rotation Speed Settings

This section of the settings will allow you to adjust the timing on how the fading transitions work for this group when it is rotating through text on your site. These options are fairly self explanatory since they are listed in the order that they occur.

  • Fade in duration - The amount of time that is spent fading the text in from being hidden.
  • Display text duration - The amount of time spent between fading the text in and when it will begin fading out.
  • Fade out duration - The amount of time that is spent fading the text out to where is hidden again.
  • Between animations - This is the amount of time spent between fading one text entry out and fading in the next text entry.

Group Styles

On the PluginBuddy team we try our best to make options for a wide variety of adjustments that people may want to make. Since there is a wide variety of places that you may want to display RotatingText on your site it was important to make it very flexible and easy to customize. The following style options were our attempt at doing just that.

  • Group Width
    • (optional) Auto width
  • Group Height
    • (optional) Auto height
  • Horizontal text alignment
  • Vertical text alignment
  • Background Color
  • Group Font Styles
    • Font-size
    • Font-family
    • Font-color

There was also a thought that users may want to style each text entry in the group individually so we added optional styling options for the font on each text entry.

Displaying RotatingText on your site

RotatingText can be added to your site using two different methods, widgets or shortcode.


Navigate to the Widgets area under Appearance in the WordPress Admin area. Drag the RotatingText widget into the widget area that you would like for it to display in and select the group from the drop-down menu that you would like to display.


The groups table in RotatingText will display a shortcode for each different group that you have created. If you would like to add a RotatingText group to a post or page all you have to do is copy that shortcode and paste it the content of the page or post.

Additional Resources

  1. Free Plugins by PluginBuddy
  2. PluginBuddy Tutorials
  4. Support Forums