API, Blog, PHP, WordPress, WordPress Plugins, WordPress Shortcode

Display a Random Insult on Your Website with PHP or WordPress Shortcode

Insults has to be one of the most pointless plugins in the WordPress repository. It was the first plugin we ever submitted to WP and was done so - like a few others - just to test the WordPress waters and get a feel for how their approval process worked. The plugin will retrieve an 'insult' from a database of thousands and return it. Simple. Like all plugins, it'll find its place somewhere.

This post will show you how to access a random insult via our API with shortcode, PHP, or with our WordPress plugin.

The Results

The result of this function will render something like this on your website:

"Some day you will find yourself -- and wish that you hadn't."

Cheesy, we know.

WordPress Shortcode

Copy and paste the WordPress function into your theme's functions.php file or, if you sensibly have one installed, your custom functions plugin. You may optionally download and install our plugin from the bottom of of the page.

If you require shortcode to work in a sidebar widget, you'll have to enable the functionality with a filter. If you're using our custom functions plugin, you'll have that feature enabled by default.

<?php

Display a Random Insult on Your Website with PHP or WordPress Shortcode

http://www.beliefmedia.com/display-random-insult

function beliefmedia_insult($atts) {

$atts = shortcode_atts(array(

'tags' => false,

'p' => false,

'temp' => 300, /* If API offline, number of seconds to wait before trying again */

'offline' => '<a href="http://www.beliefmedia/">API</a> Offline. Try again in a few minutes.',

'cache' => 3600

), $atts);

$transient = 'bmis_' . md5(serialize($atts));

$cachedposts = get_transient($transient);

if ($cachedposts !== false) {

return $cachedposts;

} else {

/* Tags? */

if ($atts['tags'] !== false) {

$tags = explode(',', $atts['tags']);

foreach($tags as $tag) {

$htmltag .= '<' . $tag . '>';

}

$html_tags_closing = str_replace('<', '</', $htmltag);

}

/* Get data from BeliefMedia API */

$json = @file_get_contents('http://api.beliefmedia.com/insults/random.php');

if ($json !== false) $data = json_decode($json, true);

if ($data['status'] == '200') {

/* Get insult */

$return = (string) $data['data']['insult'];

if ($atts['tags'] !== false) $return = $htmltag . $return . $html_tags_closing;

if ($atts['p'] !== false) $return = '<p>' . $return . '</p>';

/* Set transient */

set_transient($transient, $return, $atts['cache']);

} else {

$return = $atts['offline'];

set_transient($transient, $return, $expiration = $atts['temp']);

}

return $return;

}

add_shortcode('insult','beliefmedia_insult');

Usage

Insert the shortcode of [insult] wherever it is you want your insult to be rendered. The default code will cache the text for 1 hours (3600 seconds) but you can get them as often as every 6 minutes. We cache the text locally on our end for 5 minutes.

PHP Function

Used outside of WordPress, the following PHP function may be used. It requires the use of Simple Cache.

<?php

Display a Random Insult on Your Website with PHP

http://www.beliefmedia.com/display-random-insult

http://wordpress.org/plugins/Insults/

REQUIRES: http://www.beliefmedia.com/simple-php-cache (Simple Cache)

include('simple-cache/cache.inc.php');

function beliefmedia_random_insult($cache = '3600') {

$transient = 'bminsult_' . md5(serialize(func_get_args()));

$cachedposts = beliefmedia_get_transient($transient, $cache);

if ($cachedposts !== false) {

return $cachedposts;

} else {

$data = @file_get_contents('http://api.beliefmedia.com/insults/random.php');

if ($data !== false) $data = json_decode($data, true);

if ($data['status'] == '200') {

$return = (string) $data['data']['insult'];

/* Set transient */

beliefmedia_set_transient($transient, $return);

} else {

$return = beliefmedia_get_transient_data($transient);

}

return $return;

}

/* Usage */

echo beliefmedia_random_insult();

Download

The plugin version is hosted in the WordPress plugin repository.

Title: Display a Random Insult (Shortcode)
Description: Display a Random Insult on Your Website with PHP or WordPress Shortcode.
Download • Version 0.2, 923.0B, zip, Category: WordPress Shortcodes
PHP Code & Snippets, (664.0B)

Plugin Title: Author:
Description:
Download (downloaded 0 times) | Plugin Page

■ ■ ■

Download our complimentary 650-page guide on marketing for mortgage brokers. We'll show you exactly how we generate billions in volume for our clients.