內容簡介
Blipper Widget能夠在你的WordPress網站上以經典小工具的形式展示你在Blipfoto網站上的最新貼文（即最新的blip）。
請注意，Blipper Widget是一款帶有短代碼的經典小工具。雖然它沒有Blipper Widget區塊，但仍然可以在支援區塊的佈景主題中使用。
有兩種方法可以讓Blipper Widget與支援區塊的佈景主題兼容。第一種是解決方法，第二種是使用現有的Blipper Widget功能:
1. 安裝支援經典小工具的插件。這樣就可以將Blipper Widget添加到您網站上的任何小工具位置。
2. 使用Blipper Widget短代碼在WP Shortcode區塊中。例如: [blipper_widget title='Blipper Widget' add-link-to-blip=show display-journal-title=show display-powered-by=show display-desc-text=show]。
目前，Blipper Widget功能如下:
- 在你的Blipfoto帳戶中顯示最新的blip（圖像、標題和用戶名）:
- 在小工具中顯示
- 通過短代碼在頁面中顯示
- 通過短代碼在文章中顯示
- 顯示blip日期（可選，在默認情況下為開啟）
- 包括從圖像到Blipfoto網站上對應blip的鏈接（可選，在默認情況下為關閉）
- 顯示你的journal名稱並連結到你的Blipfoto帳戶（可選，在默認情況下為關閉）
- 顯示連結到Blipfoto網站的（powered by）鏈接（可選，在默認情況下為關閉）
blip中的圖像並不存儲在你的服務器上，該小工具連結到Blipfoto提供的最高質量圖像。
在我的WordPress網站上查看該插件的演示。
關於Blipfoto：
Blipfoto是一個照片日誌服務，允許用戶每日發布一張照片以及描述性文字和標籤;這構成了一個"blip"。用戶可以根據其設置對其他用戶的blip進行評論，並為其他用戶的blip打星或愛心。
Blipper Widget獨立於Blipfoto，並未經授權。
該插件不允許你：
- 發布blips
- 對blips進行評論
- 為blips打星或愛心
- 追蹤其他用戶。
安裝、啟用和/或使用Blipper Widget即表示你同意根據Blipfoto的開發人員規則執行涉及你的Blipfoto帳戶的操作，包括但不限於獲取你的帳戶詳細信息（但從不獲取你的密碼）並在你的WordPress網站上發布你的blips。你也同意顯示你的用戶名和圖像。遵從WordPress的開發者信息中的限制，Blipfoto（或其他外部連結）的任何鏈接都不包含在內，除非你明確同意。
使用Blipper Widget的人負責在任何使用你的Blipfoto帳戶和Blipfoto OAuth憑證的網站上顯示的圖像。
使用Blipper Widget不會影響照片的版權。
Blipfoto PHP SDK在MIT許可證下使用。
外掛標籤
開發者團隊
原文外掛簡介
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:
Install a plugin that enables classic widgets. This will allow you to add Blipper Widget to any widget-enabled location on your site.
Use the Blipper Widget shortcode in a WP Shortcode block. Example: [blipper_widget title='Blipper Widget' add-link-to-blip=show display-journal-title=show display-powered-by=show display-desc-text=show].
Blipper Widget:
displays the latest blip (image, title and username) in your Blipfoto account:
in a widget in a widget-enabled area
on a page via a shortcode
in a post via a shortcode
displays the date of the blip (optional; on by default)
includes a link from the image to the corresponding blip on the Blipfoto website (optional; off by default)
displays your journal name with a link to your Blipfoto account (optional; off by default)
displays a (powered by) link to the Blipfoto website (optional; off by default).
The image in the blip is not stored on your server: the widget links to the best quality image made available by Blipfoto.
About Blipfoto
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:
publish blips
comment on blips
award stars or hearts to blips
follow other users.
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.
GDPR compliance
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.
Usage
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.
How to use the shortcode
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:
single use: [blipper_widget]
paired use: [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' [
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]
How to use CSS classes to style 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.
Acknowledgements
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.
