=== Indesign Text Marquee ===
Contributors: indesignmedia
Tags: marquee, text-scroll, ticker, announcement-bar, news-ticker
Requires at least: 5.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

Endless text marquee for WordPress. 32 ready-made templates, live preview in the admin, no jQuery on the frontend.

== Description ==

Indesign Text Marquee is a text scrolling plugin for WordPress. It runs on `requestAnimationFrame`, keeps a seamless loop on all screen sizes, and pauses itself when the marquee is off screen to save CPU and battery.

Version 2.0 is a full rewrite of the admin experience. You now get 32 pre made templates, a tabbed settings panel, and a live preview that shows your own text in every template without having to save the marquee first.

= What you can build =

News tickers, sale bars, announcement strips, hero display text, footer credits, vertical stock tickers, podcast promos, wedding banners, seasonal banners, and more. Every template can be fine tuned after you apply it.

= Key features =

* 32 pre made templates covering news, e-commerce, tech, fashion, luxury, sports, gaming, retro, seasonal, and vertical styles.
* Live template preview inside the admin. Your own item text appears in every template card the moment you type it. No save required.
* One click apply. Clicking a template sets every setting to a known value so the frontend output matches the preview exactly.
* Green "Applied" badge shows which template is currently in use.
* Tabbed settings panel: Templates, Typography, Motion, Container, Separator and Links, Advanced.
* Full typography control: font family (outline safe Google Fonts), font weight, desktop/tablet/mobile sizes, letter spacing, italic, uppercase or lowercase.
* Outline mode with adjustable stroke width and separate stroke color.
* Motion: speed, item spacing, four directions (LTR, RTL, top to bottom, bottom to top), hover behavior (none, pause, slow, speed up), reverse on scroll, respect reduced motion.
* Container: vertical and horizontal padding, background color with transparent toggle, border color and width, border radius, tilt angle, fade edges, fade width, full window breakout mode.
* Separator: show or hide, custom glyph or emoji, size, color.
* Link behavior: same tab or new tab.
* Advanced: custom CSS class and CSS ID for targeting from your theme.
* Drag and drop to reorder marquee items. Native HTML5 drag with a visual drop indicator.
* Duplicate marquee action in the list table.
* Click to copy shortcode.
* Custom Post Type. Manage many marquees, each with its own settings and shortcode.
* Zero jQuery on the frontend.
* `IntersectionObserver` pauses the animation when the marquee is scrolled out of view.
* Google Fonts loaded on demand only when a non default font is selected.

== Installation ==

1. Upload the `indesign-text-marquee` folder to `/wp-content/plugins/`.
2. Activate the plugin from the Plugins menu.
3. Go to Indesign Text Marquee > Add New.
4. Add a few items (Text plus Link, `#` works fine for no link).
5. Open the Templates tab, click any card to apply that style.
6. Save the marquee.
7. Copy the shortcode from the Shortcode box and paste it into any page, post, or block editor.

== External Services ==

This plugin optionally connects to the Google Fonts API (`fonts.googleapis.com`) to load display fonts on the frontend. The request is only made when a non default font family is selected in the marquee settings. No personal data is sent. Only the selected font family and weight appear in the request URL.

* Service: Google Fonts
* URL: https://fonts.googleapis.com
* Privacy Policy: https://policies.google.com/privacy

If you prefer not to use external fonts, select **Inherit** as the font family. No external request will be made.

== Frequently Asked Questions ==

= How do I add a marquee to a page? =
Save the marquee, then paste the shortcode from the Shortcode box (right sidebar) into any page, post, block, or widget. It looks like `[indesign_text_marquee id="5"]`.

= Can I have more than one marquee on a page? =
Yes. Each marquee has its own ID. Paste as many shortcodes as you want.

= How do I copy the shortcode? =
Click the shortcode box. It selects and copies to your clipboard in one click.

= How many templates are included? =
32. News, e-commerce, tech, fashion, luxury, sports, gaming, retro, vertical, seasonal, and more. Popular ones show first.

= Do the template previews use my own text? =
Yes. Type in the Items box and every template preview updates instantly. No save needed.

= Will my site look exactly like the template I picked? =
Yes. Applying a template sets every setting to match the preview. Save the marquee and the frontend will match.

= Can I reorder items? =
Yes. Drag the handle on the left of any item row to reorder. A red line shows where it will drop.

= Can I duplicate a marquee? =
Yes. Hover the marquee in the list table and click Duplicate.

= Can I add links to items? =
Yes. Every item has a Link field. Set the link to open in the same tab or a new tab under Separator and Links.

