Add Send2Press® Newswire news feeds with a plug-in
Now you can easily add our news feeds to your content portal, company site, WordPress.com blog, or self-hosted blog by using a standard WordPress plug-in (tested up to WordPress 2.6.3).

Our custom-built plug-in lets you choose Send2Press content by topic (i.e., books, medical, music, travel, software, etc.) and easily integrate the news feed into your site wherever you want it — either as part of other content (such as related article topics), or on a custom "industry news" page that fits your site content.

Starting December 1, 2008 you can download the Send2Press Plug-in from the WordPress.org Plugin Directory.

NOTE: we prefer to call a plug-in a "plug-in," like most people, whereas WordPress calls them plugins (without the hyphen). So, we will use the term "plugin" when specifically referring to the WordPress site, admin panel, or the install folders for the program.

How to install the Send2Press Plug-in
The simple version, step-by-step:
(If already installed, jump to visual plug-in admin guide, below this page)

1. Download the Send2Press plug-in.
2. Via FTP or your site file manager, create a folder called "Send2Press" in your httpdocs/wp-content/plugins/ folder (or wherever your plug-ins live in your installed version). If you use WordPress.com, see the HELP information found on that site.
3. Drag the Send2Press plug-in file to the folder you created in your /plugins/ folder.
4. Go to the "Plugins" section of your WordPress admin panel.
5. "Activate" the Send2Press plug-in.
6. Go to the Send2Press link in your WordPress admin dashboard; configure options, create feed(s).
7. Place the code into your theme template, or test page/post. Test page(s). You're done!

Also see the WordPress HELP documentation in the program, or the WordPress.org site, for how to install and activate plug-ins.

Quick test
If you want to quickly test the plug-in with the "default" feed (all news topics) and you're using WP 2.5 or higher, you can go to Manage » Write » Page and make a new page in your blog/site, and then place the following code [send2press] on the page, then save, then view/preview page (if using a version prior to WP 2.5, you would use the old style <!--send2press--> on test page/post). Remember the "look" of the links and text will be based on your template style sheet (CSS) of your page/post.

To place the default feed into your theme template, use the function call within your theme layout:
<?php do_action('send2press'); ?>
  - OR -
<?php do_action('send2press','feedname'); ?>

(NOTE: once you do custom topic feed set-up, see below, then 'feedname' would be the unique identifier for your feed, such as 'books' or 'california').

Use of our Send2Press® Newswire content feeds is subject to our Terms of Use.

Screen 1 (below). Settings » Send2Press
The first admin screen (below) you will likely start with after plug-in install and activation within your WordPress site, is the main help and information page for the plug-in. To create and manage feeds, click the text link Manage - > Send2Press. (Note: depending on your version of WordPress, you should see a link under the "manage" menu in your dashboard.)

Screen 2 (below). Manage Send2Press®: Newswire Feeds
From this page, you can review your feed(s), and create a new feed. For our example, we're going to create a custom news feed of Book News. So, to get started, click the text link
Add extra feed.

Screen 3A (below). Configure new feed
From the "add extra feed" page, you can review/edit your feed(s), and create a new feed. To create a new feed, do the following:

1. In the Name box, type books, replacing NEW
2. In the Admin-defined title, type Book and Publishing News (you can change this later; this is the header which appears above the feed in your page/theme)
3. Use the drop-down selector under Type, to select your desired topic feed (see second image, Screen 3B, below) and choose Ent: Books and Publishing
4. Use the Output drop-down selector to choose whether you want only headlines, or the headline and summary; for this tutorial, choose Summary
5. Leave the default of 10 under Max items, but you can change this to fewer to better fit a layout, such as your home page, to better align column height
6. Under the Action column, click Save »
7. Below, under Cache time, leave 120 minutes as the default if you only use one topic feed; if you add additional feeds, then add 10 minutes for each additional feed you create (e.g., if you add two feeds, change value to 140 minutes); then click Save » button next to Cache time.

Screen 3B (below). Choose news topic from drop-down
IMPORTANT NOTE: there are main topics like "Entertainment" which contain ALL entertainment-related news, as well as sub-topics, like "Ent: Books and Publishing" or "Ent: Fashion." So, if you choose a main topic you get news from all related sub-topics. This allows you to choose either a broad or more narrow topic depending on your site content. For this tutorial, choose the "Books..." sub-topic.

Screen 4 (below). Manage Feeds
Now that you have created the feed, the screen shows "Saved feed books [1]". You can now proceed to test the feed in your template or page, using the feed name 'books'. To test your new Books feed, do one of the following:

• In your theme template, put the following code where you want the feed to appear:
  <?php do_action('send2press','books'); ?>
• In your WP page/post (WordPress 2.5 or higher), put this:
  [send2press name="books"]
• If using an older version of WP, put this in your page/post:
  <!--send2press#books-->