KittyCatfish

Create and manage as many catfish ads as you want.

The “catfish” ad – that eye-catching ad that slides up from the bottom of the screen – is just one of the kinds of ads that you can create with KittyCatfish. You can create as many as you want, too – and have unique settings for each one.

KittyCatfish gives you an intuitive interface for setting up your ads. It uses the WordPress content editor that you’re already familiar with, along with a bunch of new, easy to use fields to configure each ad’s settings. Pick where you want the ad to appear on the screen, which pages of your site it should show on, and how often it should display. You can have as many ads as you want, displaying in different parts of your site.

Features

  • As many ads as you need – Create multiple unique ads and manage them just like regular Posts.
  • Control where your ads appear – Show the same ad everywhere, or get specific and choose individual Posts and Pages.
  • Position your ad anywhere – Select top, right, left, or the default bottom, then use percentage or per-pixel positioning to fine tune it.
  • Show your ads when you want – Ads can appear immediately, with a timed delay, or after a user scrolls down a certain amount. Keep displaying the ad, or only show it a certain number of times.
  • Use the tools you know – Write your ad content using the standard WordPress editor.
  • Design with total freedom – Input your own CSS for your ads.

Download

Get the latest version from WordPress.org: KittyCatfish 2.2

How to Use KittyCatfish

We’ll go through the process of creating a new ad, which will introduce you to all the tools you’ll use when creating or editing your KittyCatfish ads.

Step 1: Create a New Ad

Go to KittyCatfish in the main menu. At the top of the page, select Add New, just as if you were making a new Post.

Creating a new KittyCatfish Ad

Creating a new KittyCatfish Ad

Step 2: Title and Content

Enter a title like you would for a Post. This is really for your own use, since the title isn’t displayed anywhere in the ad. Next, use the standard WordPress editor to enter the content of your ad.

Entering title and content

Entering title and content

Step 3: CSS

This is just a plain text field where you can enter ordinary CSS. Combined with the content you entered above in the editor, you can use this to design your ad however you like.

Entering CSS for the Ad

Entering CSS for the Ad

Step 4: Ad Scope

Ad scope determines where the ad shows up on your site. The options are:

  • Global: The ad will display on every page of your site.
  • Front Page: The ad will show only on the page that is set as your “Front Page”. Check your WordPress Settings under Reading to see what this is set to.
  • Posts Page: The ad will only show up on the Posts Page. Check your WordPress Settings under Reading to see what this is set to.
  • All Pages: The ad will display on all Pages on the site, not on Posts.
  • All Posts: The ad will show on all Posts.
  • Select specific Pages and Posts: Picking this option will open a list of your Pages and Posts. The box on the left has one tab showing all your Pages, and another tab showing all your Posts. Either click the green + icon on a Page or Post, or click and drag the Page or Post over to the box on the right. The box on the right shows the Pages and Posts that the ad will appear on. If you want to remove a Page or Post from the right box, either drag it back to the left box or click the red X.
Selecting the Ad's scope

Selecting the Ad’s scope

If there are multiple ads with the same scope setting, the most recently created one will be shown. More specific scope settings override less specific ones. For example, an ad set to appear on a specific Post will be displayed instead of an ad set to show on all posts, and an ad set to show on the Home Page will be displayed instead of a global ad.

Step 5: Screen Position

Screen position determines where the ad will appear on the page. Ads are designed to reveal from one of the four screen edges by sliding out from that edge. Use the buttons on the diagram of the screen to pick which edge you want the ad to appear from.

Setting the Ad's screen position

Setting the Ad’s screen position

You can then fine tune the position of your ad. For top or bottom ads, you can set how far to the left or right you want the ad to appear, either with percentage values or pixel amounts. For left or right ads, you can choose how far from the top or bottom the ad should appear, also with either percentage or pixel values.

In the case of a top or bottom ad, you can also choose to have KittyCatfish insert a spacer element. The spacer shows up at the same time as the ad and automatically compensates for the height of your ad so that it doesn’t overlap your content. This works well with ads that run the full width of the screen, but may not look good with all web designs, so it’s up to you.

Step 6: Display Options

The last set of options let you decide when the ad is displayed. By default, the ad is set to show up right away, and will appear an unlimited number of times. If you don’t like that, you can choose to have the ad appear after a certain number of seconds, or after the user scrolls down a certain number of pixels. For even more flexibility, you can use the shortcode [kittycatfish_trigger] somewhere in your content. The ad will appear when the user scrolls to that point. This allows you set a unique trigger point for each page in your site.

KittyCatfish guide 06

Setting when and how often the Ad will display

To be courteous to your users, you can check the box to prevent the ad from displaying again after the user closes it manually. This will cause KittyCatfish to set a cookie on the user’s computer which will prevent the ad from showing up again. Note that this setting is specific to the ad that was closed. If you have other active ads, they’ll still show up.

Finally, you can set how many times you want the ad to display. It will show on each page load until this limit has been reached. You can set this to zero to keep showing the ad indefinitely.

Step 7: Publish!

When you’re all done entering and configuring your new ad, simply scroll up and click the usual Publish button (or save it as a Draft if you’re not ready to go live with it yet). Congratulations, you’ve made a new KittyCatfish ad!

Changelog

2.2
New feature: shortcode trigger. Add the [kittycatfish_trigger] shortcode to your post or page content, and the ad will appear when the user scrolls to that point.

Standard content filters added; now you can do things like add shortcodes to the ad’s content.

2.1
Number of times ad has been shown and whether the user has closed it are now independent values for each ad.

2.0
Added nearly all current features and allowed for multiple ads on the same site.

10 Responses to KittyCatfish

  1. Excellent plugin:)

  2. Hi, anything special I should do to run 2 ads on the same page?

    • Peter, currently you can only have one ad on each page. Newer ads will override older ads, and ads with a more specific “scope” will override ads with a less specific scope. What sort of behavior were you looking for? We may be able to include it in a future version.

  3. Ok, Thanks.
    I where just trying to place an ad left and right.
    And get them to show at diff. “scopes” / time.
    So any way to overide the override?

    Also I would like to align the ad from the center of the page, if possible.

    Something like:
    http://wordpress.org/extend/plugins/wp-float/

    Thanks.

    • Peter, we’re going to have to add something like this in the next version of the plugin. There isn’t a way to change the behavior right now, but we’ll make some additions next time that should make that possible. Thanks for your suggestions, it helps!

  4. Super plugin.Works with my 3.x WP installation.

    Was wondering if you have some CSS templates that could be used to create ads?

    thanks

    • Steve,

      We don’t have any pre-made templates, but if you like, we do offer design services. Send us an email if you’re interested in discussing it.

  5. Any plans to update the KittyCatfish plugin for WordPress 3.8.1?