= Can I scroll vertically? =
Yes. Motion tab → Scrolling Direction → TOP or BOTTOM. Or start from the Vertical Down or Vertical Up template.

= Can I tilt the marquee? =
Yes. Container tab → Tilt Angle (between -45 and 45 degrees).

= Can I fade the edges? =
Yes. Container tab → Fade Edges ON, then set the Fade Width.

= How do I make it full window width? =
Container tab → Breakout Mode → FULL WINDOW.

= Can I use custom fonts? =
Yes. Pick from the Font Family dropdown (Anton, Bebas Neue, Playfair Display, and more). Pick Inherit to use your theme's font with no external request.

= What about visitors who prefer reduced motion? =
The marquee pauses for them by default. Turn this off in the Motion tab if you need it to always run.

= Does it slow down my site? =
No. The frontend uses no jQuery. Assets load only on pages with the shortcode. `IntersectionObserver` pauses the animation when it is scrolled out of view.

= Does it work on mobile? =
Yes. Separate font sizes for Desktop, Tablet, and Mobile are in the Typography tab.

= Can I duplicate an existing marquee? =
Yes. Hover the marquee in the list table and click Duplicate. All items and settings are copied to a new draft.

== Screenshots ==

1. Main editing screen. Items metabox, tabbed Global Settings panel, and preset cards with live previews using your own text.
2. Templates tab. 32 pre made styles like Classic Ticker, Announcement Bar, E-commerce Sale, Red News Bar, Bold Outline, Tech Startup, Elegant Italic, Hero Display, Fashion Runway, Minimalist Line, Sports Bulletin, Cinematic, Y2K Tilt, Neon Night, Retro 80s, Vintage Cream.
3. More templates including Vertical Down, Vertical Up, Podcast Show, Crypto Ticker, Gaming Neon, Luxury Gold, Fitness Bold, Real Estate, Wedding Soft, Bakery Warm, Coffee Cafe, Music Festival, Halloween Spooky, Christmas Festive.
4. Typography tab. Font family, weight, responsive sizes, letter spacing, style, transform, color palette, and outline mode with stroke width and color.
5. Motion and Container tabs. Speed, direction, hover behavior, reverse on scroll, reduced motion, background, border, tilt angle, fade edges, and breakout mode.
6. Separator and Links tab plus Advanced tab. Custom glyph, size, color, link target, and custom CSS class and ID.
7. Items repeater. Add, remove, and reorder marquee items with pre filled `#` link for quick setup.

== Changelog ==

= 2.0.0 =
* NEW: Templates tab with 32 pre made styles across news, e-commerce, tech, fashion, luxury, sports, gaming, retro, seasonal, wedding, and vertical categories.
* NEW: Live template previews rebuild with your own item text as you type. No save required.
* NEW: Green Applied badge shows which template is currently in use.
* NEW: Vertical scrolling direction (top to bottom and bottom to top).
* NEW: Tilt angle for retro and Y2K style banners.
* NEW: Fade edges with adjustable width.
* NEW: Background color with transparent toggle.
* NEW: Border color, width, and radius.
* NEW: Horizontal padding.
* NEW: Letter spacing.
* NEW: Outline mode gets its own stroke width and stroke color.
* NEW: Separator size and show or hide toggle.
* NEW: Hover behavior options: none, pause, slow down, speed up.
* NEW: Reverse on scroll (marquee direction flips as the visitor scrolls up).
* NEW: Respect prefers reduced motion.
* NEW: Custom CSS class and ID on the wrapper.
* NEW: Drag and drop reorder for marquee items with drop-position indicator.
* NEW: Duplicate action in the marquee list table.
* NEW: Click to copy shortcode.
* NEW: Tabbed admin panel: Templates, Typography, Motion, Container, Separator and Links, Advanced.
* CHANGE: Font Family list trimmed to fonts that render cleanly in Outline mode.
* CHANGE: Admin UI rebuilt with red gradient pill switches, circular color swatches, and cleaner metabox styling.
* CHANGE: New items pre fill the Link field with `#` for faster setup.

= 1.0.0 =
* Initial release.
* `requestAnimationFrame` engine.
* Google Fonts and responsive size support.
* Item Gap, Marquee Height, and Link Target controls.
* `IntersectionObserver` integration for performance.
* Sectioned admin UX.

== Upgrade Notice ==

= 2.0.0 =
Major update. 32 new templates, live preview, and many new settings (vertical scroll, tilt, fade edges, background, border, hover behavior, reduced motion). Existing marquees continue to work with their old settings.
