WordPress Marquee Manager Plugin

A WordPress plugin that allows you to create and manage scrolling marquee messages for your website. Display important announcements, news, or any text content in an animated marquee format.

Features

🎯 Core Functionality

• Custom Post Type: Creates a dedicated "Messages" post type for managing marquee content
• Enable/Disable Messages: Toggle individual messages on/off using a simple checkbox
• Shortcode Support: Easy integration with [marquee-messages] shortcode
• Gutenberg Compatible: Full support for the WordPress block editor

⚙️ Customization Options

• Speed Control: Adjust marquee scrolling speed
• Message Filtering: Show only enabled messages or all messages
• Limit Control: Set maximum number of messages to display
• Direction: Messages scroll from left to right
• Styling: Built-in spacing and bullet point separators

🎨 Display Features

• Responsive Design: Works across different screen sizes
• Clean Formatting: Automatic spacing and bullet point separators between messages
• Fallback Message: Shows "No messages available" when no content exists
• Security: Properly escaped output for XSS protection

Installation

1. Download the plugin files to your WordPress installation
2. Upload the wp-marquee-manager.php file to /wp-content/plugins/wp-marquee-messages/
3. Activate the plugin through the WordPress admin panel
4. Create Messages in the new "Messages" menu item

Usage

Creating Messages

1. Go to Messages in your WordPress admin menu
2. Click Add New to create a new message
3. Enter your message title (this will be the displayed text)
4. Check the Enabled checkbox to make the message visible
5. Publish the message

Displaying the Marquee

Use the shortcode anywhere in your posts, pages, or widgets:

[marquee-messages]

Shortcode Parameters

The shortcode supports several parameters for customization:

[marquee-messages enabled_only="true" limit="10" speed="5"]

Available Parameters:

• enabled_only (boolean): Show only enabled messages (default: true)
• limit (number): Maximum number of messages to display (default: -1 for unlimited)
• speed (number): Scrolling speed in pixels (default: 5)

Examples

Basic Usage:

[marquee-messages]

Show all messages (including disabled):

[marquee-messages enabled_only="false"]

Limit to 5 messages with faster speed:

[marquee-messages limit="5" speed="10"]

Show only enabled messages with slower speed:

[marquee-messages speed="3"]

Technical Details

Post Type

• Name: messages
• Supports: Title only
• Public: Yes
• Archive: Yes
• Menu Icon: Megaphone (dashicons-megaphone)

Meta Fields

• _news_enabled: Boolean field to enable/disable individual messages

Security Features

• Nonce verification for form submissions
• Proper capability checks
• Escaped output to prevent XSS attacks
• Input sanitization

Browser Compatibility

The plugin uses the HTML <marquee> element, which is supported in most modern browsers. For better compatibility, consider using CSS animations or JavaScript alternatives in future versions.

Requirements

• WordPress 5.0 or higher
• PHP 7.0 or higher

Support

For issues, feature requests, or contributions, please visit the GitHub repository.

License

This plugin is open source and available under the GPL v2 or later license.

Changelog

Version 1.0.0

• Initial release
• Custom post type for messages
• Enable/disable functionality
• Shortcode support with customization options
• Gutenberg compatibility