=== Auto Scrolling Testimonials ===
Contributors: opensourcetech
Tags: testimonials, reviews, scrolling, widget, shortcode
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Add testimonials and show them in an auto-scrolling list, in a widget or with a shortcode.

== Description ==

Auto Scrolling Testimonials adds a Testimonials section to your admin. Add each testimonial with a name and website, then show them:

* in the "Auto Scrolling Testimonials" widget, which scrolls upwards automatically;
* anywhere with the `[astlist]` shortcode, as a list or as a scrolling ticker.

Accessible by design: scrolling pauses on hover and keyboard focus, there is a pause button, and nothing moves for visitors who have turned on "reduce motion" on their device. No jQuery needed.

= Shortcode =

`[astlist nop="5" order="rand"]` shows a list of testimonials.

`[astlist nop="6" scroll="yes" visible="3" title="What our clients say"]` shows a scrolling ticker.

* `nop` – number of testimonials, 1 to 50. Default: 5.
* `order` – `DESC` (newest first), `ASC` (oldest first) or `rand`. Default: `DESC`.
* `scroll` – `yes` for the scrolling ticker. Default: `no`.
* `visible` – testimonials visible at once in the ticker. Default: 3.
* `length` – maximum characters per testimonial in the ticker. Default: 150.
* `title` – heading above the ticker.

== Installation ==

1. In your WordPress admin go to Plugins > Add New, search for "Auto Scrolling Testimonials", then install and activate it.
2. Go to AST Testimonials > Add New and add a few testimonials.
3. Add the `[astlist]` shortcode to a page, or add the widget under Appearance > Widgets.

== Frequently Asked Questions ==

= Will my testimonials, widgets and shortcodes survive the update to 2.0.0? =

Yes. Testimonials, their Name and Website fields, widget settings and the `[astlist]` shortcode are unchanged.

= My theme's custom CSS no longer applies =

Version 2.0.0 uses classes instead of IDs: `#newsticker-demo` is now `.ast-scroller` and `#osttestimonials` is now `.osttestimonials`.

== Changelog ==

= 2.0.0 =
* Security: the Name and Website fields are now saved with a nonce and permission check, and all output is escaped.
* Fixed fatal errors on PHP 8 (removed `create_function`).
* New scrolling ticker without jQuery or jCarouselLite, with pause on hover/focus, a pause button and reduced-motion support.
* New `scroll`, `visible`, `length` and `title` shortcode attributes, so the ticker also works in block themes.
* Fixed "Read more" and website links, and website addresses saved without `https://`.
* Styles and scripts load only where testimonials are shown.
* Testimonials are available in the block editor.
* Now requires WordPress 6.0 and PHP 7.4 or later. Tested up to WordPress 7.1.
* License changed to GPLv2 or later.

= 1.1 =
* Improved performance.
* Fixed some bugs.

== Upgrade Notice ==

= 2.0.0 =
Security and PHP 8 compatibility update. Replaces the old jQuery carousel with an accessible scroller.
