API, Blog, WordPress, WordPress Plugins, WordPress Shortcode

Display a Random Quote on your Website with WordPress Shortcode

A few years ago we toyed around with the idea of submitting a few plugins to the WordPress repository. Most of them were very basic simply so we could wrap our heads around the way they the WP system worked. One of the first plugins we submitted was QOTZ - a really simple plugin that'd do nothing except render a random quote on your WP website. The plugin is partnered with an unmonitored website, Twitter account , and Facebook page (all displaying the quotes as images rather than text).

A lot of what we worked on a few years ago included an XML API. While we thought XML data was appropriate at the time (mainly because it was browser-readable), history has since educated us on our wayward ways. As we rebuild a number of our websites, any API will return JSON data almost exclusively - now sensibly our norm. This post will essentially reproduce what we once shared on another site: how to render a random quote in your website with shortcode (using our newer, improved, faster, and more reliable API). The plugin update will follow.

If you're a client and have an API key, check the platform for expanded usage (such as text search, branded image quotes, quotes by author, and paginated results).

The Result

The result is as advertised: a random quote. Shortcode of [qotz] will return the following (bolding and blockquote is mine):

"It is truer to say that martyrs create faith more than faith creates martyrs." — Miguel de Unamuno

The quote is cached on your end for 15 minutes. That ensures you don't retrieve the same cached quote on our end.

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.

<?php

Display a Random Quote on your Website with WordPress Shortcode

http://www.beliefmedia.com/random-quote-wordpress-php

Also: https://wordpress.org/plugins/qotz/

http://www.qotz.net/

function beliefmedia_wp_qotz($atts) {

$atts = shortcode_atts(array(

'cache' => '1800'

), $atts);

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

$cachedposts = get_transient($transient);

if ($cachedposts !== false) {

return $cachedposts;

} else {

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

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

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

$text = (string) $data['data']['quote'];

$author = (string) $data['data']['author'];

$genre = (string) $data['data']['genre'];

/* Format the quote to your liking */

$return = '"' . $text . '" — ' . $author;

/* Set transient */

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

} else {

$return = 'Quote unavailable for a few minutes.';

set_transient($transient, $return, $expiration = '300');

}

return $return;

}

add_shortcode('qotz','beliefmedia_wp_qotz');

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 Function

Used outside of WordPress the following function can be used. It requires that you include Simple Cache.

<?php

Display a Random Quote on your Website with WordPress Shortcode

http://www.beliefmedia.com/random-quote-wordpress-php

Also: https://wordpress.org/plugins/qotz/

Requries Simple Cache: http://www.beliefmedia.com/simple-php-cache

http://www.qotz.net/

function beliefmedia_wp_qotz($cache = '3600') {

$transient = 'bmq_' . 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/quotes/random.php');

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

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

$text = (string) $data['data']['quote'];

$author = (string) $data['data']['author'];

$genre = (string) $data['data']['genre'];

/* Format the quote to your liking */

$return = '"' . $text . '" — ' . $author;

/* Set transient */

beliefmedia_set_transient($transient, $return);

} else {

$return = beliefmedia_get_transient_data($transient);

}

return $return;

}

/* Usage */

echo beliefmedia_wp_qotz($cache = '1800');

Considerations

Most of what's quoted on the Internet is what we wanted people to say, not what they actually said. Einstein and Marilyn Monroe are probably two of the hardest hit by distorted or fake attribution. However, short quotes are often a paraphrased sentiment, giving them a certain truth.
The quote can obviously be formatted with HTML to your liking.
Clients have access to a huge database of quotes in our library that can all be manufactured into custom images. Once created, they can be sent to social in a number of ways.
Despite showing a small number of downloads, we will build upon this plugin to return movie quotes and other information.

Download

Title: Display a Random Quote on your Website (Shortcode)
Description: Display a Random Quote on your Website with WordPress Shortcode or PHP.
Download • Version 0.2, 759.0B, zip, Category: WordPress Shortcodes
PHP Code & Snippets, (738.0B)

Download our 650-page guide on Finance Marketing. We'll show you exactly how we generate Billions in volume for our clients.