Content Slideshow

外掛說明

This plugin creates a fullscreen slideshow that displays randomly-selected pictures from your media library. Designed to display pictures related to your business/organization in the background at an event or in your office, there is no need to configure any settings or controls. Image captions/descriptions are automatically displayed as well, and can be configured based on your needs.

Once activated, you can view the slideshow by visiting http://yourdomain.com/slideshow. All JPEG images will be displayed (since .jpg is best for pictures, while .png and .gif are typically used for graphics).

Please note that it is not currently possible to pause the slideshow or go back; the slideshow is not designed for personal viewing. However, clicking/tapping on the image will open its attachment page in a new tab, allowing images to be contextualized or edited easily.

The slideshow can also be embedded into your site via a widget or a shortcode.

You can control some options by adjusting the url of the slideshow. Parameters are controlled via query string (and widget options and shortcode attributes).

  • size is the size of the image to load, either thumbnail (discouraged), medium, large, full, or auto, which uses medium or large depending on wp_is_mobile().
  • year is the 4-digit numeric year in which the images were published.
  • month is the numeric month in which the images were published (between 1 and 12), typically but not necessarily used in conjunction with year.
  • mode defines a subset of images to use, such as featured for featured images only.
  • captions controls the captions display: either auto, none, title, titlecaption, caption, or description. Caption data is read from the image attachment post and can be updated in the media library.

Using all options, for example:
http://example.com/slideshow?size=full&year=2014&month=4&mode=featured&captions=titlecaption

You can see it in action here.

螢幕擷圖

  • Full-screen mode.
  • Shortcode, in the Twenty Fourteen theme.
  • Widget, in the Twenty Fourteen theme.

安裝方式

  1. Take the easy route and install through the WordPress plugin adder OR
  2. Download the .zip file and upload the unzipped folder to the /wp-content/plugins/ directory
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Go to http://yourdomain.com/slideshow to see the slideshow in action. Add a widget version from the Widgets section in the Customizer or add the [content_slideshow] shortcode to a post or page.

常見問題集

Where’s the settings page?

For simplicity’s sake, no settings page is included. Settings for this plugin tend to depend on the exact situation in which you are using it, so rather than going to the setting page every time you want to use it, you can adjust the parameters via tweaks to the slideshow url (see details below).

What happened to my page at /slideshow?

This plugin overrides WordPress at the slideshow/ url. If you have a post/page with that slug, it will no longer be accessible on the front-end. This may be desired; for example, you could create an empty slideshow page so that you have a record of the plugin’s presence and can more easily add it to navigation menus. You don’t have to have a page thee, though, and you can manually add the slideshow URL to your navigation menus.

Loading higher quality images

You can force the plugin to always show the highest resolution pictures available by using the size query argument (http://example.com/slideshow?size=full). Note that this could cause speed issues with loading the images if your internet connection or your web server is slow.

Loading images from a specific time frame

The plugin supports year and month parameters that can be used to only show images uploaded in a given time period (see the description for an example).

Using the Shortcode

The shortcode version supports all four parameters that the full URL version supports, as attributes:
[content_slideshow size=”medium” year=”2014″ month=”1″ mode=”featured”]

使用者評論

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

參與者及開發者

以下人員參與了開源軟體〈Content Slideshow〉的開發相關工作。

參與者

〈Content Slideshow〉外掛目前已有 1 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Content Slideshow〉外掛本地化為台灣繁體中文版

對開發相關資訊感興趣?

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

變更記錄

2.4.1

  • Fix missing file in 2.4 release package.

2.4

  • Add code comments for the slideshow JS.
  • Lazy-load slideshow iframes in widgets and shortcodes. Image loading is already lazy.
  • Exclude images with wp_attachment_context from the slideshow (site icons, cropped header images, etc).

2.3

  • Add a “featured” mode to only show featured images.
  • Add options to configure the captions display, including UI options in the widget controls.

2.2

  • Fix keyboard accessibility so that only the visible image can be focused with the keyboard.

2.1

  • Add support for selective refresh in the customizer preview, available in WordPress 4.5.

2.0

  • The slideshow is now JavaScript-driven. Images should load faster with smoother transitions between them, but the initial load time will be slower. The slideshow page will reload itself much less often now.
  • The delay query arg has been removed.
  • Fix WordPress 4.3 compatibility.
  • Add translations.

1.1

  • Link images in slideshow to their attachment pages.
  • Fix display of attachment titles as fallback captions.
  • Fix viewport in IE10+ in Windows 8 mode.
  • Confirm WordPress 3.9 compatibility.

1.0

  • First publicly available version of the plugin.
  • Tested with WordPress 3.8.