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.
