Blipper Widget displays your latest entry (latest blip) on Blipfoto in a classic widget on your WordPress website.
NB Blipper Widget is a classic widget with a shortcode. Although there is no Blipper Widget block, Blipper Widget can still be used in block-enabled themes.
There are two ways to get Blipper Widget to work with block-enabled themes. The first is a workaround; the second uses existing Blipper Widget functionality:
[blipper_widget title='Blipper Widget' add-link-to-blip=show display-journal-title=show display-powered-by=show display-desc-text=show]
.Currently, Blipper Widget:
The image in the blip is not stored on your server: the widget links to the best quality image made available by Blipfoto.
See the plugin in action on my WordPress site.
Blipfoto is a photo journal service. It allows the user to post one photo a day along with descriptive text and tags; this constitutes a blip. The users may comment on other users’ blips, depending in the user’s settings, and award a star or heart to other users’ blips.
Blipper Widget is independent of and unendorsed by Blipfoto.
It does not allow you to:
This plugin is subject to Blipfoto’s developer rules; hence by installing, activating and/or using Blipper Widget, you consent to it performing actions involving your Blipfoto account, including, but not limited to, obtaining your account details (but never your password) and publishing your blips on your WordPress website. You also consent to your username being displayed together with your image. Following WordPress’ restrictions in their developer information, no links to Blipfoto (or other external links) are included without your explicit consent.
You, the Blipfoto account holder, are responsible for the images shown on any website using the Blipper Widget with your Blipfoto and Blipfoto OAuth credentials.
Use of Blipper Widget does not affect the copyright of the photo.
The Blipfoto PHP SDK is used under the MIT Licence.
Only your Blipfoto username, which is public information, and your Blipfoto access token are required, collected and stored by Blipper Widget. Your Blipfoto username and access token will be retained by this plugin until you delete or uninstall the plugin. If you do not wish Blipper Widget to store your Blipfoto username, please do not use this plugin.
Your use of the plugin is not monitored by the plugin.
In classic themes and in block themes with a classic-widgets plugin installed, Blipper Widget is added to widget areas in the same way as any other classic widget. Your latest blip will be styled either according to your CSS or to the widget’s settings.
In block-enabled themes, Blipper Widget is added with the shortcode. It can be added in a Shortcode block or anywhere else a shortcode can be added in WP.
The shortcode is also used to place Blipper Widget outside widget areas, such as posts and pages in both classic and block-enabled themes.
Using the shortcode will style your latest blip according to your CSS.
NB If you don’t know how to use WordPress shortcodes, please refer to the WordPress codex article on shortcodes. If you don’t know how to use the Shortcode block, please refer to the WordPress support article on Shortcode blocks.
The Blipper Widget shortcode [blipper_widget]
can be used singly or as a pair of start and end shortcodes:
[blipper_widget]
[blipper_widget] … [/blipper_widget]
The most straightforward use of the shortcode is single use. In the page or post editor, place the shortcode where you would like it to occur. Alternatively, place the shortcode in a Shortcode block.
There are settings you can change; these, with their default values [and alternative values where appropriate], are:
title = 'My latest blip' [<text string>]
title-level = 'h2' ['h1', 'h3', 'h4', 'h5', 'h6', 'p']
display-date = 'show' ['hide']
display-journal-title = 'hide' ['show']
add-link-to-blip = 'hide' ['show']
display-powered-by = 'hide' ['show']
display-desc-text = 'hide' ['show']
Examples
Change the text and heading level of the title:
[blipper_widget title='The Daily Photo' title-level=h1]
Change the colour of the figure-caption text:
[blipper_widget color=red]
Display your journal title in the figure caption:
[blipper_widget display-journal-title=show]
Display your journal title and change the link colour in the figure caption:
[blipper_widget display-journal-title=show link-color=blue]
You can use the paired shortcodes to add text to your blip’s caption like this:
[blipper_widget]Blipfoto allows you to save your life – with a daily photo.[/blipper_widget]
[blipper_widget add-link-to-blip=show]Click on the photo to view this image on Blipfoto[/blipper_widget]
The shortcode version of Blipper Widget always uses CSS to style the blip. The classic widget can be styled using either CSS or the Blipper Widget settings form. Blipper Widget provides various CSS selectors to style its HTML output.
A blip comprises a photo, an optional title, optional text and optional tags. Blipper Widget adds metadata including your username, but does not display the blip’s tags. There is an example of how to use CSS to style a blip on my Blipper Widget Example page. Blipfoto provides the HTML for the blip’s text.
You can ignore the provided CSS selectors to allow your theme to style your blip. Alternatively, you can use them to give your blips a unique look. Many blippers like to see their photos on a dark background, reflecting how Blipfoto’s site originally looked.
This plugin is based on aspects of BlipPress by Simon Blackbourne. I very much appreciate having his work to guide me with the use of the Blipfoto API.
I used Rotating Tweets as a guide to implementing not only the settings page and the widget back-end, but also the shortcode.
In addition, I used WP-Spamshield as a model of how to implement uninstallation code.
I had help from an anonymous person with some of the jQuery code.
The WP Readme tool has been invaluable for checking the formatting of this readme file.