這個外掛並未在最新的 3 個 WordPress 主要版本上進行測試。開發者可能不再對這個外掛進行維護或提供技術支援,並可能會與更新版本的 WordPress 產生使用上的相容性問題。

目前正在閱讀

外掛說明

Supplying an ISBN (and, optionally, a Title) will display a cover image of the relevant book with a link to that book’s page on Google Books using the Google Books API.

Using the Widget you can choose whether to:

  • Force all calls to Google to be HTTPS, instead of the API returned HTTP
  • Pad the Image (selected by default, uses internal CSS)
  • Display a Box-Shadow (selected by default, uses internal CSS)
  • Choose Alternate Google Country (defaults to “Worldwide”)

as well as

  • Decide whether you would like to use a Title
  • Define the ISBN-10 or ISBN-13 of the book.

Usage

  1. Activate the Plugin via “Plugins” → “Currently Reading” → “Activate” (if you hadn’t already done so).
  2. Go to “Appearance” → “Widgets” and drag the “Reading” widget into whichever Sidebar you choose.
  3. In the “Currently Reading” widget, you can then customise it further.

螢幕擷圖

  • The Configuration of a "目前正在閱讀" section, with Padding enabled.
  • The default "Widget" configuration, with the Google Country set to South Africa and an ISBN-13.
  • The previous configuration as rendered by Safari.
  • The difference between Padding and Box-Shadow Enabled and Disabled.
  • Widget Configuration location in the Dashboard's sidebar.

安裝方式

Manual Install

  1. Unzip the currently-reading.zip file.
  2. Upload currently-reading.php to the /wp-content/plugins/ directory.
  3. Activate the plugin through the ‘Plugins’ menu in WordPress.
  4. Use the “Currently Reading” widget (found under Appearance → Widgets).

Automated Install

  1. Go to “Plugins” → “Add New” in your Control Panel.
  2. Search for the keywords “Currently Reading”.
  3. Click the “Install Now” button on “Currently Reading” by “Eugéne Roux”.
  4. When prompted “Are you sure you want to install this plugin?” select “OK”.
  5. Once the installation is finished, you will be prompted to “Activate Plugin”.

Upgrade

  1. Follow your normal installation procedure
  2. Open each Widget’s control panel and re-save

Use the WordPress Plug-in System

  1. Select “Upgrade and Activate”
  2. Congratulate yourself on a sterling job.

常見問題集

I get a ‘*Warning: file_get_contents … : failed to open stream: HTTP request failed! HTTP/1.0 403 Forbidden*’ Error in my logs and no books are displayed. Why is this happening?

Your web-site has been configure not to allow outgoing HTTP requests and you have ‘Use Google API’ enabled.

Please de-select the ‘Use Google API’ option to use the direct connection instead.

I get a ‘*No Google Books Entry Found for ISBN:NUMBER*’ on my Blog… Why?

Sometimes Google Books does not return any valid responses on ISBNs. Try the following:

  1. See if you can find an alternate ISBN for the book
  2. Toggle the “Use Google API” option
  3. Find the eBook on Google’s Books Web Page and use its ISBN

Are you planing to insert other sources than Google Books to the Currently Reading widget?

I’ll have a look into supporting Amazon, though they do make you jump through hoops to use their API (which is the reason I settled on using Google Books to start with).

Is there a way to get this plugin to do a library of all of your books into WordPress?

It’s not currently possible with this plugin, no.

I’ll give it a bit of thought and see if I can extend it to do that; but it will most likely need the creation of an alternate plugin to do that.

This would likely require its own database table to do properly, as well…

使用者評論

這個外掛目前沒有任何使用者評論。

參與者及開發者

以下人員參與了開源軟體〈目前正在閱讀〉的開發相關工作。

參與者

將〈目前正在閱讀〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄

變更記錄

4.0.8

  • Add option to open Google Books link in a new Tab/Window

4.0.7

  • Add the option to force the use of SSL (https) on Google’s API links
  • Add the option to force the use of SSL (https) on the Alternate links to Google’s API
  • Tested to WordPress 5.2.3

4.0.6

  • Updated and tested WordPress 5

4.0.5

  • Fix the Google Books API call
  • Tested to WordPress 4.7

4.0.4

  • Check cache before using it
  • Check data validity before writing cache

4.0.2

  • Allow (and default to) not using the Google Books API in preference to the older — direct — connection
  • Since I’m probably the only Saffer using this, default to “books.google.com”

4.0.1

  • Display a message (No Google Books Entry Found for ISBN) when Google has no entry for the book in question
  • Reduce the width of margins so that the book entries fit better into the sidebar
  • Added a screenshot of the Widget Configuration location in the Sidebar (mostly since I keep forgetting where it is)

4.0

  • Use the Google Books API instead of previous deep-linking
  • Fix display of ISBN when updating the widget
  • Allow the selection of Alternate Google Domains (books.google.com causes issues in some countries)
  • Display book’s Title instead of ISBN on mouse-over

3.4

  • Minor fixes to ensure WordPress compatibility

3.3

  • Moved to a ‘<div>’ based layout instead of using Lists (Kudos to James Sumners for the suggestion)

3.2

  • Improved the book spacing a bit in the internal CSS

3.1

  • Added the ability to have drop-shadows around the front-cover images of the books

3.0

  • Release number re-alignment with internal Hg repo

2.0

  • Fixed a potentially embarrassing issue with generated HTML

1.0

  • Initial Public Release