=== Ten News Ticker ===
Contributors: antonphp
Tags: news ticker, ticker, Breaking News, animation, latest posts
Tested up to: 6.7
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Customizable WordPress news ticker with 10 themes and multiple animations to dynamically display recent posts from any category.

== Description ==

**Ten News Ticker** enhances your WordPress site by displaying recent posts from a selected category in a dynamic and engaging ticker format. With a variety of animation effects and 10 distinct themes, you can tailor the ticker's appearance to match your site's design seamlessly.

**Key Features:**

- **Multiple Animation Effects:** Choose from five captivating animations to display your news:
  - **Scroll:** Smoothly scrolls news items horizontally.
  - **Slide Vertical:** Slides news items vertically.
  - **Slide Horizontal:** Slides news items horizontally.
  - **Fade:** Fades news items in and out.
  - **Typewriter:** Simulates a typewriter effect for news items.
  
- **Ten Unique Themes:** Select from 10 pre-designed themes to match your website's aesthetics.

- **Category Selection:** Display posts from any specific category of your choice.

- **Customizable Ticker Label:** Set a custom label (default is "NEWS") to appear alongside your ticker.

- **Optional Post Date Display:** Choose whether to display the publication date of each post within the ticker.

- **Automatic or Manual Placement:** Automatically display the ticker in the header or manually insert it into your theme using a simple PHP function.

**Why Choose Ten News Ticker?**

- **User-Friendly:** Intuitive settings page for easy configuration without any coding knowledge.

- **Lightweight and Efficient:** Optimized for performance to ensure your site remains fast and responsive.

- **Responsive Design:** Ticker adapts seamlessly to different screen sizes and devices.

**Use Cases:**

- **Latest News Updates:** Keep your audience informed with the most recent posts from a specific category.

- **Announcements:** Highlight important announcements or promotions dynamically.

- **Featured Articles:** Showcase selected articles to draw attention to them.

== Installation ==

1. **Upload Plugin Files:**
   - Upload the `ten-news-ticker` folder to the `/wp-content/plugins/` directory of your WordPress installation.

2. **Activate the Plugin:**
   - Navigate to the 'Plugins' menu in WordPress and activate the **Ten News Ticker** plugin.

3. **Configure Settings:**
   - Go to the **Ten News Ticker** settings page in the WordPress admin menu.
   - Select your desired category, animation effect, theme, and other preferences.
   - Enable the ticker to display automatically if desired.

4. **Manual Placement (Optional):**
   - If you prefer to place the ticker manually within your theme, insert the following code into your theme file (e.g., `header.php`) where you want the ticker to appear:

     ```php
     <?php
       if ( function_exists( 'tntc_render_ticker' ) ) {
           tntc_render_ticker();
       }
     ?>
     ```

== Frequently Asked Questions ==

= Can I display posts from multiple categories? =

Currently, the plugin allows selection of a single category for the ticker. To display posts from multiple categories, consider creating a parent category that encompasses the desired categories and selecting it.

= How can I customize the appearance of the ticker beyond the provided themes? =

For advanced customization, you can modify the plugin's CSS files located in the `css` folder. It's recommended to create a child theme or custom CSS to ensure your changes aren't overwritten during plugin updates.

= Is the plugin compatible with all WordPress themes? =

Yes, **Ten News Ticker** is designed to work seamlessly with most WordPress themes. If you encounter any compatibility issues, please contact support.

= Does the plugin support multilingual sites? =

The plugin is translation-ready and can be used on multilingual sites. Ensure that your WordPress installation and theme are configured for multilingual support.

== Screenshots ==

1. Ten Themes news ticker
2. **Settings Page:** The plugin's settings page within the WordPress admin dashboard.

== Changelog ==

= 1.0 - February 21, 2025 =
* Initial release 