Sidebar Scroller

AI Plugin Information
Version 5
Download Download Plugin

# Sidebar Scroller

Sidebar Scroller is a classic WordPress widget that displays linked featured images from sticky and recent posts in an automatically advancing carousel.

The plugin uses progressive enhancement: without JavaScript, visitors can still swipe or horizontally scroll through a snap-aligned image strip. When JavaScript is available, the scroller advances every four seconds.

## Features

– Displays every sticky post that has a featured image.
– Displays up to 10 additional recent posts with featured images.
– Links each image to its post.
– Supports posts and public custom post types.
– Provides an optional widget title.
– Pauses automatic scrolling while the widget is hovered or focused.
– Stops automatic scrolling in background browser tabs.
– Honors the visitor’s reduced-motion preference.
– Supports right-to-left layouts and WordPress Customizer selective refresh.
– Loads front-end assets only when the widget is active or being previewed in the Customizer.
– Shows the same published, non-password-protected content to logged-in and logged-out visitors.

## Requirements

– WordPress 6.5 or later
– PHP 7.4 or later
– A theme with a widget area
– Posts with featured images

## Installation

1. Upload the plugin directory to `wp-content/plugins/`, or install the plugin ZIP through **Plugins → Add New → Upload Plugin** in WordPress.
2. Activate **Sidebar Scroller** from the **Plugins** screen.
3. Open **Settings → Sidebar Scroller** and select the public post types that the widget should include.
4. Open **Appearance → Widgets** and add **Sidebar Scroller** to a widget area.
5. Optionally enter a title for the widget, then save it.

The standard `post` post type is selected by default. Attachments are not available as a content source.

## How Content Is Selected

The scroller places eligible sticky posts first, in WordPress’s configured sticky-post order. It then adds the 10 most recent eligible non-sticky posts.

A post is eligible when it:

– belongs to one of the post types selected on the settings screen;
– is published;
– is not password protected; and
– has a featured image.

If no eligible posts are found, the widget produces no front-end output. Posts whose featured-image attachment is missing are also skipped.

## Configuration

### Content Types

Go to **Settings → Sidebar Scroller** and select one or more public post types. Saving the form replaces the current selection. If no post types are selected, the widget remains empty.

### Widget Title

Set the title in the widget’s own configuration form under **Appearance → Widgets**. Leaving it blank hides the visible heading while retaining an accessible default label for the carousel region.

### Scrolling Behavior

The widget advances once every four seconds. There are no visible next/previous controls. Visitors can navigate the image strip directly with touch or horizontal scrolling, and focusing or hovering over the widget pauses automatic movement.

## Accessibility and Progressive Enhancement

The rendered scroller uses region and slide labels for assistive technologies. Automatic advancement is disabled when the visitor has enabled `prefers-reduced-motion` at the operating-system or browser level.

JavaScript is not required to access the content. Without it, the CSS-based strip remains horizontally scrollable and uses scroll snapping.

## Project Structure

“`text
aiplugin16854.php Main plugin bootstrap
src/aiplugin16854/Admin/ WordPress settings screen
src/aiplugin16854/Services/ Post-selection query
src/aiplugin16854/Settings/ Stored settings and validation
src/aiplugin16854/Widgets/ Classic widget and markup
src/css/sidebar-scroller.css Front-end presentation
src/js/aiplugin16854.js Front-end entry point
src/js/ui/SidebarScroller.js Carousel enhancement
src/plugin-update-checker/ Bundled update-checker library
“`

## Updates

The plugin includes a bundled update checker and retrieves release metadata from the plugin provider. Available updates appear in the normal WordPress plugin update interface.

## Version

Current plugin version: **5**

## License

Copyright © AI_PLUGIN_DEV 2026. All rights reserved. This is not free software. See the plugin header for the authoritative license notice.