This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.



Search Engine Optimization for WordPress. WordPress SEO. Better your chances getting your blog found on Google, Yahoo, and Bing. For each page, post, and selected custom post type(s), you’re able to edit the:

  • 60 Character Title
  • 155 Character Description
  • 2-4 keywords

Site wide, you’re able to:

  • Set the home page title and description (which will appear in the main search engine excerpt)
  • Define the formats of different pages titles, (ie: %page_title% || %blog_title%)

This is a basic SEO alpha plugin (currently under development) that will soon feature many other new and never before seen tools for improved SEO – follow @roimediaworks for updates, SEO tips, and other technology news. It is recommended for intermediate users familiar with WordPress, HTML, and SEO terminology.

Please contact @roi_davidsword via twitter for support / bugs / questions or contribution.

SEO Plugin by the experts at


ROI Media Works Corporation is an online marketing and advertising agency specialized in Web Presents Optimization (WPO) : which collaborates Web Design & Development, Search Engine Marketing (SEM) , Search Engine Optimization (SEO) , Pay Per Click Campaigns (PPC) , Social Media Marketing campaigns (SMM) and web analytics. These services, independent or combined, deliver a significant Return On Investment (ROI) for your online marketing budget. Contact us today! for more information.


  • Metabox added to Pages, Posts (and any other post types specified). Allowing control of the Title, Description & Keywords for that post.
  • Settings: your websites main Title, Description and keywords. if not filled will auto use websites name & tagline
  • Additional Settings for formatting the titles formats, i.e.: adding the blog name to the end or beginning of single post titles


  1. Install or manually upload /roi_seo/ to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ page in your WordPress WP-Admin
  3. Still in WP-Admin, Navigate to “Settings” > “Search Engine Optimization” to configure title formatting and other options

All themes are written differently and some theme’s don’t adhere to using wordpress hooks for overwriting. So this plugin can either automatically adds the tags to the website, or, you manually add them to a theme with 1 function. Use one of the following below

Manually (Default)

  1. In your theme’s header.php file, remove/comment-out any instances similar to: <title>..</title>, <meta name=’description’ .. />, <meta name=’keywords’ .. />
  2. Still in header.php below <head>, place the following: <?php if (function_exists('roi_seo')) roi_seo(); ?>
  3. Save


  1. In WP-Admin, navigate to “Settings” > “Search Engine Optimization”
  2. Under “Options” at the bottom, select “Automatic
  3. If your theme was written correctly the tags should appear on the site. (If you’re seeing duplicates of tags, or none, see FAQ or try manual).


In 0.2, there are two ways of using the plugin, the default Manual approach, or the Automatic way.

I can’t get the plugin to change anything on the site?
  • Manual: If you’re not seeing any new titles or meta data on the website, the installation by default is set to “manual” requiring users to edit their theme’s header.php file. Please carefully read and follow the “manual” installation instructions – some HTML+PHP work is nessisary. Alternatively, try setting the plugin HTML option to “Automatic” if you do not wish to edit your header.php

  • Automatic: If you’ve set the plugin to output the tags automatically and nothing’s showing, your current theme doesn’t use the proper hooks that are expected and thus isn’t compatible with the “Automatic” feature of this plugin. To resolve this you can set the plugin to “Manual” and edit your theme (see installation instructions)

I’m seeing multiple title or meta (keywords / description) tags?
  • Manual: The <? roi_seo() ?> function is intended to replace your themes < title > and < meta (keywords / description) > tags entirely. If you’ve followed the instructions for manual, replaced or and didn’t see any < title >, < meta (keywords / description) > tags in your themes header.php file, your theme may be adding them through <? wp_head() ?> in which case custom PHP work may need to be done – try setting the ROI SEO plugin output option to “Automatic”

  • Automatic: Your theme or other plugins may be adding the same tags through the same hooks, try setting the plugin to manual.

I’m using Thematic & there’s no header.php in my child theme to edit?!

The talent at Thematic have made it easy to overwrite most tags, so instead put this line in your child-theme’s functions.php file:

