Captain Up Plugin for WordPress

Captain Up boosts engagement on your WordPress-based site using game mechanics and social tools. Quickly and immediately start rewarding users for engaging with your content, using points, levels, badges, and leaderboards, and keep them coming back for more.

You will see more likes, more tweets, more comments, and more returning visitors. You can learn more about your users, see who is passionate about your content, and connect with key users to nurture your relationship.

Getting Started

First, install our WordPress plugin. It’s really easy, no worries.

Captain Up is a game mechanics and user engagement platform for your WordPress-based site. After a quick installation, your users can connect with Facebook or Twitter, earn points, start leveling up, achieving badges, and competing on your leaderboards.

Captain Up automatically tracks WordPress, Facebook, and Disqus comments, Facebook likes, tweets, YouTube video plays, and page views. Our default setup incentivizes all of these, and you will instantly see an increase in all of them. But that's not all – you will also be able to track and incentivize any other actions important to you!

You will need to connect your WordPress site to a Captain Up account. Signing up is free, so if you don't have one yet - sign up now.

  • Total customization - You can create new badges that can be achieved by visiting specific pages or categories on your WordPress site, or for liking your Facebook page. You can completely customize badges and levels, including how they look and what users have to do to get each one.

  • Works out of the box - With over 70 different badges and 30 levels, Captain Up gives your users a challenging game experience with an easy learning curve.

  • Deep insights and statistics - Get to know your most passionate users. See who has the most Twitter followers and who brought you the most visitors. Understand how users are engaging with your WordPress site and how to improve your game.

  • Widgets - The Activity Widget shows recent activity on your site and makes your site come alive with activity and community. The Leaderboard Widget gets users competing against one another.

  • Viral actions - Users can get more points for having a large base of Twitter followers or Facebook friends. They can easily share badges and levels with a link to your WordPress site, and get even more point when other people follow these links!

  • Tons of actions - You can reward users for visiting your site consistently, Tweeting about it, Liking things, visiting specific pages, commenting, or even watching videos on your site.

Shortcodes

Several shortcodes are available for adding Captain Up widgets and helpers to your site's pages and posts:

  • [captain-leaderboard width="250px" height="400px" title="Leaderboard" leaderboard="all-time-ranking"] - adds the leaderboard widget. All attributes are optional. By default the width of the widget will be 300 pixels, the height 400 pixels and the title will be "Leaderboard". The leaderboard option selects the default leaderboard to show, can be either one of "all-time-ranking", "monthly-ranking", "weekly-ranking" or "daily-ranking".

  • [captain-activity width="250px" height="400px" title="Activity Feed"] - adds the activity widget. All attributes are optional. By default the width of the widget will be 300 pixels, the height 400 pixels and the title will be "Activity".

  • [captain-sign-up text="Join the Game"] - adds a link to sign up to Captain Up. It will open the sign up modal, incentivizing your users to start playing. By default the text of the link will be "Sign Up Now".

User integration

Automatic user integration means everyone signed up on your site will automatically get a Captain Up profile without needing to separately sign up to Captain Up.

This feature of the WordPress plugin is available for paid plans only, and can be switched on in the plugin’s settings page. Without automatic user integration, users will have to use a Twitter or Facebook account to connect to Captain Up.

User integration is also available for non-WordPress sites and apps, and via our Platform API as well.

Custom actions

On WordPress, like anywhere else, Captain Up tracks a bunch of actions by default and you can set it to track any other action you like. Just follow the quick guide on custom actions.

As the guide explains in detail, you first have to set up the action in your Captain Up admin panel, then put some code on your page to send an action when whatever you’re tracking happens. The main thing you need to note for WordPress is that this require some JavaScript.

The best place to add JavaScript to WordPress is inside your theme’s footer, usually located at wp-content/themes/YOUR-THEME-NAME/footer.php.

Here are 3 resources that could help out:

Frequently Asked Questions

Do I need to create an account?

Yes. In order for the plugin to work you need to sign up for Captain Up. It's completely free.

Is JavaScript required?

Yes. Captain Up will not work if JavaScript is disabled.

Do you support WooCommerce? BuddyPress? Other plugins?

We can confirm Captain Up works well together with WooCommerce, BuddyPress, and Simple Local Avatars. Unless the makers of those plugins make a sudden and unexpected change, Captain Up should continue working well alongside them.

If you’re using Captain Up together with other WordPress plugins, it would be just great to hear from you as to how it’s been working – have the plugins been playing nice with one another? Any issues you’d like our help resolving? Just reach out to us, any time!

How do I add the leaderboard and activity feed widgets in WordPress?

Our WordPress plugin includes built-in WordPress widgets for displaying the Activity feed and Leaderboard widgets. To add them, head over to the Appearance -> Widgets tab in your WordPress admin panel, and drag the Captain Up Widget to the right widgets area where you want them to appear.

You'll be able to select the widget type - either leaderboard or activity feed - and configure its height. When adding a leaderboard widget, you'll be able to select the type of leaderboard to display by default (all-time, monthly, weekly, or daily).

We also offer shortcodes for adding the widgets directly to your posts and pages:

  • [captain-leaderboard width="250px" height="400px" title="Leaderboard" leaderboard="all-time-ranking"] - adds the leaderboard widget. All attributes are optional. By default the width of the widget will be 300 pixels, the height 400 pixels and the title will be "Leaderboard". The leaderboard option selects the default leaderboard to show, can be either one of "all-time-ranking", "monthly-ranking", "weekly-ranking" or "daily-ranking".

  • [captain-activity width="250px" height="400px" title="Activity Feed"] - adds the activity widget. All attributes are optional. By default the width of the widget will be 300 pixels, the height 400 pixels and the title will be "Activity".

Captain Up won’t track my Tweets / Likes / Shares. What gives?

Captain Up offers built-in tracking for Facebook Likes and Shares through the official Twitter and Facebook buttons, or through the bundled share module.

If you’re using a sharing service such as AddThis or ShareThis, and depending on the share buttons you’re using, the service might block other scripts, including Captain Up (and even your own code!), from “listening” on Like and Share events.

If you don’t want to use our native share widget and need a share buttons plugin that works well with Captain Up, one good choice is Really simple Facebook Twitter share buttons.

Do you track and incentivize WordPress comments?

Yes. With the WordPress plugin installed, Captain Up will automatically track WordPress comments for you. You can incentivize these comments by configuring the Comment action in your admin panel.

Can I use Captain Up on a WordPress.com hosted blog?

Unfortunately, WordPress.com does not allow external plugins. However, if your WordPress blog is self-hosted with wordpress.org - you can use our WordPress plugin.

Do you work with a Multisite WordPress Install?

Yes. If you are using a Multisite WordPress installation, make sure to install Captain Up globally on your network, and enable it for each site you want the plugin to work on. Make sure you have the right API key and secret set on all sites and everything should work just fine.

Check our WordPress install instructions for more info.

Contributing code

The source code for this plugin is available on Captain Up's GitHub account. Pull Requests and issues are welcome.

Next steps

If you haven’t done so already, now is a good time to start delving deeper into creating a good Captain Up setup to fit your store.