function childtheme_override_doctitle() { if (function_exists('roi_seo')) roi_seo(); }
What are the fields in settings for?
  • In WP-Admin, Navigate to “Settings” > “Search Engine Optimization”
    • Site Defaults are your main tags for the site: if undefined the system will use the sites name + tagline
    • Title Formats are the different ways your title tag can be formatted; you can specify which types of separators (“/”, “~”, “-”) and which types of pages get which titles/descriptions using available %macros%
    • Options setup the different post types you’d like the rewriting to occur on, if you’d like keywords to be generated from the posts cat & tags, and which method you’d like for outputting the HTML tags
What does “Use Dynamic SEO Tags for” mean?

When selected for post type(s): the metabox allowing custom tag values is added to that posts types edit screen. (see screenshot-1.png). If not set, that post will not have the options for custom tag values and will revert to default values.

What does “Generate Posts Keywords” mean?

If selected for “[x] From Tags” or “[x] From Categories”, that post’s keywords will be created by taking the first 3x tags and/or categories assigned to that post. i.e.: if selected for tags and categories, and a blog post was filed in “Tutorials” with the tags: “PHP” and “CSS”, the keyword tag would be <meta name="keywords" value="tutorials, php, css" />

Please note that meta keywords are on obsolete tag, no longer proven to increase search ranking- but we still include it in the plugin.

This plugin isn’t working with my other SEO Plugin(s)?

Multiple SEO plugins typically do not increase your SEO. (At this time) ROI_SEO was not intended to be compatible or work with any other SEO plugin.

What placeholder %macros% can I use for each page type format?
  • ANY – %blog_title%, %blog_description%
    • Posts – %post_title%, %date%, %terms%, %author%
    • Pages – %page_title%, %author%
    • Category – %category_title%, %category_description%
    • Archives – %date%
    • Taxonomy – %tax_name%
    • Tags – %tag%
    • Author – %author%
    • Search – %s%/%search%
Another Question?

Contributors & Developers

“ROI_SEO” is open source software. The following people have contributed to this plugin.


Translate “ROI_SEO” into your language.

Interested in development?

Browse the code or subscribe to the development log by RSS.


0.3 (Dec 10, 2014)

  • minor update

0.2.3 (May 4, 2012)

  • fixed: support for custom post type formatting
  • fixed: fix bug when multi-activing plugin default settings weren’t entered
  • fixed: support for if $wp_query->query_vars['author_name'] isn’t set on on authors page

0.2.2 (Feb 20, 2012)

  • fixed: support for is_author() pages
  • fixed: issue where if option page_for_posts was HOME, the most recent post’s SEO info was used (instead of HOME)

0.2.1 (Feb 1, 2012)

  • fixed: bug where wp_title outputs twice when using ‘automatic’

0.2 (Jan 13, 2012)

  • fixed: bug where ‘tags’ where using archive format instead of tag format
  • NEW!: option to automatically add tags (using WordPress’s wp_title() and wp_head() hooks) instead of manually editing header.php
    • select “auto” or “manual” HTML output via Settings > ROI Search Engine Optimization > Options
    • updated instructions & FAQ to support both methods of output

0.1.8 (Jan 3, 2012)

  • fixed: issues with default keywords being the description in coma’s instead of the keywords for the home page

0.1.7 (Dec 27, 2011)

  • changes: to readme.txt (FAQ)
  • fixed: hide metabox values when is_home && page_on_front == $post->post_type == page

0.1.6 (Dec 9, 2011)

  • fixed: using jQuery() instead of $() – more compatible/friendly with other plugins

0.1.5 (Dec 8, 2011)

  • fixed: folder name change causing broken URL’s to plugin resources

0.1.2 (Nov 25, 2011)

  • fixed: admin: only printing jquery scripts on pages where plugin appears,

0.1.1 (Nov 25, 2011)

  • change: made “Plugin by..” credit optional in settings page; default off

0.1 (Nov 24, 2011)

  • Initial Release

0.0 (Nov 18, 2011)

  • Started Development